gutterpress 0.10.0-beta.1 → 0.10.0

package/dist/api/index.js

@@ -122,12 +122,12 @@ import {
   validateProjectPlugins,
   verifyRepoReadable,
   writeAppHeartbeat
-} from "../index-052x5fef.js";
+} from "../index-ge7q9xj3.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-c2b6gyeg.js";
+} from "../index-ycpvr0am.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,

package/dist/{audit-85zn35v8.js → audit-cvarpa72.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-5tffrg48.js";
+} from "./cli-eq5naw4m.js";
 import {
   log
-} from "./cli-v935c2ws.js";
+} from "./cli-cqtggsng.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7e79d7se.js";
-import"./cli-afm8pa0h.js";
+} from "./cli-149edp6b.js";
+import"./cli-zfcryxg8.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{build-1faqmp0y.js → build-6r502chw.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-5tffrg48.js";
+} from "./cli-eq5naw4m.js";
 import {
   log
-} from "./cli-v935c2ws.js";
+} from "./cli-cqtggsng.js";
 import {
   UsageError,
   parseEngine,
@@ -12,8 +12,8 @@ import {
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7e79d7se.js";
-import"./cli-afm8pa0h.js";
+} from "./cli-149edp6b.js";
+import"./cli-zfcryxg8.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError

package/dist/{cli-7e79d7se.js → cli-149edp6b.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.0-beta.1",
+  version: "0.10.0",
   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-v935c2ws.js → cli-cqtggsng.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-7e79d7se.js";
+} from "./cli-149edp6b.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-5tffrg48.js → cli-eq5naw4m.js}

@@ -15,12 +15,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-v935c2ws.js";
+} from "./cli-cqtggsng.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-7e79d7se.js";
+} from "./cli-149edp6b.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -29,7 +29,7 @@ import {
   getAssetPath,
   getBrowser,
   prewarmBrowser
-} from "./cli-afm8pa0h.js";
+} from "./cli-zfcryxg8.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -6905,6 +6905,76 @@ async function writeBuildFingerprint(input) {
   return outPath;
 }
 
+// src/lib/build-preflight.ts
+var INSTALL_HINTS2 = {
+  gs: INSTALL_HINTS.gs.body,
+  qpdf: INSTALL_HINTS.qpdf.body
+};
+function rendersInPooledChromium(format, opts) {
+  return format !== "html" && !opts.engineBrowser;
+}
+async function preflightBuildTools(format, opts, config) {
+  const missing = [];
+  if (rendersInPooledChromium(format, opts) && !await resolveChromiumExecutable()) {
+    await requireChromiumExecutable();
+  }
+  if (format === "pdfx" && !await resolveGhostscript()) {
+    missing.push({ name: "gs (Ghostscript)", installHint: INSTALL_HINTS2.gs });
+  }
+  if (format === "pdfx") {
+    const stripAnnotations2 = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
+    if (stripAnnotations2 && !await isToolAvailable("qpdf")) {
+      missing.push({ name: "qpdf", installHint: INSTALL_HINTS2.qpdf });
+    }
+  }
+  if (missing.length === 0)
+    return;
+  const list = missing.map((m) => `  • ${m.name}
+${m.installHint}`).join(`
+
+`);
+  throw new BuildError(`Required system tools not found:
+
+${list}
+
+Install the missing tools and re-run, or set GHOSTSCRIPT_PATH, CHROMIUM_PATH, or system PATH so gutterpress can find them. See the User Guide Chapter 7 (System Setup) at examples/gutterpress-user-guide/07-system-setup.md for the full per-feature matrix.`, 2);
+}
+async function verifyNativeChromiumMilestone() {
+  let version;
+  try {
+    const browser = await getBrowser(RENDER_TIMEOUT_MS);
+    version = await browser.version();
+  } catch (err) {
+    throw new BuildError(`Could not launch a Chromium browser for --engine native: ` + `${err instanceof Error ? err.message : String(err)}`, 2);
+  }
+  const milestone = Number(/Chrome\/(\d+)/.exec(version)?.[1] ?? 0);
+  if (milestone < REQUIRED_MILESTONE) {
+    await closeBrowser();
+    throw new BuildError(`The Gutterpress native engine requires Chromium ${REQUIRED_MILESTONE}+; found ${version}.
+
+` + `Install a newer Chrome, Chromium, or Edge, or point CHROMIUM_PATH ` + `(or PUPPETEER_EXECUTABLE_PATH) at a ${REQUIRED_MILESTONE}+ binary.
+
+` + `Note: this applies to the CLI's own Chromium only — the desktop app ` + `renders --engine native with its own bundled browser and needs no ` + `separate install.`, 2);
+  }
+}
+function computeGates(format, opts, config) {
+  if (format === "html") {
+    if (opts.skipLint || opts.skipPreValidate || opts.skipPostValidate) {
+      log.info("Validation/lint flags ignored for --format html (no validation phases apply)");
+    }
+    return { lint: false, preValidate: false, postValidate: false };
+  }
+  const lint2 = !opts.skipLint && config.lint.enabled !== false;
+  const preValidate = !opts.skipPreValidate && config.validate.enabled !== false;
+  const postValidate = format === "pdfx" && !opts.skipPostValidate && config.validate.enabled !== false;
+  return { lint: lint2, preValidate, postValidate };
+}
+
+// src/lib/build-staging.ts
+import path6 from "node:path";
+import os from "node:os";
+import fsp from "node:fs/promises";
+
 // src/lib/missing-asset-placeholder.ts
 import { createHash as createHash5 } from "node:crypto";
 import { deflateSync } from "node:zlib";
