gutterpress 0.0.0

package/dist/theme-nya4nqh6.css

@@ -0,0 +1,70 @@
+/* =============================================================================
+   Technical Document — gutterpress built-in theme (theme.css)
+   Clean sans-serif manual look with clear hierarchy. Customize tokens in :root.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #1c1e21;   /* body text                 */
+  --color-ink-muted:  #5a5f66;   /* captions, secondary text  */
+  --color-accent:     #0b5fff;   /* headings, links           */
+  --color-paper:      #ffffff;   /* page background           */
+  --color-tint:       #f3f5f9;   /* code / note fill          */
+  --color-rule:       #d6dae0;   /* borders, rules            */
+
+  --font-body:    "Helvetica Neue", "Segoe UI", Arial, sans-serif;
+  --font-display: "Helvetica Neue", "Segoe UI", Arial, sans-serif;
+  --font-mono:    "SFMono-Regular", "Consolas", "Menlo", monospace;
+
+  --scale-h1: 2.0rem;
+  --scale-h2: 1.45rem;
+  --scale-h3: 1.15rem;
+  --leading:  1.5;
+}
+
+@page {
+  size: 8.5in 11in;
+  margin: 0.9in 1in;
+}
+
+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-ink);
+  font-weight: 600;
+  line-height: 1.25;
+}
+h1 { font-size: var(--scale-h1); margin: 0 0 0.5em; color: var(--color-accent); }
+h2 { font-size: var(--scale-h2); margin: 1.4em 0 0.4em; border-bottom: 1px solid var(--color-rule); padding-bottom: 0.15em; }
+h3 { font-size: var(--scale-h3); margin: 1.2em 0 0.3em; }
+
+p { margin: 0 0 0.7em; }
+
+a { color: var(--color-accent); text-decoration: none; }
+
+code {
+  font-family: var(--font-mono); font-size: 0.88em;
+  background: var(--color-tint); padding: 0.1em 0.35em; border-radius: 3px;
+}
+pre {
+  font-family: var(--font-mono); font-size: 0.85em;
+  background: var(--color-tint); border: 1px solid var(--color-rule);
+  border-radius: 4px; padding: 0.7em 0.9em; overflow: auto;
+}
+pre code { background: none; padding: 0; }
+
+table { width: 100%; border-collapse: collapse; margin: 1em 0; font-size: 0.95em; }
+th, td { border: 1px solid var(--color-rule); padding: 0.4em 0.6em; text-align: left; }
+th { background: var(--color-tint); font-weight: 600; }
+
+blockquote {
+  margin: 1em 0; padding: 0.5em 0.9em;
+  background: var(--color-tint); border-left: 3px solid var(--color-accent);
+  color: var(--color-ink-muted);
+}

package/dist/theme-tqfypc1w.json

@@ -0,0 +1,6 @@
+{
+  "name": "Technical Document",
+  "author": "gutterpress",
+  "description": "Clean sans-serif manual look with clear hierarchy, code styling, and tidy tables.",
+  "preview": null
+}

package/dist/theme-xt0hjb1b.json

@@ -0,0 +1,6 @@
+{
+  "name": "Clean Book",
+  "author": "gutterpress",
+  "description": "A calm, classic book look: serif body, generous margins, restrained accents.",
+  "preview": null
+}

package/dist/theme-zz2ktzqs.css

@@ -0,0 +1,60 @@
+/* =============================================================================
+   Zine — gutterpress built-in theme (theme.css)
+   High-contrast, punchy, photocopier-friendly. Customize the tokens in :root.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #000000;   /* body text                 */
+  --color-ink-muted:  #333333;   /* secondary text            */
+  --color-accent:     #000000;   /* headings (mono, high ink) */
+  --color-paper:      #ffffff;   /* page background           */
+  --color-rule:       #000000;   /* heavy borders, rules      */
+
+  --font-body:    "Helvetica Neue", "Arial", sans-serif;
+  --font-display: "Impact", "Haettenschweiler", "Arial Black", sans-serif;
+  --font-mono:    "Courier New", monospace;
+
+  --scale-h1: 2.8rem;
+  --scale-h2: 1.8rem;
+  --scale-h3: 1.3rem;
+  --leading:  1.4;
+}
+
+@page {
+  size: 5.5in 8.5in;
+  margin: 0.4in;
+}
+
+body {
+  color: var(--color-ink);
+  background: var(--color-paper);
+  font-family: var(--font-body);
+  line-height: var(--leading);
+  font-size: 10pt;
+}
+
+h1, h2, h3 {
+  font-family: var(--font-display);
+  color: var(--color-accent);
+  text-transform: uppercase;
+  letter-spacing: -0.01em;
+  line-height: 0.95;
+  font-weight: 900;
+}
+h1 { font-size: var(--scale-h1); margin: 0 0 0.4em; }
+h2 { font-size: var(--scale-h2); margin: 1.1em 0 0.3em; }
+h3 { font-size: var(--scale-h3); margin: 1em 0 0.25em; }
+
+p { margin: 0 0 0.6em; }
+
+a { color: var(--color-accent); text-decoration: underline; font-weight: 700; }
+
+blockquote {
+  margin: 1em 0; padding: 0.5em 0.8em;
+  border: 2px solid var(--color-rule);
+  font-weight: 700;
+}
+
+hr { border: 0; border-top: 3px solid var(--color-rule); margin: 1em 0; }
+
+code, pre { font-family: var(--font-mono); font-size: 0.95em; }

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared TypeScript interfaces for the Gutterpress CLI
+ *
+ * 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)
+ */
+export interface PreviewServerOptions {
+    /** Input markdown file path or directory (optional, defaults to cwd) */
+    input?: string;
+    /** Debug mode (preserve temporary files) */
+    debug?: boolean;
+    /** Port for preview server */
+    port: number;
+    /**
+     * Hostname to bind to. Defaults to `127.0.0.1` (localhost only).
+     * Pass `0.0.0.0` to expose the server on the local network — opt-in
+     * because the preview serves whatever the user is editing, which may
+     * include unfinished or private content.
+     */
+    host: string;
+    /** Enable verbose logging */
+    verbose: boolean;
+    /** Disable file watching */
+    noWatch: boolean;
+    /** Automatically open browser (default: true) */
+    openBrowser: boolean;
+}

