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

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

@@ -1,5 +1,17 @@
 import type { LastPageMode } from "../engine/shared/synthesis";
 type CheckSeverity = "error" | "warning" | "info";
+/**
+ * What a manifest's `checks:` entry may say about one check or lint rule:
+ * `off`, or the severity its findings are reported at (`info`, `warn`,
+ * `error`). `true` / `on` switch on a check its preset leaves off, at the
+ * check's own severity; `false` is `off`. `warning` is accepted for `warn`.
+ */
+export type CheckLevelInput = "off" | "on" | "info" | "warn" | "warning" | "error" | boolean;
+/**
+ * A check's resolved level: `off`, `on` (runs at its own severity) or the
+ * severity every finding is reported at.
+ */
+export type CheckLevel = "off" | "on" | CheckSeverity;
 /**
  * The object form of an `extensions:` entry (#265) — only for an entry that
  * has to say more than its specifier. The common case is the bare string;
@@ -88,6 +100,17 @@ interface PublishSettings {
         format?: "pdf" | "html";
     };
 }
+/**
+ * Page margins in points: the space between the trim and the text on each
+ * edge. `inside` is the binding edge (the left of a right-hand page, the
+ * right of a left-hand one), `outside` the other. All four together.
+ */
+export interface PageMargin {
+    top: number;
+    bottom: number;
+    inside: number;
+    outside: number;
+}
 export interface GutterpressManifest {
     title?: string;
     authors?: string[];
@@ -115,9 +138,17 @@ export interface GutterpressManifest {
      * project's own `styles` always load after every extension.
      */
     extensions?: (string | ExtensionConfig)[];
-    source?: {
-        files?: string[] | null;
-    };
+    /**
+     * The book's markdown files, in reading order, relative to the manifest.
+     * Absent or null: every top-level `.md` file in natural order.
+     */
+    chapters?: string[] | null;
+    /**
+     * Per-check and per-rule levels, keyed by a check id
+     * (`pdf.print.image-resolution`) or a lint rule id
+     * (`printsafe/no-risky-print-effects`). A key that names nothing is ignored.
+     */
+    checks?: Record<string, CheckLevelInput>;
     pdfx?: {
         flavor?: "x1a" | "x3";
         icc?: string;
@@ -172,7 +203,6 @@ export interface GutterpressManifest {
     page?: {
         width?: number;
         height?: number;
-        tolerance?: number;
         /**
          * A bleed (pt) the page `width` x `height` ALREADY CONTAINS, on the top,
          * bottom and OUTER edges only (the binding edge has none) — how
@@ -217,82 +247,15 @@ export interface GutterpressManifest {
          * and `custom` none.
          */
         gutter?: number;
-    };
-    ink?: {
-        maxTac?: number;
-        tacTolerance?: number;
-    };
-    lint?: {
-        enabled?: boolean;
-        configPath?: string | null;
         /**
-         * Per-rule level overrides, keyed by rule id (`printsafe/*`, or a check id
-         * such as `source.accessibility.heading-order`). `off` silences the rule;
-         * `warn` / `error` set its severity. Unknown ids are ignored.
+         * Page margins (pt), the space between the trim and the text on each
+         * edge — `inside` is the binding edge, `outside` the other. Setup >
+         * Details in the app writes it. When set, the book prints with these
+         * margins and any `@page` margin in a stylesheet is overridden; left
+         * out, the stylesheets' `@page` margins apply (a look's design), else
+         * 1in. All four edges are required together.
          */
-        rules?: Record<string, "off" | "warn" | "error">;
-    };
-    validate?: {
-        enabled?: boolean;
-        checks?: Record<string, boolean | {
-            enabled?: boolean;
-            severity?: CheckSeverity;
-            options?: Record<string, unknown>;
-        }>;
-        source?: {
-            markdownlint?: string | false;
-            htmlhint?: string | false;
-            stylelint?: string | false;
-            /**
-             * Path to a CSS ownership contract (#232), or `false` to disable
-             * `source.css-ownership`. Optional — absent means no contract, so the
-             * check reports nothing. Default discovery: `.gutterpress/css-contract.yaml`
-             * (or `.yml`) in the project root. See docs/css-ownership-contract.md.
-             */
-            cssOwnership?: string | false;
-            /**
-             * @deprecated `:::name` container syntax was removed 2026-05-17 and the
-             * callout-validation check it gated was removed at the same time. This
-             * field is now a no-op kept for backward-compatible manifest parsing.
-             * Will be removed in a future major version. See
-             * docs/migrations/2026-05-removing-container-syntax.md.
-             */
-            allowedCallouts?: string[];
-        };
-        assets?: {
-            maxImageSize?: number;
-            /**
-             * @deprecated No-op. The source-image resolution check it configured
-             * read DPI metadata, which says nothing about the printed size; the
-             * build measures each placed image's printed DPI instead.
-             */
-            minImageDpi?: number;
-            /**
-             * @deprecated No-op. The source-image colour-space check it configured
-             * was removed: a PDF/X build converts every image to the output intent,
-             * and `pdf.print.color-spaces` checks the result.
-             */
-            allowedColorSpaces?: string[];
-            allowAlpha?: boolean;
-            approvedFontFiles?: string[];
-            requireFontLicense?: boolean;
-        };
-        pdf?: {
-            requireBookmarks?: boolean;
-            requireTocLinks?: boolean;
-            minImageResolution?: number;
-            forbidTransparency?: boolean;
-            requireBleed?: boolean;
-            bleedSize?: number;
-        };
-        heuristics?: {
-            maxDecorativeLayers?: number;
-            textDensityRange?: {
-                min?: number;
-                max?: number;
-            };
-            maxParagraphsPerSection?: number;
-        };
+        margin?: PageMargin;
     };
 }
 export interface ResolvedExtensionConfig {
@@ -335,9 +298,14 @@ export interface ResolvedConfig {
     styles?: string[];
     /** Enabled extensions, in manifest (= load = cascade) order. */
     extensions: ResolvedExtensionConfig[];
-    source: {
-        files: string[] | null;
-    };
+    /** The book's markdown files in reading order, or null for every top-level `.md` file. */
+    chapters: string[] | null;
+    /**
+     * Each check's or lint rule's level, merged key by key: preset, then the
+     * publish target's policy, then the manifest's `checks:`, then the CLI. An
+     * id that is absent runs at its own severity.
+     */
+    checks: Record<string, CheckLevel>;
     pdfx: {
         flavor: "x1a" | "x3";
         icc: string;
@@ -355,6 +323,7 @@ export interface ResolvedConfig {
     page: {
         width: number;
         height: number;
+        /** Allowed deviation (pt) of a built PDF's page size; the preset's, never the manifest's. */
         tolerance: number;
         /** In-sheet bleed in pt (top, bottom, outer edge; see the manifest field); absent = none. */
         bleed?: number;
@@ -364,41 +333,27 @@ export interface ResolvedConfig {
         artSafe?: number;
         /** The binding edge's inset from the trim in pt, text and art alike (see the manifest field); absent = same as `safe`. */
         gutter?: number;
+        /** The margins the book prints with, in pt (see the manifest field); absent = the stylesheets' `@page` margins, else 1in. */
+        margin?: PageMargin;
     };
     ink: {
         maxTac: number;
         tacTolerance: number;
     };
-    lint: {
-        enabled: boolean;
-        configPath: string | null;
-        rules: Record<string, "off" | "warn" | "error">;
-    };
+    /**
+     * The numbers the checks measure against. They come from the preset and
+     * the publish target (a printer's specification), not from the manifest:
+     * a book switches a check off, or changes how loudly it reports, in
+     * `checks:`.
+     */
     validate: {
-        enabled: boolean;
-        checks: Record<string, boolean | {
-            enabled?: boolean;
-            severity?: CheckSeverity;
-            options?: Record<string, unknown>;
-        }>;
-        source: {
-            markdownlint: string | false | null;
-            htmlhint: string | false | null;
-            stylelint: string | false | null;
-            cssOwnership: string | false | null;
-        };
         assets: {
+            /** Largest image file in bytes; 0 = no limit. */
             maxImageSize: number;
-            allowAlpha: boolean;
-            approvedFontFiles: string[];
-            requireFontLicense: boolean;
         };
         pdf: {
-            requireBookmarks: boolean;
-            requireTocLinks: boolean;
+            /** Lowest effective image resolution in DPI; 0 = no floor. */
             minImageResolution: number;
-            forbidTransparency: boolean;
-            requireBleed: boolean;
             bleedSize: number;
         };
         heuristics: {

package/dist/{tokens-7984461t.css → tokens-n82t4k9h.css}

@@ -3,20 +3,28 @@
  *
  * OWNS
  *   `:root` custom properties, and nothing else. The palette, the type scale,
- *   the spacing scale, the measure. This is the file a non-technical author
- *   edits to rebrand the whole book, and the file the desktop app's Design
- *   panel reads (`package.json` points `gutterpress.tokensFile` here).
+ *   the spacing scale, the measure. This is the file to edit to rebrand the
+ *   look. The desktop app's Book setup lists these tokens (the six shared
+ *   ones under Look, every one under Advanced) and saves a book's changes
+ *   to that book's own stylesheet, never to this file.
  *
  * MUST NOT CONTAIN
  *   - Any selector other than `:root`. The moment a rule here targets `h1`,
  *     "change the brand" and "change the look of a heading" stop being
- *     separable, and the Design panel starts showing settings that do not
+ *     separable, and Book setup starts showing settings that do not
  *     do what they say.
  *   - `var()` references to component tokens. Tokens flow one way: brand →
  *     component. A brand token that depends on a component token is a cycle
  *     waiting to happen.
  *   - Anything a specific book needs. Book-specific values go in book.css.
  *
+ * WHAT THE DESIGN TAB SHOWS is curated with comments. Right above one
+ * declaration: `@label Accent color` (its plain-words name), `@group Paper`
+ * (its heading), `@internal` (not shown). Right above a `:root` selector:
+ * `@group` or `@internal` for the whole block, which a declaration's own
+ * comment overrides. One `@internal` line above a block of component
+ * defaults keeps them off the tab.
+ *
  * LOADS FIRST, and therefore declares the layer order for the whole stack.
  * ======================================================================== */
 
@@ -74,13 +82,5 @@
     --{{PREFIX}}space-2: 0.5em;
     --{{PREFIX}}space-3: 1em;
     --{{PREFIX}}space-4: 1.75em;
-
-    /* -- Page geometry ------------------------------------------------- */
-    /* Consumed by page-rules.css. Kept here so trim size and margins are
-       editable next to the rest of the brand, not buried in an @page block. */
-    --{{PREFIX}}page-margin-top: 0.75in;
-    --{{PREFIX}}page-margin-outer: 0.75in;
-    --{{PREFIX}}page-margin-bottom: 0.85in;
-    --{{PREFIX}}page-margin-inner: 0.9in;
   }
 }

package/dist/{validate-0v7xw6wa.js → validate-r9jdz85h.js}

@@ -1,25 +1,25 @@
 import {
   executeAndReport
-} from "./cli-xq6djqbj.js";
-import"./cli-evg8sbht.js";
+} from "./cli-93mkaw6v.js";
+import"./cli-d9mm3vvh.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-pz4bn98t.js";
-import"./cli-2ppw6q9v.js";
+import"./cli-54xt7pjg.js";
+import"./cli-5crpmz42.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
-import"./cli-sdmv4bba.js";
-import"./cli-pwwfxdgb.js";
+import"./cli-y6d1arem.js";
+import"./cli-rqh295j9.js";
 import {
   log
-} from "./cli-aqh6brew.js";
+} from "./cli-pspjxnc8.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-kh8v4vvw.js";
+import"./cli-gnpea9dx.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.23-alpha.2",
+  "version": "0.11.23-alpha.4",
   "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/checks/asset/approved-fonts.d.ts

@@ -1,3 +0,0 @@
-import type { Check } from "../types";
-declare const check: Check;
-export default check;

package/dist/manifest-eagfhba6.yaml

@@ -1,19 +0,0 @@
-title: "{{TITLE}}"
-authors:
-  - "{{AUTHOR}}"
-language: en
-source:
-  files:
-    - chapter-01.md
-styles:
-  - styles/book.css
-# A paper prints on US Letter; for A4 set width 595 and height 842.
-page:
-  width: 612
-  height: 792
-extensions:
-  - markdown-it-sup
-  - gutterpress-math
-  # The built-in academic look. Style over it from styles/book.css.
-  - academic
-preset: book

package/dist/manifest-n1gh3qw5.yaml

@@ -1,9 +0,0 @@
-title: "{{TITLE}}"
-authors:
-  - "{{AUTHOR}}"
-source:
-  files:
-    - chapter-01.md
-styles:
-  - styles/book.css
-preset: book