gutterpress 0.0.0 → 0.9.0-alpha.2

package/dist/{index-3h3fef7r.js → index-bynn850m.js}

@@ -11,11 +11,11 @@ import {
   snapshotWorkingTreeUnlocked,
   stageChanges,
   withRepoLock
-} from "./index-5bxx0c4y.js";
+} from "./index-yzrh708h.js";
 import {
   detectProjectSource,
   syncRemoteFor
-} from "./index-1tyj4bk3.js";
+} from "./index-wchtvxvw.js";
 import {
   defaultGitHttp
 } from "./index-yja077f6.js";
@@ -84,7 +84,9 @@ function resolvePort(raw) {
 }
 
 // src/lib/presets.ts
+var PRESET_IDS = ["dtrpg", "book", "custom"];
 var DTRPG_PRESET = {
+  defaultTargets: ["dtrpg"],
   plugins: [],
   source: {
     files: null
@@ -156,6 +158,7 @@ var DTRPG_PRESET = {
   }
 };
 var BOOK_PRESET = {
+  defaultTargets: [],
   plugins: [],
   source: {
     files: null
@@ -220,9 +223,15 @@ var BOOK_PRESET = {
     }
   }
 };
+var CUSTOM_PRESET = {
+  ...BOOK_PRESET,
+  page: null,
+  defaultTargets: []
+};
 var PRESETS = {
   dtrpg: DTRPG_PRESET,
-  book: BOOK_PRESET
+  book: BOOK_PRESET,
+  custom: CUSTOM_PRESET
 };
 var warnedIds = new Set;
 function warnOnce(id, message, sink = defaultWarnSink) {
@@ -236,7 +245,7 @@ function defaultWarnSink(message) {
 }
 function resolvePreset(presetName) {
   if (presetName === undefined) {
-    warnOnce("no-preset-set", '[gutterpress] No `preset` set in manifest.yaml — defaulting to "dtrpg" ' + "(DriveThruRPG trim size, TAC cap 240, forced PDF/X) for backward " + "compatibility. Set `preset: dtrpg` to keep this explicitly, or " + "`preset: book` for a neutral 6x9in trade-book default with no " + "vendor TAC cap or PDF/X forcing.");
+    warnOnce("no-preset-set", '[gutterpress] No `preset` in manifest.yaml — using "dtrpg" ' + "(DriveThruRPG print-ready defaults). Set `preset: dtrpg`, `book`, " + "or `custom` to choose explicitly.");
     return DTRPG_PRESET;
   }
   const preset = PRESETS[presetName];
@@ -246,6 +255,121 @@ function resolvePreset(presetName) {
   return preset;
 }
 
+// src/lib/targets.ts
+var DTRPG_TARGET = {
+  id: "dtrpg",
+  label: "DriveThruRPG",
+  overlay: {
+    pdfx: { flavor: DTRPG_PRESET.pdfx.flavor },
+    ink: {
+      maxTac: DTRPG_PRESET.ink.maxTac,
+      tacTolerance: DTRPG_PRESET.ink.tacTolerance
+    },
+    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" }
+      },
+      assets: {
+        allowedColorSpaces: [...DTRPG_PRESET.validate.assets.allowedColorSpaces]
+      },
+      pdf: {
+        forbidTransparency: DTRPG_PRESET.validate.pdf.forbidTransparency,
+        minImageResolution: DTRPG_PRESET.validate.pdf.minImageResolution
+      }
+    }
+  },
+  requiredChecks: [
+    "pdf.structure.qpdf",
+    "pdf.print.pdfx-markers",
+    "pdf.print.pdfx-metadata",
+    "pdf.print.embedded-fonts"
+  ],
+  requiredTools: ["qpdf", "gs"]
+};
+var ITCH_TARGET = {
+  id: "itch",
+  label: "itch.io",
+  overlay: {
+    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,
+        "asset.image.tac-raster": false
+      },
+      assets: {
+        allowedColorSpaces: ["RGB", "CMYK", "Grayscale"],
+        allowAlpha: true
+      },
+      pdf: {
+        forbidTransparency: false,
+        requireBleed: false
+      }
+    }
+  },
+  requiredChecks: ["pdf.structure.qpdf", "pdf.print.embedded-fonts"],
+  requiredTools: []
+};
+var TARGETS = {
+  dtrpg: DTRPG_TARGET,
+  itch: ITCH_TARGET
+};
+var TARGET_IDS = Object.keys(TARGETS);
+function publishTargetFor(id) {
+  const target = TARGETS[id];
+  if (!target) {
+    throw new UsageError(`Unknown publish target "${id}". Known targets: ${TARGET_IDS.join(", ")}.`);
+  }
+  return target;
+}
+function resolveTargets(requested, fallback) {
+  const ids = requested ?? fallback;
+  const seen = new Set;
+  const out = [];
+  for (const id of ids) {
+    publishTargetFor(id);
+    if (!seen.has(id)) {
+      seen.add(id);
+      out.push(id);
+    }
+  }
+  return out;
+}
+function overlayPreset(preset, target) {
+  const o = target.overlay;
+  return {
+    ...preset,
+    pdfx: { ...preset.pdfx, ...o.pdfx },
+    ink: { ...preset.ink, ...o.ink },
+    validate: {
+      ...preset.validate,
+      checks: { ...preset.validate.checks, ...o.validate?.checks },
+      assets: { ...preset.validate.assets, ...o.validate?.assets },
+      pdf: { ...preset.validate.pdf, ...o.validate?.pdf }
+    }
+  };
+}
+var DEFAULT_STRICT_PDF_CHECKS = [
+  "pdf.structure.qpdf",
+  "pdf.print.pdfx-markers",
+  "pdf.print.pdfx-metadata",
+  "pdf.print.embedded-fonts"
+];
+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" };
+    }
+  }
+  return next;
+}
+
 // src/lib/manifest.ts
 var MANIFEST_FILENAMES = [
   "manifest.yaml"
@@ -333,8 +457,34 @@ function mergeShape(cli, manifest, preset) {
   return out;
 }
 function resolveConfig(cliOverrides, manifest) {
+  const presetName = cliOverrides.preset ?? manifest.preset;
+  return resolveWithPreset(cliOverrides, manifest, resolvePreset(presetName));
+}
+function resolveConfigForTarget(cliOverrides, manifest, targetId) {
   const presetName = cliOverrides.preset ?? manifest.preset;
   const preset = resolvePreset(presetName);
+  return resolveWithPreset(cliOverrides, manifest, overlayPreset(preset, publishTargetFor(targetId)));
+}
+function resolveCustomPage(c, m) {
+  const width = c.page?.width ?? m.page?.width;
+  const height = c.page?.height ?? m.page?.height;
+  const missing = [
+    width === undefined ? "page.width" : null,
+    height === undefined ? "page.height" : null
+  ].filter((f) => f !== null);
+  if (missing.length > 0) {
+    throw new UsageError(`preset: custom requires ${missing.join(" and ")} in manifest.yaml ` + `(points; 72pt = 1in). Example for US Letter:
+` + `  page:
+    width: 612
+    height: 792`);
+  }
+  return {
+    width,
+    height,
+    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5
+  };
+}
+function resolveWithPreset(cliOverrides, manifest, preset) {
   const m = manifest;
   const c = cliOverrides;
   const legacy = m;
@@ -356,9 +506,10 @@ function resolveConfig(cliOverrides, manifest) {
     authors: c.authors ?? m.authors ?? [],
     styles: c.styles ?? m.styles,
     plugins,
+    targets: resolveTargets(c.targets ?? m.targets, preset.defaultTargets),
     source: mergeShape(c.source, m.source, preset.source),
     pdfx: mergeShape(c.pdfx, m.pdfx, preset.pdfx),
-    page: mergeShape(c.page, m.page, preset.page),
+    page: preset.page ? mergeShape(c.page, m.page, preset.page) : resolveCustomPage(c, m),
     ink: mergeShape(c.ink, m.ink, preset.ink),
     lint: mergeShape(c.lint, m.lint, preset.lint),
     validate: {
@@ -1013,17 +1164,6 @@ async function assembleBookHtml(opts) {
     throw new Error("No markdown files to render");
   }
   const md = createMarkdownRenderer(opts.plugins);
-  let sourceChapter = null;
-  if (opts.wrapChapters) {
-    const renderToken = md.renderer.renderToken.bind(md.renderer);
-    md.renderer.renderToken = (tokens, idx, options) => {
-      const token = tokens[idx];
-      if (sourceChapter !== null && token.level === 0 && token.map !== null && token.type.endsWith("_open")) {
-        token.attrSet("data-chapter-src", sourceChapter);
-      }
-      return renderToken(tokens, idx, options);
-    };
-  }
   let bodyContent = "";
   const imageRefs = new Set;
   for (const file of files) {
@@ -1036,20 +1176,22 @@ async function assembleBookHtml(opts) {
       throw new Error(`Failed to read file ${file}: ${errorMsg}`);
     }
     const env = {};
-    sourceChapter = opts.wrapChapters ? chapterId : null;
-    let rendered;
-    try {
-      rendered = md.render(content, env);
-    } finally {
-      sourceChapter = null;
-    }
+    const rendered = md.render(content, env);
     if (env.layoutWarnings && env.layoutWarnings.length > 0) {
       opts.onChapterWarnings?.(chapterId, env.layoutWarnings);
     }
     for (const ref of env.imageRefs ?? [])
       imageRefs.add(ref);
-    bodyContent += rendered + `
+    if (opts.wrapChapters) {
+      const safe = chapterId.replace(/&/g, "&").replace(/"/g, """);
+      bodyContent += `<div class="gutterpress-chapter" data-chapter-src="${safe}">
+${rendered}
+</div>
+`;
+    } else {
+      bodyContent += rendered + `
 `;
+    }
   }
   if (opts.onImageRefs) {
     for (const ref of collectHtmlImageRefs(bodyContent))
@@ -1153,11 +1295,24 @@ async function resolveActiveStyles(projectDir, manifestStyles) {
   }
   return [];
 }
-async function listProjectStyles(projectDir) {
-  const [{ manifest }, discoveredAbs] = await Promise.all([
+var SHARED_STYLE_ROOTS = ["shared", "."];
+async function discoverSharedCssFiles(repoRoot) {
+  const found = new Set;
+  for (const rel of SHARED_STYLE_ROOTS) {
+    const base = path.resolve(repoRoot, rel);
+    for (const abs of await discoverCssFiles(base))
+      found.add(abs);
+  }
+  return [...found];
+}
+async function listProjectStyles(projectDir, opts = {}) {
+  const repoRoot = opts.repoRoot && path.resolve(opts.repoRoot) !== path.resolve(projectDir) ? path.resolve(opts.repoRoot) : null;
+  const [{ manifest }, ownCss, sharedCss] = await Promise.all([
     loadManifestWithPath(projectDir),
-    discoverCssFiles(projectDir)
+    discoverCssFiles(projectDir),
+    repoRoot ? discoverSharedCssFiles(repoRoot) : Promise.resolve([])
   ]);
+  const discoveredAbs = [...new Set([...ownCss, ...sharedCss])];
   const activeRels = await resolveActiveStyles(projectDir, Array.isArray(manifest.styles) ? manifest.styles : undefined);
   const out = [];
   const seen = new Set;
@@ -1216,6 +1371,22 @@ function decodeRef(ref) {
 function toPosix(p) {
   return p.split(path2.sep).join("/");
 }
+function escapesProjectRoot(projectDir, absPath) {
+  const rel = path2.relative(projectDir, absPath);
+  return rel === ".." || rel.startsWith(`..${path2.sep}`) || path2.isAbsolute(rel);
+}
+function proseImageRefError(ref, projectDir) {
+  const cleaned = stripUrlSuffix(decodeRef(ref));
+  if (path2.isAbsolute(cleaned)) {
+    return `Image reference must be relative to the project: ${ref}
+` + `  Copy the file into your project folder and reference it from there.`;
+  }
+  if (escapesProjectRoot(projectDir, path2.resolve(projectDir, cleaned))) {
+    return `Image reference points outside the project: ${ref}
+` + `  Copy the file into your project folder and reference it from there.`;
+  }
+  return null;
+}
 function mimeFor(ext) {
   return MIME_BY_EXT[ext] ?? "application/octet-stream";
 }
@@ -1318,7 +1489,7 @@ async function inlineOne(cssPath, projectDir, copies, warnings, seen) {
         return dataUri(bytes, ext);
       }
       const projectRel = path2.relative(projectDir, absAsset);
-      const dest = projectRel && !projectRel.startsWith("..") && !path2.isAbsolute(projectRel) ? toPosix(projectRel) : `${HASHED_ASSET_DIR}/${contentHash(bytes)}${ext}`;
+      const dest = projectRel && !escapesProjectRoot(projectDir, absAsset) ? toPosix(projectRel) : `${HASHED_ASSET_DIR}/${contentHash(bytes)}${ext}`;
       copies.set(dest, { from: absAsset, to: dest });
       return dest;
     });
@@ -1409,19 +1580,14 @@ async function planImageCopies(projectDir, refs) {
   for (const ref of refs) {
     if (isNonFileUrl(ref))
       continue;
-    const cleaned = stripUrlSuffix(decodeRef(ref));
-    if (path2.isAbsolute(cleaned)) {
-      errors.push(`Image reference must be relative to the project: ${ref}
-` + `  Copy the file into your project folder and reference it from there.`);
+    const refError = proseImageRefError(ref, projectDir);
+    if (refError) {
+      errors.push(refError);
       continue;
     }
+    const cleaned = stripUrlSuffix(decodeRef(ref));
     const abs = path2.resolve(projectDir, cleaned);
     const rel = path2.relative(projectDir, abs);
-    if (rel.startsWith("..")) {
-      errors.push(`Image reference points outside the project: ${ref}
-` + `  Copy the file into your project folder and reference it from there.`);
-      continue;
-    }
     const dest = toPosix(rel);
     copies.set(dest, { from: abs, to: dest });
   }
@@ -2616,7 +2782,7 @@ function shadowPathFor(pluginPath, mtimeMs) {
   const ext = extname(pluginPath);
   const stem = basename(pluginPath, ext);
   const token = String(mtimeMs).replace(/\./g, "-");
-  return join2(dirname2(pluginPath), `.${stem}.gutterpress-reload-${token}${ext}`);
+  return join2(dirname2(pluginPath), `.${stem}.gutterpress-reload-${process.pid}-${token}${ext}`);
 }
 async function loadCachedPathPluginModule(pluginPath) {
   const mtimeMs = statSync2(pluginPath).mtimeMs;
@@ -3212,7 +3378,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.0.0",
+  version: "0.9.0-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using Paged.js and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -3224,7 +3390,7 @@ var package_default = {
     "ghostscript",
     "book",
     "publishing",
-    "ttrpg"
+    "zine"
   ],
   repository: {
     type: "git",
@@ -3452,7 +3618,7 @@ async function writeBuildFingerprint(input) {
         iccPath: input.pdfx.iccPath,
         stripAnnotations: input.pdfx.stripAnnotations
       },
-      outputDir
+      outputDir: input.recordedOutputDir ? path5.resolve(input.recordedOutputDir) : outputDir
     },
     sourceRevision,
     tools
@@ -3473,16 +3639,16 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-rn1dpdpn.json";
+var manifest_schema_default = "./manifest.schema-z61rzw44.json";
 
 // src/assets/preview/scripts/pagedjs-interface.js
-var pagedjs_interface_default = "./pagedjs-interface-80g3xa8p.js";
+var pagedjs_interface_default = "./pagedjs-interface-qxvzgwd7.js";
 
 // src/assets/preview/scripts/pagedjs-bridge.js
 var pagedjs_bridge_default = "./pagedjs-bridge-vn4hk9fx.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-rghtfmc8.js";
+var preview_shell_default = "./preview-shell-6dqexx1m.js";
 
 // src/assets/vendor/paged.polyfill.js
 var paged_polyfill_default = "./paged.polyfill-n95pbxfn.js";
@@ -3496,23 +3662,17 @@ var manifest_default = "./manifest-n1gh3qw5.yaml";
 // src/assets/templates/book/chapter-01.md
 var chapter_01_default = "./chapter-01-rkpyvjna.md";
 
-// src/assets/templates/ttrpg/manifest.yaml
-var manifest_default2 = "./manifest-ryyg71nf.yaml";
-
-// src/assets/templates/ttrpg/chapter-01.md
-var chapter_01_default2 = "./chapter-01-jj8ftn4c.md";
-
 // src/assets/templates/zine/manifest.yaml
-var manifest_default3 = "./manifest-n1gh3qw5.yaml";
+var manifest_default2 = "./manifest-n1gh3qw5.yaml";
 
 // src/assets/templates/zine/chapter-01.md
-var chapter_01_default3 = "./chapter-01-7jwqg1ct.md";
+var chapter_01_default2 = "./chapter-01-7jwqg1ct.md";
 
 // src/assets/templates/technical/manifest.yaml
-var manifest_default4 = "./manifest-n1gh3qw5.yaml";
+var manifest_default3 = "./manifest-n1gh3qw5.yaml";
 
 // src/assets/templates/technical/chapter-01.md
-var chapter_01_default4 = "./chapter-01-6fn9pvd0.md";
+var chapter_01_default3 = "./chapter-01-6fn9pvd0.md";
 
 // src/assets/themes/clean-book/theme.css
 var theme_default = "./theme-570zmh2t.css";
@@ -3520,23 +3680,17 @@ var theme_default = "./theme-570zmh2t.css";
 // src/assets/themes/clean-book/theme.json
 var theme_default2 = "./theme-xt0hjb1b.json";
 
-// src/assets/themes/ttrpg-supplement/theme.css
-var theme_default3 = "./theme-0yzvthe8.css";
-
-// src/assets/themes/ttrpg-supplement/theme.json
-var theme_default4 = "./theme-6a2fngc8.json";
-
 // src/assets/themes/zine/theme.css
-var theme_default5 = "./theme-zz2ktzqs.css";
+var theme_default3 = "./theme-zz2ktzqs.css";
 
 // src/assets/themes/zine/theme.json
-var theme_default6 = "./theme-cd6efzjw.json";
+var theme_default4 = "./theme-cd6efzjw.json";
 
 // src/assets/themes/technical-doc/theme.css
-var theme_default7 = "./theme-nya4nqh6.css";
+var theme_default5 = "./theme-nya4nqh6.css";
 
 // src/assets/themes/technical-doc/theme.json
-var theme_default8 = "./theme-tqfypc1w.json";
+var theme_default6 = "./theme-tqfypc1w.json";
 
 // src/lib/embedded-assets.ts
 var __libdir = dirname3(fileURLToPath2(import.meta.url));
@@ -3552,20 +3706,16 @@ var EMBEDDED_ASSETS = {
   "profiles/CGATS21_CRPC1.icc": abs(filePath(CGATS21_CRPC1_default)),
   "templates/book/manifest.yaml": abs(filePath(manifest_default)),
   "templates/book/chapter-01.md": abs(filePath(chapter_01_default)),
-  "templates/ttrpg/manifest.yaml": abs(filePath(manifest_default2)),
-  "templates/ttrpg/chapter-01.md": abs(filePath(chapter_01_default2)),
-  "templates/zine/manifest.yaml": abs(filePath(manifest_default3)),
-  "templates/zine/chapter-01.md": abs(filePath(chapter_01_default3)),
-  "templates/technical/manifest.yaml": abs(filePath(manifest_default4)),
-  "templates/technical/chapter-01.md": abs(filePath(chapter_01_default4)),
+  "templates/zine/manifest.yaml": abs(filePath(manifest_default2)),
+  "templates/zine/chapter-01.md": abs(filePath(chapter_01_default2)),
+  "templates/technical/manifest.yaml": abs(filePath(manifest_default3)),
+  "templates/technical/chapter-01.md": abs(filePath(chapter_01_default3)),
   "themes/clean-book/theme.css": abs(filePath(theme_default)),
   "themes/clean-book/theme.json": abs(filePath(theme_default2)),
-  "themes/ttrpg-supplement/theme.css": abs(filePath(theme_default3)),
-  "themes/ttrpg-supplement/theme.json": abs(filePath(theme_default4)),
-  "themes/zine/theme.css": abs(filePath(theme_default5)),
-  "themes/zine/theme.json": abs(filePath(theme_default6)),
-  "themes/technical-doc/theme.css": abs(filePath(theme_default7)),
-  "themes/technical-doc/theme.json": abs(filePath(theme_default8))
+  "themes/zine/theme.css": abs(filePath(theme_default3)),
+  "themes/zine/theme.json": abs(filePath(theme_default4)),
+  "themes/technical-doc/theme.css": abs(filePath(theme_default5)),
+  "themes/technical-doc/theme.json": abs(filePath(theme_default6))
 };
 var extractPromise = null;
 async function extractAssets() {
@@ -3797,7 +3947,7 @@ async function runLint(opts = {}) {
 
 // src/lib/validation-exec.ts
 import { existsSync as existsSync11 } from "node:fs";
-import { join as join6, resolve as resolve9 } from "node:path";
+import { dirname as dirname5, join as join6, resolve as resolve9 } from "node:path";
 
 // src/checks/formatter.ts
 function formatReport(report, format = "text") {
@@ -3809,19 +3959,19 @@ function formatReport(report, format = "text") {
 }
 function formatText(report) {
   for (const r of report.infos) {
-    const loc = formatLocation(r.file, r.line, r.column);
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
     log.info(`${loc}${r.message}`);
     if (r.detail)
       log.info(`  ${r.detail}`);
   }
   for (const r of report.warnings) {
-    const loc = formatLocation(r.file, r.line, r.column);
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
     log.warn(`${loc}${r.message}`);
     if (r.detail)
       log.warn(`  ${r.detail}`);
   }
   for (const r of report.errors) {
-    const loc = formatLocation(r.file, r.line, r.column);
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
     log.error(`${loc}${r.message}`);
     if (r.detail)
       log.error(`  ${r.detail}`);
@@ -3835,6 +3985,9 @@ function formatText(report) {
     log.success("VALIDATION PASSED");
   }
 }
+function targetPrefix(target) {
+  return target ? `[${target}] ` : "";
+}
 function formatJson(report) {
   console.log(JSON.stringify({
     results: report.results,
@@ -5239,6 +5392,16 @@ var check19 = {
           if (inFence)
             continue;
           for (const { ref, kind } of extractLocalRefs(line)) {
+            const escape = kind === "image" ? proseImageRefError(ref, ctx.inputDir) : null;
+            if (escape) {
+              results.push(finding(check19.id, {
+                severity: "error",
+                message: escape,
+                file,
+                line: i + 1
+              }));
+              continue;
+            }
             if (localRefExists(ref, kind, file, ctx.inputDir))
               continue;
             results.push(finding(check19.id, {
@@ -6301,58 +6464,46 @@ function reportMissingTools(result) {
   }
 }
 
-// src/lib/validation-profile.ts
-var DTRPG_STRICT_PDF_CHECKS = [
-  "pdf.structure.qpdf",
-  "pdf.print.pdfx-markers",
-  "pdf.print.pdfx-metadata",
-  "pdf.print.embedded-fonts"
-];
-function enforceStrictPdfChecks(config, overwrite = false) {
-  for (const checkId of DTRPG_STRICT_PDF_CHECKS) {
-    if (overwrite || config.validate.checks[checkId] === undefined) {
-      config.validate.checks[checkId] = {
-        enabled: true,
-        severity: "error"
-      };
-    }
+// src/lib/validation-exec.ts
+var SHIPPED_ASSET_EXTS = new Set([
+  ".woff2",
+  ".woff",
+  ".ttf",
+  ".otf",
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".svg",
+  ".tif",
+  ".tiff"
+]);
+async function sharedAssetDirs(manifestDir, relStyles, inputDir) {
+  let closure;
+  try {
+    closure = await collectStyleDependencies(manifestDir, relStyles);
+  } catch {
+    return [];
   }
-}
-function applyDefaultPdfStrictChecks(config) {
-  const next = structuredClone(config);
-  enforceStrictPdfChecks(next, false);
-  return next;
-}
-var applyDtrpgPdfDefaults = applyDefaultPdfStrictChecks;
-function applyValidationProfile(config, profile) {
-  const next = structuredClone(config);
-  if (profile === "dtrpg") {
-    next.pdfx.flavor = DTRPG_PRESET.pdfx.flavor;
-    next.ink.maxTac = DTRPG_PRESET.ink.maxTac;
-    next.ink.tacTolerance = DTRPG_PRESET.ink.tacTolerance;
-    next.validate.pdf.forbidTransparency = DTRPG_PRESET.validate.pdf.forbidTransparency;
-    next.validate.pdf.minImageResolution = DTRPG_PRESET.validate.pdf.minImageResolution;
-    next.validate.assets.allowedColorSpaces = [
-      ...DTRPG_PRESET.validate.assets.allowedColorSpaces
-    ];
-    enforceStrictPdfChecks(next, true);
+  const projectRoot = resolve9(inputDir);
+  const dirs = new Set;
+  for (const file of closure) {
+    const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
+    if (!SHIPPED_ASSET_EXTS.has(ext))
+      continue;
+    const dir = dirname5(resolve9(file));
+    if (escapesProjectRoot(projectRoot, dir))
+      dirs.add(dir);
   }
-  return next;
+  return [...dirs];
 }
-
-// src/lib/validation-exec.ts
 function parseCsv(value) {
   if (!value)
     return;
   return value.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
 }
-function parseProfile(raw) {
-  if (!raw)
-    return;
-  if (raw === "dtrpg")
-    return raw;
-  throw new Error(`Unsupported profile: ${raw}. Supported profiles: dtrpg`);
-}
 function resolvePhaseArg(raw) {
   const normalized = raw.trim().toLowerCase();
   if (normalized === "pre" || normalized === "pre-build")
@@ -6375,20 +6526,16 @@ function resolveCategoryArg(raw) {
   }
   return parsed;
 }
-function withProfileRequiredCheckErrors(report, tools, profile) {
-  if (!profile)
-    return report;
-  const required = profile === "dtrpg" ? DTRPG_STRICT_PDF_CHECKS : [];
-  if (required.length === 0)
-    return report;
+function withTargetRequiredCheckErrors(report, tools, target) {
   const skippedSet = new Set(tools.skippedChecks);
-  const missingRequired = required.filter((checkId) => skippedSet.has(checkId));
+  const missingRequired = target.requiredChecks.filter((checkId) => skippedSet.has(checkId));
   if (missingRequired.length === 0)
     return report;
   const syntheticErrors = missingRequired.map((checkId) => ({
     checkId,
+    target: target.id,
     severity: "error",
-    message: `Profile ${profile} requires check ${checkId}, but it was skipped because required tools are not available.`
+    message: `Target ${target.id} requires check ${checkId}, but it was skipped because required tools are not available.`
   }));
   const results = [...report.results, ...syntheticErrors];
   const errors = [...report.errors, ...syntheticErrors];
@@ -6402,19 +6549,115 @@ function withProfileRequiredCheckErrors(report, tools, profile) {
     }
   };
 }
+var TARGET_INDEPENDENT_CATEGORIES = ["source", "heuristic"];
+var TARGET_DEPENDENT_CATEGORIES = ["asset", "pdf"];
+function tagReport(report, targetId) {
+  const tag = (r) => ({ ...r, target: targetId });
+  return {
+    results: report.results.map(tag),
+    errors: report.errors.map(tag),
+    warnings: report.warnings.map(tag),
+    infos: report.infos.map(tag),
+    passed: report.passed,
+    summary: report.summary
+  };
+}
+function mergeReports(reports) {
+  const merged = {
+    results: [],
+    errors: [],
+    warnings: [],
+    infos: [],
+    passed: [],
+    summary: { total: 0, errors: 0, warnings: 0, infos: 0, passed: 0 }
+  };
+  for (const r of reports) {
+    merged.results.push(...r.results);
+    merged.errors.push(...r.errors);
+    merged.warnings.push(...r.warnings);
+    merged.infos.push(...r.infos);
+    merged.passed.push(...r.passed);
+    merged.summary.total += r.summary.total;
+    merged.summary.errors += r.summary.errors;
+    merged.summary.warnings += r.summary.warnings;
+    merged.summary.infos += r.summary.infos;
+    merged.summary.passed += r.summary.passed;
+  }
+  return merged;
+}
+function mergeTools(results) {
+  const available = new Set;
+  const missing = new Set;
+  const skippedChecks = new Set;
+  const toolToChecks = new Map;
+  for (const r of results) {
+    for (const t of r.available)
+      available.add(t);
+    for (const t of r.missing)
+      missing.add(t);
+    for (const id of r.skippedChecks)
+      skippedChecks.add(id);
+    for (const [tool, ids] of r.toolToChecks) {
+      const merged = new Set([...toolToChecks.get(tool) ?? [], ...ids]);
+      toolToChecks.set(tool, [...merged]);
+    }
+  }
+  return {
+    available: [...available],
+    missing: [...missing],
+    skippedChecks: [...skippedChecks],
+    toolToChecks
+  };
+}
+function planRuns(opts) {
+  const { manifest, baseConfig, targetIds, pdfPath, categories, only } = opts;
+  const finalize = (config) => pdfPath ? applyDefaultPdfStrictChecks(config) : config;
+  if (targetIds.length === 0) {
+    return [{ targetId: null, config: finalize(baseConfig), category: categories, only }];
+  }
+  const requested = categories ?? [...TARGET_INDEPENDENT_CATEGORIES, ...TARGET_DEPENDENT_CATEGORIES];
+  const independentCats = requested.filter((c) => TARGET_INDEPENDENT_CATEGORIES.includes(c));
+  const dependentCats = requested.filter((c) => TARGET_DEPENDENT_CATEGORIES.includes(c));
+  let baseOnly;
+  let dependentOnly;
+  if (only && only.length > 0) {
+    const { resolved, unmatched } = resolveCheckSelectors(only);
+    const categoryById = new Map(getChecks({}).map((c) => [c.id, c.category]));
+    const independentIds = resolved.filter((id) => TARGET_INDEPENDENT_CATEGORIES.includes(categoryById.get(id) ?? ""));
+    const dependentIds = resolved.filter((id) => TARGET_DEPENDENT_CATEGORIES.includes(categoryById.get(id) ?? ""));
+    baseOnly = [...independentIds, ...unmatched];
+    dependentOnly = dependentIds;
+  }
+  const runs = [];
+  const baseWanted = only ? (baseOnly?.length ?? 0) > 0 : independentCats.length > 0;
+  if (baseWanted) {
+    runs.push({
+      targetId: null,
+      config: baseConfig,
+      category: only ? undefined : independentCats,
+      only: baseOnly
+    });
+  }
+  const dependentWanted = only ? (dependentOnly?.length ?? 0) > 0 : dependentCats.length > 0;
+  if (dependentWanted) {
+    for (const targetId of targetIds) {
+      runs.push({
+        targetId,
+        config: finalize(resolveConfigForTarget({}, manifest, targetId)),
+        category: only ? undefined : dependentCats,
+        only: dependentOnly
+      });
+    }
+  }
+  return runs;
+}
 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 profile = parseProfile(typeof args.profile === "string" ? args.profile : undefined);
-  let config = resolveConfig({}, manifest);
+  const config = resolveConfig({}, manifest);
+  const targetIds = resolveTargets(parseCsv(typeof args.target === "string" ? args.target : undefined), config.targets);
   const pdfPath = typeof args.pdf === "string" ? resolve9(args.pdf) : undefined;
   const inputDir = typeof args.input === "string" ? resolve9(args.input) : undefined;
-  if (pdfPath) {
-    config = applyDtrpgPdfDefaults(config);
-  }
-  if (profile) {
-    config = applyValidationProfile(config, profile);
-  }
   if (pdfPath && !existsSync11(pdfPath)) {
     throw new Error(`File not found: ${pdfPath}`);
   }
@@ -6443,11 +6686,11 @@ async function executeValidation(args) {
   let htmlPath;
   const outDir = resolveOutputDir(manifestDir, config.title);
   if (inputDir) {
-    const relMarkdown = await resolveActiveMarkdownFiles(inputDir, config.source.files);
-    markdownFiles = relMarkdown.map((f) => join6(inputDir, canonicalChapterId(f)));
-    const relStyles = await resolveActiveStyles(inputDir, config.styles);
-    cssFiles = relStyles.map((rel) => resolve9(inputDir, rel)).filter((f) => !f.endsWith(".min.css"));
-    assetDirs = [inputDir];
+    const relMarkdown = await resolveActiveMarkdownFiles(manifestDir, config.source.files);
+    markdownFiles = relMarkdown.map((f) => join6(manifestDir, canonicalChapterId(f)));
+    const relStyles = await resolveActiveStyles(manifestDir, config.styles);
+    cssFiles = relStyles.map((rel) => resolve9(manifestDir, rel)).filter((f) => !f.endsWith(".min.css"));
+    assetDirs = [inputDir, ...await sharedAssetDirs(manifestDir, relStyles, inputDir)];
     const possibleHtml = join6(outDir, BOOK_HTML_FILENAME);
     if (existsSync11(possibleHtml)) {
       htmlPath = possibleHtml;
@@ -6469,15 +6712,30 @@ async function executeValidation(args) {
     only,
     skip
   };
-  const tools = await checkToolAvailability(config, runnerOptions);
-  const initialReport = await runChecks(context, {
-    ...runnerOptions,
-    skipMissingTools: tools.skippedChecks
-  });
-  const report = withProfileRequiredCheckErrors(initialReport, tools, profile);
+  const runs = planRuns({ manifest, baseConfig: config, targetIds, pdfPath, categories, only });
+  const reports = [];
+  const toolResults = [];
+  for (const run2 of runs) {
+    const runOptions = {
+      category: run2.category,
+      phase,
+      only: run2.only,
+      skip
+    };
+    const runTools = await checkToolAvailability(run2.config, runOptions);
+    toolResults.push(runTools);
+    let runReport = await runChecks({ ...context, config: run2.config }, { ...runOptions, skipMissingTools: runTools.skippedChecks });
+    if (run2.targetId !== null) {
+      runReport = withTargetRequiredCheckErrors(runReport, runTools, publishTargetFor(run2.targetId));
+      runReport = tagReport(runReport, run2.targetId);
+    }
+    reports.push(runReport);
+  }
+  const tools = mergeTools(toolResults);
+  const report = mergeReports(reports);
   return {
     config,
-    profile,
+    targets: targetIds,
     context,
     runnerOptions,
     tools,
@@ -6555,7 +6813,7 @@ ${m.installHint}`).join(`
 
 ${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 8 (System Setup) at examples/gutterpress-user-guide/08-system-setup.md for the full per-feature matrix.`, 2);
+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) {
   if (format === "html") {
@@ -6649,6 +6907,15 @@ function resolveWithinRoot(relPath, root) {
   }
   return candidate;
 }
+function hasDotSegment(urlPathname) {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(urlPathname);
+  } catch {
+    return true;
+  }
+  return decoded.split(/[/\\]/).some((segment) => segment.startsWith("."));
+}
 function resolveStaticPath(urlPathname, root) {
   let decoded;
   try {
@@ -7047,14 +7314,25 @@ async function resolveBuildContext(opts) {
   const outDir = target.kind === "file" ? path9.dirname(target.file) : target.dir;
   const gates = computeGates(format, opts, config);
   const workDir = target.kind === "project" ? path9.join(path9.dirname(target.dir), `.${path9.basename(target.dir)}-build-${randomBytes(6).toString("hex")}`) : path9.join(os2.tmpdir(), `gutterpress-build-${randomBytes(6).toString("hex")}`);
-  return { opts, format, inputDir, outDir, workDir, target, manifestDir, config, gates };
+  return {
+    opts,
+    format,
+    inputDir,
+    renderDir: manifestDir,
+    outDir,
+    workDir,
+    target,
+    manifestDir,
+    config,
+    gates
+  };
 }
 async function runQualityGates(ctx) {
-  const { gates, opts, inputDir } = ctx;
+  const { gates, opts, renderDir } = ctx;
   if (gates.lint) {
     log.info("Lint: CSS print-safety");
     const lintResult = await runLint({
-      manifest: opts.manifestPath ?? inputDir
+      manifest: opts.manifestPath ?? renderDir
     });
     if (!lintResult.ok) {
       throw new BuildError("CSS lint failed", 2);
@@ -7063,7 +7341,7 @@ async function runQualityGates(ctx) {
   if (gates.preValidate) {
     log.info("Pre-build validation");
     const result = await executeAndReport({
-      input: inputDir,
+      input: renderDir,
       phase: "pre-build",
       manifest: opts.manifestPath
     }, "text");
@@ -7073,7 +7351,7 @@ async function runQualityGates(ctx) {
   }
 }
 async function renderBook(ctx) {
-  const { config, manifestDir, inputDir, workDir } = ctx;
+  const { config, renderDir, workDir } = ctx;
   if (config.source.files && config.source.files.length > 0) {
     log.info(`Using specified files (${config.source.files.length} total)`);
   } else {
@@ -7082,13 +7360,13 @@ async function renderBook(ctx) {
   if (config.plugins.length > 0) {
     log.info(`Loading ${config.plugins.length} plugin(s)...`);
   }
-  const { plugins, pluginCss } = await loadPluginsWithCss(config.plugins, manifestDir);
+  const { plugins, pluginCss } = await loadPluginsWithCss(config.plugins, renderDir);
   if (plugins && plugins.length > 0) {
     log.success(`Loaded ${plugins.length} plugin(s)`);
   }
   const imageRefs = [];
   const cssAssets = [];
-  const htmlFile = await renderChaptersToFile(inputDir, workDir, {
+  const htmlFile = await renderChaptersToFile(renderDir, workDir, {
     title: config.title,
     styles: config.styles,
     files: config.source.files,
@@ -7107,7 +7385,7 @@ async function renderBook(ctx) {
     }
   });
   log.success(`Wrote ${htmlFile}`);
-  const { copies: imageCopies, errors } = await planImageCopies(inputDir, imageRefs);
+  const { copies: imageCopies, errors } = await planImageCopies(renderDir, imageRefs);
   if (errors.length > 0) {
     throw new BuildError(`Cannot resolve ${errors.length} image reference(s):
 ` + errors.map((e) => `  - ${e}`).join(`
@@ -7146,7 +7424,8 @@ async function resolveIccProfile(icc, manifestDir, explicitIccPath) {
 async function finalizeBuild(ctx, fingerprint, wroteMessage, paths, artifactName2 = null) {
   const workFingerprint = await writeBuildFingerprint({
     ...fingerprint,
-    outputDir: ctx.workDir
+    outputDir: ctx.workDir,
+    recordedOutputDir: fingerprint.outputDir
   });
   await publishBuild(ctx, artifactName2);
   const delivered = ctx.target.kind !== "file";
@@ -7237,7 +7516,9 @@ class PdfOutput {
       await renderHtmlToPdf(htmlFile, rawPdf, opts.pdfRenderer, staticHtmlRaw);
       if (staticHtmlRaw && fs2.existsSync(staticHtmlRaw)) {
         await finalizeStaticBook(await fsp3.readFile(staticHtmlRaw, "utf-8"), htmlFile, workDir);
-        log.success(`Wrote static desktop: ${path9.join(outDir, BOOK_HTML)}`);
+        if (ctx.target.kind !== "file") {
+          log.success(`Wrote static desktop: ${path9.join(outDir, BOOK_HTML)}`);
+        }
       }
       if (!pdfxMode) {
         try {
@@ -7370,6 +7651,7 @@ async function renderPreviewBook(inputPath, config, opts) {
     plugins,
     pluginCss,
     wrapChapters: opts.wrapChapters,
+    ...opts.onCssAssets ? { onCssAssets: opts.onCssAssets } : {},
     onChapterWarnings: (file, warnings) => {
       for (const w of warnings) {
         warn2(`  ${file}, line ${w.line}: ${w.message}`);
@@ -7377,23 +7659,70 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html) {
+function injectPreviewScripts(html, pageIsolateChapters) {
   const iface = `<script src="/preview/scripts/pagedjs-interface.js"></script>
   ` + `<script src="/preview/scripts/pagedjs-bridge.js"></script>
   `;
-  return html.replace(pagedjsPolyfillTagRegex(), iface + BREAK_INSIDE_HANDLER + `
+  let output = html.replace(pagedjsPolyfillTagRegex(), iface + BREAK_INSIDE_HANDLER + `
   <script src="/vendor/paged.polyfill.js"></script>`);
+  if (pageIsolateChapters && /<\/head>/i.test(output)) {
+    output = output.replace(/<\/head>/i, `<style>.gutterpress-chapter{break-before:page}</style>
+</head>`);
+  }
+  return output;
 }
-async function generateAndWriteHtml(inputPath, tempDir, config) {
+async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets) {
   if (!inputPath) {
+    cssAssets.clear();
     await fsp4.writeFile(path10.join(tempDir, BOOK_HTML_FILENAME), EMPTY_BOOK_HTML, "utf-8");
     return;
   }
+  const nextAssets = new Map;
+  const incremental = incrementalPreviewEnabled();
   const html = await renderPreviewBook(inputPath, config, {
     files: config.source?.files ?? null,
+    wrapChapters: incremental,
+    onCssAssets: (copies) => {
+      for (const copy of copies)
+        nextAssets.set(copy.to, copy.from);
+    }
+  });
+  cssAssets.clear();
+  for (const [to, from] of nextAssets)
+    cssAssets.set(to, from);
+  await fsp4.writeFile(path10.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, incremental), "utf-8");
+}
+async function renderChapterPreviewHtml(inputPath, file, config) {
+  const html = await renderPreviewBook(inputPath, config, {
+    files: [canonicalChapterId(file)],
     wrapChapters: true
   });
-  await fsp4.writeFile(path10.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html), "utf-8");
+  return injectPreviewScripts(html, true);
+}
+function describeChanges(changes, inputResolved) {
+  const files = [];
+  for (const [changedPath, event] of changes) {
+    const relative2 = path10.relative(inputResolved, path10.resolve(changedPath));
+    if (relative2 === "" || relative2 === ".." || relative2.startsWith(`..${path10.sep}`) || path10.isAbsolute(relative2))
+      continue;
+    files.push({
+      relativePath: canonicalChapterId(relative2),
+      ext: path10.extname(changedPath).toLowerCase(),
+      event
+    });
+  }
+  return files;
+}
+function decideBroadcast(files, changeCount, incremental) {
+  const only = files.length === 1 ? files[0] : null;
+  if (incremental && changeCount === 1 && only?.ext === ".md" && only.event !== "unlink" && only.event !== "unlinkDir") {
+    return {
+      kind: "chapter-splice",
+      chapterId: canonicalChapterId(only.relativePath),
+      relativePath: only.relativePath
+    };
+  }
+  return { kind: "full-reload" };
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");
@@ -7410,11 +7739,24 @@ function isDotPathUnderRoot(candidatePath, root) {
     return false;
   return rel.split("/").some((segment) => segment.startsWith("."));
 }
+function isGeneratedProjectPath(relative2) {
+  const segments = relative2.split("/");
+  for (let i = 0;i < segments.length; i++) {
+    const segment = segments[i];
+    if (segment === "dist" || segment === "node_modules")
+      return true;
+    if (segment === "plugins" && segments[i + 1] === "npm")
+      return true;
+  }
+  return false;
+}
 function isIgnoredWatchPath(candidatePath, projectRoot) {
   const normalizedRoot = projectRoot.replace(/\\/g, "/").replace(/\/+$/, "");
   const normalizedPath = candidatePath.replace(/\\/g, "/");
-  const inProject = normalizedPath === normalizedRoot || normalizedPath.startsWith(normalizedRoot + "/");
-  return inProject ? isDotPathUnderRoot(candidatePath, projectRoot) : false;
+  if (!normalizedPath.startsWith(normalizedRoot + "/"))
+    return false;
+  const relative2 = normalizedPath.slice(normalizedRoot.length + 1);
+  return isDotPathUnderRoot(candidatePath, projectRoot) || isGeneratedProjectPath(relative2);
 }
 function isExternalWatchCandidate(candidatePath, targets) {
   const candidate = path10.resolve(candidatePath);
@@ -7499,21 +7841,43 @@ function createFileWatcher(state) {
   let closed = false;
   const pendingChanges = new Map;
   const suppressInitialExternalAdds = new Set;
+  const settledWrites = new Map;
+  let immediatePending = false;
   function scheduleRebuild() {
     if (closed)
       return;
     if (state.rebuildTimer)
       clearTimeout(state.rebuildTimer);
-    state.rebuildTimer = setTimeout(runRebuild, DEBOUNCE.FILE_WATCH);
-  }
-  function recordChange(event, filePath2) {
+    const timer = setTimeout(() => {
+      if (state.rebuildTimer === timer)
+        state.rebuildTimer = null;
+      runRebuild();
+    }, DEBOUNCE.FILE_WATCH);
+    state.rebuildTimer = timer;
+  }
+  async function recordChange(event, filePath2) {
     if (closed)
       return;
-    debug(`File ${event}: ${filePath2}`);
-    pendingChanges.set(path10.resolve(filePath2), event);
+    const target = path10.resolve(filePath2);
+    const settled = settledWrites.get(target);
+    if (settled && event !== "unlink" && Date.now() <= settled.expiresAt) {
+      const diskContent = await fsp4.readFile(target, "utf8").catch(() => null);
+      if (closed)
+        return;
+      if (settledWrites.get(target) === settled && diskContent === settled.content) {
+        debug(`Suppressed settled-write watcher echo: ${target}`);
+        return;
+      }
+    }
+    if (settledWrites.get(target) === settled)
+      settledWrites.delete(target);
+    debug(`File ${event}: ${target}`);
+    pendingChanges.set(target, event);
     scheduleRebuild();
   }
-  watcher.on("all", recordChange);
+  watcher.on("all", (event, filePath2) => {
+    recordChange(event, filePath2);
+  });
   externalWatcher.on("all", (event, filePath2) => {
     const target = path10.resolve(filePath2);
     if (!desiredExternals.has(target))
@@ -7522,6 +7886,43 @@ function createFileWatcher(state) {
       return;
     recordChange(event, target);
   });
+  function isWatchedSource(target) {
+    const rel = path10.relative(inputResolved, target);
+    const inProject = rel === "" || rel !== ".." && !rel.startsWith(`..${path10.sep}`) && !path10.isAbsolute(rel);
+    if (inProject)
+      return !isIgnoredWatchPath(target, inputResolved);
+    return desiredExternals.has(target);
+  }
+  function acceptSettledWrite(target, writtenContent) {
+    const settled = { content: writtenContent, expiresAt: Date.now() + 2000 };
+    settledWrites.set(target, settled);
+    const expiry = setTimeout(() => {
+      if (settledWrites.get(target) === settled)
+        settledWrites.delete(target);
+    }, 2000);
+    expiry.unref?.();
+    pendingChanges.set(target, "change");
+    immediatePending = true;
+    if (state.rebuildTimer) {
+      clearTimeout(state.rebuildTimer);
+      state.rebuildTimer = null;
+    }
+    if (!state.isRebuilding)
+      runRebuild();
+  }
+  state.notifySettledWrite = (filePath2, writtenContent) => {
+    if (closed)
+      return;
+    const target = path10.resolve(filePath2);
+    if (isWatchedSource(target)) {
+      acceptSettledWrite(target, writtenContent);
+      return;
+    }
+    syncQueue.then(() => {
+      if (!closed && isWatchedSource(target))
+        acceptSettledWrite(target, writtenContent);
+    });
+  };
   let watchedExternalRoots = new Set;
   let syncQueue = Promise.resolve();
   function syncExternalWatches() {
@@ -7573,10 +7974,15 @@ function createFileWatcher(state) {
   async function runRebuild() {
     if (closed || state.isRebuilding)
       return;
+    if (state.rebuildTimer) {
+      clearTimeout(state.rebuildTimer);
+      state.rebuildTimer = null;
+    }
     const changes = [...pendingChanges.entries()];
     pendingChanges.clear();
     if (changes.length === 0)
       return;
+    immediatePending = false;
     state.isRebuilding = true;
     let resolveInFlight;
     const inFlight = new Promise((resolve10) => {
@@ -7593,11 +7999,17 @@ function createFileWatcher(state) {
       await syncExternalWatches();
       if (closed)
         return;
-      await generateAndWriteHtml(inputResolved, state.tempDir, updatedConfig);
+      await generateAndWriteHtml(inputResolved, state.tempDir, updatedConfig, state.cssAssets);
       if (closed)
         return;
-      state.previewServer?.broadcastReload();
-      info(changes.length > 1 ? `Preview updated (${changes.length} files changed — full reload)` : "Preview updated");
+      const decision = decideBroadcast(describeChanges(changes, inputResolved), changes.length, incrementalPreviewEnabled());
+      if (decision.kind === "chapter-splice") {
+        state.previewServer?.broadcastContentUpdate(decision.chapterId);
+        info(`Chapter updated: ${decision.relativePath}`);
+      } else {
+        state.previewServer?.broadcastReload();
+        info(changes.length > 1 ? `Preview updated (${changes.length} files changed — full reload)` : "Preview updated");
+      }
     } catch (err) {
       error("Failed to regenerate preview:", err);
     } finally {
@@ -7605,13 +8017,19 @@ function createFileWatcher(state) {
       resolveInFlight();
       if (state.rebuildPromise === inFlight)
         state.rebuildPromise = null;
-      if (!closed && pendingChanges.size > 0)
-        scheduleRebuild();
+      if (!closed && pendingChanges.size > 0) {
+        if (immediatePending)
+          runRebuild();
+        else
+          scheduleRebuild();
+      }
     }
   }
   const closeBookWatcher = watcher.close.bind(watcher);
   watcher.close = async () => {
     closed = true;
+    state.notifySettledWrite = null;
+    settledWrites.clear();
     await syncQueue.catch(() => {});
     await state.rebuildPromise?.catch(() => {});
     await externalWatcher.close();
@@ -7710,7 +8128,7 @@ async function restartPreview(newInputPath, state) {
   state.currentInputPath = newInputPath;
   const manifest = await loadManifest(newInputPath);
   state.config = resolveConfig({}, manifest);
-  await generateAndWriteHtml(newInputPath, state.tempDir, state.config);
+  await generateAndWriteHtml(newInputPath, state.tempDir, state.config, state.cssAssets);
   startFileWatcher(state);
   state.previewServer?.broadcastReload();
   info("Preview restarted successfully");
@@ -7764,17 +8182,20 @@ function createServerState(inputPath, tempDir, config, options) {
     rebuildTimer: null,
     isRebuilding: false,
     rebuildPromise: null,
+    notifySettledWrite: null,
     previewServer: null,
     isShuttingDown: false,
     tempDir,
     config,
-    options
+    options,
+    cssAssets: new Map
   };
 }
 
 // src/preview/http-server.ts
 import http2 from "node:http";
 import net from "node:net";
+import { randomUUID } from "node:crypto";
 import { readFile as readFile21, stat as stat4 } from "node:fs/promises";
 import path12 from "path";
 import { WebSocket, WebSocketServer } from "ws";
@@ -7809,7 +8230,8 @@ function openPath(filePath2) {
 
 // src/preview/http-server.ts
 var HMR_PATH = "/__gutterpress-hmr";
-var HMR_CLIENT_SNIPPET = `
+function hmrClientSnippet(initialRevision, instanceId) {
+  return `
 <script>
   (function () {
     // When loaded by the preview SHELL (iframe double-buffer), the shell loads us
@@ -7819,6 +8241,10 @@ var HMR_CLIENT_SNIPPET = `
     // for scroll-anchor and reload.
     if (/[?&]gutterpressshell=1/.test(location.search)) return;
   var ANCHOR_KEY = 'gutterpress-scroll-anchor';
+  var appliedRevision = ${initialRevision};
+  var appliedInstance = ${JSON.stringify(instanceId)};
+  var readyToAcknowledge = false;
+  var reloadRequested = false;
 
     // Find the element nearest the top of the viewport that carries a source
     // line (markdown-it-source-map emits data-source-line on block elements).
@@ -7869,7 +8295,13 @@ var HMR_CLIENT_SNIPPET = `
           }
         }
         if (el) {
-          window.scrollBy(0, el.getBoundingClientRect().top - a.offset);
+          window.scrollBy({
+            top: el.getBoundingClientRect().top - a.offset,
+            behavior: 'instant'
+          });
+          if (window.previewAPI && typeof window.previewAPI.refresh === 'function') {
+            window.previewAPI.refresh();
+          }
           return;
         }
         if (tries++ < 240) setTimeout(attempt, 25); // wait for pagination
@@ -7877,44 +8309,100 @@ var HMR_CLIENT_SNIPPET = `
     }
     var restored = false;
     function restoreOnce() { if (restored) return; restored = true; restoreAnchor(); }
+    function finishInitialRender() {
+      restoreOnce();
+      readyToAcknowledge = true;
+      acknowledge();
+    }
     // CRITICAL ordering: when the Paged.js polyfill is present it re-paginates on
-    // load and its PagedConfig.after calls scrollTo(0,0) THEN fires
+    // load and its PagedConfig.after scrolls to the document start THEN fires
     // 'renderingComplete'. So in engine mode we MUST wait for that event —
-    // restoring earlier would be wiped by the scrollTo(0,0). In static mode (no
+    // restoring earlier would be wiped by that initial scroll. In static mode (no
     // engine) the content is final immediately, so restore right after load.
-    var hasEngine = !!document.querySelector('script[src*="paged.polyfill"], script[src*="pagedjs"]');
-    window.addEventListener('renderingComplete', restoreOnce);
+    var hasEngine = !!document.querySelector('script[src*="paged.polyfill"]');
+    window.addEventListener('renderingComplete', finishInitialRender);
     if (!hasEngine) {
       if (document.readyState === 'loading') {
-        document.addEventListener('DOMContentLoaded', function () { setTimeout(restoreOnce, 50); });
+        document.addEventListener('DOMContentLoaded', function () { setTimeout(finishInitialRender, 50); });
       } else {
-        setTimeout(restoreOnce, 50);
+        setTimeout(finishInitialRender, 50);
       }
     }
-    setTimeout(restoreOnce, 10000); // safety net if renderingComplete never fires
+    var ws = null;
+    var reconnectTimer = null;
+    var reconnectDelay = 250;
+    var stopped = false;
 
-    var ws = new WebSocket(location.origin.replace(/^http/, 'ws') + '${HMR_PATH}');
-    ws.onmessage = function (e) {
-      var msg;
-      try { msg = JSON.parse(e.data); } catch (_) { return; }
-      if (msg.type === 'full-reload') {
+    function acknowledge() {
+      if (!readyToAcknowledge || !ws || ws.readyState !== 1) return;
+      try {
+        ws.send(JSON.stringify({
+          type: 'reload-applied',
+          instance: appliedInstance,
+          revision: appliedRevision
+        }));
+      } catch (_) {}
+    }
+
+    function connect() {
+      if (stopped) return;
+      ws = new WebSocket(location.origin.replace(/^http/, 'ws') + '${HMR_PATH}');
+      ws.onopen = function () {
+        reconnectDelay = 250;
+        acknowledge();
+      };
+      ws.onmessage = function (e) {
+        var msg;
+        try { msg = JSON.parse(e.data); } catch (_) { return; }
+        if (
+          msg.type !== 'reload-state' &&
+          msg.type !== 'full-reload' &&
+          msg.type !== 'content-update'
+        ) return;
+        var instance = typeof msg.instance === 'string' ? msg.instance : null;
+        var revision = Number(msg.revision);
+        if (!instance || !Number.isSafeInteger(revision) || revision < 0) return;
+        if (instance === appliedInstance && revision <= appliedRevision) {
+          acknowledge();
+          return;
+        }
+        if (reloadRequested) return;
+        reloadRequested = true;
         try { var a = captureAnchor(); if (a) sessionStorage.setItem(ANCHOR_KEY, JSON.stringify(a)); } catch (_) {}
         location.reload();
-        return;
-      }
-    };
+      };
+      ws.onclose = function () {
+        ws = null;
+        if (stopped || reconnectTimer !== null) return;
+        reconnectTimer = setTimeout(function () {
+          reconnectTimer = null;
+          connect();
+        }, reconnectDelay);
+        reconnectDelay = Math.min(reconnectDelay * 2, 5000);
+      };
+      ws.onerror = function () { try { ws.close(); } catch (_) {} };
+    }
+
+    window.addEventListener('beforeunload', function () {
+      stopped = true;
+      if (reconnectTimer !== null) clearTimeout(reconnectTimer);
+    });
+    connect();
   })();
 </script>
 `;
-var SHELL_HTML = `<!doctype html>
+}
+function shellHtml(initialRevision, instanceId) {
+  return `<!doctype html>
 <html lang="en"><head><meta charset="utf-8"><title>gutterpress preview</title>
 <style>html,body{margin:0;height:100%;background:#fff;overflow:hidden}
 iframe{position:absolute;inset:0;width:100%;height:100%;border:0;display:block}</style>
 </head><body>
 <iframe id="gutterpress-active" src="/book.html?gutterpressshell=1" title="preview"></iframe>
-<script>window.__GUTTERPRESS_HMR=${JSON.stringify(HMR_PATH)};</script>
+<script>window.__GUTTERPRESS_HMR=${JSON.stringify(HMR_PATH)};window.__GUTTERPRESS_INSTANCE=${JSON.stringify(instanceId)};window.__GUTTERPRESS_REVISION=${initialRevision};</script>
 <script src="/preview/scripts/preview-shell.js"></script>
 </body></html>`;
+}
 function probePort(port, host) {
   return new Promise((resolve10) => {
     const srv = net.createServer();
@@ -7956,13 +8444,14 @@ async function findAvailablePort(startPort, host = "127.0.0.1") {
   }
   throw new BuildError(`Could not find an available port on ${host} from ${firstPort} to ${port - 1}; all are already in use. ` + "Stop another preview server or pass --port with an available port.", undefined, { cause: lastBusyError });
 }
-function injectHmrClient(html) {
+function injectHmrClient(html, revision, instanceId) {
+  const snippet = hmrClientSnippet(revision, instanceId);
   const closingBody = html.lastIndexOf("</body>");
   if (closingBody === -1)
-    return html + HMR_CLIENT_SNIPPET;
-  return html.slice(0, closingBody) + HMR_CLIENT_SNIPPET + html.slice(closingBody);
+    return html + snippet;
+  return html.slice(0, closingBody) + snippet + html.slice(closingBody);
 }
-async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders = {}) {
+async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders = {}, hmrRevision = 0, hmrInstance = "") {
   let filePath2 = absPath;
   try {
     const s = await stat4(filePath2);
@@ -7983,7 +8472,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   const isHtml = filePath2.endsWith(".html") || filePath2.endsWith(".htm");
   if (isHtml) {
-    const withHmr = injectHmrClient(data.toString("utf-8"));
+    const withHmr = injectHmrClient(data.toString("utf-8"), hmrRevision, hmrInstance);
     res.writeHead(200, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-store" });
     res.end(withHmr);
     return;
@@ -8001,21 +8490,89 @@ function matchesEmbedded(urlPathname) {
     return true;
   return EMBEDDED_PREFIXES.some((p) => urlPathname.startsWith(p));
 }
-function isDotfileRequest(urlPathname) {
-  let decoded;
-  try {
-    decoded = decodeURIComponent(urlPathname);
-  } catch {
-    return true;
-  }
-  return decoded.split("/").some((segment) => segment.startsWith("."));
-}
 async function createPreviewServer(state, port) {
-  const clients = new Set;
+  const ACK_RETRY_MS = 2000;
+  const MAX_ACK_RETRIES = 95;
+  const instanceId = randomUUID();
+  let reloadRevision = 0;
+  const clients = new Map;
+  function sendRevision(ws, type, file) {
+    if (ws.readyState !== WebSocket.OPEN)
+      return;
+    try {
+      ws.send(JSON.stringify({
+        type,
+        instance: instanceId,
+        revision: reloadRevision,
+        ...file ? { file } : {}
+      }));
+    } catch {}
+  }
+  function waitForAcknowledgement(ws) {
+    const client = clients.get(ws);
+    if (!client)
+      return;
+    if (client.acknowledgedRevision >= reloadRevision) {
+      if (client.retryTimer !== null)
+        clearTimeout(client.retryTimer);
+      client.retryTimer = null;
+      client.retryAttempts = 0;
+      return;
+    }
+    if (client.retryTimer !== null)
+      return;
+    client.retryTimer = setTimeout(() => {
+      const current = clients.get(ws);
+      if (!current)
+        return;
+      current.retryTimer = null;
+      if (current.retryAttempts >= MAX_ACK_RETRIES) {
+        ws.terminate();
+        return;
+      }
+      current.retryAttempts++;
+      sendRevision(ws, "reload-state");
+      waitForAcknowledgement(ws);
+    }, ACK_RETRY_MS);
+    client.retryTimer.unref?.();
+  }
+  function removeClient(ws) {
+    const client = clients.get(ws);
+    if (client && client.retryTimer !== null)
+      clearTimeout(client.retryTimer);
+    clients.delete(ws);
+  }
   const wss = new WebSocketServer({ noServer: true });
   wss.on("connection", (ws) => {
-    clients.add(ws);
-    ws.on("close", () => clients.delete(ws));
+    clients.set(ws, { acknowledgedRevision: -1, retryAttempts: 0, retryTimer: null });
+    ws.on("message", (raw) => {
+      let message;
+      try {
+        message = JSON.parse(raw.toString());
+      } catch {
+        return;
+      }
+      if (!message || typeof message !== "object")
+        return;
+      const payload = message;
+      if (payload.type !== "reload-applied")
+        return;
+      const revision = Number(payload.revision);
+      if (payload.instance !== instanceId || !Number.isSafeInteger(revision) || revision < 0 || revision > reloadRevision)
+        return;
+      const client = clients.get(ws);
+      if (!client)
+        return;
+      client.acknowledgedRevision = Math.max(client.acknowledgedRevision, revision);
+      waitForAcknowledgement(ws);
+    });
+    ws.on("close", () => removeClient(ws));
+    ws.on("error", () => {
+      removeClient(ws);
+      ws.terminate();
+    });
+    sendRevision(ws, "reload-state");
+    waitForAcknowledgement(ws);
   });
   const server = http2.createServer(async (req, res) => {
     const url = new URL(req.url, "http://127.0.0.1");
@@ -8038,6 +8595,34 @@ async function createPreviewServer(state, port) {
       res.end("Not Found");
       return;
     }
+    if (url.pathname === "/__chapter" && req.method === "GET") {
+      const rawFile = url.searchParams.get("file");
+      const file = rawFile ? canonicalChapterId(rawFile) : "";
+      const revision = Number(url.searchParams.get("revision"));
+      const configuredFiles = state.config.source?.files;
+      if (!file || !state.currentInputPath || !incrementalPreviewEnabled() || !Number.isSafeInteger(revision) || revision !== reloadRevision || path12.extname(file).toLowerCase() !== ".md" || hasDotSegment(file) || !resolveWithinRoot(file, state.currentInputPath) || Array.isArray(configuredFiles) && configuredFiles.length > 0 && !configuredFiles.some((configured) => canonicalChapterId(configured) === file)) {
+        res.writeHead(400);
+        res.end("Bad Request");
+        return;
+      }
+      try {
+        const html = await renderChapterPreviewHtml(state.currentInputPath, file, state.config);
+        if (revision !== reloadRevision) {
+          res.writeHead(409);
+          res.end("Superseded");
+          return;
+        }
+        res.writeHead(200, {
+          "Content-Type": "text/html; charset=utf-8",
+          "Cache-Control": "no-store"
+        });
+        res.end(html);
+      } catch (error2) {
+        res.writeHead(500);
+        res.end(error2 instanceof Error ? error2.message : String(error2));
+      }
+      return;
+    }
     if (matchesEmbedded(url.pathname)) {
       if (req.headers["if-none-match"] === EMBEDDED_ETAG) {
         res.writeHead(304, { ETag: EMBEDDED_ETAG, "Cache-Control": EMBEDDED_CACHE_CONTROL });
@@ -8056,12 +8641,22 @@ async function createPreviewServer(state, port) {
     }
     if (url.pathname === "/" && incrementalPreviewEnabled()) {
       res.writeHead(200, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-store" });
-      res.end(SHELL_HTML);
+      res.end(shellHtml(reloadRevision, instanceId));
       return;
     }
     const pathname = url.pathname === "/" ? "/book.html" : url.pathname;
+    const cssAssetSource = state.cssAssets.get(pathname.replace(/^\/+/, ""));
+    if (cssAssetSource) {
+      await serveStatic(cssAssetSource, res).catch((err) => {
+        if (!res.headersSent) {
+          res.writeHead(500);
+          res.end(`Internal Server Error: ${err.message}`);
+        }
+      });
+      return;
+    }
     const servingProjectRoot = pathname !== "/book.html";
-    if (servingProjectRoot && (!state.currentInputPath || isDotfileRequest(pathname))) {
+    if (servingProjectRoot && (!state.currentInputPath || hasDotSegment(pathname))) {
       res.writeHead(404);
       res.end("Not Found");
       return;
@@ -8073,7 +8668,7 @@ async function createPreviewServer(state, port) {
       res.end("Not Found");
       return;
     }
-    await serveStatic(absPath, res).catch((err) => {
+    await serveStatic(absPath, res, "no-store", {}, reloadRevision, instanceId).catch((err) => {
       if (!res.headersSent) {
         res.writeHead(500);
         res.end(`Internal Server Error: ${err.message}`);
@@ -8100,23 +8695,33 @@ async function createPreviewServer(state, port) {
     openPath(serverUrl).catch(() => {});
   }
   let stopped = false;
-  const broadcast = (payload) => {
+  const broadcastUpdate = (type, file) => {
     if (stopped)
       return;
-    const message = JSON.stringify(payload);
-    for (const ws of clients) {
-      if (ws.readyState === WebSocket.OPEN)
-        ws.send(message);
+    reloadRevision++;
+    for (const [ws] of clients) {
+      sendRevision(ws, type, file);
+      waitForAcknowledgement(ws);
     }
   };
+  const updateInFlight = () => {
+    for (const client of clients.values()) {
+      if (client.acknowledgedRevision < reloadRevision)
+        return true;
+    }
+    return false;
+  };
   return {
     port: boundPort,
     async close() {
       if (stopped)
         return;
       stopped = true;
-      for (const ws of clients)
+      for (const [ws, client] of clients) {
+        if (client.retryTimer !== null)
+          clearTimeout(client.retryTimer);
         ws.terminate();
+      }
       clients.clear();
       wss.close();
       await new Promise((resolve10) => {
@@ -8127,7 +8732,13 @@ async function createPreviewServer(state, port) {
       });
     },
     broadcastReload() {
-      broadcast({ type: "full-reload" });
+      broadcastUpdate("full-reload");
+    },
+    broadcastContentUpdate(file) {
+      if (updateInFlight())
+        broadcastUpdate("full-reload");
+      else
+        broadcastUpdate("content-update", canonicalChapterId(file));
     }
   };
 }
@@ -8146,8 +8757,8 @@ async function startPreviewServer(options) {
   }
   const config = await initializeConfiguration(inputPath);
   const tempDir = await initializePreviewDirectories();
-  await generateAndWriteHtml(inputPath, tempDir, config);
   const state = createServerState(inputPath, tempDir, config, options);
+  await generateAndWriteHtml(inputPath, tempDir, config, state.cssAssets);
   const restartPreview2 = async (newInputPath) => {
     await restartPreview(newInputPath, state);
   };
@@ -8180,7 +8791,10 @@ async function startPreviewServer(options) {
       }
       await shutdownServer(state);
     },
-    restart: restartPreview2
+    restart: restartPreview2,
+    notifySettledWrite: (filePath2, writtenContent) => {
+      state.notifySettledWrite?.(filePath2, writtenContent);
+    }
   };
 }
 // src/lib/diagnostics.ts
@@ -8437,16 +9051,77 @@ async function getSystemDiagnostics() {
     },
     tools: [chromium, ...tools],
     configDir: defaultConfigDir(),
-    docsUrl: "https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/08-system-setup.md"
+    docsUrl: "https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/07-system-setup.md"
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp2, mkdir as mkdir7, readdir as readdir6, readFile as readFile23, stat as stat5, writeFile as writeFile8 } from "node:fs/promises";
-import { constants as FS, existsSync as existsSync12 } from "node:fs";
+import { access, copyFile, cp as cp2, mkdir as mkdir8, readdir as readdir6, readFile as readFile24, stat as stat5, writeFile as writeFile8 } from "node:fs/promises";
+import { constants as FS, existsSync as existsSync13 } from "node:fs";
+import path15 from "node:path";
+
+// src/lib/manifest-doc.ts
+import { existsSync as existsSync12 } from "node:fs";
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { mkdir as mkdir7, open, readFile as readFile23, rename as rename3, rm as rm2 } from "node:fs/promises";
 import path14 from "node:path";
+import { parseDocument, isSeq, YAMLSeq } from "yaml";
+function resolveManifestPath(projectDir) {
+  const existing = MANIFEST_FILENAMES.find((name) => existsSync12(path14.join(projectDir, name)));
+  return path14.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
+}
+async function loadManifestDoc(projectDir) {
+  const file = resolveManifestPath(projectDir);
+  let text = "";
+  try {
+    text = await readFile23(file, "utf8");
+  } catch (error2) {
+    if (error2.code !== "ENOENT")
+      throw error2;
+  }
+  return { doc: parseDocument(text), file };
+}
+async function writeManifestDoc(file, doc) {
+  const dir = path14.dirname(file);
+  await mkdir7(dir, { recursive: true });
+  const temporary = path14.join(dir, `.${path14.basename(file)}.tmp-${process.pid}-${randomUUID2()}`);
+  try {
+    const handle = await open(temporary, "wx", 438);
+    try {
+      await handle.writeFile(doc.toString(), "utf8");
+      await handle.sync();
+    } finally {
+      await handle.close();
+    }
+    await rename3(temporary, file);
+    const directory = await open(dir, "r").catch(() => null);
+    if (directory) {
+      await directory.sync().catch(() => {});
+      await directory.close();
+    }
+  } finally {
+    await rm2(temporary, { force: true });
+  }
+}
+function ensureSeq(doc, key) {
+  let seq = doc.get(key, true);
+  if (!isSeq(seq)) {
+    const fresh = new YAMLSeq(doc.schema);
+    doc.set(key, fresh);
+    seq = fresh;
+  }
+  return seq;
+}
+function scalarString(item) {
+  if (item && typeof item === "object" && "value" in item) {
+    const v = item.value;
+    return typeof v === "string" ? v : null;
+  }
+  return typeof item === "string" ? item : null;
+}
+
+// src/lib/project-scaffold.ts
 var STARTER_THEME_FOR_TEMPLATE = {
   book: "clean-book",
-  ttrpg: "ttrpg-supplement",
   zine: "zine",
   technical: "technical-doc"
 };
@@ -8466,6 +9141,39 @@ function escapeYamlScalar(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
 var DEFAULT_AUTHOR = "Anonymous";
+function isPositivePoints(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function requirePreset(preset, customPage) {
+  if (!preset || !PRESET_IDS.includes(preset)) {
+    const got = preset ? ` (got "${preset}")` : "";
+    throw new CreateProjectErrorImpl("preset-required", `A preset is required to create a book${got}. Choose one of: ${PRESET_IDS.join(", ")}.`);
+  }
+  if (preset === "custom") {
+    const missing = [];
+    if (!customPage || !isPositivePoints(customPage.width))
+      missing.push("page width");
+    if (!customPage || !isPositivePoints(customPage.height))
+      missing.push("page height");
+    if (missing.length > 0) {
+      throw new CreateProjectErrorImpl("custom-page-required", `The custom preset needs a trim size: ${missing.join(" and ")} in points ` + `(72pt = 1in — e.g. US Letter is 612 x 792).`);
+    }
+  } 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) {
+  const ids = requested ?? [...PRESETS[preset].defaultTargets];
+  const unknown = ids.filter((id) => !TARGETS[id]);
+  if (unknown.length > 0) {
+    throw new CreateProjectErrorImpl("invalid-targets", `Unknown publish target${unknown.length > 1 ? "s" : ""} "${unknown.join('", "')}". ` + `Known targets: ${TARGET_IDS.join(", ")}.`);
+  }
+  return [...new Set(ids)];
+}
 async function scaffoldProject(options) {
   const name = (options.name ?? "").trim();
   if (!name) {
@@ -8477,7 +9185,7 @@ async function scaffoldProject(options) {
     throw new CreateProjectErrorImpl("invalid-name", `Could not derive a valid folder name from "${name}".`);
   }
   const parentDir = options.parentDir;
-  if (!parentDir || !path14.isAbsolute(parentDir)) {
+  if (!parentDir || !path15.isAbsolute(parentDir)) {
     throw new CreateProjectErrorImpl("parent-not-writable", "The save location must be an absolute path.");
   }
   try {
@@ -8485,7 +9193,7 @@ async function scaffoldProject(options) {
   } catch {
     throw new CreateProjectErrorImpl("parent-not-writable", `The chosen save location can't be written to: ${parentDir}`);
   }
-  const projectDir = path14.join(parentDir, folderName);
+  const projectDir = path15.join(parentDir, folderName);
   let targetExists = true;
   try {
     await access(projectDir, FS.F_OK);
@@ -8497,26 +9205,28 @@ async function scaffoldProject(options) {
   }
   const template = options.template ?? "book";
   const customTemplateDir = options.templateDir;
+  const preset = customTemplateDir && options.preset === undefined ? undefined : requirePreset(options.preset, options.customPage);
+  const targets = preset ? resolveScaffoldTargets(options.targets, preset) : undefined;
   try {
-    await mkdir7(projectDir, { recursive: true });
+    await mkdir8(projectDir, { recursive: true });
     if (customTemplateDir) {
       const entries = await readdir6(customTemplateDir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.name === ".gutterpress-template.json")
           continue;
-        await cp2(path14.join(customTemplateDir, entry.name), path14.join(projectDir, entry.name), { recursive: true });
+        await cp2(path15.join(customTemplateDir, entry.name), path15.join(projectDir, entry.name), { recursive: true });
       }
-      await mkdir7(path14.join(projectDir, "assets"), { recursive: true });
+      await mkdir8(path15.join(projectDir, "assets"), { recursive: true });
     } else {
       const tplManifest = await getAssetPath(`templates/${template}/manifest.yaml`);
       const tplChapter = await getAssetPath(`templates/${template}/chapter-01.md`);
-      await mkdir7(path14.join(projectDir, "assets"), { recursive: true });
-      await copyFile(tplManifest, path14.join(projectDir, MANIFEST_FILENAMES[0]));
-      await copyFile(tplChapter, path14.join(projectDir, "chapter-01.md"));
+      await mkdir8(path15.join(projectDir, "assets"), { recursive: true });
+      await copyFile(tplManifest, path15.join(projectDir, MANIFEST_FILENAMES[0]));
+      await copyFile(tplChapter, path15.join(projectDir, "chapter-01.md"));
       const starterThemeId = STARTER_THEME_FOR_TEMPLATE[template] ?? "clean-book";
       const starterCss = await getAssetPath(`themes/${starterThemeId}/theme.css`);
-      await mkdir7(path14.join(projectDir, "styles"), { recursive: true });
-      await copyFile(starterCss, path14.join(projectDir, "styles", "book.css"));
+      await mkdir8(path15.join(projectDir, "styles"), { recursive: true });
+      await copyFile(starterCss, path15.join(projectDir, "styles", "book.css"));
     }
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not create the project files: ${e instanceof Error ? e.message : String(e)}`);
@@ -8526,18 +9236,34 @@ async function scaffoldProject(options) {
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not write .gitignore: ${e instanceof Error ? e.message : String(e)}`);
   }
-  const manifestPath = MANIFEST_FILENAMES.map((name2) => path14.join(projectDir, name2)).find(existsSync12) ?? path14.join(projectDir, MANIFEST_FILENAMES[0]);
+  const manifestPath = MANIFEST_FILENAMES.map((name2) => path15.join(projectDir, name2)).find(existsSync13) ?? path15.join(projectDir, MANIFEST_FILENAMES[0]);
   const author = (options.author ?? "").trim() || DEFAULT_AUTHOR;
   const substitutions = {
     "{{TITLE}}": escapeYamlScalar(name),
     "{{AUTHOR}}": escapeYamlScalar(author)
   };
-  let openFile = path14.join(projectDir, "chapter-01.md");
+  let openFile = path15.join(projectDir, "chapter-01.md");
   try {
     await fillTemplateFile(manifestPath, substitutions);
+    if (preset) {
+      const { doc, file } = await loadManifestDoc(projectDir);
+      doc.set("preset", preset);
+      doc.set("targets", doc.createNode(targets ?? []));
+      if (options.customPage) {
+        const page = {
+          width: options.customPage.width,
+          height: options.customPage.height
+        };
+        if (options.customPage.tolerance !== undefined) {
+          page.tolerance = options.customPage.tolerance;
+        }
+        doc.set("page", doc.createNode(page));
+      }
+      await writeManifestDoc(file, doc);
+    }
     const firstSource = await firstSourceFile(manifestPath);
     if (firstSource)
-      openFile = path14.join(projectDir, firstSource);
+      openFile = path15.join(projectDir, firstSource);
     await fillTemplateFile(openFile, { "{{TITLE}}": name }).catch(() => {});
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not finalise the project files: ${e instanceof Error ? e.message : String(e)}`);
@@ -8547,7 +9273,7 @@ async function scaffoldProject(options) {
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-hp96b5jf.js");
+      const { providerFor } = await import("./source-provider-c1rjm2c0.js");
       const provider = providerFor({ type: "local-folder", path: projectDir });
       await provider.initVersionHistory({
         projectDir,
@@ -8557,9 +9283,9 @@ async function scaffoldProject(options) {
       versionHistory = "local-git";
     } catch (e) {
       versionHistory = "none";
-      const { findEnclosingRepoDir } = await import("./project-source-0tg0r6vm.js");
+      const { findEnclosingRepoDir } = await import("./project-source-p0gn1wd5.js");
       const enclosingRepoDir = await findEnclosingRepoDir(projectDir);
-      versionHistoryError = enclosingRepoDir ? `This book was added to ${path14.basename(enclosingRepoDir)}'s shared version history; save a snapshot to record it.` : e instanceof Error ? e.message : String(e);
+      versionHistoryError = enclosingRepoDir ? `This book was added to ${path15.basename(enclosingRepoDir)}'s shared version history; save a snapshot to record it.` : e instanceof Error ? e.message : String(e);
     }
   }
   const result = {
@@ -8579,7 +9305,7 @@ function prettifyFolderName(base) {
 }
 async function adoptFolder(options) {
   const dir = options.dir;
-  if (typeof dir !== "string" || !path14.isAbsolute(dir)) {
+  if (typeof dir !== "string" || !path15.isAbsolute(dir)) {
     throw new CreateProjectErrorImpl("scaffold-io", "An absolute folder path is required.");
   }
   let st;
@@ -8591,11 +9317,11 @@ async function adoptFolder(options) {
   if (!st.isDirectory()) {
     throw new CreateProjectErrorImpl("scaffold-io", `Not a folder: ${dir}`);
   }
-  if (MANIFEST_FILENAMES.some((name) => existsSync12(path14.join(dir, name)))) {
+  if (MANIFEST_FILENAMES.some((name) => existsSync13(path15.join(dir, name)))) {
     throw new CreateProjectErrorImpl("target-exists", "This folder is already a Gutterpress project.");
   }
   const template = options.template ?? "book";
-  const title = (options.title ?? "").trim() || prettifyFolderName(path14.basename(dir));
+  const title = (options.title ?? "").trim() || prettifyFolderName(path15.basename(dir));
   const author = (options.author ?? "").trim() || DEFAULT_AUTHOR;
   let mdFiles;
   try {
@@ -8603,14 +9329,14 @@ async function adoptFolder(options) {
     mdFiles = entries.filter((e) => e.isFile() && /\.(md|markdown)$/i.test(e.name)).map((e) => e.name).sort((a, b) => a.localeCompare(b));
     if (mdFiles.length === 0) {
       const tplChapter = await getAssetPath(`templates/${template}/chapter-01.md`);
-      await copyFile(tplChapter, path14.join(dir, "chapter-01.md"));
-      await fillTemplateFile(path14.join(dir, "chapter-01.md"), { "{{TITLE}}": title }).catch(() => {});
+      await copyFile(tplChapter, path15.join(dir, "chapter-01.md"));
+      await fillTemplateFile(path15.join(dir, "chapter-01.md"), { "{{TITLE}}": title }).catch(() => {});
       mdFiles = ["chapter-01.md"];
     }
     const themeId = STARTER_THEME_FOR_TEMPLATE[template] ?? "clean-book";
-    await mkdir7(path14.join(dir, "styles"), { recursive: true });
-    const bookCssPath = path14.join(dir, "styles", "book.css");
-    if (!existsSync12(bookCssPath)) {
+    await mkdir8(path15.join(dir, "styles"), { recursive: true });
+    const bookCssPath = path15.join(dir, "styles", "book.css");
+    if (!existsSync13(bookCssPath)) {
       await copyFile(await getAssetPath(`themes/${themeId}/theme.css`), bookCssPath);
     }
     const filesYaml = mdFiles.map((f) => `    - "${escapeYamlScalar(f)}"`).join(`
@@ -8618,14 +9344,17 @@ async function adoptFolder(options) {
     const manifest = `title: "${escapeYamlScalar(title)}"
 authors:
   - "${escapeYamlScalar(author)}"
+preset: dtrpg
+targets:
+  - dtrpg
 source:
   files:
 ${filesYaml}
 styles:
   - styles/book.css
 `;
-    await writeFile8(path14.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
-    await mkdir7(path14.join(dir, "assets"), { recursive: true });
+    await writeFile8(path15.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
+    await mkdir8(path15.join(dir, "assets"), { recursive: true });
     await ensureGitignoreHasDist(dir);
   } catch (e) {
     if (e instanceof CreateProjectErrorImpl)
@@ -8637,7 +9366,7 @@ styles:
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-hp96b5jf.js");
+      const { providerFor } = await import("./source-provider-c1rjm2c0.js");
       const provider = providerFor({ type: "local-folder", path: dir });
       await provider.initVersionHistory({
         projectDir: dir,
@@ -8652,8 +9381,8 @@ styles:
   }
   const result = {
     projectDir: dir,
-    manifestPath: path14.join(dir, MANIFEST_FILENAMES[0]),
-    openFile: path14.join(dir, mdFiles[0]),
+    manifestPath: path15.join(dir, MANIFEST_FILENAMES[0]),
+    openFile: path15.join(dir, mdFiles[0]),
     versionHistory
   };
   if (versionHistoryError !== undefined)
@@ -8661,10 +9390,10 @@ styles:
   return result;
 }
 async function ensureGitignoreHasDist(projectDir) {
-  const gitignorePath = path14.join(projectDir, ".gitignore");
+  const gitignorePath = path15.join(projectDir, ".gitignore");
   let existing = null;
   try {
-    existing = await readFile23(gitignorePath, "utf8");
+    existing = await readFile24(gitignorePath, "utf8");
   } catch {}
   if (existing === null) {
     await writeFile8(gitignorePath, `dist/
@@ -8684,7 +9413,7 @@ async function ensureGitignoreHasDist(projectDir) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile23(manifestPath, "utf8");
+    text = await readFile24(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -8696,32 +9425,45 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath2, substitutions) {
-  let text = await readFile23(filePath2, "utf8");
+  let text = await readFile24(filePath2, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
   await writeFile8(filePath2, text, "utf8");
 }
 // src/lib/project-templates.ts
-import { cp as cp3, mkdir as mkdir8, readFile as readFile24, readdir as readdir7, stat as stat6, writeFile as writeFile9 } from "node:fs/promises";
-import { constants as FS2 } from "node:fs";
+import { cp as cp3, mkdir as mkdir9, readFile as readFile25, readdir as readdir7, stat as stat6, writeFile as writeFile9 } from "node:fs/promises";
+import { constants as FS2, existsSync as existsSync14 } from "node:fs";
 import { access as access2 } from "node:fs/promises";
-import path15 from "node:path";
+import path16 from "node:path";
+import { isMap, isScalar, isSeq as isSeq2, parseDocument as parseDocument2 } from "yaml";
 var BUILT_IN_TEMPLATE_IDS = [
   "book",
-  "ttrpg",
   "zine",
   "technical"
 ];
+async function readTemplateChoices(manifestPath) {
+  try {
+    const text = await readFile25(manifestPath, "utf8");
+    const doc = parseDocument2(text);
+    const out = {};
+    const preset = doc.get("preset");
+    if (typeof preset === "string" && preset)
+      out.preset = preset;
+    const targets = doc.get("targets", true);
+    if (isSeq2(targets)) {
+      out.targets = targets.items.map((i) => scalarString(i)).filter((s) => s !== null);
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
 var BUILT_IN_META = {
   book: {
     label: "Book",
     description: "A clean starting point for a novel, memoir, or any long-form book."
   },
-  ttrpg: {
-    label: "TTRPG supplement",
-    description: "Rules, stat blocks, and tables for a tabletop roleplaying supplement."
-  },
   zine: {
     label: "Zine",
     description: "A short, personal zine made to be printed, folded, and shared."
@@ -8732,12 +9474,13 @@ var BUILT_IN_META = {
   }
 };
 async function listBuiltInTemplates() {
-  return BUILT_IN_TEMPLATE_IDS.map((id) => ({
+  return Promise.all(BUILT_IN_TEMPLATE_IDS.map(async (id) => ({
     id,
     label: BUILT_IN_META[id].label,
     description: BUILT_IN_META[id].description,
-    kind: "builtin"
-  }));
+    kind: "builtin",
+    ...await readTemplateChoices(await getAssetPath(`templates/${id}/manifest.yaml`))
+  })));
 }
 var SKIP_ENTRIES = new Set([
   ".git",
@@ -8748,13 +9491,100 @@ var SKIP_ENTRIES = new Set([
   ".gutterpress",
   ".DS_Store"
 ]);
+var VENDOR_DIR = "shared";
+function collectEscaping(nodes, getValue, escapes) {
+  const out = [];
+  for (const node of nodes) {
+    const value = getValue(node);
+    if (value !== null && escapes(value))
+      out.push({ node, value });
+  }
+  return out;
+}
+function pluginEntryPath(node) {
+  return isMap(node) ? scalarString(node.get("path", true)) : scalarString(node);
+}
+function dropEscaping(doc, seq, key, escaping) {
+  if (!isSeq2(seq))
+    return;
+  const drop = new Set(escaping.map((e) => e.node));
+  seq.items = seq.items.filter((node) => !drop.has(node));
+  if (seq.items.length === 0)
+    doc.delete(key);
+}
+function rewriteEntry(node, newPath) {
+  if (isMap(node))
+    node.set("path", newPath);
+  else if (isScalar(node))
+    node.value = newPath;
+}
+function commonAncestorDir(absFiles) {
+  const dirSegs = absFiles.map((f) => path16.resolve(f).split(path16.sep).slice(0, -1));
+  if (dirSegs.length === 0)
+    return "";
+  let common = dirSegs[0];
+  for (const segs of dirSegs.slice(1)) {
+    let i = 0;
+    while (i < common.length && i < segs.length && common[i] === segs[i])
+      i++;
+    common = common.slice(0, i);
+  }
+  return common.join(path16.sep) || path16.sep;
+}
+function pickVendorDir(templateDir, base) {
+  const preferred = path16.basename(base) || VENDOR_DIR;
+  if (!existsSync14(path16.join(templateDir, preferred)))
+    return preferred;
+  for (let n = 1;; n++) {
+    const candidate = `${preferred}-${n}`;
+    if (!existsSync14(path16.join(templateDir, candidate)))
+      return candidate;
+  }
+}
 var TEMPLATE_META_FILE = ".gutterpress-template.json";
+async function reconcileSharedRefs(templateDir, sourceProjectDir, mode) {
+  const { doc, file } = await loadManifestDoc(templateDir);
+  const escapes = (p) => escapesProjectRoot(sourceProjectDir, path16.resolve(sourceProjectDir, p));
+  const stylesSeq = doc.get("styles", true);
+  const pluginsSeq = doc.get("plugins", true);
+  const escapingStyles = collectEscaping(isSeq2(stylesSeq) ? stylesSeq.items : [], scalarString, escapes);
+  const escapingPlugins = collectEscaping(isSeq2(pluginsSeq) ? pluginsSeq.items : [], pluginEntryPath, escapes);
+  if (escapingStyles.length === 0 && escapingPlugins.length === 0) {
+    return { vendoredRefs: [], excludedRefs: [] };
+  }
+  if (mode === "exclude") {
+    const excludedRefs = [...escapingStyles, ...escapingPlugins].map((e) => e.value);
+    dropEscaping(doc, stylesSeq, "styles", escapingStyles);
+    dropEscaping(doc, pluginsSeq, "plugins", escapingPlugins);
+    await writeManifestDoc(file, doc);
+    return { vendoredRefs: [], excludedRefs };
+  }
+  const styleClosure = await collectStyleDependencies(sourceProjectDir, escapingStyles.map((s) => s.value));
+  const pluginFiles = escapingPlugins.map((p) => path16.resolve(sourceProjectDir, p.value));
+  const externalFiles = [...new Set([...styleClosure, ...pluginFiles])].filter((f) => escapesProjectRoot(sourceProjectDir, f));
+  const base = commonAncestorDir(externalFiles);
+  const vendorDir = pickVendorDir(templateDir, base);
+  await Promise.all(externalFiles.filter((abs2) => existsSync14(abs2)).map(async (abs2) => {
+    const dest = path16.join(templateDir, vendorDir, path16.relative(base, abs2));
+    await mkdir9(path16.dirname(dest), { recursive: true });
+    await cp3(abs2, dest);
+  }));
+  const bookLocal = (value) => toPosixPath(path16.join(vendorDir, path16.relative(base, path16.resolve(sourceProjectDir, value))));
+  const vendoredRefs = [];
+  for (const { node, value } of [...escapingStyles, ...escapingPlugins]) {
+    const rewritten = bookLocal(value);
+    rewriteEntry(node, rewritten);
+    vendoredRefs.push(rewritten);
+  }
+  await writeManifestDoc(file, doc);
+  return { vendoredRefs, excludedRefs: [] };
+}
 async function saveProjectAsTemplate(options) {
   const { projectDir, name, templatesRoot } = options;
   const id = slugify(name);
   if (!id)
     throw new Error(`Could not derive a template id from "${name}".`);
-  const dir = path15.join(templatesRoot, id);
+  const dir = path16.join(templatesRoot, id);
   let exists = true;
   try {
     await access2(dir, FS2.F_OK);
@@ -8764,31 +9594,33 @@ async function saveProjectAsTemplate(options) {
   if (exists) {
     throw new Error(`A template named "${name}" already exists. Choose a different name.`);
   }
-  await mkdir8(dir, { recursive: true });
+  await mkdir9(dir, { recursive: true });
   const entries = await readdir7(projectDir, { withFileTypes: true });
   for (const entry of entries) {
     if (SKIP_ENTRIES.has(entry.name))
       continue;
     if (entry.name === TEMPLATE_META_FILE)
       continue;
-    await cp3(path15.join(projectDir, entry.name), path15.join(dir, entry.name), { recursive: true });
+    await cp3(path16.join(projectDir, entry.name), path16.join(dir, entry.name), { recursive: true });
   }
   const manifestName = MANIFEST_FILENAMES.find((name2) => entries.some((entry) => entry.name === name2));
+  const shared = manifestName ? await reconcileSharedRefs(dir, projectDir, options.sharedRefs ?? "vendor") : { vendoredRefs: [], excludedRefs: [] };
   if (manifestName)
-    await retokeniseManifest(path15.join(dir, manifestName));
-  await writeFile9(path15.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
+    await retokeniseManifest(path16.join(dir, manifestName));
+  await writeFile9(path16.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
   return {
     id,
     label: name,
     description: "Your saved template.",
     kind: "custom",
-    dir
+    dir,
+    ...shared
   };
 }
 async function retokeniseManifest(manifestPath) {
   let text;
   try {
-    text = await readFile24(manifestPath, "utf8");
+    text = await readFile25(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -8806,14 +9638,21 @@ async function listCustomTemplates(templatesRoot) {
   for (const entry of entries) {
     if (!entry.isDirectory())
       continue;
-    const dir = path15.join(templatesRoot, entry.name);
+    const dir = path16.join(templatesRoot, entry.name);
     let label = prettify(entry.name);
     try {
-      const meta = JSON.parse(await readFile24(path15.join(dir, TEMPLATE_META_FILE), "utf8"));
+      const meta = JSON.parse(await readFile25(path16.join(dir, TEMPLATE_META_FILE), "utf8"));
       if (typeof meta.label === "string" && meta.label)
         label = meta.label;
     } catch {}
-    out.push({ id: entry.name, label, description: "Your saved template.", kind: "custom", dir });
+    out.push({
+      id: entry.name,
+      label,
+      description: "Your saved template.",
+      kind: "custom",
+      dir,
+      ...await readTemplateChoices(path16.join(dir, MANIFEST_FILENAMES[0]))
+    });
   }
   out.sort((a, b) => a.label.localeCompare(b.label));
   return out;
@@ -8824,12 +9663,12 @@ async function importTemplateFromFolder(options) {
   if (!srcStat.isDirectory()) {
     throw new Error("The chosen path is not a folder.");
   }
-  const name = options.name?.trim() || prettify(path15.basename(sourceDir));
+  const name = options.name?.trim() || prettify(path16.basename(sourceDir));
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir8, readFile as readFile25, writeFile as writeFile10, mkdir as mkdir9, rm as rm2 } from "node:fs/promises";
-import path16 from "node:path";
+import { readdir as readdir8, readFile as readFile26, writeFile as writeFile10, mkdir as mkdir10, rm as rm3 } from "node:fs/promises";
+import path17 from "node:path";
 var SNIPPETS_DIR = "snippets";
 var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
 function extractVariables(template) {
@@ -8848,15 +9687,15 @@ function substituteVariables(template, values) {
   return template.replace(PLACEHOLDER_RE, (_full, name) => Object.prototype.hasOwnProperty.call(values, name) ? values[name] : "");
 }
 function resolveSnippetPath(projectDir, fileName) {
-  const dir = path16.resolve(projectDir, SNIPPETS_DIR);
-  const full = path16.resolve(dir, fileName);
-  if (full !== path16.join(dir, path16.basename(fileName)) || path16.dirname(full) !== dir) {
+  const dir = path17.resolve(projectDir, SNIPPETS_DIR);
+  const full = path17.resolve(dir, fileName);
+  if (full !== path17.join(dir, path17.basename(fileName)) || path17.dirname(full) !== dir) {
     throw new Error(`Unsafe snippet filename: ${fileName}`);
   }
   return full;
 }
 async function listSnippets(projectDir) {
-  const dir = path16.join(projectDir, SNIPPETS_DIR);
+  const dir = path17.join(projectDir, SNIPPETS_DIR);
   let names;
   try {
     names = await readdir8(dir);
@@ -8869,7 +9708,7 @@ async function listSnippets(projectDir) {
       continue;
     let body = "";
     try {
-      body = await readFile25(path16.join(dir, fileName), "utf8");
+      body = await readFile26(path17.join(dir, fileName), "utf8");
     } catch {
       continue;
     }
@@ -8883,89 +9722,29 @@ async function listSnippets(projectDir) {
   return entries;
 }
 async function readSnippet(projectDir, fileName) {
-  return readFile25(resolveSnippetPath(projectDir, fileName), "utf8");
+  return readFile26(resolveSnippetPath(projectDir, fileName), "utf8");
 }
 async function saveSnippet(projectDir, name, body) {
   const stem = slugify(name);
   if (!stem)
     throw new Error(`Could not derive a filename from "${name}".`);
   const fileName = `${stem}.md`;
-  const dir = path16.join(projectDir, SNIPPETS_DIR);
-  await mkdir9(dir, { recursive: true });
+  const dir = path17.join(projectDir, SNIPPETS_DIR);
+  await mkdir10(dir, { recursive: true });
   await writeFile10(resolveSnippetPath(projectDir, fileName), body, "utf8");
   return { name, fileName, variables: extractVariables(body) };
 }
 async function deleteSnippet(projectDir, fileName) {
-  await rm2(resolveSnippetPath(projectDir, fileName), { force: true });
+  await rm3(resolveSnippetPath(projectDir, fileName), { force: true });
 }
 // src/lib/plugin-manager.ts
-import { randomUUID as randomUUID3 } from "node:crypto";
+import { randomUUID as randomUUID4 } from "node:crypto";
 import { cp as cp4, lstat as lstat3, mkdir as mkdir12, rename as rename5, rm as rm5, stat as stat7 } from "node:fs/promises";
 import path19 from "node:path";
-import { isSeq as isSeq2, isMap, isScalar, YAMLMap, Scalar } from "yaml";
-
-// src/lib/manifest-doc.ts
-import { existsSync as existsSync13 } from "node:fs";
-import { randomUUID } from "node:crypto";
-import { mkdir as mkdir10, open, readFile as readFile26, rename as rename3, rm as rm3 } from "node:fs/promises";
-import path17 from "node:path";
-import { parseDocument, isSeq, YAMLSeq } from "yaml";
-function resolveManifestPath(projectDir) {
-  const existing = MANIFEST_FILENAMES.find((name) => existsSync13(path17.join(projectDir, name)));
-  return path17.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
-}
-async function loadManifestDoc(projectDir) {
-  const file = resolveManifestPath(projectDir);
-  let text = "";
-  try {
-    text = await readFile26(file, "utf8");
-  } catch (error2) {
-    if (error2.code !== "ENOENT")
-      throw error2;
-  }
-  return { doc: parseDocument(text), file };
-}
-async function writeManifestDoc(file, doc) {
-  const dir = path17.dirname(file);
-  await mkdir10(dir, { recursive: true });
-  const temporary = path17.join(dir, `.${path17.basename(file)}.tmp-${process.pid}-${randomUUID()}`);
-  try {
-    const handle = await open(temporary, "wx", 438);
-    try {
-      await handle.writeFile(doc.toString(), "utf8");
-      await handle.sync();
-    } finally {
-      await handle.close();
-    }
-    await rename3(temporary, file);
-    const directory = await open(dir, "r").catch(() => null);
-    if (directory) {
-      await directory.sync().catch(() => {});
-      await directory.close();
-    }
-  } finally {
-    await rm3(temporary, { force: true });
-  }
-}
-function ensureSeq(doc, key) {
-  let seq = doc.get(key, true);
-  if (!isSeq(seq)) {
-    const fresh = new YAMLSeq(doc.schema);
-    doc.set(key, fresh);
-    seq = fresh;
-  }
-  return seq;
-}
-function scalarString(item) {
-  if (item && typeof item === "object" && "value" in item) {
-    const v = item.value;
-    return typeof v === "string" ? v : null;
-  }
-  return typeof item === "string" ? item : null;
-}
+import { isSeq as isSeq3, isMap as isMap2, isScalar as isScalar2, YAMLMap, Scalar } from "yaml";
 
 // src/lib/npm-plugin-installer.ts
-import { createHash as createHash4, randomUUID as randomUUID2, timingSafeEqual } from "node:crypto";
+import { createHash as createHash4, randomUUID as randomUUID3, timingSafeEqual } from "node:crypto";
 import { createReadStream as createReadStream2 } from "node:fs";
 import {
   lstat as lstat2,
@@ -9641,7 +10420,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
     }
     try {
       await lstat2(finalRoot);
-      backupRoot = `${finalRoot}.backup-${randomUUID2()}`;
+      backupRoot = `${finalRoot}.backup-${randomUUID3()}`;
       await rename4(finalRoot, backupRoot);
     } catch (error2) {
       if (error2.code !== "ENOENT")
@@ -9730,9 +10509,9 @@ function isLocalRef2(ref) {
   return ref.startsWith("./") || ref.startsWith("../") || ref.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(ref) || /\.(m?js|cjs|ts)$/i.test(ref) || !ref.startsWith("@") && ref.includes("/");
 }
 function itemRef(item) {
-  if (isScalar(item))
+  if (isScalar2(item))
     return typeof item.value === "string" ? item.value : null;
-  if (isMap(item)) {
+  if (isMap2(item)) {
     const p = item.get("path");
     const n = item.get("name");
     if (typeof p === "string")
@@ -9748,7 +10527,7 @@ function refKind(ref) {
 async function listProjectPlugins(projectDir) {
   const { doc } = await loadManifestDoc(projectDir);
   const seq = doc.get("plugins", true);
-  if (!isSeq2(seq))
+  if (!isSeq3(seq))
     return [];
   const out = [];
   for (const item of seq.items) {
@@ -9759,7 +10538,7 @@ async function listProjectPlugins(projectDir) {
     let kind;
     let version;
     let exportName;
-    if (isMap(item)) {
+    if (isMap2(item)) {
       const e = item.get("enabled");
       if (e === false)
         enabled = false;
@@ -9797,7 +10576,7 @@ async function setPluginEnabled(projectDir, ref, enabled) {
 async function setPluginEnabledUnlocked(projectDir, ref, enabled) {
   const { doc, file } = await loadManifestDoc(projectDir);
   const seq = doc.get("plugins", true);
-  if (!isSeq2(seq)) {
+  if (!isSeq3(seq)) {
     throw new Error(`No plugins are configured in ${path19.basename(file)}.`);
   }
   const idx = indexOfRef(seq, ref);
@@ -9806,7 +10585,7 @@ async function setPluginEnabledUnlocked(projectDir, ref, enabled) {
   }
   const item = seq.items[idx];
   let map;
-  if (isMap(item)) {
+  if (isMap2(item)) {
     map = item;
   } else {
     map = new YAMLMap(doc.schema);
@@ -9834,7 +10613,7 @@ async function recordInstalledNpmPlugin(projectDir, name, version, exportName) {
   const seq = ensureSeq(doc, "plugins");
   const idx = indexOfRef(seq, name);
   let map;
-  if (idx >= 0 && isMap(seq.items[idx])) {
+  if (idx >= 0 && isMap2(seq.items[idx])) {
     map = seq.items[idx];
   } else {
     map = new YAMLMap(doc.schema);
@@ -9920,8 +10699,8 @@ async function addLocalPluginUnlocked(projectDir, sourcePath) {
   const destDir = path19.join(projectDir, PLUGINS_DIR);
   await mkdir12(destDir, { recursive: true });
   const dest = path19.join(destDir, base);
-  const staging = path19.join(destDir, `.import-${randomUUID3()}`);
-  const backup = path19.join(destDir, `.backup-${randomUUID3()}`);
+  const staging = path19.join(destDir, `.import-${randomUUID4()}`);
+  const backup = path19.join(destDir, `.backup-${randomUUID4()}`);
   let hasBackup = false;
   try {
     if (info2.isDirectory()) {
@@ -9997,13 +10776,12 @@ async function validateProjectPlugins(projectDir) {
 }
 // src/lib/theme-manager.ts
 import { cp as cp5, mkdir as mkdir13, readFile as readFile28, readdir as readdir9, stat as stat8, writeFile as writeFile11, rm as rm6 } from "node:fs/promises";
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 import path20 from "node:path";
-import { isSeq as isSeq3, Scalar as Scalar2 } from "yaml";
+import { isSeq as isSeq4, Scalar as Scalar2 } from "yaml";
 var THEMES_DIR = "themes";
 var BUILT_IN_THEME_IDS = [
   "clean-book",
-  "ttrpg-supplement",
   "zine",
   "technical-doc"
 ];
@@ -10012,10 +10790,6 @@ var BUILT_IN_FALLBACK_META = {
     name: "Clean Book",
     description: "A calm, classic book look: serif body, generous margins."
   },
-  "ttrpg-supplement": {
-    name: "TTRPG Supplement",
-    description: "Bold display headings, parchment fills, boxed stat blocks."
-  },
   zine: {
     name: "Zine",
     description: "High-contrast, punchy sans-serif for short printed zines."
@@ -10077,7 +10851,7 @@ async function resolveBuiltInTheme(id) {
   }
   const cssPath = await getAssetPath(`${THEMES_DIR}/${id}/theme.css`);
   const jsonPath = await getAssetPath(`${THEMES_DIR}/${id}/theme.json`);
-  if (!existsSync14(cssPath)) {
+  if (!existsSync15(cssPath)) {
     throw new Error(`Built-in theme "${id}" is missing its theme.css.`);
   }
   const meta = await readThemeMeta(jsonPath);
@@ -10101,7 +10875,7 @@ async function listProjectThemes(projectDir) {
     if (!entry.isDirectory())
       continue;
     const dir = path20.join(root, entry.name);
-    if (!existsSync14(path20.join(dir, "theme.css")))
+    if (!existsSync15(path20.join(dir, "theme.css")))
       continue;
     const meta = await readThemeMeta(path20.join(dir, "theme.json"));
     out.push(themeInfo(entry.name, "project", meta));
@@ -10126,7 +10900,7 @@ function activeThemeIdInSeq(seq) {
 async function getActiveTheme(projectDir) {
   const { doc } = await loadManifestDoc(projectDir);
   const seq = doc.get("styles", true);
-  if (!isSeq3(seq))
+  if (!isSeq4(seq))
     return null;
   for (const item of seq.items) {
     const href = scalarString(item);
@@ -10137,7 +10911,7 @@ async function getActiveTheme(projectDir) {
       continue;
     const id = m[1];
     const dir = path20.join(projectDir, THEMES_DIR, id);
-    if (!existsSync14(path20.join(dir, "theme.css")))
+    if (!existsSync15(path20.join(dir, "theme.css")))
       continue;
     const meta = await readThemeMeta(path20.join(dir, "theme.json"));
     return themeInfo(id, "project", meta);
@@ -10174,7 +10948,7 @@ async function getPreviousTheme(projectDir) {
   if (!id)
     return null;
   const dir = themeDirFor(projectDir, id);
-  if (!existsSync14(path20.join(dir, "theme.css")))
+  if (!existsSync15(path20.join(dir, "theme.css")))
     return null;
   const active = await getActiveTheme(projectDir);
   if (active && active.id === id)
@@ -10194,7 +10968,7 @@ async function applyTheme(projectDir, target) {
   if (target.kind === "builtin") {
     const resolved = await resolveBuiltInTheme(target.id);
     let destId = target.id;
-    if (existsSync14(path20.join(projectDir, THEMES_DIR, destId, "theme.css"))) {
+    if (existsSync15(path20.join(projectDir, THEMES_DIR, destId, "theme.css"))) {
       destId = await uniqueThemeId(projectDir, target.id);
     }
     const destDir = path20.join(projectDir, THEMES_DIR, destId);
@@ -10203,7 +10977,7 @@ async function applyTheme(projectDir, target) {
     info2 = themeInfo(destId, "project", await readThemeMeta(path20.join(destDir, "theme.json")));
   } else {
     const dir = themeDirFor(projectDir, target.id);
-    if (!existsSync14(path20.join(dir, "theme.css"))) {
+    if (!existsSync15(path20.join(dir, "theme.css"))) {
       throw new Error(`Theme "${target.id}" is not present in this project.`);
     }
     info2 = themeInfo(target.id, "project", await readThemeMeta(path20.join(dir, "theme.json")));
@@ -10215,7 +10989,7 @@ async function uniqueThemeId(projectDir, base) {
   const root = path20.join(projectDir, THEMES_DIR);
   let id = themeSlug(base);
   let n = 2;
-  while (existsSync14(path20.join(root, id))) {
+  while (existsSync15(path20.join(root, id))) {
     id = `${themeSlug(base)}-${n++}`;
   }
   return id;
@@ -10230,7 +11004,7 @@ async function importThemeFromFolder(projectDir, sourceDir) {
   if (!info2.isDirectory()) {
     throw new Error("The chosen path is not a folder.");
   }
-  if (!existsSync14(path20.join(sourceDir, "theme.css"))) {
+  if (!existsSync15(path20.join(sourceDir, "theme.css"))) {
     throw new Error("A theme folder must contain a theme.css file.");
   }
   const meta = await readThemeMeta(path20.join(sourceDir, "theme.json"));
@@ -10323,20 +11097,20 @@ async function readThemeCss(projectDir, source) {
   if (!projectDir)
     throw new Error("A project is required to read a project theme.");
   const cssPath = path20.join(themeDirFor(projectDir, source.id), "theme.css");
-  if (!existsSync14(cssPath)) {
+  if (!existsSync15(cssPath)) {
     throw new Error(`Theme "${source.id}" has no theme.css in this project.`);
   }
   return readFile28(cssPath, "utf8");
 }
 async function removeProjectTheme(projectDir, id) {
   const dir = themeDirFor(projectDir, id);
-  if (existsSync14(dir)) {
+  if (existsSync15(dir)) {
     await rm6(dir, { recursive: true, force: true });
   }
   const { doc, file } = await loadManifestDoc(projectDir);
   let changed = false;
   const seq = doc.get("styles", true);
-  if (isSeq3(seq)) {
+  if (isSeq4(seq)) {
     const href = themeStyleHref(id);
     const before = seq.items.length;
     seq.items = seq.items.filter((item) => scalarString(item) !== href);
@@ -10352,7 +11126,7 @@ async function removeProjectTheme(projectDir, id) {
   }
 }
 // src/lib/theme-import.ts
-import { existsSync as existsSync15 } from "node:fs";
+import { existsSync as existsSync16 } from "node:fs";
 import { mkdir as mkdir14, mkdtemp as mkdtemp4, readFile as readFile29, rm as rm7, writeFile as writeFile12 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
 import path21 from "node:path";
@@ -10427,7 +11201,7 @@ async function readThemeJson(p) {
 }
 async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
   const cssPath = path21.join(sourceDir, "theme.css");
-  if (!existsSync15(cssPath)) {
+  if (!existsSync16(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
   const css = await readFile29(cssPath, "utf8");
@@ -10440,7 +11214,7 @@ async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
     warnings.push({ code: "print-safety", message: w.message });
   }
   const jsonPath = path21.join(sourceDir, "theme.json");
-  if (!existsSync15(jsonPath)) {
+  if (!existsSync16(jsonPath)) {
     warnings.push({
       code: "no-theme-json",
       message: "No theme.json found — the theme's name was taken from the file/folder name."
@@ -10564,7 +11338,7 @@ async function importThemeFromFile(projectDir, filePath2) {
   throw new Error("Choose a .zip theme package or a .css stylesheet.");
 }
 // src/lib/manifest-config.ts
-import { isSeq as isSeq4, isMap as isMap2, YAMLSeq as YAMLSeq3, Scalar as Scalar3 } from "yaml";
+import { isSeq as isSeq5, isMap as isMap3, YAMLSeq as YAMLSeq3, Scalar as Scalar3 } from "yaml";
 function hasKey(obj, key) {
   return Object.prototype.hasOwnProperty.call(obj, key);
 }
@@ -10585,12 +11359,24 @@ async function setManifestFields(projectDir, updates) {
       doc.set("authors", a);
     }
   }
+  if (hasKey(updates, "targets")) {
+    const t = updates.targets;
+    if (t === undefined) {
+      doc.delete("targets");
+    } else {
+      const unknown = t.filter((id) => !TARGETS[id]);
+      if (unknown.length > 0) {
+        throw new UsageError(`Unknown publish target${unknown.length > 1 ? "s" : ""} "${unknown.join('", "')}". ` + `Known targets: ${TARGET_IDS.join(", ")}.`);
+      }
+      doc.set("targets", [...new Set(t)]);
+    }
+  }
   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 (isMap2(source) && source.items.length === 0) {
+      if (isMap3(source) && source.items.length === 0) {
         doc.delete("source");
       }
     } else {
@@ -10608,15 +11394,19 @@ async function readManifestFields(projectDir) {
     if (typeof title === "string")
       out.title = title;
     const authors = doc.get("authors", true);
-    if (isSeq4(authors)) {
+    if (isSeq5(authors)) {
       out.authors = authors.items.map((i) => scalarString(i) ?? "");
     }
+    const targetsNode = doc.get("targets", true);
+    if (isSeq5(targetsNode)) {
+      out.targets = targetsNode.items.map((i) => scalarString(i)).filter((s) => s !== null);
+    }
     const filesNode = doc.getIn(["source", "files"], true);
-    if (isSeq4(filesNode)) {
+    if (isSeq5(filesNode)) {
       out.sourceFiles = filesNode.items.map((i) => scalarString(i) ?? "");
     } else {
       const sourceNode = doc.get("source", true);
-      if (isMap2(sourceNode) && sourceNode.has("files"))
+      if (isMap3(sourceNode) && sourceNode.has("files"))
         out.sourceFiles = null;
     }
     return out;
@@ -12643,12 +13433,12 @@ async function buildResolutionPlan(resolutions, localTip, remoteId, deps) {
 
 // src/lib/remote-auth/conflict-resolution.ts
 function onlineCopyPath(filepath, counter) {
-  const dirname5 = path27.posix.dirname(filepath);
+  const dirname6 = path27.posix.dirname(filepath);
   const ext = path27.posix.extname(filepath);
   const stem = path27.posix.basename(filepath, ext);
   const label = counter && counter >= 2 ? `online copy ${counter}` : "online copy";
   const renamed = `${stem} (${label})${ext}`;
-  return dirname5 === "." ? renamed : `${dirname5}/${renamed}`;
+  return dirname6 === "." ? renamed : `${dirname6}/${renamed}`;
 }
 async function uniqueOnlineCopyPath(dir, filepath, oids, cache2) {
   const taken = async (candidate2) => {
@@ -13384,8 +14174,8 @@ var drivethrurpgProvider = {
     }
     issues.push({
       severity: "info",
-      id: "drivethrurpg/validate-profile",
-      message: "Tip: run `gutterpress validate --profile dtrpg` for DriveThruRPG's print-compliance checks before uploading."
+      id: "drivethrurpg/validate-target",
+      message: "Tip: run `gutterpress validate --target dtrpg` for DriveThruRPG's print-compliance checks before uploading."
     });
     return issues;
   },
@@ -13499,7 +14289,7 @@ var info4 = {
   label: "itch.io",
   kind: "api",
   format: "pdf",
-  description: "Upload the PDF to your itch.io project page (games, TTRPG supplements, zines).",
+  description: "Upload the PDF to your itch.io project page (games, zines, and other printable projects).",
   configFields: [
     { key: "target", label: "Project (user/game)", placeholder: "you/your-book" },
     { key: "channel", label: "Channel", placeholder: "pdf" }
@@ -14177,10 +14967,10 @@ function normalizeProjectKey(projectDir) {
   return projectDir.replace(/[\\/]+$/, "");
 }
 // src/lib/publish/manifest-publish.ts
-import { isMap as isMap3 } from "yaml";
+import { isMap as isMap4 } from "yaml";
 function settingsFromDoc(doc) {
   const node = doc.get("publish", true);
-  if (!isMap3(node))
+  if (!isMap4(node))
     return {};
   const json = node.toJSON();
   const out = {};
@@ -14205,11 +14995,11 @@ async function setPublishProviderConfig(projectDir, providerId, values) {
     }
   }
   const section = doc.getIn(["publish", providerId], true);
-  if (isMap3(section) && section.items.length === 0) {
+  if (isMap4(section) && section.items.length === 0) {
     doc.deleteIn(["publish", providerId]);
   }
   const publish = doc.get("publish", true);
-  if (isMap3(publish) && publish.items.length === 0) {
+  if (isMap4(publish) && publish.items.length === 0) {
     doc.delete("publish");
   }
   await writeManifestDoc(file, doc);
@@ -15215,4 +16005,4 @@ async function dispatchToHandler(kind, ctx, error2) {
   }
   return result;
 }
-export { BuildError, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, log, resolveActiveStyles, listProjectStyles, PLUGINS_DIR, ruleRemoteUrls, ruleRiskyProps, rulePagedjsCrashSelectors, ruleSyntax, checkCss, runLint, formatReport, getChecks, getCheckById, resolveCheckSelectors, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, redactCredential, defaultConfigDir, FileTokenStore, extractUrlCredential, migrateUrlCredential, getSystemDiagnostics, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, RECOMMENDED_PLUGINS, listProjectPlugins, setPluginEnabled, addNpmPlugin, addLocalPlugin, validateProjectPlugins, THEMES_DIR, BUILT_IN_THEME_IDS, listBuiltInThemes, resolveBuiltInTheme, listProjectThemes, getActiveTheme, getPreviousTheme, revertTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, readThemeCss, removeProjectTheme, importThemeFromFile, setManifestFields, readManifestFields, setActiveStyles, APP_HEARTBEAT_FRESH_MS, heartbeatTtlMs, appHeartbeatPath, writeAppHeartbeat, removeAppHeartbeat, readAppHeartbeat, isAppHeartbeatFresh, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, listGitHubRepositories, listRepoBooks, listGitHubBranches, RepoNeedsRecoveryError, isRepoNeedsRecoveryError, classifyFromHealth, classifyGitError, SYNC_SNAPSHOT_MESSAGE, provenancePath, readProjectProvenance, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, normalizeForgeHost, knownForgeTokenUrl, connectGenericHost, GenericTokenAuthProvider, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, inspectRepo, verifyRepoReadable, isUnbornRepo, preflightStructuralReason, buildPreflightDiagnostics, onlineCopyPath, resolveConflicts, syncProject, pullChanges, pushChanges, publishCredentialKey, publishConnectionStatus, listPublishAccounts, listPublishProviders, publishProviderFor, resolvePublishRequest, runPublish, connectPublishProvider, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig, buildRecoveryContext, recover16 as recover };
+export { BuildError, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, log, resolveActiveStyles, listProjectStyles, PLUGINS_DIR, ruleRemoteUrls, ruleRiskyProps, rulePagedjsCrashSelectors, ruleSyntax, checkCss, runLint, formatReport, getChecks, getCheckById, resolveCheckSelectors, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, redactCredential, defaultConfigDir, FileTokenStore, extractUrlCredential, migrateUrlCredential, getSystemDiagnostics, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, RECOMMENDED_PLUGINS, listProjectPlugins, setPluginEnabled, addNpmPlugin, addLocalPlugin, validateProjectPlugins, THEMES_DIR, BUILT_IN_THEME_IDS, listBuiltInThemes, resolveBuiltInTheme, listProjectThemes, getActiveTheme, getPreviousTheme, revertTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, readThemeCss, removeProjectTheme, importThemeFromFile, setManifestFields, readManifestFields, setActiveStyles, APP_HEARTBEAT_FRESH_MS, heartbeatTtlMs, appHeartbeatPath, writeAppHeartbeat, removeAppHeartbeat, readAppHeartbeat, isAppHeartbeatFresh, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, listGitHubRepositories, listRepoBooks, listGitHubBranches, RepoNeedsRecoveryError, isRepoNeedsRecoveryError, classifyFromHealth, classifyGitError, SYNC_SNAPSHOT_MESSAGE, provenancePath, readProjectProvenance, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, normalizeForgeHost, knownForgeTokenUrl, connectGenericHost, GenericTokenAuthProvider, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, inspectRepo, verifyRepoReadable, isUnbornRepo, preflightStructuralReason, buildPreflightDiagnostics, onlineCopyPath, resolveConflicts, syncProject, pullChanges, pushChanges, publishCredentialKey, publishConnectionStatus, listPublishAccounts, listPublishProviders, publishProviderFor, resolvePublishRequest, runPublish, connectPublishProvider, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig, buildRecoveryContext, recover16 as recover };