gutterpress 0.10.1 → 0.10.2-alpha.2

package/dist/api/index.js

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

package/dist/{audit-p4e7v2m7.js → audit-qz3np6k3.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} 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/{build-h0x2w036.js → build-41eds5kk.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-bq7vkea9.js";
+} from "./cli-w3spkryk.js";
 import {
   log
-} from "./cli-n79ghfhs.js";
+} from "./cli-wef7qh62.js";
 import {
   UsageError,
   parseEngine,
@@ -12,8 +12,8 @@ import {
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-4n1p25df.js";
-import"./cli-eewynen9.js";
+} from "./cli-daahjr6z.js";
+import"./cli-c2yvktan.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
@@ -38,7 +38,7 @@ var commandArgs = {
   "skip-pre-validate": { type: "boolean", description: "Skip pre-build validation" },
   "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation" },
   "allow-shrink": { type: "boolean", description: "Build anyway when content is wider than the page content box, instead of failing. Chromium then scales the WHOLE book down to fit; each offender is reported as a warning." },
-  engine: { type: "string", description: "Pagination engine. Paged.js has been removed; native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
+  engine: { type: "string", description: "Pagination engine. Native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
 };
 var build_default = defineCommand({
   meta: {

package/dist/{cli-eewynen9.js → cli-c2yvktan.js}

@@ -936,7 +936,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());
@@ -1419,22 +1430,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";
@@ -1885,6 +1896,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`);
@@ -2255,13 +2267,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";
@@ -2382,7 +2458,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.`);
@@ -2392,6 +2468,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)
@@ -2544,6 +2624,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/{cli-4n1p25df.js → cli-daahjr6z.js}

@@ -4,7 +4,7 @@ import {
 // 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",

package/dist/{cli-yzf38679.js → cli-pfpb1t3h.js}

@@ -22,7 +22,7 @@ var previewArgs = {
   "skip-pre-validate": { type: "boolean", description: "Skip pre-build validation (pdf|pdfx only)" },
   "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation (pdfx only)" },
   "allow-shrink": { type: "boolean", description: "Build anyway when content is wider than the page content box, instead of failing. Chromium then scales the WHOLE book down to fit; the scale and each offender are reported as warnings. (pdf|pdfx only)" },
-  engine: { type: "string", description: "Pagination engine. Paged.js has been removed; native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
+  engine: { type: "string", description: "Pagination engine. Native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
 };
 
 export { previewArgs };

package/dist/{cli-bq7vkea9.js → cli-w3spkryk.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-n79ghfhs.js";
+} from "./cli-wef7qh62.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-4n1p25df.js";
+} from "./cli-daahjr6z.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -27,7 +27,7 @@ import {
   getAssetPath,
   getBrowser,
   prewarmBrowser
-} from "./cli-eewynen9.js";
+} from "./cli-c2yvktan.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -466,10 +466,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 ?? [];
@@ -1126,6 +1126,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")
@@ -1226,7 +1238,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",
@@ -1240,11 +1259,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)) {
@@ -2776,7 +2795,6 @@ import { readFile as readFile9 } from "node:fs/promises";
 import path3 from "node:path";
 import postcss2 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",
@@ -2896,7 +2914,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 = path3.resolve(cssPath);
   if (seen.has(abs))
     return "";
@@ -2931,11 +2949,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 = path3.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;
     });
@@ -2948,7 +2962,7 @@ async function inlineOne(cssPath, projectDir, copies, warnings, seen) {
   });
   for (const { node, target } of imports) {
     const importedAbs = path3.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, postcss2.parse(inlined, { from: importedAbs })));
   }
   return root.toString();
@@ -2960,7 +2974,7 @@ async function inlineStyles(projectDir, stylePaths) {
   const parts = [];
   for (const rel of stylePaths) {
     const abs = path3.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(path3.relative(projectDir, abs))} */
 ${css.trim()}`);
@@ -6287,12 +6301,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>
@@ -6324,6 +6340,7 @@ async function renderChapters(inputDir, opts = {}) {
     files,
     readText: (relPath) => readFile18(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
     projectCss: inlined.css,
+    preloadImages: inlined.copies.map((c) => c.to),
     title: opts.title,
     plugins: opts.plugins,
     pluginCss: opts.pluginCss,
@@ -7521,7 +7538,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-57vw8zpd.js");
+      const { buildNativePdf } = await import("./engine-36jts441.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/{cli-n79ghfhs.js → cli-wef7qh62.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-4n1p25df.js";
+} from "./cli-daahjr6z.js";
 import {
   execCapture,
   findTool,

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   previewArgs
-} from "./cli-yzf38679.js";
+} from "./cli-pfpb1t3h.js";
 import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-4n1p25df.js";
+} from "./cli-daahjr6z.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,16 +18,16 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-6gz60bbx.js").then((m) => m.default),
-  preview: () => import("./preview-7a35z1v1.js").then((m) => m.default),
-  build: () => import("./build-h0x2w036.js").then((m) => m.default),
-  publish: () => import("./publish-dpx2cebg.js").then((m) => m.default),
-  lint: () => import("./lint-7wss5p35.js").then((m) => m.default),
-  validate: () => import("./validate-hbe05b26.js").then((m) => m.default),
-  audit: () => import("./audit-p4e7v2m7.js").then((m) => m.default),
-  preflight: () => import("./preflight-3tb7stqb.js").then((m) => m.default),
-  doctor: () => import("./doctor-y2w1kcqf.js").then((m) => m.default),
-  plugin: () => import("./plugin-7awkmgq0.js").then((m) => m.default)
+  new: () => import("./new-a4052xsg.js").then((m) => m.default),
+  preview: () => import("./preview-ez7yfe8p.js").then((m) => m.default),
+  build: () => import("./build-41eds5kk.js").then((m) => m.default),
+  publish: () => import("./publish-thxa0cz7.js").then((m) => m.default),
+  lint: () => import("./lint-67xx8zms.js").then((m) => m.default),
+  validate: () => import("./validate-0tbsdxz2.js").then((m) => m.default),
+  audit: () => import("./audit-qz3np6k3.js").then((m) => m.default),
+  preflight: () => import("./preflight-7201sv7c.js").then((m) => m.default),
+  doctor: () => import("./doctor-dqmz9wr7.js").then((m) => m.default),
+  plugin: () => import("./plugin-n4b7b0nx.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -52,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-6gz60bbx.js");
+      const { newArgs } = await import("./new-a4052xsg.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed2 = parseArgs(commandArgs, {
         ...newArgs,
@@ -64,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-3tb7stqb.js");
+      const { preflightArgs } = await import("./preflight-7201sv7c.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed2 = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -88,7 +88,7 @@ async function preflightRequiredInvocations(rawArgs) {
     if (subcommand !== "add") {
       throw new UsageError(`gutterpress plugin: unknown command "${subcommand}"`);
     }
-    const { pluginAddArgs } = await import("./plugin-7awkmgq0.js");
+    const { pluginAddArgs } = await import("./plugin-n4b7b0nx.js");
     rejectUnknownFlags(subcommandArgs, pluginAddArgs, "plugin add");
     const parsed = parseArgs(subcommandArgs, {
       ...pluginAddArgs,

package/dist/{doctor-y2w1kcqf.js → doctor-dqmz9wr7.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-n79ghfhs.js";
+} from "./cli-wef7qh62.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-4n1p25df.js";
+} from "./cli-daahjr6z.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/engine/compiler/build.d.ts

@@ -7,7 +7,7 @@ import { type PostprocessResult } from "./postprocess.ts";
  * set is closed here so a surface's label table can be asserted complete
  * against it rather than drifting silently as checks are added.
  */
-export type BuildDiagnosticCode = "engine.width.overflow" | "engine.width.intrinsic" | "engine.xref.broken" | "engine.abspos.leak" | "engine.layer.trapped" | "engine.multicol.dead-column" | "engine.content.overheight" | "engine.image.low-dpi" | "engine.flush.margin-box";
+export type BuildDiagnosticCode = "engine.width.overflow" | "engine.width.intrinsic" | "engine.xref.broken" | "engine.abspos.leak" | "engine.layer.trapped" | "engine.multicol.dead-column" | "engine.content.overheight" | "engine.image.low-dpi" | "engine.flush.margin-box" | "engine.page-background.unreferenced";
 export declare const BUILD_DIAGNOSTIC_CODES: readonly BuildDiagnosticCode[];
 export interface BuildDiagnostic {
     code: BuildDiagnosticCode;

package/dist/engine/shared/margin-box-support.d.ts

@@ -2,7 +2,24 @@
  * Declarations Chromium accepts syntactically in `@page` margin boxes but
  * silently drops in native print. These were measured with deliberately
  * visible values (`rotate(-12deg)`, `6px 6px 0 #c00`) and are documented in
- * docs/engine-history/ENGINE.md §8.
+ * docs/engine/ENGINE.md §8 and docs/known-limitations.md §2.
+ *
+ * The line is what the property PAINTS, not the property family: everything
+ * that establishes a stacking context or paints outside the border box is
+ * dropped, everything that paints inside it is honoured. `text-shadow` beside
+ * `box-shadow` is the clearest pair. Re-measured on Chrome 151.0.7922.75,
+ * 96dpi raster, mean absolute pixel difference against the same box without
+ * the declaration (control: removing the box entirely, 2.6485):
+ *
+ *   dropped, all 0.0000   box-shadow · transform (rotate/scale/translate) ·
+ *                         rotate/scale/translate · opacity · outline (and its
+ *                         longhands) · filter · mix-blend-mode ·
+ *                         backdrop-filter · clip-path · perspective
+ *   honoured              text-shadow 0.1375 · border-radius 0.3397 ·
+ *                         background gradient 11.2260 · writing-mode 0.3200 ·
+ *                         padding-left 0.2927 · font-size 0.7864 ·
+ *                         color 0.1063 · letter-spacing 0.2781 ·
+ *                         text-transform 0.1804 · visibility 2.6485
  *
  * Keep the viewer and print-safety linter on this one contract: preview must
  * omit the same effects native PDF omits, while every other declaration is

package/dist/{engine-57vw8zpd.js → engine-36jts441.js}

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

package/dist/{engine-8kdwy0jz.js → engine-qg5tdaqv.js}

@@ -1,13 +1,13 @@
 import {
   build
-} from "./index-p0ebr7dh.js";
+} from "./index-my3v298z.js";
 import {
   BuildError,
   RENDER_TIMEOUT_MS,
   assertMilestone,
   connectChromium,
   getBrowser
-} from "./index-7hrvksrb.js";
+} from "./index-wbm6p5j3.js";
 import"./index-37x76zdn.js";
 
 // src/lib/engine.ts

package/dist/{gutterpress-viewer-tma1qwz2.js → gutterpress-viewer-mfeccbys.js}

@@ -2012,7 +2012,18 @@
     "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());