gutterpress 0.11.15-alpha.2 → 0.11.16-alpha.1

package/dist/{index-j77039xr.js → index-azdfgy3t.js}

@@ -4,7 +4,7 @@ import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./index-w6tqhafk.js";
+} from "./index-eawjxgkn.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -855,6 +855,133 @@ function warn(env, line, type, message, marker) {
     env.layoutWarnings = [];
   env.layoutWarnings.push({ line, type, message, marker });
 }
+var COMPONENT_SEVERITIES = ["error", "warning", "info"];
+function blockEnd(tokens, i) {
+  if (tokens[i].nesting !== 1)
+    return i;
+  let depth = 0;
+  for (let j = i;j < tokens.length; j++) {
+    depth += tokens[j].nesting;
+    if (depth === 0)
+      return j;
+  }
+  return tokens.length - 1;
+}
+function inlineText(tokens, from, to) {
+  const parts = [];
+  for (let k = from;k <= to; k++)
+    if (tokens[k].type === "inline")
+      parts.push(tokens[k].content);
+  return parts.join(`
+`);
+}
+function soleImage(inline) {
+  const parts = (inline && inline.children || []).filter((c) => c.type !== "softbreak" && !(c.type === "text" && !c.content.trim()));
+  return parts.length === 1 && parts[0].type === "image" ? parts[0] : null;
+}
+function toComponentBlocks(tokens, fallbackLine) {
+  const blocks = [];
+  for (let i = 0;i < tokens.length; i++) {
+    const tok = tokens[i];
+    const end = blockEnd(tokens, i);
+    const line = tok.map ? tok.map[0] + 1 : tok.meta && tok.meta.line || fallbackLine;
+    switch (tok.type) {
+      case "heading_open":
+        blocks.push({ type: "heading", level: Number(tok.tag.slice(1)), text: inlineText(tokens, i, end), line });
+        break;
+      case "paragraph_open": {
+        const image = soleImage(tokens[i + 1]);
+        blocks.push(image ? { type: "image", alt: image.content, src: image.attrGet("src") || "", line } : { type: "paragraph", text: inlineText(tokens, i, end), line });
+        break;
+      }
+      case "bullet_list_open":
+      case "ordered_list_open": {
+        const items = [];
+        for (let k = i + 1;k < end; k++) {
+          if (tokens[k].type !== "list_item_open" || tokens[k].level !== tok.level + 1)
+            continue;
+          const itemEnd = blockEnd(tokens, k);
+          const first = tokens.slice(k + 1, itemEnd).find((t) => t.type === "inline");
+          items.push(first ? first.content : "");
+          k = itemEnd;
+        }
+        blocks.push({ type: "list", ordered: tok.type === "ordered_list_open", items, line });
+        break;
+      }
+      case "blockquote_open":
+        blocks.push({ type: "quote", text: inlineText(tokens, i, end), line });
+        break;
+      case "fence":
+      case "code_block":
+        blocks.push({ type: "code", lang: (tok.info || "").trim().split(/\s+/)[0] || "", text: tok.content, line });
+        break;
+      case "table_open":
+        blocks.push({ type: "table", line });
+        break;
+      case "hr":
+        blocks.push({ type: "rule", line });
+        break;
+      case "html_block":
+        blocks.push({ type: "html", text: tok.content, line });
+        break;
+      case "layout_component_open":
+        blocks.push({ type: "component", name: tok.meta.component, line });
+        break;
+      default:
+        blocks.push({ type: tok.type.replace(/_open$/, ""), line });
+    }
+    i = end;
+  }
+  return blocks;
+}
+function runComponentValidate(env, decl, meta, tokens, lines) {
+  const name = meta.component;
+  const line = meta.line || 0;
+  const report = (at, type, message, severity) => {
+    if (!env.layoutWarnings)
+      env.layoutWarnings = [];
+    env.layoutWarnings.push(severity ? { line: at, type, message, severity } : { line: at, type, message });
+  };
+  const failed = (why) => report(line, "component_validate_failed", `@${name}: plugin "${decl.validateOwner}"'s validate() ${why}`);
+  let lastLine = line;
+  for (const t of tokens)
+    if (t.map && t.map[1] > lastLine)
+      lastLine = t.map[1];
+  const component = {
+    name,
+    variant: meta.variant || null,
+    attrs: { ...meta.attrs },
+    line,
+    text: lines.slice(line, lastLine).join(`
+`),
+    blocks: toComponentBlocks(tokens, line)
+  };
+  let result;
+  try {
+    result = decl.validate(component);
+  } catch (error) {
+    failed(`threw: ${error instanceof Error ? error.message : String(error)}`);
+    return;
+  }
+  if (result === undefined || result === null)
+    return;
+  if (typeof result === "string")
+    result = [result];
+  if (!Array.isArray(result)) {
+    failed("must return a message, an array of problems, or nothing (and must not be async).");
+    return;
+  }
+  for (const entry of result) {
+    const problem = typeof entry === "string" ? { message: entry } : entry;
+    if (!problem || typeof problem.message !== "string" || !problem.message.trim()) {
+      failed("returned a problem without a message.");
+      continue;
+    }
+    const at = Number.isInteger(problem.line) && problem.line > 0 ? problem.line : line;
+    const severity = COMPONENT_SEVERITIES.includes(problem.severity) ? problem.severity : undefined;
+    report(at, "component_invalid", `@${name}: ${problem.message}`, severity);
+  }
+}
 function proseEscapeHint(kind) {
   return ` If this line is prose that happens to begin with "@${kind}" — a wrapped sentence, for` + ` instance — escape it as \\@${kind} or write it as \`@${kind}\` in backticks, and it stays text.`;
 }
