gutterpress 0.10.7 → 0.10.8

package/dist/{cli-kzf64c2g.js → cli-1hx14cgk.js}

@@ -13,21 +13,22 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-pvk2s9d7.js";
+} from "./cli-vxf151ea.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-h8ejbtyr.js";
+} from "./cli-vcv5ewqj.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
   REQUIRED_MILESTONE,
   closeBrowser,
   getAssetPath,
+  getAssetsDir,
   getBrowser,
   prewarmBrowser
-} from "./cli-s8q42x3r.js";
+} from "./cli-4vtgt2ng.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -1078,7 +1079,7 @@ async function verifyVendoredPlugin(projectDir, expectedName, expectedVersion) {
 
 // src/lib/lint-runner.ts
 import { resolve as resolve4 } from "node:path";
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss from "postcss";
@@ -1379,8 +1380,8 @@ async function resolveActiveStyles(projectDir, manifestStyles) {
 
 // src/lib/markdown/plugins.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync4, lstatSync, realpathSync, rmSync, statSync as statSync2, unlinkSync } from "node:fs";
-import { cp, link, mkdir, mkdtemp, readFile as readFile3, rm, unlink, writeFile } from "node:fs/promises";
+import { existsSync as existsSync5, lstatSync, realpathSync, rmSync, statSync as statSync2, unlinkSync } from "node:fs";
+import { cp, link, mkdir, mkdtemp, readFile as readFile4, rm, unlink, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { resolve as resolve3, join, dirname as dirname2, basename, extname, relative, isAbsolute } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -1404,6 +1405,70 @@ function resolveDeclaredStyles(rawStyles, baseDir, subject) {
   });
 }
 
