gutterpress 0.11.23-alpha.2 → 0.11.23-alpha.3

package/dist/{cli-sdmv4bba.js → cli-h4x81x97.js}

@@ -11,10 +11,10 @@ import {
   prettify,
   readExtensionMeta,
   slugify
-} from "./cli-pwwfxdgb.js";
+} from "./cli-t8be9yeb.js";
 import {
   log
-} from "./cli-aqh6brew.js";
+} from "./cli-s6djx4ma.js";
 import {
   UsageError
 } from "./cli-d8xjns66.js";
@@ -94,6 +94,87 @@ import { existsSync, statSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { parse as parseYaml, YAMLParseError } from "yaml";
 
+// src/engine/shared/print-area.ts
+function isPositivePoints(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function isNonNegativePoints(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+var round3 = (n) => Math.round(n * 1000) / 1000;
+function cssLength(pt) {
+  const inches = round3(pt / 72);
+  return Math.abs(inches * 72 - pt) < 0.000001 ? `${inches}in` : `${round3(pt)}pt`;
+}
+function formatPageSize(page) {
+  return `${cssLength(page.width)} ${cssLength(page.height)}`;
+}
+function printAreaMeta(page) {
+  const area = JSON.stringify({
+    width: page.width,
+    height: page.height,
+    bleed: page.bleed ?? 0,
+    safe: page.safe ?? 0,
+    artSafe: page.artSafe,
+    gutter: page.gutter,
+    preset: page.preset,
+    spec: page.spec
+  });
+  return `<meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>`;
+}
+function pageBoxes(area, side, scale = 1) {
+  const w = area.width * scale;
+  const h = area.height * scale;
+  const b = Math.max(0, area.bleed) * scale;
+  const s = Math.max(0, area.safe) * scale;
+  const a = Math.max(0, area.artSafe) * scale;
+  const g = Math.max(0, area.gutter) * scale;
+  const [textLeft, textRight] = side === "verso" ? [s, g] : [g, s];
+  const [artLeft, artRight] = side === "verso" ? [a, g] : [g, a];
+  const trim = { x: side === "verso" ? b : 0, y: b, w: Math.max(0, w - b), h: Math.max(0, h - 2 * b) };
+  return {
+    sheet: { x: 0, y: 0, w, h },
+    trim,
+    safe: {
+      x: trim.x + textLeft,
+      y: trim.y + s,
+      w: Math.max(0, trim.w - textLeft - textRight),
+      h: Math.max(0, trim.h - 2 * s)
+    },
+    safeArt: {
+      x: trim.x + artLeft,
+      y: trim.y + a,
+      w: Math.max(0, trim.w - artLeft - artRight),
+      h: Math.max(0, trim.h - 2 * a)
+    },
+    bleed: b
+  };
+}
+var SEVERITY = { inside: 0, unsafe: 1, bleed: 2, "off-page": 3 };
+function judgeRect(r, boxes, rule, tol = 0) {
+  const { sheet, trim } = boxes;
+  const safe = rule === "art" ? boxes.safeArt : boxes.safe;
+  const sides = [
+    ["left", -r.x, -safe.x, -trim.x, -sheet.x],
+    ["right", r.x + r.w, safe.x + safe.w, trim.x + trim.w, sheet.x + sheet.w],
+    ["top", -r.y, -safe.y, -trim.y, -sheet.y],
+    ["bottom", r.y + r.h, safe.y + safe.h, trim.y + trim.h, sheet.y + sheet.h]
+  ];
+  let worst = { kind: "inside", gap: 0, need: 0, edge: null };
+  let beyond = 0;
+  for (const [edge, ink, limit, trimEdge, sheetEdge] of sides) {
+    const past = ink - limit;
+    if (past <= tol || rule === "art" && ink >= sheetEdge - tol)
+      continue;
+    const kind = ink > sheetEdge + tol ? "off-page" : ink > trimEdge + tol ? "bleed" : "unsafe";
+    if (SEVERITY[kind] > SEVERITY[worst.kind] || kind === worst.kind && past > beyond) {
+      worst = { kind, gap: trimEdge - ink, need: trimEdge - limit, edge };
+      beyond = past;
+    }
+  }
+  return worst;
+}
+
 // src/lib/presets.ts
 var PRESET_IDS = ["dtrpg", "book", "custom"];
 var DTRPG_PRESET = {
@@ -124,7 +205,8 @@ var DTRPG_PRESET = {
     bleed: 9,
     safe: 36,
     artSafe: 18,
-    gutter: 36
+    gutter: 36,
+    margin: undefined
   },
   ink: {
     maxTac: 240,
@@ -210,7 +292,8 @@ var BOOK_PRESET = {
     bleed: undefined,
     safe: 18,
     artSafe: undefined,
-    gutter: undefined
+    gutter: undefined,
+    margin: undefined
   },
   ink: {
     maxTac: 400,
@@ -572,9 +655,28 @@ function resolveCustomPage(c, m) {
     bleed: c.page?.bleed ?? m.page?.bleed,
     safe: c.page?.safe ?? m.page?.safe,
     artSafe: c.page?.artSafe ?? m.page?.artSafe,
-    gutter: c.page?.gutter ?? m.page?.gutter
+    gutter: c.page?.gutter ?? m.page?.gutter,
+    margin: c.page?.margin ?? m.page?.margin
   };
 }
+var MARGIN_EDGES = ["top", "bottom", "inside", "outside"];
+function validatePageMargin(margin, size) {
+  const edges = isPlainObject(margin) && Object.keys(margin).every((k) => MARGIN_EDGES.includes(k)) && MARGIN_EDGES.every((e) => isNonNegativePoints(margin[e]));
+  if (!edges) {
+    throw new UsageError("Manifest field `page.margin` must set all four edges in points (72pt = 1in), for example\n" + `  page:
+    margin:
+      top: 54
+      bottom: 54
+      inside: 54
+      outside: 54
+` + `got ${JSON.stringify(margin)}.`);
+  }
+  const m = margin;
+  if (m.inside + m.outside >= size.width || m.top + m.bottom >= size.height) {
+    throw new UsageError(`Manifest field \`page.margin\` leaves no room for text on a ${size.width} x ${size.height}pt page ` + `(inside ${m.inside} + outside ${m.outside} across, top ${m.top} + bottom ${m.bottom} down).`);
+  }
+  return m;
+}
 function resolveWithPreset(cliOverrides, manifest, preset) {
   const m = manifest;
   const c = cliOverrides;
@@ -627,6 +729,9 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
     throw new UsageError("Manifest field `extensions` must be a list of specifiers.");
   }
   const extensions = rawExtensions.map((entry, index) => ({ entry, index })).filter(({ entry }) => typeof entry === "string" || entry?.enabled !== false).map(({ entry, index }) => normalizeExtensionEntry(entry, index));
+  const page = preset.page ? mergeShape(c.page, m.page, preset.page) : resolveCustomPage(c, m);
+  if (page.margin !== undefined && page.margin !== null)
+    validatePageMargin(page.margin, page);
   return {
     title: c.title ?? m.title ?? "Document",
     authors: c.authors ?? m.authors ?? [],
@@ -639,7 +744,7 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
     source: mergeShape(c.source, m.source, preset.source),
     pdfx: mergeShape(c.pdfx, m.pdfx, preset.pdfx),
     print: mergeShape(c.print, m.print, preset.print),
-    page: preset.page ? mergeShape(c.page, m.page, preset.page) : resolveCustomPage(c, m),
+    page,
     ink: mergeShape(c.ink, m.ink, preset.ink),
     lint: {
       ...mergeShape(c.lint, m.lint, preset.lint),
@@ -1491,7 +1596,6 @@ async function describeFolder(dir, base, fallbackLabel, labelFrom = prettify) {
     ...meta.description?.trim() ? { description: meta.description.trim() } : {},
     ...meta.author?.trim() ? { author: meta.author.trim() } : {},
     ...meta.preview !== undefined ? { preview: meta.preview } : {},
-    ...meta.tokensFile?.trim() ? { tokensFile: meta.tokensFile.trim() } : {},
     ...styles.length > 0 ? { styles } : {},
     carries: extensionCarries(meta),
     dir
@@ -2026,4 +2130,4 @@ async function restoreForCommand(dir, options) {
     log.warn(problem);
 }
 
-export { PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, npmRegistryUrl, ensureProjectGitignore, listProjectExtensions, setExtensionEnabled, removeExtension, addExtension, checkExtensionUpdates, updateExtensions, uniqueExtensionId, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };
+export { isPositivePoints, cssLength, formatPageSize, printAreaMeta, pageBoxes, judgeRect, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, npmRegistryUrl, ensureProjectGitignore, listProjectExtensions, setExtensionEnabled, removeExtension, addExtension, checkExtensionUpdates, updateExtensions, uniqueExtensionId, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };

package/dist/{cli-evg8sbht.js → cli-n2tsxqpn.js}

@@ -11,7 +11,7 @@ import {
 import {
   PACKAGE_VERSION,
   log
-} from "./cli-aqh6brew.js";
+} from "./cli-s6djx4ma.js";
 import {
   __require
 } from "./cli-37x76zdn.js";

package/dist/{cli-aqh6brew.js → cli-s6djx4ma.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-kh8v4vvw.js";
+} from "./cli-5jzyw06s.js";
 
 // src/utils/logger.ts
 var currentLevel = "INFO";

package/dist/{cli-pwwfxdgb.js → cli-t8be9yeb.js}

@@ -1,7 +1,7 @@
 import {
   PACKAGE_VERSION,
   debug
-} from "./cli-aqh6brew.js";
+} from "./cli-s6djx4ma.js";
 import {
   isExactNpmVersion,
   isValidNpmPackageName,
@@ -24,6 +24,7 @@ import { pathToFileURL } from "node:url";
 var theme_default = `/* =============================================================================
    Clean Book — gutterpress built-in theme (theme.css)
    A calm, classic long-form book look. Change the :root tokens from the book's own stylesheet.
+   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
    ============================================================================= */
 
 :root {
@@ -42,11 +43,7 @@ var theme_default = `/* ========================================================
   --fs-h2: 1.5rem;
   --fs-h3: 1.2rem;
   --leading:  1.55;
-}
 
-@page {
-  size: 6in 9in;
-  margin: 0.85in 0.75in;
 }
 
 body {
@@ -86,6 +83,7 @@ hr { border: 0; border-top: 1px solid var(--color-rule); margin: 1.5em 0; }
 var theme_default2 = `/* =============================================================================
    Zine — gutterpress built-in theme (theme.css)
    High-contrast, punchy, photocopier-friendly. Change the :root tokens from the book's own stylesheet.
+   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
    ============================================================================= */
 
 :root {
@@ -104,11 +102,7 @@ var theme_default2 = `/* =======================================================
   --fs-h2: 1.8rem;
   --fs-h3: 1.3rem;
   --leading:  1.4;
-}
 
-@page {
-  size: 5.5in 8.5in;
-  margin: 0.4in;
 }
 
 body {
@@ -150,6 +144,7 @@ code, pre { font-family: var(--font-mono); font-size: 0.95em; }
 var theme_default3 = `/* =============================================================================
    Technical Document — gutterpress built-in theme (theme.css)
    Clean sans-serif manual look with clear hierarchy. Change the :root tokens from the book's own stylesheet.
+   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
    ============================================================================= */
 
 :root {
@@ -157,6 +152,7 @@ var theme_default3 = `/* =======================================================
   --color-ink-muted:  #5a5f66;   /* captions, secondary text  */
   --color-accent:     #0b5fff;   /* headings, links           */
   --color-paper:      #ffffff;   /* page background           */
+  /* @label Note and code background */
   --color-tint:       #f3f5f9;   /* code / note fill          */
   --color-rule:       #d6dae0;   /* borders, rules            */
 
@@ -169,11 +165,7 @@ var theme_default3 = `/* =======================================================
   --fs-h2: 1.45rem;
   --fs-h3: 1.15rem;
   --leading:  1.5;
-}
 
-@page {
-  size: 8.5in 11in;
-  margin: 0.9in 1in;
 }
 
 body {
@@ -246,10 +238,10 @@ var theme_default4 = `/* =======================================================
   --fs-h2: 1.2em;
   --fs-h3: 1em;
   --leading:  1.38;
+
 }
 
 @page {
-  margin: 1in;
   @bottom-center { content: counter(page); font-family: var(--font-body); font-size: 9pt; }
 }
 
@@ -433,7 +425,6 @@ function metaFromPackageJson(raw) {
     ...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) } : {},
     ...str(gp.markdown) ? { markdown: str(gp.markdown) } : {},
     ...str(gp.components) ? { components: str(gp.components) } : {},
     ...str(gp.snippets) ? { snippets: str(gp.snippets) } : {},
@@ -499,8 +490,7 @@ function assertExtensionContained(meta) {
     ...entry ? [entry] : [],
     ...meta.publish && meta.main?.trim() ? [meta.main.trim()] : [],
     ...meta.components ? [meta.components] : [],
-    ...meta.snippets ? [meta.snippets] : [],
-    ...meta.tokensFile ? [meta.tokensFile] : []
+    ...meta.snippets ? [meta.snippets] : []
   ];
   for (const rel of declared) {
     if (pathEscapesFolder(rel)) {
@@ -517,7 +507,6 @@ function resolveExtension(dir, meta, subject) {
   return {
     ...markdown ? { markdown } : {},
     ...styles ? { styles } : {},
-    ...meta.tokensFile?.trim() ? { tokensFile: meta.tokensFile.trim() } : {},
     ...components ? { components } : {},
     ...snippets ? { snippets } : {}
   };
@@ -3581,9 +3570,9 @@ async function loadNpmPackage(packageName, baseDir, version) {
   const looksLikeJsFilename = /\.(m?js|cjs)$/i.test(packageName);
   const suggestedPath = looksLikeJsFilename ? `./${packageName}` : `./plugins/${packageName}.js`;
   if (!looksLikeJsFilename && (!version || !isExactNpmVersion(version))) {
-    throw new Error(`Extension "${packageName}${version ? `@${version}` : ""}" is not pinned to an exact version, so it can't be downloaded automatically. Run \`gutterpress ext add ${packageName}\` (or use Book settings > Features in the desktop app) to download it and pin its version in your manifest.`);
+    throw new Error(`Extension "${packageName}${version ? `@${version}` : ""}" is not pinned to an exact version, so it can't be downloaded automatically. Run \`gutterpress ext add ${packageName}\` (or use Book setup > Looks & features > Advanced in the desktop app) to download it and pin its version in your manifest.`);
   }
-  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${version ? `${packageName}@${version}` : packageName}\` (or Book settings > Features > Advanced in the desktop app),
+  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${version ? `${packageName}@${version}` : packageName}\` (or Book setup > Looks & features > Advanced in the desktop app),
 or reference a local file under \`extensions:\`:
   extensions:
     - ${suggestedPath}`);

package/dist/{cli-pz4bn98t.js → cli-xsrffqzt.js}

@@ -530,12 +530,18 @@ function parseMargin(value) {
   const d = parts[3] ?? b;
   return { top: a, right: b, bottom: c, left: d };
 }
+var DEFAULT_PAGE_MARGIN_PT = 72;
 function resolvePage(model, ctx = {}) {
   const wanted = new Set(ctx.pseudos ?? []);
   const applicable = model.pageRules.filter((r) => r.name ? r.name === ctx.name : true).filter((r) => r.pseudos.every((p) => wanted.has(p))).sort((a, b) => specificity(a) - specificity(b));
   const decls = {};
   const marginBoxes = {};
-  const margin = { top: 72, right: 72, bottom: 72, left: 72 };
+  const margin = {
+    top: DEFAULT_PAGE_MARGIN_PT,
+    right: DEFAULT_PAGE_MARGIN_PT,
+    bottom: DEFAULT_PAGE_MARGIN_PT,
+    left: DEFAULT_PAGE_MARGIN_PT
+  };
   for (const rule of applicable) {
     for (const [prop, value] of Object.entries(rule.decls)) {
       if (prop === "margin")
@@ -1134,7 +1140,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-t7nx2stg.json";
+var manifest_schema_default = "./manifest.schema-650pe0d1.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-nnmrxyqm.js";
@@ -1149,31 +1155,31 @@ 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-701vf4qp.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-mafsby5k.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-d29ry3ak.js";
 
 // src/assets/templates/book/manifest.yaml
-var manifest_default = "./manifest-n1gh3qw5.yaml";
+var manifest_default = "./manifest-8afhrk30.yaml";
 
 // src/assets/templates/book/chapter-01.md
 var chapter_01_default = "./chapter-01-gsbjt584.md";
 
 // src/assets/templates/zine/manifest.yaml
-var manifest_default2 = "./manifest-n1gh3qw5.yaml";
+var manifest_default2 = "./manifest-d4f9q79e.yaml";
 
 // src/assets/templates/zine/chapter-01.md
 var chapter_01_default2 = "./chapter-01-wgjfz4w6.md";
 
 // src/assets/templates/technical/manifest.yaml
-var manifest_default3 = "./manifest-n1gh3qw5.yaml";
+var manifest_default3 = "./manifest-my7mdv8j.yaml";
 
 // src/assets/templates/technical/chapter-01.md
 var chapter_01_default3 = "./chapter-01-6fn9pvd0.md";
 
 // src/assets/templates/paper/manifest.yaml
-var manifest_default4 = "./manifest-eagfhba6.yaml";
+var manifest_default4 = "./manifest-gf13sjp8.yaml";
 
 // src/assets/templates/paper/chapter-01.md
 var chapter_01_default4 = "./chapter-01-s71xrf5q.md";
@@ -1200,13 +1206,13 @@ var fixture_default = "./fixture-2qnyqgb5.md";
 var expected_default = "./expected-ycmacem8.html";
 
 // src/assets/extension-templates/plugin/test/plugin.test.js.tpl
-var plugin_test_js_default = "./plugin.test.js-xgxrd8hf.tpl";
+var plugin_test_js_default = "./plugin.test.js-gxzqqfdh.tpl";
 
 // src/assets/extension-templates/look/package.json
-var package_default2 = "./package-aenwjew3.json";
+var package_default2 = "./package-awwkt7sa.json";
 
 // src/assets/extension-templates/look/README.md
-var README_default2 = "./README-8ef336pp.md";
+var README_default2 = "./README-8db7btxb.md";
 
 // src/assets/extension-templates/look/components.yaml
 var components_default = "./components-zzqdpt3m.yaml";
@@ -1215,7 +1221,7 @@ var components_default = "./components-zzqdpt3m.yaml";
 var callout_default = "./callout-hv56m16h.md";
 
 // src/assets/extension-templates/look/styles/tokens.css
-var tokens_default = "./tokens-7984461t.css";
+var tokens_default = "./tokens-ye64p899.css";
 
 // src/assets/extension-templates/look/styles/base.css
 var base_default = "./base-ypqh9n7f.css";
@@ -1227,7 +1233,7 @@ var components_default2 = "./components-aam0fe2z.css";
 var page_templates_default = "./page-templates-tx9ryt19.css";
 
 // src/assets/extension-templates/look/styles/page-rules.css
-var page_rules_default = "./page-rules-nsj3aw42.css";
+var page_rules_default = "./page-rules-fj09xct5.css";
 
 // src/assets/extension-templates/look/styles/book.css
 var book_default = "./book-ted3tzrp.css";
@@ -2679,4 +2685,4 @@ ${lines.length ? lines.join(`
 `);
 }
 
-export { lastPageMode, extract, resolvePage, getAssetPath, MARGIN_BOX_IGNORED_PROPERTIES, build };
+export { lastPageMode, DEFAULT_PAGE_MARGIN_PT, getAssetPath, MARGIN_BOX_IGNORED_PROPERTIES, build };

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
 } from "./cli-d8xjns66.js";
 import {
   package_default
-} from "./cli-kh8v4vvw.js";
+} from "./cli-5jzyw06s.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-mhs46pw3.js").then((m) => m.default),
-  preview: () => import("./preview-6p9v6rht.js").then((m) => m.default),
-  build: () => import("./build-encgnv0c.js").then((m) => m.default),
-  publish: () => import("./publish-qgsngy8s.js").then((m) => m.default),
-  validate: () => import("./validate-0v7xw6wa.js").then((m) => m.default),
-  preflight: () => import("./preflight-3k2b1x8e.js").then((m) => m.default),
-  doctor: () => import("./doctor-5gtpgpd1.js").then((m) => m.default),
-  ext: () => import("./ext-wn2a5afq.js").then((m) => m.default)
+  new: () => import("./new-s4zcaepg.js").then((m) => m.default),
+  preview: () => import("./preview-mzytcwyk.js").then((m) => m.default),
+  build: () => import("./build-m78jcpf7.js").then((m) => m.default),
+  publish: () => import("./publish-fez14ad4.js").then((m) => m.default),
+  validate: () => import("./validate-p2chr6hr.js").then((m) => m.default),
+  preflight: () => import("./preflight-c7w1xdn3.js").then((m) => m.default),
+  doctor: () => import("./doctor-j71jqce3.js").then((m) => m.default),
+  ext: () => import("./ext-fq2hg9va.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-mhs46pw3.js");
+      const { newArgs } = await import("./new-s4zcaepg.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-3k2b1x8e.js");
+      const { preflightArgs } = await import("./preflight-c7w1xdn3.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-wn2a5afq.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-fq2hg9va.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-5gtpgpd1.js → doctor-j71jqce3.js}

@@ -1,16 +1,16 @@
 import {
   getSystemDiagnostics
-} from "./cli-evg8sbht.js";
+} from "./cli-n2tsxqpn.js";
 import"./cli-asap4t1z.js";
 import {
   log
-} from "./cli-aqh6brew.js";
+} from "./cli-s6djx4ma.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-kh8v4vvw.js";
+import"./cli-5jzyw06s.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";
 

package/dist/engine/shared/gcpm-extract.d.ts

@@ -109,6 +109,14 @@ export declare function parseMargin(value: string): {
  * Later rules win; specificity follows the spec's simplified order
  * (unnamed < named, no-pseudo < pseudo).
  */
+/**
+ * The margin a page has when no `@page` rule sets one: what `resolvePage`
+ * assumes, and what the assembly writes ahead of every stylesheet
+ * (`defaultPageMarginCss`, lib/markdown/assemble.ts) so Chromium prints with
+ * the same number instead of its own default of about 0.4in, which would
+ * make the preview and the PDF paginate differently.
+ */
+export declare const DEFAULT_PAGE_MARGIN_PT = 72;
 export declare function resolvePage(model: GcpmModel, ctx?: {
     name?: string;
     pseudos?: string[];

package/dist/engine/shared/print-area.d.ts

@@ -55,6 +55,13 @@ export interface PrintAreaSource {
     safe?: number;
     artSafe?: number;
     gutter?: number;
+    /** The margins the manifest sets (pt), written as the book's `@page` margins; absent = the stylesheets'. */
+    margin?: {
+        top: number;
+        bottom: number;
+        inside: number;
+        outside: number;
+    };
     preset?: string;
     spec?: {
         label: string;
@@ -63,11 +70,16 @@ export interface PrintAreaSource {
 }
 /** A usable point value: finite and positive (a page dimension, an inset). */
 export declare function isPositivePoints(value: unknown): value is number;
+/** A margin value: finite and 0 or more (a full-bleed edge has no margin). */
+export declare function isNonNegativePoints(value: unknown): value is number;
+/** Round to 3dp so 8.27in doesn't print as 8.270000000000001in. */
+export declare const round3: (n: number) => number;
+/** CSS length for a point value: inches when exact to 3dp (612 -> 8.5in), else points. */
+export declare function cssLength(pt: number): string;
 /**
- * The `size` value written for a page — `8.5in 11in`, `595pt 842pt` — by
- * everything that writes one: Book settings (lib/page-size.ts) into the
- * book's stylesheet, and the assembly's manifest default
- * (lib/markdown/assemble.ts), so one size has one spelling.
+ * The `size` value written for a page — `8.5in 11in`, `595pt 842pt` — by the
+ * assembly's `@page` rule (lib/markdown/assemble.ts), the one place a size is
+ * written, so one size has one spelling.
  */
 export declare function formatPageSize(page: {
     width: number;

package/dist/{engine-tn13gk0b.js → engine-1r6q80tq.js}

@@ -1,7 +1,7 @@
 import {
   build
-} from "./index-4x6y8krm.js";
-import"./index-0skhjx3e.js";
+} from "./index-nvmf22rt.js";
+import"./index-nedd07bk.js";
 import {
   BuildError
 } from "./index-46ycxe6r.js";

package/dist/{engine-mc5br8g8.js → engine-m4y10shc.js}

@@ -1,6 +1,6 @@
 import {
   build
-} from "./cli-pz4bn98t.js";
+} from "./cli-xsrffqzt.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import {

package/dist/{ext-wn2a5afq.js → ext-fq2hg9va.js}

@@ -2,10 +2,10 @@ import {
   importExtensionFromFile,
   importExtensionFromUrl,
   searchNpmExtensions
-} from "./cli-xq6djqbj.js";
-import"./cli-evg8sbht.js";
+} from "./cli-1h17ktsg.js";
+import"./cli-n2tsxqpn.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-pz4bn98t.js";
+import"./cli-xsrffqzt.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
@@ -18,12 +18,12 @@ import {
   removeExtension,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-sdmv4bba.js";
+} from "./cli-h4x81x97.js";
 import {
   isPathSpecifier,
   parseExtensionSpecifier
-} from "./cli-pwwfxdgb.js";
-import"./cli-aqh6brew.js";
+} from "./cli-t8be9yeb.js";
+import"./cli-s6djx4ma.js";
 import {
   UsageError,
   exitForUsage,
@@ -31,7 +31,7 @@ import {
   rejectUnknownFlags,
   resolveProjectDir
 } from "./cli-d8xjns66.js";
-import"./cli-kh8v4vvw.js";
+import"./cli-5jzyw06s.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{extension-restore-s3x1618g.js → extension-restore-9dh7c4tp.js}

@@ -3,8 +3,8 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./index-x3ema2w3.js";
-import"./index-2bjcghze.js";
+} from "./index-7pck1q9c.js";
+import"./index-0wee4408.js";
 import"./index-46ycxe6r.js";
 import"./index-5x42amh8.js";
 import"./index-37x76zdn.js";

package/dist/{extension-restore-g8jnmmzq.js → extension-restore-tmxtzkm0.js}

@@ -3,11 +3,11 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./cli-sdmv4bba.js";
-import"./cli-pwwfxdgb.js";
-import"./cli-aqh6brew.js";
+} from "./cli-h4x81x97.js";
+import"./cli-t8be9yeb.js";
+import"./cli-s6djx4ma.js";
 import"./cli-d8xjns66.js";
-import"./cli-kh8v4vvw.js";
+import"./cli-5jzyw06s.js";
 import"./cli-46ycxe6r.js";
 import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";