gutterpress 0.11.23-alpha.2 → 0.11.23-alpha.4

package/dist/{cli-sdmv4bba.js → index-kaks3mm2.js}

@@ -1,4 +1,5 @@
 import {
+  BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
   TWO_VERSIONS_OPEN,
   bundledExtension,
@@ -6,22 +7,18 @@ import {
   extensionStyleList,
   isPathSpecifier,
   loadPlugin,
+  log,
   parseExtensionSpecifier,
   pinnedNpmSpecifier,
   prettify,
   readExtensionMeta,
+  resolveExtension,
   slugify
-} from "./cli-pwwfxdgb.js";
-import {
-  log
-} from "./cli-aqh6brew.js";
-import {
-  UsageError
-} from "./cli-d8xjns66.js";
+} from "./index-8ywkd2sv.js";
 import {
   BuildError,
   EXIT_CODES
-} from "./cli-46ycxe6r.js";
+} from "./index-46ycxe6r.js";
 import {
   EXTENSIONS_DIR,
   VENDORED_NPM_DIR,
@@ -34,10 +31,10 @@ import {
   vendoredNpmPluginRoot,
   vendoredNpmPluginRoots,
   windowsPathKey
-} from "./cli-y28j019d.js";
+} from "./index-5x42amh8.js";
 import {
   __require
-} from "./cli-37x76zdn.js";
+} from "./index-37x76zdn.js";
 
 // src/lib/extension-restore.ts
 import path5 from "node:path";