@@ -7082,75 +7152,7 @@ function placeholderPng(width = 640, height = 480, cell = 32) {
   return png;
 }
 
-// src/lib/build-preflight.ts
-var INSTALL_HINTS2 = {
-  gs: INSTALL_HINTS.gs.body,
-  qpdf: INSTALL_HINTS.qpdf.body
-};
-function rendersInPooledChromium(format, opts) {
-  return format !== "html" && !opts.engineBrowser;
-}
-async function preflightBuildTools(format, opts, config) {
-  const missing = [];
-  if (rendersInPooledChromium(format, opts) && !await resolveChromiumExecutable()) {
-    await requireChromiumExecutable();
-  }
-  if (format === "pdfx" && !await resolveGhostscript()) {
-    missing.push({ name: "gs (Ghostscript)", installHint: INSTALL_HINTS2.gs });
-  }
-  if (format === "pdfx") {
-    const stripAnnotations2 = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
-    if (stripAnnotations2 && !await isToolAvailable("qpdf")) {
-      missing.push({ name: "qpdf", installHint: INSTALL_HINTS2.qpdf });
-    }
-  }
-  if (missing.length === 0)
-    return;
-  const list = missing.map((m) => `  • ${m.name}
-${m.installHint}`).join(`
-
-`);
-  throw new BuildError(`Required system tools not found:
-
-${list}
-
-Install the missing tools and re-run, or set GHOSTSCRIPT_PATH, CHROMIUM_PATH, or system PATH so gutterpress can find them. See the User Guide Chapter 7 (System Setup) at examples/gutterpress-user-guide/07-system-setup.md for the full per-feature matrix.`, 2);
-}
-async function verifyNativeChromiumMilestone() {
-  let version;
-  try {
-    const browser = await getBrowser(RENDER_TIMEOUT_MS);
-    version = await browser.version();
-  } catch (err) {
-    throw new BuildError(`Could not launch a Chromium browser for --engine native: ` + `${err instanceof Error ? err.message : String(err)}`, 2);
-  }
-  const milestone = Number(/Chrome\/(\d+)/.exec(version)?.[1] ?? 0);
-  if (milestone < REQUIRED_MILESTONE) {
-    await closeBrowser();
-    throw new BuildError(`The Gutterpress native engine requires Chromium ${REQUIRED_MILESTONE}+; found ${version}.
-
-` + `Install a newer Chrome, Chromium, or Edge, or point CHROMIUM_PATH ` + `(or PUPPETEER_EXECUTABLE_PATH) at a ${REQUIRED_MILESTONE}+ binary.
-
-` + `Note: this applies to the CLI's own Chromium only — the desktop app ` + `renders --engine native with its own bundled browser and needs no ` + `separate install.`, 2);
-  }
-}
-function computeGates(format, opts, config) {
-  if (format === "html") {
-    if (opts.skipLint || opts.skipPreValidate || opts.skipPostValidate) {
-      log.info("Validation/lint flags ignored for --format html (no validation phases apply)");
-    }
-    return { lint: false, preValidate: false, postValidate: false };
-  }
-  const lint2 = !opts.skipLint && config.lint.enabled !== false;
-  const preValidate = !opts.skipPreValidate && config.validate.enabled !== false;
-  const postValidate = format === "pdfx" && !opts.skipPostValidate && config.validate.enabled !== false;
-  return { lint: lint2, preValidate, postValidate };
-}
-
 // src/lib/build-staging.ts
-import path6 from "node:path";
-import os from "node:os";
-import fsp from "node:fs/promises";
 async function shipViewerHtml(htmlFile, outDir) {
   await fsp.mkdir(path6.join(outDir, "engine"), { recursive: true });
   await fsp.copyFile(await getAssetPath("engine/gutterpress-viewer.js"), path6.join(outDir, "engine/gutterpress-viewer.js"));
@@ -7159,6 +7161,50 @@ async function shipViewerHtml(htmlFile, outDir) {
   const html = await fsp.readFile(htmlFile, "utf-8");
   await fsp.writeFile(htmlFile, /<\/head>/i.test(html) ? html.replace(/<\/head>/i, tag + "</head>") : tag + html, "utf-8");
 }
+async function stageBookAssets(options) {
+  const { renderDir, outDir, htmlFile, imageRefs, cssAssets, onPlan } = options;
+  const { copies: imageCopies, errors, destinations } = await planImageCopies(renderDir, imageRefs);
+  const copies = [...cssAssets, ...imageCopies];
+  onPlan?.({ unresolved: errors, copyCount: copies.length });
+  const missingPlaceholders = copies.length ? await copyReferencedAssets(copies, outDir) : new Map;
+  let staged = await fsp.readFile(htmlFile, "utf8");
+  if (missingPlaceholders.size > 0) {
+    const rewrites = new Map(missingPlaceholders);
+    for (const [ref, dest] of destinations) {
+      const placeholder = missingPlaceholders.get(dest);
+      if (placeholder)
+        rewrites.set(ref, placeholder);
+    }
+    staged = rewriteMissingImageReferences(staged, rewrites);
+    await fsp.writeFile(htmlFile, staged, "utf8");
+  }
+  if (staged.includes("--gp-shape:")) {
+    await fsp.writeFile(htmlFile, await inlineShapeUrls(staged, outDir), "utf8");
+  }
+  return { missing: [...missingPlaceholders.keys()].sort() };
+}
+async function copyReferencedAssets(copies, outDir) {
+  const dirs = new Set(copies.map((c) => path6.dirname(path6.resolve(outDir, c.to))));
+  await Promise.all([...dirs].map((d) => fsp.mkdir(d, { recursive: true })));
+  const missing = new Map;
+  await Promise.all(copies.map(async (c) => {
+    const dest = path6.resolve(outDir, c.to);
+    try {
+      await fsp.copyFile(c.from, dest);
+    } catch (err) {
+      if (err?.code === "ENOENT") {
+        const placeholder = placeholderOutputPath(c.to);
+        const placeholderDest = path6.resolve(outDir, placeholder);
+        await fsp.mkdir(path6.dirname(placeholderDest), { recursive: true });
+        await fsp.writeFile(placeholderDest, placeholderPng());
+        missing.set(c.to, placeholder);
+        return;
+      }
+      throw new BuildError(`Could not copy asset ${c.from} → ${c.to}: ` + (err instanceof Error ? err.message : String(err)), 1);
+    }
+  }));
+  return missing;
+}
 async function createStageRoot() {
   return fsp.mkdtemp(path6.join(os.tmpdir(), "gutterpress-stage-"));
 }
@@ -7271,67 +7317,35 @@ async function renderBook(ctx) {
       }
     },
     onImageRefs: (refs) => imageRefs.push(...refs),
-    onCssAssets: (copies2) => cssAssets.push(...copies2),
+    onCssAssets: (copies) => cssAssets.push(...copies),
     onStyleWarnings: (warnings) => {
       for (const w of warnings)
         log.warn(`  ${w}`);
     }
   });
   log.success(`Wrote ${htmlFile}`);
