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

package/dist/{cli-n2tsxqpn.js → cli-d9mm3vvh.js}

@@ -1,3 +1,6 @@
+import {
+  pagesWithVisibleShadingPaints
+} from "./cli-5crpmz42.js";
 import {
   enhancedPath,
   execCapture,
@@ -11,7 +14,7 @@ import {
 import {
   PACKAGE_VERSION,
   log
-} from "./cli-s6djx4ma.js";
+} from "./cli-pspjxnc8.js";
 import {
   __require
 } from "./cli-37x76zdn.js";
@@ -189,7 +192,9 @@ async function findPostScriptShadingPages(pdfBytes) {
     if (usesPostScriptShading(asDict(page.node.Resources())))
       pages.push(i + 1);
   });
-  return pages;
+  if (pages.length === 0)
+    return pages;
+  return pagesWithVisibleShadingPaints(pdfBytes, pages).catch(() => pages);
 }
 async function stripAnnotations(pdfPath, stagingDir) {
   const tmp = join(stagingDir, "annotations-stripped.pdf");

package/dist/{cli-5jzyw06s.js → cli-gnpea9dx.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.23-alpha.3",
+  version: "0.11.23-alpha.4",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

package/dist/{cli-s6djx4ma.js → cli-pspjxnc8.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-5jzyw06s.js";
+} from "./cli-gnpea9dx.js";
 
 // src/utils/logger.ts
 var currentLevel = "INFO";

package/dist/{cli-t8be9yeb.js → cli-rqh295j9.js}

@@ -1,7 +1,7 @@
 import {
   PACKAGE_VERSION,
   debug
-} from "./cli-s6djx4ma.js";
+} from "./cli-pspjxnc8.js";
 import {
   isExactNpmVersion,
   isValidNpmPackageName,
@@ -24,7 +24,7 @@ import { pathToFileURL } from "node:url";
 var theme_default = `/* =============================================================================
    Clean Book — gutterpress built-in theme (theme.css)
    A calm, classic long-form book look. Change the :root tokens from the book's own stylesheet.
-   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
+   The page SIZE comes from the manifest (Setup > Book), so it is deliberately not set here.
    ============================================================================= */
 
 :root {
@@ -83,7 +83,7 @@ hr { border: 0; border-top: 1px solid var(--color-rule); margin: 1.5em 0; }
 var theme_default2 = `/* =============================================================================
    Zine — gutterpress built-in theme (theme.css)
    High-contrast, punchy, photocopier-friendly. Change the :root tokens from the book's own stylesheet.
-   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
+   The page SIZE comes from the manifest (Setup > Book), so it is deliberately not set here.
    ============================================================================= */
 
 :root {
@@ -144,7 +144,7 @@ code, pre { font-family: var(--font-mono); font-size: 0.95em; }
 var theme_default3 = `/* =============================================================================
    Technical Document — gutterpress built-in theme (theme.css)
    Clean sans-serif manual look with clear hierarchy. Change the :root tokens from the book's own stylesheet.
-   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
+   The page SIZE comes from the manifest (Setup > Book), so it is deliberately not set here.
    ============================================================================= */
 
 :root {
@@ -2335,7 +2335,12 @@ function splitCells(str2, spans) {
         lastPos = pos;
       }
     } else if (!isEscaped && spans[ch]) {
-      pos = spans[ch](str2, pos, max);
+      const end = spans[ch](str2, pos, max);
+      if (ch === 96) {
+        current += str2.substring(lastPos, pos) + str2.substring(pos, end).replace(/\\\|/g, "|");
+        lastPos = end;
+      }
+      pos = end;
       continue;
     }
     isEscaped = ch === 92;
@@ -3570,9 +3575,9 @@ async function loadNpmPackage(packageName, baseDir, version) {
   const looksLikeJsFilename = /\.(m?js|cjs)$/i.test(packageName);
   const suggestedPath = looksLikeJsFilename ? `./${packageName}` : `./plugins/${packageName}.js`;
   if (!looksLikeJsFilename && (!version || !isExactNpmVersion(version))) {
-    throw new Error(`Extension "${packageName}${version ? `@${version}` : ""}" is not pinned to an exact version, so it can't be downloaded automatically. Run \`gutterpress ext add ${packageName}\` (or use Book setup > Looks & features > Advanced in the desktop app) to download it and pin its version in your manifest.`);
+    throw new Error(`Extension "${packageName}${version ? `@${version}` : ""}" is not pinned to an exact version, so it can't be downloaded automatically. Run \`gutterpress ext add ${packageName}\` (or use Book setup > Advanced in the desktop app) to download it and pin its version in your manifest.`);
   }
-  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${version ? `${packageName}@${version}` : packageName}\` (or Book setup > Looks & features > Advanced in the desktop app),
+  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${version ? `${packageName}@${version}` : packageName}\` (or Book setup > Advanced in the desktop app),
 or reference a local file under \`extensions:\`:
   extensions:
     - ${suggestedPath}`);

package/dist/{cli-h4x81x97.js → cli-y6d1arem.js}

@@ -11,10 +11,10 @@ import {
   prettify,
   readExtensionMeta,
   slugify
-} from "./cli-t8be9yeb.js";
+} from "./cli-rqh295j9.js";
 import {
   log
-} from "./cli-s6djx4ma.js";
+} from "./cli-pspjxnc8.js";
 import {
   UsageError
 } from "./cli-d8xjns66.js";
