gutterpress 0.11.16 → 0.11.17-alpha.2

package/dist/{index-40achhs8.js → index-c275p061.js}

@@ -4,7 +4,7 @@ import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./index-ee7wp8q3.js";
+} from "./index-eyaj6nkc.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -2859,8 +2859,9 @@ ${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" : "");
   return `<!DOCTYPE html>
-<html lang="en">
+<html lang="en"${printAttrs}>
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -3319,6 +3320,7 @@ ${css.trim()}
     projectCss: inlined.css,
     preloadImages: cssAssetCopies.map((c) => c.to),
     title: opts.title,
+    print: opts.print,
     plugins: opts.plugins,
     pluginCss,
     annotateSourceChapters: opts.annotateSourceChapters,
@@ -3330,6 +3332,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
   await mkdir(outDir, { recursive: true });
   const html = await renderChapters(inputDir, {
     title: opts.title,
+    print: opts.print,
     styles: opts.styles,
     files: opts.files,
     plugins: opts.plugins,
@@ -5638,7 +5641,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.16",
+  version: "0.11.17-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -10106,6 +10109,7 @@ async function renderBook(ctx) {
   const cssAssets = [];
   const htmlFile = await renderChaptersToFile(renderDir, workDir, {
     title: config.title,
+    print: config.print,
     styles: config.styles,
     files: config.source.files,
     plugins,
@@ -10257,7 +10261,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-w17dbt4f.js");
+      const { buildNativePdf } = await import("./engine-5jzhjjvv.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10359,7 +10363,7 @@ async function runBuild(opts) {
   }
 }
 // src/preview/lifecycle.ts
-import path15 from "path";
+import path16 from "path";
 import { tmpdir } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
 import { readdir as readdir5, readFile as readFile25, writeFile as writeFile6 } from "node:fs/promises";
@@ -10384,7 +10388,65 @@ async function mkdir6(dirPath) {
 // src/preview/file-watcher.ts
 import { watch } from "chokidar";
 import fsp3 from "node:fs/promises";
-import path14 from "path";
+import path15 from "path";
+
+// src/lib/static-serve.ts
+import path14 from "node:path";
+var STATIC_MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".htm": "text/html; charset=utf-8",
+  ".css": "text/css",
+  ".js": "application/javascript",
+  ".mjs": "application/javascript",
+  ".json": "application/json",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".webp": "image/webp",
+  ".avif": "image/avif",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".otf": "font/otf"
+};
+function resolveWithinRoot(relPath, root) {
+  const resolvedRoot = path14.resolve(root);
+  const candidate = path14.resolve(resolvedRoot, "." + (relPath.startsWith("/") ? relPath : "/" + relPath));
+  if (candidate !== resolvedRoot && !candidate.startsWith(resolvedRoot + path14.sep)) {
+    return null;
+  }
+  return candidate;
+}
+function hasDotSegment(urlPathname) {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(urlPathname);
+  } catch {
+    return true;
+  }
+  return decoded.split(/[/\\]/).some((segment) => segment.startsWith("."));
+}
+function resolveStaticPath(urlPathname, root) {
+  let decoded;
+  try {
+    decoded = decodeURIComponent(urlPathname);
+  } catch {
+    return null;
+  }
+  return resolveWithinRoot(decoded, root);
+}
+function imageRefKey(ref) {
+  let key = ref.split(/[?#]/)[0].replace(/^\.\//, "").replace(/^\/+/, "");
+  try {
+    key = decodeURIComponent(key);
+  } catch {}
+  return key;
+}
+
+// src/preview/file-watcher.ts
 var EMPTY_BOOK_HTML = `<!doctype html>
 <html lang="en">
 <head>