-  const { copies: imageCopies, errors, destinations } = await planImageCopies(renderDir, imageRefs);
-  if (errors.length > 0) {
-    throw new BuildError(`Cannot resolve ${errors.length} image reference(s):
-` + errors.map((e) => `  - ${e}`).join(`
+  const { missing } = await stageBookAssets({
+    renderDir,
+    outDir: workDir,
+    htmlFile,
+    imageRefs,
+    cssAssets,
+    onPlan: ({ unresolved, copyCount }) => {
+      if (unresolved.length > 0) {
+        throw new BuildError(`Cannot resolve ${unresolved.length} image reference(s):
+` + unresolved.map((e) => `  - ${e}`).join(`
 `), 1);
-  }
-  const copies = [...cssAssets, ...imageCopies];
-  let missingPlaceholders = new Map;
-  if (copies.length > 0) {
-    log.info(`Copying ${copies.length} referenced asset(s)`);
-    missingPlaceholders = await copyReferencedAssets(copies, workDir);
-  }
-  let staged = await fsp2.readFile(htmlFile, "utf8");
-  if (missingPlaceholders.size > 0) {
-    const rewrites = new Map(missingPlaceholders);
-    for (const [ref, dest] of destinations) {
-      const placeholder = missingPlaceholders.get(dest);
-      if (placeholder)
-        rewrites.set(ref, placeholder);
-    }
-    staged = rewriteMissingImageReferences(staged, rewrites);
-    await fsp2.writeFile(htmlFile, staged, "utf8");
-  }
-  if (staged.includes("--gp-shape:")) {
-    await fsp2.writeFile(htmlFile, await inlineShapeUrls(staged, workDir), "utf8");
-  }
-  return htmlFile;
-}
-async function copyReferencedAssets(copies, outDir) {
-  const dirs = new Set(copies.map((c) => path7.dirname(path7.resolve(outDir, c.to))));
-  await Promise.all([...dirs].map((d) => fsp2.mkdir(d, { recursive: true })));
-  const missing = new Map;
-  await Promise.all(copies.map(async (c) => {
-    const dest = path7.resolve(outDir, c.to);
-    try {
-      await fsp2.copyFile(c.from, dest);
-    } catch (err) {
-      if (err?.code === "ENOENT") {
-        const placeholder = placeholderOutputPath(c.to);
-        const placeholderDest = path7.resolve(outDir, placeholder);
-        await fsp2.mkdir(path7.dirname(placeholderDest), { recursive: true });
-        await fsp2.writeFile(placeholderDest, placeholderPng());
-        missing.set(c.to, placeholder);
-        return;
       }
-      throw new BuildError(`Could not copy asset ${c.from} → ${c.to}: ` + (err instanceof Error ? err.message : String(err)), 1);
+      if (copyCount > 0)
+        log.info(`Copying ${copyCount} referenced asset(s)`);
     }
-  }));
-  if (missing.size > 0) {
-    log.warn(`${missing.size} referenced image(s) do not exist — a magenta placeholder ` + `was substituted so the build could finish. Each one is a visible hole ` + `in the PDF:`);
-    for (const m of [...missing.keys()].sort())
+  });
+  if (missing.length > 0) {
+    log.warn(`${missing.length} referenced image(s) do not exist — a magenta placeholder ` + `was substituted so the build could finish. Each one is a visible hole ` + `in the PDF:`);
+    for (const m of missing)
       log.warn(`  missing: ${m}`);
   }
-  return missing;
+  return htmlFile;
 }
 async function resolveIccProfile(icc, manifestDir, explicitIccPath) {
   const iccCandidates = path7.isAbsolute(icc) ? [icc] : [path7.resolve(manifestDir, icc), path7.resolve(icc)];
@@ -7429,7 +7443,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path7.join(stage, "raw.pdf") : path7.resolve(pdfFile);
       await fsp2.mkdir(path7.dirname(path7.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-hrtn0b28.js");
+      const { buildNativePdf } = await import("./engine-ft4cr3ep.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/{cli-afm8pa0h.js → cli-zfcryxg8.js}

@@ -1422,7 +1422,7 @@ var favicon_default = "./favicon-wkbm9cjn.ico";
 var manifest_schema_default = "./manifest.schema-zxgxnbg7.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-hg5eqv88.js";
+var preview_interface_default = "./preview-interface-0ssk8bmm.js";
 
 // src/assets/preview/scripts/preview-bridge.js
 var preview_bridge_default = "./preview-bridge-fz7vpk8m.js";
@@ -1434,7 +1434,7 @@ var preview_shell_default = "./preview-shell-c5mfa3q0.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-fb6fhwsy.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-te8g5grx.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-7e79d7se.js";
+} from "./cli-149edp6b.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,17 +18,17 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-vsgpxzek.js").then((m) => m.default),
-  preview: () => import("./preview-cqf383g4.js").then((m) => m.default),
-  build: () => import("./build-1faqmp0y.js").then((m) => m.default),
-  publish: () => import("./publish-arvycera.js").then((m) => m.default),
-  lint: () => import("./lint-17404bsx.js").then((m) => m.default),
-  validate: () => import("./validate-ztzq7p35.js").then((m) => m.default),
-  audit: () => import("./audit-85zn35v8.js").then((m) => m.default),
-  preflight: () => import("./preflight-1h3apvqh.js").then((m) => m.default),
-  repair: () => import("./repair-vmwh2bhe.js").then((m) => m.default),
-  doctor: () => import("./doctor-69v5c9wy.js").then((m) => m.default),
-  plugin: () => import("./plugin-s4yfpx6p.js").then((m) => m.default)
+  new: () => import("./new-hvq0x91q.js").then((m) => m.default),
+  preview: () => import("./preview-d4s6gk6p.js").then((m) => m.default),
+  build: () => import("./build-6r502chw.js").then((m) => m.default),
+  publish: () => import("./publish-tkc26en7.js").then((m) => m.default),
+  lint: () => import("./lint-p2sw53d9.js").then((m) => m.default),
+  validate: () => import("./validate-w9vfefrw.js").then((m) => m.default),
+  audit: () => import("./audit-cvarpa72.js").then((m) => m.default),
+  preflight: () => import("./preflight-4j00yd0g.js").then((m) => m.default),
+  repair: () => import("./repair-2va4w12t.js").then((m) => m.default),
+  doctor: () => import("./doctor-akvxbtjb.js").then((m) => m.default),
+  plugin: () => import("./plugin-pssmk0dx.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -53,7 +53,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-vsgpxzek.js");
+      const { newArgs } = await import("./new-hvq0x91q.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed2 = parseArgs(commandArgs, {
         ...newArgs,
@@ -65,7 +65,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-1h3apvqh.js");
+      const { preflightArgs } = await import("./preflight-4j00yd0g.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed2 = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -89,7 +89,7 @@ async function preflightRequiredInvocations(rawArgs) {
     if (subcommand !== "add") {
       throw new UsageError(`gutterpress plugin: unknown command "${subcommand}"`);
     }
-    const { pluginAddArgs } = await import("./plugin-s4yfpx6p.js");
+    const { pluginAddArgs } = await import("./plugin-pssmk0dx.js");
     rejectUnknownFlags(subcommandArgs, pluginAddArgs, "plugin add");
     const parsed = parseArgs(subcommandArgs, {
       ...pluginAddArgs,

package/dist/{doctor-69v5c9wy.js → doctor-akvxbtjb.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-v935c2ws.js";
+} from "./cli-cqtggsng.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7e79d7se.js";
+} from "./cli-149edp6b.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-nbfdy0pp.js → engine-b159tbns.js}

@@ -1,13 +1,13 @@
 import {
   build
-} from "./index-wsydvp08.js";
+} from "./index-wq3r5pj7.js";
 import {
   BuildError,
   RENDER_TIMEOUT_MS,
   assertMilestone,
   connectChromium,
   getBrowser
-} from "./index-c2b6gyeg.js";
+} from "./index-ycpvr0am.js";
 import"./index-37x76zdn.js";
 
 // src/lib/engine.ts

package/dist/{engine-hrtn0b28.js → engine-ft4cr3ep.js}

@@ -4,7 +4,7 @@ import {
   build,
   connectChromium,
   getBrowser
-} from "./cli-afm8pa0h.js";
+} from "./cli-zfcryxg8.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError