gutterpress 0.11.23-alpha.3 → 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;
@@ -126,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;
@@ -183,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
@@ -238,82 +257,6 @@ export interface GutterpressManifest {
          */
         margin?: PageMargin;
     };
-    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.
-         */
-        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;
-        };
-    };
 }
 export interface ResolvedExtensionConfig {
     /** The specifier exactly as written (pin included) — for messages and manifest edits. */
@@ -355,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;
@@ -375,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;
@@ -391,36 +340,20 @@ export interface ResolvedConfig {
         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-ye64p899.css → tokens-n82t4k9h.css}

@@ -4,20 +4,27 @@
  * OWNS
  *   `:root` custom properties, and nothing else. The palette, the type scale,
  *   the spacing scale, the measure. This is the file to edit to rebrand the
- *   look. The desktop app's Design tab lists these tokens (with every other
- *   enabled look's) and saves a book's changes to that book's own
- *   stylesheet, never to this file.
+ *   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 tab 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.
  * ======================================================================== */
 

package/dist/{validate-p2chr6hr.js → validate-r9jdz85h.js}

@@ -1,25 +1,25 @@
 import {
   executeAndReport
-} from "./cli-1h17ktsg.js";
-import"./cli-n2tsxqpn.js";
+} from "./cli-93mkaw6v.js";
+import"./cli-d9mm3vvh.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xsrffqzt.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-h4x81x97.js";
-import"./cli-t8be9yeb.js";
+import"./cli-y6d1arem.js";
+import"./cli-rqh295j9.js";
 import {
   log
-} from "./cli-s6djx4ma.js";
+} from "./cli-pspjxnc8.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-5jzyw06s.js";
+import"./cli-gnpea9dx.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.23-alpha.3",
+  "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;