gutterpress 0.11.17-alpha.4 → 0.11.17-alpha.6

package/dist/api/index.js

@@ -135,11 +135,11 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-gp503ze9.js";
+} from "../index-2vd5b3vy.js";
 import"../index-ht1bcqdd.js";
 import {
   BuildError
-} from "../index-q1xqxrh9.js";
+} from "../index-vmcfahe2.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/{build-fam0tqg6.js → build-yswp3npj.js}

@@ -1,19 +1,19 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-2kc34kme.js";
+} from "./cli-an3pxzzk.js";
 import {
   log
-} from "./cli-8apk8571.js";
+} from "./cli-0wtnw98y.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-pqcb2nnb.js";
+} from "./cli-jjbeqx94.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-jyy9pqf3.js";
+import"./cli-ycbg7mxk.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-8apk8571.js → cli-0wtnw98y.js}

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

package/dist/{cli-2kc34kme.js → cli-an3pxzzk.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-8apk8571.js";
+} from "./cli-0wtnw98y.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-pqcb2nnb.js";
+} from "./cli-jjbeqx94.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -27,7 +27,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-jyy9pqf3.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,22 +1207,22 @@ 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" }
   }
 };
@@ -1388,20 +1398,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);
@@ -1545,7 +1570,7 @@ 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 : "");
@@ -1558,25 +1583,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 +1652,15 @@ 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);
+        openSection(meta, keep > 0);
         continue;
       }
       if (kind === "continue") {
@@ -1657,7 +1669,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 +1685,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 +1697,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 +1705,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "end-section") {
-        drainDeclaredFrames();
+        drainDeclaredFrames(sectionHostDepth());
         warnIfEmptyDecoratedSection("end-section", line);
         stack.close("section");
         continue;
@@ -1792,11 +1803,20 @@ 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; }
 
 `;
 
@@ -1856,26 +1876,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 +1902,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 +2061,8 @@ var GP_CLASSES = new Set([
   "gp-columns-3",
   "gp-columns-4",
   "gp-columns-5",
-  "gp-columns-all",
-  "gp-columns-flow",
-  "gp-columns-balanced",
   "gp-no-break",
   "gp-break-before",
-  "gp-grid-2",
-  "gp-grid-3",
   "gp-shape",
   "gp-pin",
   "gp-top",
@@ -9650,7 +9617,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-zdb41ay1.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-pqcb2nnb.js → cli-jjbeqx94.js}

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

@@ -1113,7 +1113,7 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/assets/favicon.ico
-var favicon_default = "./favicon-wkbm9cjn.ico";
+var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
 var manifest_schema_default = "./manifest.schema-gh0jjve9.json";
@@ -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)`);
     }

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-pqcb2nnb.js";
+} from "./cli-jjbeqx94.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-bjdf7bhg.js").then((m) => m.default),
-  preview: () => import("./preview-1cschq8s.js").then((m) => m.default),
-  build: () => import("./build-fam0tqg6.js").then((m) => m.default),
-  publish: () => import("./publish-ddqrb8s9.js").then((m) => m.default),
-  validate: () => import("./validate-3hjkgxrz.js").then((m) => m.default),
-  preflight: () => import("./preflight-gvw01661.js").then((m) => m.default),
-  doctor: () => import("./doctor-zre5k5fg.js").then((m) => m.default),
-  ext: () => import("./ext-hfqcg6ax.js").then((m) => m.default)
+  new: () => import("./new-8xwac8nd.js").then((m) => m.default),
+  preview: () => import("./preview-qdby30fx.js").then((m) => m.default),
+  build: () => import("./build-yswp3npj.js").then((m) => m.default),
+  publish: () => import("./publish-v9tdq7kc.js").then((m) => m.default),
+  validate: () => import("./validate-9nszbckg.js").then((m) => m.default),
+  preflight: () => import("./preflight-62c2r37w.js").then((m) => m.default),
+  doctor: () => import("./doctor-xjgxr88y.js").then((m) => m.default),
+  ext: () => import("./ext-n664e0ka.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-bjdf7bhg.js");
+      const { newArgs } = await import("./new-8xwac8nd.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-gvw01661.js");
+      const { preflightArgs } = await import("./preflight-62c2r37w.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-hfqcg6ax.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-n664e0ka.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{components-dhgv2sm7.yaml → components-zzqdpt3m.yaml}

@@ -47,5 +47,5 @@ page_templates:
   - name: reference
     recipe: "@page .{{PREFIX}}reference"
     emits: "div.page.{{PREFIX}}reference"
-    notes: "Two columns with a rule. Prefer core's .gp-columns-2 for plain columns."
+    notes: "Ruled headings for a reference page. For columns, use core's @columns 2 ... @end-columns inside it."
     status: stable

package/dist/{doctor-zre5k5fg.js → doctor-xjgxr88y.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-8apk8571.js";
+} from "./cli-0wtnw98y.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-pqcb2nnb.js";
+} from "./cli-jjbeqx94.js";
 import"./cli-46ycxe6r.js";
 import"./cli-7fkhgtfn.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-3xqgm82d.js → engine-5d1rpxxq.js}

