gutterpress 0.10.1 → 0.10.2-alpha.2

package/dist/{plugin-7awkmgq0.js → plugin-n4b7b0nx.js}

@@ -1,14 +1,14 @@
 import {
   addNpmPlugin,
   parseNpmPluginSpec
-} from "./cli-bq7vkea9.js";
-import"./cli-n79ghfhs.js";
+} from "./cli-w3spkryk.js";
+import"./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/{preflight-3tb7stqb.js → preflight-7201sv7c.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} 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/preview/server-context.d.ts

@@ -35,12 +35,12 @@ export interface ServerState {
      * Files the inlined CSS references but could not embed, as
      * `book.html`-relative URL path → absolute source path.
      *
-     * `asset-inline.ts` embeds fonts and images up to
-     * `IMAGE_INLINE_MAX_BYTES`; anything larger keeps its project-relative path
-     * (if it lives in the book) or becomes `assets/<contentHash><ext>` (if it
-     * does not — e.g. art referenced from a repo-root shared stylesheet, the
-     * normative multi-book layout). Either way the inliner returns a COPY PLAN,
-     * which the build executes into its output dir.
+     * `asset-inline.ts` embeds fonts; every image becomes
+     * `assets/<contentHash><ext>`, wherever it lives — in the book, or in a
+     * repo-root shared stylesheet's art folder (the normative multi-book
+     * layout). The inliner returns a COPY PLAN, which the build executes into
+     * its output dir. Content-addressing is what keeps a CSS image's URL
+     * distinct from a prose image's; see `inlineOne`.
      *
      * The preview serves the project in place and has no output dir, so a
      * rewritten `assets/<hash>` URL had nothing behind it and shared art

package/dist/{preview-7a35z1v1.js → preview-ez7yfe8p.js}

@@ -1,15 +1,15 @@
 import {
   previewArgs
-} from "./cli-yzf38679.js";
+} from "./cli-pfpb1t3h.js";
 import {
   openPath,
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-bq7vkea9.js";
+} from "./cli-w3spkryk.js";
 import {
   log
-} from "./cli-n79ghfhs.js";
+} from "./cli-wef7qh62.js";
 import {
   UsageError,
   parseEngine,
@@ -18,8 +18,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-4n1p25df.js";
-import"./cli-eewynen9.js";
+} from "./cli-daahjr6z.js";
+import"./cli-c2yvktan.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError

package/dist/{preview-interface-2f5v96hd.js → preview-interface-9rwz21yw.js}

@@ -637,8 +637,8 @@
   // ONLY to serve that panel and went with it (protocol v8).
   //
   // Three properties of the native viewer are what make this work, each
-  // spike-verified rather than assumed (plan §2) — under Paged.js none of them
-  // held, which is why the panel existed:
+  // spike-verified rather than assumed (plan §2) — the floating panel existed
+  // because none of them can be assumed of a paginator that pre-cuts the DOM:
   //   1. A block spanning a page break is ONE element with several client
   //      rects, so it takes ONE contenteditable and the caret crosses the
   //      break natively (ArrowDown walks into the next page).

package/dist/{preview-shell-kyjq59d9.js → preview-shell-gqnc5xxe.js}

@@ -288,11 +288,9 @@
     armPendingSwap();
   }
 
-  // Incremental chapter splice used to live here (spliceChapter): it needed
-  // Paged.js's `.pagedjs_page` DOM to find a chapter's live page range and
-  // graft a freshly-paginated replacement into it. Paged.js has been removed
-  // (native-only-migration-plan.md Phase 6). A native in-place splice was
-  // also tried and removed (2026-08-08 review), and the standing reason is
+  // Incremental chapter splice used to live here (spliceChapter): it grafted
+  // a freshly-paginated replacement into a chapter's live page range. It was
+  // tried and removed (2026-08-08 review), and the standing reason is
   // PERFORMANCE, not soundness: measured end-to-end (file write -> change
   // visible, 5 samples, 34pp field guide) the plain full reload (`swap`,
   // below) is 509ms avg vs the incremental splice's 998ms avg. Every

package/dist/{publish-dpx2cebg.js → publish-thxa0cz7.js}

