gutterpress 0.11.23-alpha.3 → 0.11.23-alpha.4

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/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

@@ -10,8 +10,6 @@ export interface CustomPageOptions {
     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 {
@@ -31,7 +29,8 @@ export interface PageSizeChoice {
  */
 export interface PageSetupChange {
     size?: PageSizeChoice;
-    margins?: PageMargin;
+    /** 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 {
@@ -45,16 +44,21 @@ export interface PageSetup {
     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. */
@@ -66,9 +70,10 @@ export declare function readPageSetup(projectDir: string): Promise<PageSetup>;
 /**
  * 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, height and tolerance are removed so they cannot shadow them; its
+ * 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. Nothing is written unless the whole change validates.
+ * one; `margins: null` removes `page.margin`. Nothing is written unless the
+ * whole change validates.
  */
 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

@@ -12,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/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". */

package/dist/lib/targets.d.ts

@@ -22,8 +22,8 @@ import { type VendorPreset } from "./presets";
 export type TargetOverlay = {
     pdfx?: Partial<ResolvedConfig["pdfx"]>;
     ink?: Partial<ResolvedConfig["ink"]>;
+    checks?: ResolvedConfig["checks"];
     validate?: {
-        checks?: ResolvedConfig["validate"]["checks"];
         assets?: Partial<ResolvedConfig["validate"]["assets"]>;
         pdf?: Partial<ResolvedConfig["validate"]["pdf"]>;
     };
@@ -72,9 +72,9 @@ export declare function resolveTargets(requested: readonly string[] | undefined,
 export declare function overlayPreset(preset: VendorPreset, target: PublishTarget): VendorPreset;
 /**
  * The strict-PDF fill-ins applied to EVERY post-build PDF validation
- * regardless of preset/target: any of these left `undefined` by the config
- * becomes an error-severity check, without overwriting an author's explicit
- * choice (including an explicit disable).
+ * regardless of preset/target: any of these the config leaves unset reports
+ * at error severity, without overwriting an author's explicit level
+ * (including `off`).
  */
 export declare const DEFAULT_STRICT_PDF_CHECKS: readonly ["pdf.structure.qpdf", "pdf.print.pdfx-markers", "pdf.print.pdfx-metadata", "pdf.print.embedded-fonts"];
 export declare function applyDefaultPdfStrictChecks(config: ResolvedConfig): ResolvedConfig;

package/dist/lib/validation-exec.d.ts

@@ -28,10 +28,10 @@ export interface ValidationExecutionArgs {
     pluginStylePaths?: string[];
     /**
      * Disable the `source.stylelint` check (CSS print-safety) for this run
-     * only, without touching the manifest's `validate.source.stylelint`
-     * setting on disk (#272 — one CSS gate, not two). Set by the build
-     * pipeline's `runQualityGates` (build-runner.ts) from `--skip-lint` /
-     * `config.lint.enabled: false`, so that flag disables just this one check.
+     * only, without touching the manifest's `checks:` on disk (#272 — one CSS
+     * gate, not two). Set by the build pipeline's `runQualityGates`
+     * (build-runner.ts) from `--skip-lint`, so that flag disables just this
+     * one check.
      * Every other caller (`gutterpress validate`/`preflight`, the desktop
      * Problems panel) leaves this unset and gets the manifest's own setting.
      */

package/dist/{manifest-my7mdv8j.yaml → manifest-2kc56wvw.yaml}

@@ -1,16 +1,15 @@
 title: "{{TITLE}}"
 authors:
   - "{{AUTHOR}}"
-source:
-  files:
-    - chapter-01.md
+chapters:
+  - chapter-01.md
 styles:
   - styles/book.css
 extensions:
   - technical-doc
 # Page size and margins in points (72 = 1 in): US Letter (8.5 x 11 in) with
 # 0.9 in top and bottom and 1 in side margins; text stays 0.25 in (18) inside
-# the trim. Change them under Setup > Details.
+# the trim. Change them under Setup > Book.
 page:
   width: 612
   height: 792

package/dist/{manifest-8afhrk30.yaml → manifest-41ddzm13.yaml}

@@ -1,15 +1,14 @@
 title: "{{TITLE}}"
 authors:
   - "{{AUTHOR}}"
-source:
-  files:
-    - chapter-01.md
+chapters:
+  - chapter-01.md
 styles:
   - styles/book.css
 extensions:
   - clean-book
 # Page margins in points (72 = 1 in): top, bottom, inside (the binding edge)
-# and outside. Change them, and the page size, under Setup > Details.
+# and outside. Change them, and the page size, under Setup > Book.
 page:
   margin:
     top: 61.2

package/dist/{manifest-gf13sjp8.yaml → manifest-79zsgkpn.yaml}

@@ -2,14 +2,13 @@ title: "{{TITLE}}"
 authors:
   - "{{AUTHOR}}"
 language: en
-source:
-  files:
-    - chapter-01.md
+chapters:
+  - chapter-01.md
 styles:
   - styles/book.css
 # Page size and margins in points (72 = 1 in): US Letter with 1 in margins
 # (A4 is width 595, height 842); text stays 0.25 in (18) inside the trim.
-# Change them under Setup > Details.
+# Change them under Setup > Book.
 page:
   width: 612
   height: 792

package/dist/{manifest-d4f9q79e.yaml → manifest-sqzm4681.yaml}

@@ -1,16 +1,15 @@
 title: "{{TITLE}}"
 authors:
   - "{{AUTHOR}}"
-source:
-  files:
-    - chapter-01.md
+chapters:
+  - chapter-01.md
 styles:
   - styles/book.css
 extensions:
   - zine
 # Page size and margins in points (72 = 1 in): Digest (5.5 x 8.5 in) with
 # 0.4 in margins; text stays 0.25 in (18) inside the trim. Change them under
-# Setup > Details.
+# Setup > Book.
 page:
   width: 396
   height: 612