@@ -1,9 +1,9 @@
 import {
   build
-} from "./index-hrx0gfkj.js";
+} from "./index-09h3n36d.js";
 import {
   BuildError
-} from "./index-q1xqxrh9.js";
+} from "./index-vmcfahe2.js";
 import"./index-rzm1phg0.js";
 import"./index-37x76zdn.js";
 

package/dist/{engine-zdb41ay1.js → engine-yf2w9hj7.js}

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

package/dist/{ext-hfqcg6ax.js → ext-n664e0ka.js}

@@ -12,17 +12,17 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-2kc34kme.js";
-import"./cli-8apk8571.js";
+} from "./cli-an3pxzzk.js";
+import"./cli-0wtnw98y.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-pqcb2nnb.js";
+} from "./cli-jjbeqx94.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-jyy9pqf3.js";
+import"./cli-ycbg7mxk.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{gutterpress-viewer-1n793gwd.js → gutterpress-viewer-ez7k4ha7.js}

@@ -1415,6 +1415,18 @@
       clearLeadingForcedBreaks(s.el);
     return strips;
   }
+  var AVOID_BREAK = /^avoid(-page|-column)?$/;
+  function keepChainHead(el) {
+    let head = el;
+    for (let prev = head.previousElementSibling;prev instanceof HTMLElement; prev = head.previousElementSibling) {
+      const linked = AVOID_BREAK.test(getComputedStyle(prev).breakAfter) || AVOID_BREAK.test(getComputedStyle(head).breakBefore);
+      if (!linked)
+        break;
+      head = prev;
+    }
+    return head;
+  }
+  var pushTargets = new WeakMap;
   function compensateRepeatedHeaders(strips, maxPasses = 24) {
     const warnings = [];
     let passes = 0;
@@ -1427,6 +1439,10 @@
         for (const shim of Array.from(table.querySelectorAll("tr.gp-thead-shim, tr.gp-tfoot-shim")))
           shim.remove();
         table.style.breakBefore = "";
+        const target = pushTargets.get(table);
+        if (target)
+          target.style.breakBefore = "";
+        pushTargets.delete(table);
       }
       const pushed = new Set;
       const footClaims = new Map;
@@ -1487,7 +1503,9 @@
             shim.remove();
           if (plan.push && !pushed.has(plan.table)) {
             pushed.add(plan.table);
-            plan.table.style.breakBefore = "column";
+            const target = keepChainHead(plan.table);
+            target.style.breakBefore = "column";
+            pushTargets.set(plan.table, target);
             touched++;
             continue;
           }

package/dist/{index-hrx0gfkj.js → index-09h3n36d.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-q1xqxrh9.js";
+} from "./index-vmcfahe2.js";
 import {
   launchChromium
 } from "./index-rzm1phg0.js";
@@ -1329,7 +1329,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)`);
     }