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

package/README.md

@@ -90,7 +90,7 @@ A Gutterpress project is a directory. The CLI doesn't impose much structure; the
 my-book/
 ├─ manifest.yaml      ← optional but recommended; metadata + config
 ├─ chapter-01.md      ← markdown files, processed in alphabetical order
-├─ chapter-02.md         (or in the order listed in manifest.yaml#source.files)
+├─ chapter-02.md         (or in the order listed in manifest.yaml#chapters)
 ├─ css/               ← your stylesheets
 │  └─ print.css
 └─ images/            ← images referenced from markdown or CSS
@@ -123,10 +123,9 @@ preset: dtrpg
 styles:
   - css/print.css
 
-source:
-  files:
-    - chapter-01.md
-    - chapter-02.md
+chapters:
+  - chapter-01.md
+  - chapter-02.md
 ```
 
 The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`. See the [configuration reference](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/01-getting-started.md#manifest-configuration) for details.
@@ -163,7 +162,6 @@ gutterpress new <name> [--kind <id>] [options]
   --targets <ids>          Publish targets recorded in the manifest (comma-separated: dtrpg, itch; or "none") — default: the preset's
   --page-width <pt>        Trim width in points, 72pt = 1in (required with --preset custom; optional override otherwise)
   --page-height <pt>       Trim height in points, 72pt = 1in (required with --preset custom; optional override otherwise)
-  --page-tolerance <pt>    Allowed trim deviation when validating a built PDF (default: 0.5)
   --git                    Initialise local version history (default: true; use --no-git to skip)
   --no-git
 ```
@@ -363,7 +361,7 @@ List, add, remove, enable, or disable the project's extensions. Markdown-it
 plugins, looks (stylesheets) and component libraries are all extensions — one
 `extensions:` list in `manifest.yaml`, in load order (see
 [Extensions](#extensions) below). These are the same shared-lib functions the
-desktop app's Look and Features views call, so an extension added from the
+desktop app's Extensions tab calls, so an extension added from the
 terminal is the same entry the GUI shows.
 
 ```sh
@@ -460,7 +458,7 @@ never touched.
 
 ```sh
 gutterpress ext remove markdown-it-highlightjs ./my-book
-gutterpress ext remove ./extensions/zine ./my-book
+gutterpress ext remove zine ./my-book
 ```
 
 #### `gutterpress ext enable` / `gutterpress ext disable`
@@ -475,8 +473,8 @@ gutterpress ext enable markdown-it-mark ./my-book
 
 #### `gutterpress ext search`
 
-Search **npm** for extensions — the same list the desktop app's Features view
-shows under "Find more on npm." Not project-scoped (no `dir` argument): it
+Search **npm** for extensions — the same list the desktop app's Extensions tab
+shows under *Search*. Not project-scoped (no `dir` argument): it
 queries the registry for packages tagged `gutterpress` (Gutterpress
 extensions: plugins, looks, component libraries) or `markdown-it-plugin` (the
 markdown-it ecosystem's own tag — those work in Gutterpress unchanged), and
@@ -521,7 +519,7 @@ extensions:
   # a feature bundled with Gutterpress — nothing to install, works offline
   - markdown-it-mark
   # a folder or plugin file, relative to manifest.yaml — referenced in place
-  - ./extensions/clean-book
+  - ./extensions/house-look
   - ./plugins/my-custom-plugin.js
   # an npm package, pinned to the exact version `gutterpress ext add` installed
   - markdown-it-highlightjs@4.3.0
@@ -547,8 +545,7 @@ An extension folder (or npm package) describes itself in its **`package.json`**
   "gutterpress": {
     "styles": ["styles/plugin.css"],
     "snippets": "snippets",
-    "components": "components.yaml",
-    "tokensFile": "styles/tokens.css"
+    "components": "components.yaml"
   }
 }
 ```

package/dist/{README-8ef336pp.md → README-syg2hn83.md}

@@ -17,7 +17,7 @@ arrangement of the files is the part worth keeping.
     ├── base.css              element baseline. Bare p/h2/table/code.
     ├── components.css        named components + their public tokens.
     ├── page-templates.css    .page.* layouts — arrangement WITHIN a page.
-    ├── page-rules.css        @page geometry, margin boxes, running heads.
+    ├── page-rules.css        @page margin boxes, running heads, named pages.
     └── book.css              this book's overrides. Loads last.
 ```
 
@@ -64,7 +64,7 @@ instantly: **where does this rule go?**
 | what a plain paragraph or table looks like | `base.css` |
 | a named thing an author opts into | `components.css` |
 | how one page arranges its content | `page-templates.css` |
-| margins, folios, running heads | `page-rules.css` |
+| folios, running heads, named pages | `page-rules.css` |
 | one chapter of one book | `book.css` |
 
 If a rule seems to belong in two of them, it is usually two rules.
@@ -156,23 +156,17 @@ author retypes must be found and replaced across every chapter when it
 changes. A variant expressed as a component name plus a CSS rule changes in
 one place, and chapters written afterwards get it for free.
 
-### 4. `@page { size }` is not optional, and it must match the manifest
-
-`page-rules.css` opens by declaring the trim:
-
-```css
-@page { size: 6in 9in; }
-```
-
-That line is load-bearing in the most literal sense. With no `size:` anywhere
-in the book's CSS, Chromium falls back to US Letter and prints the whole book
-at the wrong trim, with no error — this is the one failure in the stack that
-costs money rather than time.
-
-The manifest's `preset:`/`page:` remains the source of truth: it is what
-`gutterpress validate` measures the produced PDF against, and what the publish
-targets check. The CSS line is the instruction that satisfies it. Change one,
-change the other — and let validate catch you when you forget.
+### 4. The page size and margins are the book's, not the look's
+
+A look never declares `@page { size }` or `@page { margin }`. The book's
+manifest records both (`preset:`, `page: width / height / margin`, which the
+app edits under Setup > Book), and the build writes them as the `@page`
+rule after every stylesheet, so a `size` in a look is ignored and reported by
+the print-safety check, and a `margin` holds only until the author sets
+margins in the app. `page-rules.css` owns what IS a look's: the margin boxes
+(folios, running heads) and the named pages. Design them to sit in whatever
+margin the book gives them — a folio at `@bottom-right` needs no particular
+margin to work.
 
 ### 5. Keep the catalog honest
 

package/dist/api/index.d.ts

@@ -52,7 +52,7 @@ export type { ProjectStyle } from "../lib/style-resolver.ts";
 export { readManifestFields, setManifestFields, setActiveStyles, } from "../lib/manifest-config.ts";
 export type { ProjectConfigFields } from "../lib/manifest-config.ts";
 export { readPageSetup, setPageSetup } from "../lib/page-size.ts";
-export type { PageSetup, PageSizeChoice, PageSizePoints } from "../lib/page-size.ts";
+export type { PageMargin, PageSetup, PageSetupChange, PageSizeChoice, PageSizePoints } from "../lib/page-size.ts";
 export { providerFor, restoreVersionWithBackup, isNoChangesError, countUnversionedChanges, whenGitIdle, AUTO_SNAPSHOT_MESSAGE, RESTORE_BACKUP_MESSAGE, HISTORY_PAGE_LIMIT, listLocalBranches, switchBranch, SWITCH_BRANCH_SNAPSHOT_MESSAGE, } from "../lib/source-provider.ts";
 export type { ListHistoryOptions, HistoryPage, UnversionedChanges, LocalBranches, SwitchBranchOptions, SwitchBranchResult, } from "../lib/source-provider.ts";
 export { describeVersions, listOnlineVersions, compareVersionFile, exportVersionTree, VERSION_CHANGES_SHOWN, } from "../lib/version-changes.ts";

package/dist/api/index.js

@@ -101,7 +101,7 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "../index-j5z86r4a.js";
+} from "../index-ea94zbq4.js";
 import {
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
@@ -130,7 +130,7 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "../index-x3ema2w3.js";
+} from "../index-kaks3mm2.js";
 import {
   BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
@@ -145,13 +145,13 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "../index-2bjcghze.js";
+} from "../index-8ywkd2sv.js";
 import"../index-ht1bcqdd.js";
-import"../index-0skhjx3e.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/{build-encgnv0c.js → build-c48eer6f.js}

@@ -1,20 +1,20 @@
 import {
   runBuild,
   splitOutPath
-} 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,
   parseFormat,
@@ -22,7 +22,7 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-kh8v4vvw.js";
+import"./cli-gnpea9dx.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/checks/asset/extensions.d.ts

@@ -28,7 +28,7 @@ export declare const ALL_IMAGE_EXTS: readonly ["png", "jpg", "jpeg", "tiff", "ti
  * the run has no book to resolve them from (a `--pdf`-only run).
  */
 export declare function shippedImages(ctx: CheckContext, exts: readonly string[]): string[];
-/** Font file extensions shared by the approved-fonts and font-license checks. */
+/** Font file extensions the font-license check looks for. */
 export declare const FONT_EXTS: readonly ["woff", "woff2", "otf", "ttf", "eot"];
 /**
  * Directories no asset scan should ever descend into, as glob patterns.

package/dist/checks/asset/index.d.ts

@@ -1,4 +1,3 @@
 import "./image-file-size";
 import "./image-alpha";
-import "./approved-fonts";
 import "./font-license";

package/dist/checks/policy.d.ts

@@ -11,10 +11,11 @@ export declare const INSPECT_FAILED_CODE = "inspect-failed";
  * Used by BOTH the runner (execution) and tool-check (tool probing) so the two
  * can never drift.
  *
- * Order: an explicit manifest disable wins first, then the check's own
- * declarative `enabledWhen(config)` predicate — the canonical, per-check way to
- * express a tool-specific config gate (e.g. `source.stylelint === false`)
- * instead of hard-coding special cases in the runner/tool-check.
+ * Order: a check's level `off` (preset, target, `checks:` or the CLI) wins
+ * first, then the check's own declarative `enabledWhen(config)` predicate —
+ * the canonical, per-check way to express a build-setting gate (e.g.
+ * `print.signature > 1`) instead of hard-coding special cases in the
+ * runner/tool-check.
  */
 export declare function isCheckEnabled(check: Check, config: ResolvedConfig): boolean;
 /** Selector inputs shared by check execution and tool probing. */

package/dist/checks/source/config-file.d.ts

@@ -1,8 +1,11 @@
 /**
- * Locate a lint config file for a source check. An explicit relative path
- * (from the check's manifest config) wins when it exists; otherwise the first
- * of `names` found in the input dir is used. Returns null when nothing
- * matches. Shared by the markdownlint and htmlhint wrappers so their
- * config-discovery rules can never drift.
+ * Locate a lint config file for a source check by its usual name: the first
+ * of `names` in the book's folder, else in the folder above, and so on up to
+ * the repository the book lives in (the nearest folder with a `.git`), or the
+ * filesystem root when there is none. A book inside a larger repository
+ * therefore uses the repository's own `.markdownlint.jsonc`, as the linters'
+ * own command-line tools do. Returns null when nothing matches. Shared by the
+ * markdownlint, htmlhint and CSS-ownership checks so their config discovery
+ * can never drift.
  */
-export declare function findConfigFile(inputDir: string, names: readonly string[], explicit?: string | null): string | null;
+export declare function findConfigFile(startDir: string, names: readonly string[]): string | null;

package/dist/checks/source/dangling-links.d.ts

@@ -12,7 +12,7 @@ import type { Check } from "../types";
  * `source.links.local-refs` answers a different question — does the target
  * exist on disk — and a link can pass that while still being unopenable from
  * a PDF, which is why this is its own check (and can be switched off for an
- * HTML-only book via `validate.checks`).
+ * HTML-only book via `checks:` in the manifest).
  */
 declare const check: Check;
 export default check;

package/dist/checks/types.d.ts

@@ -55,8 +55,8 @@ export interface Check {
     requiredTools?: string[];
     /**
      * Declarative enable gate driven by config (beyond the generic
-     * `validate.checks[id]` enable/disable). Lets a check own a tool-specific
-     * config switch — e.g. `source.stylelint === false` — so the runner and
+     * `checks: { <id>: off }`). Lets a check run only when a build setting it
+     * depends on is in effect — e.g. `print.signature > 1` — so the runner and
      * tool-check never need per-check special cases. Returning `false` disables
      * the check for enablement/tool-probing purposes.
      */

package/dist/{cli-pz4bn98t.js → cli-54xt7pjg.js}

@@ -530,12 +530,18 @@ function parseMargin(value) {
   const d = parts[3] ?? b;
   return { top: a, right: b, bottom: c, left: d };
 }
+var DEFAULT_PAGE_MARGIN_PT = 72;
 function resolvePage(model, ctx = {}) {
   const wanted = new Set(ctx.pseudos ?? []);
   const applicable = model.pageRules.filter((r) => r.name ? r.name === ctx.name : true).filter((r) => r.pseudos.every((p) => wanted.has(p))).sort((a, b) => specificity(a) - specificity(b));
   const decls = {};
   const marginBoxes = {};
-  const margin = { top: 72, right: 72, bottom: 72, left: 72 };
+  const margin = {
+    top: DEFAULT_PAGE_MARGIN_PT,
+    right: DEFAULT_PAGE_MARGIN_PT,
+    bottom: DEFAULT_PAGE_MARGIN_PT,
+    left: DEFAULT_PAGE_MARGIN_PT
+  };
   for (const rule of applicable) {
     for (const [prop, value] of Object.entries(rule.decls)) {
       if (prop === "margin")
@@ -1134,7 +1140,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-t7nx2stg.json";
+var manifest_schema_default = "./manifest.schema-w86c1xw1.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-nnmrxyqm.js";
@@ -1149,31 +1155,31 @@ var preview_shell_default = "./preview-shell-wk9k3gcd.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-701vf4qp.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-mafsby5k.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-d29ry3ak.js";
 
 // src/assets/templates/book/manifest.yaml
-var manifest_default = "./manifest-n1gh3qw5.yaml";
+var manifest_default = "./manifest-41ddzm13.yaml";
 
 // src/assets/templates/book/chapter-01.md
 var chapter_01_default = "./chapter-01-gsbjt584.md";
 
 // src/assets/templates/zine/manifest.yaml
-var manifest_default2 = "./manifest-n1gh3qw5.yaml";
+var manifest_default2 = "./manifest-sqzm4681.yaml";
 
 // src/assets/templates/zine/chapter-01.md
 var chapter_01_default2 = "./chapter-01-wgjfz4w6.md";
 
 // src/assets/templates/technical/manifest.yaml
-var manifest_default3 = "./manifest-n1gh3qw5.yaml";
+var manifest_default3 = "./manifest-2kc56wvw.yaml";
 
 // src/assets/templates/technical/chapter-01.md
 var chapter_01_default3 = "./chapter-01-6fn9pvd0.md";
 
 // src/assets/templates/paper/manifest.yaml
-var manifest_default4 = "./manifest-eagfhba6.yaml";
+var manifest_default4 = "./manifest-79zsgkpn.yaml";
 
 // src/assets/templates/paper/chapter-01.md
 var chapter_01_default4 = "./chapter-01-s71xrf5q.md";
@@ -1200,13 +1206,13 @@ var fixture_default = "./fixture-2qnyqgb5.md";
 var expected_default = "./expected-ycmacem8.html";
 
 // src/assets/extension-templates/plugin/test/plugin.test.js.tpl
-var plugin_test_js_default = "./plugin.test.js-xgxrd8hf.tpl";
+var plugin_test_js_default = "./plugin.test.js-gxzqqfdh.tpl";
 
 // src/assets/extension-templates/look/package.json
-var package_default2 = "./package-aenwjew3.json";
+var package_default2 = "./package-awwkt7sa.json";
 
 // src/assets/extension-templates/look/README.md
-var README_default2 = "./README-8ef336pp.md";
+var README_default2 = "./README-syg2hn83.md";
 
 // src/assets/extension-templates/look/components.yaml
 var components_default = "./components-zzqdpt3m.yaml";
@@ -1215,7 +1221,7 @@ var components_default = "./components-zzqdpt3m.yaml";
 var callout_default = "./callout-hv56m16h.md";
 
 // src/assets/extension-templates/look/styles/tokens.css
-var tokens_default = "./tokens-7984461t.css";
+var tokens_default = "./tokens-n82t4k9h.css";
 
 // src/assets/extension-templates/look/styles/base.css
 var base_default = "./base-ypqh9n7f.css";
@@ -1227,7 +1233,7 @@ var components_default2 = "./components-aam0fe2z.css";
 var page_templates_default = "./page-templates-tx9ryt19.css";
 
 // src/assets/extension-templates/look/styles/page-rules.css
-var page_rules_default = "./page-rules-nsj3aw42.css";
+var page_rules_default = "./page-rules-ytj9p04v.css";
 
 // src/assets/extension-templates/look/styles/book.css
 var book_default = "./book-ted3tzrp.css";
@@ -2679,4 +2685,4 @@ ${lines.length ? lines.join(`
 `);
 }
 
-export { lastPageMode, extract, resolvePage, getAssetPath, MARGIN_BOX_IGNORED_PROPERTIES, build };
+export { lastPageMode, DEFAULT_PAGE_MARGIN_PT, getAssetPath, MARGIN_BOX_IGNORED_PROPERTIES, build };

package/dist/{index-2ppw6q9v.js → cli-5crpmz42.js}

@@ -348,6 +348,85 @@ async function unsplittableTextReasons(pdfBytes, pages) {
   }
   return reasons;
 }
+var FILL_PAINT_OPS = opSet(["fill", "eoFill", "fillStroke", "eoFillStroke", "closeFillStroke", "closeEOFillStroke"]);
+var STROKE_PAINT_OPS = opSet(["stroke", "closeStroke", "fillStroke", "eoFillStroke", "closeFillStroke", "closeEOFillStroke"]);
+var SLIVER_PT = 0.25;
+async function pagesWithVisibleShadingPaints(pdfBytes, pages) {
+  const box = (b, m) => {
+    const xs = [];
+    const ys = [];
+    const corners = [[b[0], b[1]], [b[2], b[1]], [b[2], b[3]], [b[0], b[3]]];
+    for (const [x, y] of corners) {
+      xs.push(m[0] * x + m[2] * y + m[4]);
+      ys.push(m[1] * x + m[3] * y + m[5]);
+    }
+    return [Math.min(...xs), Math.min(...ys), Math.max(...xs), Math.max(...ys)];
+  };
+  const intersect = (a, b) => a ? [Math.max(a[0], b[0]), Math.max(a[1], b[1]), Math.min(a[2], b[2]), Math.min(a[3], b[3])] : b;
+  const visible = (b) => !b || b[2] - b[0] >= SLIVER_PT && b[3] - b[1] >= SLIVER_PT;
+  const doc = await getDocumentProxy(new Uint8Array(pdfBytes));
+  const out = [];
+  try {
+    for (const i of pages) {
+      const ops = await (await doc.getPage(i)).getOperatorList();
+      let ctm = [1, 0, 0, 1, 0, 0];
+      let clip = null;
+      let fillShading = false;
+      let strokeShading = false;
+      let pendingClip = false;
+      const stack = [];
+      let found = false;
+      for (let j = 0;j < ops.fnArray.length && !found; j++) {
+        const fn = ops.fnArray[j];
+        const args = ops.argsArray[j];
+        if (fn === OPS.save)
+          stack.push([ctm, clip, fillShading, strokeShading]);
+        else if (fn === OPS.restore || fn === OPS.paintFormXObjectEnd) {
+          const saved = stack.pop();
+          if (saved)
+            [ctm, clip, fillShading, strokeShading] = saved;
+        } else if (fn === OPS.transform)
+          ctm = multiply(ctm, args);
+        else if (fn === OPS.paintFormXObjectBegin) {
+          stack.push([ctm, clip, fillShading, strokeShading]);
+          if (Array.isArray(args[0]))
+            ctm = multiply(ctm, args[0]);
+          if (Array.isArray(args[1]))
+            clip = intersect(clip, box(args[1], ctm));
+        } else if (fn === OPS.setFillColorN)
+          fillShading = args[0] === "Shading";
+        else if (fn === OPS.setStrokeColorN)
+          strokeShading = args[0] === "Shading";
+        else if (FILL_COLOR_OPS.has(fn))
+          fillShading = false;
+        else if (STROKE_COLOR_OPS.has(fn))
+          strokeShading = false;
+        else if (fn === OPS.clip || fn === OPS.eoClip)
+          pendingClip = true;
+        else if (fn === OPS.constructPath) {
+          const paintOp = args[0];
+          const bounds = args[2] ? box(args[2], ctm) : null;
+          if (fillShading && FILL_PAINT_OPS.has(paintOp) && bounds)
+            found = visible(intersect(clip, bounds));
+          if (strokeShading && STROKE_PAINT_OPS.has(paintOp))
+            found = true;
+          if (pendingClip) {
+            clip = bounds ? intersect(clip, bounds) : [0, 0, 0, 0];
+            pendingClip = false;
+          }
+        } else if (fn === OPS.shadingFill)
+          found = visible(clip);
+        else if (SHOW_TEXT_OPS.has(fn) && fillShading)
+          found = true;
+      }
+      if (found)
+        out.push(i);
+    }
+  } finally {
+    await doc.destroy();
+  }
+  return out;
+}
 function getImagePixelSize(page, name, timeoutMs = 2000) {
   return new Promise((resolve) => {
     let done = false;
@@ -435,4 +514,4 @@ async function isLoadable(doc) {
   }
 }
 
-export { DOC_CACHE_MAX, loadPdf, retainPdfCache, clearPdfCache, pendingGraceDestroyCount, getPageSize, getOutlineCount, getPageLabels, countLinkAnnotations, getTextPass, getOpPass, unsplittableTextReasons, pageHasMarks, getImageResolutions, isLoadable };
+export { DOC_CACHE_MAX, loadPdf, retainPdfCache, clearPdfCache, pendingGraceDestroyCount, getPageSize, getOutlineCount, getPageLabels, countLinkAnnotations, getTextPass, getOpPass, unsplittableTextReasons, pagesWithVisibleShadingPaints, pageHasMarks, getImageResolutions, isLoadable };