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

package/dist/{index-x3ema2w3.js → cli-y6d1arem.js}

@@ -1,5 +1,4 @@
 import {
-  BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
   TWO_VERSIONS_OPEN,
   bundledExtension,
@@ -7,18 +6,22 @@ import {
   extensionStyleList,
   isPathSpecifier,
   loadPlugin,
-  log,
   parseExtensionSpecifier,
   pinnedNpmSpecifier,
   prettify,
   readExtensionMeta,
-  resolveExtension,
   slugify
-} from "./index-2bjcghze.js";
+} from "./cli-rqh295j9.js";
+import {
+  log
+} from "./cli-pspjxnc8.js";
+import {
+  UsageError
+} from "./cli-d8xjns66.js";
 import {
   BuildError,
   EXIT_CODES
-} from "./index-46ycxe6r.js";
+} from "./cli-46ycxe6r.js";
 import {
   EXTENSIONS_DIR,
   VENDORED_NPM_DIR,
@@ -31,10 +34,10 @@ import {
   vendoredNpmPluginRoot,
   vendoredNpmPluginRoots,
   windowsPathKey
-} from "./index-5x42amh8.js";
+} from "./cli-y28j019d.js";
 import {
   __require
-} from "./index-37x76zdn.js";
+} from "./cli-37x76zdn.js";
 
 // src/lib/extension-restore.ts
 import path5 from "node:path";
@@ -91,34 +94,85 @@ import { existsSync, statSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { parse as parseYaml, YAMLParseError } from "yaml";
 
-// 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;
-  }
+// 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
+  };
 }
-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).`);
+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 n;
+  return worst;
 }
 
 // src/lib/presets.ts
@@ -131,9 +185,7 @@ var DTRPG_PRESET = {
   },
   defaultTargets: ["dtrpg"],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 4, reserveLastPage: true, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -151,59 +203,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: {
@@ -217,9 +240,7 @@ var BOOK_PRESET = {
   id: "book",
   defaultTargets: [],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 1, reserveLastPage: false, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -237,53 +258,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: {
@@ -336,16 +336,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
       }
     }
@@ -363,22 +363,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
       }
     }
@@ -417,9 +417,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 }
     }
@@ -434,27 +434,124 @@ 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;
@@ -468,8 +565,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;
@@ -605,32 +702,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) {
@@ -664,6 +766,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 ?? [],
@@ -673,25 +778,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) {
@@ -740,13 +857,6 @@ 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";
@@ -1417,6 +1527,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;
@@ -1433,10 +1544,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");
   }
@@ -1535,7 +1647,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
@@ -1669,29 +1780,6 @@ 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);
@@ -1830,6 +1918,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/")) {
@@ -1840,6 +1929,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);
@@ -1937,9 +2039,6 @@ 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);
@@ -1970,14 +2069,6 @@ 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;
@@ -1986,48 +2077,6 @@ 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 entry = await describeExtension(projectDir, use);
-  if (!entry)
-    throw new Error(`Extension "${use}" is not in the manifest.`);
-  const bundledCss = entry.kind === "bundled" ? bundledExtension(entry.name)?.css : undefined;
-  if (bundledCss !== undefined)
-    return bundledCss;
-  if (!entry.dir)
-    throw new Error(`Extension "${use}" has no stylesheets to preview.`);
-  const meta = await readExtensionMeta(entry.dir);
-  const sheets = resolveExtension(entry.dir, meta, `Extension "${use}"`).styles ?? [];
-  if (sheets.length === 0)
-    throw new Error(`Extension "${use}" declares no stylesheets.`);
-  const parts = [];
-  for (const sheet of sheets)
-    parts.push(await readFile5(sheet, "utf8"));
-  return parts.join(`
-
-`);
-}
 
 // src/lib/extension-restore.ts
 var OFFLINE_REASON = "you appear to be offline (npm can't be reached)";
@@ -2146,4 +2195,4 @@ async function restoreForCommand(dir, options) {
     log.warn(problem);
 }
 
-export { DEBOUNCE, UsageError, resolvePort, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, ensureSeq, scalarString, DEFAULT_NPM_REGISTRY, npmRegistryUrl, ensureProjectGitignore, sameExtension, listProjectExtensions, describeExtension, extensionConfigFor, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listNpmVersions, checkExtensionUpdates, updateExtensions, listBundledExtensions, uniqueExtensionId, validateProjectExtensions, readExtensionCss, 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 };