gutterpress 0.0.0

package/dist/lint-f63nxjfj.js

@@ -0,0 +1,65 @@
+import {
+  MANIFEST_FILENAMES,
+  runLint
+} from "./cli-7ykx7pp0.js";
+import {
+  log
+} from "./cli-h7phg3ka.js";
+import {
+  EXIT_CODES,
+  UsageError,
+  rejectExtraPositionals,
+  rejectUnknownFlags
+} from "./cli-hvqjs342.js";
+import"./cli-5bxx0c4y.js";
+import"./cli-1tyj4bk3.js";
+import"./cli-yja077f6.js";
+import"./cli-37x76zdn.js";
+
+// src/commands/lint.ts
+import { defineCommand } from "citty";
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+var commandArgs = {
+  files: {
+    type: "positional",
+    description: "Project directory with manifest.yaml, or glob pattern for CSS files to lint",
+    required: false
+  },
+  manifest: {
+    type: "string",
+    description: "Path to manifest.yaml"
+  }
+};
+var lint_default = defineCommand({
+  meta: {
+    name: "lint",
+    description: "Lint CSS for print-safety issues"
+  },
+  args: commandArgs,
+  async run({ args, rawArgs }) {
+    try {
+      rejectUnknownFlags(rawArgs, commandArgs, "lint");
+      rejectExtraPositionals(args._, 1, "lint");
+      const filesArg = typeof args.files === "string" ? args.files : undefined;
+      const manifestArg = typeof args.manifest === "string" ? args.manifest : undefined;
+      const filesArgIsManifestDir = filesArg && existsSync(filesArg) && statSync(filesArg).isDirectory() && MANIFEST_FILENAMES.some((name) => existsSync(join(filesArg, name)));
+      const result = await runLint({
+        files: filesArgIsManifestDir ? undefined : filesArg,
+        manifest: manifestArg ?? (filesArgIsManifestDir ? filesArg : undefined)
+      });
+      if (!result.ok) {
+        process.exit(EXIT_CODES.FINDINGS);
+      }
+    } catch (error) {
+      if (error instanceof UsageError) {
+        log.error(error.message);
+        process.exit(error.exitCode);
+      }
+      throw error;
+    }
+  }
+});
+export {
+  lint_default as default
+};

package/dist/manifest-n1gh3qw5.yaml

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

package/dist/manifest-ryyg71nf.yaml

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

package/dist/manifest.schema-rn1dpdpn.json

@@ -0,0 +1,564 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/dimm-city/gutterpress/manifest.schema.json",
+  "title": "Gutterpress Manifest",
+  "description": "Configuration file for Gutterpress markdown-to-PDF converter. Mirrors the GutterpressManifest interface in packages/cli/src/schema/manifest.types.ts. Every field is optional — an absent field falls back to the resolved preset default (see packages/cli/src/lib/presets.ts).",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Document title. Used for the HTML <title> and PDF metadata.",
+      "default": "Document",
+      "examples": ["My Book Title", "Technical Documentation", "Game Module"]
+    },
+    "authors": {
+      "type": "array",
+      "description": "List of document authors.",
+      "default": [],
+      "items": {
+        "type": "string"
+      },
+      "examples": [
+        ["John Doe"],
+        ["Jane Smith", "John Doe"]
+      ]
+    },
+    "preset": {
+      "type": "string",
+      "description": "Vendor preset supplying the defaults for every other section (page geometry, ink limits, PDF/X settings, validation checks). Omitting it defaults to \"dtrpg\" for backward compatibility and logs a warning — set it explicitly.",
+      "enum": ["dtrpg", "book"],
+      "examples": ["dtrpg", "book"]
+    },
+    "styles": {
+      "type": "array",
+      "description": "Project-relative CSS files to <link> into the rendered book, applied in order. If omitted, Gutterpress discovers one: styles/book.css, else css/print.css, css/index.css, css/style.css, css/main.css, else the first discovered .css, else none.",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "description": "Path to a CSS file, relative to the manifest directory."
+      },
+      "examples": [
+        ["styles/book.css"],
+        ["css/index.css"],
+        ["themes/parchment.css", "styles/override.css"]
+      ]
+    },
+    "plugins": {
+      "type": "array",
+      "description": "markdown-it plugins to load. Each entry is either a shorthand string or a configuration object. Entries are loaded highest-priority first.",
+      "default": [],
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "minLength": 1,
+            "description": "Shorthand. Treated as a local file path when it starts with ./, ../, / or a Windows drive letter, or when it contains a path separator and ends in .js/.mjs/.cjs. Otherwise treated as an npm package name.",
+            "examples": [
+              "./plugins/my-plugin.js",
+              "plugins/my-plugin.js",
+              "gutterpress-plugin-callouts"
+            ]
+          },
+          {
+            "type": "object",
+            "description": "Plugin configuration object. Supply either `path` (local file) or `name` (npm package).",
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Path to a local plugin module, relative to the manifest directory.",
+                "examples": ["plugins/dimm-city-plugin.js", "../shared/plugins/callouts.js"]
+              },
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "npm package name of the plugin.",
+                "examples": ["gutterpress-plugin-callouts"]
+              },
+              "version": {
+                "type": "string",
+                "description": "Exact npm version installed under plugins/npm by Gutterpress. Legacy non-exact values remain informational and use legacy node_modules resolution.",
+                "examples": ["1.2.3", "2.1.0-beta.1"]
+              },
+              "export": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Named module export to use as the markdown-it plugin function when the package has no default export.",
+                "examples": ["full"]
+              },
+              "priority": {
+                "type": "integer",
+                "description": "Load order. Higher priority loads first.",
+                "default": 100,
+                "examples": [100, 200]
+              },
+              "options": {
+                "type": "object",
+                "description": "Plugin-specific options, passed straight through to the plugin.",
+                "default": {},
+                "additionalProperties": true
+              },
+              "enabled": {
+                "type": "boolean",
+                "description": "Per-project enable flag. Absent or true = active. false keeps the entry in the manifest (so the toggle is reversible) but skips loading it at build and preview time.",
+                "default": true
+              }
+            }
+          }
+        ]
+      },
+      "examples": [
+        ["gutterpress-plugin-callouts", "./plugins/my-plugin.js"],
+        [
+          {
+            "path": "plugins/dimm-city-plugin.js",
+            "priority": 100
+          }
+        ]
+      ]
+    },
+    "source": {
+      "type": "object",
+      "description": "Where the book's content comes from. There is no `assets` list: the build discovers every file the book actually references (image src, CSS url()/@font-face, …) and copies exactly those — see lib/asset-inline.ts. An author-maintained asset directory list could drift from what the book uses; this can't.",
+      "properties": {
+        "files": {
+          "type": ["array", "null"],
+          "description": "Explicit, ordered list of markdown files to concatenate, relative to the manifest directory. Omit or set to null to include every .md file in the directory in alphabetical order.",
+          "default": null,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "examples": [
+            ["chapter-01.md", "chapter-02.md"],
+            ["frontmatter/title.md", "chapters/intro.md", "appendix.md"]
+          ]
+        }
+      }
+    },
+    "pdfx": {
+      "type": "object",
+      "description": "PDF/X conversion settings, used by `gutterpress build --format pdfx`.",
+      "properties": {
+        "flavor": {
+          "type": "string",
+          "description": "PDF/X flavor to target.",
+          "enum": ["x1a", "x3"],
+          "default": "x1a"
+        },
+        "icc": {
+          "type": "string",
+          "description": "Path to the ICC output-intent profile, relative to the manifest directory.",
+          "default": "profiles/CGATS21_CRPC1.icc",
+          "examples": ["profiles/CGATS21_CRPC1.icc", ".gutterpress/profiles/CGATS21_CRPC1.icc"]
+        },
+        "stripAnnotations": {
+          "type": "boolean",
+          "description": "Strip annotations (links, comments) during PDF/X conversion — PDF/X-1a does not permit them.",
+          "default": true
+        }
+      }
+    },
+    "page": {
+      "type": "object",
+      "description": "Expected page geometry, in POINTS. VALIDATION BOUNDS ONLY — these values do NOT set the trim size. The real PDF page size comes from the CSS `@page` rule in your stylesheet; these numbers are only what the `pdf.print.page-size` check compares the produced PDF against. Set them to the trim size you expect so a CSS mistake gets caught — and note that a bleed-inclusive @page size will legitimately differ from the trim size recorded here.",
+      "properties": {
+        "width": {
+          "type": "number",
+          "description": "Expected page width in points (1in = 72pt). Validation bound only — the CSS @page rule sets the real width. Preset defaults: dtrpg 621, book 432 (6in).",
+          "exclusiveMinimum": 0,
+          "examples": [612, 621, 432]
+        },
+        "height": {
+          "type": "number",
+          "description": "Expected page height in points (1in = 72pt). Validation bound only — the CSS @page rule sets the real height. Preset defaults: dtrpg 810, book 648 (9in).",
+          "exclusiveMinimum": 0,
+          "examples": [792, 810, 648]
+        },
+        "tolerance": {
+          "type": "number",
+          "description": "Allowed deviation, in points, between the expected and the actual page size.",
+          "default": 0.5,
+          "minimum": 0
+        }
+      }
+    },
+    "ink": {
+      "type": "object",
+      "description": "Ink coverage limits used by the `pdf.print.ink-coverage` and `asset.image.tac-raster` checks.",
+      "properties": {
+        "maxTac": {
+          "type": "number",
+          "description": "Maximum total area coverage (TAC), as a percentage summed across C+M+Y+K. 400 is the physical ceiling (100% of each plate), so it effectively disables the cap. Preset defaults: dtrpg 240 (DriveThruRPG's limit), book 400.",
+          "minimum": 0,
+          "examples": [240, 300, 400]
+        },
+        "tacTolerance": {
+          "type": "number",
+          "description": "Allowed percentage of sampled pixels that may exceed `maxTac` before the check fails.",
+          "default": 0.5,
+          "minimum": 0
+        }
+      }
+    },
+    "lint": {
+      "type": "object",
+      "description": "Markdown linting run before the build.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether linting runs.",
+          "default": true
+        },
+        "configPath": {
+          "type": ["string", "null"],
+          "description": "Path to a markdownlint config file, relative to the manifest directory. null uses the built-in defaults.",
+          "default": null
+        }
+      }
+    },
+    "validate": {
+      "type": "object",
+      "description": "Preflight/validation configuration. Individual checks are addressed by id (see `checks`); the sections below supply the thresholds those checks read.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether validation runs.",
+          "default": true
+        },
+        "checks": {
+          "type": "object",
+          "description": "Per-check overrides, keyed by check id. This is an OPEN dictionary — any registered check id may appear, including ids contributed by plugins. Built-in ids are namespaced source.*, asset.*, pdf.* and heuristic.* (e.g. pdf.structure.qpdf, pdf.print.embedded-fonts, pdf.print.pdfx-markers, pdf.print.page-size, asset.image.color-space, source.markdownlint, heuristic.whitespace.text-density). A boolean value is shorthand for enabled/disabled.",
+          "propertyNames": {
+            "description": "A registered check id, e.g. \"pdf.print.embedded-fonts\"."
+          },
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": "boolean",
+                "description": "Shorthand for { enabled: <value> }."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "enabled": {
+                    "type": "boolean",
+                    "description": "Whether this check runs.",
+                    "default": true
+                  },
+                  "severity": {
+                    "type": "string",
+                    "description": "How a failure of this check is reported.",
+                    "enum": ["error", "warning", "info"]
+                  },
+                  "options": {
+                    "type": "object",
+                    "description": "Check-specific options.",
+                    "additionalProperties": true
+                  }
+                }
+              }
+            ]
+          },
+          "examples": [
+            {
+              "pdf.structure.qpdf": { "enabled": true, "severity": "error" },
+              "pdf.print.pdfx-markers": false
+            }
+          ]
+        },
+        "source": {
+          "type": "object",
+          "description": "Source-linting checks (markdown, generated HTML, CSS). Each entry is a path to that linter's config file, or false to disable the check.",
+          "properties": {
+            "markdownlint": {
+              "description": "Path to a markdownlint config, or false to disable the source.markdownlint check.",
+              "default": null,
+              "oneOf": [
+                { "type": "string", "minLength": 1 },
+                { "type": "boolean", "const": false }
+              ]
+            },
+            "htmlhint": {
+              "description": "Path to an htmlhint config, or false to disable the source.htmlhint check.",
+              "default": null,
+              "oneOf": [
+                { "type": "string", "minLength": 1 },
+                { "type": "boolean", "const": false }
+              ]
+            },
+            "stylelint": {
+              "description": "Path to a stylelint config, or false to disable the source.stylelint check.",
+              "default": null,
+              "oneOf": [
+                { "type": "string", "minLength": 1 },
+                { "type": "boolean", "const": false }
+              ]
+            },
+            "allowedCallouts": {
+              "type": "array",
+              "deprecated": true,
+              "description": "DEPRECATED and IGNORED (no-op). The `:::name` container syntax this gated was removed 2026-05-17, along with the callout-validation check it configured. Kept only so older manifests still parse; setting it logs a deprecation warning. See docs/migrations/2026-05-removing-container-syntax.md.",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "assets": {
+          "type": "object",
+          "description": "Thresholds for the asset.* checks (images and fonts on disk).",
+          "properties": {
+            "maxImageSize": {
+              "type": "integer",
+              "description": "Maximum image file size in bytes (asset.image.file-size).",
+              "default": 10000000,
+              "minimum": 0
+            },
+            "minImageDpi": {
+              "type": "integer",
+              "description": "Minimum effective image resolution in DPI (asset.image.resolution).",
+              "default": 300,
+              "minimum": 0
+            },
+            "allowedColorSpaces": {
+              "type": "array",
+              "description": "Color spaces images may use (asset.image.color-space). Preset defaults: dtrpg [\"CMYK\", \"Grayscale\"], book [\"RGB\", \"CMYK\", \"Grayscale\"].",
+              "items": { "type": "string" },
+              "examples": [
+                ["CMYK", "Grayscale"],
+                ["RGB", "CMYK", "Grayscale"]
+              ]
+            },
+            "allowAlpha": {
+              "type": "boolean",
+              "description": "Whether images may carry an alpha channel (asset.image.alpha-channel). Preset defaults: dtrpg false (PDF/X forbids transparency), book true."
+            },
+            "approvedFontFiles": {
+              "type": "array",
+              "description": "Allow-list of font files (asset.font.approved-files). Empty means no restriction.",
+              "default": [],
+              "items": { "type": "string" }
+            },
+            "requireFontLicense": {
+              "type": "boolean",
+              "description": "Require a license record for each embedded font (asset.font.license).",
+              "default": false
+            }
+          }
+        },
+        "pdf": {
+          "type": "object",
+          "description": "Thresholds for the pdf.* checks (run against the produced PDF).",
+          "properties": {
+            "requireBookmarks": {
+              "type": "boolean",
+              "description": "Require a PDF outline/bookmark tree (pdf.nav.bookmarks).",
+              "default": false
+            },
+            "requireTocLinks": {
+              "type": "boolean",
+              "description": "Require the table of contents to use real internal links (pdf.nav.toc-links).",
+              "default": false
+            },
+            "minImageResolution": {
+              "type": "integer",
+              "description": "Minimum placed-image resolution in DPI (pdf.print.image-resolution).",
+              "default": 300,
+              "minimum": 0
+            },
+            "forbidTransparency": {
+              "type": "boolean",
+              "description": "Fail on transparency in the PDF (pdf.print.transparency). Preset defaults: dtrpg true (required by PDF/X), book false."
+            },
+            "requireBleed": {
+              "type": "boolean",
+              "description": "Require a bleed box on every page (pdf.print.bleed).",
+              "default": false
+            },
+            "bleedSize": {
+              "type": "number",
+              "description": "Expected bleed, in points (9pt = 0.125in).",
+              "default": 9,
+              "minimum": 0
+            }
+          }
+        },
+        "heuristics": {
+          "type": "object",
+          "description": "Thresholds for the heuristic.* layout-quality checks. These are advisory design heuristics, not hard print requirements.",
+          "properties": {
+            "maxDecorativeLayers": {
+              "type": "integer",
+              "description": "Maximum stacked decorative layers per page (heuristic.decoration.layer-count).",
+              "default": 5,
+              "minimum": 0
+            },
+            "textDensityRange": {
+              "type": "object",
+              "description": "Acceptable characters-per-page range (heuristic.whitespace.text-density).",
+              "properties": {
+                "min": {
+                  "type": "number",
+                  "description": "Minimum characters per page.",
+                  "default": 200,
+                  "minimum": 0
+                },
+                "max": {
+                  "type": "number",
+                  "description": "Maximum characters per page.",
+                  "default": 5000,
+                  "minimum": 0
+                }
+              }
+            },
+            "maxParagraphsPerSection": {
+              "type": "integer",
+              "description": "Maximum paragraphs in one section before it is flagged as under-chunked (heuristic.chunking.section-density).",
+              "default": 10,
+              "minimum": 0
+            }
+          }
+        }
+      }
+    },
+    "publish": {
+      "type": "object",
+      "description": "Publish provider settings, keyed by the same provider id `gutterpress publish --provider <id>` takes. Non-secret configuration only — API keys and tokens are stored in the host credential store, never in this file.",
+      "properties": {
+        "itch": {
+          "type": "object",
+          "description": "itch.io publishing (uploaded with butler)",
+          "properties": {
+            "target": {
+              "type": "string",
+              "description": "itch.io project as user/game (the butler push target)",
+              "pattern": "^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$",
+              "examples": ["dimm-city/operations-manual"]
+            },
+            "channel": {
+              "type": "string",
+              "description": "butler channel name",
+              "default": "pdf"
+            },
+            "credential": {
+              "type": "string",
+              "description": "Label of the saved credential to use when more than one is stored for this provider. Not a secret — just a reference into the host credential store. Empty or absent uses the default credential."
+            }
+          }
+        },
+        "drivethrurpg": {
+          "type": "object",
+          "description": "DriveThruRPG guided publishing (export package + open the publisher hub)",
+          "properties": {
+            "productUrl": {
+              "type": "string",
+              "description": "Existing product page URL, when updating a published title"
+            }
+          }
+        },
+        "kdp": {
+          "type": "object",
+          "description": "Amazon KDP guided publishing (export package + open kdp.amazon.com)",
+          "properties": {}
+        },
+        "azure-swa": {
+          "type": "object",
+          "description": "Azure Static Web Apps deployment of the HTML export",
+          "properties": {
+            "env": {
+              "type": "string",
+              "description": "Deploy environment",
+              "default": "production"
+            },
+            "credential": {
+              "type": "string",
+              "description": "Label of the saved credential to use when more than one is stored for this provider."
+            }
+          }
+        },
+        "shopify": {
+          "type": "object",
+          "description": "Shopify product publishing (Admin GraphQL API)",
+          "properties": {
+            "shop": {
+              "type": "string",
+              "description": "Store domain, e.g. my-store.myshopify.com"
+            },
+            "productId": {
+              "type": "string",
+              "description": "Existing product GID/id to update instead of creating a new one"
+            },
+            "apiVersion": {
+              "type": "string",
+              "description": "Admin GraphQL API version",
+              "default": "2026-04"
+            },
+            "credential": {
+              "type": "string",
+              "description": "Label of the saved credential to use when more than one is stored for this provider."
+            }
+          }
+        }
+      }
+    },
+    "themePrevious": {
+      "type": "string",
+      "description": "Id of the theme active before the current one (the 'Revert to previous theme' target, #106). Managed automatically by Gutterpress; not authored by hand.",
+      "examples": ["clean-book", "zine"]
+    }
+  },
+  "examples": [
+    {
+      "title": "My Book",
+      "authors": ["Author Name"],
+      "preset": "book",
+      "styles": ["styles/book.css"],
+      "source": {
+        "files": ["chapter-01.md", "chapter-02.md"]
+      }
+    },
+    {
+      "title": "TTRPG Supplement",
+      "authors": ["Game Master"],
+      "preset": "dtrpg",
+      "plugins": [
+        {
+          "path": "plugins/dimm-city-plugin.js",
+          "priority": 100
+        }
+      ],
+      "styles": ["css/index.css"],
+      "source": {
+        "files": ["chapter-00.md", "chapter-01.md"]
+      },
+      "page": {
+        "width": 621,
+        "height": 810,
+        "tolerance": 0.5
+      },
+      "pdfx": {
+        "flavor": "x1a",
+         "icc": ".gutterpress/profiles/CGATS21_CRPC1.icc"
+      },
+      "ink": {
+        "maxTac": 240
+      }
+    },
+    {
+      "title": "Technical Documentation",
+      "authors": ["Tech Team"],
+      "preset": "book",
+      "styles": ["styles/book.css"],
+      "validate": {
+        "enabled": true,
+        "checks": {
+          "pdf.nav.bookmarks": { "enabled": true, "severity": "warning" },
+          "pdf.print.pdfx-markers": false
+        },
+        "pdf": {
+          "requireBookmarks": true,
+          "requireTocLinks": true
+        }
+      }
+    }
+  ]
+}