gutterpress 0.0.0

package/dist/repair-jkp4n3j8.js

@@ -0,0 +1,171 @@
+import {
+  buildRecoveryContext,
+  classifyFromHealth,
+  classifyGitError,
+  inspectRepo,
+  isAppHeartbeatFresh,
+  isUnbornRepo,
+  makeManualGuidance,
+  recover,
+  verifyRepoReadable
+} from "./cli-7ykx7pp0.js";
+import {
+  FileTokenStore,
+  defaultConfigDir
+} from "./cli-h7phg3ka.js";
+import {
+  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/repair.ts
+import { defineCommand } from "citty";
+import * as readline from "node:readline/promises";
+import path from "node:path";
+async function promptYesNo(question) {
+  if (!process.stdin.isTTY)
+    return false;
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
+    return answer === "y" || answer === "yes";
+  } finally {
+    rl.close();
+  }
+}
+function describeRepair(req) {
+  const lines = [
+    "",
+    `  ${req.summary}`,
+    "",
+    `  • Changes your project files:        ${req.willChangeLocalFiles ? "yes" : "no"}`,
+    `  • Changes version-history internals: ${req.willChangeGitMetadata ? "yes" : "no"}`,
+    `  • Changes anything online:           ${req.willChangeRemote ? "yes" : "no"}`
+  ];
+  if (req.backupZipPath) {
+    lines.push(`  • Safety copy saved first:           ${req.backupZipPath}`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function printResult(result) {
+  console.log(result.message);
+  if ("guidance" in result && result.guidance) {
+    const g = result.guidance;
+    console.log(`
+Next step: ${g.recommendedNextStep}`);
+    for (const step of g.safeNextSteps ?? [])
+      console.log(`  - ${step}`);
+    if (g.supportDetails)
+      console.log(`
+Details (for support): ${g.supportDetails}`);
+  }
+  if ("backupZipPath" in result && result.backupZipPath) {
+    console.log(`
+Safety copy: ${result.backupZipPath}`);
+  }
+}
+function terminalConfirmationGate(autoApprove) {
+  return {
+    confirmRepair: async (req) => {
+      console.log(describeRepair(req));
+      if (autoApprove) {
+        console.log("Proceeding (--yes).");
+        return true;
+      }
+      return promptYesNo("Apply this fix?");
+    }
+  };
+}
+var commandArgs = {
+  dir: {
+    type: "positional",
+    description: "Project directory (defaults to the current directory)",
+    required: false
+  },
+  check: {
+    type: "boolean",
+    description: "Diagnose only — never change anything (exit 1 when repair is needed)",
+    default: false
+  },
+  yes: {
+    type: "boolean",
+    description: "Approve the repair without prompting",
+    default: false
+  },
+  force: {
+    type: "boolean",
+    description: "Repair even if the Gutterpress app appears to have this project open",
+    default: false
+  }
+};
+var repair_default = defineCommand({
+  meta: {
+    name: "repair",
+    description: "Diagnose and repair the project's version history"
+  },
+  args: commandArgs,
+  async run({ args, rawArgs }) {
+    try {
+      rejectUnknownFlags(rawArgs, commandArgs, "repair");
+      rejectExtraPositionals(args._, 1, "repair");
+    } catch (error) {
+      if (error instanceof UsageError) {
+        console.error(error.message);
+        process.exitCode = error.exitCode;
+        return;
+      }
+      throw error;
+    }
+    const openedDir = path.resolve(args.dir ?? ".");
+    const ctx = await buildRecoveryContext({
+      projectDir: openedDir,
+      confirmation: terminalConfirmationGate(args.yes),
+      tokenStore: new FileTokenStore(defaultConfigDir())
+    });
+    const health = await inspectRepo({ repoDir: ctx.repoDir, source: ctx.source });
+    let kind = classifyFromHealth(health, { minLockAgeMs: 0 });
+    if (kind === null) {
+      try {
+        await verifyRepoReadable(ctx.repoDir);
+      } catch (err) {
+        if (!isUnbornRepo(ctx.repoDir)) {
+          kind = classifyGitError(err, health);
+        }
+      }
+    }
+    if (kind === null) {
+      console.log("Your project's version history looks healthy. Nothing to repair.");
+      return;
+    }
+    const guidance = makeManualGuidance(ctx, kind);
+    console.log(`Found a problem: ${guidance.userSummary}`);
+    if (args.check) {
+      console.log(`
+Run \`gutterpress repair\` to fix it. ${guidance.recommendedNextStep}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (!args.force && await isAppHeartbeatFresh(ctx.repoDir)) {
+      console.log(`
+The Gutterpress app appears to have this project open. Close it first, or re-run with --force.`);
+      process.exitCode = 1;
+      return;
+    }
+    const result = await recover(kind, ctx);
+    console.log("");
+    printResult(result);
+    if (result.status !== "recovered" && result.status !== "retry_later") {
+      process.exitCode = 1;
+    }
+  }
+});
+export {
+  repair_default as default
+};

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

@@ -0,0 +1,218 @@
+export type CheckSeverity = "error" | "warning" | "info";
+export interface PluginConfig {
+    path?: string;
+    name?: string;
+    /** Exact project-local npm version. Legacy ranges remain informational. */
+    version?: string;
+    /** Named module export to use when the package has no default plugin export. */
+    export?: string;
+    priority?: number;
+    options?: Record<string, unknown>;
+    /**
+     * Per-project enable flag (#30). Absent or `true` = active; `false` = the
+     * entry stays in the manifest (reversible toggle) but is skipped by
+     * `resolveConfig` so it is not loaded at build/preview time.
+     */
+    enabled?: boolean;
+}
+/**
+ * Non-secret, per-provider publish settings (#35), keyed by provider id —
+ * the same spelling as `gutterpress publish --provider <id>`. Secrets (API
+ * keys, tokens) NEVER live in the manifest — they belong to the host's
+ * credential store (CLI: 0600 file under the user config dir; desktop:
+ * Electron safeStorage).
+ */
+/**
+ * The name (label) of the SAVED credential this book uses for a provider, when
+ * the user keeps more than one (e.g. two itch.io accounts). It is NOT a secret
+ * — just a reference into the host credential store's named entries; empty/
+ * absent uses the default (bare-host) credential. This book-level choice
+ * overrides any project/global default.
+ */
+export interface PublishSettings {
+    itch?: {
+        /** itch.io project as `user/game` (the butler push target). */
+        target?: string;
+        /** butler channel name (default: "pdf"). */
+        channel?: string;
+        /** Saved-credential label to use (see PublishSettings doc). */
+        credential?: string;
+    };
+    drivethrurpg?: {
+        /** Existing product page URL, when updating a published title. */
+        productUrl?: string;
+    };
+    kdp?: Record<string, never>;
+    "azure-swa"?: {
+        /** Deploy environment (default: "production"). */
+        env?: string;
+        /** Saved-credential label to use (see PublishSettings doc). */
+        credential?: string;
+    };
+    shopify?: {
+        /** The store domain, e.g. `my-store.myshopify.com`. */
+        shop?: string;
+        /** Existing product GID/id to update instead of creating a new one. */
+        productId?: string;
+        /** Admin GraphQL API version (default: "2026-04"). */
+        apiVersion?: string;
+        /** Saved-credential label to use (see PublishSettings doc). */
+        credential?: string;
+    };
+}
+export interface GutterpressManifest {
+    title?: string;
+    authors?: string[];
+    publish?: PublishSettings;
+    preset?: "dtrpg" | "book";
+    styles?: string[];
+    plugins?: (string | PluginConfig)[];
+    source?: {
+        files?: string[] | null;
+    };
+    pdfx?: {
+        flavor?: "x1a" | "x3";
+        icc?: string;
+        stripAnnotations?: boolean;
+    };
+    page?: {
+        width?: number;
+        height?: number;
+        tolerance?: number;
+    };
+    ink?: {
+        maxTac?: number;
+        tacTolerance?: number;
+    };
+    lint?: {
+        enabled?: boolean;
+        configPath?: string | null;
+    };
+    validate?: {
+        enabled?: boolean;
+        checks?: Record<string, boolean | {
+            enabled?: boolean;
+            severity?: CheckSeverity;
+            options?: Record<string, unknown>;
+        }>;
+        source?: {
+            markdownlint?: string | false;
+            htmlhint?: string | false;
+            stylelint?: string | false;
+            /**
+             * @deprecated `:::name` container syntax was removed 2026-05-17 and the
+             * callout-validation check it gated was removed at the same time. This
+             * field is now a no-op kept for backward-compatible manifest parsing.
+             * Will be removed in a future major version. See
+             * docs/migrations/2026-05-removing-container-syntax.md.
+             */
+            allowedCallouts?: string[];
+        };
+        assets?: {
+            maxImageSize?: number;
+            minImageDpi?: number;
+            allowedColorSpaces?: string[];
+            allowAlpha?: boolean;
+            approvedFontFiles?: string[];
+            requireFontLicense?: boolean;
+        };
+        pdf?: {
+            requireBookmarks?: boolean;
+            requireTocLinks?: boolean;
+            minImageResolution?: number;
+            forbidTransparency?: boolean;
+            requireBleed?: boolean;
+            bleedSize?: number;
+        };
+        heuristics?: {
+            maxDecorativeLayers?: number;
+            textDensityRange?: {
+                min?: number;
+                max?: number;
+            };
+            maxParagraphsPerSection?: number;
+        };
+    };
+}
+export interface ResolvedPluginConfig {
+    path?: string;
+    name?: string;
+    /** Exact version for a project-local vendored npm plugin. */
+    version?: string;
+    /** Named module export selected as the plugin function. */
+    export?: string;
+    priority: number;
+    options: Record<string, unknown>;
+}
+/**
+ * Fully-resolved config. Every field is a concrete default with one
+ * deliberate exception: `styles` (ARCH finding #2). There is no preset
+ * default for it — `undefined` means "the manifest didn't set one", and
+ * `resolveActiveStyles` (style-resolver.ts) is the single source of truth for
+ * what that resolves to (styles/book.css, else the first discovered `.css`,
+ * else `[]`). Baking a preset default in here defeated that fallback chain.
+ */
+export interface ResolvedConfig {
+    title: string;
+    authors: string[];
+    styles?: string[];
+    plugins: ResolvedPluginConfig[];
+    source: {
+        files: string[] | null;
+    };
+    pdfx: {
+        flavor: "x1a" | "x3";
+        icc: string;
+        stripAnnotations: boolean;
+    };
+    page: {
+        width: number;
+        height: number;
+        tolerance: number;
+    };
+    ink: {
+        maxTac: number;
+        tacTolerance: number;
+    };
+    lint: {
+        enabled: boolean;
+        configPath: string | null;
+    };
+    validate: {
+        enabled: boolean;
+        checks: Record<string, boolean | {
+            enabled?: boolean;
+            severity?: CheckSeverity;
+            options?: Record<string, unknown>;
+        }>;
+        source: {
+            markdownlint: string | false | null;
+            htmlhint: string | false | null;
+            stylelint: string | false | null;
+        };
+        assets: {
+            maxImageSize: number;
+            minImageDpi: number;
+            allowedColorSpaces: string[];
+            allowAlpha: boolean;
+            approvedFontFiles: string[];
+            requireFontLicense: boolean;
+        };
+        pdf: {
+            requireBookmarks: boolean;
+            requireTocLinks: boolean;
+            minImageResolution: number;
+            forbidTransparency: boolean;
+            requireBleed: boolean;
+            bleedSize: number;
+        };
+        heuristics: {
+            maxDecorativeLayers: number;
+            textDensityRange: {
+                min: number;
+                max: number;
+            };
+            maxParagraphsPerSection: number;
+        };
+    };
+}

package/dist/server.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Preview server entry point.
+ *
+ * Loads config via lib/manifest, generates HTML via lib/markdown, and serves
+ * the preview through a node:http + `ws` HTTP+WebSocket server (see
+ * `src/preview/http-server.ts`). Live reload is handled by broadcasting
+ * `full-reload` over the HMR WebSocket whenever the file watcher fires.
+ */
+import type { PreviewServerOptions } from './types';
+export interface PreviewServerHandle {
+    url: string;
+    port: number;
+    host: string;
+    inputPath: string;
+    /** Stop the server, file watcher, and any signal handlers. */
+    stop: () => Promise<void>;
+    /** Switch the watched directory and regenerate HTML. */
+    restart: (newInputPath: string) => Promise<void>;
+}
+export interface StartPreviewServerOptions extends PreviewServerOptions {
+    /**
+     * Install SIGINT/SIGTERM handlers that shut down the server on Ctrl+C.
+     * Defaults to true (CLI usage). Library/embedded callers (Electron+SvelteKit)
+     * should pass false and call handle.stop() themselves.
+     */
+    installSignalHandlers?: boolean;
+}
+/**
+ * Start the preview server backed by a node:http + `ws` HTTP/WebSocket server.
+ *
+ * Returns a handle the caller can use to introspect the URL or stop the server.
+ * CLI callers can simply ignore the handle and rely on SIGINT/SIGTERM.
+ */
+export declare function startPreviewServer(options: StartPreviewServerOptions): Promise<PreviewServerHandle>;

package/dist/source-provider-hp96b5jf.js

@@ -0,0 +1,46 @@
+import {
+  AUTO_SNAPSHOT_MESSAGE,
+  HISTORY_PAGE_LIMIT,
+  RESTORE_BACKUP_MESSAGE,
+  SNAPSHOT_STAGING_MARKER,
+  __repoLockQueueSizeForTests,
+  gitAuthor,
+  gitDirFor,
+  gitScopeFor,
+  hasPendingChanges,
+  hasUncommittedChanges,
+  isNoChangesError,
+  listWorkdirChanges,
+  providerFor,
+  readGitAuthor,
+  resolveGitAuthor,
+  restoreVersionWithBackup,
+  snapshotStagingMarkerPath,
+  snapshotWorkingTreeUnlocked,
+  stageChanges,
+  withRepoLock
+} from "./cli-5bxx0c4y.js";
+import"./cli-1tyj4bk3.js";
+import"./cli-37x76zdn.js";
+export {
+  withRepoLock,
+  stageChanges,
+  snapshotWorkingTreeUnlocked,
+  snapshotStagingMarkerPath,
+  restoreVersionWithBackup,
+  resolveGitAuthor,
+  readGitAuthor,
+  providerFor,
+  listWorkdirChanges,
+  isNoChangesError,
+  hasUncommittedChanges,
+  hasPendingChanges,
+  gitScopeFor,
+  gitDirFor,
+  gitAuthor,
+  __repoLockQueueSizeForTests,
+  SNAPSHOT_STAGING_MARKER,
+  RESTORE_BACKUP_MESSAGE,
+  HISTORY_PAGE_LIMIT,
+  AUTO_SNAPSHOT_MESSAGE
+};

package/dist/test-helpers/testkit.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Shared CLI test-scaffolding kit.
+ *
+ * TEST-ONLY. This module is imported exclusively by `*.test.ts` files — it is
+ * never referenced by production entrypoints (`src/index.ts`, `src/cli.ts`),
+ * so it never lands in the `bun build`/`bun build --compile` output. It exists
+ * to kill the copy-pasted scaffolding that used to live inline in dozens of
+ * test files (`makeTempDir` ~13×, `makeCtx` ~2× for the CheckContext shape,
+ * plus the isomorphic-git repo builders).
+ *
+ * Where copies differed meaningfully, the canonical helper keeps every
+ * behavior via options rather than silently picking one — callers pass the
+ * exact prefix/author/content they relied on.
+ */
+import { spyOn } from "bun:test";
+import type { FsClient } from "isomorphic-git";
+import type { CheckContext } from "../checks/types";
+/**
+ * Create a fresh, unique temp directory under `os.tmpdir()`.
+ *
+ * The `prefix` is purely a human-readable naming segment for the OS-assigned
+ * unique dir (handy when eyeballing leftover fixtures); callers that relied on
+ * a suite-specific prefix pass it through so behavior is byte-identical.
+ */
+export declare function makeTempDir(prefix?: string): Promise<string>;
+/**
+ * Build a {@link CheckContext} for check/policy unit tests, filling the
+ * required fields with defaults and shallow-merging a partial override
+ * (last-write-wins), matching the copies that lived in
+ * `checks.test.ts` / `policy.test.ts`.
+ */
+export declare function makeCtx(partial?: Partial<CheckContext>): CheckContext;
+export interface TestAuthor {
+    name: string;
+    email: string;
+}
+/** The author most recovery-test copies used. */
+export declare const DEFAULT_TEST_AUTHOR: TestAuthor;
+export interface InitRepoOptions {
+    branch?: string;
+    content?: string;
+    message?: string;
+    author?: TestAuthor;
+    fs?: FsClient;
+}
+/**
+ * Initialize a git repo with a single committed `chapter-01.md` and return the
+ * initial commit oid. Every varying bit (branch, file content, commit message,
+ * author, fs impl) is an option so the previously-bespoke copies map onto it
+ * without changing behavior.
+ */
+export declare function initRepo(dir: string, opts?: InitRepoOptions): Promise<string>;
+/**
+ * Like {@link initRepo} but defaults to the `"initial"` commit message the
+ * `makeTestRepo` copies used. Always on `main`. Returns the commit oid.
+ */
+export declare function makeTestRepo(dir: string, opts?: Omit<InitRepoOptions, "branch">): Promise<string>;
+export interface CommitFileOptions {
+    message?: string;
+    author?: TestAuthor;
+    fs?: FsClient;
+}
+/**
+ * Write `body` to `filename` inside an existing repo, stage it and commit.
+ * Defaults the message to `add <filename>` (the copies' convention). Returns
+ * the commit oid.
+ */
+export declare function commitFile(dir: string, filename: string, body: string, opts?: CommitFileOptions): Promise<string>;
+/**
+ * Thrown by {@link stubProcessExit}'s stub instead of actually terminating
+ * the test worker. Carries the exit code so `expect(...).rejects.toThrow(...)`
+ * can assert on it directly.
+ */
+export declare class ProcessExitSignal extends Error {
+    code: number;
+    constructor(code: number);
+}
+/**
+ * Replace `process.exit` with a stub that THROWS a {@link ProcessExitSignal}
+ * instead of ending the process — mirroring real `process.exit()` semantics
+ * (nothing after the call site ever runs) while staying observable in tests.
+ * Command handlers routinely do `log.error(...); process.exit(code);` with no
+ * `return` after — without this, a naive no-op stub would fall through into
+ * whatever code follows and throw on unrelated undefined state.
+ *
+ * Callers MUST `mockRestore()` the returned spy (e.g. in `afterEach`) —
+ * `process` is a shared global across the whole test run, exactly like the
+ * `spyOn`/`mockRestore` discipline documented in
+ * `build-runner.browser-lifecycle.test.ts`.
+ */
+export declare function stubProcessExit(): ReturnType<typeof spyOn<typeof process, "exit">>;

package/dist/theme-0yzvthe8.css

@@ -0,0 +1,65 @@
+/* =============================================================================
+   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-570zmh2t.css

@@ -0,0 +1,58 @@
+/* =============================================================================
+   Clean Book — gutterpress built-in theme (theme.css)
+   A calm, classic long-form book look. Customize the tokens in :root.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #1a1a1a;   /* body text                 */
+  --color-ink-muted:  #555555;   /* captions, secondary text  */
+  --color-accent:     #2b4c7e;   /* headings, links           */
+  --color-paper:      #ffffff;   /* page background           */
+  --color-rule:       #d9d9d9;   /* borders, rules            */
+
+  --font-body:    "Georgia", "Times New Roman", serif;
+  --font-display: "Georgia", "Times New Roman", serif;
+  --font-mono:    "Menlo", "Consolas", monospace;
+
+  --scale-h1: 2.1rem;
+  --scale-h2: 1.5rem;
+  --scale-h3: 1.2rem;
+  --leading:  1.55;
+}
+
+@page {
+  size: 6in 9in;
+  margin: 0.85in 0.75in;
+}
+
+body {
+  color: var(--color-ink);
+  background: var(--color-paper);
+  font-family: var(--font-body);
+  line-height: var(--leading);
+  font-size: 11pt;
+}
+
+h1, h2, h3 {
+  font-family: var(--font-display);
+  color: var(--color-accent);
+  line-height: 1.2;
+  font-weight: 600;
+}
+h1 { font-size: var(--scale-h1); margin: 0 0 0.6em; }
+h2 { font-size: var(--scale-h2); margin: 1.4em 0 0.4em; }
+h3 { font-size: var(--scale-h3); margin: 1.2em 0 0.3em; }
+
+p { margin: 0 0 0.8em; text-align: justify; hyphens: auto; }
+
+a { color: var(--color-accent); text-decoration: none; }
+
+blockquote {
+  margin: 1em 0; padding: 0.2em 0 0.2em 1em;
+  border-left: 3px solid var(--color-rule);
+  color: var(--color-ink-muted); font-style: italic;
+}
+
+code, pre { font-family: var(--font-mono); font-size: 0.9em; }
+
+hr { border: 0; border-top: 1px solid var(--color-rule); margin: 1.5em 0; }

package/dist/theme-6a2fngc8.json

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

package/dist/theme-cd6efzjw.json

@@ -0,0 +1,6 @@
+{
+  "name": "Zine",
+  "author": "gutterpress",
+  "description": "High-contrast, punchy sans-serif look for short photocopier-friendly zines.",
+  "preview": null
+}