gutterpress 0.11.17-alpha.2 → 0.11.17-alpha.3

package/dist/render.js

@@ -354,7 +354,7 @@ function resolveContainerShape(name, pluginName, decl) {
     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"]) {
+    for (const field of ["tag", "label", "autoCloseAt", "selfClosing"]) {
       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.`);
       }
@@ -411,11 +411,26 @@ function resolveContainerShape(name, pluginName, decl) {
     }
     autoCloseAtEof = decl.autoCloseAt.includes("eof");
   }
+  if (decl.selfClosing !== undefined && typeof decl.selfClosing !== "boolean") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`selfClosing\` that is not a boolean.`);
+  }
+  if (decl.selfClosing && decl.autoCloseAt !== undefined) {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" sets \`selfClosing: true\` and \`autoCloseAt\` — a ` + `self-closing marker has no open container to auto-close. Remove one of them.`);
+  }
   if (decl.validate !== undefined && typeof decl.validate !== "function") {
     throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`validate\` that is not a function.`);
   }
   const check = decl.validate ? { validate: decl.validate, validateOwner: pluginName } : {};
-  return { tag, classBase, variants, label, autoCloseAtEof, ...decl.section ? { section: true } : {}, ...check };
+  return {
+    tag,
+    classBase,
+    variants,
+    label,
+    autoCloseAtEof,
+    ...decl.section ? { section: true } : {},
+    ...decl.selfClosing ? { selfClosing: true } : {},
+    ...check
+  };
 }
 function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   const pluginName = originOf.get(name);