@@ -7,17 +7,17 @@ import {
   publishCredentialKey,
   publishProviderFor,
   runPublish
-} from "./cli-bq7vkea9.js";
+} from "./cli-w3spkryk.js";
 import {
   FileTokenStore,
   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/render.js

@@ -1389,12 +1389,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>

package/dist/schema/manifest.types.d.ts

@@ -67,8 +67,7 @@ export interface GutterpressManifest {
     /** How the book is designed (ADR 0008). The registry in lib/presets.ts is authoritative. */
     preset?: "dtrpg" | "book" | "custom";
     /**
-     * Pagination engine. Paged.js has been removed (native-only-migration-
-     * plan.md Phase 6) — the Gutterpress engine (`src/engine/`, native Chromium
+     * Pagination engine. The Gutterpress engine (`src/engine/`, native Chromium
      * pagination) is the only engine. This field and `--engine` on the CLI are
      * accepted-but-ignored for backward compatibility: an explicit "paged"
      * produces a one-line warning and the build proceeds natively regardless.
@@ -77,12 +76,12 @@ export interface GutterpressManifest {
     /**
      * 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.
+     * fires if it has entries).
      */
     engineStyles?: {
         /**
-         * REMOVED — Paged.js has been deleted. Accepted for backward-compatible
-         * manifest parsing only; entries here are ignored with a warning.
+         * Accepted for backward-compatible manifest parsing only; entries here are
+         * ignored with a warning.
          */
         paged?: string[];
         native?: string[];

package/dist/test-helpers/testkit.d.ts

@@ -89,3 +89,34 @@ export declare class ProcessExitSignal extends Error {
  * `build-runner.browser-lifecycle.test.ts`.
  */
 export declare function stubProcessExit(): ReturnType<typeof spyOn<typeof process, "exit">>;
+/**
+ * "Did this declaration paint anything?" is not answerable from a PDF's
+ * structure — Chromium fetches an unreferenced `@page` background image and
+ * then paints nothing, with no error and no missing object
+ * (docs/known-limitations.md §3, #152). The only honest answer is pixels, so
+ * these helpers rasterize page 1 and diff it against a control.
+ *
+ * Ghostscript rather than poppler's `pdftoppm`: `gs` is what CI installs, and
+ * one rasterizer keeps the two page-background suites measuring the same way.
+ */
+export interface GrayRaster {
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+/** Ghostscript's path, or `null`. Callers self-skip, as the PDF/X suites do. */
+export declare function resolveRasterizer(): Promise<string | null>;
+/** Page 1 of `pdfPath` as an 8-bit grayscale raster at 100 dpi. */
+export declare function rasterizePdfPage(gsBin: string, pdfPath: string, outDir: string, tag: string): GrayRaster;
+/**
+ * Mean absolute per-pixel difference. `0` means the two prints are identical —
+ * i.e. the declaration under test changed nothing at all.
+ */
+export declare function meanAbsDiff(a: GrayRaster, b: GrayRaster): number;
+/**
+ * A minimal RGB PNG encoder, so page-background fixtures can generate the
+ * exact image they need — a solid tile that is unmistakable when it paints, or
+ * an incompressible one that is genuinely large — instead of carrying opaque
+ * base64 blobs whose size and contrast nobody can check by reading them.
+ */
+export declare function pngRgb(width: number, height: number, pixel: (x: number, y: number) => [number, number, number]): Buffer;

package/dist/types.d.ts

@@ -29,8 +29,8 @@ export interface PreviewServerOptions {
     openBrowser: boolean;
     /**
      * CLI `--engine` override, fed into {@link resolveConfig} the same way
-     * `build`'s does (MIGRATION.md Decision #5 — preview and PDF switch
-     * together, per project, behind one flag). `undefined` defers to the
+     * `build`'s does — preview and PDF switch together, per project, behind
+     * one flag. `undefined` defers to the
      * manifest's `engine:` field (or the "native" default).
      */
     engine?: "paged" | "native";

package/dist/{validate-hbe05b26.js → validate-0tbsdxz2.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/package.json

@@ -1,6 +1,6 @@
 {
   "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",