@@ -957,13 +1084,20 @@ function resolveContainerShape(name, pluginName, decl) {
     }
     autoCloseAtEof = decl.autoCloseAt.includes("eof");
   }
-  return { tag, classBase, variants, label, autoCloseAtEof };
+  if (decl.validate !== undefined && typeof decl.validate !== "function") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`validate\` that is not a function.`);
+  }
+  const check = decl.validate ? { validate: decl.validate, validateOwner: pluginName } : {};
+  return { tag, classBase, variants, label, autoCloseAtEof, ...check };
 }
 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.snippet !== undefined && (typeof rawDecl.snippet !== "string" || !rawDecl.snippet.trim())) {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`snippet\` that is not a non-empty path string.`);
+  }
   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.`);
@@ -1178,8 +1312,8 @@ function plugin(md, pluginOptions = {}) {
     }
     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;
+      t.meta = { line: meta.__line, component: meta.kind, variant, attrs: meta.attrs || {}, labelled: false };
       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 : "");
@@ -1193,6 +1327,7 @@ function plugin(md, pluginOptions = {}) {
           labelToken.content = `<${decl.label.tag} class="${escapeAttr(decl.label.class)}">${escapeHtml(value)}</${decl.label.tag}>
 `;
           out.push(labelToken);
+          t.meta.labelled = true;
         }
       }
     }
@@ -1454,6 +1589,25 @@ function plugin(md, pluginOptions = {}) {
     stack.closeAll();
     state.tokens = out;
   });
+  if (declaredMarkers && [...declaredMarkers.values()].some((d) => d.validate)) {
+    md.core.ruler.push("gp_component_validate", function(state) {
+      let lines = null;
+      const tokens = state.tokens;
+      for (let i = 0;i < tokens.length; i++) {
+        const tok = tokens[i];
+        if (tok.type !== "layout_component_open")
+          continue;
+        const decl = declaredMarkers.get(tok.meta.component);
+        if (!decl || !decl.validate)
+          continue;
+        if (!lines)
+          lines = state.src.split(`
+`);
+        const from = i + (tok.meta.labelled ? 2 : 1);
+        runComponentValidate(state.env, decl, tok.meta, tokens.slice(from, blockEnd(tokens, i)), lines);
+      }
+    });
+  }
   md.renderer.rules.layout_page_break = (tokens, idx) => {
     const cls = tokens[idx].attrGet("class") || "gp-page-break";
     const rangeAttr = tokens[idx].attrGet("data-source-range");
@@ -3860,7 +4014,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.15-alpha.2",
+  version: "0.11.16-alpha.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -6890,7 +7044,7 @@ var check24 = {
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
           results.push(finding(check24.id, {
-            severity: "warning",
+            severity: w.severity ?? "warning",
             message: w.message,
             file,
             ...w.line > 0 ? { line: w.line } : {},
@@ -8475,7 +8629,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-s18wy689.js");
+      const { buildNativePdf } = await import("./engine-szx34415.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -11882,6 +12036,7 @@ async function readExtensionCss(projectDir, use) {
 
 // src/lib/snippets.ts
 var SNIPPETS_DIR = "snippets";
+var LEVEL_RANK = { project: 0, extension: 1, core: 2 };
 var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
 function extractVariables(template) {
   const seen = new Set;
@@ -11898,16 +12053,14 @@ function extractVariables(template) {
 function substituteVariables(template, values) {
   return template.replace(PLACEHOLDER_RE, (_full, name) => Object.prototype.hasOwnProperty.call(values, name) ? values[name] : "");
 }
-function resolveSafeChildFile(dir, fileName) {
+function resolveSnippetPath(projectDir, fileName) {
+  const dir = path20.resolve(projectDir, SNIPPETS_DIR);
   const full = path20.resolve(dir, fileName);
   if (full !== path20.join(dir, path20.basename(fileName)) || path20.dirname(full) !== dir) {
     throw new Error(`Unsafe snippet filename: ${fileName}`);
   }
   return full;
 }
-function resolveSnippetPath(projectDir, fileName) {
-  return resolveSafeChildFile(path20.resolve(projectDir, SNIPPETS_DIR), fileName);
-}
 async function scanSnippetFiles(dir) {
   let names;
   try {
@@ -11928,7 +12081,8 @@ async function scanSnippetFiles(dir) {
     entries.push({
       name: prettify(fileName.replace(/\.md$/i, "")),
       fileName,
-      variables: extractVariables(body)
+      variables: extractVariables(body),
+      body
     });
   }
   entries.sort((a, b) => a.name.localeCompare(b.name));
@@ -11938,9 +12092,6 @@ async function listSnippets(projectDir) {
   const files = await scanSnippetFiles(path20.join(projectDir, SNIPPETS_DIR));
   return files.map((file) => ({ ...file, source: { kind: "project" } }));
 }
-async function readSnippet(projectDir, fileName) {
-  return readFile30(resolveSnippetPath(projectDir, fileName), "utf8");
-}
 async function saveSnippet(projectDir, name, body) {
   const stem = slugify(name);
   if (!stem)
@@ -11949,56 +12100,97 @@ async function saveSnippet(projectDir, name, body) {
   const dir = path20.join(projectDir, SNIPPETS_DIR);
   await mkdir11(dir, { recursive: true });
   await writeFile10(resolveSnippetPath(projectDir, fileName), body, "utf8");
-  return { name, fileName, variables: extractVariables(body), source: { kind: "project" } };
+  return { name, fileName, variables: extractVariables(body), body, source: { kind: "project" } };
 }
 async function deleteSnippet(projectDir, fileName) {
   await rm4(resolveSnippetPath(projectDir, fileName), { force: true });
 }
-async function listInstalledExtensions(projectDir) {
-  const out = [];
-  for (const entry of await listProjectExtensions(projectDir)) {
-    if (!entry.enabled || !entry.dir || !entry.carries.snippets)
-      continue;
-    const meta = await readExtensionMeta(entry.dir);
-    const snippetsRel = meta.snippets?.trim();
-    if (!snippetsRel)
-      continue;
-    out.push({ ref: entry.use, dir: entry.dir, name: entry.label, snippetsRel });
-  }
-  return out;
-}
-function extensionSnippetsDir(ext) {
-  if (pathEscapesFolder(ext.snippetsRel))
+async function declaredSnippetsFolder(entry) {
+  if (!entry.dir || !entry.carries.snippets)
     return null;
-  return path20.join(ext.dir, ext.snippetsRel);
+  const rel = (await readExtensionMeta(entry.dir)).snippets?.trim();
+  return rel && !pathEscapesFolder(rel) ? rel : null;
 }
-async function listMergedSnippets(projectDir) {
-  const project = await listSnippets(projectDir);
-  const projectFileNames = new Set(project.map((entry) => entry.fileName.toLowerCase()));
-  const merged = [...project];
-  const extensions = (await listInstalledExtensions(projectDir)).sort((a, b) => a.name.localeCompare(b.name));
-  for (const ext of extensions) {
-    const dir = extensionSnippetsDir(ext);
-    if (!dir)
+async function declaredMarkers(entry, projectDir) {
+  if (!entry.carries.markdown)
+    return;
+  try {
+    return (await loadPlugin(extensionConfigFor(entry), projectDir)).markers;
+  } catch {
+    return;
+  }
+}
+async function collectLibrary(projectDir) {
+  const groups = [];
+  const components = [];
+  for (const entry of await listProjectExtensions(projectDir)) {
+    if (!entry.enabled)
       continue;
-    for (const file of await scanSnippetFiles(dir)) {
-      if (projectFileNames.has(file.fileName.toLowerCase()))
+    const source = { kind: "extension", ref: entry.use, name: entry.label };
+    const folder = await declaredSnippetsFolder(entry);
+    const snippets2 = folder ? (await scanSnippetFiles(path20.join(entry.dir, folder))).map((file) => ({ ...file, source })) : [];
+    for (const [name, decl] of Object.entries(await declaredMarkers(entry, projectDir) ?? {})) {
+      if (decl.deprecated !== undefined)
+        continue;
+      components.push({ name, source });
+      if (!entry.dir)
+        continue;
+      const own = typeof decl.snippet === "string" && decl.snippet.trim() ? decl.snippet.trim() : null;
+      const rel = own ?? path20.join(folder ?? SNIPPETS_DIR, `${name}.md`);
+      if (pathEscapesFolder(rel))
+        continue;
+      const listed = folder && path20.dirname(path20.join(entry.dir, rel)) === path20.join(entry.dir, folder) ? snippets2.find((s) => s.fileName === path20.basename(rel)) : undefined;
+      if (listed) {
+        listed.component = name;
+        continue;
+      }
+      const body = await readFile30(path20.join(entry.dir, rel), "utf8").catch(() => null);
+      if (body === null)
         continue;
-      merged.push({ ...file, source: { kind: "extension", ref: ext.ref, name: ext.name } });
+      snippets2.push({
+        name: prettify(path20.basename(rel).replace(/\.md$/i, "")),
+        fileName: rel.split(path20.sep).join("/"),
+        variables: extractVariables(body),
+        body,
+        source,
+        component: name
+      });
+    }
+    if (snippets2.length) {
+      snippets2.sort((a, b) => a.name.localeCompare(b.name));
+      groups.push({ label: entry.label, snippets: snippets2 });
     }
   }
-  return merged;
-}
-async function readExtensionSnippet(projectDir, source, fileName) {
-  const ext = (await listInstalledExtensions(projectDir)).find((candidate) => candidate.ref === source.ref);
-  if (!ext) {
-    throw new Error(`Extension "${source.ref}" is not installed or is no longer active.`);
+  const book = await listSnippets(projectDir);
+  const names = new Set(components.map((c) => c.name));
+  for (const s of book) {
+    const stem = s.fileName.replace(/\.md$/i, "").toLowerCase();
+    if (names.has(stem))
+      s.component = stem;
   }
-  const dir = extensionSnippetsDir(ext);
-  if (!dir) {
-    throw new Error(`Extension "${source.ref}" does not declare a usable snippets folder.`);
+  groups.sort((a, b) => a.label.localeCompare(b.label));
+  const snippets = [...book, ...groups.flatMap((g) => g.snippets)];
+  for (const component of components) {
+    let best;
+    for (const s of snippets) {
+      if (s.component !== component.name)
+        continue;
+      if (s.source.kind === "extension" && s.source.ref !== component.source.ref)
+        continue;
+      if (!best || LEVEL_RANK[s.source.kind] < LEVEL_RANK[best.source.kind])
+        best = s;
+    }
+    if (best)
+      component.snippet = best.body;
   }
-  return readFile30(resolveSafeChildFile(dir, fileName), "utf8");
+  components.sort((a, b) => a.name.localeCompare(b.name));
+  return { snippets, components };
+}
+async function listMergedSnippets(projectDir) {
+  return (await collectLibrary(projectDir)).snippets;
+}
+async function listMarkerComponents(projectDir) {
+  return (await collectLibrary(projectDir)).components;
 }
 // src/lib/extension-import.ts
 import { existsSync as existsSync15 } from "node:fs";
@@ -16036,4 +16228,4 @@ async function setPublishProviderConfig(projectDir, providerId, values) {
   await writeManifestDoc(file, doc);
   return settingsFromDoc(doc);
 }
-export { BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, getChecks, getCheckById, resolveCheckSelectors, formatReport, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, ensureGitignoreHasDist, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, DEFAULT_NPM_REGISTRY, npmRegistryUrl, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, checkExtensionUpdates, updateExtensions, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, refreshRemoteCopies, REPAIR_SNAPSHOT_MESSAGE, repairOnlineBackup, scorchedEarth, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };
+export { BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, getChecks, getCheckById, resolveCheckSelectors, formatReport, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, ensureGitignoreHasDist, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, DEFAULT_NPM_REGISTRY, npmRegistryUrl, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, checkExtensionUpdates, updateExtensions, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, saveSnippet, deleteSnippet, listMergedSnippets, listMarkerComponents, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, refreshRemoteCopies, REPAIR_SNAPSHOT_MESSAGE, repairOnlineBackup, scorchedEarth, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };

package/dist/{index-w6tqhafk.js → index-eawjxgkn.js}

@@ -68,10 +68,10 @@ var chapter_01_default3 = "./chapter-01-6fn9pvd0.md";
 var package_default = "./package-9rv69pxm.json";
 
 // src/assets/extension-templates/plugin/README.md
-var README_default = "./README-8b33qbjw.md";
+var README_default = "./README-vsnsc1b3.md";
 
 // src/assets/extension-templates/plugin/plugin.js.tpl
-var plugin_js_default = "./plugin.js-aszz0zgh.tpl";
+var plugin_js_default = "./plugin.js-z492w01r.tpl";
 
 // src/assets/extension-templates/plugin/styles/plugin.css
 var plugin_default = "./plugin-spbcem4j.css";
@@ -86,7 +86,7 @@ var fixture_default = "./fixture-2qnyqgb5.md";
 var expected_default = "./expected-ycmacem8.html";
 
 // src/assets/extension-templates/plugin/test/plugin.test.js.tpl
-var plugin_test_js_default = "./plugin.test.js-nw7c84s6.tpl";
+var plugin_test_js_default = "./plugin.test.js-6n8ct5e3.tpl";
 
 // src/assets/extension-templates/theme/package.json
 var package_default2 = "./package-aenwjew3.json";

package/dist/index.d.ts

@@ -30,4 +30,4 @@ export { BUILD_DIAGNOSTIC_CODES } from "./engine/compiler/build.ts";
 export type { BuildDiagnostic, BuildDiagnosticCode } from "./engine/compiler/build.ts";
 export type { PrintSafeWarning } from "./lib/printsafe.ts";
 export { ruleRemoteUrls, ruleRiskyProps, ruleSyntax, } from "./lib/printsafe.ts";
-export type { GutterpressPlugin, GutterpressPluginExport, GutterpressPluginMetadata, } from "./lib/markdown/plugins.ts";
+export type { GutterpressComponent, GutterpressComponentBlock, GutterpressComponentProblem, GutterpressPlugin, GutterpressPluginExport, GutterpressPluginMetadata, } from "./lib/markdown/plugins.ts";

package/dist/index.js

@@ -77,6 +77,7 @@ import {
   listCustomTemplates,
   listGitHubBranches,
   listGitHubRepositories,
+  listMarkerComponents,
   listMergedSnippets,
   listProjectExtensions,
   listProjectStyles,
@@ -99,10 +100,8 @@ import {
   publishTargetFor,
   readExtensionCss,
   readExtensionMeta,
-  readExtensionSnippet,
   readManifestFields,
   readPublishSettings,
-  readSnippet,
   refreshRemoteCopies,
   removeExtension,
   reorderExtensions,
@@ -146,13 +145,13 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-j77039xr.js";
+} from "./index-azdfgy3t.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-ypxhxvwv.js";
+} from "./index-9ydc9q9q.js";
 import {
   BuildError
-} from "./index-w6tqhafk.js";
+} from "./index-eawjxgkn.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,
@@ -232,10 +231,8 @@ export {
   removeExtension,
   refreshRemoteCopies,
   readyProbeExpr,
-  readSnippet,
   readPublishSettings,
   readManifestFields,
-  readExtensionSnippet,
   readExtensionMeta,
   readExtensionCss,
   publishTargetFor,
@@ -259,6 +256,7 @@ export {
   listProjectStyles,
   listProjectExtensions,
   listMergedSnippets,
+  listMarkerComponents,
   listLocalBranches,
   listGitHubRepositories,
   listGitHubBranches,

package/dist/lib/markdown/assemble.d.ts

@@ -24,6 +24,11 @@ export type ReadText = (relPath: string) => Promise<string>;
  * same type, via a second, unconditional check modeled on `unknown_gp_class`
  * rather than the core-only `scanForMistypedMarkers`.
  *
+ * A declared marker's opt-in `validate` adds two more: `component_invalid`
+ * (one problem the validator reported — the only warning that may carry a
+ * `severity`) and `component_validate_failed` (the validator threw or
+ * returned something unusable).
+ *
  * There is deliberately no `section_without_page`: a @section with no open
  * @page is valid authoring (17/17 false positives across two real books).
  */
@@ -32,6 +37,8 @@ export interface LayoutWarning {
     type: string;
     message: string;
     marker?: unknown;
+    /** Set only by a component's `validate`; absent means `"warning"`. */
+    severity?: "error" | "warning" | "info";
 }
 /**
  * The Chromium milestone that paints a `@page { background: url() }` image

package/dist/lib/markdown/plugins.d.ts

@@ -1,6 +1,6 @@
 import type { ResolvedExtensionConfig } from "../../schema/manifest.types";
 import type { LoadedPlugin } from "./renderer";
-export type { GutterpressMarkerDeclaration, GutterpressMarkerLabel, GutterpressMarkerTable, GutterpressPlugin, GutterpressPluginMetadata, GutterpressPluginExport, LoadedPlugin, } from "./renderer";
+export type { GutterpressComponent, GutterpressComponentBlock, GutterpressComponentProblem, GutterpressMarkerDeclaration, GutterpressMarkerLabel, GutterpressMarkerTable, GutterpressPlugin, GutterpressPluginMetadata, GutterpressPluginExport, LoadedPlugin, } from "./renderer";
 export { applyPlugins, collectPluginCss, collectPluginStylePaths, collectPluginStyleGroups } from "./renderer";
 export type { PluginStyleGroup } from "./renderer";
 import { type PluginStyleGroup } from "./renderer";

package/dist/lib/markdown/renderer.d.ts

@@ -106,7 +106,98 @@ export interface GutterpressMarkerDeclaration {
     };
     /** This marker is retired: using it (or its `@end-` form) warns with this message and is otherwise a no-op. */
     deprecated?: string;
+    /**
+     * The example content the desktop editor inserts for this component, as a
+     * path relative to the extension's own folder (where its package.json
+     * lives). Defaults to `<snippets folder>/<marker name>.md`. Read by the
+     * host's component listing only — it never affects rendering.
+     */
+    snippet?: string;
+    /**
+     * Opt-in structure check, run every time the component is rendered
+     * (validate, Problems panel, build, preview). Receives a plain description
+     * of the component's content — see {@link GutterpressComponent} — and
+     * returns its problems. Must be synchronous; ignored on an alias (which
+     * uses its target's) and on a deprecated entry.
+     */
+    validate?: (component: GutterpressComponent) => GutterpressComponentProblems;
+}
+/** One top-level block inside a component, as its `validate` sees it. `line` is 1-based in the file. */
+export type GutterpressComponentBlock = {
+    type: "heading";
+    level: number;
+    text: string;
+    line: number;
+} | {
+    type: "paragraph";
+    text: string;
+    line: number;
+} | {
+    type: "image";
+    alt: string;
+    src: string;
+    line: number;
+} | {
+    type: "list";
+    ordered: boolean;
+    items: string[];
+    line: number;
+} | {
+    type: "quote";
+    text: string;
+    line: number;
+} | {
+    type: "code";
+    lang: string;
+    text: string;
+    line: number;
+} | {
+    type: "table" | "rule";
+    line: number;
+} | {
+    type: "html";
+    text: string;
+    line: number;
+} | {
+    type: "component";
+    name: string;
+    line: number;
 }
+/** Any other block (e.g. one another plugin adds), named after its markdown-it block type. */
+ | {
+    type: string;
+    line: number;
+};
+/**
+ * What a declared marker's `validate` receives: a fresh, plain copy of one
+ * use of the component (changing it has no effect). `text` fields are raw
+ * markdown — inline formatting is not parsed.
+ */
+export interface GutterpressComponent {
+    /** The marker as the author typed it, e.g. `"term-box"`. */
+    name: string;
+    /** The bare word after the marker (`@term-box note` → `"note"`), or null. */
+    variant: string | null;
+    /** The marker's attributes, e.g. `{ label: "Read this first" }`. */
+    attrs: Record<string, string>;
+    /** The marker's own 1-based line. */
+    line: number;
+    /** The raw markdown inside the component, from the line after the marker through its last line of content. */
+    text: string;
+    /** The component's top-level content, in order. */
+    blocks: GutterpressComponentBlock[];
+}
+/**
+ * One problem from `validate`: a message, or a message with a 1-based `line`
+ * (default: the marker's line) and `severity` (default `"warning"`).
+ */
+export type GutterpressComponentProblem = string | {
+    message: string;
+    line?: number;
+    severity?: "error" | "warning" | "info";
+};
+/** `validate`'s return value: nothing, one message, or a list of problems. */
+export type GutterpressComponentProblems = GutterpressComponentProblem[] | string | void | null | undefined;
 /** A plugin's full declared marker table — see {@link GutterpressMarkerDeclaration}. */
 export type GutterpressMarkerTable = Record<string, GutterpressMarkerDeclaration>;
 /**