@@ -185,9 +185,7 @@ var DTRPG_PRESET = {
   },
   defaultTargets: ["dtrpg"],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 4, reserveLastPage: true, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -212,53 +210,23 @@ var DTRPG_PRESET = {
     maxTac: 240,
     tacTolerance: 0.5
   },
-  lint: {
-    enabled: true,
-    configPath: null,
-    rules: {}
+  checks: {
+    "pdf.structure.qpdf": "error",
+    "pdf.print.pdfx-markers": "error",
+    "pdf.print.pdfx-metadata": "error",
+    "pdf.print.embedded-fonts": "error",
+    "pdf.print.safe-margins": "error",
+    "pdf.print.bleed": "off",
+    "pdf.nav.bookmarks": "off",
+    "pdf.nav.toc-links": "off",
+    "asset.font.license": "off"
   },
   validate: {
-    enabled: true,
-    checks: {
-      "pdf.structure.qpdf": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.pdfx-markers": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.pdfx-metadata": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.embedded-fonts": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.safe-margins": {
-        enabled: true,
-        severity: "error"
-      }
-    },
-    source: {
-      markdownlint: null,
-      htmlhint: null,
-      stylelint: null,
-      cssOwnership: null
-    },
     assets: {
-      maxImageSize: 1e7,
-      allowAlpha: false,
-      approvedFontFiles: [],
-      requireFontLicense: false
+      maxImageSize: 1e7
     },
     pdf: {
-      requireBookmarks: false,
-      requireTocLinks: false,
       minImageResolution: 300,
-      forbidTransparency: true,
-      requireBleed: false,
       bleedSize: 9
     },
     heuristics: {
@@ -272,9 +240,7 @@ var BOOK_PRESET = {
   id: "book",
   defaultTargets: [],
   extensions: [],
-  source: {
-    files: null
-  },
+  chapters: null,
   print: { signature: 1, reserveLastPage: false, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
@@ -299,47 +265,25 @@ var BOOK_PRESET = {
     maxTac: 400,
     tacTolerance: 0.5
   },
-  lint: {
-    enabled: true,
-    configPath: null,
-    rules: {}
+  checks: {
+    "pdf.structure.qpdf": "error",
+    "pdf.print.embedded-fonts": "error",
+    "pdf.print.safe-margins": "warning",
+    "pdf.print.pdfx-markers": "off",
+    "pdf.print.pdfx-metadata": "off",
+    "pdf.print.transparency": "off",
+    "asset.image.alpha-channel": "off",
+    "pdf.print.bleed": "off",
+    "pdf.nav.bookmarks": "off",
+    "pdf.nav.toc-links": "off",
+    "asset.font.license": "off"
   },
   validate: {
-    enabled: true,
-    checks: {
-      "pdf.structure.qpdf": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.embedded-fonts": {
-        enabled: true,
-        severity: "error"
-      },
-      "pdf.print.safe-margins": {
-        enabled: true,
-        severity: "warning"
-      },
-      "pdf.print.pdfx-markers": false,
-      "pdf.print.pdfx-metadata": false
-    },
-    source: {
-      markdownlint: null,
-      htmlhint: null,
-      stylelint: null,
-      cssOwnership: null
-    },
     assets: {
-      maxImageSize: 1e7,
-      allowAlpha: true,
-      approvedFontFiles: [],
-      requireFontLicense: false
+      maxImageSize: 1e7
     },
     pdf: {
-      requireBookmarks: false,
-      requireTocLinks: false,
       minImageResolution: 300,
-      forbidTransparency: false,
-      requireBleed: false,
       bleedSize: 9
     },
     heuristics: {
@@ -392,16 +336,16 @@ var DTRPG_TARGET = {
       maxTac: DTRPG_PRESET.ink.maxTac,
       tacTolerance: DTRPG_PRESET.ink.tacTolerance
     },
+    checks: {
+      "pdf.structure.qpdf": "error",
+      "pdf.print.pdfx-markers": "error",
+      "pdf.print.pdfx-metadata": "error",
+      "pdf.print.embedded-fonts": "error",
+      "pdf.print.safe-margins": "error",
+      "pdf.print.transparency": "on"
+    },
     validate: {
-      checks: {
-        "pdf.structure.qpdf": { enabled: true, severity: "error" },
-        "pdf.print.pdfx-markers": { enabled: true, severity: "error" },
-        "pdf.print.pdfx-metadata": { enabled: true, severity: "error" },
-        "pdf.print.embedded-fonts": { enabled: true, severity: "error" },
-        "pdf.print.safe-margins": { enabled: true, severity: "error" }
-      },
       pdf: {
-        forbidTransparency: DTRPG_PRESET.validate.pdf.forbidTransparency,
         minImageResolution: DTRPG_PRESET.validate.pdf.minImageResolution
       }
     }
@@ -419,22 +363,22 @@ var ITCH_TARGET = {
   id: "itch",
   label: "itch.io",
   overlay: {
+    checks: {
+      "pdf.structure.qpdf": "error",
+      "pdf.print.embedded-fonts": "error",
+      "pdf.print.pdfx-markers": "off",
+      "pdf.print.pdfx-metadata": "off",
+      "pdf.print.ink-coverage": "off",
+      "pdf.print.safe-margins": "off",
+      "pdf.print.transparency": "off",
+      "pdf.print.bleed": "off",
+      "asset.image.alpha-channel": "off"
+    },
     validate: {
-      checks: {
-        "pdf.structure.qpdf": { enabled: true, severity: "error" },
-        "pdf.print.embedded-fonts": { enabled: true, severity: "error" },
-        "pdf.print.pdfx-markers": false,
-        "pdf.print.pdfx-metadata": false,
-        "pdf.print.ink-coverage": false,
-        "pdf.print.safe-margins": false
-      },
       assets: {
-        allowAlpha: true,
         maxImageSize: 0
       },
       pdf: {
-        forbidTransparency: false,
-        requireBleed: false,
         minImageResolution: 0
       }
     }
@@ -473,9 +417,9 @@ function overlayPreset(preset, target) {
     ...preset,
     pdfx: { ...preset.pdfx, ...o.pdfx },
     ink: { ...preset.ink, ...o.ink },
+    checks: { ...preset.checks, ...o.checks },
     validate: {
       ...preset.validate,
-      checks: { ...preset.validate.checks, ...o.validate?.checks },
       assets: { ...preset.validate.assets, ...o.validate?.assets },
       pdf: { ...preset.validate.pdf, ...o.validate?.pdf }
     }
@@ -490,13 +434,120 @@ var DEFAULT_STRICT_PDF_CHECKS = [
 function applyDefaultPdfStrictChecks(config) {
   const next = structuredClone(config);
   for (const checkId of DEFAULT_STRICT_PDF_CHECKS) {
-    if (next.validate.checks[checkId] === undefined) {
-      next.validate.checks[checkId] = { enabled: true, severity: "error" };
-    }
+    if (next.checks[checkId] === undefined)
+      next.checks[checkId] = "error";
   }
   return next;
 }
 
+// src/lib/manifest-old-spellings.ts
+var SOURCE_TOOL_CHECKS = {
+  markdownlint: "source.markdownlint",
+  htmlhint: "source.htmlhint",
+  stylelint: "source.stylelint",
+  cssOwnership: "source.css-ownership"
+};
+var FLAG_CHECKS = {
+  "assets.allowAlpha": { check: "asset.image.alpha-channel", trueMeansOn: false },
+  "assets.requireFontLicense": { check: "asset.font.license", trueMeansOn: true },
+  "pdf.requireBookmarks": { check: "pdf.nav.bookmarks", trueMeansOn: true },
+  "pdf.requireTocLinks": { check: "pdf.nav.toc-links", trueMeansOn: true },
+  "pdf.requireBleed": { check: "pdf.print.bleed", trueMeansOn: true },
+  "pdf.forbidTransparency": { check: "pdf.print.transparency", trueMeansOn: true }
+};
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function readOldSpellings(raw) {
+  const { source, lint, validate, ink, ...manifest } = raw;
+  const tolerance = isObject(raw.page) && "tolerance" in raw.page;
+  if (source === undefined && lint === undefined && validate === undefined && ink === undefined && !tolerance) {
+    return raw;
+  }
+  if (isObject(source) && source.assets !== undefined) {
+    throw new UsageError("Manifest field `source.assets` is no longer supported — remove it.\n" + "  Assets are discovered from what your book actually references, so no list is needed.");
+  }
+  const renamed = [];
+  const dropped = [];
+  const checks = {};
+  if (isObject(source) && "files" in source) {
+    renamed.push("source.files -> chapters");
+    if (manifest.chapters === undefined)
+      manifest.chapters = source.files ?? null;
+  }
+  if (isObject(validate)) {
+    for (const [id, entry] of Object.entries(validate.checks ?? {})) {
+      if (entry === false || isObject(entry) && entry.enabled === false)
+        checks[id] = "off";
+      else if (isObject(entry) && typeof entry.severity === "string")
+        checks[id] = entry.severity;
+      else
+        checks[id] = "on";
+    }
+    if (validate.checks !== undefined)
+      renamed.push("validate.checks -> checks");
+    for (const [tool, value] of Object.entries(validate.source ?? {})) {
+      const id = SOURCE_TOOL_CHECKS[tool];
+      if (id && value === false) {
+        checks[id] = "off";
+        renamed.push(`validate.source.${tool}: false -> checks: { ${id}: off }`);
+      } else if (id && tool !== "stylelint" && typeof value === "string") {
+        dropped.push(`validate.source.${tool} (the config file is found by its usual name in the book's folder or a folder above it)`);
+      } else {
+        dropped.push(`validate.source.${tool}`);
+      }
+    }
+    for (const block of ["assets", "pdf", "heuristics"]) {
+      for (const [key, value] of Object.entries(validate[block] ?? {})) {
+        const flag = FLAG_CHECKS[`${block}.${key}`];
+        if (flag && typeof value === "boolean") {
+          const level = value === flag.trueMeansOn ? "on" : "off";
+          checks[flag.check] = level;
+          renamed.push(`validate.${block}.${key}: ${value} -> checks: { ${flag.check}: ${level} }`);
+        } else {
+          dropped.push(`validate.${block}.${key} (the preset and the publish target set it)`);
+        }
+      }
+    }
+    if (validate.enabled !== undefined) {
+      dropped.push("validate.enabled (`gutterpress build --skip-pre-validate --skip-post-validate` skips validation for one build)");
+    }
+  }
+  if (isObject(lint)) {
+    for (const [id, level] of Object.entries(lint.rules ?? {}))
+      checks[id] = level;
+    if (lint.rules !== undefined)
+      renamed.push("lint.rules -> checks");
+    if (lint.enabled === false) {
+      checks["source.stylelint"] = "off";
+      renamed.push("lint.enabled: false -> checks: { source.stylelint: off }");
+    } else if (lint.enabled !== undefined) {
+      dropped.push("lint.enabled");
+    }
+    if (lint.configPath !== undefined)
+      dropped.push("lint.configPath");
+  }
+  if (ink !== undefined)
+    dropped.push("ink (the preset and the publish target set it)");
+  if (tolerance) {
+    const { tolerance: _, ...page } = raw.page;
+    manifest.page = page;
+    dropped.push("page.tolerance (the preset sets it)");
+  }
+  if (Object.keys(checks).length > 0)
+    manifest.checks = { ...checks, ...manifest.checks };
+  const lines = [
+    ...renamed.map((r) => `  ${r}`),
+    ...dropped.map((d) => `  ${d} — no longer a setting, ignored`)
+  ];
+  if (lines.length > 0) {
+    warnOnce(`old-manifest-spellings:${lines.join("|")}`, "[gutterpress] manifest.yaml uses spellings 0.11.23 replaced. They still work in this " + `release; rewrite them before the next one:
+` + lines.join(`
+`));
+  }
+  return manifest;
+}
+
 // src/lib/manifest.ts
 var MANIFEST_FILENAMES = [
   "manifest.yaml"
@@ -514,8 +565,8 @@ async function loadManifestWithPath(pathOrDir, opts) {
         throw new UsageError(`"${p}" has two versions of a setting — yours and the online version — left by a sync. Open it, keep the one you want and delete the marker lines.`);
       }
       try {
-        const manifest = parseYaml(raw) ?? {};
-        return { manifest, manifestDir: dirname(p), manifestPath: p };
+        const parsed = parseYaml(raw) ?? {};
+        return { manifest: readOldSpellings(parsed), manifestDir: dirname(p), manifestPath: p };
       } catch (error) {
         if (!(error instanceof YAMLParseError))
           throw error;
@@ -651,7 +702,7 @@ function resolveCustomPage(c, m) {
   return {
     width,
     height,
-    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
+    tolerance: 0.5,
     bleed: c.page?.bleed ?? m.page?.bleed,
     safe: c.page?.safe ?? m.page?.safe,
     artSafe: c.page?.artSafe ?? m.page?.artSafe,
@@ -680,22 +731,8 @@ function validatePageMargin(margin, size) {
 function resolveWithPreset(cliOverrides, manifest, preset) {
   const m = manifest;
   const c = cliOverrides;
-  const legacy = m;
-  if (legacy.output !== undefined || legacy.source?.assets !== undefined) {
-    const stale = [
-      legacy.output !== undefined ? "`output`" : null,
-      legacy.source?.assets !== undefined ? "`source.assets`" : null
-    ].filter(Boolean);
-    throw new UsageError(`Manifest field(s) ${stale.join(" and ")} are no longer supported — remove them.
-` + "  Output goes to `dist/<title-slug>/` automatically (use `--out` for a one-off location).\n" + "  Assets are discovered from what your book actually references, so no list is needed.");
-  }
-  if ((m.validate?.source?.allowedCallouts?.length ?? 0) > 0 || (c.validate?.source?.allowedCallouts?.length ?? 0) > 0) {
-    warnOnce("allowed-callouts-deprecated", "[gutterpress] manifest field `validate.source.allowedCallouts` is " + "deprecated and ignored. The `:::` container syntax it gated was " + "removed 2026-05-17. See docs/migrations/2026-05-removing-container-syntax.md.");
-  }
-  for (const key of ["minImageDpi", "allowedColorSpaces"]) {
-    if (m.validate?.assets?.[key] !== undefined || c.validate?.assets?.[key] !== undefined) {
-      warnOnce(`assets-${key}-deprecated`, `[gutterpress] manifest field \`validate.assets.${key}\` is deprecated and ` + "ignored. The source-image check it configured was removed; the build " + "and the PDF checks measure what actually prints.");
-    }
+  if (m.output !== undefined) {
+    throw new UsageError("Manifest field `output` is no longer supported — remove it.\n" + "  Output goes to `dist/<title-slug>/` automatically (use `--out` for a one-off location).");
   }
   const removed = m;
   if (removed.engine !== undefined) {
@@ -741,25 +778,37 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
     styles: c.styles ?? m.styles,
     extensions,
     targets: resolveTargets(c.targets ?? m.targets, preset.defaultTargets),
-    source: mergeShape(c.source, m.source, preset.source),
+    chapters: c.chapters ?? m.chapters ?? preset.chapters,
+    checks: { ...preset.checks, ...resolveCheckLevels(m.checks), ...resolveCheckLevels(c.checks) },
     pdfx: mergeShape(c.pdfx, m.pdfx, preset.pdfx),
     print: mergeShape(c.print, m.print, preset.print),
     page,
-    ink: mergeShape(c.ink, m.ink, preset.ink),
-    lint: {
-      ...mergeShape(c.lint, m.lint, preset.lint),
-      rules: { ...preset.lint.rules, ...m.lint?.rules, ...c.lint?.rules }
-    },
-    validate: {
-      enabled: c.validate?.enabled ?? m.validate?.enabled ?? preset.validate.enabled,
-      checks: { ...preset.validate.checks, ...m.validate?.checks, ...c.validate?.checks },
-      source: mergeShape(c.validate?.source, m.validate?.source, preset.validate.source),
-      assets: mergeShape(c.validate?.assets, m.validate?.assets, preset.validate.assets),
-      pdf: mergeShape(c.validate?.pdf, m.validate?.pdf, preset.validate.pdf),
-      heuristics: mergeShape(c.validate?.heuristics, m.validate?.heuristics, preset.validate.heuristics)
-    }
+    ink: structuredClone(preset.ink),
+    validate: structuredClone(preset.validate)
   };
 }
+function resolveCheckLevels(input) {
+  if (input === undefined || input === null)
+    return {};
+  if (!isPlainObject(input)) {
+    throw new UsageError("Manifest field `checks` must map check ids to off, on, info, warn or error.");
+  }
+  const out = {};
+  for (const [id, value] of Object.entries(input)) {
+    if (value === false || value === "off")
+      out[id] = "off";
+    else if (value === true || value === "on")
+      out[id] = "on";
+    else if (value === "warn" || value === "warning")
+      out[id] = "warning";
+    else if (value === "info" || value === "error")
+      out[id] = value;
+    else {
+      throw new UsageError(`Manifest field \`checks.${id}\` must be off, on, info, warn or error, got ${JSON.stringify(value)}.`);
+    }
+  }
+  return out;
+}
 
 // src/lib/manifest-doc.ts
 function resolveManifestPath(projectDir) {
@@ -1478,6 +1527,7 @@ function ignoreStatus(gitignore, entry) {
   return dir.unignored || file.unignored ? "negated" : "open";
 }
 var PROJECT_GITIGNORE_ENTRIES = ["dist/", "extensions/npm/"];
+var LEGACY_NPM_LINE = /^\/?plugins\/npm\/?[ \t]*\r?\n?/gm;
 async function ensureProjectGitignore(projectDir) {
   const gitignorePath = path3.join(projectDir, ".gitignore");
   let existing = null;
@@ -1494,10 +1544,11 @@ async function ensureProjectGitignore(projectDir) {
       negated.push(entry);
   }
   if (missing.length > 0) {
-    const lead = existing !== null && existing.length > 0 && !existing.endsWith(`
+    const kept = missing.includes("extensions/npm/") ? (existing ?? "").replace(LEGACY_NPM_LINE, "") : existing ?? "";
+    const lead = kept.length > 0 && !kept.endsWith(`
 `) ? `
 ` : "";
-    await writeFile(gitignorePath, `${existing ?? ""}${lead}${missing.join(`
+    await writeFile(gitignorePath, `${kept}${lead}${missing.join(`
 `)}
 `, "utf8");
   }
@@ -1867,6 +1918,7 @@ async function vendorNpmExtension(projectDir, input, exportName, options, commit
   await finalizeNpmPluginInstall(installed).catch((error) => {
     warnings.push(`The extension was installed, but an old backup could not be removed: ` + `${error instanceof Error ? error.message : String(error)}`);
   });
+  warnings.push(...await retireLegacyCopies(projectDir, installed.name));
   try {
     const { negated } = await ensureProjectGitignore(projectDir);
     if (negated.includes("extensions/npm/")) {
@@ -1877,6 +1929,19 @@ async function vendorNpmExtension(projectDir, input, exportName, options, commit
   }
   return { name: installed.name, version: installed.version, use, warnings };
 }
+async function retireLegacyCopies(projectDir, name) {
+  const legacyPackageDir = path4.dirname(vendoredNpmPluginRoots(projectDir, name, "0.0.0")[1]);
+  const legacyNpmDir = path4.dirname(legacyPackageDir);
+  try {
+    await rm3(legacyPackageDir, { recursive: true, force: true });
+    await removeEmptyDirs([path4.dirname(legacyNpmDir), legacyNpmDir]);
+  } catch (error) {
+    return [
+      `The extension was installed, but the copy an older version of Gutterpress kept under plugins/npm/ ` + `could not be removed: ${error instanceof Error ? error.message : String(error)}`
+    ];
+  }
+  return [];
+}
 async function pinnedVersionsOf(projectDir, name) {
   const { doc } = await loadManifestDoc(projectDir);
   const seq = doc.get("extensions", true);

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
 } from "./cli-d8xjns66.js";
 import {
   package_default
-} from "./cli-5jzyw06s.js";
+} from "./cli-gnpea9dx.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -20,14 +20,14 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-s4zcaepg.js").then((m) => m.default),
-  preview: () => import("./preview-mzytcwyk.js").then((m) => m.default),
-  build: () => import("./build-m78jcpf7.js").then((m) => m.default),
-  publish: () => import("./publish-fez14ad4.js").then((m) => m.default),
-  validate: () => import("./validate-p2chr6hr.js").then((m) => m.default),
-  preflight: () => import("./preflight-c7w1xdn3.js").then((m) => m.default),
-  doctor: () => import("./doctor-j71jqce3.js").then((m) => m.default),
-  ext: () => import("./ext-fq2hg9va.js").then((m) => m.default)
+  new: () => import("./new-t2t28ccb.js").then((m) => m.default),
+  preview: () => import("./preview-zsp9hstd.js").then((m) => m.default),
+  build: () => import("./build-c48eer6f.js").then((m) => m.default),
+  publish: () => import("./publish-hhy31gr9.js").then((m) => m.default),
+  validate: () => import("./validate-r9jdz85h.js").then((m) => m.default),
+  preflight: () => import("./preflight-srq8fktp.js").then((m) => m.default),
+  doctor: () => import("./doctor-ptb346k8.js").then((m) => m.default),
+  ext: () => import("./ext-gy8szg3x.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -52,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-s4zcaepg.js");
+      const { newArgs } = await import("./new-t2t28ccb.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -64,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-c7w1xdn3.js");
+      const { preflightArgs } = await import("./preflight-srq8fktp.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -84,7 +84,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-fq2hg9va.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-gy8szg3x.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }