gutterpress 0.11.16-alpha.6 → 0.11.17-alpha.1

package/dist/api/index.js

@@ -131,10 +131,10 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-ss8dv3zf.js";
+} from "../index-r9t4acx5.js";
 import {
   BuildError
-} from "../index-ee7wp8q3.js";
+} from "../index-dmm31ys3.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/{build-bk0rw638.js → build-jfjzam95.js}

@@ -1,18 +1,18 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-ac7zs8sp.js";
+} from "./cli-ew3gc4nt.js";
 import {
   log
-} from "./cli-n9e1mzb7.js";
+} from "./cli-0754wskb.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-nzzsyw1e.js";
-import"./cli-wqy8hnnh.js";
+} from "./cli-zce1zcqc.js";
+import"./cli-xx5bryh6.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-n9e1mzb7.js → cli-0754wskb.js}

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

package/dist/{cli-ac7zs8sp.js → cli-ew3gc4nt.js}

@@ -13,17 +13,17 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-n9e1mzb7.js";
+} from "./cli-0754wskb.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-nzzsyw1e.js";
+} from "./cli-zce1zcqc.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./cli-wqy8hnnh.js";
+} from "./cli-xx5bryh6.js";
 import {
   BuildError,
   EXIT_CODES
@@ -1181,16 +1181,23 @@ function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   }
   return { name, baseKind: name, ...resolveContainerShape(name, pluginName, rawDecl) };
 }
+var CORE_MARKER_OWNER = "Gutterpress";
+var CORE_DECLARED_MARKERS = {
+  columns: {
+    class: "gp-columns",
+    variants: { 1: "gp-columns-1", 2: "gp-columns-2", 3: "gp-columns-3", 4: "gp-columns-4", 5: "gp-columns-5" }
+  }
+};
 function buildDeclaredMarkerRegistry(sources) {
   const rawRegistry = new Map;
   const originOf = new Map;
-  for (const { pluginName, markers } of sources) {
+  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 (KNOWN_KINDS.includes(name)) {
-        throw new Error(`Plugin "${pluginName}" declares marker "@${name}", which is a core Gutterpress marker name ` + `(${KNOWN_KINDS.map((k) => `@${k}`).join(", ")}). Core marker names cannot be shadowed — ` + `rename the plugin's marker.`);
+      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.`);
       }
       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.`);
@@ -1273,7 +1280,7 @@ function plugin(md, pluginOptions = {}) {
     preferPagesInSpreads: false,
     ...pluginOptions
   };
-  const declaredMarkers = options.declaredMarkers instanceof Map && options.declaredMarkers.size > 0 ? options.declaredMarkers : null;
+  const declaredMarkers = options.declaredMarkers instanceof Map && options.declaredMarkers.size > 0 ? options.declaredMarkers : buildDeclaredMarkerRegistry([]);
   const declaredWords = declaredKindWords(declaredMarkers);
   function markerBlock(state, startLine, endLine, silent) {
     const pos = state.bMarks[startLine] + state.tShift[startLine];
@@ -1832,9 +1839,19 @@ var GUTTERPRESS_CSS = `
    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-2 { columns: 2; column-gap: var(--gp-column-gap, 1.5em); }
-.gp-columns-3 { columns: 3; column-gap: var(--gp-column-gap, 1.5em); }
+   --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 {
+  column-gap: var(--gp-column-gap, 1.5em);
+}
+.gp-columns { columns: 2; }
+.gp-columns-1 { columns: 1; }
+.gp-columns-2 { columns: 2; }
+.gp-columns-3 { columns: 3; }
+.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
@@ -2035,8 +2052,12 @@ var GP_CLASSES = new Set([
   "gp-large",
   "gp-tight",
   "gp-loose",
+  "gp-columns",
+  "gp-columns-1",
   "gp-columns-2",
   "gp-columns-3",
+  "gp-columns-4",
+  "gp-columns-5",
   "gp-columns-all",
   "gp-columns-flow",
   "gp-columns-balanced",
@@ -8312,8 +8333,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">
@@ -8375,6 +8397,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,
@@ -8386,6 +8409,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
   await mkdir4(outDir, { recursive: true });
   const html = await renderChapters(inputDir, {
     title: opts.title,
+    print: opts.print,
     styles: opts.styles,
     files: opts.files,
     plugins: opts.plugins,
@@ -9506,6 +9530,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,
@@ -9657,7 +9682,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-j5h953pg.js");
+      const { buildNativePdf } = await import("./engine-rhmwgk9k.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -9788,7 +9813,7 @@ function openPath(filePath) {
 }
 
 // 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 readdir4, readFile as readFile24, writeFile as writeFile5 } from "node:fs/promises";
@@ -9813,7 +9838,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>
@@ -9834,12 +9917,14 @@ async function renderPreviewBook(inputPath, config, opts) {
   const { plugins, pluginStyles } = await loadPluginsWithCss(config.extensions, inputPath, (ref, err) => warn(`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) {
         warn(`  ${file}, line ${w.line}: ${w.message}`);
@@ -9854,24 +9939,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(/\/+$/, "");
@@ -9908,23 +10004,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;
@@ -9933,7 +10029,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];
 }
@@ -9947,19 +10043,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,
@@ -9967,17 +10063,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);
   }
@@ -10004,7 +10100,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,
@@ -10044,7 +10140,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);
@@ -10065,7 +10161,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))
@@ -10073,8 +10169,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);
@@ -10099,7 +10195,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;
@@ -10120,7 +10216,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;
@@ -10184,7 +10280,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();
@@ -10246,7 +10342,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)
@@ -10266,8 +10362,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 readFile24(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
@@ -10281,10 +10377,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 writeFile5(path15.join(tempDir, PID_FILE_NAME), `${process.pid}
+  await writeFile5(path16.join(tempDir, PID_FILE_NAME), `${process.pid}
 `, "utf8");
   return tempDir;
 }
@@ -10307,7 +10403,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");
@@ -10367,7 +10463,8 @@ function createServerState(inputPath, tempDir, config, options) {
     tempDir,
     config,
     options,
-    cssAssets: new Map
+    cssAssets: new Map,
+    imageRefs: new Set
   };
 }
 
@@ -10378,57 +10475,6 @@ import { createHash as createHash5, randomUUID as randomUUID3 } from "node:crypt
 import { readFile as readFile25, stat as stat5 } from "node:fs/promises";
 import path17 from "path";
 import { WebSocket, WebSocketServer } from "ws";
-
-// 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) {
   return `<!doctype html>
@@ -10567,6 +10613,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;
@@ -10718,6 +10780,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) {
@@ -10793,7 +10859,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/{cli-wqy8hnnh.js → cli-xx5bryh6.js}

@@ -681,6 +681,11 @@ function planRectoBlanks(sites) {
     return wrong;
   });
 }
+function signaturePadding(pageCount, signature = 1, reserveLastPage = false) {
+  const size = signature > 1 ? signature : 1;
+  const padded = (size - pageCount % size) % size;
+  return padded === 0 && reserveLastPage ? size : padded;
+}
 var WHICH_VALUES = new Set(["first", "start", "last", "first-except"]);
 function parseWhich(raw) {
   const w = (raw ?? "").trim();
@@ -1121,7 +1126,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-5a6h4evk.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
@@ -1450,10 +1455,7 @@ async function postprocess(input, opts) {
     g.media.width - inset,
     g.media.height - inset
   ];
-  const signature = opts.signature && opts.signature > 1 ? opts.signature : 1;
-  let padded = (signature - doc.getPageCount() % signature) % signature;
-  if (padded === 0 && opts.reserveLastPage)
-    padded = signature;
+  const padded = signaturePadding(doc.getPageCount(), opts.signature, opts.reserveLastPage);
   for (let i = 0;i < padded; i++)
     doc.addPage([g.media.width, g.media.height]);
   const wantMarks = opts.marks || g.marks.includes("crop") || g.marks.includes("cross");

package/dist/{cli-nzzsyw1e.js → cli-zce1zcqc.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.16-alpha.6",
+  version: "0.11.17-alpha.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",