gutterpress 0.11.17-alpha.5 → 0.11.17-alpha.7

package/dist/api/index.d.ts

@@ -32,8 +32,8 @@ export { TARGETS, TARGET_IDS, publishTargetFor } from "../lib/targets.ts";
 export type { PublishTarget, TargetOverlay } from "../lib/targets.ts";
 export { listBuiltInTemplates, listCustomTemplates, saveProjectAsTemplate, importTemplateFromFolder, BUILT_IN_TEMPLATE_IDS, } from "../lib/project-templates.ts";
 export type { TemplateInfo, SaveProjectAsTemplateOptions, } from "../lib/project-templates.ts";
-export { extractVariables, substituteVariables, listSnippets, saveSnippet, deleteSnippet, listMergedSnippets, listMarkerComponents, SNIPPETS_DIR, } from "../lib/snippets.ts";
-export type { MarkerComponent, SnippetEntry, SnippetSource } from "../lib/snippets.ts";
+export { extractVariables, substituteVariables, listSnippets, saveSnippet, deleteSnippet, listMergedSnippets, listMarkerComponents, listLocationVariants, SNIPPETS_DIR, } from "../lib/snippets.ts";
+export type { LocationVariant, MarkerComponent, SnippetEntry, SnippetSource } from "../lib/snippets.ts";
 export { listProjectExtensions, describeExtension, addExtension, checkExtensionUpdates, listNpmVersions, updateExtensions, removeExtension, setExtensionEnabled, reorderExtensions, validateProjectExtensions, readExtensionCss, listBuiltInStyleSets, addBuiltInStyleSet, sameExtension, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, EXTENSIONS_DIR, PLUGINS_DIR, } from "../lib/extension-manager.ts";
 export type { ProjectExtensionEntry, ExtensionValidationResult, RecommendedExtension, ExtensionSourceKind, BuiltInStyleSet, BuiltInStyleSetId, AddExtensionOptions, ExtensionUpdateCheck, ExtensionUpdateResult, CheckExtensionUpdatesOptions, UpdateExtensionsOptions, } from "../lib/extension-manager.ts";
 export { BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, } from "../lib/extension-specifier.ts";

package/dist/api/index.js

@@ -70,6 +70,7 @@ import {
   listCustomTemplates,
   listGitHubBranches,
   listGitHubRepositories,
+  listLocationVariants,
   listMarkerComponents,
   listMergedSnippets,
   listNpmVersions,
@@ -135,11 +136,11 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-5ez30g3a.js";
+} from "../index-k0k4syyd.js";
 import"../index-ht1bcqdd.js";
 import {
   BuildError
-} from "../index-5gp6mkmf.js";
+} from "../index-vmcfahe2.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,
@@ -242,6 +243,7 @@ export {
   listNpmVersions,
   listMergedSnippets,
   listMarkerComponents,
+  listLocationVariants,
   listLocalBranches,
   listGitHubRepositories,
   listGitHubBranches,

package/dist/{build-jr9mqwgr.js → build-nbwgzcgv.js}

@@ -1,19 +1,19 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-82tvm0sg.js";
+} from "./cli-v3xmpvs8.js";
 import {
   log
-} from "./cli-5sg6hcqa.js";
+} from "./cli-vsgj1n9s.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-2xpwjanr.js";
+} from "./cli-2yvrfr58.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-c3enmb58.js";
+import"./cli-ycbg7mxk.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-2xpwjanr.js → cli-2yvrfr58.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.17-alpha.5",
+  version: "0.11.17-alpha.7",
   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-82tvm0sg.js → cli-v3xmpvs8.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-5sg6hcqa.js";
+} from "./cli-vsgj1n9s.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-2xpwjanr.js";
+} from "./cli-2yvrfr58.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -27,7 +27,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-c3enmb58.js";
+} from "./cli-ycbg7mxk.js";
 import {
   BuildError,
   EXIT_CODES
@@ -1169,6 +1169,16 @@ function resolveContainerShape(name, pluginName, decl) {
     ...check
   };
 }
