gutterpress 0.11.23-alpha.3 → 0.11.23-alpha.4

package/dist/{index-7pck1q9c.js → index-kaks3mm2.js}

@@ -14,7 +14,7 @@ import {
   readExtensionMeta,
   resolveExtension,
   slugify
-} from "./index-0wee4408.js";
+} from "./index-8ywkd2sv.js";
 import {
   BuildError,
   EXIT_CODES
@@ -212,9 +212,7 @@ var DTRPG_PRESET = {
   },
   defaultTargets: ["dtrpg"],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 4, reserveLastPage: true, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -239,53 +237,23 @@ var DTRPG_PRESET = {
     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: {
@@ -299,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",
@@ -326,47 +292,25 @@ var BOOK_PRESET = {
     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: {
@@ -419,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
       }
     }
@@ -446,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
       }
     }
@@ -500,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 }
     }
@@ -517,13 +461,120 @@ 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"
@@ -551,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;
@@ -688,7 +739,7 @@ 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,
@@ -717,22 +768,8 @@ function validatePageMargin(margin, size) {
 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) {
@@ -778,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,
-    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)
-    }
+    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) {
@@ -1522,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;
@@ -1538,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");
   }
@@ -1934,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/")) {
@@ -1944,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);

package/dist/{index-nvmf22rt.js → index-yc3xj266.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-nedd07bk.js";
+} from "./index-5kh4c78h.js";
 import {
   launchChromium
 } from "./index-bt0qws5c.js";

package/dist/index.js

@@ -116,7 +116,7 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-prqvz3xm.js";
+} from "./index-ea94zbq4.js";
 import {
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
@@ -146,7 +146,7 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-7pck1q9c.js";
+} from "./index-kaks3mm2.js";
 import {
   BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
@@ -162,16 +162,16 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-0wee4408.js";
+} from "./index-8ywkd2sv.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-nvmf22rt.js";
-import"./index-nedd07bk.js";
+} from "./index-yc3xj266.js";
+import"./index-5kh4c78h.js";
 import {
   BuildError
 } from "./index-46ycxe6r.js";
-import"./index-2ppw6q9v.js";
+import"./index-5crpmz42.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/build-preflight.d.ts

@@ -28,9 +28,10 @@ export interface Gates {
      * Disable the `source.stylelint` check (CSS print-safety: remote urls,
      * risky print effects, page-containment) for this run, without touching
      * `preValidate` itself (#272 — one CSS gate, not two). `true` when
-     * `--skip-lint` was passed or `config.lint.enabled === false`; consulted
-     * only when `preValidate` is also true — with `preValidate` off, no
-     * pre-build check (CSS included) runs at all, `--skip-lint` or not.
+     * `--skip-lint` was passed (a book switches it off for good with
+     * `checks: { source.stylelint: off }`); consulted only when `preValidate`
+     * is also true — with `preValidate` off, no pre-build check (CSS
+     * included) runs at all, `--skip-lint` or not.
      */
     skipStylelint: boolean;
     preValidate: boolean;
@@ -40,11 +41,4 @@ export declare function computeGates(format: BuildFormat, opts: {
     skipLint?: boolean;
     skipPreValidate?: boolean;
     skipPostValidate?: boolean;
-}, config: {
-    lint: {
-        enabled: boolean;
-    };
-    validate: {
-        enabled: boolean;
-    };
 }): Gates;

package/dist/lib/build-runner.d.ts

@@ -131,7 +131,7 @@ export interface BuildContext {
     inputDir: string;
     /**
      * THE anchor every manifest-relative path resolves against: `styles:`,
-     * `source.files`, authored plugin `path:` entries, and the CSS print-safety
+     * `chapters`, authored plugin `path:` entries, and the CSS print-safety
      * check's stylesheet resolution. Equal to {@link BuildContext.manifestDir}.
      *
      * It is NOT `inputDir`. The two are identical in the normative layout (the

package/dist/lib/ghostscript.d.ts

@@ -1,4 +1,4 @@
-import type { UnsplittableReason } from "./pdf-inspect";
+import { type UnsplittableReason } from "./pdf-inspect";
 /**
  * Resolve the Ghostscript command on every supported platform.
  *
@@ -57,7 +57,10 @@ export declare function transparentPages(pdfBytes: Uint8Array): Promise<number[]
  * these shadings.
  *
  * Walks page resources (and form XObjects they draw) rather than every
- * object, so only shadings a page can actually paint are reported. Like
+ * object, so only shadings a page can actually paint are reported; of those
+ * pages, only the ones that paint a shading with a visible area (#438: a box
+ * that opens the NEXT page is also in this page's content as a sliver —
+ * `pagesWithVisibleShadingPaints`, pdf-inspect.ts). Like
  * {@link transparentPages}, it never fails a build: an unparseable PDF
  * reports no pages.
  */

package/dist/lib/lint-rules.d.ts

@@ -1,5 +1,9 @@
 export type LintLevel = "off" | "warn" | "error";
-/** Read one rule's configured level; unrecognised values are ignored. */
+/**
+ * Read one rule's configured level; unrecognised values (and `on`) leave the
+ * rule at its own severity. A lint rule reports at warning or error, so
+ * `info` reads as warning.
+ */
 export declare function ruleLevel(rules: Readonly<Record<string, unknown>> | undefined, id: string): LintLevel | undefined;
 /**
  * The rule ids named by a `gutterpress-disable-next-line <id>[, <id>...]

package/dist/lib/manifest-config.d.ts

@@ -2,7 +2,7 @@
 export interface ProjectConfigFields {
     title?: string;
     authors?: string[];
-    /** `source.files` — the markdown inputs (null means "all chapter files"). */
+    /** `chapters` — the markdown inputs (null means "all chapter files"). */
     sourceFiles?: string[] | null;
     /**
      * `targets:` — the publish destinations this book is validated against
@@ -16,7 +16,8 @@ export interface ProjectConfigFields {
  * Apply the author-facing manifest field updates in a single yaml round-trip.
  * Only the keys present in `updates` are written; everything else is left
  * untouched (so unrelated comments + sections survive). `sourceFiles: null`
- * deletes the `source.files` entry (back to "all chapter files").
+ * deletes the `chapters` entry (back to "all chapter files"). Either way an
+ * older book's `source.files` is taken out, so the list has one spelling.
  */
 export declare function setManifestFields(projectDir: string, updates: ProjectConfigFields): Promise<ProjectConfigFields>;
 /**