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

package/dist/{cli-xq6djqbj.js → cli-93mkaw6v.js}

@@ -8,17 +8,16 @@ import {
   stampCreator,
   stripAnnotations,
   transparentPages
-} from "./cli-evg8sbht.js";
+} from "./cli-d9mm3vvh.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
 import {
+  DEFAULT_PAGE_MARGIN_PT,
   MARGIN_BOX_IGNORED_PROPERTIES,
-  extract,
   getAssetPath,
-  lastPageMode,
-  resolvePage
-} from "./cli-pz4bn98t.js";
+  lastPageMode
+} from "./cli-54xt7pjg.js";
 import {
   countLinkAnnotations,
   getImageResolutions,
@@ -31,7 +30,7 @@ import {
   loadPdf,
   pageHasMarks,
   retainPdfCache
-} from "./cli-2ppw6q9v.js";
+} from "./cli-5crpmz42.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -57,11 +56,17 @@ import {
   TARGET_IDS,
   addExtension,
   applyDefaultPdfStrictChecks,
+  cssLength,
   ensureProjectGitignore,
+  formatPageSize,
+  isPositivePoints,
+  judgeRect,
   loadManifest,
   loadManifestDoc,
   loadManifestWithPath,
   npmRegistryUrl,
+  pageBoxes,
+  printAreaMeta,
   publishTargetFor,
   resolveConfig,
   resolveConfigForTarget,
