npm - gutterpress - Versions diffs - 0.10.1 → 0.10.2-alpha.2 - Mend

gutterpress 0.10.1 → 0.10.2-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (44) hide show

package/dist/api/index.js +2 -2
package/dist/{audit-p4e7v2m7.js → audit-qz3np6k3.js} +4 -4
package/dist/{build-h0x2w036.js → build-41eds5kk.js} +5 -5
package/dist/{cli-eewynen9.js → cli-c2yvktan.js} +88 -7
package/dist/{cli-4n1p25df.js → cli-daahjr6z.js} +1 -1
package/dist/{cli-yzf38679.js → cli-pfpb1t3h.js} +1 -1
package/dist/{cli-bq7vkea9.js → cli-w3spkryk.js} +36 -19
package/dist/{cli-n79ghfhs.js → cli-wef7qh62.js} +1 -1
package/dist/cli.js +15 -15
package/dist/{doctor-y2w1kcqf.js → doctor-dqmz9wr7.js} +2 -2
package/dist/engine/compiler/build.d.ts +1 -1
package/dist/engine/shared/margin-box-support.d.ts +18 -1
package/dist/{engine-57vw8zpd.js → engine-36jts441.js} +1 -1
package/dist/{engine-8kdwy0jz.js → engine-qg5tdaqv.js} +2 -2
package/dist/{gutterpress-viewer-tma1qwz2.js → gutterpress-viewer-mfeccbys.js} +12 -1
package/dist/{index-j6b6cees.js → index-5vfsbjwz.js} +35 -18
package/dist/{index-p0ebr7dh.js → index-my3v298z.js} +75 -4
package/dist/{index-7hrvksrb.js → index-wbm6p5j3.js} +16 -5
package/dist/index.js +3 -3
package/dist/lib/asset-inline.d.ts +9 -7
package/dist/lib/build-runner.d.ts +6 -7
package/dist/lib/cli-args.d.ts +4 -5
package/dist/lib/engine.d.ts +3 -3
package/dist/lib/markdown/assemble.d.ts +37 -0
package/dist/lib/markdown/gutterpress-css.d.ts +5 -10
package/dist/lib/markdown/markers.d.ts +4 -6
package/dist/lib/markdown/source-range.d.ts +1 -1
package/dist/lib/static-serve.d.ts +1 -2
package/dist/{lint-7wss5p35.js → lint-67xx8zms.js} +4 -4
package/dist/{manifest.schema-zxgxnbg7.json → manifest.schema-084rxtwp.json} +3 -3
package/dist/{new-6gz60bbx.js → new-a4052xsg.js} +4 -4
package/dist/{plugin-7awkmgq0.js → plugin-n4b7b0nx.js} +4 -4
package/dist/{preflight-3tb7stqb.js → preflight-7201sv7c.js} +4 -4
package/dist/preview/server-context.d.ts +6 -6
package/dist/{preview-7a35z1v1.js → preview-ez7yfe8p.js} +5 -5
package/dist/{preview-interface-2f5v96hd.js → preview-interface-9rwz21yw.js} +2 -2
package/dist/{preview-shell-kyjq59d9.js → preview-shell-gqnc5xxe.js} +3 -5
package/dist/{publish-dpx2cebg.js → publish-thxa0cz7.js} +4 -4
package/dist/render.js +3 -1
package/dist/schema/manifest.types.d.ts +4 -5
package/dist/test-helpers/testkit.d.ts +31 -0
package/dist/types.d.ts +2 -2
package/dist/{validate-hbe05b26.js → validate-0tbsdxz2.js} +4 -4
package/package.json +1 -1

package/dist/{index-j6b6cees.js → index-5vfsbjwz.js} RENAMED Viewed

@@ -17,7 +17,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-7hrvksrb.js";
+} from "./index-wbm6p5j3.js";
 import {
   gitFs,
   gitScopeFor,
@@ -503,10 +503,10 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
     throw new UsageError(`Unknown engine "${String(requestedEngine)}". Expected: paged | native`);
   }
   if (requestedEngine === "paged") {
-    warnOnce("engine-paged-removed", "[gutterpress] Paged.js has been removed; the native engine is the " + 'only engine. "engine: paged" is ignored — building natively.');
+    warnOnce("engine-paged-removed", "[gutterpress] The native engine is the only engine. " + '"engine: paged" is ignored — building natively.');
   }
   if ((m.engineStyles?.paged?.length ?? 0) > 0) {
-    warnOnce("engine-styles-paged-removed", "[gutterpress] engineStyles.paged is ignored — Paged.js has been removed.");
+    warnOnce("engine-styles-paged-removed", "[gutterpress] engineStyles.paged is ignored — the native engine is the only engine.");
   }
   const engine = "native";
   const rawPlugins = c.plugins ?? m.plugins ?? [];
@@ -2002,12 +2002,14 @@ ${projectCss.trim()}` : null
   ].filter(Boolean).join(`
 `);
+  const preloadTags = (opts.preloadImages ?? []).map((href) => `
+  <link rel="preload" as="image" href="${href}">`).join("");
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${title}</title>
+  <title>${title}</title>${preloadTags}
   <style data-project-css>
 ${inlineCss}
 </style>
@@ -2127,7 +2129,6 @@ import { readFile as readFile2 } from "node:fs/promises";
 import path2 from "node:path";
 import postcss from "postcss";
 var FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
-var IMAGE_INLINE_MAX_BYTES = 512 * 1024;
 var HASHED_ASSET_DIR = "assets";
 var MIME_BY_EXT = {
   ".woff2": "font/woff2",
@@ -2247,7 +2248,7 @@ function importTarget(atRule) {
     return null;
   return target;
 }
-async function inlineOne(cssPath, projectDir, copies, warnings, seen) {
+async function inlineOne(cssPath, copies, warnings, seen) {
   const abs = path2.resolve(cssPath);
   if (seen.has(abs))
     return "";
@@ -2282,11 +2283,7 @@ async function inlineOne(cssPath, projectDir, copies, warnings, seen) {
         return dataUri(bytes2, ext);
       }
       const bytes = await readOrThrow(absAsset, "asset", abs);
-      if (bytes.byteLength <= IMAGE_INLINE_MAX_BYTES) {
-        return dataUri(bytes, ext);
-      }
-      const projectRel = path2.relative(projectDir, absAsset);
-      const dest = projectRel && !escapesProjectRoot(projectDir, absAsset) ? toPosix(projectRel) : `${HASHED_ASSET_DIR}/${contentHash(bytes)}${ext}`;
+      const dest = `${HASHED_ASSET_DIR}/${contentHash(bytes)}${ext}`;
       copies.set(dest, { from: absAsset, to: dest });
       return dest;
     });
@@ -2299,7 +2296,7 @@ async function inlineOne(cssPath, projectDir, copies, warnings, seen) {
   });
   for (const { node, target } of imports) {
     const importedAbs = path2.resolve(cssDir, stripUrlSuffix(decodeRef(target)));
-    const inlined = await inlineOne(importedAbs, projectDir, copies, warnings, seen);
+    const inlined = await inlineOne(importedAbs, copies, warnings, seen);
     node.replaceWith(wrapImportConditions(node, postcss.parse(inlined, { from: importedAbs })));
   }
   return root.toString();
@@ -2311,7 +2308,7 @@ async function inlineStyles(projectDir, stylePaths) {
   const parts = [];
   for (const rel of stylePaths) {
     const abs = path2.resolve(projectDir, rel);
-    const css = await inlineOne(abs, projectDir, copies, warnings, seen);
+    const css = await inlineOne(abs, copies, warnings, seen);
     if (css.trim().length > 0) {
       parts.push(`/* ${toPosix(path2.relative(projectDir, abs))} */
 ${css.trim()}`);
@@ -2451,6 +2448,7 @@ async function renderChapters(inputDir, opts = {}) {
     files,
     readText: (relPath) => readFile3(join(inputDir, canonicalChapterId(relPath)), "utf-8"),
     projectCss: inlined.css,
+    preloadImages: inlined.copies.map((c) => c.to),
     title: opts.title,
     plugins: opts.plugins,
     pluginCss: opts.pluginCss,
@@ -3980,7 +3978,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.1",
+  version: "0.10.2-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",
@@ -4302,6 +4300,18 @@ var marginBoxAtRuleNames = new Set([
   "right-bottom"
 ]);
 var marginBoxIgnoredProperties = MARGIN_BOX_IGNORED_PROPERTIES;
+function isInPageBox(decl) {
+  const page = decl.parent;
+  return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
+}
+function isDroppedPageGradient(decl) {
+  const prop = decl.prop.toLowerCase();
+  if (prop !== "background" && prop !== "background-image")
+    return false;
+  if (!/(^|[\s,(])[\w-]*gradient\(/i.test(decl.value))
+    return false;
+  return isInPageBox(decl);
+}
 function isInPageMarginBox(decl) {
   const box = decl.parent;
   if (!box || box.type !== "atrule")
@@ -4402,7 +4412,14 @@ function checkCss(css, from) {
   root.walkAtRules((at) => reportRemoteUrls(at.params || "", at));
   root.walkDecls((decl) => {
     const prop = decl.prop.toLowerCase();
-    if (prop === "filter") {
+    if (marginBoxIgnoredProperties.has(prop) && isInPageMarginBox(decl)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `Property "${decl.prop}" is not supported in Chromium @page margin boxes and is silently ignored — the chrome renders square/unshadowed. Anything that would paint outside the box (box-shadow, outline, filter) or make it a stacking context (transform, opacity, mix-blend-mode) is dropped; text-shadow, border, border-radius, padding and background gradients all work inside the box.`,
+        ...nodeLoc(decl)
+      });
+    } else if (prop === "filter") {
       warnings.push({
         rule: ruleRiskyProps,
         severity: "warning",
@@ -4416,11 +4433,11 @@ function checkCss(css, from) {
         message: `Property is high-risk for print/PDF (can force rasterization): ${decl.prop}`,
         ...nodeLoc(decl)
       });
-    } else if (marginBoxIgnoredProperties.has(prop) && isInPageMarginBox(decl)) {
+    } else if (isDroppedPageGradient(decl)) {
       warnings.push({
         rule: ruleRiskyProps,
         severity: "warning",
-        message: `Property "${decl.prop}" is not supported in Chromium @page margin boxes and is silently ignored — the chrome renders square/unshadowed.`,
+        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 (isUnpairedFitContentWidth(decl)) {
@@ -8016,7 +8033,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-8kdwy0jz.js");
+      const { buildNativePdf } = await import("./engine-qg5tdaqv.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/{index-p0ebr7dh.js → index-my3v298z.js} RENAMED Viewed

@@ -4,7 +4,7 @@ import {
   launchChromium,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-7hrvksrb.js";
+} from "./index-wbm6p5j3.js";
 // src/engine/compiler/build.ts
 import { readFile } from "node:fs/promises";
@@ -1383,7 +1383,8 @@ var BUILD_DIAGNOSTIC_CODES = [
   "engine.multicol.dead-column",
   "engine.content.overheight",
   "engine.image.low-dpi",
-  "engine.flush.margin-box"
+  "engine.flush.margin-box",
+  "engine.page-background.unreferenced"
 ];
 async function build(opts) {
   const log = opts.onProgress ?? (() => {});
@@ -1410,6 +1411,7 @@ async function build(opts) {
       deviceScaleFactor: 1,
       mobile: false
     };
+    await page.send("Emulation.setScrollbarsHidden", { hidden: true });
     await page.send("Emulation.setDeviceMetricsOverride", sheetViewport);
     await page.send("Emulation.setEmulatedMedia", { media: "print" });
     log(`print media emulated for audits and measurement`);
@@ -1780,13 +1782,77 @@ ${mapCss}`;
         log(`audit: ${audit.length} print-quality warning(s)`);
     }
     {
-      const { leaks, multicol, layerTraps } = JSON.parse(await page.evaluate(`(() => {
+      const { leaks, multicol, layerTraps, pageBackgrounds } = JSON.parse(await page.evaluate(`(() => {
           const desc = ${DESC_JS};
           const leaks = [];
           const multicol = [];
           const layerTraps = [];
           const seenLayerTraps = new Set();
+          // Images referenced ONLY from inside an @page rule. Chromium fetches
+          // them and then paints nothing — see the pass comment above.
+          const pageBackgrounds = (() => {
+            const absolute = (u) => {
+              try { return new URL(u, document.baseURI).href } catch { return u }
+            };
+            const urlsIn = (text) => {
+              const out = [];
+              const re = /url\\(\\s*(['"]?)([^'")]*)\\1\\s*\\)/g;
+              let m;
+              while ((m = re.exec(text))) if (m[2]) out.push(m[2]);
+              return out;
+            };
+            const owned = new Map();
+            // Resolved by something OTHER than an @page rule — a CSS rule
+            // outside @page, or an element's inline style. Unconditionally
+            // protective: the image is a StyleImage the load already resolved.
+            const cssReferenced = new Set();
+            // Named by a <link rel="preload">. Protective, unless an element
+            // src names the same URL (see srcNamed).
+            const preloaded = new Set();
+            // Named by an element's src. NEVER protective — measured, this is
+            // the one reference type that BREAKS the page box, and it breaks
+            // it whether or not a preload is present (12/12, either document
+            // order). An element reference is evidence of the failure, not of
+            // safety.
+            const srcNamed = new Set();
+            for (const el of document.querySelectorAll("[src]"))
+              srcNamed.add(absolute(el.getAttribute("src")));
+            for (const el of document.querySelectorAll("link[rel~=preload][href]"))
+              preloaded.add(absolute(el.getAttribute("href")));
+            for (const el of document.querySelectorAll("[style]"))
+              for (const u of urlsIn(el.getAttribute("style"))) cssReferenced.add(absolute(u));
+            const walk = (rules, owner) => {
+              for (const rule of rules) {
+                let own = owner;
+                if (rule.constructor.name === "CSSPageRule")
+                  own = "@page" + (rule.selectorText ? " " + rule.selectorText : "");
+                else if (owner && rule.name) own = owner + " { @" + rule.name + " }";
+                for (const u of urlsIn(rule.style ? rule.style.cssText : "")) {
+                  if (!own) cssReferenced.add(absolute(u));
+                  else if (!owned.has(absolute(u))) owned.set(absolute(u), { url: u, where: own });
+                }
+                if (rule.cssRules) walk(rule.cssRules, own);
+              }
+            };
+            for (const sheet of document.styleSheets) {
+              let rules;
+              try { rules = sheet.cssRules } catch { continue }
+              walk(rules, null);
+            }
+            // PROTECTED iff another CSS rule resolves it, OR a preload names
+            // it and no element src names it too. "Something else mentions
+            // this URL" is NOT the test — that inference is inverted for
+            // [src], the very reference type that breaks the page box.
+            return [...owned]
+              .filter(([abs, hit]) =>
+                !/^data:/i.test(hit.url) &&
+                !cssReferenced.has(abs) &&
+                !(preloaded.has(abs) && !srcNamed.has(abs)))
+              .map(([, hit]) => hit)
+              .slice(0, 20);
+          })();
           const stackingReasons = (el, cs) => {
             const reasons = [];
             const positioned = cs.position !== "static";
@@ -1907,7 +1973,7 @@ ${mapCss}`;
               }
             }
           }
-          return JSON.stringify({ leaks, multicol, layerTraps });
+          return JSON.stringify({ leaks, multicol, layerTraps, pageBackgrounds });
         })()`));
       for (const d of leaks)
         diagnose("engine.abspos.leak", `${d} uses position: absolute with nothing positioned around it, so it is placed against the whole document rather than the page it sits on in your markdown — it can print on a completely different page.`);
@@ -1917,6 +1983,10 @@ ${mapCss}`;
         diagnose("engine.layer.trapped", `${trap.behind} cannot paint behind the page as intended because ancestor ${trap.ancestor} ${trap.detail}. Remove or narrowly scope that containment style around the .gp-behind element.`);
       if (layerTraps.length)
         log(`audit: ${layerTraps.length} trapped layer warning(s)`);
+      for (const hit of pageBackgrounds)
+        diagnose("engine.page-background.unreferenced", `"${hit.url}" is only referenced from "${hit.where}", and Chromium will not print an image referenced nowhere else — the page prints with its background colour alone, with no error. Gutterpress stages and preloads every image your project stylesheets reference, so this one is outside that: it is remote (a url(https://...), which is never staged), or it comes from CSS that does not pass through your stylesheets, or an element in the document uses the same URL as its src, which drops it on its own. Use a local image, referenced from one of your project stylesheets, and not also used as an <img>.`);
+      if (pageBackgrounds.length)
+        log(`audit: ${pageBackgrounds.length} unreferenced @page background image(s)`);
       for (const d of multicol)
         diagnose("engine.multicol.dead-column", `${d} runs over more than one page in columns, and only the last page's columns get balanced — earlier pages are left with an empty column. Add column-fill: auto to ${d}.`);
       if (multicol.length)
@@ -2069,6 +2139,7 @@ async function predictPageMap(browser, url, agentScript, viewerScript, args, she
   let page;
   try {
     page = await browser.newPage();
+    await page.send("Emulation.setScrollbarsHidden", { hidden: true });
     await page.send("Emulation.setDeviceMetricsOverride", sheetViewport);
     await page.navigate(url);
     await page.evaluate(agentScript);

package/dist/{index-7hrvksrb.js → index-wbm6p5j3.js} RENAMED Viewed

@@ -593,22 +593,22 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-zxgxnbg7.json";
+var manifest_schema_default = "./manifest.schema-084rxtwp.json";
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-2f5v96hd.js";
+var preview_interface_default = "./preview-interface-9rwz21yw.js";
 // src/assets/preview/scripts/preview-bridge.js
 var preview_bridge_default = "./preview-bridge-2nnrs2hy.js";
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-kyjq59d9.js";
+var preview_shell_default = "./preview-shell-gqnc5xxe.js";
 // profiles/CGATS21_CRPC1.icc
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-tma1qwz2.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-mfeccbys.js";
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
@@ -711,7 +711,18 @@ var MARGIN_BOX_IGNORED_PROPERTIES = new Set([
   "rotate",
   "translate",
   "scale",
-  "box-shadow"
+  "perspective",
+  "box-shadow",
+  "opacity",
+  "outline",
+  "outline-color",
+  "outline-style",
+  "outline-width",
+  "outline-offset",
+  "filter",
+  "backdrop-filter",
+  "mix-blend-mode",
+  "clip-path"
 ]);
 function isIgnoredMarginBoxProperty(property) {
   return MARGIN_BOX_IGNORED_PROPERTIES.has(property.toLowerCase());

package/dist/index.js CHANGED Viewed

@@ -113,15 +113,15 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectPlugins
-} from "./index-j6b6cees.js";
+} from "./index-5vfsbjwz.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-p0ebr7dh.js";
+} from "./index-my3v298z.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "./index-7hrvksrb.js";
+} from "./index-wbm6p5j3.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,

package/dist/lib/asset-inline.d.ts CHANGED Viewed

@@ -6,16 +6,15 @@
  * local `@import` closure) is inlined, so a stylesheet's location is irrelevant
  * to the output and themes/shared design systems need no copying. Fonts become
  * `data:` URIs — which is what guarantees the byte-identical face reaches
- * Chromium, and therefore the PDF. Small images inline; large ones are copied.
+ * Chromium, and therefore the PDF. Images are files: every CSS image is copied
+ * under a content-addressed name, whatever it weighs.
  *
  * A missing stylesheet or font is a build error here, at read time, rather than
- * a 404 during pagination that Paged.js parsed as CSS or silently replaced with
- * a system face.
+ * a 404 during pagination that gets parsed as CSS or silently replaced with a
+ * system face.
  *
  * Bundle-safe (CLAUDE.md §1/§3): postcss only.
  */
-/** Inline images up to this size; copy larger ones (full-bleed page art). */
-export declare const IMAGE_INLINE_MAX_BYTES: number;
 /** One file the build must copy into the output directory. */
 export interface AssetCopy {
     /** Absolute path of the source file. */
@@ -92,8 +91,11 @@ export declare function inlineStyles(projectDir: string, stylePaths: string[]):
  */
 export declare function collectStyleDependencies(projectDir: string, stylePaths: string[]): Promise<string[]>;
 /**
- * Turn the renderer's recorded image references into a copy plan. Images keep
- * their authored relative path, so the author's folder layout is what ships.
+ * Turn the renderer's recorded image references into a copy plan. PROSE images
+ * keep their authored relative path, so the author's folder layout is what
+ * ships for them. CSS images do NOT — `inlineOne` content-addresses every one,
+ * deliberately, so a CSS URL and a prose URL can never coincide (see the
+ * comment there). A file used both ways therefore ships twice under two names.
  * A `../` reference is rejected rather than silently relocated — it has no
  * representable path under the output root.
  */

package/dist/lib/build-runner.d.ts CHANGED Viewed

@@ -39,10 +39,10 @@ export interface BuildRunnerOptions {
     keepBrowserAlive?: boolean;
     rawArgs: Record<string, unknown>;
     /**
-     * CLI `--engine` override. Paged.js has been removed — the native engine is
-     * the only engine — so this is a deprecated no-op accepted for backward
-     * compatibility only: `"paged"` triggers a one-line warning
-     * (`manifest.ts`'s resolution) and the build proceeds natively regardless.
+     * CLI `--engine` override. The native engine is the only engine, so this is
+     * a deprecated no-op accepted for backward compatibility only: `"paged"`
+     * triggers a one-line warning (`manifest.ts`'s resolution) and the build
+     * proceeds natively regardless.
      */
     engine?: "paged" | "native";
     /**
@@ -70,9 +70,8 @@ export interface BuildRunnerResult {
     /** As {@link htmlPath}: `null` when nothing but the artifact was published. */
     fingerprintPath: string | null;
     /**
-     * Author-facing print-quality findings from the render (native engine only
-     * — Paged.js has no equivalent audit). Empty for a clean build. The desktop
-     * maps these into the Problems panel; the CLI logs them.
+     * Author-facing print-quality findings from the render. Empty for a clean
+     * build. The desktop maps these into the Problems panel; the CLI logs them.
      */
     diagnostics: BuildDiagnostic[];
 }

package/dist/lib/cli-args.d.ts CHANGED Viewed

@@ -42,11 +42,10 @@ export declare function parseFormat(raw: unknown, opts: {
 /** Parse `--pdfx-flavor`, which is only valid alongside `--format pdfx`. */
 export declare function parsePdfxFlavor(raw: unknown, format: BuildFormat): PdfxFlavor | undefined;
 /**
- * Parse `--engine`, shared by `build` and `preview`. Paged.js has been
- * removed — the native engine is the only engine — so this flag is now an
- * accepted-but-ignored no-op: `--engine paged` produces a one-line warning
- * (`manifest.ts`'s resolution) and the build proceeds natively regardless.
- * `undefined` means "not passed".
+ * Parse `--engine`, shared by `build` and `preview`. The native engine is the
+ * only engine, so this flag is an accepted-but-ignored no-op: `--engine paged`
+ * produces a one-line warning (`manifest.ts`'s resolution) and the build
+ * proceeds natively regardless. `undefined` means "not passed".
  */
 export declare function parseEngine(raw: unknown): "paged" | "native" | undefined;
 /** Parse `--port`, defaulting to {@link NETWORK.DEFAULT_PORT} (0 = OS-assigned). */

package/dist/lib/engine.d.ts CHANGED Viewed

@@ -17,9 +17,9 @@ export interface NativePdfOptions {
     allowShrink?: boolean;
 }
 /**
- * Render `htmlFile` to `outPdf` via the Gutterpress engine. No HTTP staging,
- * no Paged.js polyfill — but the pooled/pre-warmed Chromium IS reused (see
- * module doc comment): this module never launches or closes a browser itself.
+ * Render `htmlFile` to `outPdf` via the Gutterpress engine. No HTTP staging —
+ * but the pooled/pre-warmed Chromium IS reused (see module doc comment): this
+ * module never launches or closes a browser itself.
  *
  * Returns the build's author-facing diagnostics so the caller can surface
  * them (the desktop Problems panel, the CLI's own output). Dropping them here

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

@@ -39,6 +39,43 @@ export interface AssembleBookHtmlOptions {
      * relocate or lose during staging.
      */
     projectCss?: string;
+    /**
+     * SHIM — spec gap #152. Output-relative hrefs of the images the project's
+     * stylesheets staged (`inlineStyles`'s copy plan, verbatim), each emitted as
+     * one `<link rel="preload" as="image">`.
+     *
+     * Chromium reaches an `@page`-only `url()` lazily, during the print, and the
+     * print path CDP drives never waits for a pending resource — so the sheet
+     * comes back with its background colour alone, no error, a valid PDF of
+     * blank paper (docs/known-limitations.md §3; mechanism in
+     * PR #187's `docs/analysis/why-page-background-drops.md`).
+     *
+     * What the preload buys is that the fetch STARTS during document load
+     * instead of during the print. That is not a timing guarantee: a response
+     * slow enough still loses (measured — held 1500 ms server-side, the preload
+     * row drops too). On the PDF path the asset is a local file staged beside
+     * `book.html`, so there is no server to be slow; a published `--format html`
+     * bundle read over a slow network can still lose the race.
+     *
+     * A second ELEMENT reference is not an alternative. Any `[src]` naming the
+     * URL drops the page box (measured 12/12, with or without a preload, in
+     * either document order) — which is why `asset-inline.ts` content-addresses
+     * every CSS image so no element can name one.
+     *
+     * WHAT PROVES IT IS STILL NEEDED: the expiry canary,
+     * `engine/compiler/page-background-chromium-bug.canary.test.ts`. The day it
+     * goes red, Chromium has fixed the bug — delete this option, the `.map()`
+     * that feeds it in `markdown/index.ts`, and the canary.
+     *
+     * The copy plan is the source, NOT a scan of the assembled CSS: `pluginCss`
+     * never passes through `inlineStyles`, so a `url()` inside it is never
+     * staged and a scan would emit a `<link>` to a file that does not exist.
+     * The plan is already deduped (keyed by destination), already excludes fonts
+     * (inlined) and remote urls (left alone), and already covers the
+     * `--paper: url()` + `var(--paper)` shape, because `walkDecls` sees custom
+     * properties like any other declaration.
+     */
+    preloadImages?: string[];
     title?: string;
     plugins?: LoadedPlugin[];
     pluginCss?: string;

package/dist/lib/markdown/gutterpress-css.d.ts CHANGED Viewed

@@ -61,17 +61,12 @@
  *                   and a plain `width: 100%` already reaches both edges —
  *                   with no shrink-to-fit trigger, because nothing out-dents
  *                   past the content box. MEASURED (Chromium 148, 6x4in
- *                   sheet, 0.75in margins): the earlier mechanism (a negative
- *                   out-dent of the real page margins, inherited from the
- *                   Paged.js era, where the polyfill published them as
- *                   `--pagedjs-margin-left/right`) shrank the WHOLE document
- *                   ~10% under native print (text run 204.4pt -> 182.9pt),
+ *                   sheet, 0.75in margins): the obvious alternative — a
+ *                   negative out-dent of the real page margins — shrank the
+ *                   WHOLE document ~10% (text run 204.4pt -> 182.9pt),
  *                   because the shrink-to-fit trigger is the page CONTENT
- *                   box, not the sheet — that failure mode is why the named
- *                   page exists. Paged.js has since been removed
- *                   (native-only-migration-plan.md Phase 6), so the out-dent
- *                   (whose custom properties nothing sets any more, making it
- *                   a permanent no-op) went with it.
+ *                   box, not the sheet. That failure mode is why the named
+ *                   page exists.
  *
  *                   KNOWN GAP: on the bleed page, native's running head/folio
  *                   move onto the trim line (margin boxes are positioned by

package/dist/lib/markdown/markers.d.ts CHANGED Viewed

@@ -14,12 +14,10 @@ export default function plugin(md: any, pluginOptions?: {}): void;
  * page root that only shrink-wraps its text is a containing block whose
  * `bottom` edge is the end of the PROSE, so `.gp-pin .gp-bottom` (and every
  * hand-written `position: absolute; bottom: 0`) lands under the last
- * paragraph instead of at the page foot. Paged.js used to supply this height
- * for free — `.pagedjs_pagebox > .pagedjs_area > .pagedjs_page_content > div
- * { height: inherit; }` stretched the page root to the page area — and
- * deleting the polyfill (native-only migration, Phase 6) silently took
- * page-boundary pinning with it. Both renderers now publish the page
- * CONTENT height as `--gp-content-h` for the page context the element is in
+ * paragraph instead of at the page foot. Nothing in a continuous document
+ * stretches a page root to the page area on its own, so both renderers
+ * publish the page CONTENT height as `--gp-content-h` for the page context
+ * the element is in
  * (the viewer on each `.gp-strip`; the compiler on `:root` plus every
  * `page:` assignment selector), and custom properties inherit, so this one
  * rule reaches a page root at any wrapper depth. Undefined var (plain

package/dist/lib/markdown/source-range.d.ts CHANGED Viewed

@@ -12,7 +12,7 @@
  *      items, blockquotes, table rows, fences, footnote definitions, …).
  *   2. `token.meta.line` — the 1-based marker line threaded onto
  *      `layout_*_open` / `layout_page_break` / `layout_column_break` tokens
- *      by `markdown-it-paged.js` (see that file's header and the
+ *      by `markers.js` (see that file's header and the
  *      `t.meta = …` assignment sites). Converted to the same half-open
  *      convention as `[line - 1, line)`.
  *

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

@@ -14,8 +14,7 @@ import http from "node:http";
  * answering a separate question, "what Content-Type does a data: URI need
  * when embedding this file inline," vs. this table's "what Content-Type does
  * an HTTP response need" — had drifted again, missing `.webp`/`.avif` here.
- * A large (>512KB, over the inliner's threshold) WebP/AVIF image was copied
- * as a real file and then served as `application/octet-stream` by both
+ * A copied WebP/AVIF image was served as `application/octet-stream` by both
  * servers above. Added below; if a third image format shows up, add it to
  * BOTH tables in the same commit (asset-inline.ts is out of scope for this
  * PR — see docs/reviews/duplication-audit-2026-07-28.md).

package/dist/{lint-7wss5p35.js → lint-67xx8zms.js} RENAMED Viewed

@@ -1,16 +1,16 @@
 import {
   MANIFEST_FILENAMES,
   runLint
-} from "./cli-bq7vkea9.js";
+} from "./cli-w3spkryk.js";
 import {
   log
-} from "./cli-n79ghfhs.js";
+} from "./cli-wef7qh62.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-4n1p25df.js";
-import"./cli-eewynen9.js";
+} from "./cli-daahjr6z.js";
+import"./cli-c2yvktan.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{manifest.schema-zxgxnbg7.json → manifest.schema-084rxtwp.json} RENAMED Viewed

@@ -31,18 +31,18 @@
     },
     "engine": {
       "type": "string",
-      "description": "Pagination engine. Paged.js has been removed — the Gutterpress engine (native Chromium pagination) is the only engine, and \"native\" is the only meaningful value. \"paged\" is accepted for backward-compatible manifest parsing only: it produces a one-line warning and the build proceeds natively regardless. `--engine` on the CLI is likewise an accepted-but-ignored no-op.",
+      "description": "Pagination engine. The Gutterpress engine (native Chromium pagination) is the only engine, and \"native\" is the only meaningful value. \"paged\" is accepted for backward-compatible manifest parsing only: it produces a one-line warning and the build proceeds natively regardless. `--engine` on the CLI is likewise an accepted-but-ignored no-op.",
       "enum": ["paged", "native"],
       "default": "native",
       "examples": ["native"]
     },
     "engineStyles": {
       "type": "object",
-      "description": "Engine-conditional stylesheets, appended AFTER `styles`. `.native` is the only list that still applies; `.paged` is accepted-but-ignored (a warning fires if it has entries) now that Paged.js has been removed.",
+      "description": "Engine-conditional stylesheets, appended AFTER `styles`. `.native` is the only list that still applies; `.paged` is accepted-but-ignored (a warning fires if it has entries).",
       "properties": {
         "paged": {
           "type": "array",
-          "description": "REMOVED — Paged.js has been deleted. Accepted for backward-compatible manifest parsing only; entries here are ignored with a warning.",
+          "description": "Accepted for backward-compatible manifest parsing only; entries here are ignored with a warning.",
           "items": { "type": "string" }
         },
         "native": { "type": "array", "items": { "type": "string" } }

package/dist/{new-6gz60bbx.js → new-a4052xsg.js} RENAMED Viewed

@@ -5,16 +5,16 @@ import {
   TARGETS,
   TARGET_IDS,
   scaffoldProject
-} from "./cli-bq7vkea9.js";
+} from "./cli-w3spkryk.js";
 import {
   resolveGhostscript
-} from "./cli-n79ghfhs.js";
+} from "./cli-wef7qh62.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-4n1p25df.js";
-import"./cli-eewynen9.js";
+} from "./cli-daahjr6z.js";
+import"./cli-c2yvktan.js";
 import {
   isToolAvailable
 } from "./cli-c41yr7he.js";