gutterpress 0.11.18-alpha.9 → 0.11.19-alpha.1

package/dist/{cli-7t8r97zk.js → cli-mkn97gxp.js}

@@ -5,6 +5,7 @@ import {
   debug,
   defaultConfigDir,
   error,
+  findPostScriptShadingPages,
   hasLiveTransparency,
   info,
   log,
@@ -13,12 +14,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-t1m7mpdz.js";
+} from "./cli-5j0a5hmc.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-5xt70xgy.js";
+} from "./cli-n3nd3sav.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -27,7 +28,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-ptez7zcc.js";
+} from "./cli-xx94a1k6.js";
 import {
   BuildError,
   EXIT_CODES
@@ -39,7 +40,7 @@ import {
   requireChromiumExecutable,
   resolveChromiumExecutable,
   spawnCapture
-} from "./cli-7fkhgtfn.js";
+} from "./cli-asap4t1z.js";
 import {
   PLUGINS_DIR,
   VENDORED_NPM_DIR,
@@ -4760,124 +4761,6 @@ async function addBuiltInStyleSet(projectDir, id) {
   });
 }
 
-// src/lib/extension-restore.ts
-import path6 from "node:path";
-var OFFLINE_REASON = "you appear to be offline (npm can't be reached)";
-function pinnedEntries(manifest) {
-  const found = new Map;
-  for (const entry of Array.isArray(manifest.extensions) ? manifest.extensions : []) {
-    const object3 = typeof entry === "object" && entry !== null ? entry : null;
-    const use = typeof entry === "string" ? entry : object3?.use;
-    if (typeof use !== "string" || object3?.enabled === false)
-      continue;
-    let parsed;
-    try {
-      parsed = parseExtensionSpecifier(use);
-    } catch {
-      continue;
-    }
-    if (parsed.kind !== "npm" || !parsed.version || !isExactNpmVersion(parsed.version))
-      continue;
-    const spec = `${parsed.name}@${parsed.version}`;
-    if (found.has(spec))
-      continue;
-    found.set(spec, {
-      name: parsed.name,
-      version: parsed.version,
-      ...typeof object3?.export === "string" && object3.export ? { export: object3.export } : {}
-    });
-  }
-  return [...found.values()];
-}
-async function restoreAll(projectDir, manifestFile, pins, options) {
-  const result = { manifestFile, installed: [], failed: [], warnings: [], offline: false };
-  const missing = [];
-  for (const pin of pins)
-    if (await vendoredCopyNeedsInstall(projectDir, pin.name, pin.version))
-      missing.push(pin);
-  if (missing.length === 0)
-    return result;
-  const report = options.onProgress ?? (() => {});
-  const specs = missing.map((pin) => `${pin.name}@${pin.version}`);
-  report({ type: "start", specs });
-  for (const [index, pin] of missing.entries()) {
-    const spec = specs[index];
-    const step = { type: "package", spec, index, total: missing.length };
-    if (result.offline) {
-      result.failed.push({ use: spec, message: OFFLINE_REASON });
-      report({ ...step, state: "failed", message: OFFLINE_REASON });
-      continue;
-    }
-    report({ ...step, state: "downloading" });
-    try {
-      result.warnings.push(...await restoreNpmExtension(projectDir, pin.name, pin.version, pin.export, {
-        ...options,
-        keepVersions: pins.filter((other) => other.name === pin.name).map((other) => other.version)
-      }));
-      result.installed.push(spec);
-      report({ ...step, state: "done" });
-    } catch (error2) {
-      if (error2 instanceof FetchUnavailableError)
-        result.offline = true;
-      const message = result.offline ? OFFLINE_REASON : error2 instanceof Error ? error2.message : String(error2);
-      result.failed.push({ use: spec, message });
-      report({ ...step, state: "failed", message });
-    }
-  }
-  report({ type: "end", installed: result.installed, failed: result.failed });
-  return result;
-}
-var inFlight = new Map;
-async function restorePinnedExtensions(projectDir, options = {}) {
-  let loaded;
-  try {
-    loaded = await loadManifestWithPath(options.manifestPath ?? projectDir);
-  } catch {
-    return { manifestFile: null, installed: [], failed: [], warnings: [], offline: false };
-  }
-  const { manifest, manifestDir, manifestPath } = loaded;
-  const pins = pinnedEntries(manifest);
-  if (manifestPath === null || pins.length === 0) {
-    return { manifestFile: manifestPath && path6.basename(manifestPath), installed: [], failed: [], warnings: [], offline: false };
-  }
-  const key = projectKey(manifestDir);
-  const running = inFlight.get(key);
-  if (running)
-    return running;
-  const run = restoreAll(manifestDir, path6.basename(manifestPath), pins, options).finally(() => {
-    inFlight.delete(key);
-  });
-  inFlight.set(key, run);
-  return run;
-}
-function restoreFailureMessage(failure, manifestFile) {
-  return `Could not download ${failure.use} (pinned in ${manifestFile ?? "the manifest"}): ${failure.message.replace(/[.\s]+$/, "")}. ` + `Check your internet connection and try again, or install it yourself with \`gutterpress ext add ${failure.use}\`.`;
-}
-function restoreOfflineMessage(failed, manifestFile) {
-  const list = failed.map((f) => f.use).join(", ");
-  return `You appear to be offline, and this book's extensions are not installed yet: ${list} ` + `(pinned in ${manifestFile ?? "the manifest"}). Connect to the internet and try again to install them; ` + `once installed, they work offline.`;
-}
-async function restoreForCommand(dir, options) {
-  const result = await restorePinnedExtensions(dir, { manifestPath: options.manifestPath });
-  const file = result.manifestFile ?? "the manifest";
-  for (const spec of result.installed)
-    console.error(`Downloaded ${spec} (pinned in ${file})`);
-  for (const warning of result.warnings)
-    log.warn(warning);
-  const offline = result.failed.filter((f) => result.offline && f.message === OFFLINE_REASON);
-  const problems = [
-    ...result.failed.filter((f) => !offline.includes(f)).map((f) => restoreFailureMessage(f, result.manifestFile)),
-    ...offline.length > 0 ? [restoreOfflineMessage(offline, result.manifestFile)] : []
-  ];
-  if (problems.length === 0)
-    return;
-  if (options.failFast)
-    throw new BuildError(problems.join(`
-`), EXIT_CODES.PIPELINE);
-  for (const problem of problems)
-    log.warn(problem);
-}
-
 // src/checks/registry.ts
 var checks = new Map;
 function registerCheck(check) {
@@ -5021,17 +4904,17 @@ function evictLru() {
       destroyEntryAfterGrace(evicted);
   }
 }
-async function loadPdf(path7) {
+async function loadPdf(path6) {
   let st;
   try {
-    st = await stat2(path7);
+    st = await stat2(path6);
   } catch {
     return null;
   }
-  const hit = docCache.get(path7);
+  const hit = docCache.get(path6);
   if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) {
-    docCache.delete(path7);
-    docCache.set(path7, hit);
+    docCache.delete(path6);
+    docCache.set(path6, hit);
     try {
       return await hit.doc;
     } catch {
@@ -5040,15 +4923,15 @@ async function loadPdf(path7) {
   }
   if (hit)
     destroyEntry(hit);
-  const docPromise = readFile7(path7).then((buf) => getDocumentProxy(new Uint8Array(buf)));
-  docCache.delete(path7);
-  docCache.set(path7, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
+  const docPromise = readFile7(path6).then((buf) => getDocumentProxy(new Uint8Array(buf)));
+  docCache.delete(path6);
+  docCache.set(path6, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
   evictLru();
   try {
     return await docPromise;
   } catch {
-    if (docCache.get(path7)?.doc === docPromise)
-      docCache.delete(path7);
+    if (docCache.get(path6)?.doc === docPromise)
+      docCache.delete(path6);
     return null;
   }
 }
@@ -6407,6 +6290,9 @@ function isDroppedPageGradient(decl) {
     return false;
   return isInPageBox(decl);
 }
+function isPostScriptShadingGradient(decl) {
+  return /(repeating-(linear|radial|conic)|conic)-gradient\(/i.test(decl.value);
+}
 function isInPageMarginBox(decl) {
   const box = decl.parent;
   if (!box || box.type !== "atrule")
@@ -6655,6 +6541,13 @@ function checkCssRaw(css, from) {
         message: `"${decl.prop}: ${decl.value}" on @page paints nothing in print — Chromium drops a gradient in the @page box's own background, with no error and a valid-looking PDF. A solid colour there paints the whole sheet; the same gradient also works on "html" (it covers the content area, not the sheet) or in a margin box.`,
         ...nodeLoc(decl)
       });
+    } else if (isPostScriptShadingGradient(decl)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `"${decl.prop}: ${decl.value}" prints blank in PDF/X exports (--format pdfx): Chromium emits repeating-*-gradient() and conic-gradient() in a form Ghostscript cannot convert. Plain PDF output is unaffected. Use linear-gradient() or radial-gradient() instead; for 0deg/90deg stripes write "linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)" with "background-size: 10px 100%", and for anything else a small tiled image.`,
+        ...nodeLoc(decl)
+      });
     } else if (isUnpairedFitContentWidth(decl)) {
       warnings.push({
         rule: ruleRiskyProps,
@@ -6749,7 +6642,7 @@ import { readFile as readFile13 } from "node:fs/promises";
 // src/lib/style-resolver.ts
 import { existsSync as existsSync8 } from "node:fs";
 import { readdir as readdir2 } from "node:fs/promises";
-import path7 from "node:path";
+import path6 from "node:path";
 var STYLES_SUBDIR = "styles";
 var FALLBACK_PRIORITY = [
   "styles/book.css",
@@ -6759,7 +6652,7 @@ var FALLBACK_PRIORITY = [
   "css/main.css"
 ];
 function relDisplay(projectDir, absPath) {
-  return path7.relative(projectDir, absPath).split(path7.sep).join("/");
+  return path6.relative(projectDir, absPath).split(path6.sep).join("/");
 }
 async function dirEntries(dir) {
   try {
@@ -6769,11 +6662,11 @@ async function dirEntries(dir) {
   }
 }
 function cssFilesFrom(dir, entries) {
-  return entries.filter((e) => e.isFile() && e.name.toLowerCase().endsWith(".css")).map((e) => path7.join(dir, e.name));
+  return entries.filter((e) => e.isFile() && e.name.toLowerCase().endsWith(".css")).map((e) => path6.join(dir, e.name));
 }
 async function discoverCssFiles(projectDir) {
-  const stylesDir = path7.join(projectDir, STYLES_SUBDIR);
-  const cssDir = path7.join(projectDir, "css");
+  const stylesDir = path6.join(projectDir, STYLES_SUBDIR);
+  const cssDir = path6.join(projectDir, "css");
   const [rootEntries, stylesEntries, cssEntries] = await Promise.all([
     dirEntries(projectDir),
     dirEntries(stylesDir),
@@ -6796,7 +6689,7 @@ async function resolveActiveStyles(projectDir, manifestStyles) {
   if (manifest.length > 0)
     return manifest;
   for (const rel of FALLBACK_PRIORITY) {
-    if (existsSync8(path7.join(projectDir, rel)))
+    if (existsSync8(path6.join(projectDir, rel)))
       return [rel];
   }
   const discovered = await discoverCssFiles(projectDir);
@@ -7011,7 +6904,7 @@ import { dirname as dirname3, resolve as resolve5 } from "node:path";
 // src/lib/asset-inline.ts
 import { createHash as createHash2 } from "node:crypto";
 import { readFile as readFile14 } from "node:fs/promises";
-import path8 from "node:path";
+import path7 from "node:path";
 import postcss3 from "postcss";
 var FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
 var HASHED_ASSET_DIR = "assets";
@@ -7052,19 +6945,19 @@ function decodeRef(ref) {
   }
 }
 function toPosix(p) {
-  return p.split(path8.sep).join("/");
+  return p.split(path7.sep).join("/");
 }
 function escapesProjectRoot(projectDir, absPath) {
-  const rel = path8.relative(projectDir, absPath);
-  return rel === ".." || rel.startsWith(`..${path8.sep}`) || path8.isAbsolute(rel);
+  const rel = path7.relative(projectDir, absPath);
+  return rel === ".." || rel.startsWith(`..${path7.sep}`) || path7.isAbsolute(rel);
 }
 function proseImageRefError(ref, projectDir) {
   const cleaned = stripUrlSuffix(decodeRef(ref));
-  if (/^file:/i.test(cleaned) || path8.isAbsolute(cleaned)) {
+  if (/^file:/i.test(cleaned) || path7.isAbsolute(cleaned)) {
     return `Image reference must be relative to the book folder: ${ref}
 ` + `  Copy the file into your book folder and reference it from there.`;
   }
-  if (escapesProjectRoot(projectDir, path8.resolve(projectDir, cleaned))) {
+  if (escapesProjectRoot(projectDir, path7.resolve(projectDir, cleaned))) {
     return `Image reference points outside the book folder: ${ref}
 ` + `  Copy the file into your book folder and reference it from there.`;
   }
@@ -7134,12 +7027,12 @@ function importTarget(atRule) {
   return target;
 }
 async function inlineOne(cssPath, copies, warnings, seen) {
-  const abs = path8.resolve(cssPath);
+  const abs = path7.resolve(cssPath);
   if (seen.has(abs))
     return "";
   seen.add(abs);
   const source = await readOrThrow(abs, "stylesheet", "the book manifest");
-  const cssDir = path8.dirname(abs);
+  const cssDir = path7.dirname(abs);
   let root;
   try {
     root = postcss3.parse(source.toString("utf-8"), { from: abs });
@@ -7161,8 +7054,8 @@ async function inlineOne(cssPath, copies, warnings, seen) {
         return null;
       }
       const relPath = stripUrlSuffix(decodeRef(raw));
-      const absAsset = path8.resolve(cssDir, relPath);
-      const ext = path8.extname(absAsset).toLowerCase();
+      const absAsset = path7.resolve(cssDir, relPath);
+      const ext = path7.extname(absAsset).toLowerCase();
       if (FONT_EXTS.has(ext)) {
         const bytes2 = await readOrThrow(absAsset, "font file", abs);
         return dataUri(bytes2, ext);
@@ -7180,7 +7073,7 @@ async function inlineOne(cssPath, copies, warnings, seen) {
       imports.push({ node, target });
   });
   for (const { node, target } of imports) {
-    const importedAbs = path8.resolve(cssDir, stripUrlSuffix(decodeRef(target)));
+    const importedAbs = path7.resolve(cssDir, stripUrlSuffix(decodeRef(target)));
     const inlined = await inlineOne(importedAbs, copies, warnings, seen);
     node.replaceWith(wrapImportConditions(node, postcss3.parse(inlined, { from: importedAbs })));
   }
@@ -7192,10 +7085,10 @@ async function inlineStyles(projectDir, stylePaths) {
   const seen = new Set;
   const parts = [];
   for (const rel of stylePaths) {
-    const abs = path8.resolve(projectDir, rel);
+    const abs = path7.resolve(projectDir, rel);
     const css = await inlineOne(abs, copies, warnings, seen);
     if (css.trim().length > 0) {
-      parts.push(`/* ${toPosix(path8.relative(projectDir, abs))} */
+      parts.push(`/* ${toPosix(path7.relative(projectDir, abs))} */
 ${css.trim()}`);
     }
   }
@@ -7211,7 +7104,7 @@ async function collectStyleDependencies(projectDir, stylePaths) {
   const found = new Set;
   const visited = new Set;
   async function walk(cssPath) {
-    const abs = path8.resolve(cssPath);
+    const abs = path7.resolve(cssPath);
     if (visited.has(abs))
       return;
     visited.add(abs);
@@ -7228,14 +7121,14 @@ async function collectStyleDependencies(projectDir, stylePaths) {
     } catch {
       return;
     }
-    const cssDir = path8.dirname(abs);
+    const cssDir = path7.dirname(abs);
     root.walkDecls((decl) => {
       if (!decl.value.includes("url("))
         return;
       for (const raw of extractCssUrls(decl.value)) {
         if (!raw || isNonFilesystemRef(raw))
           continue;
-        found.add(path8.resolve(cssDir, stripUrlSuffix(decodeRef(raw))));
+        found.add(path7.resolve(cssDir, stripUrlSuffix(decodeRef(raw))));
       }
     });
     const imports = [];
@@ -7245,11 +7138,11 @@ async function collectStyleDependencies(projectDir, stylePaths) {
         imports.push(target);
     });
     for (const target of imports) {
-      await walk(path8.resolve(cssDir, stripUrlSuffix(decodeRef(target))));
+      await walk(path7.resolve(cssDir, stripUrlSuffix(decodeRef(target))));
     }
   }
   for (const rel of stylePaths) {
-    await walk(path8.resolve(projectDir, rel));
+    await walk(path7.resolve(projectDir, rel));
   }
   return [...found];
 }
@@ -7266,8 +7159,8 @@ async function planImageCopies(projectDir, refs) {
       continue;
     }
     const cleaned = stripUrlSuffix(decodeRef(ref));
-    const abs = path8.resolve(projectDir, cleaned);
-    const rel = path8.relative(projectDir, abs);
+    const abs = path7.resolve(projectDir, cleaned);
+    const rel = path7.relative(projectDir, abs);
     const dest = toPosix(rel);
     copies.set(dest, { from: abs, to: dest });
     destinations.set(ref, dest);
@@ -7288,9 +7181,9 @@ async function inlineShapeUrls(html, baseDir) {
     if (!raw || isNonFilesystemRef(raw))
       continue;
     const cleaned = stripUrlSuffix(decodeRef(raw));
-    if (path8.isAbsolute(cleaned))
+    if (path7.isAbsolute(cleaned))
       continue;
-    const abs = path8.resolve(baseDir, cleaned);
+    const abs = path7.resolve(baseDir, cleaned);
     if (escapesProjectRoot(baseDir, abs))
       continue;
     let bytes;
@@ -7299,7 +7192,7 @@ async function inlineShapeUrls(html, baseDir) {
     } catch {
       continue;
     }
-    const mime = mimeFor(path8.extname(abs).toLowerCase());
+    const mime = mimeFor(path7.extname(abs).toLowerCase());
     const dataUri2 = `data:${mime};base64,${bytes.toString("base64")}`;
     replacements.set(m[0], `--gp-shape:url("${dataUri2}")`);
   }
@@ -7444,7 +7337,7 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
 registerCheck(check22);
 
 // src/lib/build-staging.ts
-import path9 from "node:path";
+import path8 from "node:path";
 import os from "node:os";
 import fsp from "node:fs/promises";
 
@@ -7629,8 +7522,8 @@ function placeholderPng(width = 640, height = 480, cell = 32) {
 
 // src/lib/build-staging.ts
 async function shipViewerHtml(htmlFile, outDir) {
-  await fsp.mkdir(path9.join(outDir, "engine"), { recursive: true });
-  await fsp.copyFile(await getAssetPath("engine/gutterpress-viewer.js"), path9.join(outDir, "engine/gutterpress-viewer.js"));
+  await fsp.mkdir(path8.join(outDir, "engine"), { recursive: true });
+  await fsp.copyFile(await getAssetPath("engine/gutterpress-viewer.js"), path8.join(outDir, "engine/gutterpress-viewer.js"));
   const tag = `  <script src="engine/gutterpress-viewer.js"></script>
 `;
   const html = await fsp.readFile(htmlFile, "utf-8");
@@ -7662,18 +7555,18 @@ async function stageBookAssets(options) {
   return { missing: [...missingPlaceholders.keys()].sort() };
 }
 async function copyReferencedAssets(copies, outDir) {
-  const dirs = new Set(copies.map((c) => path9.dirname(path9.resolve(outDir, c.to))));
+  const dirs = new Set(copies.map((c) => path8.dirname(path8.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 = path9.resolve(outDir, c.to);
+    const dest = path8.resolve(outDir, c.to);
     try {
       await fsp.copyFile(c.from, dest);
     } catch (err) {
       if (err?.code === "ENOENT") {
         const placeholder = placeholderOutputPath(c.to);
-        const placeholderDest = path9.resolve(outDir, placeholder);
-        await fsp.mkdir(path9.dirname(placeholderDest), { recursive: true });
+        const placeholderDest = path8.resolve(outDir, placeholder);
+        await fsp.mkdir(path8.dirname(placeholderDest), { recursive: true });
         await fsp.writeFile(placeholderDest, placeholderPng());
         missing.set(c.to, placeholder);
         return;
@@ -7703,7 +7596,7 @@ function dropRelativeLinkHrefs(html) {
   });
 }
 async function createStageRoot() {
-  return fsp.mkdtemp(path9.join(os.tmpdir(), "gutterpress-stage-"));
+  return fsp.mkdtemp(path8.join(os.tmpdir(), "gutterpress-stage-"));
 }
 
 // src/checks/source/dangling-links.ts
@@ -8015,7 +7908,7 @@ registerCheck(check26);
 
 // src/checks/source/merge-markers.ts
 import { readFile as readFile19 } from "node:fs/promises";
-import path10 from "node:path";
+import path9 from "node:path";
 
 // src/checks/asset/extensions.ts
 var RASTER_INSPECTABLE_EXTS = [
@@ -8099,7 +7992,7 @@ var check27 = {
         ignore: [...ASSET_SCAN_IGNORE_GLOBS]
       });
       for (const sibling of siblings.sort()) {
-        const rel = path10.relative(ctx.inputDir, sibling).split(path10.sep).join("/");
+        const rel = path9.relative(ctx.inputDir, sibling).split(path9.sep).join("/");
         results.push(finding(check27.id, {
           severity: "warning",
           code: "kept-both-versions",
@@ -8122,24 +8015,24 @@ import { stat as stat4 } from "node:fs/promises";
 import { stat as stat3, readFile as readFile20 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
-async function inspectImage(path11) {
+async function inspectImage(path10) {
   let st;
   try {
-    st = await stat3(path11);
+    st = await stat3(path10);
   } catch {
     return null;
   }
-  const hit = cache.get(path11);
+  const hit = cache.get(path10);
   if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size)
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile20(path11);
+    const buf = await readFile20(path10);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
   }
-  cache.set(path11, { mtimeMs: st.mtimeMs, size: st.size, info: info2 });
+  cache.set(path10, { mtimeMs: st.mtimeMs, size: st.size, info: info2 });
   return info2;
 }
 function parseImage(b) {
@@ -8880,14 +8773,14 @@ import { existsSync as existsSync11 } from "node:fs";
 import { dirname as dirname4, join as join3, resolve as resolve7 } from "node:path";
 
 // src/lib/output-paths.ts
-import path11 from "node:path";
+import path10 from "node:path";
 var DIST_DIRNAME = "dist";
 var BOOK_HTML = "book.html";
 function bookSlug(title) {
   return slugify(title ?? "", "book");
 }
 function resolveOutputDir(manifestDir, title) {
-  return path11.resolve(manifestDir, DIST_DIRNAME, bookSlug(title));
+  return path10.resolve(manifestDir, DIST_DIRNAME, bookSlug(title));
 }
 function artifactName(title, format) {
   return `${bookSlug(title)}-${format}.pdf`;
@@ -8896,6 +8789,124 @@ function artifactName(title, format) {
 // src/lib/desktop.ts
 var BOOK_HTML_FILENAME = "book.html";
 
+// src/lib/extension-restore.ts
+import path11 from "node:path";
+var OFFLINE_REASON = "you appear to be offline (npm can't be reached)";
+function pinnedEntries(manifest) {
+  const found = new Map;
+  for (const entry of Array.isArray(manifest.extensions) ? manifest.extensions : []) {
+    const object3 = typeof entry === "object" && entry !== null ? entry : null;
+    const use = typeof entry === "string" ? entry : object3?.use;
+    if (typeof use !== "string" || object3?.enabled === false)
+      continue;
+    let parsed;
+    try {
+      parsed = parseExtensionSpecifier(use);
+    } catch {
+      continue;
+    }
+    if (parsed.kind !== "npm" || !parsed.version || !isExactNpmVersion(parsed.version))
+      continue;
+    const spec = `${parsed.name}@${parsed.version}`;
+    if (found.has(spec))
+      continue;
+    found.set(spec, {
+      name: parsed.name,
+      version: parsed.version,
+      ...typeof object3?.export === "string" && object3.export ? { export: object3.export } : {}
+    });
+  }
+  return [...found.values()];
+}
+async function restoreAll(projectDir, manifestFile, pins, options) {
+  const result = { manifestFile, installed: [], failed: [], warnings: [], offline: false };
+  const missing = [];
+  for (const pin of pins)
+    if (await vendoredCopyNeedsInstall(projectDir, pin.name, pin.version))
+      missing.push(pin);
+  if (missing.length === 0)
+    return result;
+  const report = options.onProgress ?? (() => {});
+  const specs = missing.map((pin) => `${pin.name}@${pin.version}`);
+  report({ type: "start", specs });
+  for (const [index, pin] of missing.entries()) {
+    const spec = specs[index];
+    const step = { type: "package", spec, index, total: missing.length };
+    if (result.offline) {
+      result.failed.push({ use: spec, message: OFFLINE_REASON });
+      report({ ...step, state: "failed", message: OFFLINE_REASON });
+      continue;
+    }
+    report({ ...step, state: "downloading" });
+    try {
+      result.warnings.push(...await restoreNpmExtension(projectDir, pin.name, pin.version, pin.export, {
+        ...options,
+        keepVersions: pins.filter((other) => other.name === pin.name).map((other) => other.version)
+      }));
+      result.installed.push(spec);
+      report({ ...step, state: "done" });
+    } catch (error2) {
+      if (error2 instanceof FetchUnavailableError)
+        result.offline = true;
+      const message = result.offline ? OFFLINE_REASON : error2 instanceof Error ? error2.message : String(error2);
+      result.failed.push({ use: spec, message });
+      report({ ...step, state: "failed", message });
+    }
+  }
+  report({ type: "end", installed: result.installed, failed: result.failed });
+  return result;
+}
+var inFlight = new Map;
+async function restorePinnedExtensions(projectDir, options = {}) {
+  let loaded;
+  try {
+    loaded = await loadManifestWithPath(options.manifestPath ?? projectDir);
+  } catch {
+    return { manifestFile: null, installed: [], failed: [], warnings: [], offline: false };
+  }
+  const { manifest, manifestDir, manifestPath } = loaded;
+  const pins = pinnedEntries(manifest);
+  if (manifestPath === null || pins.length === 0) {
+    return { manifestFile: manifestPath && path11.basename(manifestPath), installed: [], failed: [], warnings: [], offline: false };
+  }
+  const key = projectKey(manifestDir);
+  const running = inFlight.get(key);
+  if (running)
+    return running;
+  const run = restoreAll(manifestDir, path11.basename(manifestPath), pins, options).finally(() => {
+    inFlight.delete(key);
+  });
+  inFlight.set(key, run);
+  return run;
+}
+function restoreFailureMessage(failure, manifestFile) {
+  return `Could not download ${failure.use} (pinned in ${manifestFile ?? "the manifest"}): ${failure.message.replace(/[.\s]+$/, "")}. ` + `Check your internet connection and try again, or install it yourself with \`gutterpress ext add ${failure.use}\`.`;
+}
+function restoreOfflineMessage(failed, manifestFile) {
+  const list = failed.map((f) => f.use).join(", ");
+  return `You appear to be offline, and this book's extensions are not installed yet: ${list} ` + `(pinned in ${manifestFile ?? "the manifest"}). Connect to the internet and try again to install them; ` + `once installed, they work offline.`;
+}
+async function restoreForCommand(dir, options) {
+  const result = await restorePinnedExtensions(dir, { manifestPath: options.manifestPath });
+  const file = result.manifestFile ?? "the manifest";
+  for (const spec of result.installed)
+    console.error(`Downloaded ${spec} (pinned in ${file})`);
+  for (const warning of result.warnings)
+    log.warn(warning);
+  const offline = result.failed.filter((f) => result.offline && f.message === OFFLINE_REASON);
+  const problems = [
+    ...result.failed.filter((f) => !offline.includes(f)).map((f) => restoreFailureMessage(f, result.manifestFile)),
+    ...offline.length > 0 ? [restoreOfflineMessage(offline, result.manifestFile)] : []
+  ];
+  if (problems.length === 0)
+    return;
+  if (options.failFast)
+    throw new BuildError(problems.join(`
+`), EXIT_CODES.PIPELINE);
+  for (const problem of problems)
+    log.warn(problem);
+}
+
 // src/lib/markdown/index.ts
 import { readdir as readdir3, readFile as readFile22, writeFile as writeFile2, mkdir as mkdir4 } from "node:fs/promises";
 
@@ -10082,7 +10093,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-wtnakejg.js");
+      const { buildNativePdf } = await import("./engine-fe0n7v9p.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10107,6 +10118,10 @@ class PdfOutput {
         if (await hasLiveTransparency(await fsp2.readFile(rawPdf))) {
           log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK.");
         }
+        const blankGradientPages = await findPostScriptShadingPages(await fsp2.readFile(rawPdf));
+        if (blankGradientPages.length > 0) {
+          log.warn(`Page${blankGradientPages.length === 1 ? "" : "s"} ${blankGradientPages.join(", ")}: ` + "a repeating-*-gradient() or conic-gradient() will print blank — " + "Ghostscript cannot convert it to PDF/X. Replace it with a plain linear-gradient() or radial-gradient(), or a small tiled image. For 0deg/90deg stripes, `linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)` with `background-size: 10px 100%` converts correctly.");
+        }
         const shouldStrip = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
         shouldStripAnnotations = shouldStrip;
         if (shouldStrip) {
@@ -10161,7 +10176,7 @@ async function runBuild(opts) {
   if (ctx.format !== "html") {
     await preflightBuildTools(ctx.format, opts, ctx.config);
   }
-  const launch = opts.engineBrowser ?? (async () => (await import("./cdp-smdx6mr3.js")).launchChromium());
+  const launch = opts.engineBrowser ?? (async () => (await import("./cdp-1hn3xsk2.js")).launchChromium());
   const browserPromise = ctx.format === "html" ? null : launch();
   browserPromise?.catch(() => {});
   try {
@@ -10315,6 +10330,7 @@ var EMPTY_BOOK_HTML = `<!doctype html>
 </html>
 `;
 async function renderPreviewBook(inputPath, config, opts) {
+  await restoreForCommand(inputPath, { failFast: false });
   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",
@@ -14181,4 +14197,4 @@ function normalizeProjectKey(projectDir) {
 }
 // src/lib/publish/manifest-publish.ts
 import { isMap as isMap4 } from "yaml";
-export { isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, loadManifestWithPath, BUILT_IN_STYLE_SET_IDS, listProjectExtensions, setExtensionEnabled, removeExtension, addExtension, checkExtensionUpdates, updateExtensions, addBuiltInStyleSet, restoreForCommand, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, scaffoldProject, EXTENSION_KINDS, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, importExtensionFromFile, importExtensionFromUrl, searchNpmExtensions, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listPublishProviders, publishProviderFor, resolvePublishFormat, runPublish, connectPublishProvider, disconnectPublishCredential };
+export { isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, loadManifestWithPath, BUILT_IN_STYLE_SET_IDS, listProjectExtensions, setExtensionEnabled, removeExtension, addExtension, checkExtensionUpdates, updateExtensions, addBuiltInStyleSet, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, scaffoldProject, EXTENSION_KINDS, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, importExtensionFromFile, importExtensionFromUrl, searchNpmExtensions, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listPublishProviders, publishProviderFor, resolvePublishFormat, runPublish, connectPublishProvider, disconnectPublishCredential };