+// src/lib/extension-manifest.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { readFile as readFile3 } from "node:fs/promises";
+import path3 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 readFile3(jsonPath, "utf8"));
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+async function readExtensionMeta(dir) {
+  const extensionPath = path3.join(dir, EXTENSION_MANIFEST_FILENAME);
+  if (existsSync4(extensionPath)) {
+    return readJsonMetaFile(extensionPath);
+  }
+  return readJsonMetaFile(path3.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 path3.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/renderer.ts
 import MarkdownIt from "markdown-it";
 import markdownItAttrs from "markdown-it-attrs";
@@ -1461,7 +1526,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;
@@ -1495,9 +1560,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);
@@ -1600,12 +1665,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);
@@ -1621,16 +1688,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;
+      warn2(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)
@@ -1687,10 +1931,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) {
+          warn2(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) {
@@ -1840,6 +2138,7 @@ function plugin(md, pluginOptions = {}) {
       const kind = meta.kind;
       const line = meta.__line || 0;
       if (kind === "chapter") {
+        drainDeclaredFrames();
         stack.close("chapter");
         openChapter(meta);
         continue;
@@ -1848,16 +2147,19 @@ function plugin(md, pluginOptions = {}) {
         if (stack.has("spread")) {
           warn2(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");
@@ -1873,6 +2175,7 @@ function plugin(md, pluginOptions = {}) {
           warn2(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 || {} }
@@ -1905,15 +2208,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) {
+            warn2(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) {
+              warn2(state.env, line, "deprecated_marker", `@${kind} is deprecated: ${closeDecl.deprecated}`, meta);
+              continue;
+            }
+            if (!closeDeclaredFrame(closeDecl.baseKind)) {
+              warn2(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) {
       warn2(state.env, 0, "spread_eof_close", "An open @spread reached end-of-document; closing it automatically.", null);
     }
+    drainDeclaredFramesAtEof();
     stack.closeAll();
     state.tokens = out;
   });
@@ -2903,7 +3233,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) {
@@ -3226,7 +3558,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 readFile3(absolute, "utf8");
+    const source = await readFile4(absolute, "utf8");
     const [imports] = parseModuleImports(source, absolute);
     const replacements = [];
     const targets = new Set;
@@ -3457,12 +3789,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) {
@@ -3478,11 +3820,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;
@@ -3553,6 +3896,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;
@@ -3568,10 +3953,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);
@@ -3587,7 +3983,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,
@@ -3595,6 +3991,7 @@ async function loadPlugin(config, baseDir) {
     metadata,
     css,
     styles,
+    markers,
     options: config.options
   };
 }
@@ -3638,7 +4035,10 @@ async function runLint(opts = {}) {
   } else {
     const relStyles = await resolveActiveStyles(manifestDir, resolved.styles);
     const projectFiles = relStyles.map((rel) => resolve4(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) {
@@ -3652,7 +4052,7 @@ async function runLint(opts = {}) {
   for (const file of files) {
     let css;
     try {
-      css = await readFile4(file, "utf8");
+      css = await readFile5(file, "utf8");
     } catch (err) {
       log.error(`  ${file}`);
       log.error(`    cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`);
@@ -3791,7 +4191,7 @@ function inspectionFailed(checkId, message, extra = {}) {
 }
 
 // src/lib/pdf-inspect.ts
-import { stat, readFile as readFile5 } from "node:fs/promises";
+import { stat, readFile as readFile6 } from "node:fs/promises";
 import { getDocumentProxy } from "unpdf";
 import * as pdfjs from "unpdf/pdfjs";
 function getOps(mod) {
@@ -3827,17 +4227,17 @@ function evictLru() {
       destroyEntryAfterGrace(evicted);
   }
 }
-async function loadPdf(path3) {
+async function loadPdf(path4) {
   let st;
   try {
-    st = await stat(path3);
+    st = await stat(path4);
   } catch {
     return null;
   }
-  const hit = docCache.get(path3);
+  const hit = docCache.get(path4);
   if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) {
-    docCache.delete(path3);
-    docCache.set(path3, hit);
+    docCache.delete(path4);
+    docCache.set(path4, hit);
     try {
       return await hit.doc;
     } catch {
@@ -3846,15 +4246,15 @@ async function loadPdf(path3) {
   }
   if (hit)
     destroyEntry(hit);
-  const docPromise = readFile5(path3).then((buf) => getDocumentProxy(new Uint8Array(buf)));
-  docCache.delete(path3);
-  docCache.set(path3, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
+  const docPromise = readFile6(path4).then((buf) => getDocumentProxy(new Uint8Array(buf)));
+  docCache.delete(path4);
+  docCache.set(path4, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
   evictLru();
   try {
     return await docPromise;
   } catch {
-    if (docCache.get(path3)?.doc === docPromise)
-      docCache.delete(path3);
+    if (docCache.get(path4)?.doc === docPromise)
+      docCache.delete(path4);
     return null;
   }
 }
@@ -4305,9 +4705,9 @@ var check3 = {
 registerCheck(check3);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile6 } from "node:fs/promises";
+import { readFile as readFile7 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile6(pdfPath, "latin1");
+  return readFile7(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -4878,21 +5278,21 @@ var check15 = {
 registerCheck(check15);
 
 // src/checks/source/markdownlint.ts
-import { readFile as readFile7 } from "node:fs/promises";
+import { readFile as readFile8 } from "node:fs/promises";
 import { lint } from "markdownlint/sync";
 import { parse as parseYaml2 } from "yaml";
 
 // src/checks/source/config-file.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { resolve as resolve5 } from "node:path";
 function findConfigFile(inputDir, names, explicit) {
   if (explicit) {
     const p = resolve5(inputDir, explicit);
-    return existsSync5(p) ? p : null;
+    return existsSync6(p) ? p : null;
   }
   for (const name of names) {
     const p = resolve5(inputDir, name);
-    if (existsSync5(p))
+    if (existsSync6(p))
       return p;
   }
   return null;
@@ -4911,7 +5311,7 @@ function stripJsonComments(s) {
   return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
 }
 async function loadConfig(configPath) {
-  const raw = await readFile7(configPath, "utf8");
+  const raw = await readFile8(configPath, "utf8");
   let parsed;
   if (configPath.endsWith(".json")) {
     parsed = JSON.parse(raw);
@@ -4970,8 +5370,8 @@ var check16 = {
 registerCheck(check16);
 
 // src/checks/source/htmlhint.ts
-import { existsSync as existsSync6 } from "node:fs";
-import { readFile as readFile8 } from "node:fs/promises";
+import { existsSync as existsSync7 } from "node:fs";
+import { readFile as readFile9 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
@@ -4985,14 +5385,14 @@ var check17 = {
     const sourceConfig = ctx.config.validate.source;
     if (sourceConfig.htmlhint === false)
       return [];
-    if (!ctx.htmlPath || !existsSync6(ctx.htmlPath))
+    if (!ctx.htmlPath || !existsSync7(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 readFile8(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile8(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile9(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile9(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
       checkId: check17.id,
@@ -5007,7 +5407,7 @@ var check17 = {
 registerCheck(check17);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile9 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 var check18 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
@@ -5025,7 +5425,7 @@ var check18 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile9(file, "utf8");
+        css = await readFile10(file, "utf8");
       } catch {
         continue;
       }
@@ -5046,12 +5446,12 @@ var check18 = {
 registerCheck(check18);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 import postcss2 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 readFile10(configPath, "utf8");
+  const raw = await readFile11(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -5202,7 +5602,7 @@ var check19 = {
         continue;
       let css;
       try {
-        css = await readFile10(absFile, "utf8");
+        css = await readFile11(absFile, "utf8");
       } catch {
         continue;
       }
@@ -5244,14 +5644,14 @@ var check19 = {
 registerCheck(check19);
 
 // src/checks/source/local-refs.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 { dirname as dirname3, resolve as resolve6 } from "node:path";
 
 // src/lib/asset-inline.ts
 import { createHash as createHash3 } from "node:crypto";
-import { readFile as readFile11 } from "node:fs/promises";
-import path3 from "node:path";
+import { readFile as readFile12 } from "node:fs/promises";
+import path4 from "node:path";
 import postcss3 from "postcss";
 var FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
 var HASHED_ASSET_DIR = "assets";
@@ -5292,19 +5692,19 @@ function decodeRef(ref) {
   }
 }
 function toPosix(p) {
-  return p.split(path3.sep).join("/");
+  return p.split(path4.sep).join("/");
 }
 function escapesProjectRoot(projectDir, absPath) {
-  const rel = path3.relative(projectDir, absPath);
-  return rel === ".." || rel.startsWith(`..${path3.sep}`) || path3.isAbsolute(rel);
+  const rel = path4.relative(projectDir, absPath);
+  return rel === ".." || rel.startsWith(`..${path4.sep}`) || path4.isAbsolute(rel);
 }
 function proseImageRefError(ref, projectDir) {
   const cleaned = stripUrlSuffix(decodeRef(ref));
-  if (/^file:/i.test(cleaned) || path3.isAbsolute(cleaned)) {
+  if (/^file:/i.test(cleaned) || path4.isAbsolute(cleaned)) {
     return `Image reference must be relative to the project: ${ref}
 ` + `  Copy the file into your project folder and reference it from there.`;
   }
-  if (escapesProjectRoot(projectDir, path3.resolve(projectDir, cleaned))) {
+  if (escapesProjectRoot(projectDir, path4.resolve(projectDir, cleaned))) {
     return `Image reference points outside the project: ${ref}
 ` + `  Copy the file into your project folder and reference it from there.`;
   }
@@ -5315,7 +5715,7 @@ function mimeFor(ext) {
 }
 async function readOrThrow(absPath, kind, referencedFrom) {
   try {
-    return await readFile11(absPath);
+    return await readFile12(absPath);
   } catch {
     throw new BuildError(`Missing ${kind}: ${absPath}
   referenced from ${referencedFrom}
@@ -5374,12 +5774,12 @@ function importTarget(atRule) {
   return target;
 }
 async function inlineOne(cssPath, copies, warnings, seen) {
-  const abs = path3.resolve(cssPath);
+  const abs = path4.resolve(cssPath);
   if (seen.has(abs))
     return "";
   seen.add(abs);
   const source = await readOrThrow(abs, "stylesheet", "the project manifest");
-  const cssDir = path3.dirname(abs);
+  const cssDir = path4.dirname(abs);
   let root;
   try {
     root = postcss3.parse(source.toString("utf-8"), { from: abs });
@@ -5401,8 +5801,8 @@ async function inlineOne(cssPath, copies, warnings, seen) {
         return null;
       }
       const relPath = stripUrlSuffix(decodeRef(raw));
-      const absAsset = path3.resolve(cssDir, relPath);
-      const ext = path3.extname(absAsset).toLowerCase();
+      const absAsset = path4.resolve(cssDir, relPath);
+      const ext = path4.extname(absAsset).toLowerCase();
       if (FONT_EXTS.has(ext)) {
         const bytes2 = await readOrThrow(absAsset, "font file", abs);
         return dataUri(bytes2, ext);
@@ -5420,7 +5820,7 @@ async function inlineOne(cssPath, copies, warnings, seen) {
       imports.push({ node, target });
   });
   for (const { node, target } of imports) {
-    const importedAbs = path3.resolve(cssDir, stripUrlSuffix(decodeRef(target)));
+    const importedAbs = path4.resolve(cssDir, stripUrlSuffix(decodeRef(target)));
     const inlined = await inlineOne(importedAbs, copies, warnings, seen);
     node.replaceWith(wrapImportConditions(node, postcss3.parse(inlined, { from: importedAbs })));
   }
@@ -5432,10 +5832,10 @@ async function inlineStyles(projectDir, stylePaths) {
   const seen = new Set;
   const parts = [];
   for (const rel of stylePaths) {
-    const abs = path3.resolve(projectDir, rel);
+    const abs = path4.resolve(projectDir, rel);
     const css = await inlineOne(abs, copies, warnings, seen);
     if (css.trim().length > 0) {
-      parts.push(`/* ${toPosix(path3.relative(projectDir, abs))} */
+      parts.push(`/* ${toPosix(path4.relative(projectDir, abs))} */
 ${css.trim()}`);
     }
   }
@@ -5451,14 +5851,14 @@ async function collectStyleDependencies(projectDir, stylePaths) {
   const found = new Set;
   const visited = new Set;
   async function walk(cssPath) {
-    const abs = path3.resolve(cssPath);
+    const abs = path4.resolve(cssPath);
     if (visited.has(abs))
       return;
     visited.add(abs);
     found.add(abs);
     let source;
     try {
-      source = await readFile11(abs, "utf-8");
+      source = await readFile12(abs, "utf-8");
     } catch {
       return;
     }
@@ -5468,14 +5868,14 @@ async function collectStyleDependencies(projectDir, stylePaths) {
     } catch {
       return;
     }
-    const cssDir = path3.dirname(abs);
+    const cssDir = path4.dirname(abs);
     root.walkDecls((decl) => {
       if (!decl.value.includes("url("))
         return;
       for (const raw of extractCssUrls(decl.value)) {
         if (!raw || isNonFilesystemRef(raw))
           continue;
-        found.add(path3.resolve(cssDir, stripUrlSuffix(decodeRef(raw))));
+        found.add(path4.resolve(cssDir, stripUrlSuffix(decodeRef(raw))));
       }
     });
     const imports = [];
@@ -5485,11 +5885,11 @@ async function collectStyleDependencies(projectDir, stylePaths) {
         imports.push(target);
     });
     for (const target of imports) {
-      await walk(path3.resolve(cssDir, stripUrlSuffix(decodeRef(target))));
+      await walk(path4.resolve(cssDir, stripUrlSuffix(decodeRef(target))));
     }
   }
   for (const rel of stylePaths) {
-    await walk(path3.resolve(projectDir, rel));
+    await walk(path4.resolve(projectDir, rel));
   }
   return [...found];
 }
@@ -5506,8 +5906,8 @@ async function planImageCopies(projectDir, refs) {
       continue;
     }
     const cleaned = stripUrlSuffix(decodeRef(ref));
-    const abs = path3.resolve(projectDir, cleaned);
-    const rel = path3.relative(projectDir, abs);
+    const abs = path4.resolve(projectDir, cleaned);
+    const rel = path4.relative(projectDir, abs);
     const dest = toPosix(rel);
     copies.set(dest, { from: abs, to: dest });
     destinations.set(ref, dest);
@@ -5528,18 +5928,18 @@ async function inlineShapeUrls(html, baseDir) {
     if (!raw || isNonFilesystemRef(raw))
       continue;
     const cleaned = stripUrlSuffix(decodeRef(raw));
-    if (path3.isAbsolute(cleaned))
+    if (path4.isAbsolute(cleaned))
       continue;
-    const abs = path3.resolve(baseDir, cleaned);
+    const abs = path4.resolve(baseDir, cleaned);
     if (escapesProjectRoot(baseDir, abs))
       continue;
     let bytes;
     try {
-      bytes = await readFile11(abs);
+      bytes = await readFile12(abs);
     } catch {
       continue;
     }
-    const mime = mimeFor(path3.extname(abs).toLowerCase());
+    const mime = mimeFor(path4.extname(abs).toLowerCase());
     const dataUri2 = `data:${mime};base64,${bytes.toString("base64")}`;
     replacements.set(m[0], `--gp-shape:url(&quot;${dataUri2}&quot;)`);
   }
@@ -5629,7 +6029,7 @@ var check20 = {
     const collectRenderedLocalRefs = createRenderedLocalRefCollector(plugins);
     for (const file of files) {
       try {
-        const content = await readFile12(file, "utf8");
+        const content = await readFile13(file, "utf8");
         for (const { ref, kind, line } of collectRenderedLocalRefs(content)) {
           if (isNonFilesystemRef(ref))
             continue;
@@ -5671,15 +6071,15 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
   const rootRelative = resolve6(projectRoot, cleaned);
   switch (kind) {
     case "image":
-      return existsSync7(rootRelative);
+      return existsSync8(rootRelative);
     case "link":
-      return existsSync7(fileRelative);
+      return existsSync8(fileRelative);
   }
 }
 registerCheck(check20);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile13 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 var check21 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
@@ -5693,7 +6093,7 @@ var check21 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile13(file, "utf8");
+        const content = await readFile14(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -5737,7 +6137,7 @@ function extractImageAlts(line) {
 registerCheck(check21);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 var check22 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
@@ -5751,7 +6151,7 @@ var check22 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile14(file, "utf8");
+        const content = await readFile15(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -5787,7 +6187,7 @@ var check22 = {
 registerCheck(check22);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 var check23 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
@@ -5805,7 +6205,7 @@ var check23 = {
     const md = createMarkdownRenderer(plugins);
     for (const file of files) {
       try {
-        const content = await readFile15(file, "utf8");
+        const content = await readFile16(file, "utf8");
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
@@ -5827,8 +6227,8 @@ var check23 = {
 registerCheck(check23);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile16 } from "node:fs/promises";
-import path4 from "node:path";
+import { readFile as readFile17 } from "node:fs/promises";
+import path5 from "node:path";
 
 // src/checks/asset/extensions.ts
 var RASTER_INSPECTABLE_EXTS = [
@@ -5869,7 +6269,7 @@ var check24 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile16(file, "utf8");
+        content = await readFile17(file, "utf8");
       } catch {
         results.push(inspectionFailed(check24.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -5912,7 +6312,7 @@ var check24 = {
         ignore: [...ASSET_SCAN_IGNORE_GLOBS]
       });
       for (const sibling of siblings.sort()) {
-        const rel = path4.relative(ctx.inputDir, sibling).split(path4.sep).join("/");
+        const rel = path5.relative(ctx.inputDir, sibling).split(path5.sep).join("/");
         results.push(finding(check24.id, {
           severity: "warning",
           code: "kept-both-versions",
@@ -5932,27 +6332,27 @@ registerCheck(check24);
 import { stat as stat3 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat2, readFile as readFile17 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile18 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
-async function inspectImage(path5) {
+async function inspectImage(path6) {
   let st;
   try {
-    st = await stat2(path5);
+    st = await stat2(path6);
   } catch {
     return null;
   }
-  const hit = cache.get(path5);
+  const hit = cache.get(path6);
   if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size)
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile17(path5);
+    const buf = await readFile18(path6);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
   }
-  cache.set(path5, { mtimeMs: st.mtimeMs, size: st.size, info: info2 });
+  cache.set(path6, { mtimeMs: st.mtimeMs, size: st.size, info: info2 });
   return info2;
 }
 function parseImage(b) {
@@ -6406,7 +6806,7 @@ var check30 = {
 registerCheck(check30);
 
 // src/checks/asset/font-license.ts
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { resolve as resolve7 } from "node:path";
 var LICENSE_NAMES = [
   "LICENSE",
@@ -6442,7 +6842,7 @@ var check31 = {
     }
     const results = [];
     for (const fontDir of fontDirs) {
-      const hasLicense = LICENSE_NAMES.some((name) => existsSync8(resolve7(fontDir, name)));
+      const hasLicense = LICENSE_NAMES.some((name) => existsSync9(resolve7(fontDir, name)));
       if (!hasLicense) {
         results.push({
           checkId: check31.id,
@@ -6507,7 +6907,7 @@ var check32 = {
 registerCheck(check32);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 var check33 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
@@ -6524,7 +6924,7 @@ var check33 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile18(file, "utf8");
+        const content = await readFile19(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -6689,11 +7089,11 @@ function reportMissingTools(result) {
 }
 
 // src/lib/validation-exec.ts
-import { existsSync as existsSync9 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 import { dirname as dirname4, join as join3, resolve as resolve8 } from "node:path";
 
 // src/lib/output-paths.ts
-import path5 from "node:path";
+import path6 from "node:path";
 
 // src/lib/slug.ts
 function slugify(name, fallback = "") {
@@ -6711,7 +7111,7 @@ function bookSlug(title) {
   return slugify(title ?? "", "book");
 }
 function resolveOutputDir(manifestDir, title) {
-  return path5.resolve(manifestDir, DIST_DIRNAME, bookSlug(title));
+  return path6.resolve(manifestDir, DIST_DIRNAME, bookSlug(title));
 }
 function artifactName(title, format) {
   return `${bookSlug(title)}-${format}.pdf`;
@@ -6721,7 +7121,7 @@ function artifactName(title, format) {
 var BOOK_HTML_FILENAME = "book.html";
 
 // src/lib/markdown/index.ts
-import { readdir as readdir3, readFile as readFile19, writeFile as writeFile2, mkdir as mkdir2 } from "node:fs/promises";
+import { readdir as readdir3, readFile as readFile20, writeFile as writeFile2, mkdir as mkdir2 } from "node:fs/promises";
 
 // src/lib/remote-auth/sync-messages.ts
 function isOnlineSibling(filepath) {
@@ -6849,7 +7249,7 @@ async function renderChapters(inputDir, opts = {}) {
   }
   return assembleBookHtml({
     files,
-    readText: (relPath) => readFile19(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
+    readText: (relPath) => readFile20(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
     projectCss: inlined.css,
     preloadImages: [...pluginInlined.copies.map((c) => c.to), ...inlined.copies.map((c) => c.to)],
     title: opts.title,
@@ -7214,7 +7614,7 @@ async function executeValidation(args) {
   const targetIds = resolveTargets(parseCsv(typeof args.target === "string" ? args.target : undefined), config.targets);
   const pdfPath = typeof args.pdf === "string" ? resolve8(args.pdf) : undefined;
   const inputDir = typeof args.input === "string" ? resolve8(args.input) : undefined;
-  if (pdfPath && !existsSync9(pdfPath)) {
+  if (pdfPath && !existsSync10(pdfPath)) {
     throw new Error(`File not found: ${pdfPath}`);
   }
   const categories = resolveCategoryArg(typeof args.category === "string" ? args.category : undefined);
@@ -7245,10 +7645,15 @@ async function executeValidation(args) {
     const relMarkdown = await resolveActiveMarkdownFiles(manifestDir, config.source.files);
     markdownFiles = relMarkdown.map((f) => join3(manifestDir, canonicalChapterId(f)));
     const relStyles = await resolveActiveStyles(manifestDir, config.styles);
-    cssFiles = relStyles.map((rel) => resolve8(manifestDir, rel)).filter((f) => !f.endsWith(".min.css"));
+    const projectCssFiles = relStyles.map((rel) => resolve8(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 = join3(outDir, BOOK_HTML_FILENAME);
-    if (existsSync9(possibleHtml)) {
+    if (existsSync10(possibleHtml)) {
       htmlPath = possibleHtml;
     }
   }
@@ -7341,7 +7746,7 @@ function buildPdfSummaryLines(results) {
 }
 
 // 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";
@@ -7349,9 +7754,9 @@ import { randomBytes } from "node:crypto";
 
 // src/lib/build-fingerprint.ts
 import * as fs from "node:fs";
-import { mkdir as mkdir3, readFile as readFile20, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir3, readFile as readFile21, writeFile as writeFile3 } from "node:fs/promises";
 import { createHash as createHash4 } from "node:crypto";
-import path6 from "node:path";
+import path7 from "node:path";
 import git from "isomorphic-git";
 var FINGERPRINT_FILENAME = "build-fingerprint.json";
 var VERSION_TIMEOUT_MS = 4000;
@@ -7400,7 +7805,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 = path6.resolve(dir);
+    const abs = path7.resolve(dir);
     if (seen.has(abs))
       continue;
     seen.add(abs);
@@ -7436,8 +7841,8 @@ async function getEngineBundleHash() {
       getAssetPath("engine/gutterpress-agent.js")
     ]);
     const [viewerBytes, agentBytes] = await Promise.all([
-      readFile20(viewerPath),
-      readFile20(agentPath)
+      readFile21(viewerPath),
+      readFile21(agentPath)
     ]);
     const hash = createHash4("sha256");
     hash.update(viewerBytes);
@@ -7485,8 +7890,8 @@ function sanitizeArgs(args) {
   return out;
 }
 async function writeBuildFingerprint(input) {
-  const outputDir = path6.resolve(input.outputDir);
-  const outPath = path6.join(outputDir, FINGERPRINT_FILENAME);
+  const outputDir = path7.resolve(input.outputDir);
+  const outPath = path7.join(outputDir, FINGERPRINT_FILENAME);
   const [tools, sourceRevision] = await Promise.all([
     getToolVersions(),
     getGitRevision(input.sourceDir)
@@ -7502,7 +7907,7 @@ async function writeBuildFingerprint(input) {
         iccPath: input.pdfx.iccPath,
         stripAnnotations: input.pdfx.stripAnnotations
       },
-      outputDir: input.recordedOutputDir ? path6.resolve(input.recordedOutputDir) : outputDir
+      outputDir: input.recordedOutputDir ? path7.resolve(input.recordedOutputDir) : outputDir
     },
     sourceRevision,
     tools
@@ -7578,7 +7983,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";
 
@@ -7761,8 +8166,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");
@@ -7791,18 +8196,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;
@@ -7813,7 +8218,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
@@ -7821,18 +8226,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>`.");
@@ -7847,10 +8252,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,
@@ -7862,15 +8267,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);
@@ -7881,7 +8303,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") {
@@ -7900,13 +8323,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, {
@@ -7918,7 +8335,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}`);
         }
@@ -7956,9 +8373,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) {
@@ -7974,13 +8391,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
@@ -7991,8 +8408,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") {
@@ -8001,12 +8418,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) {
@@ -8022,7 +8439,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",
@@ -8035,7 +8452,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 });
   }
 }
 
@@ -8044,14 +8461,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-pb6h089e.js");
+      const { buildNativePdf } = await import("./engine-daad33qn.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -8082,7 +8499,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,
@@ -8171,10 +8588,10 @@ function openPath(filePath) {
 }
 
 // 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 readdir4, readFile as readFile21, writeFile as writeFile4 } from "node:fs/promises";
+import { readdir as readdir4, readFile as readFile22, writeFile as writeFile4 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -8196,7 +8613,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>
@@ -8250,7 +8667,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;
@@ -8265,7 +8682,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, {
@@ -8277,12 +8694,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
     });
   }
@@ -8334,23 +8751,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;
@@ -8359,12 +8776,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);
@@ -8372,21 +8789,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);
   }
@@ -8413,7 +8830,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,
@@ -8453,7 +8870,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);
@@ -8474,7 +8891,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))
@@ -8482,8 +8899,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);
@@ -8508,7 +8925,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;
@@ -8529,7 +8946,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;
@@ -8661,7 +9078,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)
@@ -8681,10 +9098,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 readFile21(pidFile, "utf8");
+      const raw = await readFile22(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -8696,10 +9113,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 writeFile4(path10.join(tempDir, PID_FILE_NAME), `${process.pid}
+  await writeFile4(path11.join(tempDir, PID_FILE_NAME), `${process.pid}
 `, "utf8");
   return tempDir;
 }
@@ -8790,12 +9207,12 @@ 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 readFile22, stat as stat4 } from "node:fs/promises";
-import path12 from "path";
+import { readFile as readFile23, stat as stat4 } from "node:fs/promises";
+import path13 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
 // 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",
@@ -8817,9 +9234,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;
@@ -9072,7 +9489,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");
@@ -9080,7 +9497,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile22(filePath);
+    data = await readFile23(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -9093,7 +9510,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);
 }
@@ -9103,7 +9520,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;
@@ -9130,7 +9547,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile22(absPath);
+      data = await readFile23(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -9269,7 +9686,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;
@@ -9469,9 +9886,9 @@ async function startPreviewServer(options) {
 }
 
 // src/lib/theme-manager.ts
-import { cp as cp2, mkdir as mkdir6, readFile as readFile24, readdir as readdir5, stat as stat5, writeFile as writeFile5, rm as rm3 } from "node:fs/promises";
-import { existsSync as existsSync11 } from "node:fs";
-import path14 from "node:path";
+import { cp as cp2, mkdir as mkdir6, readFile as readFile25, readdir as readdir5, stat as stat5, writeFile as writeFile5, rm as rm3 } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
+import path15 from "node:path";
 import { isSeq as isSeq2, Scalar } from "yaml";
 
 // src/lib/fetch-timeout.ts
@@ -9508,20 +9925,20 @@ async function withFetchTimeout(options, run) {
 }
 
 // src/lib/manifest-doc.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir5, open, readFile as readFile23, rename, rm as rm2 } from "node:fs/promises";
-import path13 from "node:path";
+import { mkdir as mkdir5, open, readFile as readFile24, rename, rm as rm2 } from "node:fs/promises";
+import path14 from "node:path";
 import { parseDocument, isSeq, YAMLSeq } from "yaml";
 function resolveManifestPath(projectDir) {
-  const existing = MANIFEST_FILENAMES.find((name) => existsSync10(path13.join(projectDir, name)));
-  return path13.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
+  const existing = MANIFEST_FILENAMES.find((name) => existsSync11(path14.join(projectDir, name)));
+  return path14.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
 }
 async function loadManifestDoc(projectDir) {
   const file = resolveManifestPath(projectDir);
   let text = "";
   try {
-    text = await readFile23(file, "utf8");
+    text = await readFile24(file, "utf8");
   } catch (error2) {
     if (error2.code !== "ENOENT")
       throw error2;
@@ -9529,9 +9946,9 @@ async function loadManifestDoc(projectDir) {
   return { doc: parseDocument(text), file };
 }
 async function writeManifestDoc(file, doc) {
-  const dir = path13.dirname(file);
+  const dir = path14.dirname(file);
   await mkdir5(dir, { recursive: true });
-  const temporary = path13.join(dir, `.${path13.basename(file)}.tmp-${process.pid}-${randomUUID2()}`);
+  const temporary = path14.join(dir, `.${path14.basename(file)}.tmp-${process.pid}-${randomUUID2()}`);
   try {
     const handle = await open(temporary, "wx", 438);
     try {
@@ -9597,29 +10014,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 readFile24(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 (path14.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 {
@@ -9630,7 +10031,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) {
@@ -9640,14 +10044,14 @@ function themeDirFor(projectDir, id) {
   if (typeof id !== "string" || id.length === 0 || themeSlug(id) !== id) {
     throw new Error(`Invalid theme id "${id}".`);
   }
-  return path14.join(projectDir, THEMES_DIR, id);
+  return path15.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(path15.join(await getAssetsDir(), THEMES_DIR, id));
     } catch {
       meta = {};
     }
@@ -9665,20 +10069,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 (!existsSync11(cssPath)) {
+  if (!existsSync12(cssPath)) {
     throw new Error(`Built-in theme "${id}" is missing its theme.css.`);
   }
-  const meta = await readThemeMeta(jsonPath);
+  const meta = await readThemeMeta(path15.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: path14.dirname(cssPath) };
+  return { info: themeInfo(id, "builtin", meta), cssPath, dir: path15.dirname(cssPath) };
 }
 async function listProjectThemes(projectDir) {
-  const root = path14.join(projectDir, THEMES_DIR);
+  const root = path15.join(projectDir, THEMES_DIR);
   let entries;
   try {
     entries = await readdir5(root, { withFileTypes: true });
@@ -9689,10 +10092,10 @@ async function listProjectThemes(projectDir) {
   for (const entry of entries) {
     if (!entry.isDirectory())
       continue;
-    const dir = path14.join(root, entry.name);
-    const meta = await readThemeMeta(path14.join(dir, "theme.json"));
+    const dir = path15.join(root, entry.name);
+    const meta = await readThemeMeta(dir);
     const primary = themeStyleList(meta)[0];
-    if (!existsSync11(path14.join(dir, primary)))
+    if (!existsSync12(path15.join(dir, primary)))
       continue;
     out.push(themeInfo(entry.name, "project", meta));
   }
@@ -9743,10 +10146,10 @@ async function getActiveTheme(projectDir) {
     if (!m)
       continue;
     const id = m[1];
-    const dir = path14.join(projectDir, THEMES_DIR, id);
-    const meta = await readThemeMeta(path14.join(dir, "theme.json"));
+    const dir = path15.join(projectDir, THEMES_DIR, id);
+    const meta = await readThemeMeta(dir);
     const primary = themeStyleList(meta)[0];
-    if (!existsSync11(path14.join(dir, primary)))
+    if (!existsSync12(path15.join(dir, primary)))
       continue;
     return themeInfo(id, "project", meta);
   }
@@ -9784,9 +10187,9 @@ async function getPreviousTheme(projectDir) {
   if (!id)
     return null;
   const dir = themeDirFor(projectDir, id);
-  const meta = await readThemeMeta(path14.join(dir, "theme.json"));
+  const meta = await readThemeMeta(dir);
   const primary = themeStyleList(meta)[0];
-  if (!existsSync11(path14.join(dir, primary)))
+  if (!existsSync12(path15.join(dir, primary)))
     return null;
   const active = await getActiveTheme(projectDir);
   if (active && active.id === id)
@@ -9806,23 +10209,23 @@ async function applyTheme(projectDir, target) {
   if (target.kind === "builtin") {
     const resolved = await resolveBuiltInTheme(target.id);
     let destId = target.id;
-    if (existsSync11(path14.join(projectDir, THEMES_DIR, destId, "theme.css"))) {
+    if (existsSync12(path15.join(projectDir, THEMES_DIR, destId, "theme.css"))) {
       destId = await uniqueThemeId(projectDir, target.id);
     }
-    const destDir = path14.join(projectDir, THEMES_DIR, destId);
+    const destDir = path15.join(projectDir, THEMES_DIR, destId);
     await mkdir6(destDir, { recursive: true });
     await cp2(resolved.dir, destDir, { recursive: true });
-    meta = await readThemeMeta(path14.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(path14.join(dir, "theme.json"));
+    meta = await readThemeMeta(dir);
     assertThemeSheetsContained(meta);
     const primary = themeStyleList(meta)[0];
-    if (!existsSync11(path14.join(dir, primary))) {
+    if (!existsSync12(path15.join(dir, primary))) {
       throw new Error(`Theme "${target.id}" is not present in this project.`);
     }
     resolveDeclaredStyles(themeStyleList(meta), dir, `Theme "${target.id}"`);
@@ -9833,10 +10236,10 @@ async function applyTheme(projectDir, target) {
   return info2;
 }
 async function uniqueThemeId(projectDir, base) {
-  const root = path14.join(projectDir, THEMES_DIR);
+  const root = path15.join(projectDir, THEMES_DIR);
   let id = themeSlug(base);
   let n = 2;
-  while (existsSync11(path14.join(root, id))) {
+  while (existsSync12(path15.join(root, id))) {
     id = `${themeSlug(base)}-${n++}`;
   }
   return id;
@@ -9851,20 +10254,20 @@ async function importThemeFromFolder(projectDir, sourceDir) {
   if (!info2.isDirectory()) {
     throw new Error("The chosen path is not a folder.");
   }
-  const meta = await readThemeMeta(path14.join(sourceDir, "theme.json"));
+  const meta = await readThemeMeta(sourceDir);
   assertThemeSheetsContained(meta);
   const primary = themeStyleList(meta)[0];
-  if (!existsSync11(path14.join(sourceDir, primary))) {
+  if (!existsSync12(path15.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 || path14.basename(sourceDir);
+  const base = meta.name || path15.basename(sourceDir);
   const id = await uniqueThemeId(projectDir, base);
-  const destDir = path14.join(projectDir, THEMES_DIR, id);
-  await mkdir6(path14.dirname(destDir), { recursive: true });
+  const destDir = path15.join(projectDir, THEMES_DIR, id);
+  await mkdir6(path15.dirname(destDir), { recursive: true });
   await cp2(sourceDir, destDir, { recursive: true });
-  return themeInfo(id, "project", await readThemeMeta(path14.join(destDir, "theme.json")));
+  return themeInfo(id, "project", await readThemeMeta(destDir));
 }
 function looksLikeCssUrl(url) {
   try {
@@ -9911,7 +10314,7 @@ async function importThemeFromUrl(projectDir, url) {
   let baseName;
   if (looksLikeCssUrl(trimmed)) {
     css = await fetchText(trimmed);
-    baseName = path14.basename(new URL(trimmed, "https://x/").pathname, ".css") || "theme";
+    baseName = path15.basename(new URL(trimmed, "https://x/").pathname, ".css") || "theme";
   } else {
     const base = trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
     css = await fetchText(`${base}theme.css`);
@@ -9921,41 +10324,41 @@ async function importThemeFromUrl(projectDir, url) {
       if (parsed && typeof parsed === "object")
         meta = parsed;
     } catch {}
-    baseName = meta.name || path14.basename(new URL(base, "https://x/").pathname.replace(/\/$/, "")) || "theme";
+    baseName = meta.name || path15.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 = path14.join(projectDir, THEMES_DIR, id);
+  const destDir = path15.join(projectDir, THEMES_DIR, id);
   await mkdir6(destDir, { recursive: true });
-  await writeFile5(path14.join(destDir, "theme.css"), css, "utf8");
+  await writeFile5(path15.join(destDir, "theme.css"), css, "utf8");
   const finalMeta = {
     name: meta.name || prettify(id),
     author: meta.author,
     description: meta.description,
     preview: meta.preview ?? null
   };
-  await writeFile5(path14.join(destDir, "theme.json"), JSON.stringify(finalMeta, null, 2), "utf8");
+  await writeFile5(path15.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 readFile24(resolved.cssPath, "utf8");
+    return readFile25(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(path14.join(dir, "theme.json"));
+  const meta = await readThemeMeta(dir);
   const sheets = themeStyleList(meta);
   const parts = [];
   for (const rel of sheets) {
-    const sheetPath = path14.join(dir, rel);
-    if (!existsSync11(sheetPath))
+    const sheetPath = path15.join(dir, rel);
+    if (!existsSync12(sheetPath))
       continue;
-    parts.push(await readFile24(sheetPath, "utf8"));
+    parts.push(await readFile25(sheetPath, "utf8"));
   }
   if (parts.length === 0) {
     throw new Error(`Theme "${source.id}" has no ${sheets[0]} in this project.`);
@@ -9966,7 +10369,7 @@ async function readThemeCss(projectDir, source) {
 }
 async function removeProjectTheme(projectDir, id) {
   const dir = themeDirFor(projectDir, id);
-  if (existsSync11(dir)) {
+  if (existsSync12(dir)) {
     await rm3(dir, { recursive: true, force: true });
   }
   const { doc, file } = await loadManifestDoc(projectDir);
@@ -10004,7 +10407,7 @@ async function detectLegacyForkedTheme(projectDir, active) {
     return null;
   let bookCss;
   try {
-    bookCss = await readFile24(path14.join(projectDir, "styles", "book.css"), "utf8");
+    bookCss = await readFile25(path15.join(projectDir, "styles", "book.css"), "utf8");
   } catch {
     return null;
   }
@@ -10024,9 +10427,9 @@ async function detectLegacyForkedTheme(projectDir, active) {
 }
 
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp3, mkdir as mkdir7, readdir as readdir6, readFile as readFile25, stat as stat6, writeFile as writeFile6 } from "node:fs/promises";
-import { constants as FS, existsSync as existsSync12 } from "node:fs";
-import path15 from "node:path";
+import { access, copyFile, cp as cp3, mkdir as mkdir7, readdir as readdir6, readFile as readFile26, stat as stat6, writeFile as writeFile6 } from "node:fs/promises";
+import { constants as FS, existsSync as existsSync13 } from "node:fs";
+import path16 from "node:path";
 var STARTER_THEME_FOR_TEMPLATE = {
   book: "clean-book",
   zine: "zine",
@@ -10106,7 +10509,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 || !path15.isAbsolute(parentDir)) {
+  if (!parentDir || !path16.isAbsolute(parentDir)) {
     throw new CreateProjectErrorImpl("parent-not-writable", "The save location must be an absolute path.");
   }
   try {
@@ -10114,7 +10517,7 @@ async function scaffoldProject(options) {
   } catch {
     throw new CreateProjectErrorImpl("parent-not-writable", `The chosen save location can't be written to: ${parentDir}`);
   }
-  const projectDir = path15.join(parentDir, folderName);
+  const projectDir = path16.join(parentDir, folderName);
   let targetExists = true;
   try {
     await access(projectDir, FS.F_OK);
@@ -10136,17 +10539,17 @@ async function scaffoldProject(options) {
       for (const entry of entries) {
         if (entry.name === ".gutterpress-template.json")
           continue;
-        await cp3(path15.join(customTemplateDir, entry.name), path15.join(projectDir, entry.name), { recursive: true });
+        await cp3(path16.join(customTemplateDir, entry.name), path16.join(projectDir, entry.name), { recursive: true });
       }
-      await mkdir7(path15.join(projectDir, "assets"), { recursive: true });
+      await mkdir7(path16.join(projectDir, "assets"), { recursive: true });
     } else {
       const tplManifest = await getAssetPath(`templates/${template}/manifest.yaml`);
       const tplChapter = await getAssetPath(`templates/${template}/chapter-01.md`);
-      await mkdir7(path15.join(projectDir, "assets"), { recursive: true });
-      await copyFile(tplManifest, path15.join(projectDir, MANIFEST_FILENAMES[0]));
-      await copyFile(tplChapter, path15.join(projectDir, "chapter-01.md"));
-      await mkdir7(path15.join(projectDir, "styles"), { recursive: true });
-      await writeFile6(path15.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
+      await mkdir7(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 mkdir7(path16.join(projectDir, "styles"), { recursive: true });
+      await writeFile6(path16.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)}`);
@@ -10156,13 +10559,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) => path15.join(projectDir, name2)).find(existsSync12) ?? path15.join(projectDir, MANIFEST_FILENAMES[0]);
+  const manifestPath = MANIFEST_FILENAMES.map((name2) => path16.join(projectDir, name2)).find(existsSync13) ?? path16.join(projectDir, MANIFEST_FILENAMES[0]);
   const author = (options.author ?? "").trim() || DEFAULT_AUTHOR;
   const substitutions = {
     "{{TITLE}}": escapeYamlScalar(name),
     "{{AUTHOR}}": escapeYamlScalar(author)
   };
-  let openFile = path15.join(projectDir, "chapter-01.md");
+  let openFile = path16.join(projectDir, "chapter-01.md");
   try {
     await fillTemplateFile(manifestPath, substitutions);
     if (!customTemplateDir) {
@@ -10186,7 +10589,7 @@ async function scaffoldProject(options) {
     }
     const firstSource = await firstSourceFile(manifestPath);
     if (firstSource)
-      openFile = path15.join(projectDir, firstSource);
+      openFile = path16.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)}`);
@@ -10208,7 +10611,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 ${path15.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 ${path16.basename(enclosingRepoDir)}'s shared version history; save a snapshot to record it.` : e instanceof Error ? e.message : String(e);
     }
   }
   const result = {
@@ -10223,10 +10626,10 @@ async function scaffoldProject(options) {
   return result;
 }
 async function ensureGitignoreHasDist(projectDir) {
-  const gitignorePath = path15.join(projectDir, ".gitignore");
+  const gitignorePath = path16.join(projectDir, ".gitignore");
   let existing = null;
   try {
-    existing = await readFile25(gitignorePath, "utf8");
+    existing = await readFile26(gitignorePath, "utf8");
   } catch {}
   if (existing === null) {
     await writeFile6(gitignorePath, `dist/
@@ -10246,7 +10649,7 @@ async function ensureGitignoreHasDist(projectDir) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile25(manifestPath, "utf8");
+    text = await readFile26(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -10258,13 +10661,158 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile25(filePath, "utf8");
+  let text = await readFile26(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
   await writeFile6(filePath, text, "utf8");
 }
 
+// src/lib/extension-scaffold.ts
+import { access as access2, mkdir as mkdir8, readFile as readFile27, writeFile as writeFile7 } from "node:fs/promises";
+import { constants as FS2 } from "node:fs";
+import path17 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 || !path17.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 = path17.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 mkdir8(extensionDir, { recursive: true });
+    for (const [assetName, relDest] of entries) {
+      const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
+      const dest = path17.join(extensionDir, relDest);
+      await mkdir8(path17.dirname(dest), { recursive: true });
+      const text = await readFile27(src, "utf8");
+      const table = relDest.endsWith(".json") ? jsonSafe : plain;
+      await writeFile7(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: path17.join(extensionDir, "gutterpress.json"),
+    kind,
+    slug,
+    prefix,
+    openFile: path17.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 { isMap, isScalar, isSeq as isSeq3, parseDocument as parseDocument2 } from "yaml";
 var BUILT_IN_TEMPLATE_IDS = [
@@ -10283,7 +10831,7 @@ var SKIP_ENTRIES = new Set([
 ]);
 
 // src/lib/plugin-manager.ts
-import path17 from "node:path";
+import path19 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
@@ -10291,15 +10839,15 @@ import { createHash as createHash7, randomUUID as randomUUID3, timingSafeEqual }
 import { createReadStream as createReadStream2 } from "node:fs";
 import {
   lstat as lstat2,
-  mkdir as mkdir8,
+  mkdir as mkdir9,
   mkdtemp as mkdtemp2,
   open as open2,
-  readFile as readFile26,
+  readFile as readFile28,
   realpath as realpath2,
   rename as rename2,
   rm as rm4
 } from "node:fs/promises";
-import path16 from "node:path";
+import path18 from "node:path";
 import { Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createGunzip } from "node:zlib";
@@ -10344,8 +10892,8 @@ function mb(bytes) {
   return `${Math.ceil(bytes / 1024 / 1024)}MB`;
 }
 function isContained2(root, candidate) {
-  const relative2 = path16.relative(root, candidate);
-  return relative2 === "" || !relative2.startsWith("..") && !path16.isAbsolute(relative2);
+  const relative2 = path18.relative(root, candidate);
+  return relative2 === "" || !relative2.startsWith("..") && !path18.isAbsolute(relative2);
 }
 function mergeLimits(overrides) {
   const limits = { ...DEFAULT_LIMITS, ...overrides };
@@ -10579,7 +11127,7 @@ async function extractTarball(ctx, archivePath, packageDir, packageName) {
     "OldGnuLongPath",
     "OldExtendedHeader"
   ]);
-  await mkdir8(packageDir, { recursive: true });
+  await mkdir9(packageDir, { recursive: true });
   const unpack = extract({
     cwd: packageDir,
     strip: 1,
@@ -10652,13 +11200,13 @@ async function extractTarball(ctx, archivePath, packageDir, packageName) {
     throw rejected;
 }
 async function readInstalledManifest(packageDir, selected) {
-  const packageJsonPath = path16.join(packageDir, "package.json");
+  const packageJsonPath = path18.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 readFile26(packageJsonPath, "utf8")));
+    manifest = object2(JSON.parse(await readFile28(packageJsonPath, "utf8")));
   } catch (error2) {
     throw new SecurityInstallError(`Downloaded ${selected.name}@${selected.version} has no valid package.json (${error2 instanceof Error ? error2.message : String(error2)}).`);
   }
@@ -10728,10 +11276,10 @@ 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 = path16.join(ctx.stageRoot, ...relativePath.split("/"));
-  const archivePath = path16.join(ctx.downloadsDir, `${ctx.archiveCounter++}.tgz`);
+  const packageDir = path18.join(ctx.stageRoot, ...relativePath.split("/"));
+  const archivePath = path18.join(ctx.downloadsDir, `${ctx.archiveCounter++}.tgz`);
   try {
-    await mkdir8(path16.dirname(packageDir), { recursive: true });
+    await mkdir9(path18.dirname(packageDir), { recursive: true });
     await downloadTarball(ctx, selected, archivePath);
     await extractTarball(ctx, archivePath, packageDir, selected.name);
     const manifest = await readInstalledManifest(packageDir, selected);
@@ -10826,14 +11374,14 @@ async function ensureDirectory(pathname) {
   } catch (error2) {
     if (error2.code !== "ENOENT")
       throw error2;
-    await mkdir8(pathname);
+    await mkdir9(pathname);
   }
 }
 async function prepareVendorParent(projectDir, name) {
-  const plugins = path16.join(projectDir, PLUGINS_DIR);
-  const npm = path16.join(plugins, VENDORED_NPM_DIR);
-  const packageParent = path16.dirname(vendoredNpmPluginRoot(projectDir, name, "0.0.0"));
-  await mkdir8(projectDir, { recursive: true });
+  const plugins = path18.join(projectDir, PLUGINS_DIR);
+  const npm = path18.join(plugins, VENDORED_NPM_DIR);
+  const packageParent = path18.dirname(vendoredNpmPluginRoot(projectDir, name, "0.0.0"));
+  await mkdir9(projectDir, { recursive: true });
   await ensureDirectory(plugins);
   await ensureDirectory(npm);
   await ensureDirectory(packageParent);
@@ -10860,15 +11408,15 @@ function publicReceipt(record) {
   };
 }
 async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
-  const requestedProjectDir = path16.resolve(projectDirInput);
-  await mkdir8(requestedProjectDir, { recursive: true });
+  const requestedProjectDir = path18.resolve(projectDirInput);
+  await mkdir9(requestedProjectDir, { recursive: true });
   const projectDir = await realpath2(requestedProjectDir);
   const requested = parseNpmPluginSpec(packageSpec);
   const npmRoot = await prepareVendorParent(projectDir, requested.name);
-  const container = await mkdtemp2(path16.join(npmRoot, ".install-"));
-  const stageRoot = path16.join(container, "root");
-  const downloadsDir = path16.join(container, "downloads");
-  await Promise.all([mkdir8(stageRoot), mkdir8(downloadsDir)]);
+  const container = await mkdtemp2(path18.join(npmRoot, ".install-"));
+  const stageRoot = path18.join(container, "root");
+  const downloadsDir = path18.join(container, "downloads");
+  await Promise.all([mkdir9(stageRoot), mkdir9(downloadsDir)]);
   const ctx = {
     fetch: options.fetch ?? globalThis.fetch,
     signal: options.signal,
@@ -10913,7 +11461,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
       skipped: ctx.skipped,
       tree: { algorithm: "sha256", ...tree }
     };
-    const receiptFile = await open2(path16.join(stageRoot, VENDOR_RECEIPT_FILE), "wx");
+    const receiptFile = await open2(path18.join(stageRoot, VENDOR_RECEIPT_FILE), "wx");
     try {
       await receiptFile.writeFile(`${JSON.stringify(receipt, null, 2)}
 `, "utf8");
@@ -10922,7 +11470,7 @@ async function installNpmPlugin(projectDirInput, packageSpec, options = {}) {
       await receiptFile.close();
     }
     finalRoot = vendoredNpmPluginRoot(projectDir, rootRecord.name, rootRecord.version);
-    const realFinalParent = await realpath2(path16.dirname(finalRoot));
+    const realFinalParent = await realpath2(path18.dirname(finalRoot));
     if (!isContained2(projectDir, realFinalParent)) {
       throw new Error("Plugin install destination resolves outside the project.");
     }
@@ -10971,7 +11519,7 @@ async function rollbackNpmPluginInstall(installed) {
 // src/lib/plugin-manager.ts
 var pluginMutationQueues = new Map;
 function withPluginMutationLock(projectDir, mutation) {
-  const resolved = path17.resolve(projectDir);
+  const resolved = path19.resolve(projectDir);
   const key = process.platform === "win32" ? resolved.toLowerCase() : resolved;
   const previous = pluginMutationQueues.get(key) ?? Promise.resolve();
   const run = previous.then(mutation, mutation);
@@ -11171,10 +11719,10 @@ async function addNpmPluginUnlocked(projectDir, packageSpec, options) {
 }
 
 // src/lib/theme-import.ts
-import { existsSync as existsSync13 } from "node:fs";
-import { mkdir as mkdir9, mkdtemp as mkdtemp3, readFile as readFile27, rm as rm5, writeFile as writeFile7 } from "node:fs/promises";
+import { existsSync as existsSync14 } from "node:fs";
+import { mkdir as mkdir10, mkdtemp as mkdtemp3, readFile as readFile29, rm as rm5, writeFile as writeFile8 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
-import path18 from "node:path";
+import path20 from "node:path";
 import { unzipSync } from "fflate";
 var MAX_THEME_ARCHIVE_BYTES = 25 * 1024 * 1024;
 var MAX_THEME_UNZIPPED_BYTES = 25 * 1024 * 1024;
@@ -11207,7 +11755,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",
@@ -11223,8 +11771,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;
@@ -11236,20 +11788,12 @@ function unexpectedThemeFiles(relPaths) {
 function mb2(n) {
   return `${Math.round(n / (1024 * 1024))}MB`;
 }
-async function readThemeJson(p) {
-  try {
-    const parsed = JSON.parse(await readFile27(p, "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
 async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
-  const cssPath = path18.join(sourceDir, "theme.css");
-  if (!existsSync13(cssPath)) {
+  const cssPath = path20.join(sourceDir, "theme.css");
+  if (!existsSync14(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile27(cssPath, "utf8");
+  const css = await readFile29(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -11258,29 +11802,29 @@ async function finalizeThemeImport(projectDir, sourceDir, relPaths) {
   for (const w of printFindings) {
     warnings.push({ code: "print-safety", message: w.message });
   }
-  const jsonPath = path18.join(sourceDir, "theme.json");
-  const jsonExists = existsSync13(jsonPath);
-  const meta = jsonExists ? await readThemeJson(jsonPath) : {};
-  if (!jsonExists) {
+  const metaExists = existsSync14(path20.join(sourceDir, EXTENSION_MANIFEST_FILENAME)) || existsSync14(path20.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 = existsSync14(path20.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 readFile27(sheetPath, "utf8");
+    const sheetCss = await readFile29(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -11289,7 +11833,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({
@@ -11341,7 +11886,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(path18.join(tmpdir3(), "gutterpress-theme-"));
+  const tmp = await mkdtemp3(path20.join(tmpdir3(), "gutterpress-theme-"));
   try {
     const relPaths = [];
     for (const [name, data] of Object.entries(files)) {
@@ -11353,13 +11898,13 @@ async function importThemeFromZip(projectDir, archive) {
       const rel = prefix ? norm.slice(prefix.length) : norm;
       if (!rel || rel.split("/").some((seg) => seg === ".."))
         continue;
-      const dest = path18.join(tmp, rel);
-      if (dest !== tmp && !dest.startsWith(tmp + path18.sep)) {
+      const dest = path20.join(tmp, rel);
+      if (dest !== tmp && !dest.startsWith(tmp + path20.sep)) {
         throw new Error(`The package contains an unsafe path and was rejected: ${name}`);
       }
       relPaths.push(rel);
-      await mkdir9(path18.dirname(dest), { recursive: true });
-      await writeFile7(dest, data);
+      await mkdir10(path20.dirname(dest), { recursive: true });
+      await writeFile8(dest, data);
     }
     return await finalizeThemeImport(projectDir, tmp, relPaths);
   } finally {
@@ -11372,10 +11917,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(path18.join(tmpdir3(), "gutterpress-theme-"));
+  const tmp = await mkdtemp3(path20.join(tmpdir3(), "gutterpress-theme-"));
   try {
-    await writeFile7(path18.join(tmp, "theme.css"), css, "utf8");
-    await writeFile7(path18.join(tmp, "theme.json"), JSON.stringify({ name: displayName }, null, 2), "utf8");
+    await writeFile8(path20.join(tmp, "theme.css"), css, "utf8");
+    await writeFile8(path20.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",
@@ -11387,14 +11932,14 @@ async function importThemeFromCssText(projectDir, css, name) {
   }
 }
 async function importThemeFromFile(projectDir, filePath) {
-  const ext = path18.extname(filePath).toLowerCase();
+  const ext = path20.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile27(filePath);
+    const buf = await readFile29(filePath);
     return importThemeFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile27(filePath, "utf8");
-    return importThemeFromCssText(projectDir, css, prettify(path18.basename(filePath, ".css")));
+    const css = await readFile29(filePath, "utf8");
+    return importThemeFromCssText(projectDir, css, prettify(path20.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip theme package or a .css stylesheet.");
 }
@@ -11903,25 +12448,25 @@ ${tail}` : ""}`);
 };
 
 // src/lib/publish/providers/guided.ts
-import { copyFile as copyFile2, mkdir as mkdir10, writeFile as writeFile8 } from "node:fs/promises";
-import path19 from "node:path";
+import { copyFile as copyFile2, mkdir as mkdir11, writeFile as writeFile9 } from "node:fs/promises";
+import path21 from "node:path";
 async function stageGuidedPackage(req, providerId, listingLines) {
-  const packageDir = path19.join(path19.dirname(req.artifact.path), "publish", providerId);
-  await mkdir10(packageDir, { recursive: true });
-  await copyFile2(req.artifact.path, path19.join(packageDir, path19.basename(req.artifact.path)));
+  const packageDir = path21.join(path21.dirname(req.artifact.path), "publish", providerId);
+  await mkdir11(packageDir, { recursive: true });
+  await copyFile2(req.artifact.path, path21.join(packageDir, path21.basename(req.artifact.path)));
   const { title, authors } = req.project;
   const sheet = [
     `# ${title || "Untitled"}`,
     "",
     `- **Authors:** ${authors.length ? authors.join(", ") : "(not set)"}`,
-    `- **File:** ${path19.basename(req.artifact.path)}`,
+    `- **File:** ${path21.basename(req.artifact.path)}`,
     ...listingLines,
     "",
     "Copy these details into the platform's listing form when uploading.",
     ""
   ].join(`
 `);
-  await writeFile8(path19.join(packageDir, "LISTING.md"), sheet, "utf8");
+  await writeFile9(path21.join(packageDir, "LISTING.md"), sheet, "utf8");
   return packageDir;
 }
 
@@ -11984,9 +12529,9 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp4, readFile as readFile28, readdir as readdir7, rm as rm6, stat as stat7, writeFile as writeFile9 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile30, readdir as readdir7, rm as rm6, stat as stat7, writeFile as writeFile10 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import path20 from "node:path";
+import path22 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
 
 // src/lib/publish/google-drive.ts
@@ -12371,34 +12916,34 @@ function zipEntriesNonBlocking(entries, opts) {
 async function collectZipEntries(root, dir, out, onWarn) {
   const entries = await readdir7(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const full = path20.join(dir, entry.name);
+    const full = path22.join(dir, entry.name);
     if (entry.isDirectory()) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
-      const rel = path20.relative(root, full).split(path20.sep).join("/");
-      out[rel] = await readFile28(full);
+      const rel = path22.relative(root, full).split(path22.sep).join("/");
+      out[rel] = await readFile30(full);
     } else if (entry.isSymbolicLink()) {
       const resolved = await stat7(full).catch(() => null);
       if (resolved?.isFile()) {
-        const rel = path20.relative(root, full).split(path20.sep).join("/");
-        out[rel] = await readFile28(full);
+        const rel = path22.relative(root, full).split(path22.sep).join("/");
+        out[rel] = await readFile30(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
-        onWarn?.(`Skipped "${path20.relative(root, full)}" in the website export — it's a broken symlink.`);
+        onWarn?.(`Skipped "${path22.relative(root, full)}" in the website export — it's a broken symlink.`);
       }
     } else {
-      onWarn?.(`Skipped "${path20.relative(root, full)}" in the website export — not a file, folder, or symlink.`);
+      onWarn?.(`Skipped "${path22.relative(root, full)}" in the website export — not a file, folder, or symlink.`);
     }
   }
 }
-async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile9) {
+async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile10) {
   const entries = {};
   await collectZipEntries(exportDir, exportDir, entries, onWarn);
   const fileName = `${bookSlug(title)}-website.zip`;
-  const tmpRoot = await mkdtemp4(path20.join(tmpdir4(), "gutterpress-gdrive-"));
+  const tmpRoot = await mkdtemp4(path22.join(tmpdir4(), "gutterpress-gdrive-"));
   try {
-    const filePath = path20.join(tmpRoot, fileName);
+    const filePath = path22.join(tmpRoot, fileName);
     const zipped = await zipEntriesNonBlocking(entries, { level: 6 });
     await writeArchiveImpl(filePath, zipped);
     return {
@@ -12446,7 +12991,7 @@ 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: path20.basename(req.artifact.path),
+      fileName: path22.basename(req.artifact.path),
       mimeType: "application/pdf",
       cleanup: async () => {}
     };
@@ -12496,8 +13041,8 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod, mkdir as mkdir11, stat as stat8, writeFile as writeFile10 } from "node:fs/promises";
-import path21 from "node:path";
+import { chmod, mkdir as mkdir12, stat as stat8, writeFile as writeFile11 } from "node:fs/promises";
+import path23 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
 function butlerBrothChannel(platform = process.platform, arch = process.arch) {
@@ -12534,8 +13079,8 @@ async function ensureButler(deps) {
   }
   if (await commandExists("butler", runCommand, deps.env))
     return "butler";
-  const cacheDir = path21.join(deps.configDir ?? defaultConfigDir(), "tools", "butler");
-  const cached = path21.join(cacheDir, butlerBinaryName());
+  const cacheDir = path23.join(deps.configDir ?? defaultConfigDir(), "tools", "butler");
+  const cached = path23.join(cacheDir, butlerBinaryName());
   if (await fileExists2(cached))
     return cached;
   const channel = butlerBrothChannel();
@@ -12557,14 +13102,14 @@ async function ensureButler(deps) {
     return new Uint8Array(await response.arrayBuffer());
   });
   const files = unzipSync2(archive);
-  await mkdir11(cacheDir, { recursive: true });
+  await mkdir12(cacheDir, { recursive: true });
   let foundBinary = false;
   for (const [name, data] of Object.entries(files)) {
     if (name.endsWith("/"))
       continue;
-    const target = path21.join(cacheDir, path21.basename(name));
-    await writeFile10(target, data);
-    if (path21.basename(name) === butlerBinaryName()) {
+    const target = path23.join(cacheDir, path23.basename(name));
+    await writeFile11(target, data);
+    if (path23.basename(name) === butlerBinaryName()) {
       await chmod(target, 493).catch(() => {});
       foundBinary = true;
     }
@@ -12994,7 +13539,7 @@ function publishProviderFor(id) {
 
 // src/lib/publish/run-publish.ts
 import { readdir as readdir8, stat as stat9 } from "node:fs/promises";
-import path22 from "node:path";
+import path24 from "node:path";
 function resolvePublishFormat(info8, providerConfig) {
   if (info8.formats && info8.formats.length > 0) {
     const configured = typeof providerConfig.format === "string" ? providerConfig.format.trim() : "";
@@ -13015,9 +13560,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" ? path22.join(outDir, artifactName(config.title, "pdf")) : outDir;
+  const defaultArtifact = effectiveFormat === "pdf" ? path24.join(outDir, artifactName(config.title, "pdf")) : outDir;
   const artifact = {
-    path: options.artifactPath ? path22.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
+    path: options.artifactPath ? path24.resolve(options.projectDir, options.artifactPath) : defaultArtifact,
     format: effectiveFormat
   };
   return {
@@ -13081,7 +13626,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat9(path22.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat9(path24.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -13313,17 +13858,17 @@ import git6 from "isomorphic-git";
 import git5 from "isomorphic-git";
 import diff3Merge from "diff3";
 // src/lib/publish/selections.ts
-import { chmod as chmod2, mkdir as mkdir12, readFile as readFile29, writeFile as writeFile11 } from "node:fs/promises";
-import path23 from "node:path";
+import { chmod as chmod2, mkdir as mkdir13, readFile as readFile31, writeFile as writeFile12 } from "node:fs/promises";
+import path25 from "node:path";
 class PublishSelectionsStore {
   filePath;
   queue = Promise.resolve();
   constructor(filePath) {
-    this.filePath = filePath ?? path23.join(defaultConfigDir(), "publish-selections.json");
+    this.filePath = filePath ?? path25.join(defaultConfigDir(), "publish-selections.json");
   }
   async read() {
     try {
-      const raw = await readFile29(this.filePath, "utf8");
+      const raw = await readFile31(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {
@@ -13336,8 +13881,8 @@ class PublishSelectionsStore {
     return { version: 1, global: {}, projects: {} };
   }
   async write(data) {
-    await mkdir12(path23.dirname(this.filePath), { recursive: true });
-    await writeFile11(this.filePath, JSON.stringify(data, null, 2), {
+    await mkdir13(path25.dirname(this.filePath), { recursive: true });
+    await writeFile12(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384
     });
@@ -13402,4 +13947,4 @@ function normalizeProjectKey(projectDir) {
 }
 // src/lib/publish/manifest-publish.ts
 import { isMap as isMap4 } from "yaml";
-export { PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, loadManifestWithPath, parseNpmPluginSpec, runLint, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, BUILT_IN_THEME_IDS, listBuiltInThemes, listProjectThemes, getActiveTheme, getPreviousTheme, revertTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, removeProjectTheme, detectLegacyForkedTheme, scaffoldProject, BUILT_IN_TEMPLATE_IDS, addNpmPlugin, importThemeFromFile, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listPublishProviders, publishProviderFor, resolvePublishFormat, runPublish, connectPublishProvider, disconnectPublishCredential };
+export { PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, loadManifestWithPath, parseNpmPluginSpec, runLint, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, BUILT_IN_THEME_IDS, listBuiltInThemes, listProjectThemes, getActiveTheme, getPreviousTheme, revertTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, removeProjectTheme, detectLegacyForkedTheme, scaffoldProject, EXTENSION_KINDS, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, addNpmPlugin, importThemeFromFile, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listPublishProviders, publishProviderFor, resolvePublishFormat, runPublish, connectPublishProvider, disconnectPublishCredential };