@@ -10405,12 +10467,14 @@ async function renderPreviewBook(inputPath, config, opts) {
   const { plugins, pluginStyles } = await loadPluginsWithCss(config.extensions, inputPath, (ref, err) => warn2(`Skipping plugin "${ref}" in preview — ${err.message}`));
   return renderChapters(inputPath, {
     title: config.title ?? "Document",
+    print: config.print,
     styles: config.styles,
     files: opts.files,
     plugins,
     pluginStyles,
     annotateSourceChapters: true,
     ...opts.onCssAssets ? { onCssAssets: opts.onCssAssets } : {},
+    ...opts.onImageRefs ? { onImageRefs: opts.onImageRefs } : {},
     onChapterWarnings: (file, warnings) => {
       for (const w of warnings) {
         warn2(`  ${file}, line ${w.line}: ${w.message}`);
@@ -10425,24 +10489,35 @@ function injectPreviewScripts(html) {
 `;
   return /<\/head>/i.test(html) ? html.replace(/<\/head>/i, scripts + "</head>") : html + scripts;
 }
-async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets) {
+async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, imageRefs) {
   if (!inputPath) {
     cssAssets.clear();
-    await fsp3.writeFile(path14.join(tempDir, BOOK_HTML_FILENAME), EMPTY_BOOK_HTML, "utf-8");
+    imageRefs?.clear();
+    await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), EMPTY_BOOK_HTML, "utf-8");
     return;
   }
   const nextAssets = new Map;
+  const nextImageRefs = new Set;
   const html = await renderPreviewBook(inputPath, config, {
     files: config.source?.files ?? null,
     onCssAssets: (copies) => {
       for (const copy of copies)
         nextAssets.set(copy.to, copy.from);
+    },
+    onImageRefs: (refs) => {
+      for (const ref of refs)
+        nextImageRefs.add(imageRefKey(ref));
     }
   });
   cssAssets.clear();
   for (const [to, from] of nextAssets)
     cssAssets.set(to, from);
-  await fsp3.writeFile(path14.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html), "utf-8");
+  if (imageRefs) {
+    imageRefs.clear();
+    for (const ref of nextImageRefs)
+      imageRefs.add(ref);
+  }
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");
@@ -10479,23 +10554,23 @@ function isIgnoredWatchPath(candidatePath, projectRoot) {
   return isDotPathUnderRoot(candidatePath, projectRoot) || isGeneratedProjectPath(relative2);
 }
 function isExternalWatchCandidate(candidatePath, targets) {
-  const candidate = path14.resolve(candidatePath);
+  const candidate = path15.resolve(candidatePath);
   for (const rawTarget of targets) {
-    const target = path14.resolve(rawTarget);
-    const rel = path14.relative(candidate, target);
-    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path14.sep}`) && !path14.isAbsolute(rel))
+    const target = path15.resolve(rawTarget);
+    const rel = path15.relative(candidate, target);
+    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path15.sep}`) && !path15.isAbsolute(rel))
       return true;
   }
   return false;
 }
 async function nearestExistingDirectory(start) {
-  let current = path14.resolve(start);
+  let current = path15.resolve(start);
   while (true) {
     try {
       if ((await fsp3.stat(current)).isDirectory())
         return current;
     } catch {}
-    const parent = path14.dirname(current);
+    const parent = path15.dirname(current);
     if (parent === current)
       return current;
     current = parent;
@@ -10504,7 +10579,7 @@ async function nearestExistingDirectory(start) {
 async function externalWatchRoots(targets) {
   const roots = new Set;
   for (const target of targets) {
-    roots.add(await nearestExistingDirectory(path14.dirname(path14.resolve(target))));
+    roots.add(await nearestExistingDirectory(path15.dirname(path15.resolve(target))));
   }
   return [...roots];
 }
@@ -10518,19 +10593,19 @@ async function extensionFolderFiles(dir) {
   const meta = await readExtensionMeta(dir);
   const entry = extensionEntry(meta);
   return [
-    path14.join(dir, EXTENSION_MANIFEST_FILENAME),
-    ...entry ? [path14.resolve(dir, entry)] : [],
+    path15.join(dir, EXTENSION_MANIFEST_FILENAME),
+    ...entry ? [path15.resolve(dir, entry)] : [],
     ...await collectStyleDependencies(dir, extensionStyleList(meta))
   ];
 }
 async function externalWatchTargets(projectDir, config) {
-  const root = path14.resolve(projectDir);
+  const root = path15.resolve(projectDir);
   let canonicalRoot = root;
   try {
     canonicalRoot = await fsp3.realpath(root);
   } catch {}
   const styles = await resolveActiveStyles(root, config.styles);
-  const extensionPaths = (config.extensions ?? []).map((p) => p.path).filter((p) => !!p).map((p) => path14.resolve(root, p));
+  const extensionPaths = (config.extensions ?? []).map((p) => p.path).filter((p) => !!p).map((p) => path15.resolve(root, p));
   const candidates = [
     ...await collectStyleDependencies(root, styles),
     ...extensionPaths,
@@ -10538,17 +10613,17 @@ async function externalWatchTargets(projectDir, config) {
   ];
   const external = new Set;
   for (const abs of candidates) {
-    const authoredPath = path14.resolve(abs);
-    const authoredRel = path14.relative(root, authoredPath);
-    if (authoredRel !== "" && (authoredRel === ".." || authoredRel.startsWith(`..${path14.sep}`) || path14.isAbsolute(authoredRel))) {
+    const authoredPath = path15.resolve(abs);
+    const authoredRel = path15.relative(root, authoredPath);
+    if (authoredRel !== "" && (authoredRel === ".." || authoredRel.startsWith(`..${path15.sep}`) || path15.isAbsolute(authoredRel))) {
       external.add(authoredPath);
     }
     let canonicalPath = authoredPath;
     try {
       canonicalPath = await fsp3.realpath(canonicalPath);
     } catch {}
-    const rel = path14.relative(canonicalRoot, canonicalPath);
-    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path14.sep}`) && !path14.isAbsolute(rel))
+    const rel = path15.relative(canonicalRoot, canonicalPath);
+    if (rel === "" || rel !== ".." && !rel.startsWith(`..${path15.sep}`) && !path15.isAbsolute(rel))
       continue;
     external.add(canonicalPath);
   }