@@ -94,6 +91,117 @@ 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/constants.ts
+var NETWORK = {
+  DEFAULT_PORT: 3579
+};
+var DEBOUNCE = {
+  FILE_WATCH: 100
+};
+
+// src/lib/cli-args.ts
+class UsageError extends Error {
+  exitCode;
+  constructor(message, exitCode = EXIT_CODES.USAGE) {
+    super(message);
+    this.name = "UsageError";
+    this.exitCode = exitCode;
+  }
+}
+function resolvePort(raw) {
+  if (raw === undefined)
+    return NETWORK.DEFAULT_PORT;
+  if (raw === "" || typeof raw === "string" && raw.trim() === "") {
+    throw new UsageError("--port requires a value.");
+  }
+  const n = typeof raw === "number" || typeof raw === "string" ? Number(raw) : NaN;
+  if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0 || n > 65535) {
+    throw new UsageError(`Invalid --port value: "${raw}". Expected an integer from 0 to 65535 (0 = OS-assigned).`);
+  }
+  return n;
+}
+
 // src/lib/presets.ts
 var PRESET_IDS = ["dtrpg", "book", "custom"];
 var DTRPG_PRESET = {
@@ -104,9 +212,7 @@ var DTRPG_PRESET = {
   },
   defaultTargets: ["dtrpg"],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 4, reserveLastPage: true, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -124,59 +230,30 @@ var DTRPG_PRESET = {
     bleed: 9,
     safe: 36,
     artSafe: 18,
-    gutter: 36
+    gutter: 36,
+    margin: undefined
   },
   ink: {
     maxTac: 240,
     tacTolerance: 0.5
   },
-  lint: {
-    enabled: true,
-    configPath: null,
-    rules: {}
+  checks: {
+    "pdf.structure.qpdf": "error",
+    "pdf.print.pdfx-markers": "error",
+    "pdf.print.pdfx-metadata": "error",
+    "pdf.print.embedded-fonts": "error",
+    "pdf.print.safe-margins": "error",
+    "pdf.print.bleed": "off",
+    "pdf.nav.bookmarks": "off",
+    "pdf.nav.toc-links": "off",
+    "asset.font.license": "off"
   },
   validate: {
-    enabled: true,
-    checks: {
-      "pdf.structure.qpdf": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.pdfx-markers": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.pdfx-metadata": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.embedded-fonts": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.safe-margins": {
-        enabled: true,
-        severity: "error"
-      }
-    },
-    source: {
-      markdownlint: null,
-      htmlhint: null,
-      stylelint: null,
-      cssOwnership: null
-    },
     assets: {
-      maxImageSize: 1e7,
-      allowAlpha: false,
-      approvedFontFiles: [],
-      requireFontLicense: false
+      maxImageSize: 1e7
     },
     pdf: {
-      requireBookmarks: false,
-      requireTocLinks: false,
       minImageResolution: 300,
-      forbidTransparency: true,
-      requireBleed: false,
       bleedSize: 9
     },
     heuristics: {
@@ -190,9 +267,7 @@ var BOOK_PRESET = {
   id: "book",
   defaultTargets: [],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 1, reserveLastPage: false, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -210,53 +285,32 @@ var BOOK_PRESET = {
     bleed: undefined,
     safe: 18,
     artSafe: undefined,
-    gutter: undefined
+    gutter: undefined,
+    margin: undefined
   },
   ink: {
     maxTac: 400,
     tacTolerance: 0.5
   },
-  lint: {
-    enabled: true,
-    configPath: null,
-    rules: {}
+  checks: {
+    "pdf.structure.qpdf": "error",
+    "pdf.print.embedded-fonts": "error",
+    "pdf.print.safe-margins": "warning",
+    "pdf.print.pdfx-markers": "off",
+    "pdf.print.pdfx-metadata": "off",
+    "pdf.print.transparency": "off",
+    "asset.image.alpha-channel": "off",
+    "pdf.print.bleed": "off",
+    "pdf.nav.bookmarks": "off",
+    "pdf.nav.toc-links": "off",
+    "asset.font.license": "off"
   },
   validate: {
-    enabled: true,
-    checks: {
-      "pdf.structure.qpdf": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.embedded-fonts": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.safe-margins": {
-        enabled: true,
-        severity: "warning"
-      },
-      "pdf.print.pdfx-markers": false,
-      "pdf.print.pdfx-metadata": false
-    },
-    source: {
-      markdownlint: null,
-      htmlhint: null,
-      stylelint: null,
-      cssOwnership: null
-    },
     assets: {
-      maxImageSize: 1e7,
-      allowAlpha: true,
-      approvedFontFiles: [],
-      requireFontLicense: false
+      maxImageSize: 1e7
     },
     pdf: {
-      requireBookmarks: false,
-      requireTocLinks: false,
       minImageResolution: 300,
-      forbidTransparency: false,
-      requireBleed: false,
       bleedSize: 9
     },
     heuristics: {
@@ -309,16 +363,16 @@ var DTRPG_TARGET = {
       maxTac: DTRPG_PRESET.ink.maxTac,
       tacTolerance: DTRPG_PRESET.ink.tacTolerance
     },
+    checks: {
+      "pdf.structure.qpdf": "error",
+      "pdf.print.pdfx-markers": "error",
+      "pdf.print.pdfx-metadata": "error",
+      "pdf.print.embedded-fonts": "error",
+      "pdf.print.safe-margins": "error",
+      "pdf.print.transparency": "on"
+    },
     validate: {
-      checks: {
-        "pdf.structure.qpdf": { enabled: true, severity: "error" },
-        "pdf.print.pdfx-markers": { enabled: true, severity: "error" },
-        "pdf.print.pdfx-metadata": { enabled: true, severity: "error" },
-        "pdf.print.embedded-fonts": { enabled: true, severity: "error" },
-        "pdf.print.safe-margins": { enabled: true, severity: "error" }
-      },
       pdf: {
-        forbidTransparency: DTRPG_PRESET.validate.pdf.forbidTransparency,
         minImageResolution: DTRPG_PRESET.validate.pdf.minImageResolution
       }
     }
@@ -336,22 +390,22 @@ var ITCH_TARGET = {
   id: "itch",
   label: "itch.io",
   overlay: {
+    checks: {
+      "pdf.structure.qpdf": "error",
+      "pdf.print.embedded-fonts": "error",
+      "pdf.print.pdfx-markers": "off",
+      "pdf.print.pdfx-metadata": "off",
+      "pdf.print.ink-coverage": "off",
+      "pdf.print.safe-margins": "off",
+      "pdf.print.transparency": "off",
+      "pdf.print.bleed": "off",
+      "asset.image.alpha-channel": "off"
+    },
     validate: {
-      checks: {
-        "pdf.structure.qpdf": { enabled: true, severity: "error" },
-        "pdf.print.embedded-fonts": { enabled: true, severity: "error" },
-        "pdf.print.pdfx-markers": false,
-        "pdf.print.pdfx-metadata": false,
-        "pdf.print.ink-coverage": false,
-        "pdf.print.safe-margins": false
-      },
       assets: {
-        allowAlpha: true,
         maxImageSize: 0
       },
       pdf: {
-        forbidTransparency: false,
-        requireBleed: false,
         minImageResolution: 0
       }
     }
@@ -390,9 +444,9 @@ function overlayPreset(preset, target) {
     ...preset,
     pdfx: { ...preset.pdfx, ...o.pdfx },
     ink: { ...preset.ink, ...o.ink },
+    checks: { ...preset.checks, ...o.checks },
     validate: {
       ...preset.validate,
-      checks: { ...preset.validate.checks, ...o.validate?.checks },
       assets: { ...preset.validate.assets, ...o.validate?.assets },
       pdf: { ...preset.validate.pdf, ...o.validate?.pdf }
     }
@@ -407,17 +461,134 @@ var DEFAULT_STRICT_PDF_CHECKS = [
 function applyDefaultPdfStrictChecks(config) {
   const next = structuredClone(config);
   for (const checkId of DEFAULT_STRICT_PDF_CHECKS) {
-    if (next.validate.checks[checkId] === undefined) {
-      next.validate.checks[checkId] = { enabled: true, severity: "error" };
-    }
+    if (next.checks[checkId] === undefined)
+      next.checks[checkId] = "error";
   }
   return next;
 }
 
+// src/lib/manifest-old-spellings.ts
+var SOURCE_TOOL_CHECKS = {
+  markdownlint: "source.markdownlint",
+  htmlhint: "source.htmlhint",
+  stylelint: "source.stylelint",
+  cssOwnership: "source.css-ownership"
+};
+var FLAG_CHECKS = {
+  "assets.allowAlpha": { check: "asset.image.alpha-channel", trueMeansOn: false },
+  "assets.requireFontLicense": { check: "asset.font.license", trueMeansOn: true },
+  "pdf.requireBookmarks": { check: "pdf.nav.bookmarks", trueMeansOn: true },
+  "pdf.requireTocLinks": { check: "pdf.nav.toc-links", trueMeansOn: true },
+  "pdf.requireBleed": { check: "pdf.print.bleed", trueMeansOn: true },
+  "pdf.forbidTransparency": { check: "pdf.print.transparency", trueMeansOn: true }
+};
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function readOldSpellings(raw) {
+  const { source, lint, validate, ink, ...manifest } = raw;
+  const tolerance = isObject(raw.page) && "tolerance" in raw.page;
+  if (source === undefined && lint === undefined && validate === undefined && ink === undefined && !tolerance) {
+    return raw;
+  }
+  if (isObject(source) && source.assets !== undefined) {
+    throw new UsageError("Manifest field `source.assets` is no longer supported — remove it.\n" + "  Assets are discovered from what your book actually references, so no list is needed.");
+  }
+  const renamed = [];
+  const dropped = [];
+  const checks = {};
+  if (isObject(source) && "files" in source) {
+    renamed.push("source.files -> chapters");
+    if (manifest.chapters === undefined)
+      manifest.chapters = source.files ?? null;
+  }
+  if (isObject(validate)) {
+    for (const [id, entry] of Object.entries(validate.checks ?? {})) {
+      if (entry === false || isObject(entry) && entry.enabled === false)
+        checks[id] = "off";
+      else if (isObject(entry) && typeof entry.severity === "string")
+        checks[id] = entry.severity;
+      else
+        checks[id] = "on";
+    }
+    if (validate.checks !== undefined)
+      renamed.push("validate.checks -> checks");
+    for (const [tool, value] of Object.entries(validate.source ?? {})) {
+      const id = SOURCE_TOOL_CHECKS[tool];
+      if (id && value === false) {
+        checks[id] = "off";
+        renamed.push(`validate.source.${tool}: false -> checks: { ${id}: off }`);
+      } else if (id && tool !== "stylelint" && typeof value === "string") {
+        dropped.push(`validate.source.${tool} (the config file is found by its usual name in the book's folder or a folder above it)`);
+      } else {
+        dropped.push(`validate.source.${tool}`);
+      }
+    }
+    for (const block of ["assets", "pdf", "heuristics"]) {
+      for (const [key, value] of Object.entries(validate[block] ?? {})) {
+        const flag = FLAG_CHECKS[`${block}.${key}`];
+        if (flag && typeof value === "boolean") {
+          const level = value === flag.trueMeansOn ? "on" : "off";
+          checks[flag.check] = level;
+          renamed.push(`validate.${block}.${key}: ${value} -> checks: { ${flag.check}: ${level} }`);
+        } else {
+          dropped.push(`validate.${block}.${key} (the preset and the publish target set it)`);
+        }
+      }
+    }
+    if (validate.enabled !== undefined) {
+      dropped.push("validate.enabled (`gutterpress build --skip-pre-validate --skip-post-validate` skips validation for one build)");
+    }
+  }
+  if (isObject(lint)) {
+    for (const [id, level] of Object.entries(lint.rules ?? {}))
+      checks[id] = level;
+    if (lint.rules !== undefined)
+      renamed.push("lint.rules -> checks");
+    if (lint.enabled === false) {
+      checks["source.stylelint"] = "off";
+      renamed.push("lint.enabled: false -> checks: { source.stylelint: off }");
+    } else if (lint.enabled !== undefined) {
+      dropped.push("lint.enabled");
+    }
+    if (lint.configPath !== undefined)
+      dropped.push("lint.configPath");
+  }
+  if (ink !== undefined)
+    dropped.push("ink (the preset and the publish target set it)");
+  if (tolerance) {
+    const { tolerance: _, ...page } = raw.page;
+    manifest.page = page;
+    dropped.push("page.tolerance (the preset sets it)");
+  }
+  if (Object.keys(checks).length > 0)
+    manifest.checks = { ...checks, ...manifest.checks };
+  const lines = [
+    ...renamed.map((r) => `  ${r}`),
+    ...dropped.map((d) => `  ${d} — no longer a setting, ignored`)
+  ];
+  if (lines.length > 0) {
+    warnOnce(`old-manifest-spellings:${lines.join("|")}`, "[gutterpress] manifest.yaml uses spellings 0.11.23 replaced. They still work in this " + `release; rewrite them before the next one:
+` + lines.join(`
+`));
+  }
+  return manifest;
+}
+
 // src/lib/manifest.ts
 var MANIFEST_FILENAMES = [
   "manifest.yaml"
 ];
+function hasProjectManifest(dir) {
+  return MANIFEST_FILENAMES.some((name) => {
+    const candidate = resolve(dir, name);
+    try {
+      return statSync(candidate).isFile();
+    } catch {
+      return false;
+    }
+  });
+}
 async function loadManifest(pathOrDir) {
   const { manifest } = await loadManifestWithPath(pathOrDir);
   return manifest;
@@ -431,8 +602,8 @@ async function loadManifestWithPath(pathOrDir, opts) {
         throw new UsageError(`"${p}" has two versions of a setting — yours and the online version — left by a sync. Open it, keep the one you want and delete the marker lines.`);
       }
       try {
-        const manifest = parseYaml(raw) ?? {};
-        return { manifest, manifestDir: dirname(p), manifestPath: p };
+        const parsed = parseYaml(raw) ?? {};
+        return { manifest: readOldSpellings(parsed), manifestDir: dirname(p), manifestPath: p };
       } catch (error) {
         if (!(error instanceof YAMLParseError))
           throw error;
@@ -568,32 +739,37 @@ function resolveCustomPage(c, m) {
   return {
     width,
     height,
-    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
+    tolerance: 0.5,
     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;
-  const legacy = m;
-  if (legacy.output !== undefined || legacy.source?.assets !== undefined) {
-    const stale = [
-      legacy.output !== undefined ? "`output`" : null,
-      legacy.source?.assets !== undefined ? "`source.assets`" : null
-    ].filter(Boolean);
-    throw new UsageError(`Manifest field(s) ${stale.join(" and ")} are no longer supported — remove them.
-` + "  Output goes to `dist/<title-slug>/` automatically (use `--out` for a one-off location).\n" + "  Assets are discovered from what your book actually references, so no list is needed.");
-  }
-  if ((m.validate?.source?.allowedCallouts?.length ?? 0) > 0 || (c.validate?.source?.allowedCallouts?.length ?? 0) > 0) {
-    warnOnce("allowed-callouts-deprecated", "[gutterpress] manifest field `validate.source.allowedCallouts` is " + "deprecated and ignored. The `:::` container syntax it gated was " + "removed 2026-05-17. See docs/migrations/2026-05-removing-container-syntax.md.");
-  }
-  for (const key of ["minImageDpi", "allowedColorSpaces"]) {
-    if (m.validate?.assets?.[key] !== undefined || c.validate?.assets?.[key] !== undefined) {
-      warnOnce(`assets-${key}-deprecated`, `[gutterpress] manifest field \`validate.assets.${key}\` is deprecated and ` + "ignored. The source-image check it configured was removed; the build " + "and the PDF checks measure what actually prints.");
-    }
+  if (m.output !== undefined) {
+    throw new UsageError("Manifest field `output` is no longer supported — remove it.\n" + "  Output goes to `dist/<title-slug>/` automatically (use `--out` for a one-off location).");
   }
   const removed = m;
   if (removed.engine !== undefined) {
@@ -627,6 +803,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 ?? [],
@@ -636,25 +815,37 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
     styles: c.styles ?? m.styles,
     extensions,
     targets: resolveTargets(c.targets ?? m.targets, preset.defaultTargets),
-    source: mergeShape(c.source, m.source, preset.source),
+    chapters: c.chapters ?? m.chapters ?? preset.chapters,
+    checks: { ...preset.checks, ...resolveCheckLevels(m.checks), ...resolveCheckLevels(c.checks) },
     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),
-    ink: mergeShape(c.ink, m.ink, preset.ink),
-    lint: {
-      ...mergeShape(c.lint, m.lint, preset.lint),
-      rules: { ...preset.lint.rules, ...m.lint?.rules, ...c.lint?.rules }
-    },
-    validate: {
-      enabled: c.validate?.enabled ?? m.validate?.enabled ?? preset.validate.enabled,
-      checks: { ...preset.validate.checks, ...m.validate?.checks, ...c.validate?.checks },
-      source: mergeShape(c.validate?.source, m.validate?.source, preset.validate.source),
-      assets: mergeShape(c.validate?.assets, m.validate?.assets, preset.validate.assets),
-      pdf: mergeShape(c.validate?.pdf, m.validate?.pdf, preset.validate.pdf),
-      heuristics: mergeShape(c.validate?.heuristics, m.validate?.heuristics, preset.validate.heuristics)
-    }
+    page,
+    ink: structuredClone(preset.ink),
+    validate: structuredClone(preset.validate)
   };
 }
+function resolveCheckLevels(input) {
+  if (input === undefined || input === null)
+    return {};
+  if (!isPlainObject(input)) {
+    throw new UsageError("Manifest field `checks` must map check ids to off, on, info, warn or error.");
+  }
+  const out = {};
+  for (const [id, value] of Object.entries(input)) {
+    if (value === false || value === "off")
+      out[id] = "off";
+    else if (value === true || value === "on")
+      out[id] = "on";
+    else if (value === "warn" || value === "warning")
+      out[id] = "warning";
+    else if (value === "info" || value === "error")
+      out[id] = value;
+    else {
+      throw new UsageError(`Manifest field \`checks.${id}\` must be off, on, info, warn or error, got ${JSON.stringify(value)}.`);
+    }
+  }
+  return out;
+}
 
 // src/lib/manifest-doc.ts
 function resolveManifestPath(projectDir) {
@@ -703,6 +894,13 @@ function ensureSeq(doc, key) {
   }
   return seq;
 }
+function scalarString(item) {
+  if (item && typeof item === "object" && "value" in item) {
+    const v = item.value;
+    return typeof v === "string" ? v : null;
+  }
+  return typeof item === "string" ? item : null;
+}
 
 // src/lib/npm-plugin-installer.ts
 import { createHash, randomUUID as randomUUID2, timingSafeEqual } from "node:crypto";
@@ -1373,6 +1571,7 @@ function ignoreStatus(gitignore, entry) {
   return dir.unignored || file.unignored ? "negated" : "open";
 }
 var PROJECT_GITIGNORE_ENTRIES = ["dist/", "extensions/npm/"];
+var LEGACY_NPM_LINE = /^\/?plugins\/npm\/?[ \t]*\r?\n?/gm;
 async function ensureProjectGitignore(projectDir) {
   const gitignorePath = path3.join(projectDir, ".gitignore");
   let existing = null;
@@ -1389,10 +1588,11 @@ async function ensureProjectGitignore(projectDir) {
       negated.push(entry);
   }
   if (missing.length > 0) {
-    const lead = existing !== null && existing.length > 0 && !existing.endsWith(`
+    const kept = missing.includes("extensions/npm/") ? (existing ?? "").replace(LEGACY_NPM_LINE, "") : existing ?? "";
+    const lead = kept.length > 0 && !kept.endsWith(`
 `) ? `
 ` : "";
-    await writeFile(gitignorePath, `${existing ?? ""}${lead}${missing.join(`
+    await writeFile(gitignorePath, `${kept}${lead}${missing.join(`
 `)}
 `, "utf8");
   }
@@ -1491,7 +1691,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
@@ -1625,6 +1824,29 @@ async function setExtensionEnabled(projectDir, use, enabled) {
     await writeManifestDoc(file, doc);
   });
 }
+async function reorderExtensions(projectDir, order) {
+  return withMutationLock(projectDir, async () => {
+    const { doc, file } = await loadManifestDoc(projectDir);
+    const seq = doc.get("extensions", true);
+    if (!isSeq2(seq))
+      throw new Error(`No extensions are configured in ${path4.basename(file)}.`);
+    const items = seq.items;
+    const current = items.map((item) => entryUse(item));
+    const wanted = order.map((u) => u.trim());
+    const sameSet = current.length === wanted.length && [...current].sort().join(`
+`) === [...wanted].sort().join(`
+`);
+    if (!sameSet) {
+      throw new Error("The new order must list every configured extension exactly once — reload the list and try again.");
+    }
+    const remaining = [...items];
+    seq.items = wanted.map((u) => {
+      const i = remaining.findIndex((item) => entryUse(item) === u);
+      return remaining.splice(i, 1)[0];
+    });
+    await writeManifestDoc(file, doc);
+  });
+}
 async function removeExtension(projectDir, use) {
   return withMutationLock(projectDir, async () => {
     const { doc, file } = await loadManifestDoc(projectDir);
@@ -1763,6 +1985,7 @@ async function vendorNpmExtension(projectDir, input, exportName, options, commit
   await finalizeNpmPluginInstall(installed).catch((error) => {
     warnings.push(`The extension was installed, but an old backup could not be removed: ` + `${error instanceof Error ? error.message : String(error)}`);
   });
+  warnings.push(...await retireLegacyCopies(projectDir, installed.name));
   try {
     const { negated } = await ensureProjectGitignore(projectDir);
     if (negated.includes("extensions/npm/")) {
@@ -1773,6 +1996,19 @@ async function vendorNpmExtension(projectDir, input, exportName, options, commit
   }
   return { name: installed.name, version: installed.version, use, warnings };
 }
+async function retireLegacyCopies(projectDir, name) {
+  const legacyPackageDir = path4.dirname(vendoredNpmPluginRoots(projectDir, name, "0.0.0")[1]);
+  const legacyNpmDir = path4.dirname(legacyPackageDir);
+  try {
+    await rm3(legacyPackageDir, { recursive: true, force: true });
+    await removeEmptyDirs([path4.dirname(legacyNpmDir), legacyNpmDir]);
+  } catch (error) {
+    return [
+      `The extension was installed, but the copy an older version of Gutterpress kept under plugins/npm/ ` + `could not be removed: ${error instanceof Error ? error.message : String(error)}`
+    ];
+  }
+  return [];
+}
 async function pinnedVersionsOf(projectDir, name) {
   const { doc } = await loadManifestDoc(projectDir);
   const seq = doc.get("extensions", true);
@@ -1870,6 +2106,9 @@ async function latestNpmVersion(name, options) {
   }
   return latest;
 }
+async function listNpmVersions(name, options = {}) {
+  return (await fetchNpmVersions(name, options)).versions.sort(semverRcompare);
+}
 async function checkExtensionUpdates(projectDir, options = {}) {
   const entries = await listProjectExtensions(projectDir);
   const pinned = entries.filter((e) => e.kind === "npm" && e.version);
@@ -1900,6 +2139,14 @@ async function updateExtensions(projectDir, options = {}) {
   }
   return updated;
 }
+function listBundledExtensions() {
+  return BUNDLED_EXTENSIONS.map((b) => ({
+    use: b.name,
+    label: b.label,
+    description: b.description,
+    look: b.css !== undefined
+  }));
+}
 async function uniqueExtensionId(projectDir, base) {
   const slug = slugify(base) || "extension";
   let candidate = slug;
@@ -1908,6 +2155,51 @@ async function uniqueExtensionId(projectDir, base) {
   }
   return candidate;
 }
+async function validateProjectExtensions(projectDir) {
+  const out = [];
+  for (const entry of await listProjectExtensions(projectDir)) {
+    if (!entry.enabled) {
+      out.push({ use: entry.use, kind: entry.kind, enabled: false, ok: true });
+      continue;
+    }
+    try {
+      await loadPlugin(extensionConfigFor(entry), projectDir);
+      out.push({ use: entry.use, kind: entry.kind, enabled: true, ok: true });
+    } catch (e) {
+      out.push({
+        use: entry.use,
+        kind: entry.kind,
+        enabled: true,
+        ok: false,
+        error: e instanceof Error ? e.message : String(e)
+      });
+    }
+  }
+  return out;
+}
+async function readExtensionCss(projectDir, use) {
+  const direct = bundledExtension(use)?.css;
+  if (direct !== undefined)
+    return direct;
+  const entry = await describeExtension(projectDir, use);
+  if (!entry)
+    throw new Error(`Extension "${use}" is not in the manifest.`);
+  return readEntryCss(entry);
+}
+async function readEntryCss(entry) {
+  const direct = bundledExtension(entry.use)?.css;
+  if (direct !== undefined)
+    return direct;
+  if (!entry.dir)
+    throw new Error(`Extension "${entry.use}" has no stylesheets to preview.`);
+  const meta = await readExtensionMeta(entry.dir);
+  const sheets = resolveExtension(entry.dir, meta, `Extension "${entry.use}"`).styles ?? [];
+  if (sheets.length === 0)
+    throw new Error(`Extension "${entry.use}" declares no stylesheets.`);
+  return (await Promise.all(sheets.map((sheet) => readFile5(sheet, "utf8")))).join(`
+
+`);
+}
 
 // src/lib/extension-restore.ts
 var OFFLINE_REASON = "you appear to be offline (npm can't be reached)";
@@ -2026,4 +2318,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, isNonNegativePoints, round3, cssLength, formatPageSize, printAreaMeta, pageBoxes, judgeRect, DEBOUNCE, UsageError, resolvePort, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, MARGIN_EDGES, validatePageMargin, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, scalarString, DEFAULT_NPM_REGISTRY, npmRegistryUrl, ensureProjectGitignore, sameExtension, listProjectExtensions, describeExtension, extensionConfigFor, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listNpmVersions, checkExtensionUpdates, updateExtensions, listBundledExtensions, uniqueExtensionId, validateProjectExtensions, readExtensionCss, readEntryCss, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };