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

package/dist/{index-prqvz3xm.js → index-ea94zbq4.js}

@@ -37,7 +37,7 @@ import {
   validatePageMargin,
   withFetchTimeout,
   writeManifestDoc
-} from "./index-7pck1q9c.js";
+} from "./index-kaks3mm2.js";
 import {
   EXTENSION_MANIFEST_FILENAME,
   GUTTERPRESS_CSS,
@@ -73,7 +73,7 @@ import {
   setLogLevel,
   slugify,
   warn
-} from "./index-0wee4408.js";
+} from "./index-8ywkd2sv.js";
 import {
   blackTextToGray
 } from "./index-ht1bcqdd.js";
@@ -84,7 +84,7 @@ import {
   getAssetPath,
   lastPageMode,
   resolvePage
-} from "./index-nedd07bk.js";
+} from "./index-5kh4c78h.js";
 import {
   BuildError
 } from "./index-46ycxe6r.js";
@@ -99,8 +99,9 @@ import {
   isLoadable,
   loadPdf,
   pageHasMarks,
+  pagesWithVisibleShadingPaints,
   retainPdfCache
-} from "./index-2ppw6q9v.js";
+} from "./index-5crpmz42.js";
 import {
   INSTALL_HINTS,
   enhancedPath,
@@ -156,14 +157,14 @@ var MSG_UP_TO_DATE = "Everything is in sync.";
 var MSG_UP_TO_DATE_PULLED = "Everything is in sync. The latest online changes were downloaded to this computer.";
 var MSG_SYNCED = "Your changes are online.";
 var MSG_SYNCED_MERGED = "Your changes are online, combined with changes from the online copy.";
-var MSG_OFFLINE = "Your changes are saved on this computer. gutterpress couldn't reach the online repository — try syncing again when you're back online.";
+var MSG_OFFLINE = "Your changes are saved on this computer. Gutterpress couldn't reach the online repository — try syncing again when you're back online.";
 var MSG_AUTH = "The online repository didn't accept the saved connection. Reconnect and try again.";
 var MSG_INSECURE_TRANSPORT = "This book's online address isn't secure, so the saved connection wasn't sent — connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
 var MSG_BUSY = "The online copy is changing very quickly right now. Your work is saved on this computer — try Sync again in a moment.";
 var MSG_HISTORY_UNREADABLE = "This book's version history can't be read, so syncing can't continue. Your writing is safe — every file is still here on this computer. Use Repair online backup (in Where your work is kept) to get history and syncing working again.";
 var MSG_UNRELATED = "This book and the online copy have no history in common, so they can't be combined. Either the online address points at a different book, or this book's own history was lost and started over. Your writing is safe — every file is still here on this computer. Check the online address; if it is correct, use Repair online backup (in Where your work is kept).";
 var MSG_NO_REMOTE = "This book isn't connected to an online repository yet.";
-var MSG_SSH_REMOTE = "This book's online address uses SSH (git@…), which gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
+var MSG_SSH_REMOTE = "This book's online address uses SSH (git@…), which Gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
 var MSG_NO_BRANCH = "This book's version history isn't on a named branch, so it can't be synced right now.";
 var SYNC_SNAPSHOT_MESSAGE = "Automatic backup of your work";
 var SYNC_LATE_EDIT_MESSAGE = "Saved the edit you made while syncing";
@@ -955,7 +956,9 @@ async function findPostScriptShadingPages(pdfBytes) {
     if (usesPostScriptShading(asDict(page.node.Resources())))
       pages.push(i + 1);
   });
-  return pages;
+  if (pages.length === 0)
+    return pages;
+  return pagesWithVisibleShadingPaints(pdfBytes, pages).catch(() => pages);
 }
 async function stripAnnotations(pdfPath, stagingDir) {
   const tmp = join2(stagingDir, "annotations-stripped.pdf");
@@ -1350,7 +1353,7 @@ async function writeBuildFingerprint(input) {
 // src/lib/validation-exec.ts
 import { existsSync as existsSync7 } from "node:fs";
 import { readFile as readFile20 } from "node:fs/promises";
-import { dirname as dirname2, join as join3, resolve as resolve5 } from "node:path";
+import { dirname as dirname3, join as join3, resolve as resolve5 } from "node:path";
 
 // src/lib/markdownlint-fix.ts
 import { readFile as readFile6, writeFile as writeFile4 } from "node:fs/promises";
@@ -1359,18 +1362,20 @@ import { lint as lint2 } from "markdownlint/sync";
 
 // src/checks/source/config-file.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { resolve as resolve2 } from "node:path";
-function findConfigFile(inputDir, names, explicit) {
-  if (explicit) {
-    const p = resolve2(inputDir, explicit);
-    return existsSync3(p) ? p : null;
-  }
-  for (const name of names) {
-    const p = resolve2(inputDir, name);
-    if (existsSync3(p))
-      return p;
+import { dirname, resolve as resolve2 } from "node:path";
+function findConfigFile(startDir, names) {
+  let dir = resolve2(startDir);
+  for (;; ) {
+    for (const name of names) {
+      const p = resolve2(dir, name);
+      if (existsSync3(p))
+        return p;
+    }
+    const parent = dirname(dir);
+    if (existsSync3(resolve2(dir, ".git")) || parent === dir)
+      return null;
+    dir = parent;
   }
-  return null;
 }
 
 // src/checks/source/markdownlint.ts
@@ -1482,17 +1487,13 @@ var check = {
   category: "source",
   phase: "pre-build",
   async run(ctx) {
-    const sourceConfig = ctx.config.validate.source;
-    if (sourceConfig.markdownlint === false)
-      return [];
     const files = ctx.markdownFiles;
     if (!files || files.length === 0)
       return [];
-    const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
-    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
-    if (!resolvedConfig && !configPath)
+    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES);
+    if (!resolvedConfig)
       return [];
-    const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
+    const config = await loadConfig(resolvedConfig);
     const results = lint({ files, config });
     const out = [];
     for (const [file, violations] of Object.entries(results)) {
@@ -1531,8 +1532,7 @@ async function uncommittedAmong(inputDir, files) {
   return files.filter((file) => changed.has(repoSubPath(repoRoot, file)));
 }
 async function applyMarkdownlintFixes(ctx) {
-  const sourceConfig = ctx.config.validate.source;
-  if (sourceConfig.markdownlint === false) {
+  if (ctx.config.checks["source.markdownlint"] === "off") {
     log.warn("--fix: source.markdownlint is disabled for this book — no files were fixed.");
     return [];
   }
@@ -1541,13 +1541,12 @@ async function applyMarkdownlintFixes(ctx) {
     log.warn("--fix: no markdown files to fix.");
     return [];
   }
-  const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
-  const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
-  if (!resolvedConfig && !configPath) {
-    log.warn(`--fix: no markdownlint config found in ${ctx.inputDir} (looked for ${CONFIG_NAMES.join(", ")}) — no files were fixed.`);
+  const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES);
+  if (!resolvedConfig) {
+    log.warn(`--fix: no markdownlint config found in ${ctx.inputDir} or a folder above it (looked for ${CONFIG_NAMES.join(", ")}) — no files were fixed.`);
     return [];
   }
-  const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
+  const config = await loadConfig(resolvedConfig);
   const results = lint2({ files, config });
   const pending = [];
   for (const [file, violations] of Object.entries(results)) {
@@ -1581,10 +1580,7 @@ import { readFile as readFile7 } from "node:fs/promises";
 // src/checks/policy.ts
 var INSPECT_FAILED_CODE = "inspect-failed";
 function isCheckEnabled(check2, config) {
-  const entry = config.validate.checks[check2.id];
-  if (entry === false)
-    return false;
-  if (typeof entry === "object" && entry.enabled === false)
+  if (config.checks[check2.id] === "off")
     return false;
   if (check2.enabledWhen && !check2.enabledWhen(config))
     return false;
@@ -2327,7 +2323,7 @@ var check9 = {
           severity: "warning",
           message: `Dark four-colour text at ${LARGE_TEXT_PT}pt or smaller on page(s) ${found.pages.join(", ")}.`,
           file: ctx.pdfPath,
-          detail: "Small text printed with all four inks can look fuzzy if the plates are slightly out of register, which is why print vendors such as DriveThruRPG want small black text on the black plate alone. `pdfx.blackText: k-only` already does that for near-black text; this text is either a dark colour (for example a dark brown, which keeps its colour) or painted in a way the build cannot rewrite (an image or a pattern). To print it on the black plate, make the text black (#000). If the colour is intended, set `lint.rules: { pdf.print.black-text: off }` in manifest.yaml.",
+          detail: "Small text printed with all four inks can look fuzzy if the plates are slightly out of register, which is why print vendors such as DriveThruRPG want small black text on the black plate alone. `pdfx.blackText: k-only` already does that for near-black text; this text is either a dark colour (for example a dark brown, which keeps its colour) or painted in a way the build cannot rewrite (an image or a pattern). To print it on the black plate, make the text black (#000). If the colour is intended, set `checks: { pdf.print.black-text: off }` in manifest.yaml.",
           code: "rich-black-text",
           data: { runs: found.runs, pages: found.pages }
         })
@@ -2407,8 +2403,6 @@ var check11 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.requireBookmarks)
-      return [];
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
@@ -2441,8 +2435,6 @@ var check12 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.requireTocLinks)
-      return [];
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
@@ -2580,8 +2572,6 @@ var check16 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.forbidTransparency)
-      return [];
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     const found = [];
     if (bytes.includes("/Transparency"))
@@ -2622,8 +2612,6 @@ var check17 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.requireBleed)
-      return [];
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     if (!bytes) {
       return [
@@ -2720,14 +2708,10 @@ var check19 = {
   category: "source",
   phase: "pre-build",
   async run(ctx) {
-    const sourceConfig = ctx.config.validate.source;
-    if (sourceConfig.htmlhint === false)
-      return [];
     if (!ctx.htmlPath || !existsSync4(ctx.htmlPath))
       return [];
-    const configPath = typeof sourceConfig.htmlhint === "string" ? sourceConfig.htmlhint : null;
-    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
-    if (!resolvedConfig && !configPath)
+    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2);
+    if (!resolvedConfig)
       return [];
     const ruleset = resolvedConfig ? JSON.parse(await readFile10(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
     const html = await readFile10(ctx.htmlPath, "utf8");
@@ -2755,7 +2739,7 @@ function ruleLevel(rules, id) {
   const v = rules?.[id];
   if (v === "off" || v === false)
     return "off";
-  if (v === "warn" || v === "warning")
+  if (v === "warn" || v === "warning" || v === "info")
     return "warn";
   if (v === "error")
     return "error";
@@ -3074,7 +3058,7 @@ function checkCssRaw(css, from) {
       warnings.push({
         rule: rulePageSizeInStylesheet,
         severity: "warning",
-        message: `"size" in a stylesheet's @page rule is ignored: the page size comes from the manifest (preset:, or page: width and height — Setup > Details in the app), which is written after every stylesheet. Remove this declaration; to print at another size, change the manifest.`,
+        message: `"size" in a stylesheet's @page rule is ignored: the page size comes from the manifest (preset:, or page: width and height — Setup > Book in the app), which is written after every stylesheet. Remove this declaration; to print at another size, change the manifest.`,
         ...nodeLoc(decl)
       });
       return;
@@ -3174,10 +3158,7 @@ var check20 = {
   description: "Checks CSS for print-safety issues (remote URLs, rasterizing effects, and page-layer containment)",
   category: "source",
   phase: "pre-build",
-  enabledWhen: (config) => config.validate.source.stylelint !== false,
   async run(ctx) {
-    if (ctx.config.validate.source.stylelint === false)
-      return [];
     const files = ctx.cssFiles;
     if (!files || files.length === 0)
       return [];
@@ -3195,7 +3176,7 @@ var check20 = {
         });
         continue;
       }
-      for (const w of checkCss(css, file, { rules: ctx.config.lint.rules })) {
+      for (const w of checkCss(css, file, { rules: ctx.config.checks })) {
         results.push({
           checkId: check20.id,
           severity: w.severity,
@@ -3336,15 +3317,11 @@ var check21 = {
   description: "Checks an optional per-project CSS ownership contract (.gutterpress/css-contract.yaml): which file may declare which properties/at-rules, and which selectors must never appear unscoped.",
   category: "source",
   phase: "pre-build",
-  enabledWhen: (config) => config.validate.source.cssOwnership !== false,
   async run(ctx) {
-    if (ctx.config.validate.source.cssOwnership === false)
-      return [];
     const files = ctx.cssFiles;
     if (!files || files.length === 0)
       return [];
-    const explicit = typeof ctx.config.validate.source.cssOwnership === "string" ? ctx.config.validate.source.cssOwnership : null;
-    const configPath = findConfigFile(ctx.inputDir, CONFIG_NAMES3, explicit);
+    const configPath = findConfigFile(ctx.inputDir, CONFIG_NAMES3);
     if (!configPath)
       return [];
     let contract;
@@ -3411,7 +3388,7 @@ registerCheck(check21);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync5 } from "node:fs";
-import { dirname, resolve as resolve3 } from "node:path";
+import { dirname as dirname2, resolve as resolve3 } from "node:path";
 var check22 = {
   id: "source.links.local-refs",
   name: "Local Markdown References",
@@ -3451,7 +3428,7 @@ function filesystemRef(ref) {
 }
 function localRefExists(ref, kind, sourceFile, projectRoot) {
   const cleaned = filesystemRef(ref);
-  const fileRelative = resolve3(dirname(sourceFile), cleaned);
+  const fileRelative = resolve3(dirname2(sourceFile), cleaned);
   const rootRelative = resolve3(projectRoot, cleaned);
   switch (kind) {
     case "image":
@@ -4527,8 +4504,6 @@ var check30 = {
   category: "asset",
   phase: "pre-build",
   async run(ctx) {
-    if (ctx.config.validate.assets.allowAlpha)
-      return [];
     if (ctx.config.pdfx.transparency === "preserve-text")
       return [];
     const files = shippedImages(ctx, ["png", "tiff", "tif"]);
@@ -4551,58 +4526,6 @@ var check30 = {
 };
 registerCheck(check30);
 
-// src/checks/asset/approved-fonts.ts
-var check31 = {
-  id: "asset.font.approved-files",
-  name: "Approved Font Files",
-  description: "Checks font files against the approved file patterns",
-  category: "asset",
-  phase: "pre-build",
-  async run(ctx) {
-    const patterns = ctx.config.validate.assets.approvedFontFiles;
-    if (!patterns || patterns.length === 0)
-      return [];
-    const { glob } = await import("glob");
-    const dirs = ctx.assetDirs ?? [ctx.inputDir];
-    const allFonts = [];
-    for (const dir of dirs) {
-      const matches = await glob(`**/*.{${FONT_EXTS2.join(",")}}`, {
-        cwd: dir,
-        absolute: true,
-        ignore: [...ASSET_SCAN_IGNORE_GLOBS]
-      });
-      allFonts.push(...matches);
-    }
-    if (allFonts.length === 0)
-      return [];
-    const approvedFonts = new Set;
-    for (const dir of dirs) {
-      for (const pattern of patterns) {
-        const matches = await glob(pattern, {
-          cwd: dir,
-          absolute: true,
-          ignore: [...ASSET_SCAN_IGNORE_GLOBS]
-        });
-        for (const m of matches)
-          approvedFonts.add(m);
-      }
-    }
-    const results = [];
-    for (const font of allFonts) {
-      if (!approvedFonts.has(font)) {
-        results.push({
-          checkId: check31.id,
-          severity: "warning",
-          message: "Font file not in approved list",
-          file: font
-        });
-      }
-    }
-    return results;
-  }
-};
-registerCheck(check31);
-
 // src/checks/asset/font-license.ts
 import { existsSync as existsSync6 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
@@ -4616,15 +4539,13 @@ var LICENSE_NAMES = [
   "OFL-1.1.txt",
   "COPYING"
 ];
-var check32 = {
+var check31 = {
   id: "asset.font.license",
   name: "Font License",
   description: "Checks for license files in font directories",
   category: "asset",
   phase: "pre-build",
   async run(ctx) {
-    if (!ctx.config.validate.assets.requireFontLicense)
-      return [];
     const { glob } = await import("glob");
     const dirs = ctx.assetDirs ?? [ctx.inputDir];
     const fontDirs = new Set;
@@ -4643,7 +4564,7 @@ var check32 = {
       const hasLicense = LICENSE_NAMES.some((name) => existsSync6(resolve4(fontDir, name)));
       if (!hasLicense) {
         results.push({
-          checkId: check32.id,
+          checkId: check31.id,
           severity: "warning",
           message: `No font license file found in directory`,
           file: fontDir
@@ -4653,10 +4574,10 @@ var check32 = {
     return results;
   }
 };
-registerCheck(check32);
+registerCheck(check31);
 
 // src/checks/heuristic/text-density.ts
-var check33 = {
+var check32 = {
   id: "heuristic.whitespace.text-density",
   name: "Text Density",
   description: "Checks characters-per-page ratio",
@@ -4685,7 +4606,7 @@ var check33 = {
     });
     if (lowPages.length > 0) {
       results.push({
-        checkId: check33.id,
+        checkId: check32.id,
         severity: "info",
         message: `Low text density on pages: ${lowPages.join(", ")} (below ${range.min} chars)`,
         file: ctx.pdfPath
@@ -4693,7 +4614,7 @@ var check33 = {
     }
     if (highPages.length > 0) {
       results.push({
-        checkId: check33.id,
+        checkId: check32.id,
         severity: "info",
         message: `High text density on pages: ${highPages.join(", ")} (above ${range.max} chars)`,
         file: ctx.pdfPath
@@ -4702,11 +4623,11 @@ var check33 = {
     return results;
   }
 };
-registerCheck(check33);
+registerCheck(check32);
 
 // src/checks/heuristic/section-density.ts
 import { readFile as readFile19 } from "node:fs/promises";
-var check34 = {
+var check33 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
   description: "Checks heading/paragraph/callout density from source Markdown",
@@ -4732,7 +4653,7 @@ var check34 = {
           const line = lines[i];
           if (/^#{1,6}\s/.test(line)) {
             if (paragraphCount > maxParas) {
-              results.push(finding(check34.id, {
+              results.push(finding(check33.id, {
                 severity: "info",
                 message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
                 file,
@@ -4752,7 +4673,7 @@ var check34 = {
           }
         }
         if (paragraphCount > maxParas) {
-          results.push(finding(check34.id, {
+          results.push(finding(check33.id, {
             severity: "info",
             message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
             file,
@@ -4760,7 +4681,7 @@ var check34 = {
           }));
         }
       } catch {
-        results.push(inspectionFailed(check34.id, `Could not read source file: ${file}`, {
+        results.push(inspectionFailed(check33.id, `Could not read source file: ${file}`, {
           file
         }));
       }
@@ -4768,10 +4689,10 @@ var check34 = {
     return results;
   }
 };
-registerCheck(check34);
+registerCheck(check33);
 
 // src/checks/heuristic/layer-count.ts
-var check35 = {
+var check34 = {
   id: "heuristic.decoration.layer-count",
   name: "Layer Count",
   description: "Counts image objects per page",
@@ -4796,7 +4717,7 @@ var check35 = {
       heavyPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check35.id,
+          checkId: check34.id,
           severity: "info",
           message: `Pages with many image layers (>${maxLayers}): ${heavyPages.join(", ")}`,
           file: ctx.pdfPath
@@ -4806,10 +4727,10 @@ var check35 = {
     return [];
   }
 };
-registerCheck(check35);
+registerCheck(check34);
 
 // src/checks/heuristic/placement-variance.ts
-var check36 = {
+var check35 = {
   id: "heuristic.layout.placement-variance",
   name: "Placement Variance",
   description: "Analyzes text baseline coordinates for layout consistency",
@@ -4827,7 +4748,7 @@ var check36 = {
     const uniqueX = new Set(positions.map((p) => Math.round(p.x)));
     return [
       {
-        checkId: check36.id,
+        checkId: check35.id,
         severity: "info",
         message: `Layout analysis: ${uniqueX.size} unique horizontal text positions across ${positions.length} text blocks.`,
         file: ctx.pdfPath
@@ -4835,19 +4756,14 @@ var check36 = {
     ];
   }
 };
-registerCheck(check36);
+registerCheck(check35);
 
 // src/checks/runner.ts
 function getCheckSeverityOverride(checkId, config) {
-  const entry = config.validate.checks[checkId];
-  if (typeof entry === "object" && entry.severity)
-    return entry.severity;
-  return;
+  const level = config.checks[checkId];
+  return level === "off" || level === "on" ? undefined : level;
 }
 async function runChecks(ctx, opts = {}) {
-  if (ctx.config.validate.enabled === false) {
-    return emptyReport();
-  }
   const { checks: selected, unmatched: unmatchedSelectors } = selectChecks(opts, ctx.config);
   let checks2 = selected;
   if (opts.skipMissingTools && opts.skipMissingTools.length > 0) {
@@ -4865,32 +4781,25 @@ async function runChecks(ctx, opts = {}) {
   }
   const release = retainPdfCache();
   try {
-    for (const check37 of checks2) {
+    for (const check36 of checks2) {
       try {
-        let results = await check37.run(ctx);
-        const severityOverride = getCheckSeverityOverride(check37.id, ctx.config);
+        const results = await check36.run(ctx);
+        const severityOverride = getCheckSeverityOverride(check36.id, ctx.config);
         if (severityOverride) {
           for (const r of results) {
             r.severity = severityOverride;
           }
         }
-        const lintLevel = ruleLevel(ctx.config.lint.rules, check37.id);
-        if (lintLevel === "off")
-          results = [];
-        else if (lintLevel) {
-          for (const r of results)
-            r.severity = lintLevel === "warn" ? "warning" : "error";
-        }
         if (results.length === 0) {
-          passed.push(check37.id);
+          passed.push(check36.id);
         } else {
           allResults.push(...results);
         }
       } catch (err) {
         allResults.push({
-          checkId: check37.id,
+          checkId: check36.id,
           severity: "error",
-          message: `Check "${check37.id}" threw: ${err instanceof Error ? err.message : String(err)}`
+          message: `Check "${check36.id}" threw: ${err instanceof Error ? err.message : String(err)}`
         });
       }
     }
@@ -4915,30 +4824,20 @@ async function runChecks(ctx, opts = {}) {
     }
   };
 }
-function emptyReport() {
-  return {
-    results: [],
-    errors: [],
-    warnings: [],
-    infos: [],
-    passed: [],
-    summary: { total: 0, errors: 0, warnings: 0, infos: 0, passed: 0 }
-  };
-}
 
 // src/checks/tool-check.ts
 async function checkToolAvailability(config, opts = {}) {
   const { checks: checks2 } = selectChecks(opts, config);
   const toolToChecks = new Map;
-  for (const check37 of checks2) {
-    if (!check37.requiredTools?.length)
+  for (const check36 of checks2) {
+    if (!check36.requiredTools?.length)
       continue;
-    for (const tool of check37.requiredTools) {
+    for (const tool of check36.requiredTools) {
       const existing = toolToChecks.get(tool);
       if (existing) {
-        existing.push(check37.id);
+        existing.push(check36.id);
       } else {
-        toolToChecks.set(tool, [check37.id]);
+        toolToChecks.set(tool, [check36.id]);
       }
     }
   }
@@ -4954,11 +4853,11 @@ async function checkToolAvailability(config, opts = {}) {
   const missing = results.filter((r) => !r.found).map((r) => r.tool);
   const missingSet = new Set(missing);
   const skippedChecks = [];
-  for (const check37 of checks2) {
-    if (!check37.requiredTools?.length)
+  for (const check36 of checks2) {
+    if (!check36.requiredTools?.length)
       continue;
-    if (check37.requiredTools.some((t) => missingSet.has(t))) {
-      skippedChecks.push(check37.id);
+    if (check36.requiredTools.some((t) => missingSet.has(t))) {
+      skippedChecks.push(check36.id);
     }
   }
   return { available, missing, skippedChecks, toolToChecks };
@@ -5029,7 +4928,7 @@ async function sharedAssetDirs(manifestDir, relStyles, inputDir) {
     const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
     if (!SHIPPED_ASSET_EXTS.has(ext))
       continue;
-    const dir = dirname2(resolve5(file));
+    const dir = dirname3(resolve5(file));
     if (escapesProjectRoot(projectRoot, dir))
       dirs.add(dir);
   }
@@ -5190,7 +5089,7 @@ function planRuns(opts) {
 async function executeValidation(args) {
   const manifestPath = typeof args.manifest === "string" ? args.manifest : undefined;
   const { manifest, manifestDir } = await loadManifestWithPath(manifestPath ?? args.input ?? undefined, { explicit: manifestPath !== undefined });
-  const config = resolveConfig(args.skipStylelint ? { validate: { source: { stylelint: false } } } : {}, manifest);
+  const config = resolveConfig(args.skipStylelint ? { checks: { "source.stylelint": "off" } } : {}, manifest);
   const targetIds = resolveTargets(parseCsv(typeof args.target === "string" ? args.target : undefined), config.targets);
   const pdfPath = typeof args.pdf === "string" ? resolve5(args.pdf) : undefined;
   const inputDir = typeof args.input === "string" ? resolve5(args.input) : undefined;
@@ -5223,7 +5122,7 @@ async function executeValidation(args) {
   let htmlPath;
   const outDir = resolveOutputDir(manifestDir, config.title);
   if (inputDir) {
-    const relMarkdown = await resolveActiveMarkdownFiles(manifestDir, config.source.files);
+    const relMarkdown = await resolveActiveMarkdownFiles(manifestDir, config.chapters);
     markdownFiles = relMarkdown.map((f) => join3(manifestDir, canonicalChapterId(f)));
     const relStyles = await resolveActiveStyles(manifestDir, config.styles);
     const projectCssFiles = relStyles.map((rel) => resolve5(manifestDir, rel));
@@ -5259,7 +5158,7 @@ async function executeValidation(args) {
   };
   if (args.fix) {
     const selected = selectChecks(runnerOptions, config).checks;
-    if (selected.some((check37) => check37.id === MARKDOWNLINT_CHECK_ID)) {
+    if (selected.some((check36) => check36.id === MARKDOWNLINT_CHECK_ID)) {
       await applyMarkdownlintFixes(context);
     } else {
       log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
@@ -5362,16 +5261,16 @@ ${list}
 
 Install the missing tools and re-run, or set GHOSTSCRIPT_PATH, CHROMIUM_PATH, or system PATH so gutterpress can find them. See the User Guide Chapter 7 (System Setup) at examples/gutterpress-user-guide/07-system-setup.md for the full per-feature matrix.`, 2);
 }
-function computeGates(format, opts, config) {
+function computeGates(format, opts) {
   if (format === "html") {
     if (opts.skipLint || opts.skipPreValidate || opts.skipPostValidate) {
       log.info("Validation/lint flags ignored for --format html (no validation phases apply)");
     }
     return { skipStylelint: false, preValidate: false, postValidate: false };
   }
-  const skipStylelint = !!opts.skipLint || config.lint.enabled === false;
-  const preValidate = !opts.skipPreValidate && config.validate.enabled !== false;
-  const postValidate = format === "pdfx" && !opts.skipPostValidate && config.validate.enabled !== false;
+  const skipStylelint = !!opts.skipLint;
+  const preValidate = !opts.skipPreValidate;
+  const postValidate = format === "pdfx" && !opts.skipPostValidate;
   return { skipStylelint, preValidate, postValidate };
 }
 
@@ -5407,7 +5306,7 @@ async function resolveBuildContext(opts) {
   }, manifest);
   const target = opts.pdfFileOverride ? { kind: "file", file: path7.resolve(opts.pdfFileOverride) } : opts.outDir ? { kind: "directory", dir: opts.outDir } : { kind: "project", dir: resolveOutputDir(manifestDir, config.title) };
   const outDir = target.kind === "file" ? path7.dirname(target.file) : target.dir;
-  const gates = computeGates(format, opts, config);
+  const gates = computeGates(format, opts);
   const workDir = target.kind === "project" ? path7.join(path7.dirname(target.dir), `.${path7.basename(target.dir)}-build-${randomBytes(6).toString("hex")}`) : path7.join(os2.tmpdir(), `gutterpress-build-${randomBytes(6).toString("hex")}`);
   return {
     opts,
@@ -5463,8 +5362,8 @@ async function runQualityGates(ctx) {
 }
 async function renderBook(ctx) {
   const { config, gates, renderDir, workDir, opts, format } = ctx;
-  if (config.source.files && config.source.files.length > 0) {
-    log.info(`Using specified files (${config.source.files.length} total)`);
+  if (config.chapters && config.chapters.length > 0) {
+    log.info(`Using specified files (${config.chapters.length} total)`);
   } else {
     log.info("Using all .md files in alphabetical order");
   }
@@ -5477,7 +5376,7 @@ async function renderBook(ctx) {
     print: config.print,
     printArea: { ...config.page, preset: config.preset, spec: config.spec },
     styles: config.styles,
-    files: config.source.files,
+    files: config.chapters,
     plugins,
     pluginStyles,
     onChapterWarnings: (file, warnings) => {
@@ -5628,7 +5527,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path7.join(stage, "raw.pdf") : path7.resolve(pdfFile);
       await fsp2.mkdir(path7.dirname(path7.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-1r6q80tq.js");
+      const { buildNativePdf } = await import("./engine-6txhxmmv.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -5665,7 +5564,7 @@ class PdfOutput {
         }
         const flattenPages = config.pdfx.flattenPages;
         if (transparent.length > 0 && config.pdfx.transparency === "preserve-text") {
-          const { unsplittableTextReasons } = await import("./pdf-inspect-wnw4za71.js");
+          const { unsplittableTextReasons } = await import("./pdf-inspect-b3mf81ex.js");
           const reasons = await unsplittableTextReasons(rawBytes, transparent).catch((err) => {
             log.warn(`pdfx.transparency: preserve-text could not inspect this PDF's text (${err instanceof Error ? err.message : String(err)}), so every page that uses transparency is flattened whole, as with flatten-page.`);
             return null;
@@ -5938,7 +5837,7 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
     ...config,
     printArea: config.page && { ...config.page, preset: config.preset, spec: config.spec }
   }, {
-    files: config.source?.files ?? null,
+    files: config.chapters ?? null,
     onCssAssets: (copies) => {
       for (const copy of copies)
         nextAssets.set(copy.to, copy.from);
@@ -7175,12 +7074,10 @@ import { readFile as readFile24 } from "node:fs/promises";
 import path13 from "node:path";
 import { isMap } from "yaml";
 function writePageBounds(doc, page) {
-  const tolerance = page.tolerance ?? numberAt(doc, ["page", "tolerance"]);
   ensurePageMap(doc);
   doc.setIn(["page", "width"], page.width);
   doc.setIn(["page", "height"], page.height);
-  if (tolerance !== undefined)
-    doc.setIn(["page", "tolerance"], tolerance);
+  doc.deleteIn(["page", "tolerance"]);
 }
 function deletePageBounds(doc) {
   const block = doc.get("page", true);
@@ -7193,6 +7090,14 @@ function deletePageBounds(doc) {
   if (block.items.length === 0)
     doc.delete("page");
 }
+function deletePageMargin(doc) {
+  const block = doc.get("page", true);
+  if (!isMap(block))
+    return;
+  block.delete("margin");
+  if (block.items.length === 0)
+    doc.delete("page");
+}
 function writePageMargin(doc, margin) {
   ensurePageMap(doc);
   if (!isMap(doc.getIn(["page", "margin"], true)))
@@ -7228,11 +7133,12 @@ function manifestGeometry(doc) {
   const base = preset ? PRESETS[preset].page : null;
   const width = numberAt(doc, ["page", "width"]) ?? base?.width;
   const height = numberAt(doc, ["page", "height"]) ?? base?.height;
-  const tolerance = numberAt(doc, ["page", "tolerance"]) ?? base?.tolerance ?? 0.5;
+  const tolerance = base?.tolerance ?? 0.5;
   const bounds = width !== undefined && height !== undefined ? { width, height, tolerance } : null;
+  const presetSizeOverridden = base !== null && (numberAt(doc, ["page", "width"]) !== undefined || numberAt(doc, ["page", "height"]) !== undefined);
   const at = (edge) => doc.getIn(["page", "margin", edge]);
   const margins = MARGIN_EDGES.every((edge) => isNonNegativePoints(at(edge))) ? { top: at("top"), bottom: at("bottom"), inside: at("inside"), outside: at("outside") } : undefined;
-  return { preset, bounds, ...margins ? { margins } : {} };
+  return { preset, bounds, presetSizeOverridden, ...margins ? { margins } : {} };
 }
 async function stylesheetMargins(projectDir, manifestStyles) {
   const d = DEFAULT_PAGE_MARGIN_PT;
@@ -7267,10 +7173,9 @@ async function stylesheetMargins(projectDir, manifestStyles) {
 }
 async function setupOf(projectDir, doc) {
   const { margins, ...geometry } = manifestGeometry(doc);
-  if (margins)
-    return { ...geometry, margins, marginsFrom: "manifest" };
   const styles = doc.toJS()?.styles;
-  return { ...geometry, ...await stylesheetMargins(projectDir, Array.isArray(styles) ? styles : undefined) };
+  const sheets = await stylesheetMargins(projectDir, Array.isArray(styles) ? styles : undefined);
+  return margins ? { ...geometry, margins, marginsFrom: "manifest", fallbackMarginsFrom: sheets.marginsFrom } : { ...geometry, ...sheets, fallbackMarginsFrom: sheets.marginsFrom };
 }
 async function readPageSetup(projectDir) {
   const { doc } = await loadManifestDoc(projectDir);
@@ -7280,7 +7185,7 @@ async function setPageSetup(projectDir, change) {
   const { doc, file } = await loadManifestDoc(projectDir);
   const size2 = change.size ? pageSizeForChoice(change.size) : null;
   let margins;
-  if (change.margins !== undefined) {
+  if (change.margins) {
     const against = size2 ?? manifestGeometry(doc).bounds;
     if (!against)
       throw new UsageError("Choose a page size before setting margins: the manifest records none.");
@@ -7295,6 +7200,8 @@ async function setPageSetup(projectDir, change) {
   }
   if (margins)
     writePageMargin(doc, margins);
+  else if (change.margins === null)
+    deletePageMargin(doc);
   await writeManifestDoc(file, doc);
   return setupOf(projectDir, doc);
 }
@@ -7304,10 +7211,10 @@ function starterOverridesCss() {
   return `/**
  * Your book's own styles. Rules here win over your look's.
  *
- * In the app you rarely need this file: Setup > Looks & features adds a
- * look, Setup > Design changes its fonts, colors and sizes (those changes
- * are saved here as :root custom properties), and Setup > Details sets the
- * page size and margins (in the manifest).
+ * In the app you rarely need this file: Setup > Look chooses a look and
+ * changes its fonts and colors (those changes are saved here as :root
+ * custom properties), Setup > Advanced lists every setting, and Setup > Book
+ * sets the page size and margins (in the manifest).
  *
  * To change the look from the command line: gutterpress ext remove <old>
  * <book>, then gutterpress ext add <look> <book>.
@@ -7346,9 +7253,6 @@ function requirePreset(preset, customPage) {
   } else if (customPage && (!isPositivePoints(customPage.width) || !isPositivePoints(customPage.height))) {
     throw new CreateProjectErrorImpl("custom-page-required", "Page overrides need a positive width and height in points (72pt = 1in).");
   }
-  if (customPage?.tolerance !== undefined && !isPositivePoints(customPage.tolerance)) {
-    throw new CreateProjectErrorImpl("custom-page-required", "Page tolerance must be a positive number of points.");
-  }
   return preset;
 }
 function resolveScaffoldTargets(requested, preset) {
@@ -7517,7 +7421,7 @@ async function adoptFolder(options) {
     if (!existsSync9(bookCssPath)) {
       await writeFile7(bookCssPath, starterOverridesCss(), "utf8");
     }
-    const filesYaml = mdFiles.map((f) => `    - "${escapeYamlScalar(f)}"`).join(`
+    const filesYaml = mdFiles.map((f) => `  - "${escapeYamlScalar(f)}"`).join(`
 `);
     const manifest = `title: "${escapeYamlScalar(title)}"
 authors:
@@ -7525,8 +7429,7 @@ authors:
 preset: dtrpg
 targets:
   - dtrpg
-source:
-  files:
+chapters:
 ${filesYaml}
 styles:
   - styles/book.css
@@ -7574,7 +7477,7 @@ async function firstSourceFile(manifestPath) {
   } catch {
     return;
   }
-  const filesIdx = text.search(/^\s*files:\s*$/m);
+  const filesIdx = text.search(/^(?:chapters|\s+files):\s*$/m);
   if (filesIdx === -1)
     return;
   const rest = text.slice(filesIdx);
@@ -8654,15 +8557,16 @@ async function setManifestFields(projectDir, updates) {
   }
   if (hasKey(updates, "sourceFiles")) {
     const f = updates.sourceFiles;
-    if (f === null || Array.isArray(f) && f.length === 0) {
-      doc.deleteIn(["source", "files"]);
-      const source = doc.get("source", true);
-      if (isMap3(source) && source.items.length === 0) {
+    const source = doc.get("source", true);
+    if (isMap3(source)) {
+      source.delete("files");
+      if (source.items.length === 0)
         doc.delete("source");
-      }
-    } else {
-      doc.setIn(["source", "files"], f);
     }
+    if (f === null || Array.isArray(f) && f.length === 0)
+      doc.delete("chapters");
+    else
+      doc.set("chapters", f);
   }
   await writeManifestDoc(file, doc);
   return readManifestFields(projectDir);
@@ -8682,13 +8586,13 @@ async function readManifestFields(projectDir) {
     if (isSeq2(targetsNode)) {
       out.targets = targetsNode.items.map((i) => scalarString(i)).filter((s) => s !== null);
     }
-    const filesNode = doc.getIn(["source", "files"], true);
+    const sourceNode = doc.get("source", true);
+    const oldSpelling = isMap3(sourceNode) && sourceNode.has("files");
+    const filesNode = doc.has("chapters") ? doc.get("chapters", true) : doc.getIn(["source", "files"], true);
     if (isSeq2(filesNode)) {
       out.sourceFiles = filesNode.items.map((i) => scalarString(i) ?? "");
-    } else {
-      const sourceNode = doc.get("source", true);
-      if (isMap3(sourceNode) && sourceNode.has("files"))
-        out.sourceFiles = null;
+    } else if (doc.has("chapters") || oldSpelling) {
+      out.sourceFiles = null;
     }
     return out;
   } catch {
@@ -10839,7 +10743,7 @@ var FAILURE_MESSAGES = {
   auth: "The Git server didn't accept the saved connection. Reconnect to this server with a current access token and try again.",
   "not-found": "The server answered, but no repository was found at that address. It may have been moved, renamed, or you may no longer have access.",
   unreachable: "Couldn't reach the Git server. Check your internet connection (and VPN, if this is a private server), then try again.",
-  "ssh-unsupported": "This book's online address uses SSH (git@…), which gutterpress can't check or sync with. Everything on this computer still works — sync with your usual Git tool.",
+  "ssh-unsupported": "This book's online address uses SSH (git@…), which Gutterpress can't check or sync with. Everything on this computer still works — sync with your usual Git tool.",
   "insecure-transport": "This address isn't secure, so the saved connection wasn't sent — connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to use a saved connection.",
   tls: "The server's security certificate couldn't be verified. If this is a private server with its own certificate, ask its administrator about trusting it (NODE_EXTRA_CA_CERTS).",
   unknown: "The connection test failed unexpectedly. The server may not be a Git server, or it may be temporarily unavailable."
@@ -12569,7 +12473,7 @@ async function resolvePublishProvider(id, book) {
   const ext = await bookExtensions(book);
   const npmEntry = ext.extensions.some((c) => !c.path && c.name === id);
   if (npmEntry) {
-    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-9dh7c4tp.js");
+    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-dymzcasz.js");
     await restoreForCommand2(book.projectDir, { manifestPath: book.manifestPath, failFast: true });
   }
   const publishers = await discover(ext);
@@ -12607,7 +12511,7 @@ function infoFor(p) {
 }
 function pluginProvider(p) {
   let loading;
-  const load = () => loading ??= import("./plugins-80emnf31.js").then((m) => m.loadPublishFunction(p));
+  const load = () => loading ??= import("./plugins-fec8t2bh.js").then((m) => m.loadPublishFunction(p));
   return {
     info: infoFor(p),
     async authenticate() {