gutterpress 0.11.23-alpha.3 → 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
 ```

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

@@ -160,7 +160,7 @@ one place, and chapters written afterwards get it for free.
 
 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 > Details), and the build writes them as the `@page`
+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

package/dist/api/index.js

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

@@ -1,20 +1,20 @@
 import {
   runBuild,
   splitOutPath
-} 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,
   parseFormat,
@@ -22,7 +22,7 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-5jzyw06s.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-xsrffqzt.js → cli-54xt7pjg.js}

@@ -1140,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-650pe0d1.json";
+var manifest_schema_default = "./manifest.schema-w86c1xw1.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-nnmrxyqm.js";
@@ -1161,25 +1161,25 @@ var gutterpress_viewer_default = "./gutterpress-viewer-mafsby5k.js";
 var gutterpress_agent_default = "./gutterpress-agent-d29ry3ak.js";
 
 // src/assets/templates/book/manifest.yaml
-var manifest_default = "./manifest-8afhrk30.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-d4f9q79e.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-my7mdv8j.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-gf13sjp8.yaml";
+var manifest_default4 = "./manifest-79zsgkpn.yaml";
 
 // src/assets/templates/paper/chapter-01.md
 var chapter_01_default4 = "./chapter-01-s71xrf5q.md";
@@ -1212,7 +1212,7 @@ var plugin_test_js_default = "./plugin.test.js-gxzqqfdh.tpl";
 var package_default2 = "./package-awwkt7sa.json";
 
 // src/assets/extension-templates/look/README.md
-var README_default2 = "./README-8db7btxb.md";
+var README_default2 = "./README-syg2hn83.md";
 
 // src/assets/extension-templates/look/components.yaml
 var components_default = "./components-zzqdpt3m.yaml";
@@ -1221,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-ye64p899.css";
+var tokens_default = "./tokens-n82t4k9h.css";
 
 // src/assets/extension-templates/look/styles/base.css
 var base_default = "./base-ypqh9n7f.css";
@@ -1233,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-fj09xct5.css";
+var page_rules_default = "./page-rules-ytj9p04v.css";
 
 // src/assets/extension-templates/look/styles/book.css
 var book_default = "./book-ted3tzrp.css";

package/dist/{cli-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 };