@@ -10575,7 +10650,7 @@ async function addAndAwaitWatch(watcher, roots) {
   }
 }
 function createFileWatcher(state) {
-  const inputResolved = path14.resolve(state.currentInputPath);
+  const inputResolved = path15.resolve(state.currentInputPath);
   const watcher = watch(inputResolved, {
     persistent: true,
     ignoreInitial: true,
@@ -10615,7 +10690,7 @@ function createFileWatcher(state) {
   async function recordChange(event, filePath) {
     if (closed)
       return;
-    const target = path14.resolve(filePath);
+    const target = path15.resolve(filePath);
     const settled = settledWrites.get(target);
     if (settled && event !== "unlink" && Date.now() <= settled.expiresAt) {
       const diskContent = await fsp3.readFile(target, "utf8").catch(() => null);
@@ -10636,7 +10711,7 @@ function createFileWatcher(state) {
     recordChange(event, filePath);
   });
   externalWatcher.on("all", (event, filePath) => {
-    const target = path14.resolve(filePath);
+    const target = path15.resolve(filePath);
     if (!desiredExternals.has(target))
       return;
     if (event === "add" && suppressInitialExternalAdds.delete(target))
@@ -10644,8 +10719,8 @@ function createFileWatcher(state) {
     recordChange(event, target);
   });
   function isWatchedSource(target) {
-    const rel = path14.relative(inputResolved, target);
-    const inProject = rel === "" || rel !== ".." && !rel.startsWith(`..${path14.sep}`) && !path14.isAbsolute(rel);
+    const rel = path15.relative(inputResolved, target);
+    const inProject = rel === "" || rel !== ".." && !rel.startsWith(`..${path15.sep}`) && !path15.isAbsolute(rel);
     if (inProject)
       return !isIgnoredWatchPath(target, inputResolved);
     return desiredExternals.has(target);
@@ -10670,7 +10745,7 @@ function createFileWatcher(state) {
   state.notifySettledWrite = (filePath, writtenContent) => {
     if (closed)
       return;
-    const target = path14.resolve(filePath);
+    const target = path15.resolve(filePath);
     if (isWatchedSource(target)) {
       acceptSettledWrite(target, writtenContent);
       return;
@@ -10691,7 +10766,7 @@ function createFileWatcher(state) {
       return;
     let nextTargets;
     try {
-      nextTargets = new Set((await externalWatchTargets(inputResolved, state.config)).map((target) => path14.resolve(target)));
+      nextTargets = new Set((await externalWatchTargets(inputResolved, state.config)).map((target) => path15.resolve(target)));
     } catch (err) {
       debug(`Could not resolve external watch targets: ${err}`);
       return;
@@ -10755,7 +10830,7 @@ function createFileWatcher(state) {
       await syncExternalWatches();
       if (closed)
         return;
-      await generateAndWriteHtml(inputResolved, state.tempDir, updatedConfig, state.cssAssets);
+      await generateAndWriteHtml(inputResolved, state.tempDir, updatedConfig, state.cssAssets, state.imageRefs);
       if (closed)
         return;
       state.previewServer?.broadcastReload();
@@ -10817,7 +10892,7 @@ async function stopFileWatcher(state) {
 }
 
 // src/preview/lifecycle.ts
-var TEMP_DIR_BASE = path15.join(tmpdir(), "gutterpress-preview");
+var TEMP_DIR_BASE = path16.join(tmpdir(), "gutterpress-preview");
 var PID_FILE_NAME = ".gutterpress.pid";
 function isProcessAlive(pid) {
   if (!Number.isFinite(pid) || pid <= 0)
@@ -10837,8 +10912,8 @@ async function cleanupOrphanTempDirs() {
     return;
   }
   for (const entry of entries) {
-    const dir = path15.join(TEMP_DIR_BASE, entry);
-    const pidFile = path15.join(dir, PID_FILE_NAME);
+    const dir = path16.join(TEMP_DIR_BASE, entry);
+    const pidFile = path16.join(dir, PID_FILE_NAME);
     try {
       const raw = await readFile25(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
@@ -10852,10 +10927,10 @@ async function cleanupOrphanTempDirs() {
 async function initializePreviewDirectories() {
   await cleanupOrphanTempDirs();
   const tempDirSuffix = randomBytes2(8).toString("hex");
-  const tempDir = path15.join(TEMP_DIR_BASE, tempDirSuffix);
+  const tempDir = path16.join(TEMP_DIR_BASE, tempDirSuffix);
   await mkdir6(tempDir);
   debug(`Created temporary directory: ${tempDir}`);
-  await writeFile6(path15.join(tempDir, PID_FILE_NAME), `${process.pid}
+  await writeFile6(path16.join(tempDir, PID_FILE_NAME), `${process.pid}
 `, "utf8");
   return tempDir;
 }
@@ -10878,7 +10953,7 @@ async function restartPreview(newInputPath, state) {
   state.currentInputPath = newInputPath;
   const manifest = await loadManifest(newInputPath);
   state.config = resolveConfig({}, manifest);
-  await generateAndWriteHtml(newInputPath, state.tempDir, state.config, state.cssAssets);
+  await generateAndWriteHtml(newInputPath, state.tempDir, state.config, state.cssAssets, state.imageRefs);
   startFileWatcher(state);
   state.previewServer?.broadcastReload();
   info("Preview restarted successfully");
@@ -10938,7 +11013,8 @@ function createServerState(inputPath, tempDir, config, options) {
     tempDir,
     config,
     options,
-    cssAssets: new Map
+    cssAssets: new Map,
+    imageRefs: new Set
   };
 }
 
@@ -10978,55 +11054,6 @@ function openPath(filePath) {
   });
 }
 
-// src/lib/static-serve.ts
-import path16 from "node:path";
-var STATIC_MIME = {
-  ".html": "text/html; charset=utf-8",
-  ".htm": "text/html; charset=utf-8",
-  ".css": "text/css",
-  ".js": "application/javascript",
-  ".mjs": "application/javascript",
-  ".json": "application/json",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".webp": "image/webp",
-  ".avif": "image/avif",
-  ".ico": "image/x-icon",
-  ".woff": "font/woff",
-  ".woff2": "font/woff2",
-  ".ttf": "font/ttf",
-  ".otf": "font/otf"
-};
-function resolveWithinRoot(relPath, root) {
-  const resolvedRoot = path16.resolve(root);
-  const candidate = path16.resolve(resolvedRoot, "." + (relPath.startsWith("/") ? relPath : "/" + relPath));
-  if (candidate !== resolvedRoot && !candidate.startsWith(resolvedRoot + path16.sep)) {
-    return null;
-  }
-  return candidate;
-}
-function hasDotSegment(urlPathname) {
-  let decoded;
-  try {
-    decoded = decodeURIComponent(urlPathname);
-  } catch {
-    return true;
-  }
-  return decoded.split(/[/\\]/).some((segment) => segment.startsWith("."));
-}
-function resolveStaticPath(urlPathname, root) {
-  let decoded;
-  try {
-    decoded = decodeURIComponent(urlPathname);
-  } catch {
-    return null;
-  }
-  return resolveWithinRoot(decoded, root);
-}
-
 // src/preview/http-server.ts
 var HMR_PATH = "/__gutterpress-hmr";
 function shellHtml(initialRevision, instanceId) {
@@ -11166,6 +11193,22 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   }
   await serveStatic(absPath, res, PROJECT_ASSET_CACHE_CONTROL, { ETag: validator.etag });
 }
+var missingImagePng;
+async function isMissingReferencedImage(pathname, absPath, refs) {
+  if (!refs.has(imageRefKey(pathname)))
+    return false;
+  try {
+    await stat5(absPath);
+    return false;
+  } catch (err) {
+    return err?.code === "ENOENT";
+  }
+}
+function serveMissingImage(res) {
+  missingImagePng ??= Buffer.from(placeholderPng());
+  res.writeHead(200, { "Content-Type": "image/png", "Cache-Control": "no-store" });
+  res.end(missingImagePng);
+}
 function matchesEmbedded(urlPathname) {
   if (EMBEDDED_EXACT.has(urlPathname))
     return true;
@@ -11317,6 +11360,10 @@ async function createPreviewServer(state, port) {
       res.end("Not Found");
       return;
     }
+    if (servingProjectRoot && await isMissingReferencedImage(pathname, absPath, state.imageRefs)) {
+      serveMissingImage(res);
+      return;
+    }
     const serve = servingProjectRoot ? serveRevalidatedStatic(req, absPath, res, projectAssetValidators) : serveStatic(absPath, res);
     await serve.catch((err) => {
       if (!res.headersSent) {
@@ -11392,7 +11439,7 @@ async function startPreviewServer(options) {
   const config = await initializeConfiguration(inputPath);
   const tempDir = await initializePreviewDirectories();
   const state = createServerState(inputPath, tempDir, config, options);
-  await generateAndWriteHtml(inputPath, tempDir, config, state.cssAssets);
+  await generateAndWriteHtml(inputPath, tempDir, config, state.cssAssets, state.imageRefs);
   const restartPreview2 = async (newInputPath) => {
     await restartPreview(newInputPath, state);
   };

package/dist/{index-ee7wp8q3.js → index-eyaj6nkc.js}

@@ -29,7 +29,7 @@ var favicon_default = "./favicon-wkbm9cjn.ico";
 var manifest_schema_default = "./manifest.schema-40sfq49z.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-5wnzrvhf.js";
+var preview_interface_default = "./preview-interface-c44qk17f.js";
 
 // src/assets/preview/scripts/preview-bridge.js
 var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
@@ -41,7 +41,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-swz6bwfa.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-zkv2stfy.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/index.js

@@ -148,13 +148,13 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-40achhs8.js";
+} from "./index-c275p061.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-qep93v0z.js";
+} from "./index-5dcj1vts.js";
 import {
   BuildError
-} from "./index-ee7wp8q3.js";
+} from "./index-eyaj6nkc.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/markdown/assemble.d.ts

@@ -116,6 +116,16 @@ export interface AssembleBookHtmlOptions {
      */
     preloadImages?: string[];
     title?: string;
+    /**
+     * The manifest's `print` padding, written on `<html>` as
+     * `data-gp-signature` / `data-gp-reserve-last-page` so the viewer shows the
+     * blank pages the PDF build appends (`signaturePadding` in
+     * engine/shared/synthesis.ts) and the two page counts agree.
+     */
+    print?: {
+        signature?: number;
+        reserveLastPage?: boolean;
+    };
     plugins?: LoadedPlugin[];
     pluginCss?: string;
     /** Add a layout-neutral source-file id to source-mapped preview blocks. */

package/dist/lib/markdown/index.d.ts

@@ -30,6 +30,11 @@ export declare function resolveActiveMarkdownFiles(inputDir: string, configuredF
  */
 export declare function renderChapters(inputDir: string, opts?: {
     title?: string;
+    /** See {@link AssembleBookHtmlOptions.print}. */
+    print?: {
+        signature?: number;
+        reserveLastPage?: boolean;
+    };
     styles?: string[];
     files?: string[] | null;
     plugins?: LoadedPlugin[];
@@ -67,6 +72,11 @@ export declare function renderChapters(inputDir: string, opts?: {
  */
 export declare function renderChaptersToFile(inputDir: string, outDir: string, opts?: {
     title?: string;
+    /** See {@link AssembleBookHtmlOptions.print}. */
+    print?: {
+        signature?: number;
+        reserveLastPage?: boolean;
+    };
     styles?: string[];
     files?: string[] | null;
     plugins?: LoadedPlugin[];

package/dist/lib/static-serve.d.ts

@@ -85,3 +85,9 @@ export declare function resolveStaticPath(urlPathname: string, root: string): st
  * this helper.
  */
 export declare function serveFile(filePath: string, res: http.ServerResponse): Promise<void>;
+/**
+ * The URL path (no leading slash, decoded, no `./`) an image reference is
+ * served at from book.html — the key `ServerState.imageRefs` is looked
+ * up by. A query or fragment is dropped, as the server's own path is.
+ */
+export declare function imageRefKey(ref: string): string;

package/dist/{new-wsjsrm7w.js → new-m5y2wepr.js}

@@ -7,16 +7,16 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-ev175hx9.js";
+} from "./cli-6z5zthzt.js";
 import {
   resolveGhostscript
-} from "./cli-0prrt9e4.js";
+} from "./cli-70xgehq2.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-182j48xc.js";
-import"./cli-wqy8hnnh.js";
+} from "./cli-ppc0vz4b.js";
+import"./cli-gymfg04q.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preflight-0fjjnk9e.js → preflight-bwpqwwny.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-ev175hx9.js";
+} from "./cli-6z5zthzt.js";
 import {
   log
-} from "./cli-0prrt9e4.js";
+} from "./cli-70xgehq2.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-182j48xc.js";
-import"./cli-wqy8hnnh.js";
+} from "./cli-ppc0vz4b.js";
+import"./cli-gymfg04q.js";
 import {
   BuildError,
   EXIT_CODES

package/dist/preview/file-watcher.d.ts

@@ -43,7 +43,11 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
         files?: string[] | null;
     };
     extensions?: ResolvedExtensionConfig[];
-}, cssAssets: Map<string, string>): Promise<void>;
+    print?: {
+        signature?: number;
+        reserveLastPage?: boolean;
+    };
+}, cssAssets: Map<string, string>, imageRefs?: Set<string>): Promise<void>;
 /**
  * Chokidar 5's `ignored` matcher (regex or function) is tested against the
  * fully-qualified, forward-slash-normalized ABSOLUTE path — never a path

package/dist/preview/server-context.d.ts

@@ -53,6 +53,16 @@ export interface ServerState {
      * surface.
      */
     cssAssets: Map<string, string>;
+    /**
+     * Every image the current render references (`onImageRefs`, the same list
+     * the build plans its asset copies from), normalized to the URL path the
+     * preview serves it at. A request for one whose file does not exist gets
+     * the build's magenta placeholder (`placeholderPng`) instead of a 404, so
+     * the preview lays out the same 640×480 box the PDF does rather than a
+     * small broken-image icon — that difference moved every later page by one
+     * in a real book (#354). Rebuilt on every render; exact-match lookups only.
+     */
+    imageRefs: Set<string>;
 }
 /**
  * Create initial server state

package/dist/{preview-azy06gw0.js → preview-62y7qhkp.js}

@@ -7,10 +7,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-ev175hx9.js";
+} from "./cli-6z5zthzt.js";
 import {
   log
-} from "./cli-0prrt9e4.js";
+} from "./cli-70xgehq2.js";
 import {
   UsageError,
   parseFormat,
@@ -18,8 +18,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-182j48xc.js";
-import"./cli-wqy8hnnh.js";
+} from "./cli-ppc0vz4b.js";
+import"./cli-gymfg04q.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";