gutterpress 0.0.0 → 0.9.0-alpha.2

package/dist/render.js

@@ -600,17 +600,6 @@ async function assembleBookHtml(opts) {
     throw new Error("No markdown files to render");
   }
   const md = createMarkdownRenderer(opts.plugins);
-  let sourceChapter = null;
-  if (opts.wrapChapters) {
-    const renderToken = md.renderer.renderToken.bind(md.renderer);
-    md.renderer.renderToken = (tokens, idx, options) => {
-      const token = tokens[idx];
-      if (sourceChapter !== null && token.level === 0 && token.map !== null && token.type.endsWith("_open")) {
-        token.attrSet("data-chapter-src", sourceChapter);
-      }
-      return renderToken(tokens, idx, options);
-    };
-  }
   let bodyContent = "";
   const imageRefs = new Set;
   for (const file of files) {
@@ -623,20 +612,22 @@ async function assembleBookHtml(opts) {
       throw new Error(`Failed to read file ${file}: ${errorMsg}`);
     }
     const env = {};
-    sourceChapter = opts.wrapChapters ? chapterId : null;
-    let rendered;
-    try {
-      rendered = md.render(content, env);
-    } finally {
-      sourceChapter = null;
-    }
+    const rendered = md.render(content, env);
     if (env.layoutWarnings && env.layoutWarnings.length > 0) {
       opts.onChapterWarnings?.(chapterId, env.layoutWarnings);
     }
     for (const ref of env.imageRefs ?? [])
       imageRefs.add(ref);
-    bodyContent += rendered + `
+    if (opts.wrapChapters) {
+      const safe = chapterId.replace(/&/g, "&").replace(/"/g, """);
+      bodyContent += `<div class="gutterpress-chapter" data-chapter-src="${safe}">
+${rendered}
+</div>
+`;
+    } else {
+      bodyContent += rendered + `
 `;
+    }
   }
   if (opts.onImageRefs) {
     for (const ref of collectHtmlImageRefs(bodyContent))

package/dist/{repair-jkp4n3j8.js → repair-zgq7q2g6.js}

@@ -8,18 +8,18 @@ import {
   makeManualGuidance,
   recover,
   verifyRepoReadable
-} from "./cli-7ykx7pp0.js";
+} from "./cli-k4bd06sd.js";
 import {
   FileTokenStore,
   defaultConfigDir
-} from "./cli-h7phg3ka.js";
+} from "./cli-najycadg.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-e5zhb0xs.js";
+import"./cli-yzrh708h.js";
+import"./cli-wchtvxvw.js";
 import"./cli-yja077f6.js";
 import"./cli-37x76zdn.js";
 

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

@@ -1,4 +1,4 @@
-export type CheckSeverity = "error" | "warning" | "info";
+type CheckSeverity = "error" | "warning" | "info";
 export interface PluginConfig {
     path?: string;
     name?: string;
@@ -29,7 +29,7 @@ export interface PluginConfig {
  * absent uses the default (bare-host) credential. This book-level choice
  * overrides any project/global default.
  */
-export interface PublishSettings {
+interface PublishSettings {
     itch?: {
         /** itch.io project as `user/game` (the butler push target). */
         target?: string;
@@ -64,7 +64,15 @@ export interface GutterpressManifest {
     title?: string;
     authors?: string[];
     publish?: PublishSettings;
-    preset?: "dtrpg" | "book";
+    /** How the book is designed (ADR 0008). The registry in lib/presets.ts is authoritative. */
+    preset?: "dtrpg" | "book" | "custom";
+    /**
+     * Where the book is published (ADR 0008): publish-target ids whose
+     * validation policies this book is checked against. Absent = the preset's
+     * defaults (`dtrpg` -> ["dtrpg"]; `book`/`custom` -> []). The registry in
+     * lib/targets.ts is authoritative.
+     */
+    targets?: string[];
     styles?: string[];
     plugins?: (string | PluginConfig)[];
     source?: {
@@ -155,6 +163,8 @@ export interface ResolvedPluginConfig {
 export interface ResolvedConfig {
     title: string;
     authors: string[];
+    /** Validated publish-target ids for this book (may be empty). */
+    targets: string[];
     styles?: string[];
     plugins: ResolvedPluginConfig[];
     source: {
@@ -216,3 +226,4 @@ export interface ResolvedConfig {
         };
     };
 }
+export {};

package/dist/server.d.ts

@@ -16,6 +16,8 @@ export interface PreviewServerHandle {
     stop: () => Promise<void>;
     /** Switch the watched directory and regenerate HTML. */
     restart: (newInputPath: string) => Promise<void>;
+    /** Rebuild immediately after a host-managed write has fully settled. */
+    notifySettledWrite: (filePath: string, writtenContent: string) => void;
 }
 export interface StartPreviewServerOptions extends PreviewServerOptions {
     /**

package/dist/{source-provider-hp96b5jf.js → source-provider-c1rjm2c0.js}

@@ -2,9 +2,7 @@ import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
   RESTORE_BACKUP_MESSAGE,
-  SNAPSHOT_STAGING_MARKER,
   __repoLockQueueSizeForTests,
-  gitAuthor,
   gitDirFor,
   gitScopeFor,
   hasPendingChanges,
@@ -12,15 +10,14 @@ import {
   isNoChangesError,
   listWorkdirChanges,
   providerFor,
-  readGitAuthor,
   resolveGitAuthor,
   restoreVersionWithBackup,
   snapshotStagingMarkerPath,
   snapshotWorkingTreeUnlocked,
   stageChanges,
   withRepoLock
-} from "./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-yzrh708h.js";
+import"./cli-wchtvxvw.js";
 import"./cli-37x76zdn.js";
 export {
   withRepoLock,
@@ -29,7 +26,6 @@ export {
   snapshotStagingMarkerPath,
   restoreVersionWithBackup,
   resolveGitAuthor,
-  readGitAuthor,
   providerFor,
   listWorkdirChanges,
   isNoChangesError,
@@ -37,9 +33,7 @@ export {
   hasPendingChanges,
   gitScopeFor,
   gitDirFor,
-  gitAuthor,
   __repoLockQueueSizeForTests,
-  SNAPSHOT_STAGING_MARKER,
   RESTORE_BACKUP_MESSAGE,
   HISTORY_PAGE_LIMIT,
   AUTO_SNAPSHOT_MESSAGE

package/dist/types.d.ts

@@ -4,7 +4,6 @@
  * Core types used by the preview server and CLI commands.
  * Build pipeline types are in src/schema/manifest.types.ts.
  */
-export type { GutterpressManifest, ResolvedConfig } from './schema/manifest.types';
 /**
  * Options for preview server (internal)
  */

package/dist/{validate-k2drs19j.js → validate-nr0xa6sa.js}

@@ -1,17 +1,17 @@
 import {
   executeAndReport
-} from "./cli-7ykx7pp0.js";
+} from "./cli-k4bd06sd.js";
 import {
   log
-} from "./cli-h7phg3ka.js";
+} from "./cli-najycadg.js";
 import {
   EXIT_CODES,
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-e5zhb0xs.js";
+import"./cli-yzrh708h.js";
+import"./cli-wchtvxvw.js";
 import"./cli-yja077f6.js";
 import"./cli-37x76zdn.js";
 
@@ -55,9 +55,9 @@ var commandArgs = {
     type: "string",
     description: "Run checks for phase: pre | post | all | pre-build | post-build (default: all)"
   },
-  profile: {
+  target: {
     type: "string",
-    description: "Validation profile lock (currently: dtrpg)"
+    description: "Publish targets to validate against (comma-separated, e.g. dtrpg,itch), overriding the manifest's `targets:`"
   }
 };
 var validate_default = defineCommand({
@@ -83,7 +83,7 @@ var validate_default = defineCommand({
         only: typeof args.only === "string" ? args.only : undefined,
         skip: typeof args.skip === "string" ? args.skip : undefined,
         phase: typeof args.phase === "string" ? args.phase : undefined,
-        profile: typeof args.profile === "string" ? args.profile : undefined
+        target: typeof args.target === "string" ? args.target : undefined
       }, format);
     } catch (error) {
       log.error(error instanceof Error ? error.message : String(error));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.0.0",
+  "version": "0.9.0-alpha.2",
   "description": "Markdown-to-PDF converter for professional print layout using Paged.js and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",
@@ -12,7 +12,7 @@
     "ghostscript",
     "book",
     "publishing",
-    "ttrpg"
+    "zine"
   ],
   "repository": {
     "type": "git",

package/dist/chapter-01-jj8ftn4c.md

@@ -1,29 +0,0 @@
-# Introduction
-
-Welcome to {{TITLE}}, a tabletop roleplaying supplement. This first page is a
-starting point — replace it with your own rules, lore, and tables.
-
-## How to use this supplement
-
-Write your rules in plain paragraphs, then break out the parts players reach for
-most into clearly labelled blocks. Headings keep long sections easy to scan at
-the table.
-
-## A sample rule
-
-> **Quick rule:** When two characters disagree on the outcome of an action, both
-> roll. The higher result decides what happens, and the other player narrates
-> how their character reacts.
-
-## A sample stat block
-
-Use a simple table for stat blocks so the numbers line up neatly on the page:
-
-| Attribute | Value |
-| --------- | ----- |
-| Health    | 10    |
-| Defense   | 4     |
-| Speed     | 6     |
-
-Add more files alongside this one and they become the next sections of your
-supplement. Start writing and watch your rules take shape in the preview.

package/dist/lib/validation-profile.d.ts

@@ -1,18 +0,0 @@
-import type { ResolvedConfig } from "../schema/manifest.types";
-export type ValidationProfile = "dtrpg";
-export declare const DTRPG_STRICT_PDF_CHECKS: readonly ["pdf.structure.qpdf", "pdf.print.pdfx-markers", "pdf.print.pdfx-metadata", "pdf.print.embedded-fonts"];
-/**
- * Fill in the strict PDF checks (structure/PDF-X markers/metadata/embedded
- * fonts) for any of them the config left unset, without overwriting an
- * author's explicit choice. ARCH finding #21: replaces the old
- * `applyDtrpgPdfDefaults` name, which implied a dtrpg-only opt-in even though
- * `executeValidation` applies it to every PDF validation regardless of
- * profile/preset — see validation-exec.ts.
- */
-export declare function applyDefaultPdfStrictChecks(config: ResolvedConfig): ResolvedConfig;
-/**
- * @deprecated Use {@link applyDefaultPdfStrictChecks} — kept as an alias so
- * existing call sites keep resolving under the old, dtrpg-branded name.
- */
-export declare const applyDtrpgPdfDefaults: typeof applyDefaultPdfStrictChecks;
-export declare function applyValidationProfile(config: ResolvedConfig, profile: ValidationProfile): ResolvedConfig;

package/dist/manifest-ryyg71nf.yaml

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

package/dist/new-7b08a42h.js

@@ -1,105 +0,0 @@
-import {
-  BUILT_IN_TEMPLATE_IDS,
-  scaffoldProject
-} from "./cli-7ykx7pp0.js";
-import"./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/new.ts
-import { defineCommand } from "citty";
-import { resolve } from "node:path";
-var newArgs = {
-  name: {
-    type: "positional",
-    description: "Project name (becomes the title and folder name)",
-    required: true
-  },
-  author: {
-    type: "string",
-    description: "Author name to record in the project"
-  },
-  dir: {
-    type: "string",
-    description: "Parent directory to create the project in (default: current directory)"
-  },
-  folder: {
-    type: "string",
-    description: "Folder name to create (default: a slug of the project name)"
-  },
-  template: {
-    type: "string",
-    description: `Starter template: ${BUILT_IN_TEMPLATE_IDS.join(", ")} (default: book)`
-  },
-  git: {
-    type: "boolean",
-    description: "Initialise local version history (default: true; use --no-git to skip)",
-    default: true
-  }
-};
-var new_default = defineCommand({
-  meta: {
-    name: "new",
-    description: "Create a new Gutterpress project from a starter template"
-  },
-  args: newArgs,
-  async run({ args, rawArgs }) {
-    try {
-      rejectUnknownFlags(rawArgs, newArgs, "new");
-      rejectExtraPositionals(args._, 1, "new");
-    } catch (error) {
-      if (error instanceof UsageError) {
-        console.error(error.message);
-        process.exit(error.exitCode);
-      }
-      throw error;
-    }
-    const name = String(args.name);
-    const parentDir = resolve(typeof args.dir === "string" && args.dir ? args.dir : process.cwd());
-    let template;
-    if (typeof args.template === "string" && args.template) {
-      if (!BUILT_IN_TEMPLATE_IDS.includes(args.template)) {
-        console.error(`Unknown template "${args.template}". Choose one of: ${BUILT_IN_TEMPLATE_IDS.join(", ")}.`);
-        process.exit(EXIT_CODES.USAGE);
-      }
-      template = args.template;
-    }
-    try {
-      const result = await scaffoldProject({
-        name,
-        author: typeof args.author === "string" ? args.author : undefined,
-        parentDir,
-        folderName: typeof args.folder === "string" && args.folder ? args.folder : undefined,
-        template,
-        versionHistory: args.git === false ? "none" : "local-git"
-      });
-      console.log(`Created project: ${result.projectDir}`);
-      console.log(`  manifest: ${result.manifestPath}`);
-      console.log(`  start writing in: ${result.openFile}`);
-      if (result.versionHistory === "local-git") {
-        console.log("  version history: enabled (local snapshots)");
-      } else if (result.versionHistoryError) {
-        console.log(`  version history: not enabled (${result.versionHistoryError})`);
-      }
-      console.log("");
-      console.log(`Next: gutterpress preview "${result.projectDir}"`);
-    } catch (e) {
-      const err = e;
-      const code = err && typeof err.code === "string" ? err.code : "scaffold-io";
-      console.error(`Could not create project: ${err?.message ?? String(e)}`);
-      process.exit(code === "scaffold-io" ? EXIT_CODES.PIPELINE : EXIT_CODES.USAGE);
-    }
-  }
-});
-export {
-  newArgs,
-  new_default as default
-};

package/dist/preview-shell-rghtfmc8.js

@@ -1,155 +0,0 @@
-// Gutterpress preview shell controller (shared by the CLI preview and Electron).
-// Every source change takes one correctness-first path: paginate a fresh hidden
-// full document, then swap it in without flashing unpaginated content.
-//
-// TRANSPORT IS ABSTRACTED: change events arrive through connectChanges(), which
-  // uses WebSocket by default but honors window.__GUTTERPRESS_CHANGE_SOURCE so an Electron
-// host can feed the same full-reload signal over IPC.
-(function () {
-  'use strict';
-  var active = document.getElementById('gutterpress-active');
-  var building = null;
-  if (!active) return;
-
-  // Transparent bridge relay: forward host-toolbar commands to the active book
-  // iframe and relay its replies/events back to the host.
-  window.addEventListener('message', function (e) {
-    try {
-      if (window.parent !== window && e.source === window.parent) {
-        if (active && active.contentWindow) active.contentWindow.postMessage(e.data, '*');
-      } else if (active && e.source === active.contentWindow && window.parent !== window) {
-        window.parent.postMessage(e.data, '*');
-      }
-    } catch (_) {}
-  });
-
-  function fdoc(f) { try { return f.contentDocument; } catch (_) { return null; } }
-  function fwin(f) { try { return f.contentWindow; } catch (_) { return null; } }
-  function chapterOf(el) {
-    var chapter = el.closest && el.closest('[data-chapter-src]');
-    return chapter ? chapter.getAttribute('data-chapter-src') : null;
-  }
-  function blocksInChapter(d, chapter) {
-    var all = d.querySelectorAll('[data-source-line]');
-    if (!chapter) return all;
-    var matched = [];
-    for (var i = 0; i < all.length; i++) {
-      if (chapterOf(all[i]) === chapter) matched.push(all[i]);
-    }
-    return matched;
-  }
-
-  // data-source-line resets per source file, so preserve both chapter and line.
-  function capture(f) {
-    var d = fdoc(f); if (!d) return null;
-    var els = d.querySelectorAll('[data-source-line]'), best = null, bestTop = -Infinity;
-    for (var i = 0; i < els.length; i++) {
-      var r = els[i].getBoundingClientRect();
-      if (r.bottom < 0 || r.height === 0) continue;
-      if (r.top <= 80 && r.top > bestTop) { bestTop = r.top; best = els[i]; }
-    }
-    if (!best) {
-      for (var j = 0; j < els.length; j++) {
-        var rr = els[j].getBoundingClientRect();
-        if (rr.bottom > 0 && rr.height > 0) { best = els[j]; break; }
-      }
-    }
-    if (!best) return null;
-    return {
-      chapter: chapterOf(best),
-      line: best.getAttribute('data-source-line'),
-      offset: best.getBoundingClientRect().top
-    };
-  }
-
-  function restore(f, anchor) {
-    if (!anchor) return;
-    var w = fwin(f), d = fdoc(f); if (!w || !d) return;
-    var els = blocksInChapter(d, anchor.chapter);
-    var wanted = parseInt(anchor.line, 10), el = null, bestDiff = Infinity;
-    for (var i = 0; i < els.length; i++) {
-      var line = parseInt(els[i].getAttribute('data-source-line'), 10);
-      if (String(els[i].getAttribute('data-source-line')) === String(anchor.line)) {
-        el = els[i];
-        break;
-      }
-      var diff = Math.abs(line - wanted);
-      if (diff < bestDiff) { bestDiff = diff; el = els[i]; }
-    }
-    if (el) w.scrollBy(0, el.getBoundingClientRect().top - anchor.offset);
-  }
-
-  function onReady(f, callback) {
-    var w = fwin(f), d = fdoc(f); if (!w || !d) { callback(); return; }
-    var hasPaged = !!d.querySelector('script[src*="paged.polyfill"], script[src*="pagedjs"]');
-    if (hasPaged) {
-      var done = false;
-      var finish = function () { if (!done) { done = true; callback(); } };
-      w.addEventListener('renderingComplete', finish, { once: true });
-      setTimeout(finish, 180000);
-      return;
-    }
-    var attempts = 0;
-    (function poll() {
-      var current = fdoc(f);
-      if (current && current.querySelectorAll('.pagedjs_page').length > 0) { callback(); return; }
-      if (attempts++ < 800) setTimeout(poll, 25); else callback();
-    })();
-  }
-
-  function swap() {
-    // A newer reload invalidates any older hidden pagination. Its callback also
-    // checks identity before swapping, so stale work can never win a race.
-    if (building && building.parentNode) building.parentNode.removeChild(building);
-    building = null;
-
-    var frame = document.createElement('iframe');
-    frame.style.visibility = 'hidden';
-    frame.setAttribute('aria-hidden', 'true');
-    frame.src = '/book.html?gutterpressshell=1&bust=' + Date.now();
-    building = frame;
-
-    var finished = false;
-    function finish() {
-      if (finished || building !== frame) return;
-      finished = true;
-      // Capture at swap time, not rebuild start: the visible frame stays usable
-      // while a long book paginates and the user may scroll during that work.
-      var anchor = capture(active);
-      restore(frame, anchor);
-      frame.style.visibility = 'visible';
-      frame.removeAttribute('aria-hidden');
-      var old = active;
-      active = frame;
-      building = null;
-      requestAnimationFrame(function () {
-        requestAnimationFrame(function () {
-          if (old && old.parentNode) old.parentNode.removeChild(old);
-        });
-      });
-    }
-
-    frame.addEventListener('load', function () { onReady(frame, finish); });
-    document.body.appendChild(frame);
-  }
-
-  function connectChanges(onMessage) {
-    var source = window.__GUTTERPRESS_CHANGE_SOURCE;
-    if (source && typeof source.subscribe === 'function') return source.subscribe(onMessage);
-    var wsPath = window.__GUTTERPRESS_HMR || '/__gutterpress-hmr';
-    var ws = new WebSocket(location.origin.replace(/^http/, 'ws') + wsPath);
-    ws.onmessage = function (event) {
-      var message;
-      try { message = JSON.parse(event.data); } catch (_) { return; }
-      onMessage(message);
-    };
-    return function () { try { ws.close(); } catch (_) {} };
-  }
-
-  connectChanges(function (message) {
-    if (!message || !message.type) return;
-    // Accept legacy content-update producers, but never perform an isolated
-    // chapter splice: a changed boundary can affect every following page.
-    if (message.type === 'full-reload' || message.type === 'content-update') swap();
-  });
-})();

package/dist/theme-0yzvthe8.css

@@ -1,65 +0,0 @@
-/* =============================================================================
-   TTRPG Supplement — gutterpress built-in theme (theme.css)
-   Bold headings, parchment fills, boxed blocks. Customize the tokens in :root.
-   ============================================================================= */
-
-:root {
-  --color-ink:        #241a12;   /* body text                 */
-  --color-ink-muted:  #5c4a36;   /* captions, secondary text  */
-  --color-accent:     #7a2222;   /* headings, key accents     */
-  --color-paper:      #faf4e6;   /* parchment page background */
-  --color-tint:       #efe3c8;   /* stat-block / callout fill */
-  --color-rule:       #b89a6a;   /* borders, rules            */
-
-  --font-body:    "Palatino Linotype", "Book Antiqua", Palatino, serif;
-  --font-display: "Trajan Pro", "Cinzel", "Georgia", serif;
-  --font-mono:    "Consolas", "Menlo", monospace;
-
-  --scale-h1: 2.4rem;
-  --scale-h2: 1.7rem;
-  --scale-h3: 1.25rem;
-  --leading:  1.45;
-}
-
-@page {
-  size: 8.5in 11in;
-  margin: 0.7in;
-}
-
-body {
-  color: var(--color-ink);
-  background: var(--color-paper);
-  font-family: var(--font-body);
-  line-height: var(--leading);
-  font-size: 10.5pt;
-}
-
-h1, h2, h3 {
-  font-family: var(--font-display);
-  color: var(--color-accent);
-  letter-spacing: 0.02em;
-  text-transform: uppercase;
-  font-weight: 700;
-}
-h1 { font-size: var(--scale-h1); margin: 0 0 0.5em; border-bottom: 3px double var(--color-rule); padding-bottom: 0.2em; }
-h2 { font-size: var(--scale-h2); margin: 1.3em 0 0.4em; }
-h3 { font-size: var(--scale-h3); margin: 1.1em 0 0.3em; letter-spacing: 0; }
-
-p { margin: 0 0 0.7em; }
-
-a { color: var(--color-accent); text-decoration: none; }
-
-blockquote {
-  margin: 1em 0; padding: 0.6em 0.9em;
-  background: var(--color-tint);
-  border: 1px solid var(--color-rule);
-  border-radius: 4px;
-}
-
-table {
-  width: 100%; border-collapse: collapse; margin: 1em 0;
-}
-th, td { border: 1px solid var(--color-rule); padding: 0.35em 0.6em; text-align: left; }
-th { background: var(--color-tint); font-family: var(--font-display); }
-
-code, pre { font-family: var(--font-mono); font-size: 0.9em; }

package/dist/theme-6a2fngc8.json

@@ -1,6 +0,0 @@
-{
-  "name": "TTRPG Supplement",
-  "author": "gutterpress",
-  "description": "Bold display headings, warm parchment fills, and boxed stat blocks for game books.",
-  "preview": null
-}