@@ -674,7 +689,8 @@ function plugin(md, pluginOptions = {}) {
       addClasses(t, baseClass, meta.attrs && meta.attrs.class ? meta.attrs.class : "");
       attachDataAttrs(t, decl.baseKind, variant, meta.attrs || {});
       out.push(t);
-      declaredFrames.push({ kind: decl.baseKind, tag: decl.tag, decl, line: meta.__line });
+      if (!decl.selfClosing)
+        declaredFrames.push({ kind: decl.baseKind, tag: decl.tag, decl, line: meta.__line });
       if (decl.label) {
         const value = meta.attrs && meta.attrs[decl.label.attr];
         if (value) {
@@ -685,6 +701,8 @@ function plugin(md, pluginOptions = {}) {
           t.meta.labelled = true;
         }
       }
+      if (decl.selfClosing)
+        out.push(new state.Token("layout_component_close", decl.tag, -1));
     }
     const stack = {
       frames: [],
@@ -963,7 +981,7 @@ function plugin(md, pluginOptions = {}) {
               continue;
             }
             if (!closeDeclaredFrame(closeDecl.baseKind)) {
-              warn(state.env, line, "declared_marker_close_without_open", `@${kind} used without an open @${closeDecl.baseKind}; ignoring marker.`, meta);
+              warn(state.env, line, "declared_marker_close_without_open", closeDecl.selfClosing ? `@${kind} is not a marker: @${closeDecl.baseKind} is self-closing and has nothing to close; ignoring marker.` : `@${kind} used without an open @${closeDecl.baseKind}; ignoring marker.`, meta);
             }
             continue;
           }
@@ -2077,6 +2095,12 @@ function collectPluginCss(plugins) {
 `);
 }
 
+// src/engine/shared/synthesis.ts
+function lastPageMode(print) {
+  return print.lastPage ?? (print.reserveLastPage ? "blank" : undefined);
+}
+var WHICH_VALUES = new Set(["first", "start", "last", "first-except"]);
+
 // src/lib/markdown/assemble.ts
 async function assembleBookHtml(opts) {
   const title = opts.title ?? "Document";
@@ -2134,7 +2158,8 @@ ${projectCss.trim()}` : null
 `);
   const preloadTags = (opts.preloadImages ?? []).map((href) => `
   <link rel="preload" as="image" href="${href}">`).join("");
-  const printAttrs = (opts.print?.signature && opts.print.signature > 1 ? ` data-gp-signature="${opts.print.signature}"` : "") + (opts.print?.reserveLastPage ? " data-gp-reserve-last-page" : "");
+  const lastPage = opts.print && lastPageMode(opts.print);
+  const printAttrs = (opts.print?.signature && opts.print.signature > 1 ? ` data-gp-signature="${opts.print.signature}"` : "") + (lastPage ? ` data-gp-last-page="${lastPage}"` : "");
   return `<!DOCTYPE html>
 <html lang="en"${printAttrs}>
 <head>

package/dist/schema/manifest.types.d.ts

@@ -1,3 +1,4 @@
+import type { LastPageMode } from "../engine/shared/synthesis";
 type CheckSeverity = "error" | "warning" | "info";
 /**
  * The object form of an `extensions:` entry (#265) — only for an entry that
@@ -132,6 +133,14 @@ export interface GutterpressManifest {
          * DriveThruRPG reserve the last page for printer info.
          */
         reserveLastPage?: boolean;
+        /**
+         * What the interior's last page is for a printer that reserves it:
+         * `blank` (an empty page the build adds — what `reserveLastPage: true`
+         * means) or `short-by-one` (one page short of a multiple of `signature`,
+         * the printer supplies the last page). When set it wins over
+         * `reserveLastPage`.
+         */
+        lastPage?: LastPageMode;
     };
     page?: {
         width?: number;
@@ -145,6 +154,12 @@ export interface GutterpressManifest {
     lint?: {
         enabled?: boolean;
         configPath?: string | null;
+        /**
+         * Per-rule level overrides, keyed by rule id (`printsafe/*`, or a check id
+         * such as `source.accessibility.heading-order`). `off` silences the rule;
+         * `warn` / `error` set its severity. Unknown ids are ignored.
+         */
+        rules?: Record<string, "off" | "warn" | "error">;
     };
     validate?: {
         enabled?: boolean;
@@ -240,6 +255,7 @@ export interface ResolvedConfig {
     print: {
         signature: number;
         reserveLastPage: boolean;
+        lastPage?: LastPageMode;
     };
     page: {
         width: number;
@@ -253,6 +269,7 @@ export interface ResolvedConfig {
     lint: {
         enabled: boolean;
         configPath: string | null;
+        rules: Record<string, "off" | "warn" | "error">;
     };
     validate: {
         enabled: boolean;

package/dist/{validate-fgwwxtbn.js → validate-xaajdw4x.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-6z5zthzt.js";
+} from "./cli-9nba5ve6.js";
 import {
   log
-} from "./cli-70xgehq2.js";
+} from "./cli-3p1e95zc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ppc0vz4b.js";
-import"./cli-gymfg04q.js";
+} from "./cli-d57bsfpb.js";
+import"./cli-jyy9pqf3.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.17-alpha.2",
+  "version": "0.11.17-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/index-eyaj6nkc.js

@@ -1,267 +0,0 @@
-// src/lib/build-error.ts
-var EXIT_CODES = {
-  OK: 0,
-  FINDINGS: 1,
-  USAGE: 2,
-  PIPELINE: 3
-};
-
-class BuildError extends Error {
-  exitCode;
-  constructor(message, exitCode = EXIT_CODES.PIPELINE, options) {
-    super(message, options);
-    this.name = "BuildError";
-    this.exitCode = exitCode;
-  }
-}
-
-// src/lib/embedded-assets.ts
-import { existsSync } from "node:fs";
-import { mkdtemp, mkdir, writeFile, readFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-// src/assets/favicon.ico
-var favicon_default = "./favicon-wkbm9cjn.ico";
-
-// src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-40sfq49z.json";
-
-// src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-c44qk17f.js";
-
-// src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
-
-// src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-xwn84kqr.js";
-
-// profiles/CGATS21_CRPC1.icc
-var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
-
-// src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-zkv2stfy.js";
-
-// src/assets/engine/gutterpress-agent.js
-var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
-
-// src/assets/templates/book/manifest.yaml
-var manifest_default = "./manifest-n1gh3qw5.yaml";
-
-// src/assets/templates/book/chapter-01.md
-var chapter_01_default = "./chapter-01-rkpyvjna.md";
-
-// src/assets/templates/zine/manifest.yaml
-var manifest_default2 = "./manifest-n1gh3qw5.yaml";
-
-// src/assets/templates/zine/chapter-01.md
-var chapter_01_default2 = "./chapter-01-7jwqg1ct.md";
-
-// src/assets/templates/technical/manifest.yaml
-var manifest_default3 = "./manifest-n1gh3qw5.yaml";
-
-// src/assets/templates/technical/chapter-01.md
-var chapter_01_default3 = "./chapter-01-6fn9pvd0.md";
-
-// src/assets/extension-templates/plugin/package.json
-var package_default = "./package-9rv69pxm.json";
-
-// src/assets/extension-templates/plugin/README.md
-var README_default = "./README-vsnsc1b3.md";
-
-// src/assets/extension-templates/plugin/plugin.js.tpl
-var plugin_js_default = "./plugin.js-m4a7m3t4.tpl";
-
-// src/assets/extension-templates/plugin/styles/plugin.css
-var plugin_default = "./plugin-spbcem4j.css";
-
-// src/assets/extension-templates/plugin/snippets/term-box.md
-var term_box_default = "./term-box-4y0w7y32.md";
-
-// src/assets/extension-templates/plugin/test/fixture.md
-var fixture_default = "./fixture-2qnyqgb5.md";
-
-// src/assets/extension-templates/plugin/test/expected.html
-var expected_default = "./expected-ycmacem8.html";
-
-// src/assets/extension-templates/plugin/test/plugin.test.js.tpl
-var plugin_test_js_default = "./plugin.test.js-6n8ct5e3.tpl";
-
-// src/assets/extension-templates/theme/package.json
-var package_default2 = "./package-aenwjew3.json";
-
-// src/assets/extension-templates/theme/README.md
-var README_default2 = "./README-3nj919rm.md";
-
-// src/assets/extension-templates/theme/components.yaml
-var components_default = "./components-dhgv2sm7.yaml";
-
-// src/assets/extension-templates/theme/snippets/callout.md
-var callout_default = "./callout-hv56m16h.md";
-
-// src/assets/extension-templates/theme/styles/tokens.css
-var tokens_default = "./tokens-7984461t.css";
-
-// src/assets/extension-templates/theme/styles/base.css
-var base_default = "./base-ypqh9n7f.css";
-
-// src/assets/extension-templates/theme/styles/components.css
-var components_default2 = "./components-aam0fe2z.css";
-
-// src/assets/extension-templates/theme/styles/page-templates.css
-var page_templates_default = "./page-templates-7md4ev7d.css";
-
-// src/assets/extension-templates/theme/styles/page-rules.css
-var page_rules_default = "./page-rules-nsj3aw42.css";
-
-// src/assets/extension-templates/theme/styles/book.css
-var book_default = "./book-ted3tzrp.css";
-
-// src/assets/themes/clean-book/theme.css
-var theme_default = "./theme-j2bagrfx.css";
-
-// src/assets/themes/clean-book/package.json
-var package_default3 = "./package-97gm31sg.json";
-
-// src/assets/themes/zine/theme.css
-var theme_default2 = "./theme-h5recz6c.css";
-
-// src/assets/themes/zine/package.json
-var package_default4 = "./package-gag6ykwn.json";
-
-// src/assets/themes/technical-doc/theme.css
-var theme_default3 = "./theme-nn6d53zy.css";
-
-// src/assets/themes/technical-doc/package.json
-var package_default5 = "./package-nrhkwf2m.json";
-
-// src/lib/embedded-assets.ts
-var __libdir = dirname(fileURLToPath(import.meta.url));
-var abs = (p) => resolve(__libdir, p);
-var filePath = (v) => v;
-var EMBEDDED_ASSETS = {
-  "favicon.ico": abs(favicon_default),
-  "manifest.schema.json": abs(filePath(manifest_schema_default)),
-  "preview/scripts/preview-interface.js": abs(filePath(preview_interface_default)),
-  "preview/scripts/preview-bridge.js": abs(filePath(preview_bridge_default)),
-  "preview/scripts/preview-shell.js": abs(filePath(preview_shell_default)),
-  "profiles/CGATS21_CRPC1.icc": abs(filePath(CGATS21_CRPC1_default)),
-  "engine/gutterpress-viewer.js": abs(filePath(gutterpress_viewer_default)),
-  "engine/gutterpress-agent.js": abs(filePath(gutterpress_agent_default)),
-  "templates/book/manifest.yaml": abs(filePath(manifest_default)),
-  "templates/book/chapter-01.md": abs(filePath(chapter_01_default)),
-  "templates/zine/manifest.yaml": abs(filePath(manifest_default2)),
-  "templates/zine/chapter-01.md": abs(filePath(chapter_01_default2)),
-  "templates/technical/manifest.yaml": abs(filePath(manifest_default3)),
-  "templates/technical/chapter-01.md": abs(filePath(chapter_01_default3)),
-  "extension-templates/plugin/package.json": abs(filePath(package_default)),
-  "extension-templates/plugin/README.md": abs(filePath(README_default)),
-  "extension-templates/plugin/plugin.js.tpl": abs(filePath(plugin_js_default)),
-  "extension-templates/plugin/styles/plugin.css": abs(filePath(plugin_default)),
-  "extension-templates/plugin/snippets/term-box.md": abs(filePath(term_box_default)),
-  "extension-templates/plugin/test/fixture.md": abs(filePath(fixture_default)),
-  "extension-templates/plugin/test/expected.html": abs(filePath(expected_default)),
-  "extension-templates/plugin/test/plugin.test.js.tpl": abs(filePath(plugin_test_js_default)),
-  "extension-templates/theme/package.json": abs(filePath(package_default2)),
-  "extension-templates/theme/README.md": abs(filePath(README_default2)),
-  "extension-templates/theme/components.yaml": abs(filePath(components_default)),
-  "extension-templates/theme/snippets/callout.md": abs(filePath(callout_default)),
-  "extension-templates/theme/styles/tokens.css": abs(filePath(tokens_default)),
-  "extension-templates/theme/styles/base.css": abs(filePath(base_default)),
-  "extension-templates/theme/styles/components.css": abs(filePath(components_default2)),
-  "extension-templates/theme/styles/page-templates.css": abs(filePath(page_templates_default)),
-  "extension-templates/theme/styles/page-rules.css": abs(filePath(page_rules_default)),
-  "extension-templates/theme/styles/book.css": abs(filePath(book_default)),
-  "themes/clean-book/theme.css": abs(filePath(theme_default)),
-  "themes/clean-book/package.json": abs(filePath(package_default3)),
-  "themes/zine/theme.css": abs(filePath(theme_default2)),
-  "themes/zine/package.json": abs(filePath(package_default4)),
-  "themes/technical-doc/theme.css": abs(filePath(theme_default3)),
-  "themes/technical-doc/package.json": abs(filePath(package_default5))
-};
-var extractPromise = null;
-async function extractAssets() {
-  const root = await mkdtemp(join(tmpdir(), "gutterpress-assets-"));
-  for (const [relPath, srcPath] of Object.entries(EMBEDDED_ASSETS)) {
-    const dest = join(root, relPath);
-    await mkdir(dirname(dest), { recursive: true });
-    const bytes = await readFile(srcPath);
-    await writeFile(dest, bytes);
-  }
-  return root;
-}
-var SENTINEL_ASSET = "engine/gutterpress-viewer.js";
-async function getAssetsDir() {
-  if (extractPromise) {
-    try {
-      const root = await extractPromise;
-      if (existsSync(join(root, SENTINEL_ASSET))) {
-        return root;
-      }
-    } catch {}
-    extractPromise = null;
-  }
-  extractPromise = extractAssets();
-  return extractPromise;
-}
-async function getAssetPath(relPath) {
-  const root = await getAssetsDir();
-  return join(root, relPath);
-}
-
-// src/engine/shared/margin-box-support.ts
-var MARGIN_BOX_IGNORED_PROPERTIES = new Set([
-  "transform",
-  "rotate",
-  "translate",
-  "scale",
-  "perspective",
-  "box-shadow",
-  "opacity",
-  "outline",
-  "outline-color",
-  "outline-style",
-  "outline-width",
-  "outline-offset",
-  "filter",
-  "backdrop-filter",
-  "mix-blend-mode",
-  "clip-path"
-]);
-function isIgnoredMarginBoxProperty(property) {
-  return MARGIN_BOX_IGNORED_PROPERTIES.has(property.toLowerCase());
-}
-function marginBoxRectPt(name, g) {
-  const { top, right, bottom, left } = g.margin;
-  const cw = g.width - left - right;
-  const ch = g.height - top - bottom;
-  const third = (n) => n / 3;
-  const T = {
-    "top-left-corner": [0, 0, left, top],
-    "top-left": [left, 0, third(cw), top],
-    "top-center": [left + third(cw), 0, third(cw), top],
-    "top-right": [left + 2 * third(cw), 0, third(cw), top],
-    "top-right-corner": [g.width - right, 0, right, top],
-    "bottom-left-corner": [0, g.height - bottom, left, bottom],
-    "bottom-left": [left, g.height - bottom, third(cw), bottom],
-    "bottom-center": [left + third(cw), g.height - bottom, third(cw), bottom],
-    "bottom-right": [left + 2 * third(cw), g.height - bottom, third(cw), bottom],
-    "bottom-right-corner": [g.width - right, g.height - bottom, right, bottom],
-    "left-top": [0, top, left, third(ch)],
-    "left-middle": [0, top + third(ch), left, third(ch)],
-    "left-bottom": [0, top + 2 * third(ch), left, third(ch)],
-    "right-top": [g.width - right, top, right, third(ch)],
-    "right-middle": [g.width - right, top + third(ch), right, third(ch)],
-    "right-bottom": [g.width - right, top + 2 * third(ch), right, third(ch)]
-  };
-  const [x, y, w, h] = T[name] ?? [0, 0, 0, 0];
-  return { x, y, w, h };
-}
-function marginBoxAlign(name) {
-  if (name.includes("center") || name.includes("middle"))
-    return "center";
-  return /right/.test(name) ? "end" : "start";
-}
-
-export { EXIT_CODES, BuildError, getAssetsDir, getAssetPath, MARGIN_BOX_IGNORED_PROPERTIES, isIgnoredMarginBoxProperty, marginBoxRectPt, marginBoxAlign };