gutterpress 0.11.17-alpha.6 → 0.11.17-alpha.8

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,7 +136,7 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-2vd5b3vy.js";
+} from "../index-4qx2z7rm.js";
 import"../index-ht1bcqdd.js";
 import {
   BuildError
@@ -242,6 +243,7 @@ export {
   listNpmVersions,
   listMergedSnippets,
   listMarkerComponents,
+  listLocationVariants,
   listLocalBranches,
   listGitHubRepositories,
   listGitHubBranches,

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

@@ -1,17 +1,17 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-an3pxzzk.js";
+} from "./cli-vtb897de.js";
 import {
   log
-} from "./cli-0wtnw98y.js";
+} from "./cli-cxxc73t3.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-jjbeqx94.js";
+} from "./cli-fq80qyy2.js";
 import"./cli-ht1bcqdd.js";
 import"./cli-ycbg7mxk.js";
 import {

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

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

package/dist/{cli-jjbeqx94.js → cli-fq80qyy2.js}

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

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-0wtnw98y.js";
+} from "./cli-cxxc73t3.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-jjbeqx94.js";
+} from "./cli-fq80qyy2.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -1224,18 +1224,53 @@ var CORE_DECLARED_MARKERS = {
     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.`);
@@ -1248,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) {
@@ -1303,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)
@@ -1310,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,
@@ -1320,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];
@@ -1503,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);
@@ -1534,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 : "";
@@ -1573,7 +1626,8 @@ function plugin(md, pluginOptions = {}) {
     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
@@ -1660,6 +1714,9 @@ function plugin(md, pluginOptions = {}) {
         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);
         }
+        if (meta.name && !locationVariants.section.has(meta.name)) {
+          warnNearMissVariant(state.env, meta, "section", locationVariants.section);
+        }
         openSection(meta, keep > 0);
         continue;
       }
@@ -1784,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
@@ -1818,6 +1894,34 @@ body { margin: 0; }
 :where(p) > :where(img:not([class])) { max-height: calc(var(--gp-content-h) - 4px); object-fit: contain; }
 :where(figure) { break-inside: 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; }
+
 `;
 
 // src/lib/markdown/gutterpress-css.ts
@@ -2061,6 +2165,8 @@ var GP_CLASSES = new Set([
   "gp-columns-3",
   "gp-columns-4",
   "gp-columns-5",
+  "gp-page-blank",
+  "gp-page-full-bleed",
   "gp-no-break",
   "gp-break-before",
   "gp-shape",

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-jjbeqx94.js";
+} from "./cli-fq80qyy2.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-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)
+  new: () => import("./new-6728wa4h.js").then((m) => m.default),
+  preview: () => import("./preview-7j7praqt.js").then((m) => m.default),
+  build: () => import("./build-szv6yb9b.js").then((m) => m.default),
+  publish: () => import("./publish-r3gd2pgd.js").then((m) => m.default),
+  validate: () => import("./validate-neh48dk8.js").then((m) => m.default),
+  preflight: () => import("./preflight-q2z645kv.js").then((m) => m.default),
+  doctor: () => import("./doctor-nymyn4ht.js").then((m) => m.default),
+  ext: () => import("./ext-eqy2brat.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-8xwac8nd.js");
+      const { newArgs } = await import("./new-6728wa4h.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-62c2r37w.js");
+      const { preflightArgs } = await import("./preflight-q2z645kv.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-n664e0ka.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-eqy2brat.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

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

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

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

@@ -12,15 +12,15 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-an3pxzzk.js";
-import"./cli-0wtnw98y.js";
+} from "./cli-vtb897de.js";
+import"./cli-cxxc73t3.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-jjbeqx94.js";
+} from "./cli-fq80qyy2.js";
 import"./cli-ht1bcqdd.js";
 import"./cli-ycbg7mxk.js";
 import {