package/dist/utils/file-utils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Simplified file utilities - core file I/O only
+ *
+ * Provides essential file operations: read, write, resolve paths, check existence
+ */
+import { type Dirent } from 'fs';
+/**
+ * Read a file as UTF-8 text
+ * @throws Error if file doesn't exist or can't be read
+ */
+export declare function readFile(filePath: string): Promise<string>;
+/**
+ * Write content to a file, creating parent directories if needed
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+/**
+ * Check if a file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Remove a directory or file recursively
+ * Safe to call even if path doesn't exist
+ */
+export declare function remove(targetPath: string): Promise<void>;
+/**
+ * Create a directory, including parent directories if needed
+ */
+export declare function mkdir(dirPath: string): Promise<void>;
+/**
+ * Check if a path is a directory
+ */
+export declare function isDirectory(targetPath: string): Promise<boolean>;
+/**
+ * Read all files in a directory
+ * @param dirPath Directory path to read
+ * @returns Array of directory entries
+ */
+export declare function readDirectory(dirPath: string): Promise<Dirent[]>;
+/**
+ * Wait for a file to be created
+ * Polls for file existence with exponential backoff
+ *
+ * @param filePath - Path to file to wait for
+ * @param options - Configuration options
+ * @param options.timeout - Maximum wait time in milliseconds (default: 10000)
+ * @param options.interval - Initial polling interval in milliseconds (default: 10)
+ * @returns Promise that resolves when file exists
+ * @throws {Error} If timeout is reached before file appears
+ */
+export declare function waitForFile(filePath: string, options?: {
+    timeout?: number;
+    interval?: number;
+}): Promise<void>;

package/dist/utils/logger.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Leveled logging utility for gutterpress.
+ *
+ * ONE logger for the whole CLI/lib. Two surfaces share a single level state:
+ *
+ *   - Leveled free functions (`debug`/`info`/`warn`/`error`/`success`) —
+ *     timestamped, gated by the current level. Used by the preview server
+ *     internals. `--verbose`/`--debug` calls `setLogLevel('DEBUG')` so
+ *     `debug()` lines become visible; by default (INFO) they are suppressed.
+ *   - The `log` facade object (`log.info`/`log.warn`/`log.error`/`log.success`)
+ *     — clean, prefix-styled command output used by the CLI commands and
+ *     re-exported from `index.ts` for the desktop. Always emitted (it carries
+ *     user-facing command results, not diagnostic chatter), preserving the
+ *     historical `lib/logger` behavior verbatim.
+ */
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+/**
+ * Set the current log level. Messages below this level will be suppressed.
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get the current log level.
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Log a debug message (only shown when log level is DEBUG).
+ */
+export declare function debug(message: string, ...args: unknown[]): void;
+/**
+ * Log an info message (shown at INFO level and above).
+ */
+export declare function info(message: string, ...args: unknown[]): void;
+/**
+ * Log a warning message (shown at WARN level and above).
+ */
+export declare function warn(message: string, ...args: unknown[]): void;
+/**
+ * Log an error message (always shown).
+ */
+export declare function error(message: string, ...args: unknown[]): void;
+/**
+ * Log a success message (shown at INFO level and above).
+ */
+export declare function success(message: string, ...args: unknown[]): void;
+/**
+ * Silence all logs (useful for testing).
+ * Sets to a level higher than WARN so only ERROR still shows.
+ */
+export declare function silence(): void;
+/**
+ * Reset to default log level (INFO).
+ */
+export declare function reset(): void;
+export declare const log: {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+    success(msg: string, ...args: unknown[]): void;
+};

package/dist/validate-k2drs19j.js

@@ -0,0 +1,99 @@
+import {
+  executeAndReport
+} 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/validate.ts
+import { defineCommand } from "citty";
+var commandArgs = {
+  dir: {
+    type: "positional",
+    description: "Project directory (default: cwd). Sets the pre-build source directory unless --input is also given.",
+    required: false
+  },
+  pdf: {
+    type: "string",
+    description: "Path to the PDF file to validate (post-build checks)"
+  },
+  input: {
+    type: "string",
+    description: "Source directory for pre-build checks (overrides the positional directory)"
+  },
+  manifest: {
+    type: "string",
+    description: "Path to manifest.yaml"
+  },
+  category: {
+    type: "string",
+    description: "Comma-separated categories: source, pdf, asset, heuristic"
+  },
+  only: {
+    type: "string",
+    description: "Run only these check IDs/selectors (comma-separated)"
+  },
+  skip: {
+    type: "string",
+    description: "Skip these check IDs/selectors (comma-separated)"
+  },
+  format: {
+    type: "string",
+    description: "Output format: text (default) or json"
+  },
+  phase: {
+    type: "string",
+    description: "Run checks for phase: pre | post | all | pre-build | post-build (default: all)"
+  },
+  profile: {
+    type: "string",
+    description: "Validation profile lock (currently: dtrpg)"
+  }
+};
+var validate_default = defineCommand({
+  meta: {
+    name: "validate",
+    description: "Validate source files and/or PDF for print compliance"
+  },
+  args: commandArgs,
+  async run({ args, rawArgs }) {
+    const format = args.format === "json" ? "json" : "text";
+    const positionalDir = typeof args.dir === "string" ? args.dir : undefined;
+    const inputFlag = typeof args.input === "string" ? args.input : undefined;
+    const input = inputFlag ?? positionalDir;
+    let result;
+    try {
+      rejectUnknownFlags(rawArgs, commandArgs, "validate");
+      rejectExtraPositionals(args._, 1, "validate");
+      result = await executeAndReport({
+        manifest: typeof args.manifest === "string" ? args.manifest : undefined,
+        pdf: typeof args.pdf === "string" ? args.pdf : undefined,
+        input,
+        category: typeof args.category === "string" ? args.category : undefined,
+        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
+      }, format);
+    } catch (error) {
+      log.error(error instanceof Error ? error.message : String(error));
+      process.exit(error instanceof UsageError ? error.exitCode : EXIT_CODES.USAGE);
+    }
+    if (!result.ok) {
+      process.exit(EXIT_CODES.FINDINGS);
+    }
+  }
+});
+export {
+  validate_default as default
+};

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "gutterpress",
+  "version": "0.0.0",
+  "description": "Markdown-to-PDF converter for professional print layout using Paged.js and Ghostscript.",
+  "author": "itlackey",
+  "license": "MPL-2.0",
+  "keywords": [
+    "markdown",
+    "pdf",
+    "print",
+    "pagedjs",
+    "ghostscript",
+    "book",
+    "publishing",
+    "ttrpg"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dimm-city/gutterpress.git"
+  },
+  "homepage": "https://github.com/dimm-city/gutterpress#readme",
+  "bugs": {
+    "url": "https://github.com/dimm-city/gutterpress/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "gutterpress": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "default": "./dist/api/index.js"
+    },
+    "./render": {
+      "types": "./dist/render.d.ts",
+      "default": "./dist/render.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build:library": "rimraf dist && bun build src/index.ts src/api/index.ts --target=node --packages=external --splitting --outdir=dist && bun build src/render.ts --target=node --packages=external --outdir=dist && node scripts/check-render-pure.mjs && tsc -p tsconfig.build.json",
+    "build": "bun run build:library && bun build src/cli.ts --target=node --packages=external --splitting --outdir=dist",
+    "prepublishOnly": "bun run build",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "bun": ">=1.0.0",
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "acorn": "8.16.0",
+    "chokidar": "^5.0.0",
+    "citty": "^0.2.0",
+    "diff3": "0.0.3",
+    "es-module-lexer": "2.0.0",
+    "fflate": "0.8.3",
+    "glob": "^13.0.0",
+    "htmlhint": "^1.9.2",
+    "isomorphic-git": "^1.38.4",
+    "markdown-it": "^14.1.0",
+    "markdown-it-abbr": "^2.0.0",
+    "markdown-it-attrs": "^4.3.0",
+    "markdown-it-deflist": "^3.0.1",
+    "markdown-it-footnote": "^4.0.0",
+    "markdown-it-mark": "^4.0.0",
+    "markdown-it-source-map": "^0.1.1",
+    "markdown-it-sub": "^2.0.0",
+    "markdown-it-sup": "^2.0.0",
+    "markdownlint": "^0.40.0",
+    "pdf-lib": "^1.17.1",
+    "postcss": "^8.5.18",
+    "puppeteer-core": "^25.0.4",
+    "resolve.exports": "2.0.3",
+    "semver": "7.8.0",
+    "tar": "7.5.20",
+    "unpdf": "^1.6.2",
+    "ws": "^8.21.0",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^22.0.0",
+    "@types/semver": "^7.7.1",
+    "@types/ws": "^8.5.13",
+    "pagedjs": "^0.4.3",
+    "playwright": "^1.60.0",
+    "rimraf": "^6.0.0",
+    "typescript": "^5"
+  }
+}