gutterpress 0.11.23-alpha.2 → 0.11.23-alpha.4

package/dist/{index-4x6y8krm.js → index-yc3xj266.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-0skhjx3e.js";
+} from "./index-5kh4c78h.js";
 import {
   launchChromium
 } from "./index-bt0qws5c.js";

package/dist/index.js

@@ -116,7 +116,7 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-j5z86r4a.js";
+} from "./index-ea94zbq4.js";
 import {
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
@@ -146,7 +146,7 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-x3ema2w3.js";
+} from "./index-kaks3mm2.js";
 import {
   BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
@@ -162,16 +162,16 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-2bjcghze.js";
+} from "./index-8ywkd2sv.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-4x6y8krm.js";
-import"./index-0skhjx3e.js";
+} from "./index-yc3xj266.js";
+import"./index-5kh4c78h.js";
 import {
   BuildError
 } from "./index-46ycxe6r.js";
-import"./index-2ppw6q9v.js";
+import"./index-5crpmz42.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/build-preflight.d.ts

@@ -28,9 +28,10 @@ export interface Gates {
      * Disable the `source.stylelint` check (CSS print-safety: remote urls,
      * risky print effects, page-containment) for this run, without touching
      * `preValidate` itself (#272 — one CSS gate, not two). `true` when
-     * `--skip-lint` was passed or `config.lint.enabled === false`; consulted
-     * only when `preValidate` is also true — with `preValidate` off, no
-     * pre-build check (CSS included) runs at all, `--skip-lint` or not.
+     * `--skip-lint` was passed (a book switches it off for good with
+     * `checks: { source.stylelint: off }`); consulted only when `preValidate`
+     * is also true — with `preValidate` off, no pre-build check (CSS
+     * included) runs at all, `--skip-lint` or not.
      */
     skipStylelint: boolean;
     preValidate: boolean;
@@ -40,11 +41,4 @@ export declare function computeGates(format: BuildFormat, opts: {
     skipLint?: boolean;
     skipPreValidate?: boolean;
     skipPostValidate?: boolean;
-}, config: {
-    lint: {
-        enabled: boolean;
-    };
-    validate: {
-        enabled: boolean;
-    };
 }): Gates;

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

@@ -131,7 +131,7 @@ export interface BuildContext {
     inputDir: string;
     /**
      * THE anchor every manifest-relative path resolves against: `styles:`,
-     * `source.files`, authored plugin `path:` entries, and the CSS print-safety
+     * `chapters`, authored plugin `path:` entries, and the CSS print-safety
      * check's stylesheet resolution. Equal to {@link BuildContext.manifestDir}.
      *
      * It is NOT `inputDir`. The two are identical in the normative layout (the

package/dist/lib/extension-manager.d.ts

@@ -27,14 +27,11 @@ export interface ProjectExtensionEntry {
     author?: string;
     /** Preview image path relative to the extension folder, when declared. */
     preview?: string | null;
-    /** The sheet carrying the `:root` token surface, relative to the folder,
-     *  when declared (package.json's `gutterpress.tokensFile`). */
-    tokensFile?: string;
     /** Declared stylesheets relative to the folder, in cascade order
      *  (`gutterpress.styles`). Absent when the folder declares none. */
     styles?: string[];
-    /** What the extension declares — the desktop shows styles-carrying entries
-     *  in its Look view and markdown-carrying ones in Features; one list. */
+    /** What the extension declares — the badges on the desktop's Looks &
+     *  features list. */
     carries: ExtensionCarries;
     /** Absolute folder its metadata was read from. Absent for a bundled name,
      *  a bare JS file, an uninstalled npm entry, or a missing path. */
@@ -208,7 +205,11 @@ export declare function uniqueExtensionId(projectDir: string, base: string): Pro
 export declare function validateProjectExtensions(projectDir: string): Promise<ExtensionValidationResult[]>;
 /**
  * Read an extension's stylesheets, concatenated in cascade order, for a
- * preview thumbnail (the renderer never touches fs). Read-only, so
- * concatenation is fine even though it would not be for an editable surface.
+ * preview thumbnail (the renderer never touches fs). A bundled look answers
+ * whether or not the manifest lists it, so a book can show what a look is
+ * before adding it. Read-only, so concatenation is fine even though it would
+ * not be for an editable surface.
  */
 export declare function readExtensionCss(projectDir: string, use: string): Promise<string>;
+/** The same, for an entry already described (`listProjectExtensions`), so a caller with the list in hand reads each once. */
+export declare function readEntryCss(entry: Pick<ProjectExtensionEntry, "use" | "dir">): Promise<string>;

package/dist/lib/extension-manifest.d.ts

@@ -42,11 +42,6 @@ export interface ExtensionMetadata {
      * its sheets, it does not get an implicit `theme.css`.
      */
     styles?: string[];
-    /** `gutterpress.tokensFile` — which declared sheet (a path from `styles`)
-     *  carries the author-facing `:root` token surface for the Design panel's
-     *  guided editor. Purely advisory — nothing in this module enforces or
-     *  existence-checks it. */
-    tokensFile?: string;
     /**
      * `gutterpress.markdown` — an EXPLICIT markdown-it entry, relative to the
      * extension folder, for the one case npm's `main` can't express: a package
@@ -138,7 +133,7 @@ export declare function assertPublishOnly(meta: ExtensionMetadata, ref: string):
  * Exported (#242) for `snippets.ts`'s installed-extension snippet merge,
  * which needs this SAME single-field check but cannot use
  * {@link assertExtensionContained}: that guard throws on ANY escaping field
- * (styles/markdown/components/tokensFile too), which is correct for a
+ * (styles/markdown/components too), which is correct for a
  * write-boundary check at install/apply time but wrong for a tolerant
  * listing — an extension with a broken, unrelated `styles` entry must not
  * make its perfectly fine `snippets` folder disappear from the picker (the
@@ -158,8 +153,6 @@ export declare function assertSupportsThisGutterpress(meta: ExtensionMetadata, r
  * extension is self-contained by contract (apply/install copies the whole
  * folder), and an imported/vendored package is untrusted input: a `../` or
  * absolute entry would make apply/load read a file from anywhere on disk.
- * `tokensFile` is included even though it is advisory/unenforced elsewhere —
- * defense in depth against a future consumer reading it unchecked.
  *
  * A WRITE-BOUNDARY guard, not a read-path check: callers invoke this before
  * copying anything or wiring a manifest, never from a plain listing/read
@@ -176,17 +169,12 @@ export declare function assertExtensionContained(meta: ExtensionMetadata): void;
  * `styles` already resolve through, so a broken declaration (a missing file)
  * throws HERE, at load/apply time, instead of failing silently deep in the
  * render pipeline (or never, for `components`, which nothing yet reads).
- *
- * `tokensFile` is the one exception, kept as declared (relative, not
- * existence-checked) — it stays purely advisory.
  */
 export interface ResolvedExtension {
     /** Absolute path to the markdown-it entry module, when the folder has one. */
     markdown?: string;
     /** Absolute paths, in cascade order, when any are declared. */
     styles?: string[];
-    /** Declared-relative path of the `:root` token surface — advisory. */
-    tokensFile?: string;
     /** Absolute path to the component catalog file, when declared (#242). */
     components?: string;
     /** Absolute path to the snippets folder, when declared. */

package/dist/lib/ghostscript.d.ts

@@ -1,4 +1,4 @@
-import type { UnsplittableReason } from "./pdf-inspect";
+import { type UnsplittableReason } from "./pdf-inspect";
 /**
  * Resolve the Ghostscript command on every supported platform.
  *
@@ -57,7 +57,10 @@ export declare function transparentPages(pdfBytes: Uint8Array): Promise<number[]
  * these shadings.
  *
  * Walks page resources (and form XObjects they draw) rather than every
- * object, so only shadings a page can actually paint are reported. Like
+ * object, so only shadings a page can actually paint are reported; of those
+ * pages, only the ones that paint a shading with a visible area (#438: a box
+ * that opens the NEXT page is also in this page's content as a sliver —
+ * `pagesWithVisibleShadingPaints`, pdf-inspect.ts). Like
  * {@link transparentPages}, it never fails a build: an unparseable PDF
  * reports no pages.
  */

package/dist/lib/lint-rules.d.ts

@@ -1,5 +1,9 @@
 export type LintLevel = "off" | "warn" | "error";
-/** Read one rule's configured level; unrecognised values are ignored. */
+/**
+ * Read one rule's configured level; unrecognised values (and `on`) leave the
+ * rule at its own severity. A lint rule reports at warning or error, so
+ * `info` reads as warning.
+ */
 export declare function ruleLevel(rules: Readonly<Record<string, unknown>> | undefined, id: string): LintLevel | undefined;
 /**
  * The rule ids named by a `gutterpress-disable-next-line <id>[, <id>...]

package/dist/lib/manifest-config.d.ts

@@ -2,7 +2,7 @@
 export interface ProjectConfigFields {
     title?: string;
     authors?: string[];
-    /** `source.files` — the markdown inputs (null means "all chapter files"). */
+    /** `chapters` — the markdown inputs (null means "all chapter files"). */
     sourceFiles?: string[] | null;
     /**
      * `targets:` — the publish destinations this book is validated against
@@ -16,7 +16,8 @@ export interface ProjectConfigFields {
  * Apply the author-facing manifest field updates in a single yaml round-trip.
  * Only the keys present in `updates` are written; everything else is left
  * untouched (so unrelated comments + sections survive). `sourceFiles: null`
- * deletes the `source.files` entry (back to "all chapter files").
+ * deletes the `chapters` entry (back to "all chapter files"). Either way an
+ * older book's `source.files` is taken out, so the list has one spelling.
  */
 export declare function setManifestFields(projectDir: string, updates: ProjectConfigFields): Promise<ProjectConfigFields>;
 /**

package/dist/lib/manifest-old-spellings.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The manifest spellings 0.11.23 replaced, read for this release only so a
+ * book written for 0.11.22 still builds. Every old key found is translated
+ * to its new spelling (or dropped, when nothing replaces it) and named in ONE
+ * notice. Delete this module, and its call in `loadManifestWithPath`, in the
+ * release after 0.11.23.
+ *
+ *   source.files                     -> chapters
+ *   validate.checks, lint.rules      -> checks (off | on | info | warn | error)
+ *   validate.source.<tool>: false    -> checks: { source.<tool>: off }
+ *   lint.enabled: false              -> checks: { source.stylelint: off }
+ *   validate.assets.allowAlpha,
+ *   validate.assets.requireFontLicense,
+ *   validate.pdf.requireBookmarks,
+ *   validate.pdf.requireTocLinks,
+ *   validate.pdf.requireBleed,
+ *   validate.pdf.forbidTransparency  -> the matching check, on or off
+ *   validate.source.<tool>: <path>   -> dropped: the config file is found by
+ *                                       its usual name in the book's folder
+ *                                       or a folder above it
+ *   ink.*, page.tolerance,
+ *   validate thresholds,
+ *   validate.enabled, lint.configPath,
+ *   and the keys
+ *   0.11.22 already ignored           -> dropped: the preset and the publish
+ *                                       target set the thresholds
+ */
+import type { CheckLevelInput, GutterpressManifest } from "../schema/manifest.types";
+type OldCheckEntry = boolean | {
+    enabled?: boolean;
+    severity?: string;
+    options?: unknown;
+};
+/** The keys a pre-0.11.23 manifest may carry. */
+export interface OldSpellings {
+    source?: {
+        files?: string[] | null;
+        assets?: unknown;
+    } | null;
+    lint?: {
+        enabled?: boolean;
+        configPath?: string | null;
+        rules?: Record<string, CheckLevelInput>;
+    } | null;
+    validate?: {
+        enabled?: boolean;
+        checks?: Record<string, OldCheckEntry>;
+        source?: Record<string, unknown>;
+        assets?: Record<string, unknown>;
+        pdf?: Record<string, unknown>;
+        heuristics?: Record<string, unknown>;
+    } | null;
+    ink?: unknown;
+    page?: GutterpressManifest["page"] & {
+        tolerance?: unknown;
+    };
+}
+/**
+ * Translate a parsed manifest's old spellings to the current ones. A key
+ * written both ways keeps the new spelling. Throws for `source.assets`,
+ * removed before 0.11.23 with an actionable error.
+ */
+export declare function readOldSpellings(raw: GutterpressManifest & OldSpellings): GutterpressManifest;
+export {};

package/dist/lib/manifest.d.ts

@@ -1,4 +1,4 @@
-import type { GutterpressManifest, ResolvedConfig } from "../schema/manifest.types";
+import type { GutterpressManifest, PageMargin, ResolvedConfig } from "../schema/manifest.types";
 /**
  * The manifest file name Gutterpress recognizes.
  * Single source of truth — any code that needs to find/match a manifest file
@@ -44,3 +44,17 @@ export declare function resolveConfig(cliOverrides: Partial<GutterpressManifest>
  * the same sovereignty rule presets follow.
  */
 export declare function resolveConfigForTarget(cliOverrides: Partial<GutterpressManifest>, manifest: GutterpressManifest, targetId: string): ResolvedConfig;
+/** The edges of `page.margin`, in the order they are shown and written. */
+export declare const MARGIN_EDGES: readonly ["top", "bottom", "inside", "outside"];
+/**
+ * The one rule for a legal `page.margin`, applied to a manifest as it is
+ * resolved and to a margin Book setup is about to write: all four edges or
+ * nothing (a partial block would leave the missing edges to whatever a
+ * stylesheet says, the two-places split the field exists to end), each a
+ * finite point value of 0 or more, and the four leaving room for text on the
+ * page. Returns the margin typed, or throws the message both callers show.
+ */
+export declare function validatePageMargin(margin: unknown, size: {
+    width: number;
+    height: number;
+}): PageMargin;

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

@@ -138,9 +138,10 @@ export interface AssembleBookHtmlOptions {
      * preset id and printer spec — written as `<meta name="gp-print-area">`
      * (engine/shared/print-area.ts) into EVERY assembled book, preview, build
      * and publish alike: the preview's print overlays judge the ink against it,
-     * and both engines place pinned art on its art-safe line. Metadata only,
-     * with one exception: its `width` x `height` is also the page size the book
-     * prints at when no stylesheet sets one — see {@link defaultPageSizeCss}.
+     * and both engines place pinned art on its art-safe line. Metadata, except
+     * that its `width` x `height` is also the page size the book prints at, and
+     * its `margin`, when the manifest sets one, the margins — see
+     * {@link pageGeometryCss}.
      */
     printArea?: PrintAreaSource;
     plugins?: LoadedPlugin[];

package/dist/lib/markdown/chapter-id.d.ts

@@ -13,7 +13,7 @@
  *   - the desktop's editor↔preview sync scoping
  *     (packages/desktop +page.svelte editorChapter)
  *
- * WHY: manifest `source.files` entries are author-written and arrive in many
+ * WHY: manifest `chapters` entries are author-written and arrive in many
  * spellings (`./chapters/03.md`, `chapters\03.md` on Windows, `chapters//03.md`),
  * while the watcher broadcasts `path.relative(inputPath, file)`. Before this
  * helper the build tagged the manifest string VERBATIM, so any `./`-prefixed

package/dist/lib/markdown/index.d.ts

@@ -9,7 +9,7 @@ export type { LayoutWarning } from "./assemble";
  * resolver — markdown's counterpart to `resolveActiveStyles` (style-resolver.ts).
  * Both `renderChapters` below AND validation (validation-exec.ts) call this,
  * so what gets checked is always what gets rendered:
- *   1. `configuredFiles` (the manifest `source.files` list), if it has entries,
+ *   1. `configuredFiles` (the manifest `chapters` list), if it has entries,
  *      in that order; else
  *   2. every `.md` file directly inside `inputDir` — NOT recursive, since a
  *      book's chapters live at the project root by convention — alphabetically.

package/dist/lib/markdown/table.d.ts

@@ -11,9 +11,11 @@ import type MarkdownIt from "markdown-it";
  *     or a formula splits the cell, and the cells past the header's count
  *     are silently dropped. Here an inline span is opaque to the split: a
  *     code span always, and a `$…$` formula when the math feature is on
- *     (math.ts re-registers this rule with its own scanner). `\|` still
- *     escapes a pipe in plain cell text; inside a span nothing is touched,
- *     so `\|` in a formula is LaTeX's own `\|`.
+ *     (math.ts re-registers this rule with its own scanner). `\|` escapes
+ *     a pipe in plain cell text and, as on GitHub, inside a code span (the
+ *     GFM spec's "including inside other inline spans"), so a table that
+ *     lints clean for markdownlint's MD056 prints `|`, not `\|`; a formula's
+ *     text is not touched, so `\|` there is LaTeX's own `\|`.
  *   - a row with MORE cells than the header is reported
  *     (`table_extra_cells` on `env.layoutWarnings`, the channel Gutterpress's
  *     marker parser uses) instead of losing them without a word.

package/dist/lib/page-size.d.ts

@@ -1,67 +1,79 @@
 import type { Document } from "yaml";
 import { type PresetId } from "./presets.ts";
-import { formatPageSize, isPositivePoints } from "../engine/shared/print-area.ts";
-export { formatPageSize, isPositivePoints };
+import { isPositivePoints } from "../engine/shared/print-area.ts";
+import type { PageMargin } from "../schema/manifest.types.ts";
+export { isPositivePoints };
+export type { PageMargin };
 /** Page bounds written to the manifest's `page:` block (points; 72pt = 1in). */
 export interface CustomPageOptions {
     /** Trim width in points (72pt = 1in). */
     width: number;
     /** Trim height in points (72pt = 1in). */
     height: number;
-    /** Allowed deviation in points when validating a built PDF. Default 0.5. */
-    tolerance?: number;
 }
 /** A page size in points. */
 export interface PageSizePoints {
     width: number;
     height: number;
 }
-/** What an author picks: a preset, plus the trim when the preset is `custom`. */
+/** What an author picks for the size: a preset, and the trim when the preset is `custom`. */
 export interface PageSizeChoice {
     preset: PresetId;
     /** Required for `custom`; ignored for `dtrpg` / `book` (the preset owns it). */
     page?: PageSizePoints;
 }
-/** A book's page size as currently recorded, read back for the settings UI. */
+/**
+ * A change to a book's page geometry: the size, the margins, or both. A part
+ * left out stays as recorded, so a margin edit never rewrites the size (nor
+ * drops a preset's `page:` override) and a size change never invents margins.
+ */
+export interface PageSetupChange {
+    size?: PageSizeChoice;
+    /** New margins, or null to remove `page.margin` so the stylesheets' (or the default) apply again. */
+    margins?: PageMargin | null;
+}
+/** A book's page geometry as currently recorded, read back for the settings UI. */
 export interface PageSetup {
     /** The manifest's preset (`dtrpg` when undeclared — the product default); null when unrecognised. */
     preset: PresetId | null;
-    /** The validation bounds the manifest resolves to, or null (custom with no `page:`). */
+    /** The size the book prints at and is checked against, or null (custom with no `page:`). */
     bounds: (PageSizePoints & {
         tolerance: number;
     }) | null;
-    /** What the book's stylesheets print at, or null when no plain `@page` sets a size (the book then prints at `bounds`). */
-    css: (PageSizePoints & {
-        file: string;
-    }) | null;
+    /** The margins the book prints with (points, `inside` at the binding edge). */
+    margins: PageMargin;
+    /** Where `margins` come from: the manifest's `page.margin` (the author's own), a stylesheet's `@page` (a look's design), or the engine's 1in default. */
+    marginsFrom: "manifest" | "stylesheet" | "default";
+    /** What the book prints with without `page.margin`: a stylesheet's `@page` margins or the default. Equals `marginsFrom` unless the manifest sets margins. */
+    fallbackMarginsFrom: "stylesheet" | "default";
+    /** True when `preset:` is `dtrpg` or `book` and `page.width`/`height` override its size: Details shows the preset, and choosing a size there replaces the override. */
+    presetSizeOverridden: boolean;
 }
 /**
- * Write the manifest's `page:` bounds. `tolerance` defaults to whatever the
- * block already carries, so re-sizing a book never silently resets a
- * hand-tuned tolerance. The block's other keys stay as written; a `page:`
- * that is not a map is replaced.
+ * Write the manifest's `page:` bounds. A `tolerance` an older book carries
+ * goes (the preset sets it); the block's other keys stay as written; a
+ * `page:` that is not a map is replaced.
  */
 export declare function writePageBounds(doc: Document, page: CustomPageOptions): void;
+/** Remove the bounds a preset owns and nothing else; a `page:` left empty goes too. */
+export declare function deletePageBounds(doc: Document): void;
+/** Remove the manifest's `page.margin` and nothing else; a `page:` left empty goes too. */
+export declare function deletePageMargin(doc: Document): void;
+/** Write the manifest's `page.margin`, all four edges; the block's other keys stay as written. */
+export declare function writePageMargin(doc: Document, margin: PageMargin): void;
+/** A positive point value at `keyPath` in the manifest, or undefined. */
+export declare function numberAt(doc: Document, keyPath: string[]): number | undefined;
 /** The size (points) a choice means: `custom` brings its own, the others are the preset's. */
 export declare function pageSizeForChoice(choice: PageSizeChoice): PageSizePoints;
-/** The size the LAST plain `@page { size }` in the stylesheet sets (cascade: last wins), or null. */
-export declare function readPageSizeFromCss(css: string): PageSizePoints | null;
-/**
- * Point a stylesheet's plain `@page` rule at `page`. Rewrites the existing
- * `size` declaration's value in place — comments, whitespace, other rules and
- * `!important` untouched — or, when no plain `@page` sets a size, appends a
- * minimal rule. An already-matching size leaves the text exactly as it was.
- * Throws when the CSS does not parse (it must never be half-rewritten).
- */
-export declare function setPageSizeInCss(css: string, page: PageSizePoints): string;
-/** Read a book's page size back from its manifest and stylesheets. */
+/** Read a book's page geometry back from its manifest (and, for margins it does not set, its stylesheets). */
 export declare function readPageSetup(projectDir: string): Promise<PageSetup>;
 /**
- * Change a book's page size: the manifest's `preset:` + `page:` bounds and the
- * stylesheet's `@page` size, together. Mirrors what the wizard records —
- * `dtrpg` / `book` carry their own bounds (the `page:` block's width, height
- * and tolerance are removed so they cannot shadow them; its print-area keys
- * stay), `custom` records the typed trim. Nothing is written
- * unless the whole choice validates and the stylesheet parses.
+ * Change a book's page geometry in the manifest. The size mirrors what the
+ * wizard records — `dtrpg` / `book` carry their own bounds (the `page:` block's
+ * width and height are removed so they cannot shadow them; its
+ * other keys stay), `custom` records the typed trim. The margins go to
+ * `page.margin`, validated against the size being written, else the recorded
+ * one; `margins: null` removes `page.margin`. Nothing is written unless the
+ * whole change validates.
  */
-export declare function setPageSetup(projectDir: string, choice: PageSizeChoice): Promise<PageSetup>;
+export declare function setPageSetup(projectDir: string, change: PageSetupChange): Promise<PageSetup>;

package/dist/lib/pdf-inspect.d.ts

@@ -191,6 +191,33 @@ export type UnsplittableReason = "text-transparency" | "type3-font" | "text-patt
  * XObject is an implicit save/restore).
  */
 export declare function unsplittableTextReasons(pdfBytes: Uint8Array, pages?: number[]): Promise<Map<number, UnsplittableReason>>;
+/**
+ * Of `pages` (1-based), those on which a shading pattern paints a visible
+ * area: a path filled with a `/Pattern` fill colour, or a `sh`, whose box is
+ * at least {@link SLIVER_PT} wide and tall once the clip in force is applied.
+ * Text shown in a shading pattern, a stroke with one, and a `sh` under an
+ * unbounded clip are not sized here and count as visible.
+ *
+ * The one thing this excludes (#438): a box that starts exactly on a page
+ * break and whose ink overflow (a `box-shadow` blur, an `outline`) reaches
+ * above its top edge. Chromium paints it into the PREVIOUS page as well — the
+ * whole background, clipped to that page's content box — so a repeating or
+ * conic gradient on such a box also sits, as a sliver, in the resources and
+ * content of the page before it. Its clipped area is empty in exact
+ * arithmetic (under 0.01pt when the page's content height is not a whole
+ * pixel); a RIP under the any-part-of-pixel rule renders one device row of it.
+ * Measured on the ghostscript.flatten fixture with its 1in margins: page 3's
+ * content fills page 4's 636x56px gradient box at y = 738pt, the clip's own
+ * bottom edge, and a 300dpi raster of page 3 has exactly one non-white row.
+ *
+ * Walks PDF.js's operator list as {@link unsplittableTextReasons} does, with
+ * the CTM and the clip's bounding box tracked per save/restore (a form
+ * XObject is an implicit save/restore under its `/Matrix`, inside its
+ * `/BBox`). PDF.js reports `W`/`W*` as a `clip`/`eoClip` op ahead of the
+ * path it applies to, and every path as `constructPath` with its painting
+ * operator and its bounding box.
+ */
+export declare function pagesWithVisibleShadingPaints(pdfBytes: Uint8Array, pages: number[]): Promise<number[]>;
 /**
  * Does page `pageNum` (1-based) paint anything at all? False for a page with
  * no content and for one whose operators only set state or clip. A path op

package/dist/lib/presets.d.ts

@@ -5,8 +5,10 @@ import type { ResolvedConfig } from "../schema/manifest.types";
  * book of this kind validates against when the manifest lists none. Where
  * the book is PUBLISHED is a separate concern — see ./targets.ts.
  *
- * Every preset value is overridable from the manifest, leaf by leaf
- * (resolveConfig's mergeShape; precedence cli > manifest > target > preset).
+ * Geometry, build and print values are overridable from the manifest, leaf
+ * by leaf (resolveConfig's mergeShape; precedence cli > manifest > target >
+ * preset). The check thresholds (`ink`, `validate`) are the preset's and the
+ * target's alone; a book changes a check's level in `checks:`.
  */
 export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" | "language" | "preset" | "targets" | "page"> {
     /** This preset's id: what the manifest's `preset:` names and a resolved config reports. */
@@ -43,16 +45,16 @@ export declare const DTRPG_PRESET: VendorPreset;
  * - `page`: 6in x 9in (432 x 648pt) — the common generic trade paperback trim.
  *   Authors targeting a different size still set `page.width`/`page.height`
  *   directly; this is a starting point, not a lock-in.
- * - `ink.maxTac: 400` — 400% is the physical ceiling for 4-color process ink
+ * - `ink.maxTac` 400 — 400% is the physical ceiling for 4-color process ink
  *   (100% each of C+M+Y+K), so `pdf.print.ink-coverage` effectively never
  *   fires unless the author opts into a real vendor limit.
- * - `validate.checks`: keeps the generic, vendor-agnostic PDF health checks
+ * - `checks`: keeps the generic, vendor-agnostic PDF health checks
  *   (`pdf.structure.qpdf` parses/traverses, `pdf.print.embedded-fonts` are
- *   embedded) but does NOT force `pdf.print.pdfx-markers` /
+ *   embedded) but switches off `pdf.print.pdfx-markers` /
  *   `pdf.print.pdfx-metadata` — those assert PDF/X OutputIntent/DOCINFO
- *   structure, which only applies to a PDF/X build (`--format pdfx`).
- * - `validate.pdf.forbidTransparency: false` and `assets.allowAlpha: true` —
- *   PDF/X forbids both; a plain PDF/HTML book has no such restriction.
+ *   structure, which only applies to a PDF/X build (`--format pdfx`) — and
+ *   the transparency and alpha-channel checks: PDF/X forbids both; a plain
+ *   PDF/HTML book has no such restriction.
  */
 export declare const BOOK_PRESET: VendorPreset;
 /**

package/dist/lib/printsafe.d.ts

@@ -3,6 +3,7 @@ export declare const ruleRiskyProps = "printsafe/no-risky-print-effects";
 export declare const ruleSyntax = "printsafe/syntax-error";
 export declare const rulePageContainment = "printsafe/page-containment";
 export declare const rulePreviewCannotFollow = "printsafe/preview-cannot-follow";
+export declare const rulePageSizeInStylesheet = "printsafe/page-size-in-stylesheet";
 export interface PrintSafeWarning {
     rule: string;
     severity: "error" | "warning";
@@ -11,7 +12,7 @@ export interface PrintSafeWarning {
     column: number;
 }
 export interface CheckCssOptions {
-    /** The manifest's `lint.rules`: `off` drops a rule, `warn`/`error` set its severity. */
+    /** The book's `checks` levels: `off` drops a rule, `warn`/`error` set its severity. */
     rules?: Readonly<Record<string, unknown>>;
 }
 /**

package/dist/lib/project-scaffold.d.ts

@@ -134,7 +134,7 @@ export interface AdoptFolderOptions {
 /**
  * Adopt an EXISTING folder as a gutterpress project, in place (no new subfolder).
  * Writes a `manifest.yaml` (using the folder's existing top-level `.md` files as
- * `source.files`, or scaffolding a `chapter-01.md` when there are none), copies
+ * `chapters`, or scaffolding a `chapter-01.md` when there are none), copies
  * a starter `styles/book.css`, ensures `dist/` and `extensions/npm/` are gitignored
  * (see `ensureProjectGitignore`), and optionally initialises local version history.
  *

package/dist/lib/project-templates.d.ts

@@ -22,6 +22,15 @@ export interface TemplateInfo {
     preset?: string;
     /** The `targets:` this template's manifest declares, when it has one. */
     targets?: string[];
+    /**
+     * The `page:` size (points) this template's manifest declares, when it has
+     * one. A `custom`-preset template says what size it is designed for here,
+     * and the creation flows show that size pre-filled.
+     */
+    page?: {
+        width: number;
+        height: number;
+    };
 }
 export declare const BUILT_IN_META: Record<ProjectTemplateId, {
     label: string;

package/dist/lib/remote-auth/sync-messages.d.ts

@@ -8,7 +8,7 @@ export declare const MSG_UP_TO_DATE = "Everything is in sync.";
 export declare const MSG_UP_TO_DATE_PULLED = "Everything is in sync. The latest online changes were downloaded to this computer.";
 export declare const MSG_SYNCED = "Your changes are online.";
 export declare const MSG_SYNCED_MERGED = "Your changes are online, combined with changes from the online copy.";
-export declare const MSG_OFFLINE = "Your changes are saved on this computer. gutterpress couldn't reach the online repository \u2014 try syncing again when you're back online.";
+export declare const MSG_OFFLINE = "Your changes are saved on this computer. Gutterpress couldn't reach the online repository \u2014 try syncing again when you're back online.";
 export declare const MSG_AUTH = "The online repository didn't accept the saved connection. Reconnect and try again.";
 export declare const MSG_INSECURE_TRANSPORT = "This book's online address isn't secure, so the saved connection wasn't sent \u2014 connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
 export declare const MSG_BUSY = "The online copy is changing very quickly right now. Your work is saved on this computer \u2014 try Sync again in a moment.";
@@ -21,7 +21,7 @@ export declare const MSG_BUSY = "The online copy is changing very quickly right
 export declare const MSG_HISTORY_UNREADABLE = "This book's version history can't be read, so syncing can't continue. Your writing is safe \u2014 every file is still here on this computer. Use Repair online backup (in Where your work is kept) to get history and syncing working again.";
 export declare const MSG_UNRELATED = "This book and the online copy have no history in common, so they can't be combined. Either the online address points at a different book, or this book's own history was lost and started over. Your writing is safe \u2014 every file is still here on this computer. Check the online address; if it is correct, use Repair online backup (in Where your work is kept).";
 export declare const MSG_NO_REMOTE = "This book isn't connected to an online repository yet.";
-export declare const MSG_SSH_REMOTE = "This book's online address uses SSH (git@\u2026), which gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
+export declare const MSG_SSH_REMOTE = "This book's online address uses SSH (git@\u2026), which Gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
 export declare const MSG_NO_BRANCH = "This book's version history isn't on a named branch, so it can't be synced right now.";
 /** Message recorded on the automatic pre-sync snapshot (D5 invariant).
  *  Pre-0.10.1 history carries the old spelling "Snapshot before syncing". */