@@ -70,7 +75,7 @@ import {
   uniqueExtensionId,
   withFetchTimeout,
   writeManifestDoc
-} from "./cli-sdmv4bba.js";
+} from "./cli-y6d1arem.js";
 import {
   EXTENSION_MANIFEST_FILENAME,
   GUTTERPRESS_CSS,
@@ -91,7 +96,7 @@ import {
   readExtensionMeta,
   resolveDeclaredStyles,
   slugify
-} from "./cli-pwwfxdgb.js";
+} from "./cli-rqh295j9.js";
 import {
   PACKAGE_META,
   PACKAGE_VERSION,
@@ -101,7 +106,7 @@ import {
   log,
   setLogLevel,
   warn
-} from "./cli-aqh6brew.js";
+} from "./cli-pspjxnc8.js";
 import {
   DEBOUNCE,
   UsageError,
@@ -184,10 +189,7 @@ function selectorToRegex(selector) {
 // src/checks/policy.ts
 var INSPECT_FAILED_CODE = "inspect-failed";
 function isCheckEnabled(check, config) {
-  const entry = config.validate.checks[check.id];
-  if (entry === false)
-    return false;
-  if (typeof entry === "object" && entry.enabled === false)
+  if (config.checks[check.id] === "off")
     return false;
   if (check.enabledWhen && !check.enabledWhen(config))
     return false;
@@ -281,84 +283,6 @@ var check2 = {
 };
 registerCheck(check2);
 
-// src/engine/shared/print-area.ts
-function isPositivePoints(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0;
-}
-var round3 = (n) => Math.round(n * 1000) / 1000;
-function cssLength(pt) {
-  const inches = round3(pt / 72);
-  return Math.abs(inches * 72 - pt) < 0.000001 ? `${inches}in` : `${round3(pt)}pt`;
-}
-function formatPageSize(page) {
-  return `${cssLength(page.width)} ${cssLength(page.height)}`;
-}
-function printAreaMeta(page) {
-  const area = JSON.stringify({
-    width: page.width,
-    height: page.height,
-    bleed: page.bleed ?? 0,
-    safe: page.safe ?? 0,
-    artSafe: page.artSafe,
-    gutter: page.gutter,
-    preset: page.preset,
-    spec: page.spec
-  });
-  return `<meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>`;
-}
-function pageBoxes(area, side, scale = 1) {
-  const w = area.width * scale;
-  const h = area.height * scale;
-  const b = Math.max(0, area.bleed) * scale;
-  const s = Math.max(0, area.safe) * scale;
-  const a = Math.max(0, area.artSafe) * scale;
-  const g = Math.max(0, area.gutter) * scale;
-  const [textLeft, textRight] = side === "verso" ? [s, g] : [g, s];
-  const [artLeft, artRight] = side === "verso" ? [a, g] : [g, a];
-  const trim = { x: side === "verso" ? b : 0, y: b, w: Math.max(0, w - b), h: Math.max(0, h - 2 * b) };
-  return {
-    sheet: { x: 0, y: 0, w, h },
-    trim,
-    safe: {
-      x: trim.x + textLeft,
-      y: trim.y + s,
-      w: Math.max(0, trim.w - textLeft - textRight),
-      h: Math.max(0, trim.h - 2 * s)
-    },
-    safeArt: {
-      x: trim.x + artLeft,
-      y: trim.y + a,
-      w: Math.max(0, trim.w - artLeft - artRight),
-      h: Math.max(0, trim.h - 2 * a)
-    },
-    bleed: b
-  };
-}
-var SEVERITY = { inside: 0, unsafe: 1, bleed: 2, "off-page": 3 };
-function judgeRect(r, boxes, rule, tol = 0) {
-  const { sheet, trim } = boxes;
-  const safe = rule === "art" ? boxes.safeArt : boxes.safe;
-  const sides = [
-    ["left", -r.x, -safe.x, -trim.x, -sheet.x],
-    ["right", r.x + r.w, safe.x + safe.w, trim.x + trim.w, sheet.x + sheet.w],
-    ["top", -r.y, -safe.y, -trim.y, -sheet.y],
-    ["bottom", r.y + r.h, safe.y + safe.h, trim.y + trim.h, sheet.y + sheet.h]
-  ];
-  let worst = { kind: "inside", gap: 0, need: 0, edge: null };
-  let beyond = 0;
-  for (const [edge, ink, limit, trimEdge, sheetEdge] of sides) {
-    const past = ink - limit;
-    if (past <= tol || rule === "art" && ink >= sheetEdge - tol)
-      continue;
-    const kind = ink > sheetEdge + tol ? "off-page" : ink > trimEdge + tol ? "bleed" : "unsafe";
-    if (SEVERITY[kind] > SEVERITY[worst.kind] || kind === worst.kind && past > beyond) {
-      worst = { kind, gap: trimEdge - ink, need: trimEdge - limit, edge };
-      beyond = past;
-    }
-  }
-  return worst;
-}
-
 // src/checks/pdf/safe-margins.ts
 var TOLERANCE_PT = 0.5;
 var ABOVE_BASELINE = 0.8;
@@ -846,7 +770,7 @@ var check8 = {
           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 }
         })
@@ -926,8 +850,6 @@ var check10 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.requireBookmarks)
-      return [];
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
@@ -960,8 +882,6 @@ var check11 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.requireTocLinks)
-      return [];
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
@@ -1099,8 +1019,6 @@ var check15 = {
   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"))
@@ -1141,8 +1059,6 @@ var check16 = {
   async run(ctx) {
     if (!ctx.pdfPath)
       return [];
-    if (!ctx.config.validate.pdf.requireBleed)
-      return [];
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     if (!bytes) {
       return [
@@ -1233,18 +1149,20 @@ import { parse as parseYaml } from "yaml";
 
 // src/checks/source/config-file.ts
 import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-function findConfigFile(inputDir, names, explicit) {
-  if (explicit) {
-    const p = resolve(inputDir, explicit);
-    return existsSync(p) ? p : null;
-  }
-  for (const name of names) {
-    const p = resolve(inputDir, name);
-    if (existsSync(p))
-      return p;
+import { dirname, resolve } from "node:path";
+function findConfigFile(startDir, names) {
+  let dir = resolve(startDir);
+  for (;; ) {
+    for (const name of names) {
+      const p = resolve(dir, name);
+      if (existsSync(p))
+        return p;
+    }
+    const parent = dirname(dir);
+    if (existsSync(resolve(dir, ".git")) || parent === dir)
+      return null;
+    dir = parent;
   }
-  return null;
 }
 
 // src/checks/source/markdownlint.ts
@@ -1286,17 +1204,13 @@ var check18 = {
   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)) {
@@ -1332,14 +1246,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 || !existsSync2(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 readFile4(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
     const html = await readFile4(ctx.htmlPath, "utf8");
@@ -1367,7 +1277,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";
@@ -1388,6 +1298,7 @@ var ruleRiskyProps = "printsafe/no-risky-print-effects";
 var ruleSyntax = "printsafe/syntax-error";
 var rulePageContainment = "printsafe/page-containment";
 var rulePreviewCannotFollow = "printsafe/preview-cannot-follow";
+var rulePageSizeInStylesheet = "printsafe/page-size-in-stylesheet";
 function extractUrls(value) {
   const urls = [];
   const re = /url\(\s*(['"]?)(.*?)\1\s*\)/gi;
@@ -1436,6 +1347,12 @@ function isInPageBox(decl) {
   const page = decl.parent;
   return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
 }
+function isInBookPageRule(decl) {
+  if (!isInPageBox(decl))
+    return false;
+  const params = decl.parent.params.trim();
+  return params === "" || /^(:[a-z-]+\s*)+$/i.test(params);
+}
 function isDroppedPageGradient(decl) {
   const prop = decl.prop.toLowerCase();
   if (prop !== "background" && prop !== "background-image")
@@ -1675,6 +1592,15 @@ function checkCssRaw(css, from) {
   root.walkAtRules((at) => reportRemoteUrls(at.params || "", at));
   root.walkDecls((decl) => {
     const prop = decl.prop.toLowerCase();
+    if (prop === "size" && isInBookPageRule(decl)) {
+      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 > Book in the app), which is written after every stylesheet. Remove this declaration; to print at another size, change the manifest.`,
+        ...nodeLoc(decl)
+      });
+      return;
+    }
     if (isInertValue(prop, decl.value))
       return;
     if (marginBoxIgnoredProperties.has(prop) && isInPageMarginBox(decl)) {
@@ -1770,10 +1696,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 [];
@@ -1791,7 +1714,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,
@@ -1987,15 +1910,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;
@@ -2062,7 +1981,7 @@ registerCheck(check21);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync4 } from "node:fs";
-import { dirname, resolve as resolve2 } from "node:path";
+import { dirname as dirname2, resolve as resolve2 } from "node:path";
 
 // src/lib/asset-inline.ts
 import { createHash } from "node:crypto";
@@ -2488,7 +2407,7 @@ function filesystemRef(ref) {
 }
 function localRefExists(ref, kind, sourceFile, projectRoot) {
   const cleaned = filesystemRef(ref);
-  const fileRelative = resolve2(dirname(sourceFile), cleaned);
+  const fileRelative = resolve2(dirname2(sourceFile), cleaned);
   const rootRelative = resolve2(projectRoot, cleaned);
   switch (kind) {
     case "image":
@@ -3590,8 +3509,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"]);
@@ -3614,58 +3531,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 existsSync5 } from "node:fs";
 import { resolve as resolve3 } from "node:path";
@@ -3679,15 +3544,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;
@@ -3706,7 +3569,7 @@ var check32 = {
       const hasLicense = LICENSE_NAMES.some((name) => existsSync5(resolve3(fontDir, name)));
       if (!hasLicense) {
         results.push({
-          checkId: check32.id,
+          checkId: check31.id,
           severity: "warning",
           message: `No font license file found in directory`,
           file: fontDir
@@ -3716,10 +3579,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",
@@ -3748,7 +3611,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
@@ -3756,7 +3619,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
@@ -3765,11 +3628,11 @@ var check33 = {
     return results;
   }
 };
-registerCheck(check33);
+registerCheck(check32);
 
 // src/checks/heuristic/section-density.ts
 import { readFile as readFile15 } 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",
@@ -3795,7 +3658,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,
@@ -3815,7 +3678,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,
@@ -3823,7 +3686,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
         }));
       }
@@ -3831,10 +3694,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",
@@ -3859,7 +3722,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
@@ -3869,10 +3732,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",
@@ -3890,7 +3753,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
@@ -3898,21 +3761,21 @@ var check36 = {
     ];
   }
 };
-registerCheck(check36);
+registerCheck(check35);
 
 // 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]);
       }
     }
   }
@@ -3928,11 +3791,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 };
@@ -3952,7 +3815,7 @@ function reportMissingTools(result) {
 // src/lib/validation-exec.ts
 import { existsSync as existsSync6 } from "node:fs";
 import { readFile as readFile18 } from "node:fs/promises";
-import { dirname as dirname2, join as join2, resolve as resolve4 } from "node:path";
+import { dirname as dirname3, join as join2, resolve as resolve4 } from "node:path";
 
 // src/lib/output-paths.ts
 import path5 from "node:path";
@@ -3995,16 +3858,25 @@ function canonicalChapterId(p) {
 }
 
 // src/lib/markdown/assemble.ts
-function defaultPageSizeCss(css, page) {
+function pageGeometryCss(page) {
   if (!page || !isPositivePoints(page.width) || !isPositivePoints(page.height))
     return null;
-  try {
-    if (resolvePage(extract(css)).decls.size !== undefined)
-      return null;
-  } catch {
+  const size2 = `size: ${formatPageSize(page)};`;
+  const m = page.margin;
+  if (!m)
+    return `@page { ${size2} }`;
+  const [top, bottom, inside, outside] = [m.top, m.bottom, m.inside, m.outside].map(cssLength);
+  const recto = `margin: ${top} ${outside} ${bottom} ${inside};`;
+  const verso = `margin: ${top} ${inside} ${bottom} ${outside};`;
+  return [`@page { ${size2} ${recto} }`, `@page :left { ${verso} }`, `@page :right { ${recto} }`].join(`
+`);
+}
+function defaultPageMarginCss(page) {
+  if (!page || page.margin)
     return null;
-  }
-  return `@page { size: ${formatPageSize(page)}; }`;
+  return `@layer gp.vocab {
+@page { margin: ${cssLength(DEFAULT_PAGE_MARGIN_PT)}; }
+}`;
 }
 async function assembleBookHtml(opts) {
   const title = opts.title ?? "Document";
@@ -4044,8 +3916,8 @@ async function assembleBookHtml(opts) {
       imageRefs.add(ref);
     opts.onImageRefs([...imageRefs]);
   }
-  const pageSize = defaultPageSizeCss(`${pluginCss}
-${projectCss}`, opts.printArea);
+  const pageGeometry = pageGeometryCss(opts.printArea);
+  const defaultMargin = defaultPageMarginCss(opts.printArea);
   const inlineCss = [
     "@layer gp.marker, gp.vocab;",
     `/* gutterpress markers */
@@ -4057,14 +3929,16 @@ ${TWO_VERSIONS_CSS.trim()}
 @layer gp.vocab {
 ${GUTTERPRESS_CSS.trim()}
 }`,
-    pageSize ? `/* page size (manifest) */
-${pageSize}` : null,
+    defaultMargin ? `/* page margins (default) */
+${defaultMargin}` : null,
     pluginCss ? `/* extension css */
 ${pluginCss.trim()}` : null,
     `/* column alignment */
 ${TABLE_ALIGN_CSS.trim()}`,
     projectCss ? `/* project css */
-${projectCss.trim()}` : null
+${projectCss.trim()}` : null,
+    pageGeometry ? `/* page geometry (manifest) */
+${pageGeometry}` : null
   ].filter(Boolean).join(`
 
 `);
@@ -4186,8 +4060,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 [];
   }
@@ -4196,13 +4069,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)) {
@@ -4291,15 +4163,10 @@ function formatLocation(file, line, column) {
 
 // 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) {
@@ -4317,32 +4184,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)}`
         });
       }
     }
@@ -4367,16 +4227,6 @@ 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/lib/validation-exec.ts
 var SHIPPED_ASSET_EXTS = new Set([
@@ -4432,7 +4282,7 @@ async function sharedAssetDirs(manifestDir, relStyles, inputDir) {
     const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
     if (!SHIPPED_ASSET_EXTS.has(ext))
       continue;
-    const dir = dirname2(resolve4(file));
+    const dir = dirname3(resolve4(file));
     if (escapesProjectRoot(projectRoot, dir))
       dirs.add(dir);
   }
@@ -4593,7 +4443,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" ? resolve4(args.pdf) : undefined;
   const inputDir = typeof args.input === "string" ? resolve4(args.input) : undefined;
@@ -4626,7 +4476,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) => join2(manifestDir, canonicalChapterId(f)));
     const relStyles = await resolveActiveStyles(manifestDir, config.styles);
     const projectCssFiles = relStyles.map((rel) => resolve4(manifestDir, rel));
@@ -4662,7 +4512,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.`);
@@ -4940,16 +4790,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 };
 }
 
@@ -4985,7 +4835,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,
@@ -5041,8 +4891,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");
   }
@@ -5055,7 +4905,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) => {
@@ -5206,7 +5056,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-mc5br8g8.js");
+      const { buildNativePdf } = await import("./engine-4rzdx6af.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -5243,7 +5093,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;
@@ -5545,7 +5395,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);
@@ -6501,32 +6351,41 @@ import { constants as FS, existsSync as existsSync7 } from "node:fs";
 import path12 from "node:path";
 
 // src/lib/page-size.ts
-import postcss5 from "postcss";
-import { isMap, Scalar } from "yaml";
+import { isMap } from "yaml";
 function writePageBounds(doc, page) {
-  const tolerance = page.tolerance ?? numberAt(doc, ["page", "tolerance"]);
-  if (!isMap(doc.get("page", true)))
-    doc.set("page", doc.createNode({}));
+  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);
+  if (!isMap(block)) {
+    doc.delete("page");
+    return;
+  }
+  for (const key of ["width", "height", "tolerance"])
+    block.delete(key);
+  if (block.items.length === 0)
+    doc.delete("page");
 }
-function numberAt(doc, keyPath) {
-  const v = doc.getIn(keyPath);
-  return isPositivePoints(v) ? v : undefined;
+function ensurePageMap(doc) {
+  if (!isMap(doc.get("page", true)))
+    doc.set("page", doc.createNode({}));
 }
 
 // src/lib/project-scaffold.ts
 function starterOverridesCss() {
   return `/**
- * Your book's own styles.
+ * Your book's own styles. Rules here win over your look's.
  *
- * This file loads AFTER every extension, so any rule you add here overrides
- * a look's defaults. A new book has no look until its template or you add
- * one:
- *   gutterpress ext add academic <book>    (a built-in look)
- *   gutterpress ext add <package> <book>   (a look from npm)
+ * 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>.
  */
 `;
 }
@@ -6562,9 +6421,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) {
@@ -6649,6 +6505,8 @@ async function scaffoldProject(options) {
       if (preset) {
         doc.set("preset", preset);
         doc.set("targets", doc.createNode(targets ?? []));
+        if (preset !== "custom")
+          deletePageBounds(doc);
       }
       if (options.customPage)
         writePageBounds(doc, options.customPage);
@@ -6699,7 +6557,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);
@@ -9020,7 +8878,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-g8jnmmzq.js");
+    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-m8tj43e7.js");
     await restoreForCommand2(book.projectDir, { manifestPath: book.manifestPath, failFast: true });
   }
   const publishers = await discover(ext);
@@ -9058,7 +8916,7 @@ function infoFor(p) {
 }
 function pluginProvider(p) {
   let loading;
-  const load = () => loading ??= import("./plugins-1sxe0dkz.js").then((m) => m.loadPublishFunction(p));
+  const load = () => loading ??= import("./plugins-sqa4msdk.js").then((m) => m.loadPublishFunction(p));
   return {
     info: infoFor(p),
     async authenticate() {
@@ -9332,10 +9190,10 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/manifest-config.ts
-import { isSeq as isSeq2, isMap as isMap3, YAMLSeq, Scalar as Scalar2 } from "yaml";
+import { isSeq as isSeq2, isMap as isMap3, YAMLSeq, Scalar } from "yaml";
 // src/lib/version-changes.ts
 import git3 from "isomorphic-git";
-import postcss6 from "postcss";
+import postcss5 from "postcss";
 
 // src/lib/remote-auth/transport.ts
 import git2 from "isomorphic-git";