gutterpress 0.11.16-alpha.1 → 0.11.16-alpha.3

package/dist/api/index.js

@@ -128,10 +128,10 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-azdfgy3t.js";
+} from "../index-ncxfknbv.js";
 import {
   BuildError
-} from "../index-eawjxgkn.js";
+} from "../index-w1qk3tap.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/{build-46bb205t.js → build-tse0tq0t.js}

@@ -1,18 +1,18 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-sq0awkbf.js";
+} from "./cli-x9bb628z.js";
 import {
   log
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-6tfc4ed6.js → cli-14j4aqtc.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-p8xwsknv.js";
+} from "./cli-w9qc8fem.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-d55z7rtk.js → cli-8597az31.js}

@@ -1151,7 +1151,7 @@ var package_default = "./package-9rv69pxm.json";
 var README_default = "./README-vsnsc1b3.md";
 
 // src/assets/extension-templates/plugin/plugin.js.tpl
-var plugin_js_default = "./plugin.js-z492w01r.tpl";
+var plugin_js_default = "./plugin.js-m4a7m3t4.tpl";
 
 // src/assets/extension-templates/plugin/styles/plugin.css
 var plugin_default = "./plugin-spbcem4j.css";

package/dist/{cli-p8xwsknv.js → cli-w9qc8fem.js}

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

package/dist/{cli-sq0awkbf.js → cli-x9bb628z.js}

@@ -13,17 +13,17 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-p8xwsknv.js";
+} from "./cli-w9qc8fem.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./cli-d55z7rtk.js";
+} from "./cli-8597az31.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
@@ -3148,6 +3148,16 @@ function validateDeclaredMarkerName(name, pluginName) {
 }
 var TAG_NAME_RE = /^[a-z][a-z0-9-]*$/;
 function resolveContainerShape(name, pluginName, decl) {
+  if (decl.section !== undefined && typeof decl.section !== "boolean") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`section\` that is not a boolean.`);
+  }
+  if (decl.section) {
+    for (const field of ["tag", "label", "autoCloseAt"]) {
+      if (decl[field] !== undefined) {
+        throw new Error(`Plugin "${pluginName}"'s marker "@${name}" sets \`section: true\` and \`${field}\` — a section ` + `marker is a core @section, so \`${field}\` does not apply. Remove one of them.`);
+      }
+    }
+  }
   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.`);
@@ -3203,7 +3213,7 @@ function resolveContainerShape(name, pluginName, decl) {
     throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`validate\` that is not a function.`);
   }
   const check20 = decl.validate ? { validate: decl.validate, validateOwner: pluginName } : {};
-  return { tag, classBase, variants, label, autoCloseAtEof, ...check20 };
+  return { tag, classBase, variants, label, autoCloseAtEof, ...decl.section ? { section: true } : {}, ...check20 };
 }
 function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   const pluginName = originOf.get(name);
@@ -3279,12 +3289,12 @@ function declaredKindWords(declaredMarkers) {
   }
   return words;
 }
-function nearestDeclaredMarkerName(word, declaredMarkers) {
+function nearestDeclaredMarkerName(word, names) {
   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()) {
+  for (const known of names) {
     const d = editDistance(w, known);
     if (d < bestDistance) {
       bestDistance = d;
@@ -3312,13 +3322,23 @@ function scanForUnknownDeclaredMarkers(state, declaredMarkers) {
       const word = m[1];
       if (KNOWN_KINDS.includes(word) || declaredMarkers.has(word))
         continue;
-      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers);
+      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers.keys());
       if (!suggestion)
         continue;
       warn2(state.env, tok.map[0] + i + 1, "unknown_marker", `Unknown marker "@${word}". Did you mean "@${suggestion}"?`, null);
     }
   }
 }
+function warnUnknownVariant(env, meta, decl) {
+  const word = meta.name;
+  if (!word)
+    return;
+  const variants = Object.keys(decl.variants || {});
+  if (variants.includes(word))
+    return;
+  const near = variants.find((v) => v.toLowerCase() === word.toLowerCase()) || (word.length >= 3 ? nearestDeclaredMarkerName(word, variants) : null);
+  warn2(env, meta.__line, "unknown_variant", `"${word}" is not a variant of @${meta.kind}, so it adds no styling. ` + (variants.length ? `Variants: ${variants.join(", ")}.` : `@${meta.kind} has no variants.`) + (near ? ` Did you mean "${near}"?` : ""), meta);
+}
 function plugin(md, pluginOptions = {}) {
   const options = {
     preferPagesInSpreads: false,
@@ -3428,7 +3448,15 @@ function plugin(md, pluginOptions = {}) {
     function openDeclaredMarker(meta, decl) {
       const t = new state.Token("layout_component_open", decl.tag, 1);
       const variant = meta.name || decl.presetVariant || null;
-      t.meta = { line: meta.__line, component: meta.kind, variant, attrs: meta.attrs || {}, labelled: false };
+      warnUnknownVariant(state.env, meta, decl);
+      t.meta = {
+        line: meta.__line,
+        component: meta.kind,
+        kind: decl.baseKind,
+        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 : "");
@@ -3536,16 +3564,34 @@ function plugin(md, pluginOptions = {}) {
         warn2(state.env, meta.__line || 0, "page_outside_spread", "@page used outside of a spread; allowed, but spreads are recommended for deliberate grouping.", meta);
       }
     }
+    function sectionMetaFor(meta, decl) {
+      const attrs = meta.attrs || {};
+      const variant = meta.name || decl.presetVariant || null;
+      warnUnknownVariant(state.env, meta, decl);
+      const variantClass = variant && decl.variants && decl.variants[variant] || "";
+      const cls = [decl.classBase, variantClass, attrs.class].filter(Boolean).join(" ");
+      return {
+        kind: "section",
+        name: null,
+        attrs: cls ? { ...attrs, class: cls } : attrs,
+        __line: meta.__line,
+        __component: { component: meta.kind, kind: decl.baseKind, variant, attrs }
+      };
+    }
     function openSection(meta) {
       const t = new state.Token("layout_section_open", "div", 1);
+      const component = meta.__component || null;
       addClasses(t, "section", meta.attrs && meta.attrs.class ? meta.attrs.class : "");
-      attachDataAttrs(t, "section", meta.name, meta.attrs || {});
-      t.meta = { line: meta.__line };
+      if (component)
+        attachDataAttrs(t, component.kind, component.variant, meta.attrs || {});
+      else
+        attachDataAttrs(t, "section", meta.name, meta.attrs || {});
+      t.meta = component ? { line: meta.__line, ...component, ...meta.__continued ? { continued: true } : {} } : { line: meta.__line };
       stack.open({
         kind: "section",
         classes: meta.attrs && meta.attrs.class || "",
         sawContent: false,
-        meta: { name: meta.name || null, attrs: { ...meta.attrs || {} } },
+        meta: { name: meta.name || null, attrs: { ...meta.attrs || {} }, component },
         openToken: t
       }, t);
     }
@@ -3591,9 +3637,21 @@ function plugin(md, pluginOptions = {}) {
         out.push(tok);
         continue;
       }
-      const meta = tok.meta || {};
-      const kind = meta.kind;
+      let meta = tok.meta || {};
+      let kind = meta.kind;
       const line = meta.__line || 0;
+      if (declaredMarkers) {
+        const closing = kind.startsWith("end-");
+        const sectionDecl = declaredMarkers.get(closing ? kind.slice(4) : kind);
+        if (sectionDecl && sectionDecl.section) {
+          if (closing) {
+            kind = "end-section";
+          } else {
+            meta = sectionMetaFor(meta, sectionDecl);
+            kind = "section";
+          }
+        }
+      }
       if (kind === "chapter") {
         drainDeclaredFrames();
         stack.close("chapter");
@@ -3637,6 +3695,10 @@ function plugin(md, pluginOptions = {}) {
           name: section.meta.name,
           attrs: { ...section.meta.attrs || {} }
         };
+        if (section.meta.component) {
+          contMeta.__component = section.meta.component;
+          contMeta.__continued = true;
+        }
         contMeta.__line = line;
         const cls = (contMeta.attrs.class || "").split(/\s+/).filter(Boolean);
         if (!cls.includes("gp-continued"))
@@ -3710,7 +3772,8 @@ function plugin(md, pluginOptions = {}) {
       const tokens = state.tokens;
       for (let i = 0;i < tokens.length; i++) {
         const tok = tokens[i];
-        if (tok.type !== "layout_component_open")
+        const isSection = tok.type === "layout_section_open" && tok.meta && tok.meta.component && !tok.meta.continued;
+        if (tok.type !== "layout_component_open" && !isSection)
           continue;
         const decl = declaredMarkers.get(tok.meta.component);
         if (!decl || !decl.validate)
@@ -8139,7 +8202,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-nv2xddnk.js");
+      const { buildNativePdf } = await import("./engine-6jnxqfsm.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
+} from "./cli-w9qc8fem.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,14 +18,14 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-daeh9p9p.js").then((m) => m.default),
-  preview: () => import("./preview-00298rvf.js").then((m) => m.default),
-  build: () => import("./build-46bb205t.js").then((m) => m.default),
-  publish: () => import("./publish-jn9t18mr.js").then((m) => m.default),
-  validate: () => import("./validate-cm1m5bbf.js").then((m) => m.default),
-  preflight: () => import("./preflight-bfvw2qe5.js").then((m) => m.default),
-  doctor: () => import("./doctor-tjatz81j.js").then((m) => m.default),
-  ext: () => import("./ext-ph0770mx.js").then((m) => m.default)
+  new: () => import("./new-n43vrq56.js").then((m) => m.default),
+  preview: () => import("./preview-v66m0vff.js").then((m) => m.default),
+  build: () => import("./build-tse0tq0t.js").then((m) => m.default),
+  publish: () => import("./publish-xgmbeerq.js").then((m) => m.default),
+  validate: () => import("./validate-281t5k0g.js").then((m) => m.default),
+  preflight: () => import("./preflight-qnp6rd1d.js").then((m) => m.default),
+  doctor: () => import("./doctor-s6npnst2.js").then((m) => m.default),
+  ext: () => import("./ext-tf6x156j.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -50,7 +50,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-daeh9p9p.js");
+      const { newArgs } = await import("./new-n43vrq56.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -62,7 +62,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-bfvw2qe5.js");
+      const { preflightArgs } = await import("./preflight-qnp6rd1d.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -82,7 +82,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-ph0770mx.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-tf6x156j.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-tjatz81j.js → doctor-s6npnst2.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
+} from "./cli-w9qc8fem.js";
 import"./cli-46ycxe6r.js";
 import"./cli-7fkhgtfn.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-szx34415.js → engine-5b92gk8n.js}

@@ -1,9 +1,9 @@
 import {
   build
-} from "./index-9ydc9q9q.js";
+} from "./index-zb48zwcq.js";
 import {
   BuildError
-} from "./index-eawjxgkn.js";
+} from "./index-w1qk3tap.js";
 import"./index-rzm1phg0.js";
 import"./index-37x76zdn.js";
 

package/dist/{engine-nv2xddnk.js → engine-6jnxqfsm.js}

@@ -1,6 +1,6 @@
 import {
   build
-} from "./cli-d55z7rtk.js";
+} from "./cli-8597az31.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{ext-ph0770mx.js → ext-tf6x156j.js}

@@ -12,16 +12,16 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-sq0awkbf.js";
-import"./cli-6tfc4ed6.js";
+} from "./cli-x9bb628z.js";
+import"./cli-14j4aqtc.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -4,7 +4,7 @@ import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./index-eawjxgkn.js";
+} from "./index-w1qk3tap.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -1033,6 +1033,16 @@ function validateDeclaredMarkerName(name, pluginName) {
 }
 var TAG_NAME_RE = /^[a-z][a-z0-9-]*$/;
 function resolveContainerShape(name, pluginName, decl) {
+  if (decl.section !== undefined && typeof decl.section !== "boolean") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`section\` that is not a boolean.`);
+  }
+  if (decl.section) {
+    for (const field of ["tag", "label", "autoCloseAt"]) {
+      if (decl[field] !== undefined) {
+        throw new Error(`Plugin "${pluginName}"'s marker "@${name}" sets \`section: true\` and \`${field}\` — a section ` + `marker is a core @section, so \`${field}\` does not apply. Remove one of them.`);
+      }
+    }
+  }
   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.`);
@@ -1088,7 +1098,7 @@ function resolveContainerShape(name, pluginName, decl) {
     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 };
+  return { tag, classBase, variants, label, autoCloseAtEof, ...decl.section ? { section: true } : {}, ...check };
 }
 function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   const pluginName = originOf.get(name);
@@ -1164,12 +1174,12 @@ function declaredKindWords(declaredMarkers) {
   }
   return words;
 }
-function nearestDeclaredMarkerName(word, declaredMarkers) {
+function nearestDeclaredMarkerName(word, names) {
   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()) {
+  for (const known of names) {
     const d = editDistance(w, known);
     if (d < bestDistance) {
       bestDistance = d;
@@ -1197,13 +1207,23 @@ function scanForUnknownDeclaredMarkers(state, declaredMarkers) {
       const word = m[1];
       if (KNOWN_KINDS.includes(word) || declaredMarkers.has(word))
         continue;
-      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers);
+      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers.keys());
       if (!suggestion)
         continue;
       warn(state.env, tok.map[0] + i + 1, "unknown_marker", `Unknown marker "@${word}". Did you mean "@${suggestion}"?`, null);
     }
   }
 }
+function warnUnknownVariant(env, meta, decl) {
+  const word = meta.name;
+  if (!word)
+    return;
+  const variants = Object.keys(decl.variants || {});
+  if (variants.includes(word))
+    return;
+  const near = variants.find((v) => v.toLowerCase() === word.toLowerCase()) || (word.length >= 3 ? nearestDeclaredMarkerName(word, variants) : null);
+  warn(env, meta.__line, "unknown_variant", `"${word}" is not a variant of @${meta.kind}, so it adds no styling. ` + (variants.length ? `Variants: ${variants.join(", ")}.` : `@${meta.kind} has no variants.`) + (near ? ` Did you mean "${near}"?` : ""), meta);
+}
 function plugin(md, pluginOptions = {}) {
   const options = {
     preferPagesInSpreads: false,
@@ -1313,7 +1333,15 @@ function plugin(md, pluginOptions = {}) {
     function openDeclaredMarker(meta, decl) {
       const t = new state.Token("layout_component_open", decl.tag, 1);
       const variant = meta.name || decl.presetVariant || null;
-      t.meta = { line: meta.__line, component: meta.kind, variant, attrs: meta.attrs || {}, labelled: false };
+      warnUnknownVariant(state.env, meta, decl);
+      t.meta = {
+        line: meta.__line,
+        component: meta.kind,
+        kind: decl.baseKind,
+        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 : "");
@@ -1421,16 +1449,34 @@ function plugin(md, pluginOptions = {}) {
         warn(state.env, meta.__line || 0, "page_outside_spread", "@page used outside of a spread; allowed, but spreads are recommended for deliberate grouping.", meta);
       }
     }
+    function sectionMetaFor(meta, decl) {
+      const attrs = meta.attrs || {};
+      const variant = meta.name || decl.presetVariant || null;
+      warnUnknownVariant(state.env, meta, decl);
+      const variantClass = variant && decl.variants && decl.variants[variant] || "";
+      const cls = [decl.classBase, variantClass, attrs.class].filter(Boolean).join(" ");
+      return {
+        kind: "section",
+        name: null,
+        attrs: cls ? { ...attrs, class: cls } : attrs,
+        __line: meta.__line,
+        __component: { component: meta.kind, kind: decl.baseKind, variant, attrs }
+      };
+    }
     function openSection(meta) {
       const t = new state.Token("layout_section_open", "div", 1);
+      const component = meta.__component || null;
       addClasses(t, "section", meta.attrs && meta.attrs.class ? meta.attrs.class : "");
-      attachDataAttrs(t, "section", meta.name, meta.attrs || {});
-      t.meta = { line: meta.__line };
+      if (component)
+        attachDataAttrs(t, component.kind, component.variant, meta.attrs || {});
+      else
+        attachDataAttrs(t, "section", meta.name, meta.attrs || {});
+      t.meta = component ? { line: meta.__line, ...component, ...meta.__continued ? { continued: true } : {} } : { line: meta.__line };
       stack.open({
         kind: "section",
         classes: meta.attrs && meta.attrs.class || "",
         sawContent: false,
-        meta: { name: meta.name || null, attrs: { ...meta.attrs || {} } },
+        meta: { name: meta.name || null, attrs: { ...meta.attrs || {} }, component },
         openToken: t
       }, t);
     }
@@ -1476,9 +1522,21 @@ function plugin(md, pluginOptions = {}) {
         out.push(tok);
         continue;
       }
-      const meta = tok.meta || {};
-      const kind = meta.kind;
+      let meta = tok.meta || {};
+      let kind = meta.kind;
       const line = meta.__line || 0;
+      if (declaredMarkers) {
+        const closing = kind.startsWith("end-");
+        const sectionDecl = declaredMarkers.get(closing ? kind.slice(4) : kind);
+        if (sectionDecl && sectionDecl.section) {
+          if (closing) {
+            kind = "end-section";
+          } else {
+            meta = sectionMetaFor(meta, sectionDecl);
+            kind = "section";
+          }
+        }
+      }
       if (kind === "chapter") {
         drainDeclaredFrames();
         stack.close("chapter");
@@ -1522,6 +1580,10 @@ function plugin(md, pluginOptions = {}) {
           name: section.meta.name,
           attrs: { ...section.meta.attrs || {} }
         };
+        if (section.meta.component) {
+          contMeta.__component = section.meta.component;
+          contMeta.__continued = true;
+        }
         contMeta.__line = line;
         const cls = (contMeta.attrs.class || "").split(/\s+/).filter(Boolean);
         if (!cls.includes("gp-continued"))
@@ -1595,7 +1657,8 @@ function plugin(md, pluginOptions = {}) {
       const tokens = state.tokens;
       for (let i = 0;i < tokens.length; i++) {
         const tok = tokens[i];
-        if (tok.type !== "layout_component_open")
+        const isSection = tok.type === "layout_section_open" && tok.meta && tok.meta.component && !tok.meta.continued;
+        if (tok.type !== "layout_component_open" && !isSection)
           continue;
         const decl = declaredMarkers.get(tok.meta.component);
         if (!decl || !decl.validate)
@@ -4014,7 +4077,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.16-alpha.1",
+  version: "0.11.16-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -8629,7 +8692,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-szx34415.js");
+      const { buildNativePdf } = await import("./engine-5b92gk8n.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -12123,16 +12186,27 @@ async function declaredMarkers(entry, projectDir) {
 async function collectLibrary(projectDir) {
   const groups = [];
   const components = [];
+  const loaded = [];
   for (const entry of await listProjectExtensions(projectDir)) {
     if (!entry.enabled)
       continue;
     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)
+    loaded.push({ entry, source, folder, snippets: snippets2, markers: await declaredMarkers(entry, projectDir) });
+  }
+  let registry;
+  try {
+    registry = buildDeclaredMarkerRegistry(loaded.flatMap((l) => l.markers ? [{ pluginName: l.entry.label, markers: l.markers }] : []));
+  } catch {
+    registry = undefined;
+  }
+  for (const { entry, source, folder, snippets: snippets2, markers } of loaded) {
+    for (const [name, decl] of Object.entries(registry ? markers ?? {} : {})) {
+      const resolved = registry.get(name);
+      if (!resolved || resolved.deprecated !== undefined)
         continue;
-      components.push({ name, source });
+      components.push({ name, source, variants: Object.keys(resolved.variants ?? {}) });
       if (!entry.dir)
         continue;
       const own = typeof decl.snippet === "string" && decl.snippet.trim() ? decl.snippet.trim() : null;

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

@@ -71,7 +71,7 @@ var package_default = "./package-9rv69pxm.json";
 var README_default = "./README-vsnsc1b3.md";
 
 // src/assets/extension-templates/plugin/plugin.js.tpl
-var plugin_js_default = "./plugin.js-z492w01r.tpl";
+var plugin_js_default = "./plugin.js-m4a7m3t4.tpl";
 
 // src/assets/extension-templates/plugin/styles/plugin.css
 var plugin_default = "./plugin-spbcem4j.css";

package/dist/{index-9ydc9q9q.js → index-zb48zwcq.js}

@@ -3,7 +3,7 @@ import {
   isIgnoredMarginBoxProperty,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-eawjxgkn.js";
+} from "./index-w1qk3tap.js";
 import {
   launchChromium
 } from "./index-rzm1phg0.js";

package/dist/index.js

@@ -145,13 +145,13 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-azdfgy3t.js";
+} from "./index-ncxfknbv.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-9ydc9q9q.js";
+} from "./index-zb48zwcq.js";
 import {
   BuildError
-} from "./index-eawjxgkn.js";
+} from "./index-w1qk3tap.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

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

@@ -29,6 +29,9 @@ export type ReadText = (relPath: string) => Promise<string>;
  * `severity`) and `component_validate_failed` (the validator threw or
  * returned something unusable).
  *
+ * `unknown_variant` is emitted for a declared marker (container or
+ * `section: true`) whose bare word is not one of its declared `variants`.
+ *
  * There is deliberately no `section_without_page`: a @section with no open
  * @page is valid authoring (17/17 false positives across two real books).
  */

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

@@ -62,13 +62,36 @@ export interface GutterpressMarkerLabel {
  * One entry in a plugin's declared `markers` table (#240 — "declarative
  * container components in core"). Exactly one of three shapes:
  *
- *   - a CONTAINER: `tag`/`class`/`variants`/`label`/`autoCloseAt`, any/all
+ *   - a CONTAINER: `section`/`tag`/`class`/`variants`/`label`/`autoCloseAt`, any/all
  *     optional (a bare `{}` is a valid, if pointless, `<div>` wrapper);
  *   - an ALIAS: `alias` (another declared name) + optional `preset`;
  *   - a DEPRECATION: `deprecated` (a human-readable retirement message) —
  *     wins over every other field on the same entry, per
  *     `markers.js`'s `resolveMarkerDeclaration`.
  *
+ * A container may instead set `section: true` (below) to be a core `@section`.
+ *
+ * TOKEN CONTRACT (public and stable). A declared container renders as a
+ * `layout_component_open` / `layout_component_close` token pair, so a plugin
+ * can "declare, then transform": declare the marker so core parses it
+ * (autocomplete, closing, warnings, source lines), then rewrite the tokens
+ * between the pair with an ordinary markdown-it core rule. The open token's
+ * `meta` is
+ *
+ *     { line, component, kind, variant, attrs, labelled }
+ *
+ *   - `line`      the marker's 1-based line
+ *   - `component` the marker name as typed (an alias's own name)
+ *   - `kind`      the resolved base marker name (an alias's target)
+ *   - `variant`   the bare word after the marker (or an alias's preset), or null
+ *   - `attrs`     the marker's attributes, as authored
+ *   - `labelled`  true when core injected a label `html_block` right after the open token
+ *
+ * The close token has no meta. A `section: true` marker produces the core
+ * `layout_section_open` / `layout_section_close` pair instead; its open token
+ * carries `{ line, component, kind, variant, attrs }` (plus `continued: true`
+ * on a `@continue` reopening) and a plain `@section`'s carries only `{ line }`.
+ *
  * See `markers.js`'s header comment for a worked example and
  * `buildDeclaredMarkerRegistry` for the full validation/resolution contract
  * (collision rules, alias indirection, the auto-derived `@end-<name>`
@@ -78,6 +101,17 @@ export interface GutterpressMarkerLabel {
  * plugin input.
  */
 export interface GutterpressMarkerDeclaration {
+    /**
+     * This marker IS a core `@section`: `@npc-stat wirephreak .extra` renders
+     * exactly like `@section .<class> .<variants.wirephreak> .extra` (same
+     * classes, same order), closes like one (at the next `@section` / `@page` /
+     * `@chapter` / `@spread`, or `@end-<name>`, which acts as `@end-section`),
+     * and `@continue` reopens it with the same classes. The variant word is a
+     * variant, not a section name: it emits `data-<name>="<variant>"` (the
+     * alias target's name for an alias), never `data-section`. Cannot be combined
+     * with `tag`, `label` or `autoCloseAt`. Aliases of a section marker inherit it.
+     */
+    section?: boolean;
     /** Wrapper element tag. Defaults to `"div"`. */
     tag?: string;
     /** Base class(es) on the wrapper, e.g. `"dc-alert"`. */
@@ -118,7 +152,8 @@ export interface GutterpressMarkerDeclaration {
      * (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.
+     * uses its target's) and on a deprecated entry. Works on `section: true`
+     * markers too (a `@continue` continuation is not validated on its own).
      */
     validate?: (component: GutterpressComponent) => GutterpressComponentProblems;
 }

package/dist/lib/snippets.d.ts

@@ -83,6 +83,10 @@ export interface MarkerComponent {
     source: Extract<SnippetSource, {
         kind: "extension";
     }>;
+    /** The variant names the marker accepts as its bare word (`@name <variant>`),
+     *  as the renderer resolves them — an alias lists its target's. A variant
+     *  only adds a class, so one snippet serves them all. */
+    variants: string[];
     /** The winning example snippet's body (book, then extension, then core). */
     snippet?: string;
 }

package/dist/{new-daeh9p9p.js → new-n43vrq56.js}

@@ -7,16 +7,16 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-sq0awkbf.js";
+} from "./cli-x9bb628z.js";
 import {
   resolveGhostscript
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{plugin.js-z492w01r.tpl → plugin.js-m4a7m3t4.tpl}

@@ -62,6 +62,7 @@ const PREFIX = "{{PREFIX}}";
  *   @end-term-box
  *
  * Fields, all optional:
+ *   section     true makes the marker a core @section (no tag/label/autoCloseAt)
  *   tag         wrapper element            (default "div")
  *   class       base class on the wrapper
  *   variants    extra classes keyed by the marker's bare word

package/dist/{preflight-bfvw2qe5.js → preflight-qnp6rd1d.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-sq0awkbf.js";
+} from "./cli-x9bb628z.js";
 import {
   log
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preview-00298rvf.js → preview-v66m0vff.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-sq0awkbf.js";
+} from "./cli-x9bb628z.js";
 import {
   log
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   parseFormat,
@@ -17,8 +17,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{publish-jn9t18mr.js → publish-xgmbeerq.js}

@@ -11,17 +11,17 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-sq0awkbf.js";
+} from "./cli-x9bb628z.js";
 import {
   FileTokenStore,
   log
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/render.js

@@ -350,6 +350,16 @@ function validateDeclaredMarkerName(name, pluginName) {
 }
 var TAG_NAME_RE = /^[a-z][a-z0-9-]*$/;
 function resolveContainerShape(name, pluginName, decl) {
+  if (decl.section !== undefined && typeof decl.section !== "boolean") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`section\` that is not a boolean.`);
+  }
+  if (decl.section) {
+    for (const field of ["tag", "label", "autoCloseAt"]) {
+      if (decl[field] !== undefined) {
+        throw new Error(`Plugin "${pluginName}"'s marker "@${name}" sets \`section: true\` and \`${field}\` — a section ` + `marker is a core @section, so \`${field}\` does not apply. Remove one of them.`);
+      }
+    }
+  }
   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.`);
@@ -405,7 +415,7 @@ function resolveContainerShape(name, pluginName, decl) {
     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 };
+  return { tag, classBase, variants, label, autoCloseAtEof, ...decl.section ? { section: true } : {}, ...check };
 }
 function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   const pluginName = originOf.get(name);
@@ -481,12 +491,12 @@ function declaredKindWords(declaredMarkers) {
   }
   return words;
 }
-function nearestDeclaredMarkerName(word, declaredMarkers) {
+function nearestDeclaredMarkerName(word, names) {
   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()) {
+  for (const known of names) {
     const d = editDistance(w, known);
     if (d < bestDistance) {
       bestDistance = d;
@@ -514,13 +524,23 @@ function scanForUnknownDeclaredMarkers(state, declaredMarkers) {
       const word = m[1];
       if (KNOWN_KINDS.includes(word) || declaredMarkers.has(word))
         continue;
-      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers);
+      const suggestion = nearestDeclaredMarkerName(word, declaredMarkers.keys());
       if (!suggestion)
         continue;
       warn(state.env, tok.map[0] + i + 1, "unknown_marker", `Unknown marker "@${word}". Did you mean "@${suggestion}"?`, null);
     }
   }
 }
+function warnUnknownVariant(env, meta, decl) {
+  const word = meta.name;
+  if (!word)
+    return;
+  const variants = Object.keys(decl.variants || {});
+  if (variants.includes(word))
+    return;
+  const near = variants.find((v) => v.toLowerCase() === word.toLowerCase()) || (word.length >= 3 ? nearestDeclaredMarkerName(word, variants) : null);
+  warn(env, meta.__line, "unknown_variant", `"${word}" is not a variant of @${meta.kind}, so it adds no styling. ` + (variants.length ? `Variants: ${variants.join(", ")}.` : `@${meta.kind} has no variants.`) + (near ? ` Did you mean "${near}"?` : ""), meta);
+}
 function plugin(md, pluginOptions = {}) {
   const options = {
     preferPagesInSpreads: false,
@@ -630,7 +650,15 @@ function plugin(md, pluginOptions = {}) {
     function openDeclaredMarker(meta, decl) {
       const t = new state.Token("layout_component_open", decl.tag, 1);
       const variant = meta.name || decl.presetVariant || null;
-      t.meta = { line: meta.__line, component: meta.kind, variant, attrs: meta.attrs || {}, labelled: false };
+      warnUnknownVariant(state.env, meta, decl);
+      t.meta = {
+        line: meta.__line,
+        component: meta.kind,
+        kind: decl.baseKind,
+        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 : "");
@@ -738,16 +766,34 @@ function plugin(md, pluginOptions = {}) {
         warn(state.env, meta.__line || 0, "page_outside_spread", "@page used outside of a spread; allowed, but spreads are recommended for deliberate grouping.", meta);
       }
     }
+    function sectionMetaFor(meta, decl) {
+      const attrs = meta.attrs || {};
+      const variant = meta.name || decl.presetVariant || null;
+      warnUnknownVariant(state.env, meta, decl);
+      const variantClass = variant && decl.variants && decl.variants[variant] || "";
+      const cls = [decl.classBase, variantClass, attrs.class].filter(Boolean).join(" ");
+      return {
+        kind: "section",
+        name: null,
+        attrs: cls ? { ...attrs, class: cls } : attrs,
+        __line: meta.__line,
+        __component: { component: meta.kind, kind: decl.baseKind, variant, attrs }
+      };
+    }
     function openSection(meta) {
       const t = new state.Token("layout_section_open", "div", 1);
+      const component = meta.__component || null;
       addClasses(t, "section", meta.attrs && meta.attrs.class ? meta.attrs.class : "");
-      attachDataAttrs(t, "section", meta.name, meta.attrs || {});
-      t.meta = { line: meta.__line };
+      if (component)
+        attachDataAttrs(t, component.kind, component.variant, meta.attrs || {});
+      else
+        attachDataAttrs(t, "section", meta.name, meta.attrs || {});
+      t.meta = component ? { line: meta.__line, ...component, ...meta.__continued ? { continued: true } : {} } : { line: meta.__line };
       stack.open({
         kind: "section",
         classes: meta.attrs && meta.attrs.class || "",
         sawContent: false,
-        meta: { name: meta.name || null, attrs: { ...meta.attrs || {} } },
+        meta: { name: meta.name || null, attrs: { ...meta.attrs || {} }, component },
         openToken: t
       }, t);
     }
@@ -793,9 +839,21 @@ function plugin(md, pluginOptions = {}) {
         out.push(tok);
         continue;
       }
-      const meta = tok.meta || {};
-      const kind = meta.kind;
+      let meta = tok.meta || {};
+      let kind = meta.kind;
       const line = meta.__line || 0;
+      if (declaredMarkers) {
+        const closing = kind.startsWith("end-");
+        const sectionDecl = declaredMarkers.get(closing ? kind.slice(4) : kind);
+        if (sectionDecl && sectionDecl.section) {
+          if (closing) {
+            kind = "end-section";
+          } else {
+            meta = sectionMetaFor(meta, sectionDecl);
+            kind = "section";
+          }
+        }
+      }
       if (kind === "chapter") {
         drainDeclaredFrames();
         stack.close("chapter");
@@ -839,6 +897,10 @@ function plugin(md, pluginOptions = {}) {
           name: section.meta.name,
           attrs: { ...section.meta.attrs || {} }
         };
+        if (section.meta.component) {
+          contMeta.__component = section.meta.component;
+          contMeta.__continued = true;
+        }
         contMeta.__line = line;
         const cls = (contMeta.attrs.class || "").split(/\s+/).filter(Boolean);
         if (!cls.includes("gp-continued"))
@@ -912,7 +974,8 @@ function plugin(md, pluginOptions = {}) {
       const tokens = state.tokens;
       for (let i = 0;i < tokens.length; i++) {
         const tok = tokens[i];
-        if (tok.type !== "layout_component_open")
+        const isSection = tok.type === "layout_section_open" && tok.meta && tok.meta.component && !tok.meta.continued;
+        if (tok.type !== "layout_component_open" && !isSection)
           continue;
         const decl = declaredMarkers.get(tok.meta.component);
         if (!decl || !decl.validate)

package/dist/{validate-cm1m5bbf.js → validate-281t5k0g.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-sq0awkbf.js";
+} from "./cli-x9bb628z.js";
 import {
   log
-} from "./cli-6tfc4ed6.js";
+} from "./cli-14j4aqtc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-p8xwsknv.js";
-import"./cli-d55z7rtk.js";
+} from "./cli-w9qc8fem.js";
+import"./cli-8597az31.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.16-alpha.1",
+  "version": "0.11.16-alpha.3",
   "description": "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",