gutterpress 0.0.0 → 0.9.0-alpha.1

package/dist/{preflight-tg4mpz1h.js → preflight-epcffags.js}

@@ -1,18 +1,19 @@
 import {
   executeValidation,
+  publishTargetFor,
   reportMissingTools
-} from "./cli-7ykx7pp0.js";
+} from "./cli-yp0d2hp8.js";
 import {
   log
-} from "./cli-h7phg3ka.js";
+} from "./cli-v2dze8ja.js";
 import {
   EXIT_CODES,
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-rkqxbnkq.js";
+import"./cli-yzrh708h.js";
+import"./cli-wchtvxvw.js";
 import"./cli-yja077f6.js";
 import"./cli-37x76zdn.js";
 
@@ -35,25 +36,19 @@ function severityRank(severity) {
   return 2;
 }
 function buildRequiredChecks(execution) {
-  if (execution.profile !== "dtrpg")
-    return [];
-  const requiredIds = [
-    "pdf.structure.qpdf",
-    "pdf.print.pdfx-markers",
-    "pdf.print.pdfx-metadata",
-    "pdf.print.embedded-fonts"
-  ];
   const skipped = new Set(execution.tools.skippedChecks);
-  const failed = new Set(execution.report.errors.map((item) => item.checkId));
   const passed = new Set(execution.report.passed);
-  return requiredIds.map((id) => {
-    if (skipped.has(id))
-      return { id, status: "skipped" };
-    if (failed.has(id))
-      return { id, status: "fail" };
-    if (passed.has(id))
-      return { id, status: "pass" };
-    return { id, status: "fail" };
+  return execution.targets.flatMap((targetId) => {
+    const failed = new Set(execution.report.errors.filter((item) => item.target === undefined || item.target === targetId).map((item) => item.checkId));
+    return publishTargetFor(targetId).requiredChecks.map((id) => {
+      if (skipped.has(id))
+        return { target: targetId, id, status: "skipped" };
+      if (failed.has(id))
+        return { target: targetId, id, status: "fail" };
+      if (passed.has(id))
+        return { target: targetId, id, status: "pass" };
+      return { target: targetId, id, status: "fail" };
+    });
   });
 }
 function buildPreflightPayload(execution) {
@@ -85,8 +80,8 @@ function buildPreflightPayload(execution) {
   const requiredChecks = buildRequiredChecks(execution);
   const skippedRequired = requiredChecks.some((check) => check.status === "skipped");
   return {
-    schemaVersion: 1,
-    profile: execution.profile ?? null,
+    schemaVersion: 2,
+    targets: [...execution.targets],
     status: computeStatus(execution.report.summary.errors, execution.report.summary.warnings, execution.tools.missing.length, skippedRequired),
     pdf: execution.context.pdfPath ?? "",
     summary: { ...execution.report.summary },
@@ -103,7 +98,7 @@ function toPreflightMarkdown(payload) {
   lines.push("# gutterpress preflight");
   lines.push("");
   lines.push(`- Status: **${payload.status}**`);
-  lines.push(`- Profile: ${payload.profile ?? "none"}`);
+  lines.push(`- Targets: ${payload.targets.length > 0 ? payload.targets.join(", ") : "none"}`);
   lines.push(`- PDF: ${payload.pdf}`);
   lines.push(`- Summary: ${payload.summary.errors} error(s), ${payload.summary.warnings} warning(s), ${payload.summary.passed}/${payload.summary.total} checks passed`);
   if (payload.tools.missing.length > 0) {
@@ -117,7 +112,7 @@ function toPreflightMarkdown(payload) {
     lines.push("");
     lines.push("## Required Checks");
     for (const check of payload.requiredChecks) {
-      lines.push(`- ${check.id}: ${check.status}`);
+      lines.push(`- [${check.target}] ${check.id}: ${check.status}`);
     }
   }
   if (payload.issues.length > 0) {
@@ -155,9 +150,9 @@ var preflightArgs = {
     type: "string",
     description: "Path to manifest.yaml"
   },
-  profile: {
+  target: {
     type: "string",
-    description: "Validation profile lock (currently: dtrpg)"
+    description: "Publish targets to preflight against (comma-separated, e.g. dtrpg,itch), overriding the manifest's `targets:`"
   },
   "report-dir": {
     type: "string",
@@ -187,7 +182,7 @@ var preflight_default = defineCommand({
         pdf: typeof args.pdf === "string" ? args.pdf : undefined,
         input,
         phase: "post-build",
-        profile: typeof args.profile === "string" ? args.profile : undefined
+        target: typeof args.target === "string" ? args.target : undefined
       });
     } catch (error) {
       log.error(error instanceof Error ? error.message : String(error));

package/dist/preview/file-watcher.d.ts

@@ -13,26 +13,6 @@ import type { ResolvedPluginConfig } from '../schema/manifest.types';
  * every source change now performs a full-document pagination.
  */
 export declare function incrementalPreviewEnabled(): boolean;
-/**
- * Shared preview render path. renderChapters() does all Markdown, CSS, and
- * Paged.js-slot work.
- *
- * Named `renderPreviewBook` (ARCH finding #53) to distinguish it from
- * build-runner.ts's `renderBook` — same name, different module, and a
- * genuinely different contract: this one is degrade-and-report (a plugin the
- * author enabled but hasn't installed yet is skipped with a loud warning so
- * the rest of the live preview still renders); build-runner.ts's is
- * fail-fast, because a final artifact must never silently drop a plugin.
- * Both preambles now share {@link loadPluginsWithCss}.
- */
-export declare function renderPreviewBook(inputPath: string, config: {
-    title?: string;
-    styles?: string[];
-    plugins?: ResolvedPluginConfig[];
-}, opts: {
-    files: string[] | null;
-    wrapChapters: boolean;
-}): Promise<string>;
 /**
  * Rewrite rendered book HTML for the live preview. Injects, in order:
  *   1. pagedjs-interface.js — defines window.previewAPI for in-iframe controls
@@ -70,6 +50,12 @@ export declare function injectPreviewScripts(html: string): string;
  *
  * Empty `inputPath` writes a static placeholder — the desktop app (packages/desktop)
  * supplies a real path via its own folder picker.
+ *
+ * `cssAssets` is REQUIRED, not optional: it is the map the HTTP server resolves
+ * the inliner's rewritten asset URLs against (see {@link ServerState.cssAssets}),
+ * so a caller that skipped it would render a book.html whose shared-art URLs
+ * 404 — the exact bug this parameter exists to fix, reintroduced silently.
+ * Every render replaces its contents.
  */
 export declare function generateAndWriteHtml(inputPath: string, tempDir: string, config: {
     title?: string;
@@ -78,7 +64,7 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
         files?: string[] | null;
     };
     plugins?: ResolvedPluginConfig[];
-}): Promise<void>;
+}, cssAssets: Map<string, string>): Promise<void>;
 /**
  * Chokidar 5's `ignored` matcher (regex or function) is tested against the
  * fully-qualified, forward-slash-normalized ABSOLUTE path — never a path
@@ -102,7 +88,8 @@ export declare function isDotPathUnderRoot(candidatePath: string, root: string):
  * Whether the watcher should ignore a path.
  *
  * IN-PROJECT paths get the dotfile rule ({@link isDotPathUnderRoot}) — a
- * project's own `.git/`, `.DS_Store`, editor swap files, and so on are noise.
+ * project's own `.git/`, `.DS_Store`, editor swap files, and so on are noise —
+ * plus the generated/vendored-subtree rule ({@link isGeneratedProjectPath}).
  *
  * A path OUTSIDE the project is only ever seen because it is a DECLARED
  * external dependency the manifest named explicitly (see

package/dist/preview/server-context.d.ts

@@ -29,6 +29,28 @@ export interface ServerState {
     config: ResolvedConfig;
     /** Server options */
     options: PreviewServerOptions;
+    /**
+     * Files the inlined CSS references but could not embed, as
+     * `book.html`-relative URL path → absolute source path.
+     *
+     * `asset-inline.ts` embeds fonts and images up to
+     * `IMAGE_INLINE_MAX_BYTES`; anything larger keeps its project-relative path
+     * (if it lives in the book) or becomes `assets/<contentHash><ext>` (if it
+     * does not — e.g. art referenced from a repo-root shared stylesheet, the
+     * normative multi-book layout). Either way the inliner returns a COPY PLAN,
+     * which the build executes into its output dir.
+     *
+     * The preview serves the project in place and has no output dir, so a
+     * rewritten `assets/<hash>` URL had nothing behind it and shared art
+     * rendered broken in the live preview while building correctly. Keeping the
+     * plan here lets the server resolve those URLs straight from their real
+     * location — same URL as the build, still nothing copied.
+     *
+     * Rebuilt from scratch on every render, so a stylesheet edit that drops an
+     * image drops its URL too. Exact-match lookups only: never a path-traversal
+     * surface.
+     */
+    cssAssets: Map<string, string>;
 }
 /**
  * Create initial server state

package/dist/{preview-h2bwbb2x.js → preview-xf5dktz2.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-7ykx7pp0.js";
+} from "./cli-yp0d2hp8.js";
 import {
   log
-} from "./cli-h7phg3ka.js";
+} from "./cli-v2dze8ja.js";
 import {
   BuildError,
   UsageError,
@@ -18,9 +18,9 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-rkqxbnkq.js";
+import"./cli-yzrh708h.js";
+import"./cli-wchtvxvw.js";
 import"./cli-yja077f6.js";
 import"./cli-37x76zdn.js";
 

package/dist/{project-source-0tg0r6vm.js → project-source-p0gn1wd5.js}

@@ -2,15 +2,15 @@ import {
   capabilitiesFor,
   detectProjectSource,
   findEnclosingRepoDir,
-  pickSyncRemote,
+  repoRootForSource,
   repoSubPath,
   syncRemoteFor
-} from "./cli-1tyj4bk3.js";
+} from "./cli-wchtvxvw.js";
 import"./cli-37x76zdn.js";
 export {
   syncRemoteFor,
   repoSubPath,
-  pickSyncRemote,
+  repoRootForSource,
   findEnclosingRepoDir,
   detectProjectSource,
   capabilitiesFor

package/dist/{publish-ztaet53r.js → publish-97vdwq31.js}

@@ -7,19 +7,19 @@ import {
   publishCredentialKey,
   publishProviderFor,
   runPublish
-} from "./cli-7ykx7pp0.js";
+} from "./cli-yp0d2hp8.js";
 import {
   FileTokenStore,
   log
-} from "./cli-h7phg3ka.js";
+} from "./cli-v2dze8ja.js";
 import {
   EXIT_CODES,
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-rkqxbnkq.js";
+import"./cli-yzrh708h.js";
+import"./cli-wchtvxvw.js";
 import"./cli-yja077f6.js";
 import"./cli-37x76zdn.js";
 

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

@@ -8,18 +8,18 @@ import {
   makeManualGuidance,
   recover,
   verifyRepoReadable
-} from "./cli-7ykx7pp0.js";
+} from "./cli-yp0d2hp8.js";
 import {
   FileTokenStore,
   defaultConfigDir
-} from "./cli-h7phg3ka.js";
+} from "./cli-v2dze8ja.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-rkqxbnkq.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/{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-swzejnd8.js}

@@ -1,17 +1,17 @@
 import {
   executeAndReport
-} from "./cli-7ykx7pp0.js";
+} from "./cli-yp0d2hp8.js";
 import {
   log
-} from "./cli-h7phg3ka.js";
+} from "./cli-v2dze8ja.js";
 import {
   EXIT_CODES,
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hvqjs342.js";
-import"./cli-5bxx0c4y.js";
-import"./cli-1tyj4bk3.js";
+} from "./cli-rkqxbnkq.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.1",
   "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
-};