+function presetVariantOf(name, pluginName, rawDecl) {
+  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.`);
+  }
+  return preset.variant;
+}
 function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   const pluginName = originOf.get(name);
   if (typeof rawDecl !== "object" || rawDecl === null || Array.isArray(rawDecl)) {
@@ -1197,35 +1207,70 @@ function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
     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: rawDecl.alias, presetVariant: presetVariantOf(name, pluginName, rawDecl), ...container };
   }
-  return { name, baseKind: name, ...resolveContainerShape(name, pluginName, rawDecl) };
+  const presetVariant = presetVariantOf(name, pluginName, rawDecl);
+  return {
+    name,
+    baseKind: name,
+    ...presetVariant !== undefined ? { presetVariant } : {},
+    ...resolveContainerShape(name, pluginName, rawDecl)
+  };
 }
 var CORE_MARKER_OWNER = "Gutterpress";
 var CORE_DECLARED_MARKERS = {
   columns: {
     class: "gp-columns",
+    preset: { variant: "2" },
     variants: { 1: "gp-columns-1", 2: "gp-columns-2", 3: "gp-columns-3", 4: "gp-columns-4", 5: "gp-columns-5" }
-  }
+  },
+  page: { variants: { blank: "gp-page-blank", "full-bleed": "gp-page-full-bleed" } }
 };
+var LOCATION_KINDS = ["page", "chapter", "section"];
+var LOCATION_KEYS = ["variants", "label", "snippet"];
+function isLocationDeclaration(name, rawDecl) {
+  return LOCATION_KINDS.includes(name) && rawDecl !== null && typeof rawDecl === "object" && !Array.isArray(rawDecl) && Object.hasOwn(rawDecl, "variants") && Object.keys(rawDecl).every((k) => LOCATION_KEYS.includes(k));
+}
+function addLocationVariants(kind, rawDecl, pluginName, into) {
+  const { variants, label, snippet } = rawDecl;
+  const where = `Plugin "${pluginName}" declares @${kind} variants`;
+  if (variants === null || typeof variants !== "object" || Array.isArray(variants)) {
+    throw new Error(`${where} that are not a plain object of { word: 'class' }.`);
+  }
+  if (label !== undefined && typeof label !== "string")
+    throw new Error(`${where} with a \`label\` that is not a string.`);
+  if (snippet !== undefined && typeof snippet !== "string")
+    throw new Error(`${where} with a \`snippet\` that is not a string.`);
+  for (const [word, cls] of Object.entries(variants)) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(word)) {
+      throw new Error(`${where} with an invalid word "${word}" — use letters, digits, hyphens and underscores.`);
+    }
+    if (typeof cls !== "string" || !cls.trim()) {
+      throw new Error(`${where}: variant "${word}" needs a non-empty class string.`);
+    }
+    const taken = into[kind].get(word);
+    if (taken) {
+      throw new Error(`@${kind} variant "${word}" is declared by both plugin "${taken.owner}" and plugin "${pluginName}". ` + `Variant words must be unique across every loaded plugin — rename one of them.`);
+    }
+    into[kind].set(word, { class: cls.trim(), owner: pluginName, ...label ? { label } : {}, ...snippet ? { snippet } : {} });
+  }
+}
 function buildDeclaredMarkerRegistry(sources) {
   const rawRegistry = new Map;
   const originOf = new Map;
+  const locationVariants = { page: new Map, chapter: new Map, section: new Map };
   for (const { pluginName, markers } of [{ pluginName: CORE_MARKER_OWNER, markers: CORE_DECLARED_MARKERS }, ...sources]) {
     if (!markers)
       continue;
     for (const [name, rawDecl] of Object.entries(markers)) {
       validateDeclaredMarkerName(name, pluginName);
+      if (isLocationDeclaration(name, rawDecl)) {
+        addLocationVariants(name, rawDecl, pluginName, locationVariants);
+        continue;
+      }
       if (KNOWN_KINDS.includes(name) || pluginName !== CORE_MARKER_OWNER && name in CORE_DECLARED_MARKERS) {
-        throw new Error(`Plugin "${pluginName}" declares marker "@${name}", which is a core Gutterpress marker name ` + `(${[...KNOWN_KINDS, ...Object.keys(CORE_DECLARED_MARKERS)].map((k) => `@${k}`).join(", ")}). ` + `Core marker names cannot be shadowed — ` + `rename the plugin's marker.`);
+        throw new Error(`Plugin "${pluginName}" declares marker "@${name}", which is a core Gutterpress marker name ` + `(${[...KNOWN_KINDS, ...Object.keys(CORE_DECLARED_MARKERS).filter((k) => !KNOWN_KINDS.includes(k))].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.`);
@@ -1238,6 +1283,7 @@ function buildDeclaredMarkerRegistry(sources) {
   for (const [name, rawDecl] of rawRegistry) {
     resolved.set(name, resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf));
   }
+  resolved.locationVariants = locationVariants;
   return resolved;
 }
 function declaredKindWords(declaredMarkers) {
@@ -1293,6 +1339,9 @@ function scanForUnknownDeclaredMarkers(state, declaredMarkers) {
 function variantClassFor(decl, word) {
   return word && decl.variants && Object.hasOwn(decl.variants, word) ? decl.variants[word] : "";
 }
+function nearVariant(word, variants) {
+  return variants.find((v) => v.toLowerCase() === word.toLowerCase()) || (word.length >= 3 ? nearestDeclaredMarkerName(word, variants) : null);
+}
 function warnUnknownVariant(env, meta, decl) {
   const word = meta.name;
   if (!word)
@@ -1300,9 +1349,16 @@ function warnUnknownVariant(env, meta, decl) {
   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);
+  const near = nearVariant(word, variants);
   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 warnNearMissVariant(env, meta, kind, variants) {
+  const words = [...variants.keys()];
+  const near = nearVariant(meta.name, words);
+  if (!near)
+    return;
+  warn2(env, meta.__line, "unknown_variant", `"${meta.name}" is not a variant of @${kind}, so it is only a ${kind} name and adds no styling. ` + `Variants: ${words.join(", ")}. Did you mean "${near}"?`, meta);
+}
 function plugin(md, pluginOptions = {}) {
   const options = {
     preferPagesInSpreads: false,
@@ -1310,6 +1366,7 @@ function plugin(md, pluginOptions = {}) {
   };
   const declaredMarkers = options.declaredMarkers instanceof Map && options.declaredMarkers.size > 0 ? options.declaredMarkers : buildDeclaredMarkerRegistry([]);
   const declaredWords = declaredKindWords(declaredMarkers);
+  const locationVariants = declaredMarkers.locationVariants || buildDeclaredMarkerRegistry([]).locationVariants;
   function markerBlock(state, startLine, endLine, silent) {
     const pos = state.bMarks[startLine] + state.tShift[startLine];
     const max = state.eMarks[startLine];
@@ -1388,20 +1445,35 @@ function plugin(md, pluginOptions = {}) {
       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));
-      }
+      drainDeclaredFrames(at);
       return true;
     }
-    function drainDeclaredFrames() {
-      while (declaredFrames.length) {
+    function sectionAbove(length) {
+      const section = stack.get("section");
+      return !!section && section.inColumns && declaredFrameIndex("columns") === length - 1;
+    }
+    function sectionHostDepth() {
+      const section = stack.get("section");
+      if (section && !section.inColumns)
+        return 0;
+      return declaredFrameIndex("columns") + 1;
+    }
+    function drainDeclaredFrames(keep = 0) {
+      while (declaredFrames.length > keep) {
+        if (sectionAbove(declaredFrames.length)) {
+          stack.close("section");
+          continue;
+        }
         const frame = declaredFrames.pop();
         out.push(new state.Token("layout_component_close", frame.tag, -1));
       }
     }
     function drainDeclaredFramesAtEof() {
       while (declaredFrames.length) {
+        if (sectionAbove(declaredFrames.length)) {
+          stack.close("section");
+          continue;
+        }
         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);
@@ -1478,14 +1550,16 @@ function plugin(md, pluginOptions = {}) {
     function openChapter(meta) {
       const t = new state.Token("layout_chapter_open", "div", 1);
       t.meta = { line: meta.__line };
-      const classes = meta.attrs?.class || "";
+      const variant = locationVariants.chapter.get(meta.name);
+      const label = variant ? "" : meta.name;
+      const classes = [variant?.class, meta.attrs?.class].filter(Boolean).join(" ");
       addClasses(t, "chapter", classes);
-      attachDataAttrs(t, "chapter", meta.name, meta.attrs || {});
+      attachDataAttrs(t, "chapter", label, meta.attrs || {});
       const explicit = (classes.match(/(?:^|\s)(chapter-\d+)(?=\s|$)/) || [])[1] || "";
       const fromAttr = meta.attrs?.ch ? `chapter-${meta.attrs.ch}` : "";
       stack.open({
         kind: "chapter",
-        label: meta.name || "",
+        label: label || "",
         counterClass: explicit || fromAttr,
         openerEmitted: false
       }, t);
@@ -1509,7 +1583,11 @@ function plugin(md, pluginOptions = {}) {
       const explicit = meta.attrs && meta.attrs.class ? meta.attrs.class : "";
       const counterClass = chapter ? chapter.counterClass : "";
       const tokens = explicit ? explicit.split(/\s+/) : [];
-      const merged = counterClass && !tokens.includes(counterClass) ? explicit ? `${explicit} ${counterClass}` : counterClass : explicit;
+      const withCounter = counterClass && !tokens.includes(counterClass) ? explicit ? `${explicit} ${counterClass}` : counterClass : explicit;
+      const variant = locationVariants.page.get(meta.name);
+      if (!variant && meta.name)
+        warnNearMissVariant(state.env, meta, "page", locationVariants.page);
+      const merged = [variant?.class, withCounter].filter(Boolean).join(" ");
       addClasses(t, "page", merged);
       attachDataAttrs(t, "page", meta.name, meta.attrs || {});
       const label = chapter ? chapter.label : "";
@@ -1545,10 +1623,11 @@ function plugin(md, pluginOptions = {}) {
         __component: { component: meta.kind, kind: decl.baseKind, variant, attrs }
       };
     }
-    function openSection(meta) {
+    function openSection(meta, inColumns = false) {
       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 : "");
+      const variant = component ? null : locationVariants.section.get(meta.name);
+      addClasses(t, "section", [variant?.class, meta.attrs && meta.attrs.class].filter(Boolean).join(" "));
       if (component)
         attachDataAttrs(t, component.kind, component.variant, meta.attrs || {});
       else
@@ -1558,25 +1637,11 @@ function plugin(md, pluginOptions = {}) {
         kind: "section",
         classes: meta.attrs && meta.attrs.class || "",
         sawContent: false,
+        ...inColumns ? { inColumns: true } : {},
         meta: { name: meta.name || null, attrs: { ...meta.attrs || {} }, component },
         openToken: t
       }, t);
     }
-    function breakHost() {
-      return stack.get("section") || stack.get("page") || stack.get("spread");
-    }
-    function gridClassOf(frame) {
-      if (!frame || !frame.classes)
-        return null;
-      return frame.classes.split(/\s+/).find((c) => c.startsWith("gp-grid-")) || null;
-    }
-    function warnBreakInsideGrid(kind, line, meta) {
-      const host = breakHost();
-      const gridClass = gridClassOf(host);
-      if (!gridClass)
-        return;
-      warn2(state.env, line, "break_inside_grid", `@${kind} inside a grid container: the enclosing @${host.kind} carries .${gridClass}, so this break's <div> becomes a grid ITEM — it takes a cell of its own, corrupts the grid's placement, and print and the live preview then disagree about which page the content after it lands on. Move the break outside the grid @${host.kind}, or remove it — grid rows already flow and fragment across pages on their own.`, meta);
-    }
     function warnIfEmptyDecoratedSection(closingKind, closingLine) {
       const sec = stack.get("section");
       if (!sec || sec.sawContent)
@@ -1641,14 +1706,18 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "section") {
-        drainDeclaredFrames();
+        const keep = sectionHostDepth();
+        drainDeclaredFrames(keep);
         warnIfEmptyDecoratedSection("section", line);
         stack.close("section");
         const spread = stack.get("spread");
         if (spread && spread.noPagesYet) {
           warn2(state.env, line, "spread_without_pages", "@section inside a spread without an explicit @page. Allowed (adhoc spread), but explicit @page markers give stronger control.", meta);
         }
-        openSection(meta);
+        if (meta.name && !locationVariants.section.has(meta.name)) {
+          warnNearMissVariant(state.env, meta, "section", locationVariants.section);
+        }
+        openSection(meta, keep > 0);
         continue;
       }
       if (kind === "continue") {
@@ -1657,7 +1726,8 @@ function plugin(md, pluginOptions = {}) {
           warn2(state.env, line, "continue_without_section", "@continue used without an open @section; ignoring marker.", meta);
           continue;
         }
-        drainDeclaredFrames();
+        const keep = sectionHostDepth();
+        drainDeclaredFrames(keep);
         const contMeta = {
           name: section.meta.name,
           attrs: { ...section.meta.attrs || {} }
@@ -1672,11 +1742,10 @@ function plugin(md, pluginOptions = {}) {
           cls.push("gp-continued");
         contMeta.attrs.class = cls.join(" ");
         stack.close("section");
-        openSection(contMeta);
+        openSection(contMeta, keep > 0);
         continue;
       }
       if (kind === "page-break") {
-        warnBreakInsideGrid("page-break", line, meta);
         const t = new state.Token("layout_page_break", "div", 0);
         t.meta = { line };
         t.attrSet("class", "gp-page-break");
@@ -1685,7 +1754,6 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "column-break") {
-        warnBreakInsideGrid("column-break", line, meta);
         const t = new state.Token("layout_column_break", "div", 0);
         t.meta = { line };
         t.attrSet("class", "gp-column-break");
@@ -1694,7 +1762,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "end-section") {
-        drainDeclaredFrames();
+        drainDeclaredFrames(sectionHostDepth());
         warnIfEmptyDecoratedSection("end-section", line);
         stack.close("section");
         continue;
@@ -1773,6 +1841,25 @@ function plugin(md, pluginOptions = {}) {
   };
   md.renderer.rules.layout_marker = () => "";
 }
+var NO_MARGIN_BOXES = [
+  "top-left-corner",
+  "top-left",
+  "top-center",
+  "top-right",
+  "top-right-corner",
+  "bottom-left-corner",
+  "bottom-left",
+  "bottom-center",
+  "bottom-right",
+  "bottom-right-corner",
+  "left-top",
+  "left-middle",
+  "left-bottom",
+  "right-top",
+  "right-middle",
+  "right-bottom"
+].map((box) => `  @${box} { content: none; }`).join(`
+`);
 var MARKER_CSS = `
 /* The UA default of 8px body margin is a screen affordance with no meaning
    in paged media, and engines disagree about it: a polyfill that treats the
@@ -1792,11 +1879,48 @@ body { margin: 0; }
 .gp-column-break { break-after: column; height: 0; font-size: 0; line-height: 0; visibility: hidden; }
 
 :where(h1,h2,h3,h4,h5,h6) { break-after: avoid; }
+/* A lead-in paragraph ("**ROLL A DIE!**" above a roll table, "You will need:"
+   above a list) stays with the table or list it introduces, the way a heading
+   stays with what follows it -- otherwise the label can end a column or page
+   with its table starting on the next (#370). Standard break-after; the
+   :has() selector is Chromium's own. :where() keeps specificity at zero so an
+   author rule such as p { break-after: auto } wins. Deliberately table/ul/ol only,
+   also when a @section wraps it (the second rule): the lead-in then keeps with
+   the section that opens with the table or list. */
+:where(p):has(+ :where(table, ul, ol)) { break-after: avoid; }
+:where(p):has(+ :where(.section) > :where(table, ul, ol):first-child) { break-after: avoid; }
 :where(img, svg, video) { max-width: 100%; }
 :where(p > img:only-child, figure > img) { width: fit-content; max-width: 100%; height: auto; vertical-align: bottom; }
 :where(p) > :where(img:not([class])) { max-height: calc(var(--gp-content-h) - 4px); object-fit: contain; }
 :where(figure) { break-inside: avoid; }
-:where(.section, figure) > :where(:first-child) { break-before: avoid; }
+
+/* Core page variants — \`@page blank\` and \`@page full-bleed\` (CORE_DECLARED_MARKERS).
+   Each is the \`.page\` the marker already emits plus one class; the class
+   assigns the page to a NAMED page, and the named \`@page\` block below is
+   plain CSS Paged Media. Authors never write these names.
+
+   SPEC GAP FILLED: none. Named pages (\`@page <name>\`, \`page:\`) and margin
+   box \`content: none\` are standard and implemented in Chromium; this is
+   author vocabulary that expands to them (permanent, like @columns), not a
+   shim, so nothing here is deleted when Chrome catches up. Both pages are
+   named \`gp-\`, which the shrink-to-fit audit (engine/compiler/build.ts)
+   leaves out of its per-page limits, so they cannot loosen it for other pages.
+
+   The folio still COUNTS on these pages (only what is drawn is cleared), and
+   a book that assigns \`page:\` to every \`.page\` in its own unlayered CSS
+   overrides the assignment, as any unlayered rule overrides this layer. */
+@page gp-page-blank {
+${NO_MARGIN_BOXES}
+}
+.page.gp-page-blank { page: gp-page-blank; }
+
+/* full-bleed: zero page margin, so the content box IS the sheet. The margin
+   boxes are cleared too — with zero margins they would land on the trim line. */
+@page gp-page-full-bleed {
+  margin: 0;
+${NO_MARGIN_BOXES}
+}
+.page.gp-page-full-bleed { page: gp-page-full-bleed; }
 
 `;
 
@@ -1856,26 +1980,24 @@ var GUTTERPRESS_CSS = `
 .gp-tight { --gp-gap: 0.5em; }
 .gp-loose { --gp-gap: 2em; }
 
-/* column runs — plain CSS Multi-column, exposed as author vocabulary so
-   "put this in two columns" does not require borrowing a styled container
-   from the book's own component layer. That borrowing is what this exists
-   to prevent: a book whose theme paints .section chrome by default gives
-   every author who opens a section just to start a column run a panel they
-   did not ask for, and the book then needs a reset rule to take it back.
-   With a neutral primitive the author opts into columns and nothing else.
+/* column runs — plain CSS Multi-column, emitted by the core @columns marker
+   (markers.js): @columns [1-5] ... @end-columns is the ONE way to lay
+   content out in columns, and @column-break moves to the next column.
+   The classes below are the CSS that marker emits, not author vocabulary.
 
    Permanent vocabulary, not a shim: Chromium implements multicol natively
    and these rules are the standard properties verbatim, so there is no
    spec gap here to remove later. Deliberately minimal — column-fill is
-   NOT set, because the correct value depends on whether the run fragments
-   across pages (auto packs each page's columns; the CSS initial balance is
-   right for a run that fits on one page) and only the author knows which.
-   --gp-column-gap is author-settable.
-   .gp-columns is what the core @columns marker emits (markers.js); on its
-   own it is two columns, and @columns 1 to 5 add the matching count, which
-   wins because it comes later at the same specificity. */
-.gp-columns, .gp-columns-1, .gp-columns-2, .gp-columns-3, .gp-columns-4, .gp-columns-5 {
+   NOT set (the CSS initial balance applies).
+   Themes style a run through two tokens instead of writing column rules:
+     --gp-column-gap   default 1.5em
+     --gp-column-rule  default none (any column-rule shorthand value)
+   Both hooks sit at zero specificity (:where), so any author rule wins.
+   .gp-columns is two columns on its own; a count class (bare @columns
+   emits gp-columns-2) wins because it comes later at the same specificity. */
+:where(.gp-columns, .gp-columns-1, .gp-columns-2, .gp-columns-3, .gp-columns-4, .gp-columns-5) {
   column-gap: var(--gp-column-gap, 1.5em);
+  column-rule: var(--gp-column-rule, none);
 }
 .gp-columns { columns: 2; }
 .gp-columns-1 { columns: 1; }
@@ -1884,54 +2006,8 @@ var GUTTERPRESS_CSS = `
 .gp-columns-4 { columns: 4; }
 .gp-columns-5 { columns: 5; }
 
-/* the per-shape decisions the paragraph above deliberately leaves to the
-   author, named instead of left as raw CSS every book was reinventing
-   (CLAUDE.md §0: "behavior broadly useful to non-technical authors belongs
-   in core").
-   Permanent vocabulary, standard properties verbatim — same rationale as
-   the column/grid runs above. One name each, no aliases:
-     .gp-columns-all       column-span: all      a heading or block that
-                                                  spans every column in the
-                                                  run it sits inside.
-     .gp-columns-flow      column-fill: auto     a run that FRAGMENTS across
-                                                  pages — every page's
-                                                  columns fill instead of
-                                                  only the last one
-                                                  balancing (the dead-column
-                                                  collapse the build's
-                                                  engine.multicol.dead-column
-                                                  warning names this fix
-                                                  for).
-     .gp-columns-balanced  column-fill: balance  a run that fits on ONE
-                                                  page (the CSS initial
-                                                  value — ragged columns
-                                                  would be wrong here). */
-.gp-columns-all { column-span: all; }
-.gp-columns-flow { column-fill: auto; }
-.gp-columns-balanced { column-fill: balance; }
-
-/* grid runs — the SLOTTED counterpart to the column runs above. Grid places
-   each child into the next cell, across then down (deterministic slots: card
-   layouts, stat blocks, image-plus-caption pairs); columns FLOW one text run
-   down then across. Same neutral-primitive rationale as .gp-columns-*, and
-   permanent vocabulary for the same reason: standard CSS Grid verbatim, no
-   spec gap to remove later. MEASURED (Chromium 151, gp-grid evidence pack):
-   grid rows fragment across sheets with EXACT print/viewer parity — 2- and
-   3-col, unequal item heights, mid-row cuts, multi-sheet overflow,
-   break-inside:avoid, gap geometry — so a grid taller than the page is safe,
-   no fit-one-page constraint. Two things to know, not fix:
-     - on a min-height page root (MARKER_CSS), default align-content
-       stretches rows apart to fill the page — identically in both engines.
-       Authors wanting packed rows set align-content: start.
-     - a @page-break / @column-break marker DIRECTLY inside a grid container
-       becomes a grid item and corrupts placement (the one measured parity
-       break); markers.js diagnoses it (break_inside_grid).
-   --gp-grid-gap is author-settable. */
-.gp-grid-2 { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--gp-grid-gap, 1.5em); }
-.gp-grid-3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--gp-grid-gap, 1.5em); }
-
 /* fragmentation controls — generic pagination utilities for any element,
-   independent of the column/grid vocabulary above (a book reached for
+   independent of the column vocabulary above (a book reached for
    these just as often outside a multicol run: keeping a card whole,
    forcing a section to start a fresh page). Standard properties only —
    this project is Chromium-only (CLAUDE.md), so there are no legacy
@@ -2089,13 +2165,10 @@ var GP_CLASSES = new Set([
   "gp-columns-3",
   "gp-columns-4",
   "gp-columns-5",
-  "gp-columns-all",
-  "gp-columns-flow",
-  "gp-columns-balanced",
+  "gp-page-blank",
+  "gp-page-full-bleed",
   "gp-no-break",
   "gp-break-before",
-  "gp-grid-2",
-  "gp-grid-3",
   "gp-shape",
   "gp-pin",
   "gp-top",
@@ -9650,7 +9723,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path13.join(stage, "raw.pdf") : path13.resolve(pdfFile);
       await fsp2.mkdir(path13.dirname(path13.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-63r7pxsy.js");
+      const { buildNativePdf } = await import("./engine-yf2w9hj7.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/{cli-5sg6hcqa.js → cli-vsgj1n9s.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-2xpwjanr.js";
+} from "./cli-2yvrfr58.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-c3enmb58.js → cli-ycbg7mxk.js}

@@ -1131,7 +1131,7 @@ var preview_shell_default = "./preview-shell-xwn84kqr.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-1n793gwd.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-ez7k4ha7.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
@@ -1185,7 +1185,7 @@ var package_default2 = "./package-aenwjew3.json";
 var README_default2 = "./README-3nj919rm.md";
 
 // src/assets/extension-templates/theme/components.yaml
-var components_default = "./components-dhgv2sm7.yaml";
+var components_default = "./components-zzqdpt3m.yaml";
 
 // src/assets/extension-templates/theme/snippets/callout.md
 var callout_default = "./callout-hv56m16h.md";
@@ -1200,7 +1200,7 @@ var base_default = "./base-ypqh9n7f.css";
 var components_default2 = "./components-aam0fe2z.css";
 
 // src/assets/extension-templates/theme/styles/page-templates.css
-var page_templates_default = "./page-templates-7md4ev7d.css";
+var page_templates_default = "./page-templates-tx9ryt19.css";
 
 // src/assets/extension-templates/theme/styles/page-rules.css
 var page_rules_default = "./page-rules-nsj3aw42.css";
@@ -2226,7 +2226,7 @@ ${mapCss}`;
       if (pageBackgrounds.length)
         log(`audit: ${pageBackgrounds.length} unreferenced @page background image(s)`);
       for (const d of multicol)
-        diagnose("engine.multicol.dead-column", `${d} runs over more than one page in columns, and only the last page's columns get balanced — earlier pages are left with an empty column. Add .gp-columns-flow to ${d} (column-fill: auto) so every page's columns fill.`);
+        diagnose("engine.multicol.dead-column", `${d} runs over more than one page in columns, and only the last page's columns get balanced — earlier pages are left with an empty column. End the @columns run where the page ends and open a new @columns for the next page, or set column-fill: auto on ${d} in your stylesheet so every page's columns fill.`);
       if (multicol.length)
         log(`audit: ${multicol.length} fragmenting multicol warning(s)`);
     }