gutterpress 0.10.7 → 0.10.8

package/dist/{index-r4ny4fyr.js → index-dfw8hn8q.js}

@@ -10,6 +10,7 @@ import {
   findTool,
   fullInstallHint,
   getAssetPath,
+  getAssetsDir,
   getBrowser,
   isToolAvailable,
   prewarmBrowser,
@@ -17,7 +18,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-837htyjy.js";
+} from "./index-9pbaznww.js";
 import {
   gitFs,
   gitScopeFor,
@@ -38,7 +39,7 @@ import {
 } from "./index-37x76zdn.js";
 
 // src/lib/build-runner.ts
-import path8 from "node:path";
+import path9 from "node:path";
 import fs2 from "node:fs";
 import fsp2 from "node:fs/promises";
 import os2 from "node:os";
@@ -643,7 +644,7 @@ function escapeHtml(s) {
 function escapeAttr(s) {
   return String(s).replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-function parseMarkerLine(line) {
+function parseMarkerLine(line, declaredWords) {
   const trimmed = line.trim();
   if (!trimmed.startsWith("@"))
     return null;
@@ -677,9 +678,9 @@ function parseMarkerLine(line) {
     tokens[i] = unwrapAttrBraces(tokens[i]);
   const head = tokens[0];
   const kind = head.slice(1);
-  if (!KNOWN_KINDS.includes(kind))
+  if (!KNOWN_KINDS.includes(kind) && !(declaredWords && declaredWords.has(kind)))
     return null;
-  if (kind === "page-break" || kind === "column-break" || kind === "end-section" || kind === "continue") {
+  if (kind === "page-break" || kind === "column-break" || kind === "continue" || kind.startsWith("end-")) {
     return { kind, name: null, attrs: {} };
   }
   const body = tokens.slice(1);
@@ -782,12 +783,14 @@ function attachDataAttrs(token, kind, name, attrs) {
   if (name) {
     if (kind === "chapter")
       token.attrSet("data-chapter-label", name);
-    if (kind === "spread")
+    else if (kind === "spread")
       token.attrSet("data-spread", name);
-    if (kind === "page")
+    else if (kind === "page")
       token.attrSet("data-page", name);
-    if (kind === "section")
+    else if (kind === "section")
       token.attrSet("data-section", name);
+    else
+      token.attrSet(`data-${kind}`, name);
   }
   if (attrs.template)
     token.attrSet("data-template", attrs.template);
@@ -803,16 +806,193 @@ function attachDataAttrs(token, kind, name, attrs) {
     token.attrSet(`data-${k}`, v);
   }
 }
+var DECLARED_NAME_RE = /^[a-z][a-z0-9-]*$/;
+function validateDeclaredMarkerName(name, pluginName) {
+  if (!DECLARED_NAME_RE.test(name)) {
+    throw new Error(`Plugin "${pluginName}" declares marker "@${name}" with an invalid name — marker names must be ` + `lower-case letters, digits and hyphens, starting with a letter (like core's own "page-break").`);
+  }
+  if (name.startsWith("end-")) {
+    throw new Error(`Plugin "${pluginName}" declares marker "@${name}", but names starting with "end-" are reserved ` + `for the auto-derived closer of another declared marker (a container named "${name.slice(4)}" ` + `would collide with it). Rename this marker.`);
+  }
+}
+var TAG_NAME_RE = /^[a-z][a-z0-9-]*$/;
+function resolveContainerShape(name, pluginName, decl) {
+  const tag = decl.tag !== undefined ? decl.tag : "div";
+  if (typeof tag !== "string" || !TAG_NAME_RE.test(tag)) {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has an invalid \`tag\` (${JSON.stringify(decl.tag)}) — ` + `must be a lower-case HTML tag name.`);
+  }
+  const classBase = decl.class !== undefined ? decl.class : "";
+  if (typeof classBase !== "string") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`class\` that is not a string.`);
+  }
+  let variants;
+  if (decl.variants !== undefined) {
+    if (typeof decl.variants !== "object" || decl.variants === null || Array.isArray(decl.variants)) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has \`variants\` that is not a plain object.`);
+    }
+    variants = {};
+    for (const [variantName, variantClass] of Object.entries(decl.variants)) {
+      if (typeof variantClass !== "string") {
+        throw new Error(`Plugin "${pluginName}"'s marker "@${name}" variant "${variantName}" is not a string.`);
+      }
+      variants[variantName] = variantClass;
+    }
+  }
+  let label;
+  if (decl.label !== undefined) {
+    if (typeof decl.label !== "object" || decl.label === null || Array.isArray(decl.label)) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`label\` that is not an object.`);
+    }
+    if (typeof decl.label.class !== "string" || !decl.label.class) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`label.class\` that is not a non-empty string.`);
+    }
+    const match = typeof decl.label.from === "string" ? /^attr:([A-Za-z_][A-Za-z0-9_-]*)$/.exec(decl.label.from) : null;
+    if (!match) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`label.from\` (${JSON.stringify(decl.label.from)}) that is not "attr:<name>" — that is the only supported form today.`);
+    }
+    const labelTag = decl.label.tag !== undefined ? decl.label.tag : "div";
+    if (typeof labelTag !== "string" || !TAG_NAME_RE.test(labelTag)) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has an invalid \`label.tag\` (${JSON.stringify(decl.label.tag)}).`);
+    }
+    label = { class: decl.label.class, attr: match[1], tag: labelTag };
+  }
+  let autoCloseAtEof = false;
+  if (decl.autoCloseAt !== undefined) {
+    if (!Array.isArray(decl.autoCloseAt)) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has an \`autoCloseAt\` that is not an array.`);
+    }
+    for (const value of decl.autoCloseAt) {
+      if (value !== "eof") {
+        throw new Error(`Plugin "${pluginName}"'s marker "@${name}" declares an unsupported \`autoCloseAt\` value ` + `${JSON.stringify(value)} — only "eof" is currently supported.`);
+      }
+    }
+    autoCloseAtEof = decl.autoCloseAt.includes("eof");
+  }
+  return { tag, classBase, variants, label, autoCloseAtEof };
+}
+function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
+  const pluginName = originOf.get(name);
+  if (typeof rawDecl !== "object" || rawDecl === null || Array.isArray(rawDecl)) {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" is not a plain object.`);
+  }
+  if (rawDecl.deprecated !== undefined) {
+    if (typeof rawDecl.deprecated !== "string" || !rawDecl.deprecated) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`deprecated\` value that is not a non-empty string.`);
+    }
+    return { name, deprecated: rawDecl.deprecated };
+  }
+  if (rawDecl.alias !== undefined) {
+    if (typeof rawDecl.alias !== "string" || !rawDecl.alias) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has an \`alias\` value that is not a non-empty string.`);
+    }
+    const targetRaw = rawRegistry.get(rawDecl.alias);
+    if (!targetRaw) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" aliases unknown marker "@${rawDecl.alias}" — no ` + `loaded plugin declares it.`);
+    }
+    if (targetRaw.deprecated !== undefined) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" aliases "@${rawDecl.alias}", which is deprecated: ` + `${targetRaw.deprecated}`);
+    }
+    if (targetRaw.alias !== undefined) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" aliases "@${rawDecl.alias}", which is itself an alias. ` + `Chained aliases are not supported — alias the base marker directly.`);
+    }
+    const preset = rawDecl.preset !== undefined ? rawDecl.preset : {};
+    if (typeof preset !== "object" || preset === null || Array.isArray(preset)) {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`preset\` that is not a plain object.`);
+    }
+    if (preset.variant !== undefined && typeof preset.variant !== "string") {
+      throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`preset.variant\` that is not a string.`);
+    }
+    const container = resolveContainerShape(rawDecl.alias, originOf.get(rawDecl.alias), targetRaw);
+    return { name, baseKind: rawDecl.alias, presetVariant: preset.variant, ...container };
+  }
+  return { name, baseKind: name, ...resolveContainerShape(name, pluginName, rawDecl) };
+}
+function buildDeclaredMarkerRegistry(sources) {
+  const rawRegistry = new Map;
+  const originOf = new Map;
+  for (const { pluginName, markers } of sources) {
+    if (!markers)
+      continue;
+    for (const [name, rawDecl] of Object.entries(markers)) {
+      validateDeclaredMarkerName(name, pluginName);
+      if (KNOWN_KINDS.includes(name)) {
+        throw new Error(`Plugin "${pluginName}" declares marker "@${name}", which is a core Gutterpress marker name ` + `(${KNOWN_KINDS.map((k) => `@${k}`).join(", ")}). Core marker names cannot be shadowed — ` + `rename the plugin's marker.`);
+      }
+      if (rawRegistry.has(name)) {
+        throw new Error(`Marker "@${name}" is declared by both plugin "${originOf.get(name)}" and plugin "${pluginName}". ` + `Declared marker names must be unique across every loaded plugin — rename one of them.`);
+      }
+      rawRegistry.set(name, rawDecl);
+      originOf.set(name, pluginName);
+    }
+  }
+  const resolved = new Map;
+  for (const [name, rawDecl] of rawRegistry) {
+    resolved.set(name, resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf));
+  }
+  return resolved;
+}
+function declaredKindWords(declaredMarkers) {
+  if (!declaredMarkers)
+    return null;
+  const words = new Set;
+  for (const name of declaredMarkers.keys()) {
+    words.add(name);
+    words.add(`end-${name}`);
+  }
+  return words;
+}
+function nearestDeclaredMarkerName(word, declaredMarkers) {
+  const w = word.toLowerCase();
+  const threshold = Math.max(2, Math.floor(w.length / 3));
+  let best = null;
+  let bestDistance = Infinity;
+  for (const known of declaredMarkers.keys()) {
+    const d = editDistance(w, known);
+    if (d < bestDistance) {
+      bestDistance = d;
+      best = known;
+    }
+  }
+  return best !== null && bestDistance > 0 && bestDistance <= threshold ? best : null;
+}
+function scanForUnknownDeclaredMarkers(state, declaredMarkers) {
+  if (!declaredMarkers)
+    return;
+  for (let tokenIndex = 0;tokenIndex < state.tokens.length; tokenIndex++) {
+    const tok = state.tokens[tokenIndex];
+    if (tok.type !== "inline" || !tok.map)
+      continue;
+    const opener = state.tokens[tokenIndex - 1];
+    if (!opener || opener.type !== "paragraph_open")
+      continue;
+    const lines = tok.content.split(`
+`);
+    for (let i = 0;i < lines.length; i++) {
+      const m = /^@([A-Za-z][A-Za-z0-9-]*)(?=\s|$)/.exec(lines[i].trim());
+      if (!m)
+        continue;
+      const word = m[1];
+      if (KNOWN_KINDS.includes(word) || declaredMarkers.has(word))
+        continue;
+      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers);
+      if (!suggestion)
+        continue;
+      warn(state.env, tok.map[0] + i + 1, "unknown_marker", `Unknown marker "@${word}". Did you mean "@${suggestion}"?`, null);
+    }
+  }
+}
 function plugin(md, pluginOptions = {}) {
   const options = {
     preferPagesInSpreads: false,
     ...pluginOptions
   };
+  const declaredMarkers = options.declaredMarkers instanceof Map && options.declaredMarkers.size > 0 ? options.declaredMarkers : null;
+  const declaredWords = declaredKindWords(declaredMarkers);
   function markerBlock(state, startLine, endLine, silent) {
     const pos = state.bMarks[startLine] + state.tShift[startLine];
     const max = state.eMarks[startLine];
     const line = state.src.slice(pos, max);
-    const parsed = parseMarkerLine(line);
+    const parsed = parseMarkerLine(line, declaredWords);
     if (!parsed)
       return false;
     if (silent)
@@ -869,10 +1049,64 @@ function plugin(md, pluginOptions = {}) {
     }
   }
   md.core.ruler.after("block", "layout_transform", function(state) {
+    scanForUnknownDeclaredMarkers(state, declaredMarkers);
     if (!state.env.__layoutMarkersUsed)
       return;
     scanForMistypedMarkers(state);
     const out = [];
+    const declaredFrames = [];
+    function declaredFrameIndex(kind) {
+      for (let i = declaredFrames.length - 1;i >= 0; i--) {
+        if (declaredFrames[i].kind === kind)
+          return i;
+      }
+      return -1;
+    }
+    function closeDeclaredFrame(kind) {
+      const at = declaredFrameIndex(kind);
+      if (at === -1)
+        return false;
+      while (declaredFrames.length > at) {
+        const frame = declaredFrames.pop();
+        out.push(new state.Token("layout_component_close", frame.tag, -1));
+      }
+      return true;
+    }
+    function drainDeclaredFrames() {
+      while (declaredFrames.length) {
+        const frame = declaredFrames.pop();
+        out.push(new state.Token("layout_component_close", frame.tag, -1));
+      }
+    }
+    function drainDeclaredFramesAtEof() {
+      while (declaredFrames.length) {
+        const frame = declaredFrames.pop();
+        if (!frame.decl.autoCloseAtEof) {
+          warn(state.env, frame.line || 0, "declared_marker_eof_close", `An open @${frame.kind} reached end-of-document; closing it automatically. Add ` + `@end-${frame.kind} to close it explicitly, or declare autoCloseAt: ["eof"] on this ` + `marker if running to end-of-document is expected.`, null);
+        }
+        out.push(new state.Token("layout_component_close", frame.tag, -1));
+      }
+    }
+    function openDeclaredMarker(meta, decl) {
+      const t = new state.Token("layout_component_open", decl.tag, 1);
+      t.meta = { line: meta.__line };
+      const variant = meta.name || decl.presetVariant || null;
+      const variantClass = variant && decl.variants && decl.variants[variant] || "";
+      const baseClass = [decl.classBase, variantClass].filter(Boolean).join(" ");
+      addClasses(t, baseClass, meta.attrs && meta.attrs.class ? meta.attrs.class : "");
+      attachDataAttrs(t, decl.baseKind, variant, meta.attrs || {});
+      out.push(t);
+      declaredFrames.push({ kind: decl.baseKind, tag: decl.tag, decl, line: meta.__line });
+      if (decl.label) {
+        const value = meta.attrs && meta.attrs[decl.label.attr];
+        if (value) {
+          const labelToken = new state.Token("html_block", "", 0);
+          labelToken.content = `<${decl.label.tag} class="${escapeAttr(decl.label.class)}">${escapeHtml(value)}</${decl.label.tag}>
+`;
+          out.push(labelToken);
+        }
+      }
+    }
     const stack = {
       frames: [],
       get(kind) {
@@ -1022,6 +1256,7 @@ function plugin(md, pluginOptions = {}) {
       const kind = meta.kind;
       const line = meta.__line || 0;
       if (kind === "chapter") {
+        drainDeclaredFrames();
         stack.close("chapter");
         openChapter(meta);
         continue;
@@ -1030,16 +1265,19 @@ function plugin(md, pluginOptions = {}) {
         if (stack.has("spread")) {
           warn(state.env, line, "nested_spread", "@spread encountered while another spread is open; closing the previous spread automatically.", meta);
         }
+        drainDeclaredFrames();
         stack.close("spread");
         openSpread(meta);
         continue;
       }
       if (kind === "page") {
+        drainDeclaredFrames();
         stack.close("page");
         openPage(meta);
         continue;
       }
       if (kind === "section") {
+        drainDeclaredFrames();
         warnIfEmptyDecoratedSection("section", line);
         stack.close("section");
         const spread = stack.get("spread");
@@ -1055,6 +1293,7 @@ function plugin(md, pluginOptions = {}) {
           warn(state.env, line, "continue_without_section", "@continue used without an open @section; ignoring marker.", meta);
           continue;
         }
+        drainDeclaredFrames();
         const contMeta = {
           name: section.meta.name,
           attrs: { ...section.meta.attrs || {} }
@@ -1087,15 +1326,42 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "end-section") {
+        drainDeclaredFrames();
         warnIfEmptyDecoratedSection("end-section", line);
         stack.close("section");
         continue;
       }
+      if (declaredMarkers) {
+        const openDecl = declaredMarkers.get(kind);
+        if (openDecl) {
+          if (openDecl.deprecated) {
+            warn(state.env, line, "deprecated_marker", `@${kind} is deprecated: ${openDecl.deprecated}`, meta);
+            continue;
+          }
+          closeDeclaredFrame(openDecl.baseKind);
+          openDeclaredMarker(meta, openDecl);
+          continue;
+        }
+        if (kind.startsWith("end-")) {
+          const closeDecl = declaredMarkers.get(kind.slice(4));
+          if (closeDecl) {
+            if (closeDecl.deprecated) {
+              warn(state.env, line, "deprecated_marker", `@${kind} is deprecated: ${closeDecl.deprecated}`, meta);
+              continue;
+            }
+            if (!closeDeclaredFrame(closeDecl.baseKind)) {
+              warn(state.env, line, "declared_marker_close_without_open", `@${kind} used without an open @${closeDecl.baseKind}; ignoring marker.`, meta);
+            }
+            continue;
+          }
+        }
+      }
     }
     const eofSpread = stack.get("spread");
     if (eofSpread && !eofSpread.sawAnyPage) {
       warn(state.env, 0, "spread_eof_close", "An open @spread reached end-of-document; closing it automatically.", null);
     }
+    drainDeclaredFramesAtEof();
     stack.closeAll();
     state.tokens = out;
   });
@@ -2154,7 +2420,9 @@ function createMarkdownRenderer(customPlugins) {
   md.use(unwrapPlugin(markdownItFootnote));
   md.use(unwrapPlugin(markdownItDeflist));
   md.use(unwrapPlugin(markdownItSourceMap));
-  md.use(plugin);
+  const declaredMarkerSources = (customPlugins ?? []).filter((p) => !!p.markers).map((p) => ({ pluginName: p.name, markers: p.markers }));
+  const declaredMarkers = buildDeclaredMarkerRegistry(declaredMarkerSources);
+  md.use(plugin, { declaredMarkers });
   md.use(gpPinScope);
   registerImageRule(md);
   if (customPlugins && customPlugins.length > 0) {
@@ -2734,8 +3002,8 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
 
 // src/lib/markdown/plugins.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync4, lstatSync, realpathSync, rmSync, statSync as statSync2, unlinkSync } from "node:fs";
-import { cp, link, mkdir as mkdir2, mkdtemp, readFile as readFile5, rm, unlink, writeFile as writeFile2 } from "node:fs/promises";
+import { existsSync as existsSync5, lstatSync, realpathSync, rmSync, statSync as statSync2, unlinkSync } from "node:fs";
+import { cp, link, mkdir as mkdir2, mkdtemp, readFile as readFile6, rm, unlink, writeFile as writeFile2 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { resolve as resolve3, join as join2, dirname as dirname2, basename, extname, relative, isAbsolute } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -3327,6 +3595,70 @@ function resolveDeclaredStyles(rawStyles, baseDir, subject) {
     return abs;
   });
 }
+
+// src/lib/extension-manifest.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { readFile as readFile5 } from "node:fs/promises";
+import path4 from "node:path";
+var EXTENSION_MANIFEST_FILENAME = "gutterpress.json";
+var LEGACY_THEME_MANIFEST_FILENAME = "theme.json";
+async function readJsonMetaFile(jsonPath) {
+  try {
+    const parsed = JSON.parse(await readFile5(jsonPath, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+async function readExtensionMeta(dir) {
+  const extensionPath = path4.join(dir, EXTENSION_MANIFEST_FILENAME);
+  if (existsSync4(extensionPath)) {
+    return readJsonMetaFile(extensionPath);
+  }
+  return readJsonMetaFile(path4.join(dir, LEGACY_THEME_MANIFEST_FILENAME));
+}
+function declaredList(value) {
+  return Array.isArray(value) ? value.filter((s) => typeof s === "string" && s.trim().length > 0) : [];
+}
+function extensionStyleList(meta) {
+  return declaredList(meta.styles);
+}
+function extensionEngineStyleList(meta) {
+  return declaredList(meta.engineStyles?.native);
+}
+function pathEscapesFolder(rel) {
+  return path4.isAbsolute(rel) || rel.split(/[\\/]/).includes("..");
+}
+function assertExtensionContained(meta) {
+  const declared = [
+    ...extensionStyleList(meta),
+    ...extensionEngineStyleList(meta),
+    ...meta.markdown ? [meta.markdown] : [],
+    ...meta.components ? [meta.components] : [],
+    ...meta.snippets ? [meta.snippets] : [],
+    ...meta.tokensFile ? [meta.tokensFile] : []
+  ];
+  for (const rel of declared) {
+    if (pathEscapesFolder(rel)) {
+      throw new Error(`Extension metadata declares "${rel}" outside its own folder; an extension must be self-contained.`);
+    }
+  }
+}
+function resolveExtension(dir, meta, subject) {
+  const styles = resolveDeclaredStyles(extensionStyleList(meta), dir, subject);
+  const engineStyles = resolveDeclaredStyles(extensionEngineStyleList(meta), dir, subject);
+  const [markdown] = resolveDeclaredStyles(meta.markdown ? [meta.markdown] : undefined, dir, subject) ?? [];
+  const [components] = resolveDeclaredStyles(meta.components ? [meta.components] : undefined, dir, subject) ?? [];
+  const [snippets] = resolveDeclaredStyles(meta.snippets ? [meta.snippets] : undefined, dir, subject) ?? [];
+  return {
+    ...markdown ? { markdown } : {},
+    ...styles ? { styles } : {},
+    ...engineStyles ? { engineStyles } : {},
+    ...meta.tokensFile?.trim() ? { tokensFile: meta.tokensFile.trim() } : {},
+    ...components ? { components } : {},
+    ...snippets ? { snippets } : {}
+  };
+}
 // src/lib/markdown/plugins.ts
 var moduleInternals = Module;
 var vendorCjsTrees = new Map;
@@ -3617,7 +3949,7 @@ async function rewriteReachableModuleImports(entryPath, tree) {
     const pkg = packageOwningFile(tree, absolute);
     if (!pkg)
       throw new Error(`Reachable plugin module is outside the verified package tree: ${absolute}`);
-    const source = await readFile5(absolute, "utf8");
+    const source = await readFile6(absolute, "utf8");
     const [imports] = parseModuleImports(source, absolute);
     const replacements = [];
     const targets = new Set;
@@ -3848,12 +4180,22 @@ function validateStylesExport(value, pluginRef) {
   }
   return value.length > 0 ? value : undefined;
 }
+function validateMarkersExport(value, pluginRef) {
+  if (value === undefined)
+    return;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error(`Plugin "${pluginRef}" exports \`markers\` that is not a plain object.`);
+  }
+  const table = value;
+  return Object.keys(table).length > 0 ? table : undefined;
+}
 function extractPluginExports(pluginModule, pluginRef, exportName) {
   const mod = pluginModule !== null && (typeof pluginModule === "object" || typeof pluginModule === "function") ? pluginModule : {};
   let plugin2;
   let metadata = mod.metadata;
   let css = mod.css;
   let styles = validateStylesExport(mod.styles, pluginRef);
+  let markers = validateMarkersExport(mod.markers, pluginRef);
   if (exportName && typeof mod[exportName] === "function") {
     plugin2 = mod[exportName];
   } else if (exportName) {
@@ -3869,11 +4211,12 @@ function extractPluginExports(pluginModule, pluginRef, exportName) {
     metadata = inner.metadata ?? metadata;
     css = inner.css ?? css;
     styles = validateStylesExport(inner.styles, pluginRef) ?? styles;
+    markers = validateMarkersExport(inner.markers, pluginRef) ?? markers;
   }
   if (typeof plugin2 !== "function") {
     throw new Error(`Plugin "${pluginRef}" does not export a valid plugin function. Expected \`export default function (md, options) { ... }\` or CommonJS \`module.exports = function (md, options) { ... }\`.`);
   }
-  return { plugin: plugin2, metadata, css, styles };
+  return { plugin: plugin2, metadata, css, styles, markers };
 }
 var pathPluginCache = new Map;
 var liveShadowPaths = new Set;
@@ -3944,6 +4287,48 @@ function resolvePluginStyles(rawStyles, moduleDir, pluginRef) {
   }
   return resolveDeclaredStyles(rawStyles, moduleDir, `Plugin "${pluginRef}"`);
 }
+function noopPlugin() {}
+function extensionMetadata(meta) {
+  if (!meta.name && !meta.description && !meta.author)
+    return;
+  return {
+    ...meta.name ? { name: meta.name } : {},
+    ...meta.description ? { description: meta.description } : {},
+    ...meta.author ? { author: meta.author } : {}
+  };
+}
+async function loadExtensionFromDir(extensionDir, config, pluginRef) {
+  const meta = await readExtensionMeta(extensionDir);
+  assertExtensionContained(meta);
+  const resolved = resolveExtension(extensionDir, meta, `Plugin "${pluginRef}"`);
+  const extensionStyles = [...resolved.styles ?? [], ...resolved.engineStyles ?? []];
+  const name = config.name ?? meta.name ?? pluginRef;
+  if (!resolved.markdown && extensionStyles.length === 0) {
+    throw new Error(`Extension folder "${pluginRef}" declares neither \`markdown\` nor \`styles\`/` + "`engineStyles` (in its gutterpress.json or theme.json) — there is nothing to " + "load. Point `path` at a JS file directly for a plain plugin, or add a metadata file declaring at least one.");
+  }
+  if (!resolved.markdown) {
+    return {
+      name,
+      plugin: noopPlugin,
+      ...extensionMetadata(meta) ? { metadata: extensionMetadata(meta) } : {},
+      ...extensionStyles.length > 0 ? { styles: extensionStyles } : {},
+      options: config.options
+    };
+  }
+  const pluginModule = await loadCachedPathPluginModule(resolved.markdown);
+  const { plugin: plugin2, metadata, css, styles: rawStyles, markers } = extractPluginExports(pluginModule, pluginRef, config.export);
+  const ownStyles = resolvePluginStyles(rawStyles, dirname2(resolved.markdown), pluginRef);
+  const styles = [...extensionStyles, ...ownStyles ?? []];
+  return {
+    name,
+    plugin: plugin2,
+    metadata: metadata ?? extensionMetadata(meta),
+    css,
+    ...styles.length > 0 ? { styles } : {},
+    ...markers ? { markers } : {},
+    options: config.options
+  };
+}
 async function loadPlugin(config, baseDir) {
   const pluginRef = config.path ?? config.name ?? "(unspecified)";
   let pluginModule;
@@ -3959,10 +4344,21 @@ async function loadPlugin(config, baseDir) {
       options: config.options
     };
   }
+  if (config.path) {
+    const candidatePath = resolve3(baseDir, config.path);
+    if (existsSync5(candidatePath) && statSync2(candidatePath).isDirectory()) {
+      try {
+        return await loadExtensionFromDir(candidatePath, config, pluginRef);
+      } catch (error2) {
+        const errorMsg = error2 instanceof Error ? error2.message : String(error2);
+        throw new Error(`Failed to load plugin "${pluginRef}": ${errorMsg}`);
+      }
+    }
+  }
   try {
     if (config.path) {
       const pluginPath = resolve3(baseDir, config.path);
-      if (!existsSync4(pluginPath)) {
+      if (!existsSync5(pluginPath)) {
         throw new Error(`Plugin file not found: ${pluginPath} (resolved from manifest entry path="${config.path}")`);
       }
       pluginModule = await loadCachedPathPluginModule(pluginPath);
@@ -3978,7 +4374,7 @@ async function loadPlugin(config, baseDir) {
     const errorMsg = error2 instanceof Error ? error2.message : String(error2);
     throw new Error(`Failed to load plugin "${pluginRef}": ${errorMsg}`);
   }
-  const { plugin: plugin2, metadata, css, styles: rawStyles } = extractPluginExports(pluginModule, pluginRef, config.export);
+  const { plugin: plugin2, metadata, css, styles: rawStyles, markers } = extractPluginExports(pluginModule, pluginRef, config.export);
   const styles = resolvePluginStyles(rawStyles, moduleDir, pluginRef);
   return {
     name: pluginName,
@@ -3986,6 +4382,7 @@ async function loadPlugin(config, baseDir) {
     metadata,
     css,
     styles,
+    markers,
     options: config.options
   };
 }
@@ -4017,7 +4414,7 @@ async function loadPluginsWithCss(configs, baseDir, onError) {
 }
 
 // src/lib/output-paths.ts
-import path4 from "node:path";
+import path5 from "node:path";
 
 // src/lib/slug.ts
 function slugify(name, fallback = "") {
@@ -4035,15 +4432,15 @@ function bookSlug(title) {
   return slugify(title ?? "", "book");
 }
 function resolveOutputDir(manifestDir, title) {
-  return path4.resolve(manifestDir, DIST_DIRNAME, bookSlug(title));
+  return path5.resolve(manifestDir, DIST_DIRNAME, bookSlug(title));
 }
 function artifactName(title, format) {
   return `${bookSlug(title)}-${format}.pdf`;
 }
 
 // src/lib/ghostscript.ts
-import { existsSync as existsSync5 } from "node:fs";
-import { readFile as readFile6, writeFile as writeFile3, unlink as unlink2, rename, readdir as readdir4 } from "node:fs/promises";
+import { existsSync as existsSync6 } from "node:fs";
+import { readFile as readFile7, writeFile as writeFile3, unlink as unlink2, rename, readdir as readdir4 } from "node:fs/promises";
 import { join as join3, basename as basename2, resolve as resolve4 } from "node:path";
 var WINDOWS_GHOSTSCRIPT_NAMES = ["gswin64c", "gswin32c", "gs"];
 var POSIX_GHOSTSCRIPT_NAMES = ["gs"];
@@ -4077,7 +4474,7 @@ async function findWindowsGhostscriptInstall(env) {
     for (const version of versions) {
       for (const executable of ["gswin64c.exe", "gswin32c.exe"]) {
         const candidate = join3(installRoot, version.name, "bin", executable);
-        if (existsSync5(candidate))
+        if (existsSync6(candidate))
           return candidate;
       }
     }
@@ -4086,7 +4483,7 @@ async function findWindowsGhostscriptInstall(env) {
 }
 async function resolveGhostscript(targetPlatform = process.platform, env = process.env) {
   const override = envValue(env, "GHOSTSCRIPT_PATH");
-  if (override && existsSync5(override))
+  if (override && existsSync6(override))
     return override;
   const names = targetPlatform === "win32" ? WINDOWS_GHOSTSCRIPT_NAMES : POSIX_GHOSTSCRIPT_NAMES;
   for (const name of names) {
@@ -4145,7 +4542,7 @@ async function stripAnnotations(pdfPath, stagingDir) {
     await unlink2(tmp).catch(() => {});
   }
   const { PDFDocument, PDFName } = await import("pdf-lib");
-  const bytes = await readFile6(pdfPath);
+  const bytes = await readFile7(pdfPath);
   const doc = await PDFDocument.load(bytes, { updateMetadata: false });
   const annots = PDFName.of("Annots");
   for (const page of doc.getPages())
@@ -4220,7 +4617,7 @@ ${docInfoConformance}/DOCINFO pdfmark
 }
 async function stampCreator(pdfPath) {
   const { PDFDocument } = await import("pdf-lib");
-  const bytes = await readFile6(pdfPath);
+  const bytes = await readFile7(pdfPath);
   const doc = await PDFDocument.load(bytes, { updateMetadata: false });
   doc.setCreator("gutterpress");
   const out = await doc.save();
@@ -4271,14 +4668,14 @@ async function convertToPdfxCmyk(inputPdf, outPdf, config) {
 
 // src/lib/build-fingerprint.ts
 import * as fs from "node:fs";
-import { mkdir as mkdir3, readFile as readFile7, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir3, readFile as readFile8, writeFile as writeFile4 } from "node:fs/promises";
 import { createHash as createHash4 } from "node:crypto";
-import path5 from "node:path";
+import path6 from "node:path";
 import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.7",
+  version: "0.10.8",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -4435,7 +4832,7 @@ async function getGitRevision(sourceDir) {
   const candidateDirs = [sourceDir, process.cwd()].filter((v) => Boolean(v));
   const seen = new Set;
   for (const dir of candidateDirs) {
-    const abs = path5.resolve(dir);
+    const abs = path6.resolve(dir);
     if (seen.has(abs))
       continue;
     seen.add(abs);
@@ -4471,8 +4868,8 @@ async function getEngineBundleHash() {
       getAssetPath("engine/gutterpress-agent.js")
     ]);
     const [viewerBytes, agentBytes] = await Promise.all([
-      readFile7(viewerPath),
-      readFile7(agentPath)
+      readFile8(viewerPath),
+      readFile8(agentPath)
     ]);
     const hash = createHash4("sha256");
     hash.update(viewerBytes);
@@ -4520,8 +4917,8 @@ function sanitizeArgs(args) {
   return out;
 }
 async function writeBuildFingerprint(input) {
-  const outputDir = path5.resolve(input.outputDir);
-  const outPath = path5.join(outputDir, FINGERPRINT_FILENAME);
+  const outputDir = path6.resolve(input.outputDir);
+  const outPath = path6.join(outputDir, FINGERPRINT_FILENAME);
   const [tools, sourceRevision] = await Promise.all([
     getToolVersions(),
     getGitRevision(input.sourceDir)
@@ -4537,7 +4934,7 @@ async function writeBuildFingerprint(input) {
         iccPath: input.pdfx.iccPath,
         stripAnnotations: input.pdfx.stripAnnotations
       },
-      outputDir: input.recordedOutputDir ? path5.resolve(input.recordedOutputDir) : outputDir
+      outputDir: input.recordedOutputDir ? path6.resolve(input.recordedOutputDir) : outputDir
     },
     sourceRevision,
     tools
@@ -4549,7 +4946,7 @@ async function writeBuildFingerprint(input) {
 
 // src/lib/lint-runner.ts
 import { resolve as resolve5 } from "node:path";
-import { readFile as readFile8 } from "node:fs/promises";
+import { readFile as readFile9 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss2 from "postcss";
@@ -4790,7 +5187,10 @@ async function runLint(opts = {}) {
   } else {
     const relStyles = await resolveActiveStyles(manifestDir, resolved.styles);
     const projectFiles = relStyles.map((rel) => resolve5(manifestDir, rel));
-    const { pluginStylePaths } = await loadPluginsWithCss(resolved.plugins, manifestDir, (ref, err) => log.warn(`Skipping plugin "${ref}" for lint — ${err.message}`));
+    let pluginStylePaths = opts.pluginStylePaths;
+    if (pluginStylePaths === undefined) {
+      ({ pluginStylePaths } = await loadPluginsWithCss(resolved.plugins, manifestDir, (ref, err) => log.warn(`Skipping plugin "${ref}" for lint — ${err.message}`)));
+    }
     files = [...projectFiles, ...pluginStylePaths].filter((f) => !f.endsWith(".min.css"));
   }
   if (files.length === 0) {
@@ -4804,7 +5204,7 @@ async function runLint(opts = {}) {
   for (const file of files) {
     let css;
     try {
-      css = await readFile8(file, "utf8");
+      css = await readFile9(file, "utf8");
     } catch (err) {
       log.error(`  ${file}`);
       log.error(`    cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`);
@@ -4837,7 +5237,7 @@ async function runLint(opts = {}) {
 }
 
 // src/lib/validation-exec.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { dirname as dirname4, join as join4, resolve as resolve9 } from "node:path";
 
 // src/checks/formatter.ts
@@ -5008,7 +5408,7 @@ function inspectionFailed(checkId, message, extra = {}) {
 }
 
 // src/lib/pdf-inspect.ts
-import { stat, readFile as readFile9 } from "node:fs/promises";
+import { stat, readFile as readFile10 } from "node:fs/promises";
 import { getDocumentProxy } from "unpdf";
 import * as pdfjs from "unpdf/pdfjs";
 function getOps(mod) {
@@ -5044,17 +5444,17 @@ function evictLru() {
       destroyEntryAfterGrace(evicted);
   }
 }
-async function loadPdf(path6) {
+async function loadPdf(path7) {
   let st;
   try {
-    st = await stat(path6);
+    st = await stat(path7);
   } catch {
     return null;
   }
-  const hit = docCache.get(path6);
+  const hit = docCache.get(path7);
   if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) {
-    docCache.delete(path6);
-    docCache.set(path6, hit);
+    docCache.delete(path7);
+    docCache.set(path7, hit);
     try {
       return await hit.doc;
     } catch {
@@ -5063,15 +5463,15 @@ async function loadPdf(path6) {
   }
   if (hit)
     destroyEntry(hit);
-  const docPromise = readFile9(path6).then((buf) => getDocumentProxy(new Uint8Array(buf)));
-  docCache.delete(path6);
-  docCache.set(path6, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
+  const docPromise = readFile10(path7).then((buf) => getDocumentProxy(new Uint8Array(buf)));
+  docCache.delete(path7);
+  docCache.set(path7, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
   evictLru();
   try {
     return await docPromise;
   } catch {
-    if (docCache.get(path6)?.doc === docPromise)
-      docCache.delete(path6);
+    if (docCache.get(path7)?.doc === docPromise)
+      docCache.delete(path7);
     return null;
   }
 }
@@ -5522,9 +5922,9 @@ var check3 = {
 registerCheck(check3);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile10(pdfPath, "latin1");
+  return readFile11(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -6095,21 +6495,21 @@ var check15 = {
 registerCheck(check15);
 
 // src/checks/source/markdownlint.ts
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 import { lint } from "markdownlint/sync";
 import { parse as parseYaml2 } from "yaml";
 
 // src/checks/source/config-file.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 import { resolve as resolve6 } from "node:path";
 function findConfigFile(inputDir, names, explicit) {
   if (explicit) {
     const p = resolve6(inputDir, explicit);
-    return existsSync6(p) ? p : null;
+    return existsSync7(p) ? p : null;
   }
   for (const name of names) {
     const p = resolve6(inputDir, name);
-    if (existsSync6(p))
+    if (existsSync7(p))
       return p;
   }
   return null;
@@ -6128,7 +6528,7 @@ function stripJsonComments(s) {
   return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
 }
 async function loadConfig(configPath) {
-  const raw = await readFile11(configPath, "utf8");
+  const raw = await readFile12(configPath, "utf8");
   let parsed;
   if (configPath.endsWith(".json")) {
     parsed = JSON.parse(raw);
@@ -6187,8 +6587,8 @@ var check16 = {
 registerCheck(check16);
 
 // src/checks/source/htmlhint.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile12 } from "node:fs/promises";
+import { existsSync as existsSync8 } from "node:fs";
+import { readFile as readFile13 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
@@ -6202,14 +6602,14 @@ var check17 = {
     const sourceConfig = ctx.config.validate.source;
     if (sourceConfig.htmlhint === false)
       return [];
-    if (!ctx.htmlPath || !existsSync7(ctx.htmlPath))
+    if (!ctx.htmlPath || !existsSync8(ctx.htmlPath))
       return [];
     const configPath = typeof sourceConfig.htmlhint === "string" ? sourceConfig.htmlhint : null;
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile12(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile12(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile13(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile13(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
       checkId: check17.id,
@@ -6224,7 +6624,7 @@ var check17 = {
 registerCheck(check17);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile13 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 var check18 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
@@ -6242,7 +6642,7 @@ var check18 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile13(file, "utf8");
+        css = await readFile14(file, "utf8");
       } catch {
         continue;
       }
@@ -6263,12 +6663,12 @@ var check18 = {
 registerCheck(check18);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 import postcss3 from "postcss";
 import { parse as parseYaml3 } from "yaml";
 var CONFIG_NAMES3 = [".gutterpress/css-contract.yaml", ".gutterpress/css-contract.yml"];
 async function loadContract(configPath) {
-  const raw = await readFile14(configPath, "utf8");
+  const raw = await readFile15(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -6419,7 +6819,7 @@ var check19 = {
         continue;
       let css;
       try {
-        css = await readFile14(absFile, "utf8");
+        css = await readFile15(absFile, "utf8");
       } catch {
         continue;
       }
@@ -6461,8 +6861,8 @@ var check19 = {
 registerCheck(check19);
 
 // src/checks/source/local-refs.ts
-import { existsSync as existsSync8 } from "node:fs";
-import { readFile as readFile15 } from "node:fs/promises";
+import { existsSync as existsSync9 } from "node:fs";
+import { readFile as readFile16 } from "node:fs/promises";
 import { dirname as dirname3, resolve as resolve7 } from "node:path";
 
 // src/checks/source/local-ref-parser.ts
@@ -6542,7 +6942,7 @@ var check20 = {
     const collectRenderedLocalRefs = createRenderedLocalRefCollector(plugins);
     for (const file of files) {
       try {
-        const content = await readFile15(file, "utf8");
+        const content = await readFile16(file, "utf8");
         for (const { ref, kind, line } of collectRenderedLocalRefs(content)) {
           if (isNonFilesystemRef(ref))
             continue;
@@ -6584,15 +6984,15 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
   const rootRelative = resolve7(projectRoot, cleaned);
   switch (kind) {
     case "image":
-      return existsSync8(rootRelative);
+      return existsSync9(rootRelative);
     case "link":
-      return existsSync8(fileRelative);
+      return existsSync9(fileRelative);
   }
 }
 registerCheck(check20);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 var check21 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
@@ -6606,7 +7006,7 @@ var check21 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile16(file, "utf8");
+        const content = await readFile17(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -6650,7 +7050,7 @@ function extractImageAlts(line) {
 registerCheck(check21);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 var check22 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
@@ -6664,7 +7064,7 @@ var check22 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile17(file, "utf8");
+        const content = await readFile18(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -6700,7 +7100,7 @@ var check22 = {
 registerCheck(check22);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 var check23 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
@@ -6718,7 +7118,7 @@ var check23 = {
     const md = createMarkdownRenderer(plugins);
     for (const file of files) {
       try {
-        const content = await readFile18(file, "utf8");
+        const content = await readFile19(file, "utf8");
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
@@ -6740,8 +7140,8 @@ var check23 = {
 registerCheck(check23);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile19 } from "node:fs/promises";
-import path6 from "node:path";
+import { readFile as readFile20 } from "node:fs/promises";
+import path7 from "node:path";
 
 // src/checks/asset/extensions.ts
 var RASTER_INSPECTABLE_EXTS = [
@@ -6782,7 +7182,7 @@ var check24 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile19(file, "utf8");
+        content = await readFile20(file, "utf8");
       } catch {
         results.push(inspectionFailed(check24.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -6825,7 +7225,7 @@ var check24 = {
         ignore: [...ASSET_SCAN_IGNORE_GLOBS]
       });
       for (const sibling of siblings.sort()) {
-        const rel = path6.relative(ctx.inputDir, sibling).split(path6.sep).join("/");
+        const rel = path7.relative(ctx.inputDir, sibling).split(path7.sep).join("/");
         results.push(finding(check24.id, {
           severity: "warning",
           code: "kept-both-versions",
@@ -6845,27 +7245,27 @@ registerCheck(check24);
 import { stat as stat3 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat2, readFile as readFile20 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile21 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
-async function inspectImage(path7) {
+async function inspectImage(path8) {
   let st;
   try {
-    st = await stat2(path7);
+    st = await stat2(path8);
   } catch {
     return null;
   }
-  const hit = cache.get(path7);
+  const hit = cache.get(path8);
   if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size)
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile20(path7);
+    const buf = await readFile21(path8);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
   }
-  cache.set(path7, { mtimeMs: st.mtimeMs, size: st.size, info: info2 });
+  cache.set(path8, { mtimeMs: st.mtimeMs, size: st.size, info: info2 });
   return info2;
 }
 function parseImage(b) {
@@ -7319,7 +7719,7 @@ var check30 = {
 registerCheck(check30);
 
 // src/checks/asset/font-license.ts
-import { existsSync as existsSync9 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 import { resolve as resolve8 } from "node:path";
 var LICENSE_NAMES = [
   "LICENSE",
@@ -7355,7 +7755,7 @@ var check31 = {
     }
     const results = [];
     for (const fontDir of fontDirs) {
-      const hasLicense = LICENSE_NAMES.some((name) => existsSync9(resolve8(fontDir, name)));
+      const hasLicense = LICENSE_NAMES.some((name) => existsSync10(resolve8(fontDir, name)));
       if (!hasLicense) {
         results.push({
           checkId: check31.id,
@@ -7420,7 +7820,7 @@ var check32 = {
 registerCheck(check32);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile21 } from "node:fs/promises";
+import { readFile as readFile22 } from "node:fs/promises";
 var check33 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
@@ -7437,7 +7837,7 @@ var check33 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile21(file, "utf8");
+        const content = await readFile22(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -7877,7 +8277,7 @@ async function executeValidation(args) {
   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 && !existsSync10(pdfPath)) {
+  if (pdfPath && !existsSync11(pdfPath)) {
     throw new Error(`File not found: ${pdfPath}`);
   }
   const categories = resolveCategoryArg(typeof args.category === "string" ? args.category : undefined);
@@ -7908,10 +8308,15 @@ async function executeValidation(args) {
     const relMarkdown = await resolveActiveMarkdownFiles(manifestDir, config.source.files);
     markdownFiles = relMarkdown.map((f) => join4(manifestDir, canonicalChapterId(f)));
     const relStyles = await resolveActiveStyles(manifestDir, config.styles);
-    cssFiles = relStyles.map((rel) => resolve9(manifestDir, rel)).filter((f) => !f.endsWith(".min.css"));
+    const projectCssFiles = relStyles.map((rel) => resolve9(manifestDir, rel));
+    let pluginStylePaths = args.pluginStylePaths;
+    if (pluginStylePaths === undefined) {
+      ({ pluginStylePaths } = await loadPluginsWithCss(config.plugins, manifestDir, (ref, err) => log.warn(`Skipping plugin "${ref}" for validation — ${err.message}`)));
+    }
+    cssFiles = [...projectCssFiles, ...pluginStylePaths].filter((f) => !f.endsWith(".min.css"));
     assetDirs = [inputDir, ...await sharedAssetDirs(manifestDir, relStyles, inputDir)];
     const possibleHtml = join4(outDir, BOOK_HTML_FILENAME);
-    if (existsSync10(possibleHtml)) {
+    if (existsSync11(possibleHtml)) {
       htmlPath = possibleHtml;
     }
   }
@@ -8069,7 +8474,7 @@ function computeGates(format, opts, config) {
 }
 
 // src/lib/build-staging.ts
-import path7 from "node:path";
+import path8 from "node:path";
 import os from "node:os";
 import fsp from "node:fs/promises";
 
@@ -8252,8 +8657,8 @@ function placeholderPng(width = 640, height = 480, cell = 32) {
 
 // src/lib/build-staging.ts
 async function shipViewerHtml(htmlFile, outDir) {
-  await fsp.mkdir(path7.join(outDir, "engine"), { recursive: true });
-  await fsp.copyFile(await getAssetPath("engine/gutterpress-viewer.js"), path7.join(outDir, "engine/gutterpress-viewer.js"));
+  await fsp.mkdir(path8.join(outDir, "engine"), { recursive: true });
+  await fsp.copyFile(await getAssetPath("engine/gutterpress-viewer.js"), path8.join(outDir, "engine/gutterpress-viewer.js"));
   const tag = `  <script src="engine/gutterpress-viewer.js"></script>
 `;
   const html = await fsp.readFile(htmlFile, "utf-8");
@@ -8282,18 +8687,18 @@ async function stageBookAssets(options) {
   return { missing: [...missingPlaceholders.keys()].sort() };
 }
 async function copyReferencedAssets(copies, outDir) {
-  const dirs = new Set(copies.map((c) => path7.dirname(path7.resolve(outDir, c.to))));
+  const dirs = new Set(copies.map((c) => path8.dirname(path8.resolve(outDir, c.to))));
   await Promise.all([...dirs].map((d) => fsp.mkdir(d, { recursive: true })));
   const missing = new Map;
   await Promise.all(copies.map(async (c) => {
-    const dest = path7.resolve(outDir, c.to);
+    const dest = path8.resolve(outDir, c.to);
     try {
       await fsp.copyFile(c.from, dest);
     } catch (err) {
       if (err?.code === "ENOENT") {
         const placeholder = placeholderOutputPath(c.to);
-        const placeholderDest = path7.resolve(outDir, placeholder);
-        await fsp.mkdir(path7.dirname(placeholderDest), { recursive: true });
+        const placeholderDest = path8.resolve(outDir, placeholder);
+        await fsp.mkdir(path8.dirname(placeholderDest), { recursive: true });
         await fsp.writeFile(placeholderDest, placeholderPng());
         missing.set(c.to, placeholder);
         return;
@@ -8304,7 +8709,7 @@ async function copyReferencedAssets(copies, outDir) {
   return missing;
 }
 async function createStageRoot() {
-  return fsp.mkdtemp(path7.join(os.tmpdir(), "gutterpress-stage-"));
+  return fsp.mkdtemp(path8.join(os.tmpdir(), "gutterpress-stage-"));
 }
 
 // src/lib/build-runner.ts
@@ -8312,18 +8717,18 @@ function splitOutPath(outArg, format) {
   if (typeof outArg !== "string" || outArg.length === 0) {
     return { outDir: undefined, pdfFileOverride: null };
   }
-  const resolved = path8.resolve(outArg);
+  const resolved = path9.resolve(outArg);
   if ((format === "pdf" || format === "pdfx") && resolved.toLowerCase().endsWith(".pdf")) {
-    return { outDir: path8.dirname(resolved), pdfFileOverride: resolved };
+    return { outDir: path9.dirname(resolved), pdfFileOverride: resolved };
   }
   return { outDir: resolved, pdfFileOverride: null };
 }
 function layoutWarningKey(file, line, message) {
-  return `${path8.resolve(file)}\x00${line ?? 0}\x00${message}`;
+  return `${path9.resolve(file)}\x00${line ?? 0}\x00${message}`;
 }
 async function resolveBuildContext(opts) {
   const { format } = opts;
-  const inputDir = path8.resolve(opts.inputDir);
+  const inputDir = path9.resolve(opts.inputDir);
   const { manifest, manifestDir, manifestPath } = await loadManifestWithPath(opts.manifestPath ?? inputDir, { explicit: opts.manifestPath !== undefined });
   if (manifestPath === null) {
     throw new UsageError(`No project manifest found in ${inputDir}. Looked for ${MANIFEST_FILENAMES.join(" or ")}. ` + "Run from your project folder or pass that folder with `gutterpress build <project-dir>`. " + "For a custom manifest filename, pass `--manifest <path>`.");
@@ -8338,10 +8743,10 @@ async function resolveBuildContext(opts) {
     pdfx: pdfxConfigOverride,
     engine: opts.engine
   }, manifest);
-  const target = opts.pdfFileOverride ? { kind: "file", file: path8.resolve(opts.pdfFileOverride) } : opts.outDir ? { kind: "directory", dir: opts.outDir } : { kind: "project", dir: resolveOutputDir(manifestDir, config.title) };
-  const outDir = target.kind === "file" ? path8.dirname(target.file) : target.dir;
+  const target = opts.pdfFileOverride ? { kind: "file", file: path9.resolve(opts.pdfFileOverride) } : opts.outDir ? { kind: "directory", dir: opts.outDir } : { kind: "project", dir: resolveOutputDir(manifestDir, config.title) };
+  const outDir = target.kind === "file" ? path9.dirname(target.file) : target.dir;
   const gates = computeGates(format, opts, config);
-  const workDir = target.kind === "project" ? path8.join(path8.dirname(target.dir), `.${path8.basename(target.dir)}-build-${randomBytes(6).toString("hex")}`) : path8.join(os2.tmpdir(), `gutterpress-build-${randomBytes(6).toString("hex")}`);
+  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,
@@ -8353,15 +8758,32 @@ async function resolveBuildContext(opts) {
     manifestDir,
     config,
     gates,
-    prevalidatedLayoutWarningKeys: new Set
+    prevalidatedLayoutWarningKeys: new Set,
+    plugins: null
   };
 }
+async function loadBuildPlugins(ctx) {
+  if (ctx.plugins)
+    return ctx.plugins;
+  const { config, renderDir } = ctx;
+  if (config.plugins.length > 0) {
+    log.info(`Loading ${config.plugins.length} plugin(s)...`);
+  }
+  const loaded = await loadPluginsWithCss(config.plugins, renderDir);
+  if (loaded.plugins && loaded.plugins.length > 0) {
+    log.success(`Loaded ${loaded.plugins.length} plugin(s)`);
+  }
+  ctx.plugins = loaded;
+  return loaded;
+}
 async function runQualityGates(ctx) {
   const { gates, opts, renderDir } = ctx;
+  const pluginStylePaths = gates.lint || gates.preValidate ? (await loadBuildPlugins(ctx)).pluginStylePaths : undefined;
   if (gates.lint) {
     log.info("Lint: CSS print-safety");
     const lintResult = await runLint({
-      manifest: opts.manifestPath ?? renderDir
+      manifest: opts.manifestPath ?? renderDir,
+      pluginStylePaths
     });
     if (!lintResult.ok) {
       throw new BuildError("CSS lint failed", 2);
@@ -8372,7 +8794,8 @@ async function runQualityGates(ctx) {
     const result = await executeAndReport({
       input: renderDir,
       phase: "pre-build",
-      manifest: opts.manifestPath
+      manifest: opts.manifestPath,
+      pluginStylePaths
     }, "text");
     for (const finding2 of result.execution.report.results) {
       if (finding2.checkId === "source.markdown.layout-markers" && finding2.file && finding2.code !== "inspect-failed") {
@@ -8391,13 +8814,7 @@ async function renderBook(ctx) {
   } else {
     log.info("Using all .md files in alphabetical order");
   }
-  if (config.plugins.length > 0) {
-    log.info(`Loading ${config.plugins.length} plugin(s)...`);
-  }
-  const { plugins, pluginCss, pluginStylePaths } = await loadPluginsWithCss(config.plugins, renderDir);
-  if (plugins && plugins.length > 0) {
-    log.success(`Loaded ${plugins.length} plugin(s)`);
-  }
+  const { plugins, pluginCss, pluginStylePaths } = await loadBuildPlugins(ctx);
   const imageRefs = [];
   const cssAssets = [];
   const htmlFile = await renderChaptersToFile(renderDir, workDir, {
@@ -8409,7 +8826,7 @@ async function renderBook(ctx) {
     pluginStylePaths,
     onChapterWarnings: (file, warnings) => {
       for (const w of warnings) {
-        const key = layoutWarningKey(path8.resolve(renderDir, file), w.line, w.message);
+        const key = layoutWarningKey(path9.resolve(renderDir, file), w.line, w.message);
         if (!ctx.prevalidatedLayoutWarningKeys.has(key)) {
           log.warn(`  ${file}, line ${w.line}: ${w.message}`);
         }
@@ -8447,9 +8864,9 @@ async function renderBook(ctx) {
   return htmlFile;
 }
 async function resolveIccProfile(icc, manifestDir, explicitIccPath) {
-  const iccCandidates = path8.isAbsolute(icc) ? [icc] : [path8.resolve(manifestDir, icc), path8.resolve(icc)];
+  const iccCandidates = path9.isAbsolute(icc) ? [icc] : [path9.resolve(manifestDir, icc), path9.resolve(icc)];
   let effectiveIccPath = iccCandidates.find((candidate) => fs2.existsSync(candidate)) ?? null;
-  if (!effectiveIccPath && !explicitIccPath && path8.basename(icc) === "CGATS21_CRPC1.icc") {
+  if (!effectiveIccPath && !explicitIccPath && path9.basename(icc) === "CGATS21_CRPC1.icc") {
     effectiveIccPath = await getAssetPath("profiles/CGATS21_CRPC1.icc");
   }
   if (!effectiveIccPath) {
@@ -8465,13 +8882,13 @@ async function finalizeBuild(ctx, fingerprint, wroteMessage, paths, artifactName
   });
   await publishBuild(ctx, artifactName2);
   const delivered = ctx.target.kind !== "file";
-  const fingerprintPath = delivered ? path8.join(ctx.outDir, path8.basename(workFingerprint)) : null;
+  const fingerprintPath = delivered ? path9.join(ctx.outDir, path9.basename(workFingerprint)) : null;
   log.success(wroteMessage);
   if (fingerprintPath)
     log.info(`Fingerprint: ${fingerprintPath}`);
   return {
     outDir: ctx.outDir,
-    htmlPath: delivered ? path8.join(ctx.outDir, path8.relative(ctx.workDir, paths.htmlPath)) : null,
+    htmlPath: delivered ? path9.join(ctx.outDir, path9.relative(ctx.workDir, paths.htmlPath)) : null,
     pdfPath: paths.pdfPath,
     fingerprintPath,
     diagnostics
@@ -8482,8 +8899,8 @@ async function publishBuild(ctx, artifactName2) {
   if (target.kind === "file") {
     if (!artifactName2)
       throw new BuildError("No artifact to write for this format", 1);
-    await fsp2.mkdir(path8.dirname(target.file), { recursive: true });
-    await fsp2.copyFile(path8.join(workDir, artifactName2), target.file);
+    await fsp2.mkdir(path9.dirname(target.file), { recursive: true });
+    await fsp2.copyFile(path9.join(workDir, artifactName2), target.file);
     return;
   }
   if (target.kind === "directory") {
@@ -8492,12 +8909,12 @@ async function publishBuild(ctx, artifactName2) {
     return;
   }
   for (const name of await listPdfs(target.dir)) {
-    if (!fs2.existsSync(path8.join(workDir, name))) {
-      await fsp2.rename(path8.join(target.dir, name), path8.join(workDir, name));
+    if (!fs2.existsSync(path9.join(workDir, name))) {
+      await fsp2.rename(path9.join(target.dir, name), path9.join(workDir, name));
     }
   }
   await fsp2.rm(target.dir, { recursive: true, force: true });
-  await fsp2.mkdir(path8.dirname(target.dir), { recursive: true });
+  await fsp2.mkdir(path9.dirname(target.dir), { recursive: true });
   await fsp2.rename(workDir, target.dir);
 }
 async function listPdfs(dir) {
@@ -8513,7 +8930,7 @@ class HtmlOutput {
     const { workDir, outDir, inputDir, config, opts } = ctx;
     log.info("Shipping self-contained HTML + viewer bundle (native engine)");
     await shipViewerHtml(htmlFile, workDir);
-    await fsp2.writeFile(path8.join(workDir, "index.html"), `<!DOCTYPE html><html><head><meta charset="utf-8"><meta http-equiv="refresh" content="0;url=book.html"><title>Gutterpress</title></head><body></body></html>
+    await fsp2.writeFile(path9.join(workDir, "index.html"), `<!DOCTYPE html><html><head><meta charset="utf-8"><meta http-equiv="refresh" content="0;url=book.html"><title>Gutterpress</title></head><body></body></html>
 `, "utf-8");
     return finalizeBuild(ctx, {
       command: "build",
@@ -8526,7 +8943,7 @@ class HtmlOutput {
         iccPath: null,
         stripAnnotations: null
       }
-    }, `Wrote: ${path8.join(outDir, BOOK_HTML)}`, { htmlPath: htmlFile, pdfPath: null });
+    }, `Wrote: ${path9.join(outDir, BOOK_HTML)}`, { htmlPath: htmlFile, pdfPath: null });
   }
 }
 
@@ -8535,14 +8952,14 @@ class PdfOutput {
     const { workDir, outDir, inputDir, config, opts, format, manifestDir, gates } = ctx;
     const pdfxMode = format === "pdfx" ? opts.pdfxFlavor ?? config.pdfx.flavor : undefined;
     const pdfName = artifactName(config.title, pdfxMode ? "pdfx" : "pdf");
-    const pdfFile = path8.join(workDir, pdfName);
-    const reportedPdf = ctx.target.kind === "file" ? ctx.target.file : path8.join(outDir, pdfName);
+    const pdfFile = path9.join(workDir, pdfName);
+    const reportedPdf = ctx.target.kind === "file" ? ctx.target.file : path9.join(outDir, pdfName);
     const stage = await createStageRoot();
     try {
-      const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
-      await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
+      const rawPdf = pdfxMode ? path9.join(stage, "raw.pdf") : path9.resolve(pdfFile);
+      await fsp2.mkdir(path9.dirname(path9.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-88mynx9a.js");
+      const { buildNativePdf } = await import("./engine-db8632w6.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -8573,7 +8990,7 @@ class PdfOutput {
           await stripAnnotations(rawPdf, stage);
         }
         log.info(`Converting to CMYK PDF/X (${pdfxMode})`);
-        await convertToPdfxCmyk(rawPdf, path8.resolve(pdfFile), {
+        await convertToPdfxCmyk(rawPdf, path9.resolve(pdfFile), {
           iccPath: effectiveIccPath,
           pdfx: pdfxMode,
           title: config.title,
@@ -8633,10 +9050,10 @@ async function runBuild(opts) {
   }
 }
 // src/preview/lifecycle.ts
-import path10 from "path";
+import path11 from "path";
 import { tmpdir as tmpdir2 } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir5, readFile as readFile22, writeFile as writeFile5 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile23, writeFile as writeFile5 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -8658,7 +9075,7 @@ async function mkdir4(dirPath) {
 // src/preview/file-watcher.ts
 import { watch } from "chokidar";
 import fsp3 from "node:fs/promises";
-import path9 from "path";
+import path10 from "path";
 var EMPTY_BOOK_HTML = `<!doctype html>
 <html lang="en">
 <head>
@@ -8712,7 +9129,7 @@ function injectPreviewScripts(html, pageIsolateChapters) {
 async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets) {
   if (!inputPath) {
     cssAssets.clear();
-    await fsp3.writeFile(path9.join(tempDir, BOOK_HTML_FILENAME), EMPTY_BOOK_HTML, "utf-8");
+    await fsp3.writeFile(path10.join(tempDir, BOOK_HTML_FILENAME), EMPTY_BOOK_HTML, "utf-8");
     return;
   }
   const nextAssets = new Map;
@@ -8727,7 +9144,7 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets) {
   cssAssets.clear();
   for (const [to, from] of nextAssets)
     cssAssets.set(to, from);
-  await fsp3.writeFile(path9.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, false), "utf-8");
+  await fsp3.writeFile(path10.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, false), "utf-8");
 }
 async function renderChapterPreviewHtml(inputPath, file, config) {
   const html = await renderPreviewBook(inputPath, config, {
@@ -8739,12 +9156,12 @@ async function renderChapterPreviewHtml(inputPath, file, config) {
 function describeChanges(changes, inputResolved) {
   const files = [];
   for (const [changedPath, event] of changes) {
-    const relative2 = path9.relative(inputResolved, path9.resolve(changedPath));
-    if (relative2 === "" || relative2 === ".." || relative2.startsWith(`..${path9.sep}`) || path9.isAbsolute(relative2))
+    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: path9.extname(changedPath).toLowerCase(),
+      ext: path10.extname(changedPath).toLowerCase(),
       event
     });
   }
@@ -8796,23 +9213,23 @@ function isIgnoredWatchPath(candidatePath, projectRoot) {
   return isDotPathUnderRoot(candidatePath, projectRoot) || isGeneratedProjectPath(relative2);
 }
 function isExternalWatchCandidate(candidatePath, targets) {
-  const candidate = path9.resolve(candidatePath);
+  const candidate = path10.resolve(candidatePath);
   for (const rawTarget of targets) {
-    const target = path9.resolve(rawTarget);
-    const rel = path9.relative(candidate, target);
-    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path9.sep}`) && !path9.isAbsolute(rel))
+    const target = path10.resolve(rawTarget);
+    const rel = path10.relative(candidate, target);
+    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path10.sep}`) && !path10.isAbsolute(rel))
       return true;
   }
   return false;
 }
 async function nearestExistingDirectory(start) {
-  let current = path9.resolve(start);
+  let current = path10.resolve(start);
   while (true) {
     try {
       if ((await fsp3.stat(current)).isDirectory())
         return current;
     } catch {}
-    const parent = path9.dirname(current);
+    const parent = path10.dirname(current);
     if (parent === current)
       return current;
     current = parent;
@@ -8821,12 +9238,12 @@ async function nearestExistingDirectory(start) {
 async function externalWatchRoots(targets) {
   const roots = new Set;
   for (const target of targets) {
-    roots.add(await nearestExistingDirectory(path9.dirname(path9.resolve(target))));
+    roots.add(await nearestExistingDirectory(path10.dirname(path10.resolve(target))));
   }
   return [...roots];
 }
 async function externalWatchTargets(projectDir, config) {
-  const root = path9.resolve(projectDir);
+  const root = path10.resolve(projectDir);
   let canonicalRoot = root;
   try {
     canonicalRoot = await fsp3.realpath(root);
@@ -8834,21 +9251,21 @@ async function externalWatchTargets(projectDir, config) {
   const styles = await resolveActiveStyles(root, config.styles);
   const candidates = [
     ...await collectStyleDependencies(root, styles),
-    ...(config.plugins ?? []).map((p) => p.path).filter((p) => !!p).map((p) => path9.resolve(root, p))
+    ...(config.plugins ?? []).map((p) => p.path).filter((p) => !!p).map((p) => path10.resolve(root, p))
   ];
   const external = new Set;
   for (const abs of candidates) {
-    const authoredPath = path9.resolve(abs);
-    const authoredRel = path9.relative(root, authoredPath);
-    if (authoredRel !== "" && (authoredRel === ".." || authoredRel.startsWith(`..${path9.sep}`) || path9.isAbsolute(authoredRel))) {
+    const authoredPath = path10.resolve(abs);
+    const authoredRel = path10.relative(root, authoredPath);
+    if (authoredRel !== "" && (authoredRel === ".." || authoredRel.startsWith(`..${path10.sep}`) || path10.isAbsolute(authoredRel))) {
       external.add(authoredPath);
     }
     let canonicalPath = authoredPath;
     try {
       canonicalPath = await fsp3.realpath(canonicalPath);
     } catch {}
-    const rel = path9.relative(canonicalRoot, canonicalPath);
-    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path9.sep}`) && !path9.isAbsolute(rel))
+    const rel = path10.relative(canonicalRoot, canonicalPath);
+    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path10.sep}`) && !path10.isAbsolute(rel))
       continue;
     external.add(canonicalPath);
   }
@@ -8875,7 +9292,7 @@ async function addAndAwaitWatch(watcher, roots) {
   }
 }
 function createFileWatcher(state) {
-  const inputResolved = path9.resolve(state.currentInputPath);
+  const inputResolved = path10.resolve(state.currentInputPath);
   const watcher = watch(inputResolved, {
     persistent: true,
     ignoreInitial: true,
@@ -8915,7 +9332,7 @@ function createFileWatcher(state) {
   async function recordChange(event, filePath) {
     if (closed)
       return;
-    const target = path9.resolve(filePath);
+    const target = path10.resolve(filePath);
     const settled = settledWrites.get(target);
     if (settled && event !== "unlink" && Date.now() <= settled.expiresAt) {
       const diskContent = await fsp3.readFile(target, "utf8").catch(() => null);
@@ -8936,7 +9353,7 @@ function createFileWatcher(state) {
     recordChange(event, filePath);
   });
   externalWatcher.on("all", (event, filePath) => {
-    const target = path9.resolve(filePath);
+    const target = path10.resolve(filePath);
     if (!desiredExternals.has(target))
       return;
     if (event === "add" && suppressInitialExternalAdds.delete(target))
@@ -8944,8 +9361,8 @@ function createFileWatcher(state) {
     recordChange(event, target);
   });
   function isWatchedSource(target) {
-    const rel = path9.relative(inputResolved, target);
-    const inProject = rel === "" || rel !== ".." && !rel.startsWith(`..${path9.sep}`) && !path9.isAbsolute(rel);
+    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);
@@ -8970,7 +9387,7 @@ function createFileWatcher(state) {
   state.notifySettledWrite = (filePath, writtenContent) => {
     if (closed)
       return;
-    const target = path9.resolve(filePath);
+    const target = path10.resolve(filePath);
     if (isWatchedSource(target)) {
       acceptSettledWrite(target, writtenContent);
       return;
@@ -8991,7 +9408,7 @@ function createFileWatcher(state) {
       return;
     let nextTargets;
     try {
-      nextTargets = new Set((await externalWatchTargets(inputResolved, state.config)).map((target) => path9.resolve(target)));
+      nextTargets = new Set((await externalWatchTargets(inputResolved, state.config)).map((target) => path10.resolve(target)));
     } catch (err) {
       debug(`Could not resolve external watch targets: ${err}`);
       return;
@@ -9123,7 +9540,7 @@ async function stopFileWatcher(state) {
 }
 
 // src/preview/lifecycle.ts
-var TEMP_DIR_BASE = path10.join(tmpdir2(), "gutterpress-preview");
+var TEMP_DIR_BASE = path11.join(tmpdir2(), "gutterpress-preview");
 var PID_FILE_NAME = ".gutterpress.pid";
 function isProcessAlive(pid) {
   if (!Number.isFinite(pid) || pid <= 0)
@@ -9143,10 +9560,10 @@ async function cleanupOrphanTempDirs() {
     return;
   }
   for (const entry of entries) {
-    const dir = path10.join(TEMP_DIR_BASE, entry);
-    const pidFile = path10.join(dir, PID_FILE_NAME);
+    const dir = path11.join(TEMP_DIR_BASE, entry);
+    const pidFile = path11.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile22(pidFile, "utf8");
+      const raw = await readFile23(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -9158,10 +9575,10 @@ async function cleanupOrphanTempDirs() {
 async function initializePreviewDirectories() {
   await cleanupOrphanTempDirs();
   const tempDirSuffix = randomBytes2(8).toString("hex");
-  const tempDir = path10.join(TEMP_DIR_BASE, tempDirSuffix);
+  const tempDir = path11.join(TEMP_DIR_BASE, tempDirSuffix);
   await mkdir4(tempDir);
   debug(`Created temporary directory: ${tempDir}`);
-  await writeFile5(path10.join(tempDir, PID_FILE_NAME), `${process.pid}
+  await writeFile5(path11.join(tempDir, PID_FILE_NAME), `${process.pid}
 `, "utf8");
   return tempDir;
 }
@@ -9252,8 +9669,8 @@ function createServerState(inputPath, tempDir, config, options) {
 import http from "node:http";
 import net from "node:net";
 import { createHash as createHash6, randomUUID } from "node:crypto";
-import { readFile as readFile23, stat as stat4 } from "node:fs/promises";
-import path12 from "path";
+import { readFile as readFile24, stat as stat4 } from "node:fs/promises";
+import path13 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
 // src/lib/open-path.ts
@@ -9285,7 +9702,7 @@ function openPath(filePath) {
 }
 
 // src/lib/static-serve.ts
-import path11 from "node:path";
+import path12 from "node:path";
 var STATIC_MIME = {
   ".html": "text/html; charset=utf-8",
   ".htm": "text/html; charset=utf-8",
@@ -9307,9 +9724,9 @@ var STATIC_MIME = {
   ".otf": "font/otf"
 };
 function resolveWithinRoot(relPath, root) {
-  const resolvedRoot = path11.resolve(root);
-  const candidate = path11.resolve(resolvedRoot, "." + (relPath.startsWith("/") ? relPath : "/" + relPath));
-  if (candidate !== resolvedRoot && !candidate.startsWith(resolvedRoot + path11.sep)) {
+  const resolvedRoot = path12.resolve(root);
+  const candidate = path12.resolve(resolvedRoot, "." + (relPath.startsWith("/") ? relPath : "/" + relPath));
+  if (candidate !== resolvedRoot && !candidate.startsWith(resolvedRoot + path12.sep)) {
     return null;
   }
   return candidate;
@@ -9562,7 +9979,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   try {
     const s = await stat4(filePath);
     if (s.isDirectory())
-      filePath = path12.join(filePath, "index.html");
+      filePath = path13.join(filePath, "index.html");
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -9570,7 +9987,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile23(filePath);
+    data = await readFile24(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -9583,7 +10000,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
     res.end(withHmr);
     return;
   }
-  const ct = STATIC_MIME[path12.extname(filePath).toLowerCase()] ?? "application/octet-stream";
+  const ct = STATIC_MIME[path13.extname(filePath).toLowerCase()] ?? "application/octet-stream";
   res.writeHead(200, { "Content-Type": ct, "Cache-Control": cacheControl, ...extraHeaders });
   res.end(data);
 }
@@ -9593,7 +10010,7 @@ var EMBEDDED_CACHE_CONTROL = "public, no-cache";
 var EMBEDDED_ETAG = `"gutterpress-${PACKAGE_VERSION}"`;
 var PROJECT_ASSET_CACHE_CONTROL = "private, no-cache";
 async function serveRevalidatedStatic(req, absPath, res, validators) {
-  const extension = path12.extname(absPath).toLowerCase();
+  const extension = path13.extname(absPath).toLowerCase();
   if (extension === ".html" || extension === ".htm") {
     await serveStatic(absPath, res);
     return;
@@ -9620,7 +10037,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile23(absPath);
+      data = await readFile24(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -9759,7 +10176,7 @@ async function createPreviewServer(state, port) {
       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)) {
+      if (!file || !state.currentInputPath || !incrementalPreviewEnabled() || !Number.isSafeInteger(revision) || revision !== reloadRevision || path13.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;
@@ -9961,9 +10378,9 @@ async function startPreviewServer(options) {
 import { platform, arch, release } from "node:os";
 
 // src/lib/remote-auth/token-store.ts
-import { chmod, mkdir as mkdir5, readFile as readFile24, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
+import { chmod, mkdir as mkdir5, readFile as readFile25, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
 import os3 from "node:os";
-import path13 from "node:path";
+import path14 from "node:path";
 function credentialHostKey(hostOrUrl) {
   const trimmed = String(hostOrUrl ?? "").trim();
   if (!trimmed)
@@ -9990,22 +10407,22 @@ function defaultConfigDir() {
   if (override)
     return override;
   if (process.platform === "win32" && process.env.APPDATA) {
-    return path13.join(process.env.APPDATA, "gutterpress");
+    return path14.join(process.env.APPDATA, "gutterpress");
   }
   const xdg = process.env.XDG_CONFIG_HOME?.trim();
-  return path13.join(xdg || path13.join(os3.homedir(), ".config"), "gutterpress");
+  return path14.join(xdg || path14.join(os3.homedir(), ".config"), "gutterpress");
 }
 
 class FileTokenStore {
   filePath;
   queue = Promise.resolve();
   constructor(filePath) {
-    this.filePath = filePath ?? path13.join(defaultConfigDir(), "credentials.json");
+    this.filePath = filePath ?? path14.join(defaultConfigDir(), "credentials.json");
   }
   async read() {
     let raw;
     try {
-      raw = await readFile24(this.filePath, "utf8");
+      raw = await readFile25(this.filePath, "utf8");
     } catch (e) {
       if (e?.code === "ENOENT") {
         return { version: 1, credentials: {} };
@@ -10025,7 +10442,7 @@ class FileTokenStore {
     return { version: 1, credentials: {} };
   }
   async write(data) {
-    await mkdir5(path13.dirname(this.filePath), { recursive: true });
+    await mkdir5(path14.dirname(this.filePath), { recursive: true });
     const tmpPath = `${this.filePath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
     await writeFile6(tmpPath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
@@ -10174,18 +10591,18 @@ async function getSystemDiagnostics() {
         installHint: INSTALL_HINTS3[t.hintKey]
       };
     }
-    const [path14, available] = await Promise.all([
+    const [path15, available] = await Promise.all([
       findTool(t.bin),
       isToolAvailable(t.bin)
     ]);
-    const found = available || !!path14;
+    const found = available || !!path15;
     const version = found ? await getVersion(t.bin) : undefined;
     return {
       id: t.id,
       name: t.name,
       bin: t.bin,
       found,
-      path: path14,
+      path: path15,
       version,
       usedBy: t.usedBy,
       installHint: INSTALL_HINTS3[t.hintKey]
@@ -10205,25 +10622,25 @@ async function getSystemDiagnostics() {
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp3, mkdir as mkdir8, readdir as readdir7, readFile as readFile27, stat as stat6, writeFile as writeFile8 } from "node:fs/promises";
-import { constants as FS, existsSync as existsSync13 } from "node:fs";
-import path16 from "node:path";
+import { access, copyFile, cp as cp3, mkdir as mkdir8, readdir as readdir7, readFile as readFile28, stat as stat6, writeFile as writeFile8 } from "node:fs/promises";
+import { constants as FS, existsSync as existsSync14 } from "node:fs";
+import path17 from "node:path";
 
 // src/lib/manifest-doc.ts
-import { existsSync as existsSync11 } from "node:fs";
+import { existsSync as existsSync12 } from "node:fs";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir6, open, readFile as readFile25, rename as rename3, rm as rm2 } from "node:fs/promises";
-import path14 from "node:path";
+import { mkdir as mkdir6, open, readFile as readFile26, rename as rename3, rm as rm2 } from "node:fs/promises";
+import path15 from "node:path";
 import { parseDocument, isSeq, YAMLSeq } from "yaml";
 function resolveManifestPath(projectDir) {
-  const existing = MANIFEST_FILENAMES.find((name) => existsSync11(path14.join(projectDir, name)));
-  return path14.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
+  const existing = MANIFEST_FILENAMES.find((name) => existsSync12(path15.join(projectDir, name)));
+  return path15.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
 }
 async function loadManifestDoc(projectDir) {
   const file = resolveManifestPath(projectDir);
   let text = "";
   try {
-    text = await readFile25(file, "utf8");
+    text = await readFile26(file, "utf8");
   } catch (error2) {
     if (error2.code !== "ENOENT")
       throw error2;
@@ -10231,9 +10648,9 @@ async function loadManifestDoc(projectDir) {
   return { doc: parseDocument(text), file };
 }
 async function writeManifestDoc(file, doc) {
-  const dir = path14.dirname(file);
+  const dir = path15.dirname(file);
   await mkdir6(dir, { recursive: true });
-  const temporary = path14.join(dir, `.${path14.basename(file)}.tmp-${process.pid}-${randomUUID2()}`);
+  const temporary = path15.join(dir, `.${path15.basename(file)}.tmp-${process.pid}-${randomUUID2()}`);
   try {
     const handle = await open(temporary, "wx", 438);
     try {
@@ -10279,9 +10696,9 @@ function scalarString(item) {
 }
 
 // src/lib/theme-manager.ts
-import { cp as cp2, mkdir as mkdir7, readFile as readFile26, readdir as readdir6, stat as stat5, writeFile as writeFile7, rm as rm3 } from "node:fs/promises";
-import { existsSync as existsSync12 } from "node:fs";
-import path15 from "node:path";
+import { cp as cp2, mkdir as mkdir7, readFile as readFile27, readdir as readdir6, stat as stat5, writeFile as writeFile7, rm as rm3 } from "node:fs/promises";
+import { existsSync as existsSync13 } from "node:fs";
+import path16 from "node:path";
 import { isSeq as isSeq2, Scalar } from "yaml";
 
 // src/lib/fetch-timeout.ts
@@ -10338,29 +10755,13 @@ var BUILT_IN_FALLBACK_META = {
     description: "Clean sans-serif manual with clear hierarchy and code styling."
   }
 };
-async function readThemeMeta(jsonPath) {
-  try {
-    const text = await readFile26(jsonPath, "utf8");
-    const parsed = JSON.parse(text);
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
+var readThemeMeta = readExtensionMeta;
 function themeStyleList(meta) {
-  const declared = Array.isArray(meta.styles) ? meta.styles.filter((s) => typeof s === "string" && s.trim().length > 0) : [];
+  const declared = extensionStyleList(meta);
   return declared.length > 0 ? declared : ["theme.css"];
 }
-function assertThemeSheetsContained(meta) {
-  for (const rel of [...themeStyleList(meta), ...themeEngineStyleList(meta)]) {
-    if (path15.isAbsolute(rel) || rel.split(/[\\/]/).includes("..")) {
-      throw new Error(`theme.json declares stylesheet "${rel}" outside the theme folder; a theme must be self-contained.`);
-    }
-  }
-}
-function themeEngineStyleList(meta) {
-  return Array.isArray(meta.engineStyles?.native) ? meta.engineStyles.native.filter((s) => typeof s === "string" && s.trim().length > 0) : [];
-}
+var assertThemeSheetsContained = assertExtensionContained;
+var themeEngineStyleList = extensionEngineStyleList;
 function themeInfo(id, kind, meta) {
   const styles = themeStyleList(meta);
   return {
@@ -10371,7 +10772,10 @@ function themeInfo(id, kind, meta) {
     kind,
     preview: meta.preview ?? null,
     styles,
-    tokensFile: meta.tokensFile?.trim() || styles[0]
+    tokensFile: meta.tokensFile?.trim() || styles[0],
+    markdown: meta.markdown?.trim() || undefined,
+    components: meta.components?.trim() || undefined,
+    snippets: meta.snippets?.trim() || undefined
   };
 }
 function themeSlug(name) {
@@ -10381,14 +10785,14 @@ function themeDirFor(projectDir, id) {
   if (typeof id !== "string" || id.length === 0 || themeSlug(id) !== id) {
     throw new Error(`Invalid theme id "${id}".`);
   }
-  return path15.join(projectDir, THEMES_DIR, id);
+  return path16.join(projectDir, THEMES_DIR, id);
 }
 async function listBuiltInThemes() {
   const out = [];
   for (const id of BUILT_IN_THEME_IDS) {
     let meta = {};
     try {
-      meta = await readThemeMeta(await getAssetPath(`${THEMES_DIR}/${id}/theme.json`));
+      meta = await readThemeMeta(path16.join(await getAssetsDir(), THEMES_DIR, id));
     } catch {
       meta = {};
     }
@@ -10406,20 +10810,19 @@ async function resolveBuiltInTheme(id) {
     throw new Error(`Unknown built-in theme: "${id}".`);
   }
   const cssPath = await getAssetPath(`${THEMES_DIR}/${id}/theme.css`);
-  const jsonPath = await getAssetPath(`${THEMES_DIR}/${id}/theme.json`);
-  if (!existsSync12(cssPath)) {
+  if (!existsSync13(cssPath)) {
     throw new Error(`Built-in theme "${id}" is missing its theme.css.`);
   }
-  const meta = await readThemeMeta(jsonPath);
+  const meta = await readThemeMeta(path16.join(await getAssetsDir(), THEMES_DIR, id));
   if (!meta.name)
     meta.name = BUILT_IN_FALLBACK_META[id]?.name;
   if (!meta.description) {
     meta.description = BUILT_IN_FALLBACK_META[id]?.description;
   }
-  return { info: themeInfo(id, "builtin", meta), cssPath, dir: path15.dirname(cssPath) };
+  return { info: themeInfo(id, "builtin", meta), cssPath, dir: path16.dirname(cssPath) };
 }
 async function listProjectThemes(projectDir) {
-  const root = path15.join(projectDir, THEMES_DIR);
+  const root = path16.join(projectDir, THEMES_DIR);
   let entries;
   try {
     entries = await readdir6(root, { withFileTypes: true });
@@ -10430,10 +10833,10 @@ async function listProjectThemes(projectDir) {
   for (const entry of entries) {
     if (!entry.isDirectory())
       continue;
-    const dir = path15.join(root, entry.name);
-    const meta = await readThemeMeta(path15.join(dir, "theme.json"));
+    const dir = path16.join(root, entry.name);
+    const meta = await readThemeMeta(dir);
     const primary = themeStyleList(meta)[0];
-    if (!existsSync12(path15.join(dir, primary)))
+    if (!existsSync13(path16.join(dir, primary)))
       continue;
     out.push(themeInfo(entry.name, "project", meta));
   }
@@ -10484,10 +10887,10 @@ async function getActiveTheme(projectDir) {
     if (!m)
       continue;
     const id = m[1];
-    const dir = path15.join(projectDir, THEMES_DIR, id);
-    const meta = await readThemeMeta(path15.join(dir, "theme.json"));
+    const dir = path16.join(projectDir, THEMES_DIR, id);
+    const meta = await readThemeMeta(dir);
     const primary = themeStyleList(meta)[0];
-    if (!existsSync12(path15.join(dir, primary)))
+    if (!existsSync13(path16.join(dir, primary)))
       continue;
     return themeInfo(id, "project", meta);
   }
@@ -10525,9 +10928,9 @@ async function getPreviousTheme(projectDir) {
   if (!id)
     return null;
   const dir = themeDirFor(projectDir, id);
-  const meta = await readThemeMeta(path15.join(dir, "theme.json"));
+  const meta = await readThemeMeta(dir);
   const primary = themeStyleList(meta)[0];
-  if (!existsSync12(path15.join(dir, primary)))
+  if (!existsSync13(path16.join(dir, primary)))
     return null;
   const active = await getActiveTheme(projectDir);
   if (active && active.id === id)
@@ -10547,23 +10950,23 @@ async function applyTheme(projectDir, target) {
   if (target.kind === "builtin") {
     const resolved = await resolveBuiltInTheme(target.id);
     let destId = target.id;
-    if (existsSync12(path15.join(projectDir, THEMES_DIR, destId, "theme.css"))) {
+    if (existsSync13(path16.join(projectDir, THEMES_DIR, destId, "theme.css"))) {
       destId = await uniqueThemeId(projectDir, target.id);
     }
-    const destDir = path15.join(projectDir, THEMES_DIR, destId);
+    const destDir = path16.join(projectDir, THEMES_DIR, destId);
     await mkdir7(destDir, { recursive: true });
     await cp2(resolved.dir, destDir, { recursive: true });
-    meta = await readThemeMeta(path15.join(destDir, "theme.json"));
+    meta = await readThemeMeta(destDir);
     assertThemeSheetsContained(meta);
     resolveDeclaredStyles(themeStyleList(meta), destDir, `Theme "${destId}"`);
     resolveDeclaredStyles(themeEngineStyleList(meta), destDir, `Theme "${destId}"`);
     info2 = themeInfo(destId, "project", meta);
   } else {
     const dir = themeDirFor(projectDir, target.id);
-    meta = await readThemeMeta(path15.join(dir, "theme.json"));
+    meta = await readThemeMeta(dir);
     assertThemeSheetsContained(meta);
     const primary = themeStyleList(meta)[0];
-    if (!existsSync12(path15.join(dir, primary))) {
+    if (!existsSync13(path16.join(dir, primary))) {
       throw new Error(`Theme "${target.id}" is not present in this project.`);
     }
     resolveDeclaredStyles(themeStyleList(meta), dir, `Theme "${target.id}"`);
@@ -10574,10 +10977,10 @@ async function applyTheme(projectDir, target) {
   return info2;
 }
 async function uniqueThemeId(projectDir, base) {
-  const root = path15.join(projectDir, THEMES_DIR);
+  const root = path16.join(projectDir, THEMES_DIR);
   let id = themeSlug(base);
   let n = 2;
-  while (existsSync12(path15.join(root, id))) {
+  while (existsSync13(path16.join(root, id))) {
     id = `${themeSlug(base)}-${n++}`;
   }
   return id;
@@ -10592,20 +10995,20 @@ async function importThemeFromFolder(projectDir, sourceDir) {
   if (!info2.isDirectory()) {
     throw new Error("The chosen path is not a folder.");
   }
-  const meta = await readThemeMeta(path15.join(sourceDir, "theme.json"));
+  const meta = await readThemeMeta(sourceDir);
   assertThemeSheetsContained(meta);
   const primary = themeStyleList(meta)[0];
-  if (!existsSync12(path15.join(sourceDir, primary))) {
+  if (!existsSync13(path16.join(sourceDir, primary))) {
     throw new Error(primary === "theme.css" ? "A theme folder must contain a theme.css file." : `A theme folder must contain its declared stylesheet: ${primary}`);
   }
   resolveDeclaredStyles(themeStyleList(meta), sourceDir, "The theme folder");
   resolveDeclaredStyles(themeEngineStyleList(meta), sourceDir, "The theme folder");
-  const base = meta.name || path15.basename(sourceDir);
+  const base = meta.name || path16.basename(sourceDir);
   const id = await uniqueThemeId(projectDir, base);
-  const destDir = path15.join(projectDir, THEMES_DIR, id);
-  await mkdir7(path15.dirname(destDir), { recursive: true });
+  const destDir = path16.join(projectDir, THEMES_DIR, id);
+  await mkdir7(path16.dirname(destDir), { recursive: true });
   await cp2(sourceDir, destDir, { recursive: true });
-  return themeInfo(id, "project", await readThemeMeta(path15.join(destDir, "theme.json")));
+  return themeInfo(id, "project", await readThemeMeta(destDir));
 }
 function looksLikeCssUrl(url) {
   try {
@@ -10652,7 +11055,7 @@ async function importThemeFromUrl(projectDir, url) {
   let baseName;
   if (looksLikeCssUrl(trimmed)) {
     css = await fetchText(trimmed);
-    baseName = path15.basename(new URL(trimmed, "https://x/").pathname, ".css") || "theme";
+    baseName = path16.basename(new URL(trimmed, "https://x/").pathname, ".css") || "theme";
   } else {
     const base = trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
     css = await fetchText(`${base}theme.css`);
@@ -10662,41 +11065,41 @@ async function importThemeFromUrl(projectDir, url) {
       if (parsed && typeof parsed === "object")
         meta = parsed;
     } catch {}
-    baseName = meta.name || path15.basename(new URL(base, "https://x/").pathname.replace(/\/$/, "")) || "theme";
+    baseName = meta.name || path16.basename(new URL(base, "https://x/").pathname.replace(/\/$/, "")) || "theme";
   }
   if (!css.trim()) {
     throw new Error(`Fetched theme CSS from ${trimmed} was empty.`);
   }
   assertLooksLikeCss(css, trimmed);
   const id = await uniqueThemeId(projectDir, meta.name || baseName);
-  const destDir = path15.join(projectDir, THEMES_DIR, id);
+  const destDir = path16.join(projectDir, THEMES_DIR, id);
   await mkdir7(destDir, { recursive: true });
-  await writeFile7(path15.join(destDir, "theme.css"), css, "utf8");
+  await writeFile7(path16.join(destDir, "theme.css"), css, "utf8");
   const finalMeta = {
     name: meta.name || prettify(id),
     author: meta.author,
     description: meta.description,
     preview: meta.preview ?? null
   };
-  await writeFile7(path15.join(destDir, "theme.json"), JSON.stringify(finalMeta, null, 2), "utf8");
+  await writeFile7(path16.join(destDir, "theme.json"), JSON.stringify(finalMeta, null, 2), "utf8");
   return themeInfo(id, "project", finalMeta);
 }
 async function readThemeCss(projectDir, source) {
   if (source.kind === "builtin") {
     const resolved = await resolveBuiltInTheme(source.id);
-    return readFile26(resolved.cssPath, "utf8");
+    return readFile27(resolved.cssPath, "utf8");
   }
   if (!projectDir)
     throw new Error("A project is required to read a project theme.");
   const dir = themeDirFor(projectDir, source.id);
-  const meta = await readThemeMeta(path15.join(dir, "theme.json"));
+  const meta = await readThemeMeta(dir);
   const sheets = themeStyleList(meta);
   const parts = [];
   for (const rel of sheets) {
-    const sheetPath = path15.join(dir, rel);
-    if (!existsSync12(sheetPath))
+    const sheetPath = path16.join(dir, rel);
+    if (!existsSync13(sheetPath))
       continue;
-    parts.push(await readFile26(sheetPath, "utf8"));
+    parts.push(await readFile27(sheetPath, "utf8"));
   }
   if (parts.length === 0) {
     throw new Error(`Theme "${source.id}" has no ${sheets[0]} in this project.`);
@@ -10707,7 +11110,7 @@ async function readThemeCss(projectDir, source) {
 }
 async function removeProjectTheme(projectDir, id) {
   const dir = themeDirFor(projectDir, id);
-  if (existsSync12(dir)) {
+  if (existsSync13(dir)) {
     await rm3(dir, { recursive: true, force: true });
   }
   const { doc, file } = await loadManifestDoc(projectDir);
@@ -10745,7 +11148,7 @@ async function detectLegacyForkedTheme(projectDir, active) {
     return null;
   let bookCss;
   try {
-    bookCss = await readFile26(path15.join(projectDir, "styles", "book.css"), "utf8");
+    bookCss = await readFile27(path16.join(projectDir, "styles", "book.css"), "utf8");
   } catch {
     return null;
   }
@@ -10844,7 +11247,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 || !path16.isAbsolute(parentDir)) {
+  if (!parentDir || !path17.isAbsolute(parentDir)) {
     throw new CreateProjectErrorImpl("parent-not-writable", "The save location must be an absolute path.");
   }
   try {
@@ -10852,7 +11255,7 @@ async function scaffoldProject(options) {
   } catch {
     throw new CreateProjectErrorImpl("parent-not-writable", `The chosen save location can't be written to: ${parentDir}`);
   }
-  const projectDir = path16.join(parentDir, folderName);
+  const projectDir = path17.join(parentDir, folderName);
   let targetExists = true;
   try {
     await access(projectDir, FS.F_OK);
@@ -10874,17 +11277,17 @@ async function scaffoldProject(options) {
       for (const entry of entries) {
         if (entry.name === ".gutterpress-template.json")
           continue;
-        await cp3(path16.join(customTemplateDir, entry.name), path16.join(projectDir, entry.name), { recursive: true });
+        await cp3(path17.join(customTemplateDir, entry.name), path17.join(projectDir, entry.name), { recursive: true });
       }
-      await mkdir8(path16.join(projectDir, "assets"), { recursive: true });
+      await mkdir8(path17.join(projectDir, "assets"), { recursive: true });
     } else {
       const tplManifest = await getAssetPath(`templates/${template}/manifest.yaml`);
       const tplChapter = await getAssetPath(`templates/${template}/chapter-01.md`);
-      await mkdir8(path16.join(projectDir, "assets"), { recursive: true });
-      await copyFile(tplManifest, path16.join(projectDir, MANIFEST_FILENAMES[0]));
-      await copyFile(tplChapter, path16.join(projectDir, "chapter-01.md"));
-      await mkdir8(path16.join(projectDir, "styles"), { recursive: true });
-      await writeFile8(path16.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
+      await mkdir8(path17.join(projectDir, "assets"), { recursive: true });
+      await copyFile(tplManifest, path17.join(projectDir, MANIFEST_FILENAMES[0]));
+      await copyFile(tplChapter, path17.join(projectDir, "chapter-01.md"));
+      await mkdir8(path17.join(projectDir, "styles"), { recursive: true });
+      await writeFile8(path17.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
     }
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not create the project files: ${e instanceof Error ? e.message : String(e)}`);
@@ -10894,13 +11297,13 @@ 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) => path16.join(projectDir, name2)).find(existsSync13) ?? path16.join(projectDir, MANIFEST_FILENAMES[0]);
+  const manifestPath = MANIFEST_FILENAMES.map((name2) => path17.join(projectDir, name2)).find(existsSync14) ?? path17.join(projectDir, MANIFEST_FILENAMES[0]);
   const author = (options.author ?? "").trim() || DEFAULT_AUTHOR;
   const substitutions = {
     "{{TITLE}}": escapeYamlScalar(name),
     "{{AUTHOR}}": escapeYamlScalar(author)
   };
-  let openFile = path16.join(projectDir, "chapter-01.md");
+  let openFile = path17.join(projectDir, "chapter-01.md");
   try {
     await fillTemplateFile(manifestPath, substitutions);
     if (!customTemplateDir) {
@@ -10924,7 +11327,7 @@ async function scaffoldProject(options) {
     }
     const firstSource = await firstSourceFile(manifestPath);
     if (firstSource)
-      openFile = path16.join(projectDir, firstSource);
+      openFile = path17.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)}`);
@@ -10946,7 +11349,7 @@ async function scaffoldProject(options) {
       versionHistory = "none";
       const { findEnclosingRepoDir } = await import("./project-source-ekcyp63q.js");
       const enclosingRepoDir = await findEnclosingRepoDir(projectDir);
-      versionHistoryError = enclosingRepoDir ? `This book was added to ${path16.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 ${path17.basename(enclosingRepoDir)}'s shared version history; save a snapshot to record it.` : e instanceof Error ? e.message : String(e);
     }
   }
   const result = {
@@ -10966,7 +11369,7 @@ function prettifyFolderName(base) {
 }
 async function adoptFolder(options) {
   const dir = options.dir;
-  if (typeof dir !== "string" || !path16.isAbsolute(dir)) {
+  if (typeof dir !== "string" || !path17.isAbsolute(dir)) {
     throw new CreateProjectErrorImpl("scaffold-io", "An absolute folder path is required.");
   }
   let st;
@@ -10978,11 +11381,11 @@ async function adoptFolder(options) {
   if (!st.isDirectory()) {
     throw new CreateProjectErrorImpl("scaffold-io", `Not a folder: ${dir}`);
   }
-  if (MANIFEST_FILENAMES.some((name) => existsSync13(path16.join(dir, name)))) {
+  if (MANIFEST_FILENAMES.some((name) => existsSync14(path17.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(path16.basename(dir));
+  const title = (options.title ?? "").trim() || prettifyFolderName(path17.basename(dir));
   const author = (options.author ?? "").trim() || DEFAULT_AUTHOR;
   let mdFiles;
   try {
@@ -10990,14 +11393,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, path16.join(dir, "chapter-01.md"));
-      await fillTemplateFile(path16.join(dir, "chapter-01.md"), { "{{TITLE}}": title }).catch(() => {});
+      await copyFile(tplChapter, path17.join(dir, "chapter-01.md"));
+      await fillTemplateFile(path17.join(dir, "chapter-01.md"), { "{{TITLE}}": title }).catch(() => {});
       mdFiles = ["chapter-01.md"];
     }
     const themeId = STARTER_THEME_FOR_TEMPLATE[template] ?? "clean-book";
-    await mkdir8(path16.join(dir, "styles"), { recursive: true });
-    const bookCssPath = path16.join(dir, "styles", "book.css");
-    const hadOwnStylesheet = existsSync13(bookCssPath);
+    await mkdir8(path17.join(dir, "styles"), { recursive: true });
+    const bookCssPath = path17.join(dir, "styles", "book.css");
+    const hadOwnStylesheet = existsSync14(bookCssPath);
     if (!hadOwnStylesheet) {
       await writeFile8(bookCssPath, starterOverridesCss(themeId), "utf8");
     }
@@ -11015,8 +11418,8 @@ ${filesYaml}
 styles:
   - styles/book.css
 `;
-    await writeFile8(path16.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
-    await mkdir8(path16.join(dir, "assets"), { recursive: true });
+    await writeFile8(path17.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
+    await mkdir8(path17.join(dir, "assets"), { recursive: true });
     if (!hadOwnStylesheet) {
       await applyTheme(dir, { kind: "builtin", id: themeId });
     }
@@ -11046,8 +11449,8 @@ styles:
   }
   const result = {
     projectDir: dir,
-    manifestPath: path16.join(dir, MANIFEST_FILENAMES[0]),
-    openFile: path16.join(dir, mdFiles[0]),
+    manifestPath: path17.join(dir, MANIFEST_FILENAMES[0]),
+    openFile: path17.join(dir, mdFiles[0]),
     versionHistory
   };
   if (versionHistoryError !== undefined)
@@ -11055,10 +11458,10 @@ styles:
   return result;
 }
 async function ensureGitignoreHasDist(projectDir) {
-  const gitignorePath = path16.join(projectDir, ".gitignore");
+  const gitignorePath = path17.join(projectDir, ".gitignore");
   let existing = null;
   try {
-    existing = await readFile27(gitignorePath, "utf8");
+    existing = await readFile28(gitignorePath, "utf8");
   } catch {}
   if (existing === null) {
     await writeFile8(gitignorePath, `dist/
@@ -11078,7 +11481,7 @@ async function ensureGitignoreHasDist(projectDir) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile27(manifestPath, "utf8");
+    text = await readFile28(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -11090,17 +11493,161 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile27(filePath, "utf8");
+  let text = await readFile28(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
   await writeFile8(filePath, text, "utf8");
 }
+// src/lib/extension-scaffold.ts
+import { access as access2, mkdir as mkdir9, readFile as readFile29, writeFile as writeFile9 } from "node:fs/promises";
+import { constants as FS2 } from "node:fs";
+import path18 from "node:path";
+var EXTENSION_KINDS = ["plugin", "theme"];
+var RESERVED_PREFIX = "gp-";
+var TEMPLATE_FILES = {
+  plugin: [
+    ["gutterpress.json", "gutterpress.json"],
+    ["package.json", "package.json"],
+    ["README.md", "README.md"],
+    ["plugin.js.tpl", "plugin.js"],
+    ["styles/plugin.css", "styles/plugin.css"],
+    ["snippets/term-box.md", "snippets/term-box.md"],
+    ["test/fixture.md", "test/fixture.md"],
+    ["test/expected.html", "test/expected.html"],
+    ["test/plugin.test.js.tpl", "test/plugin.test.js"]
+  ],
+  theme: [
+    ["gutterpress.json", "gutterpress.json"],
+    ["README.md", "README.md"],
+    ["components.yaml", "components.yaml"],
+    ["snippets/callout.md", "snippets/callout.md"],
+    ["styles/tokens.css", "styles/tokens.css"],
+    ["styles/base.css", "styles/base.css"],
+    ["styles/components.css", "styles/components.css"],
+    ["styles/page-templates.css", "styles/page-templates.css"],
+    ["styles/page-rules.css", "styles/page-rules.css"],
+    ["styles/book.css", "styles/book.css"]
+  ]
+};
+var OPEN_FILE = {
+  plugin: "plugin.js",
+  theme: "styles/tokens.css"
+};
+var DEFAULT_DESCRIPTION = {
+  plugin: "A Gutterpress plugin.",
+  theme: "A Gutterpress theme."
+};
+var DEFAULT_AUTHOR2 = "Anonymous";
+
+class ExtensionScaffoldError extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "CreateProjectError";
+    this.code = code;
+  }
+}
+function resolveExtensionPrefix(slug, requested) {
+  const raw = (requested ?? `${slug}-`).trim();
+  const prefix = raw.endsWith("-") ? raw : `${raw}-`;
+  if (!/^[a-z][a-z0-9-]*-$/.test(prefix)) {
+    throw new ExtensionScaffoldError("invalid-name", `"${raw}" is not a usable prefix. Use lower-case letters, digits and hyphens, ` + `starting with a letter — for example "${slug}-" or "fn-".`);
+  }
+  if (prefix === RESERVED_PREFIX) {
+    throw new ExtensionScaffoldError("invalid-name", `"${RESERVED_PREFIX}" is reserved for Gutterpress core's own classes and custom ` + `properties. Taking it would silently override them — choose your own prefix.`);
+  }
+  return prefix;
+}
+function identifierFor(slug) {
+  const camel = slug.replace(/-([a-z0-9])/g, (_m, c) => c.toUpperCase());
+  return /^[0-9]/.test(camel) ? `_${camel}` : camel;
+}
+function escapeJsonScalar(value) {
+  return JSON.stringify(value).slice(1, -1);
+}
+async function scaffoldExtension(options) {
+  const kind = options.kind;
+  if (kind !== "plugin" && kind !== "theme") {
+    throw new ExtensionScaffoldError("invalid-name", `Unknown extension kind "${String(kind)}". Choose one of: ${EXTENSION_KINDS.join(", ")}.`);
+  }
+  const name = (options.name ?? "").trim();
+  if (!name) {
+    throw new ExtensionScaffoldError("invalid-name", "A name is required.");
+  }
+  const slug = (options.folderName ?? slugify(name)).trim();
+  if (!slug || slug !== slugify(slug)) {
+    throw new ExtensionScaffoldError("invalid-name", `Could not derive a valid folder name from "${name}".`);
+  }
+  const prefix = resolveExtensionPrefix(slug, options.prefix);
+  const parentDir = options.parentDir;
+  if (!parentDir || !path18.isAbsolute(parentDir)) {
+    throw new ExtensionScaffoldError("parent-not-writable", "The save location must be an absolute path.");
+  }
+  try {
+    await access2(parentDir, FS2.W_OK);
+  } catch {
+    throw new ExtensionScaffoldError("parent-not-writable", `The chosen save location can't be written to: ${parentDir}`);
+  }
+  const extensionDir = path18.join(parentDir, slug);
+  let targetExists = true;
+  try {
+    await access2(extensionDir, FS2.F_OK);
+  } catch {
+    targetExists = false;
+  }
+  if (targetExists) {
+    throw new ExtensionScaffoldError("target-exists", `A folder named "${slug}" already exists here. Choose a different name or location.`);
+  }
+  const author = (options.author ?? "").trim() || DEFAULT_AUTHOR2;
+  const description = (options.description ?? "").trim() || DEFAULT_DESCRIPTION[kind];
+  const plain = {
+    "{{NAME}}": name,
+    "{{SLUG}}": slug,
+    "{{PREFIX}}": prefix,
+    "{{AUTHOR}}": author,
+    "{{DESCRIPTION}}": description,
+    "{{IDENT}}": identifierFor(slug)
+  };
+  const jsonSafe = Object.fromEntries(Object.entries(plain).map(([token, value]) => [token, escapeJsonScalar(value)]));
+  const entries = TEMPLATE_FILES[kind];
+  const written = [];
+  try {
+    await mkdir9(extensionDir, { recursive: true });
+    for (const [assetName, relDest] of entries) {
+      const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
+      const dest = path18.join(extensionDir, relDest);
+      await mkdir9(path18.dirname(dest), { recursive: true });
+      const text = await readFile29(src, "utf8");
+      const table = relDest.endsWith(".json") ? jsonSafe : plain;
+      await writeFile9(dest, substitute(text, table), "utf8");
+      written.push(relDest);
+    }
+  } catch (e) {
+    throw new ExtensionScaffoldError("scaffold-io", `Could not create the ${kind} files: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  return {
+    extensionDir,
+    manifestPath: path18.join(extensionDir, "gutterpress.json"),
+    kind,
+    slug,
+    prefix,
+    openFile: path18.join(extensionDir, OPEN_FILE[kind]),
+    files: written
+  };
+}
+function substitute(text, table) {
+  let out = text;
+  for (const [token, value] of Object.entries(table)) {
+    out = out.split(token).join(value);
+  }
+  return out;
+}
 // src/lib/project-templates.ts
-import { cp as cp4, mkdir as mkdir9, readFile as readFile28, readdir as readdir8, stat as stat7, 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 path17 from "node:path";
+import { cp as cp4, mkdir as mkdir10, readFile as readFile30, readdir as readdir8, stat as stat7, writeFile as writeFile10 } from "node:fs/promises";
+import { constants as FS3, existsSync as existsSync15 } from "node:fs";
+import { access as access3 } from "node:fs/promises";
+import path19 from "node:path";
 import { isMap, isScalar, isSeq as isSeq3, parseDocument as parseDocument2 } from "yaml";
 var BUILT_IN_TEMPLATE_IDS = [
   "book",
@@ -11109,7 +11656,7 @@ var BUILT_IN_TEMPLATE_IDS = [
 ];
 async function readTemplateChoices(manifestPath) {
   try {
-    const text = await readFile28(manifestPath, "utf8");
+    const text = await readFile30(manifestPath, "utf8");
     const doc = parseDocument2(text);
     const out = {};
     const preset = doc.get("preset");
@@ -11184,7 +11731,7 @@ function rewriteEntry(node, newPath) {
     node.value = newPath;
 }
 function commonAncestorDir(absFiles) {
-  const dirSegs = absFiles.map((f) => path17.resolve(f).split(path17.sep).slice(0, -1));
+  const dirSegs = absFiles.map((f) => path19.resolve(f).split(path19.sep).slice(0, -1));
   if (dirSegs.length === 0)
     return "";
   let common = dirSegs[0];
@@ -11194,22 +11741,22 @@ function commonAncestorDir(absFiles) {
       i++;
     common = common.slice(0, i);
   }
-  return common.join(path17.sep) || path17.sep;
+  return common.join(path19.sep) || path19.sep;
 }
 function pickVendorDir(templateDir, base) {
-  const preferred = path17.basename(base) || VENDOR_DIR;
-  if (!existsSync14(path17.join(templateDir, preferred)))
+  const preferred = path19.basename(base) || VENDOR_DIR;
+  if (!existsSync15(path19.join(templateDir, preferred)))
     return preferred;
   for (let n = 1;; n++) {
     const candidate = `${preferred}-${n}`;
-    if (!existsSync14(path17.join(templateDir, candidate)))
+    if (!existsSync15(path19.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, path17.resolve(sourceProjectDir, p));
+  const escapes = (p) => escapesProjectRoot(sourceProjectDir, path19.resolve(sourceProjectDir, p));
   const stylesSeq = doc.get("styles", true);
   const pluginsSeq = doc.get("plugins", true);
   const escapingStyles = collectEscaping(isSeq3(stylesSeq) ? stylesSeq.items : [], scalarString, escapes);
@@ -11225,16 +11772,16 @@ async function reconcileSharedRefs(templateDir, sourceProjectDir, mode) {
     return { vendoredRefs: [], excludedRefs };
   }
   const styleClosure = await collectStyleDependencies(sourceProjectDir, escapingStyles.map((s) => s.value));
-  const pluginFiles = escapingPlugins.map((p) => path17.resolve(sourceProjectDir, p.value));
+  const pluginFiles = escapingPlugins.map((p) => path19.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((abs) => existsSync14(abs)).map(async (abs) => {
-    const dest = path17.join(templateDir, vendorDir, path17.relative(base, abs));
-    await mkdir9(path17.dirname(dest), { recursive: true });
+  await Promise.all(externalFiles.filter((abs) => existsSync15(abs)).map(async (abs) => {
+    const dest = path19.join(templateDir, vendorDir, path19.relative(base, abs));
+    await mkdir10(path19.dirname(dest), { recursive: true });
     await cp4(abs, dest);
   }));
-  const bookLocal = (value) => toPosixPath(path17.join(vendorDir, path17.relative(base, path17.resolve(sourceProjectDir, value))));
+  const bookLocal = (value) => toPosixPath(path19.join(vendorDir, path19.relative(base, path19.resolve(sourceProjectDir, value))));
   const vendoredRefs = [];
   for (const { node, value } of [...escapingStyles, ...escapingPlugins]) {
     const rewritten = bookLocal(value);
@@ -11249,30 +11796,30 @@ async function saveProjectAsTemplate(options) {
   const id = slugify(name);
   if (!id)
     throw new Error(`Could not derive a template id from "${name}".`);
-  const dir = path17.join(templatesRoot, id);
+  const dir = path19.join(templatesRoot, id);
   let exists = true;
   try {
-    await access2(dir, FS2.F_OK);
+    await access3(dir, FS3.F_OK);
   } catch {
     exists = false;
   }
   if (exists) {
     throw new Error(`A template named "${name}" already exists. Choose a different name.`);
   }
-  await mkdir9(dir, { recursive: true });
+  await mkdir10(dir, { recursive: true });
   const entries = await readdir8(projectDir, { withFileTypes: true });
   for (const entry of entries) {
     if (SKIP_ENTRIES.has(entry.name))
       continue;
     if (entry.name === TEMPLATE_META_FILE)
       continue;
-    await cp4(path17.join(projectDir, entry.name), path17.join(dir, entry.name), { recursive: true });
+    await cp4(path19.join(projectDir, entry.name), path19.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(path17.join(dir, manifestName));
-  await writeFile9(path17.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
+    await retokeniseManifest(path19.join(dir, manifestName));
+  await writeFile10(path19.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
   return {
     id,
     label: name,
@@ -11285,12 +11832,12 @@ async function saveProjectAsTemplate(options) {
 async function retokeniseManifest(manifestPath) {
   let text;
   try {
-    text = await readFile28(manifestPath, "utf8");
+    text = await readFile30(manifestPath, "utf8");
   } catch {
     return;
   }
   text = text.replace(/^title:\s*.*$/m, 'title: "{{TITLE}}"').replace(/^(authors:[^\n]*\n[ \t]*-[ \t]*).*$/m, '$1"{{AUTHOR}}"');
-  await writeFile9(manifestPath, text, "utf8");
+  await writeFile10(manifestPath, text, "utf8");
 }
 async function listCustomTemplates(templatesRoot) {
   let entries;
@@ -11303,10 +11850,10 @@ async function listCustomTemplates(templatesRoot) {
   for (const entry of entries) {
     if (!entry.isDirectory())
       continue;
-    const dir = path17.join(templatesRoot, entry.name);
+    const dir = path19.join(templatesRoot, entry.name);
     let label = prettify(entry.name);
     try {
-      const meta = JSON.parse(await readFile28(path17.join(dir, TEMPLATE_META_FILE), "utf8"));
+      const meta = JSON.parse(await readFile30(path19.join(dir, TEMPLATE_META_FILE), "utf8"));
       if (typeof meta.label === "string" && meta.label)
         label = meta.label;
     } catch {}
@@ -11316,7 +11863,7 @@ async function listCustomTemplates(templatesRoot) {
       description: "Your saved template.",
       kind: "custom",
       dir,
-      ...await readTemplateChoices(path17.join(dir, MANIFEST_FILENAMES[0]))
+      ...await readTemplateChoices(path19.join(dir, MANIFEST_FILENAMES[0]))
     });
   }
   out.sort((a, b) => a.label.localeCompare(b.label));
@@ -11328,84 +11875,17 @@ async function importTemplateFromFolder(options) {
   if (!srcStat.isDirectory()) {
     throw new Error("The chosen path is not a folder.");
   }
-  const name = options.name?.trim() || prettify(path17.basename(sourceDir));
+  const name = options.name?.trim() || prettify(path19.basename(sourceDir));
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir9, readFile as readFile29, writeFile as writeFile10, mkdir as mkdir10, rm as rm4 } from "node:fs/promises";
-import path18 from "node:path";
-var SNIPPETS_DIR = "snippets";
-var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
-function extractVariables(template) {
-  const seen = new Set;
-  const order = [];
-  for (const m of template.matchAll(PLACEHOLDER_RE)) {
-    const name = m[1];
-    if (!seen.has(name)) {
-      seen.add(name);
-      order.push(name);
-    }
-  }
-  return order;
-}
-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 = path18.resolve(projectDir, SNIPPETS_DIR);
-  const full = path18.resolve(dir, fileName);
-  if (full !== path18.join(dir, path18.basename(fileName)) || path18.dirname(full) !== dir) {
-    throw new Error(`Unsafe snippet filename: ${fileName}`);
-  }
-  return full;
-}
-async function listSnippets(projectDir) {
-  const dir = path18.join(projectDir, SNIPPETS_DIR);
-  let names;
-  try {
-    names = await readdir9(dir);
-  } catch {
-    return [];
-  }
-  const entries = [];
-  for (const fileName of names) {
-    if (!fileName.toLowerCase().endsWith(".md"))
-      continue;
-    let body = "";
-    try {
-      body = await readFile29(path18.join(dir, fileName), "utf8");
-    } catch {
-      continue;
-    }
-    entries.push({
-      name: prettify(fileName.replace(/\.md$/i, "")),
-      fileName,
-      variables: extractVariables(body)
-    });
-  }
-  entries.sort((a, b) => a.name.localeCompare(b.name));
-  return entries;
-}
-async function readSnippet(projectDir, fileName) {
-  return readFile29(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 = path18.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 rm4(resolveSnippetPath(projectDir, fileName), { force: true });
-}
+import { readdir as readdir9, readFile as readFile32, writeFile as writeFile11, mkdir as mkdir13, rm as rm6, stat as stat9 } from "node:fs/promises";
+import path22 from "node:path";
+
 // src/lib/plugin-manager.ts
 import { randomUUID as randomUUID4 } from "node:crypto";
-import { cp as cp5, lstat as lstat3, mkdir as mkdir12, rename as rename5, rm as rm6, stat as stat8 } from "node:fs/promises";
-import path20 from "node:path";
+import { cp as cp5, lstat as lstat3, mkdir as mkdir12, rename as rename5, rm as rm5, stat as stat8 } from "node:fs/promises";
+import path21 from "node:path";
 import { isSeq as isSeq4, isMap as isMap2, isScalar as isScalar2, YAMLMap, Scalar as Scalar2 } from "yaml";
 
 // src/lib/npm-plugin-installer.ts
@@ -11416,12 +11896,12 @@ import {
   mkdir as mkdir11,
   mkdtemp as mkdtemp2,
   open as open2,
-  readFile as readFile30,
+  readFile as readFile31,
   realpath as realpath2,
   rename as rename4,
-  rm as rm5
+  rm as rm4
 } from "node:fs/promises";
-import path19 from "node:path";
+import path20 from "node:path";
 import { Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createGunzip } from "node:zlib";
@@ -11466,8 +11946,8 @@ function mb(bytes) {
   return `${Math.ceil(bytes / 1024 / 1024)}MB`;
 }
 function isContained2(root, candidate) {
-  const relative2 = path19.relative(root, candidate);
-  return relative2 === "" || !relative2.startsWith("..") && !path19.isAbsolute(relative2);
+  const relative2 = path20.relative(root, candidate);
+  return relative2 === "" || !relative2.startsWith("..") && !path20.isAbsolute(relative2);
 }
 function mergeLimits(overrides) {
   const limits = { ...DEFAULT_LIMITS, ...overrides };
@@ -11774,13 +12254,13 @@ async function extractTarball(ctx, archivePath, packageDir, packageName) {
     throw rejected;
 }
 async function readInstalledManifest(packageDir, selected) {
-  const packageJsonPath = path19.join(packageDir, "package.json");
+  const packageJsonPath = path20.join(packageDir, "package.json");
   let manifest = null;
   try {
     const info2 = await lstat2(packageJsonPath);
     if (!info2.isFile() || info2.isSymbolicLink())
       throw new Error("not a regular file");
-    manifest = object2(JSON.parse(await readFile30(packageJsonPath, "utf8")));
+    manifest = object2(JSON.parse(await readFile31(packageJsonPath, "utf8")));
   } catch (error2) {
     throw new SecurityInstallError(`Downloaded ${selected.name}@${selected.version} has no valid package.json (${error2 instanceof Error ? error2.message : String(error2)}).`);
   }
@@ -11850,17 +12330,17 @@ async function installPackage(ctx, name, selector, parentPackagePath, ancestors,
     throw new SecurityInstallError(`Dependency graph exceeds ${ctx.limits.totalPackages} packages.`);
   }
   const relativePath = relativePackagePath(parentPackagePath, name);
-  const packageDir = path19.join(ctx.stageRoot, ...relativePath.split("/"));
-  const archivePath = path19.join(ctx.downloadsDir, `${ctx.archiveCounter++}.tgz`);
+  const packageDir = path20.join(ctx.stageRoot, ...relativePath.split("/"));
+  const archivePath = path20.join(ctx.downloadsDir, `${ctx.archiveCounter++}.tgz`);
   try {
-    await mkdir11(path19.dirname(packageDir), { recursive: true });
+    await mkdir11(path20.dirname(packageDir), { recursive: true });
     await downloadTarball(ctx, selected, archivePath);
     await extractTarball(ctx, archivePath, packageDir, selected.name);
     const manifest = await readInstalledManifest(packageDir, selected);
     if (!platformAllowed(manifest.os, process.platform) || !platformAllowed(manifest.cpu, process.arch)) {
       const reason = `${name}@${selected.version} does not support ${process.platform}/${process.arch}`;
       if (optional) {
-        await rm5(packageDir, { recursive: true, force: true });
+        await rm4(packageDir, { recursive: true, force: true });
         return { skipped: reason };
       }
       throw new PackageUnavailableError(reason);
@@ -11929,14 +12409,14 @@ async function installPackage(ctx, name, selector, parentPackagePath, ancestors,
     }
     return { path: relativePath };
   } catch (error2) {
-    await rm5(packageDir, { recursive: true, force: true });
+    await rm4(packageDir, { recursive: true, force: true });
     if (optional && isOptionalAvailabilityError(error2)) {
       discardOptionalSubtree();
       return { skipped: error2 instanceof Error ? error2.message : String(error2) };
     }
     throw error2;
   } finally {
-    await rm5(archivePath, { force: true });
+    await rm4(archivePath, { force: true });
   }
 }
 async function ensureDirectory(pathname) {
@@ -11952,9 +12432,9 @@ async function ensureDirectory(pathname) {
   }
 }
 async function prepareVendorParent(projectDir, name) {
-  const plugins = path19.join(projectDir, PLUGINS_DIR);
-  const npm = path19.join(plugins, VENDORED_NPM_DIR);
-  const packageParent = path19.dirname(vendoredNpmPluginRoot(projectDir, name, "0.0.0"));
+  const plugins = path20.join(projectDir, PLUGINS_DIR);
+  const npm = path20.join(plugins, VENDORED_NPM_DIR);
+  const packageParent = path20.dirname(vendoredNpmPluginRoot(projectDir, name, "0.0.0"));
   await mkdir11(projectDir, { recursive: true });
   await ensureDirectory(plugins);
   await ensureDirectory(npm);
@@ -11982,14 +12462,14 @@ function publicReceipt(record) {
   };
 }
 async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
-  const requestedProjectDir = path19.resolve(projectDirInput);
+  const requestedProjectDir = path20.resolve(projectDirInput);
   await mkdir11(requestedProjectDir, { recursive: true });
   const projectDir = await realpath2(requestedProjectDir);
   const requested = parseNpmPluginSpec(packageSpec);
   const npmRoot = await prepareVendorParent(projectDir, requested.name);
-  const container = await mkdtemp2(path19.join(npmRoot, ".install-"));
-  const stageRoot = path19.join(container, "root");
-  const downloadsDir = path19.join(container, "downloads");
+  const container = await mkdtemp2(path20.join(npmRoot, ".install-"));
+  const stageRoot = path20.join(container, "root");
+  const downloadsDir = path20.join(container, "downloads");
   await Promise.all([mkdir11(stageRoot), mkdir11(downloadsDir)]);
   const ctx = {
     fetch: options.fetch ?? globalThis.fetch,
@@ -12035,7 +12515,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
       skipped: ctx.skipped,
       tree: { algorithm: "sha256", ...tree }
     };
-    const receiptFile = await open2(path19.join(stageRoot, VENDOR_RECEIPT_FILE), "wx");
+    const receiptFile = await open2(path20.join(stageRoot, VENDOR_RECEIPT_FILE), "wx");
     try {
       await receiptFile.writeFile(`${JSON.stringify(receipt, null, 2)}
 `, "utf8");
@@ -12044,7 +12524,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
       await receiptFile.close();
     }
     finalRoot = vendoredNpmPluginRoot(projectDir, rootRecord.name, rootRecord.version);
-    const realFinalParent = await realpath2(path19.dirname(finalRoot));
+    const realFinalParent = await realpath2(path20.dirname(finalRoot));
     if (!isContained2(projectDir, realFinalParent)) {
       throw new Error("Plugin install destination resolves outside the project.");
     }
@@ -12076,16 +12556,16 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
       warnings: [...ctx.warnings]
     };
   } finally {
-    await rm5(container, { recursive: true, force: true }).catch(() => {});
+    await rm4(container, { recursive: true, force: true }).catch(() => {});
   }
 }
 async function finalizeNpmPluginInstall(installed) {
   if (installed.backupRoot) {
-    await rm5(installed.backupRoot, { recursive: true, force: true });
+    await rm4(installed.backupRoot, { recursive: true, force: true });
   }
 }
 async function rollbackNpmPluginInstall(installed) {
-  await rm5(installed.installRoot, { recursive: true, force: true });
+  await rm4(installed.installRoot, { recursive: true, force: true });
   if (installed.backupRoot)
     await rename4(installed.backupRoot, installed.installRoot);
 }
@@ -12093,7 +12573,7 @@ async function rollbackNpmPluginInstall(installed) {
 // src/lib/plugin-manager.ts
 var pluginMutationQueues = new Map;
 function withPluginMutationLock(projectDir, mutation) {
-  const resolved = path20.resolve(projectDir);
+  const resolved = path21.resolve(projectDir);
   const key = process.platform === "win32" ? resolved.toLowerCase() : resolved;
   const previous = pluginMutationQueues.get(key) ?? Promise.resolve();
   const run2 = previous.then(mutation, mutation);
@@ -12213,7 +12693,7 @@ async function setPluginEnabledUnlocked(projectDir, ref, enabled) {
   const { doc, file } = await loadManifestDoc(projectDir);
   const seq = doc.get("plugins", true);
   if (!isSeq4(seq)) {
-    throw new Error(`No plugins are configured in ${path20.basename(file)}.`);
+    throw new Error(`No plugins are configured in ${path21.basename(file)}.`);
   }
   const idx = indexOfRef(seq, ref);
   if (idx < 0) {
@@ -12331,12 +12811,12 @@ async function addLocalPluginUnlocked(projectDir, sourcePath) {
   } catch {
     throw new Error(`Plugin source not found: ${sourcePath}`);
   }
-  const base = path20.basename(sourcePath);
-  const destDir = path20.join(projectDir, PLUGINS_DIR);
+  const base = path21.basename(sourcePath);
+  const destDir = path21.join(projectDir, PLUGINS_DIR);
   await mkdir12(destDir, { recursive: true });
-  const dest = path20.join(destDir, base);
-  const staging = path20.join(destDir, `.import-${randomUUID4()}`);
-  const backup = path20.join(destDir, `.backup-${randomUUID4()}`);
+  const dest = path21.join(destDir, base);
+  const staging = path21.join(destDir, `.import-${randomUUID4()}`);
+  const backup = path21.join(destDir, `.backup-${randomUUID4()}`);
   let hasBackup = false;
   try {
     if (info2.isDirectory()) {
@@ -12363,16 +12843,16 @@ async function addLocalPluginUnlocked(projectDir, sourcePath) {
     try {
       await appendPlugin(projectDir, relPath, new Scalar2(relPath));
     } catch (error2) {
-      await rm6(dest, { recursive: true, force: true });
+      await rm5(dest, { recursive: true, force: true });
       if (hasBackup)
         await rename5(backup, dest);
       throw error2;
     }
     if (hasBackup)
-      await rm6(backup, { recursive: true, force: true }).catch(() => {});
+      await rm5(backup, { recursive: true, force: true }).catch(() => {});
     return { ref: relPath, kind: "local", enabled: true, path: relPath };
   } finally {
-    await rm6(staging, { recursive: true, force: true }).catch(() => {});
+    await rm5(staging, { recursive: true, force: true }).catch(() => {});
   }
 }
 async function validateProjectPlugins(projectDir) {
@@ -12410,11 +12890,158 @@ async function validateProjectPlugins(projectDir) {
   }
   return out;
 }
+
+// src/lib/snippets.ts
+var SNIPPETS_DIR = "snippets";
+var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+function extractVariables(template) {
+  const seen = new Set;
+  const order = [];
+  for (const m of template.matchAll(PLACEHOLDER_RE)) {
+    const name = m[1];
+    if (!seen.has(name)) {
+      seen.add(name);
+      order.push(name);
+    }
+  }
+  return order;
+}
+function substituteVariables(template, values) {
+  return template.replace(PLACEHOLDER_RE, (_full, name) => Object.prototype.hasOwnProperty.call(values, name) ? values[name] : "");
+}
+function resolveSafeChildFile(dir, fileName) {
+  const full = path22.resolve(dir, fileName);
+  if (full !== path22.join(dir, path22.basename(fileName)) || path22.dirname(full) !== dir) {
+    throw new Error(`Unsafe snippet filename: ${fileName}`);
+  }
+  return full;
+}
+function resolveSnippetPath(projectDir, fileName) {
+  return resolveSafeChildFile(path22.resolve(projectDir, SNIPPETS_DIR), fileName);
+}
+async function scanSnippetFiles(dir) {
+  let names;
+  try {
+    names = await readdir9(dir);
+  } catch {
+    return [];
+  }
+  const entries = [];
+  for (const fileName of names) {
+    if (!fileName.toLowerCase().endsWith(".md"))
+      continue;
+    let body = "";
+    try {
+      body = await readFile32(path22.join(dir, fileName), "utf8");
+    } catch {
+      continue;
+    }
+    entries.push({
+      name: prettify(fileName.replace(/\.md$/i, "")),
+      fileName,
+      variables: extractVariables(body)
+    });
+  }
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+  return entries;
+}
+async function listSnippets(projectDir) {
+  const files = await scanSnippetFiles(path22.join(projectDir, SNIPPETS_DIR));
+  return files.map((file) => ({ ...file, source: { kind: "project" } }));
+}
+async function readSnippet(projectDir, fileName) {
+  return readFile32(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 = path22.join(projectDir, SNIPPETS_DIR);
+  await mkdir13(dir, { recursive: true });
+  await writeFile11(resolveSnippetPath(projectDir, fileName), body, "utf8");
+  return { name, fileName, variables: extractVariables(body), source: { kind: "project" } };
+}
+async function deleteSnippet(projectDir, fileName) {
+  await rm6(resolveSnippetPath(projectDir, fileName), { force: true });
+}
+async function listInstalledExtensions(projectDir) {
+  const out = [];
+  const activeTheme = await getActiveTheme(projectDir);
+  const themeSnippets = activeTheme?.snippets?.trim();
+  if (activeTheme && themeSnippets) {
+    out.push({
+      ref: activeTheme.id,
+      kind: "theme",
+      dir: path22.join(projectDir, THEMES_DIR, activeTheme.id),
+      name: activeTheme.name,
+      snippetsRel: themeSnippets
+    });
+  }
+  for (const entry of await listProjectPlugins(projectDir)) {
+    if (entry.kind !== "local" || !entry.enabled)
+      continue;
+    const dir = path22.resolve(projectDir, entry.ref);
+    let isExtensionDir = false;
+    try {
+      isExtensionDir = (await stat9(dir)).isDirectory();
+    } catch {
+      continue;
+    }
+    if (!isExtensionDir)
+      continue;
+    const meta = await readExtensionMeta(dir);
+    const snippetsRel = meta.snippets?.trim();
+    if (!snippetsRel)
+      continue;
+    out.push({
+      ref: entry.ref,
+      kind: "plugin",
+      dir,
+      name: meta.name?.trim() || prettify(path22.basename(dir)),
+      snippetsRel
+    });
+  }
+  return out;
+}
+function extensionSnippetsDir(ext) {
+  if (pathEscapesFolder(ext.snippetsRel))
+    return null;
+  return path22.join(ext.dir, ext.snippetsRel);
+}
+async function listMergedSnippets(projectDir) {
+  const project = await listSnippets(projectDir);
+  const projectFileNames = new Set(project.map((entry) => entry.fileName.toLowerCase()));
+  const merged = [...project];
+  const extensions = (await listInstalledExtensions(projectDir)).sort((a, b) => a.name.localeCompare(b.name));
+  for (const ext of extensions) {
+    const dir = extensionSnippetsDir(ext);
+    if (!dir)
+      continue;
+    for (const file of await scanSnippetFiles(dir)) {
+      if (projectFileNames.has(file.fileName.toLowerCase()))
+        continue;
+      merged.push({ ...file, source: { kind: ext.kind, ref: ext.ref, name: ext.name } });
+    }
+  }
+  return merged;
+}
+async function readExtensionSnippet(projectDir, source, fileName) {
+  const ext = (await listInstalledExtensions(projectDir)).find((candidate) => candidate.kind === source.kind && candidate.ref === source.ref);
+  if (!ext) {
+    throw new Error(`Extension "${source.ref}" is not installed or is no longer active.`);
+  }
+  const dir = extensionSnippetsDir(ext);
+  if (!dir) {
+    throw new Error(`Extension "${source.ref}" does not declare a usable snippets folder.`);
+  }
+  return readFile32(resolveSafeChildFile(dir, fileName), "utf8");
+}
 // src/lib/theme-import.ts
-import { existsSync as existsSync15 } from "node:fs";
-import { mkdir as mkdir13, mkdtemp as mkdtemp3, readFile as readFile31, rm as rm7, writeFile as writeFile11 } from "node:fs/promises";
+import { existsSync as existsSync16 } from "node:fs";
+import { mkdir as mkdir14, mkdtemp as mkdtemp3, readFile as readFile33, rm as rm7, writeFile as writeFile12 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
-import path21 from "node:path";
+import path23 from "node:path";
 import { unzipSync } from "fflate";
 var MAX_THEME_ARCHIVE_BYTES = 25 * 1024 * 1024;
 var MAX_THEME_UNZIPPED_BYTES = 25 * 1024 * 1024;
@@ -12447,7 +13074,7 @@ function classifyThemeCssFindings(findings) {
   const warnings = reject ? [] : findings.filter((f) => f.rule !== ruleSyntax);
   return { reject, warnings };
 }
-var KNOWN_THEME_FILES = new Set(["theme.css", "theme.json"]);
+var KNOWN_THEME_FILES = new Set(["theme.css", "theme.json", EXTENSION_MANIFEST_FILENAME]);
 var ALLOWED_ASSET_EXTS = new Set([
   ".woff",
   ".woff2",
@@ -12463,8 +13090,12 @@ var ALLOWED_ASSET_EXTS = new Set([
   ".avif",
   ".css"
 ]);
-function unexpectedThemeFiles(relPaths) {
+function unexpectedThemeFiles(relPaths, declaredExtras = []) {
+  const extras = declaredExtras.map((p) => p.replace(/\\/g, "/"));
+  const isDeclared = (p) => extras.some((extra) => p === extra || p.startsWith(`${extra}/`));
   return relPaths.map((p) => p.replace(/\\/g, "/")).filter((p) => p.length > 0 && !p.endsWith("/")).filter((p) => {
+    if (isDeclared(p))
+      return false;
     const base = p.split("/").pop().toLowerCase();
     if (KNOWN_THEME_FILES.has(base))
       return false;
@@ -12476,20 +13107,12 @@ function unexpectedThemeFiles(relPaths) {
 function mb2(n) {
   return `${Math.round(n / (1024 * 1024))}MB`;
 }
-async function readThemeJson(p) {
-  try {
-    const parsed = JSON.parse(await readFile31(p, "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
 async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
-  const cssPath = path21.join(sourceDir, "theme.css");
-  if (!existsSync15(cssPath)) {
+  const cssPath = path23.join(sourceDir, "theme.css");
+  if (!existsSync16(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile31(cssPath, "utf8");
+  const css = await readFile33(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -12498,29 +13121,29 @@ async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
   for (const w of printFindings) {
     warnings.push({ code: "print-safety", message: w.message });
   }
-  const jsonPath = path21.join(sourceDir, "theme.json");
-  const jsonExists = existsSync15(jsonPath);
-  const meta = jsonExists ? await readThemeJson(jsonPath) : {};
-  if (!jsonExists) {
+  const metaExists = existsSync16(path23.join(sourceDir, EXTENSION_MANIFEST_FILENAME)) || existsSync16(path23.join(sourceDir, "theme.json"));
+  const meta = metaExists ? await readExtensionMeta(sourceDir) : {};
+  if (!metaExists) {
     warnings.push({
       code: "no-theme-json",
-      message: "No theme.json found — the theme's name was taken from the file/folder name."
+      message: "No gutterpress.json or theme.json found — the theme's name was taken from the file/folder name."
     });
   } else if (!meta.name || !meta.name.trim()) {
     warnings.push({
       code: "unnamed-theme",
-      message: `theme.json has no "name" — the theme's name was taken from the file/folder name.`
+      message: `The metadata file has no "name" — the theme's name was taken from the file/folder name.`
     });
   }
   assertThemeSheetsContained(meta);
+  const metaFilename = existsSync16(path23.join(sourceDir, EXTENSION_MANIFEST_FILENAME)) ? EXTENSION_MANIFEST_FILENAME : "theme.json";
   const extraSheets = [
     ...new Set([...themeStyleList(meta), ...themeEngineStyleList(meta)])
   ].filter((rel) => rel !== "theme.css");
-  const extraSheetPaths = resolveDeclaredStyles(extraSheets, sourceDir, "theme.json") ?? [];
+  const extraSheetPaths = resolveDeclaredStyles(extraSheets, sourceDir, metaFilename) ?? [];
   for (let i = 0;i < extraSheets.length; i++) {
     const rel = extraSheets[i];
     const sheetPath = extraSheetPaths[i];
-    const sheetCss = await readFile31(sheetPath, "utf8");
+    const sheetCss = await readFile33(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -12529,7 +13152,8 @@ async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
       warnings.push({ code: "print-safety", message: `${rel}: ${w.message}` });
     }
   }
-  const extra = unexpectedThemeFiles(relPaths);
+  const declaredExtras = [meta.markdown, meta.components, meta.snippets].filter((p) => typeof p === "string" && p.trim().length > 0);
+  const extra = unexpectedThemeFiles(relPaths, declaredExtras);
   if (extra.length > 0) {
     const shown = extra.slice(0, 6).join(", ");
     warnings.push({
@@ -12581,7 +13205,7 @@ async function importThemeFromZip(projectDir, archive) {
     throw new Error("No theme.css found in the package. A theme needs a theme.css at the package root or inside a single folder.");
   }
   const prefix = root === "" ? "" : `${root}/`;
-  const tmp = await mkdtemp3(path21.join(tmpdir3(), "gutterpress-theme-"));
+  const tmp = await mkdtemp3(path23.join(tmpdir3(), "gutterpress-theme-"));
   try {
     const relPaths = [];
     for (const [name, data] of Object.entries(files)) {
@@ -12593,13 +13217,13 @@ async function importThemeFromZip(projectDir, archive) {
       const rel = prefix ? norm.slice(prefix.length) : norm;
       if (!rel || rel.split("/").some((seg) => seg === ".."))
         continue;
-      const dest = path21.join(tmp, rel);
-      if (dest !== tmp && !dest.startsWith(tmp + path21.sep)) {
+      const dest = path23.join(tmp, rel);
+      if (dest !== tmp && !dest.startsWith(tmp + path23.sep)) {
         throw new Error(`The package contains an unsafe path and was rejected: ${name}`);
       }
       relPaths.push(rel);
-      await mkdir13(path21.dirname(dest), { recursive: true });
-      await writeFile11(dest, data);
+      await mkdir14(path23.dirname(dest), { recursive: true });
+      await writeFile12(dest, data);
     }
     return await finalizeThemeImport(projectDir, tmp, relPaths);
   } finally {
@@ -12612,10 +13236,10 @@ async function importThemeFromCssText(projectDir, css, name) {
     throw new Error(`The CSS could not be parsed — ${reject.message}`);
   }
   const displayName = name.trim() || "Imported theme";
-  const tmp = await mkdtemp3(path21.join(tmpdir3(), "gutterpress-theme-"));
+  const tmp = await mkdtemp3(path23.join(tmpdir3(), "gutterpress-theme-"));
   try {
-    await writeFile11(path21.join(tmp, "theme.css"), css, "utf8");
-    await writeFile11(path21.join(tmp, "theme.json"), JSON.stringify({ name: displayName }, null, 2), "utf8");
+    await writeFile12(path23.join(tmp, "theme.css"), css, "utf8");
+    await writeFile12(path23.join(tmp, "theme.json"), JSON.stringify({ name: displayName }, null, 2), "utf8");
     const result = await finalizeThemeImport(projectDir, tmp, ["theme.css", "theme.json"]);
     result.warnings.unshift({
       code: "no-theme-json",
@@ -12627,14 +13251,14 @@ async function importThemeFromCssText(projectDir, css, name) {
   }
 }
 async function importThemeFromFile(projectDir, filePath) {
-  const ext = path21.extname(filePath).toLowerCase();
+  const ext = path23.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile31(filePath);
+    const buf = await readFile33(filePath);
     return importThemeFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile31(filePath, "utf8");
-    return importThemeFromCssText(projectDir, css, prettify(path21.basename(filePath, ".css")));
+    const css = await readFile33(filePath, "utf8");
+    return importThemeFromCssText(projectDir, css, prettify(path23.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip theme package or a .css stylesheet.");
 }
@@ -13337,8 +13961,8 @@ async function listGitHubBranches(credential, owner, repo, options = {}) {
   return branches;
 }
 // src/lib/remote-auth/clone.ts
-import { mkdir as mkdir14, readdir as readdir10, rm as rm8 } from "node:fs/promises";
-import path22 from "node:path";
+import { mkdir as mkdir15, readdir as readdir10, rm as rm8 } from "node:fs/promises";
+import path24 from "node:path";
 import git3 from "isomorphic-git";
 
 // src/lib/remote-auth/git-http.ts
@@ -13669,7 +14293,7 @@ function friendlyCloneError(e) {
 }
 async function cloneRepository(options) {
   const { dir, onProgress, tokenStore } = options;
-  if (!path22.isAbsolute(dir)) {
+  if (!path24.isAbsolute(dir)) {
     throw new Error("cloneRepository requires an absolute destination path.");
   }
   let parsed;
@@ -13689,7 +14313,7 @@ async function cloneRepository(options) {
   return withRepoLock(dir, async () => {
     await assertCloneTarget(dir);
     const dirExistedBefore = gitFs.existsSync(dir);
-    await mkdir14(dir, { recursive: true });
+    await mkdir15(dir, { recursive: true });
     try {
       await git3.clone({
         fs: gitFs,
@@ -13981,8 +14605,8 @@ async function diagnoseProjectRemote(projectDir, options = {}) {
 import git6 from "isomorphic-git";
 
 // src/lib/remote-auth/converge-merge.ts
-import { mkdir as mkdir15, unlink as unlink3, writeFile as writeFile12 } from "node:fs/promises";
-import path23 from "node:path";
+import { mkdir as mkdir16, unlink as unlink3, writeFile as writeFile13 } from "node:fs/promises";
+import path25 from "node:path";
 import git5 from "isomorphic-git";
 import diff3Merge from "diff3";
 function isMergeConflictError(e) {
@@ -14029,9 +14653,9 @@ async function readBlobOrNull(dir, cache2, oid, filepath) {
   }
 }
 async function writeTreeFile(dir, filepath, content) {
-  const abs = path23.join(dir, filepath);
-  await mkdir15(path23.dirname(abs), { recursive: true });
-  await writeFile12(abs, content);
+  const abs = path25.join(dir, filepath);
+  await mkdir16(path25.dirname(abs), { recursive: true });
+  await writeFile13(abs, content);
 }
 async function bothAddedPaths(dir, cache2, ourTip, theirTip, allowUnrelated) {
   const bases = await git5.findMergeBase({ fs: gitFs, dir, cache: cache2, oids: [ourTip, theirTip] });
@@ -14127,7 +14751,7 @@ async function convergeMerge(params) {
     }
     for (const p of paths.deleteByTheirs) {
       const ourBlob = await readBlobOrNull(dir, cache2, ourTip, p);
-      await unlink3(path23.join(dir, p)).catch((e) => {
+      await unlink3(path25.join(dir, p)).catch((e) => {
         if (e?.code !== "ENOENT")
           throw e;
       });
@@ -14368,8 +14992,8 @@ async function syncProject(options) {
   });
 }
 // src/lib/publish/run-publish.ts
-import { readdir as readdir12, stat as stat11 } from "node:fs/promises";
-import path27 from "node:path";
+import { readdir as readdir12, stat as stat12 } from "node:fs/promises";
+import path29 from "node:path";
 
 // src/lib/publish/command-runner.ts
 var CAPTURE_LIMIT = 64 * 1024;
@@ -14518,25 +15142,25 @@ ${tail}` : ""}`);
 };
 
 // src/lib/publish/providers/guided.ts
-import { copyFile as copyFile2, mkdir as mkdir16, writeFile as writeFile13 } from "node:fs/promises";
-import path24 from "node:path";
+import { copyFile as copyFile2, mkdir as mkdir17, writeFile as writeFile14 } from "node:fs/promises";
+import path26 from "node:path";
 async function stageGuidedPackage(req, providerId, listingLines) {
-  const packageDir = path24.join(path24.dirname(req.artifact.path), "publish", providerId);
-  await mkdir16(packageDir, { recursive: true });
-  await copyFile2(req.artifact.path, path24.join(packageDir, path24.basename(req.artifact.path)));
+  const packageDir = path26.join(path26.dirname(req.artifact.path), "publish", providerId);
+  await mkdir17(packageDir, { recursive: true });
+  await copyFile2(req.artifact.path, path26.join(packageDir, path26.basename(req.artifact.path)));
   const { title, authors } = req.project;
   const sheet = [
     `# ${title || "Untitled"}`,
     "",
     `- **Authors:** ${authors.length ? authors.join(", ") : "(not set)"}`,
-    `- **File:** ${path24.basename(req.artifact.path)}`,
+    `- **File:** ${path26.basename(req.artifact.path)}`,
     ...listingLines,
     "",
     "Copy these details into the platform's listing form when uploading.",
     ""
   ].join(`
 `);
-  await writeFile13(path24.join(packageDir, "LISTING.md"), sheet, "utf8");
+  await writeFile14(path26.join(packageDir, "LISTING.md"), sheet, "utf8");
   return packageDir;
 }
 
@@ -14599,9 +15223,9 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp4, readFile as readFile32, readdir as readdir11, rm as rm9, stat as stat9, writeFile as writeFile14 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile34, readdir as readdir11, rm as rm9, stat as stat10, writeFile as writeFile15 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import path25 from "node:path";
+import path27 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
 
 // src/lib/publish/google-drive.ts
@@ -14986,34 +15610,34 @@ function zipEntriesNonBlocking(entries, opts) {
 async function collectZipEntries(root, dir, out, onWarn) {
   const entries = await readdir11(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const full = path25.join(dir, entry.name);
+    const full = path27.join(dir, entry.name);
     if (entry.isDirectory()) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
-      const rel = path25.relative(root, full).split(path25.sep).join("/");
-      out[rel] = await readFile32(full);
+      const rel = path27.relative(root, full).split(path27.sep).join("/");
+      out[rel] = await readFile34(full);
     } else if (entry.isSymbolicLink()) {
-      const resolved = await stat9(full).catch(() => null);
+      const resolved = await stat10(full).catch(() => null);
       if (resolved?.isFile()) {
-        const rel = path25.relative(root, full).split(path25.sep).join("/");
-        out[rel] = await readFile32(full);
+        const rel = path27.relative(root, full).split(path27.sep).join("/");
+        out[rel] = await readFile34(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
-        onWarn?.(`Skipped "${path25.relative(root, full)}" in the website export — it's a broken symlink.`);
+        onWarn?.(`Skipped "${path27.relative(root, full)}" in the website export — it's a broken symlink.`);
       }
     } else {
-      onWarn?.(`Skipped "${path25.relative(root, full)}" in the website export — not a file, folder, or symlink.`);
+      onWarn?.(`Skipped "${path27.relative(root, full)}" in the website export — not a file, folder, or symlink.`);
     }
   }
 }
-async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile14) {
+async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile15) {
   const entries = {};
   await collectZipEntries(exportDir, exportDir, entries, onWarn);
   const fileName = `${bookSlug(title)}-website.zip`;
-  const tmpRoot = await mkdtemp4(path25.join(tmpdir4(), "gutterpress-gdrive-"));
+  const tmpRoot = await mkdtemp4(path27.join(tmpdir4(), "gutterpress-gdrive-"));
   try {
-    const filePath = path25.join(tmpRoot, fileName);
+    const filePath = path27.join(tmpRoot, fileName);
     const zipped = await zipEntriesNonBlocking(entries, { level: 6 });
     await writeArchiveImpl(filePath, zipped);
     return {
@@ -15061,12 +15685,12 @@ var gdriveProvider = {
     const isHtml = req.artifact.format === "html";
     const source = isHtml ? await zipHtmlExport(req.artifact.path, req.project.title, (msg) => req.deps.onProgress?.(msg)) : {
       filePath: req.artifact.path,
-      fileName: path25.basename(req.artifact.path),
+      fileName: path27.basename(req.artifact.path),
       mimeType: "application/pdf",
       cleanup: async () => {}
     };
     try {
-      const artifactStat = await stat9(source.filePath);
+      const artifactStat = await stat10(source.filePath);
       const about = await driveAbout(fetchImpl, accessToken);
       if (about.quota.limitBytes != null && about.quota.freeBytes != null) {
         if (artifactStat.size > about.quota.freeBytes) {
@@ -15111,8 +15735,8 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod as chmod2, mkdir as mkdir17, stat as stat10, writeFile as writeFile15 } from "node:fs/promises";
-import path26 from "node:path";
+import { chmod as chmod2, mkdir as mkdir18, stat as stat11, writeFile as writeFile16 } from "node:fs/promises";
+import path28 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
 function butlerBrothChannel(platform2 = process.platform, arch2 = process.arch) {
@@ -15132,7 +15756,7 @@ function butlerBinaryName(platform2 = process.platform) {
 }
 async function fileExists2(p) {
   try {
-    return (await stat10(p)).isFile();
+    return (await stat11(p)).isFile();
   } catch {
     return false;
   }
@@ -15149,8 +15773,8 @@ async function ensureButler(deps) {
   }
   if (await commandExists("butler", runCommand, deps.env))
     return "butler";
-  const cacheDir = path26.join(deps.configDir ?? defaultConfigDir(), "tools", "butler");
-  const cached = path26.join(cacheDir, butlerBinaryName());
+  const cacheDir = path28.join(deps.configDir ?? defaultConfigDir(), "tools", "butler");
+  const cached = path28.join(cacheDir, butlerBinaryName());
   if (await fileExists2(cached))
     return cached;
   const channel = butlerBrothChannel();
@@ -15172,14 +15796,14 @@ async function ensureButler(deps) {
     return new Uint8Array(await response.arrayBuffer());
   });
   const files = unzipSync2(archive);
-  await mkdir17(cacheDir, { recursive: true });
+  await mkdir18(cacheDir, { recursive: true });
   let foundBinary = false;
   for (const [name, data] of Object.entries(files)) {
     if (name.endsWith("/"))
       continue;
-    const target = path26.join(cacheDir, path26.basename(name));
-    await writeFile15(target, data);
-    if (path26.basename(name) === butlerBinaryName()) {
+    const target = path28.join(cacheDir, path28.basename(name));
+    await writeFile16(target, data);
+    if (path28.basename(name) === butlerBinaryName()) {
       await chmod2(target, 493).catch(() => {});
       foundBinary = true;
     }
@@ -15628,9 +16252,9 @@ async function resolvePublishRequest(options, deps) {
   const effectiveDeps = effectiveAccount ? { ...deps, credentialAccount: effectiveAccount } : deps;
   const outDir = resolveOutputDir(manifestDir, config.title);
   const effectiveFormat = resolvePublishFormat(provider.info, providerConfig);
-  const defaultArtifact = effectiveFormat === "pdf" ? path27.join(outDir, artifactName(config.title, "pdf")) : outDir;
+  const defaultArtifact = effectiveFormat === "pdf" ? path29.join(outDir, artifactName(config.title, "pdf")) : outDir;
   const artifact = {
-    path: options.artifactPath ? path27.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
+    path: options.artifactPath ? path29.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
     format: effectiveFormat
   };
   return {
@@ -15648,7 +16272,7 @@ var PDF_HINT = "Build the PDF first (gutterpress build, or export it from the ap
 var HTML_HINT = "Build the website export first (gutterpress build --format html).";
 async function artifactIssues(artifact) {
   try {
-    const s = await stat11(artifact.path);
+    const s = await stat12(artifact.path);
     if (artifact.format === "pdf" && !s.isFile()) {
       return [
         {
@@ -15694,7 +16318,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat11(path27.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat12(path29.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -15813,17 +16437,17 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir18, readFile as readFile33, writeFile as writeFile16 } from "node:fs/promises";
-import path28 from "node:path";
+import { chmod as chmod3, mkdir as mkdir19, readFile as readFile35, writeFile as writeFile17 } from "node:fs/promises";
+import path30 from "node:path";
 class PublishSelectionsStore {
   filePath;
   queue = Promise.resolve();
   constructor(filePath) {
-    this.filePath = filePath ?? path28.join(defaultConfigDir(), "publish-selections.json");
+    this.filePath = filePath ?? path30.join(defaultConfigDir(), "publish-selections.json");
   }
   async read() {
     try {
-      const raw = await readFile33(this.filePath, "utf8");
+      const raw = await readFile35(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {
@@ -15836,8 +16460,8 @@ class PublishSelectionsStore {
     return { version: 1, global: {}, projects: {} };
   }
   async write(data) {
-    await mkdir18(path28.dirname(this.filePath), { recursive: true });
-    await writeFile16(this.filePath, JSON.stringify(data, null, 2), {
+    await mkdir19(path30.dirname(this.filePath), { recursive: true });
+    await writeFile17(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384
     });
@@ -15939,4 +16563,4 @@ async function setPublishProviderConfig(projectDir, providerId, values) {
   await writeManifestDoc(file, doc);
   return settingsFromDoc(doc);
 }
-export { PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, PLUGINS_DIR, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, checkCss, runLint, formatReport, getChecks, getCheckById, resolveCheckSelectors, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, THEMES_DIR, BUILT_IN_THEME_IDS, listBuiltInThemes, resolveBuiltInTheme, listProjectThemes, getActiveTheme, getPreviousTheme, revertTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, readThemeCss, removeProjectTheme, detectLegacyForkedTheme, 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, importThemeFromFile, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };
+export { PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, PLUGINS_DIR, EXTENSION_MANIFEST_FILENAME, LEGACY_THEME_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEngineStyleList, pathEscapesFolder, assertExtensionContained, resolveExtension, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, checkCss, runLint, formatReport, getChecks, getCheckById, resolveCheckSelectors, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, THEMES_DIR, BUILT_IN_THEME_IDS, listBuiltInThemes, resolveBuiltInTheme, listProjectThemes, getActiveTheme, getPreviousTheme, revertTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, readThemeCss, removeProjectTheme, detectLegacyForkedTheme, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, RECOMMENDED_PLUGINS, listProjectPlugins, setPluginEnabled, addNpmPlugin, addLocalPlugin, validateProjectPlugins, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importThemeFromFile, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };