gutterpress 0.0.0

package/dist/api/index.js

@@ -0,0 +1,272 @@
+import {
+  APP_HEARTBEAT_FRESH_MS,
+  AUTO_SNAPSHOT_DEFAULT_MINUTES,
+  AUTO_SNAPSHOT_MAX_MINUTES,
+  AUTO_SNAPSHOT_MIN_MINUTES,
+  AUTO_SYNC_DEFAULT_MINUTES,
+  AUTO_SYNC_MAX_MINUTES,
+  AUTO_SYNC_MIN_MINUTES,
+  BUILT_IN_TEMPLATE_IDS,
+  BUILT_IN_THEME_IDS,
+  BuildError,
+  FileTokenStore,
+  GITHUB_HOST,
+  GenericTokenAuthProvider,
+  GitHubAuthProvider,
+  MANIFEST_FILENAMES,
+  PLUGINS_DIR,
+  PublishSelectionsStore,
+  RECOMMENDED_PLUGINS,
+  RepoNeedsRecoveryError,
+  SNIPPETS_DIR,
+  SYNC_SNAPSHOT_MESSAGE,
+  THEMES_DIR,
+  addLocalPlugin,
+  addNpmPlugin,
+  adoptFolder,
+  appHeartbeatPath,
+  applyTheme,
+  autoSnapshotDelayMs,
+  autoSyncDelayMs,
+  buildPreflightDiagnostics,
+  buildRecoveryContext,
+  classifyFromHealth,
+  classifyGitError,
+  cloneRepository,
+  connectGenericHost,
+  connectPublishProvider,
+  defaultConfigDir,
+  deleteSnippet,
+  diagnoseProjectRemote,
+  escapeYamlScalar,
+  extractUrlCredential,
+  extractVariables,
+  forgeKindForHost,
+  getActiveTheme,
+  getPreviousTheme,
+  getSystemDiagnostics,
+  hasProjectManifest,
+  heartbeatTtlMs,
+  importTemplateFromFolder,
+  importThemeFromFile,
+  importThemeFromFolder,
+  importThemeFromUrl,
+  inspectRepo,
+  isAppHeartbeatFresh,
+  isGitInternalPath,
+  isRepoNeedsRecoveryError,
+  isSshRemoteUrl,
+  isUnbornRepo,
+  knownForgeTokenUrl,
+  listBuiltInTemplates,
+  listBuiltInThemes,
+  listCustomTemplates,
+  listGitHubBranches,
+  listGitHubRepositories,
+  listProjectPlugins,
+  listProjectStyles,
+  listProjectThemes,
+  listPublishAccounts,
+  listPublishProviders,
+  listRepoBooks,
+  listSnippets,
+  loadManifestWithPath,
+  migrateUrlCredential,
+  normalizeForgeHost,
+  onlineCopyPath,
+  parseRemoteOrigin,
+  preflightStructuralReason,
+  provenancePath,
+  publishConnectionStatus,
+  publishCredentialKey,
+  publishProviderFor,
+  pullChanges,
+  pushChanges,
+  readAppHeartbeat,
+  readManifestFields,
+  readProjectProvenance,
+  readPublishSettings,
+  readSnippet,
+  readThemeCss,
+  recover,
+  redactCredential,
+  removeAppHeartbeat,
+  removeProjectTheme,
+  resolveActiveStyles,
+  resolveBuiltInTheme,
+  resolveConfig,
+  resolveConflicts,
+  resolveGitHubClientId,
+  resolvePublishRequest,
+  revertTheme,
+  runBuild,
+  runPublish,
+  sanitizeCloneFolderName,
+  saveProjectAsTemplate,
+  saveSnippet,
+  scaffoldProject,
+  setActiveStyles,
+  setManifestFields,
+  setPluginEnabled,
+  setPublishProviderConfig,
+  slugifyProjectName,
+  splitOutPath,
+  startPreviewServer,
+  substituteVariables,
+  syncProject,
+  testRemoteAccess,
+  validateProjectPlugins,
+  verifyRepoReadable,
+  writeAppHeartbeat
+} from "../index-3h3fef7r.js";
+import {
+  AUTO_SNAPSHOT_MESSAGE,
+  HISTORY_PAGE_LIMIT,
+  RESTORE_BACKUP_MESSAGE,
+  isNoChangesError,
+  providerFor,
+  resolveLogger,
+  restoreVersionWithBackup,
+  shortOid
+} from "../index-5bxx0c4y.js";
+import {
+  capabilitiesFor,
+  detectProjectSource,
+  findEnclosingRepoDir,
+  repoSubPath
+} from "../index-1tyj4bk3.js";
+import"../index-yja077f6.js";
+import"../index-37x76zdn.js";
+export {
+  writeAppHeartbeat,
+  verifyRepoReadable,
+  validateProjectPlugins,
+  testRemoteAccess,
+  syncProject,
+  substituteVariables,
+  startPreviewServer,
+  splitOutPath,
+  slugifyProjectName,
+  shortOid,
+  setPublishProviderConfig,
+  setPluginEnabled,
+  setManifestFields,
+  setActiveStyles,
+  scaffoldProject,
+  saveSnippet,
+  saveProjectAsTemplate,
+  sanitizeCloneFolderName,
+  runPublish,
+  runBuild,
+  revertTheme,
+  restoreVersionWithBackup,
+  resolvePublishRequest,
+  resolveLogger,
+  resolveGitHubClientId,
+  resolveConflicts,
+  resolveConfig,
+  resolveBuiltInTheme,
+  resolveActiveStyles,
+  repoSubPath,
+  removeProjectTheme,
+  removeAppHeartbeat,
+  redactCredential,
+  recover,
+  readThemeCss,
+  readSnippet,
+  readPublishSettings,
+  readProjectProvenance,
+  readManifestFields,
+  readAppHeartbeat,
+  pushChanges,
+  pullChanges,
+  publishProviderFor,
+  publishCredentialKey,
+  publishConnectionStatus,
+  providerFor,
+  provenancePath,
+  preflightStructuralReason,
+  parseRemoteOrigin,
+  onlineCopyPath,
+  normalizeForgeHost,
+  migrateUrlCredential,
+  loadManifestWithPath,
+  listSnippets,
+  listRepoBooks,
+  listPublishProviders,
+  listPublishAccounts,
+  listProjectThemes,
+  listProjectStyles,
+  listProjectPlugins,
+  listGitHubRepositories,
+  listGitHubBranches,
+  listCustomTemplates,
+  listBuiltInThemes,
+  listBuiltInTemplates,
+  knownForgeTokenUrl,
+  isUnbornRepo,
+  isSshRemoteUrl,
+  isRepoNeedsRecoveryError,
+  isNoChangesError,
+  isGitInternalPath,
+  isAppHeartbeatFresh,
+  inspectRepo,
+  importThemeFromUrl,
+  importThemeFromFolder,
+  importThemeFromFile,
+  importTemplateFromFolder,
+  heartbeatTtlMs,
+  hasProjectManifest,
+  getSystemDiagnostics,
+  getPreviousTheme,
+  getActiveTheme,
+  forgeKindForHost,
+  findEnclosingRepoDir,
+  extractVariables,
+  extractUrlCredential,
+  escapeYamlScalar,
+  diagnoseProjectRemote,
+  detectProjectSource,
+  deleteSnippet,
+  defaultConfigDir,
+  connectPublishProvider,
+  connectGenericHost,
+  cloneRepository,
+  classifyGitError,
+  classifyFromHealth,
+  capabilitiesFor,
+  buildRecoveryContext,
+  buildPreflightDiagnostics,
+  autoSyncDelayMs,
+  autoSnapshotDelayMs,
+  applyTheme,
+  appHeartbeatPath,
+  adoptFolder,
+  addNpmPlugin,
+  addLocalPlugin,
+  THEMES_DIR,
+  SYNC_SNAPSHOT_MESSAGE,
+  SNIPPETS_DIR,
+  RepoNeedsRecoveryError,
+  RESTORE_BACKUP_MESSAGE,
+  RECOMMENDED_PLUGINS,
+  PublishSelectionsStore,
+  PLUGINS_DIR,
+  MANIFEST_FILENAMES,
+  HISTORY_PAGE_LIMIT,
+  GitHubAuthProvider,
+  GenericTokenAuthProvider,
+  GITHUB_HOST,
+  FileTokenStore,
+  BuildError,
+  BUILT_IN_THEME_IDS,
+  BUILT_IN_TEMPLATE_IDS,
+  AUTO_SYNC_MIN_MINUTES,
+  AUTO_SYNC_MAX_MINUTES,
+  AUTO_SYNC_DEFAULT_MINUTES,
+  AUTO_SNAPSHOT_MIN_MINUTES,
+  AUTO_SNAPSHOT_MESSAGE,
+  AUTO_SNAPSHOT_MAX_MINUTES,
+  AUTO_SNAPSHOT_DEFAULT_MINUTES,
+  APP_HEARTBEAT_FRESH_MS
+};

package/dist/assets/preview/scripts/pagedjs-bridge.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/assets/preview/scripts/pagedjs-interface.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/assets/preview/scripts/preview-shell.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/audit-1jrwwacz.js

@@ -0,0 +1,66 @@
+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/audit.ts
+import { defineCommand } from "citty";
+import { resolve } from "node:path";
+var commandArgs = {
+  dir: {
+    type: "positional",
+    description: "Asset directory (default: cwd)",
+    required: false
+  },
+  input: {
+    type: "string",
+    description: "Asset directory (overrides the positional directory)"
+  },
+  manifest: { type: "string", description: "Path to manifest.yaml" },
+  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" }
+};
+var audit_default = defineCommand({
+  meta: { name: "audit", description: "Run asset-only validation checks" },
+  args: commandArgs,
+  async run({ args, rawArgs }) {
+    const positionalDir = typeof args.dir === "string" ? args.dir : undefined;
+    const inputFlag = typeof args.input === "string" ? args.input : undefined;
+    const inputDir = resolve(inputFlag ?? positionalDir ?? ".");
+    const format = args.format === "json" ? "json" : "text";
+    let result;
+    try {
+      rejectUnknownFlags(rawArgs, commandArgs, "audit");
+      rejectExtraPositionals(args._, 1, "audit");
+      result = await executeAndReport({
+        input: inputDir,
+        manifest: typeof args.manifest === "string" ? args.manifest : undefined,
+        category: "asset",
+        phase: "pre-build",
+        only: typeof args.only === "string" ? args.only : undefined,
+        skip: typeof args.skip === "string" ? args.skip : 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 {
+  audit_default as default
+};

package/dist/build-5s92kgpc.js

@@ -0,0 +1,77 @@
+import {
+  runBuild,
+  splitOutPath
+} from "./cli-7ykx7pp0.js";
+import {
+  log
+} from "./cli-h7phg3ka.js";
+import {
+  BuildError,
+  UsageError,
+  parseFormat,
+  parsePdfxFlavor,
+  rejectExtraPositionals,
+  rejectUnknownFlags
+} from "./cli-hvqjs342.js";
+import"./cli-5bxx0c4y.js";
+import"./cli-1tyj4bk3.js";
+import"./cli-yja077f6.js";
+import"./cli-37x76zdn.js";
+
+// src/commands/build.ts
+import { defineCommand } from "citty";
+import path from "node:path";
+var commandArgs = {
+  input: { type: "positional", description: "Input directory containing markdown files (default: cwd)", required: false },
+  format: { type: "string", description: "Output format: html | pdf | pdfx (default: pdf)" },
+  out: { type: "string", description: "Output directory. For --format pdf|pdfx, --out may also be a .pdf file path." },
+  title: { type: "string", description: "Document title (overrides manifest)" },
+  "pdfx-flavor": { type: "string", description: "PDF/X flavor (x1a or x3). --format pdfx only." },
+  icc: { type: "string", description: "Path to ICC profile (required for --format pdfx)" },
+  manifest: { type: "string", description: "Path to manifest.yaml" },
+  "strip-annotations": { type: "boolean", description: "Strip PDF annotations for PDF/X compliance" },
+  "skip-lint": { type: "boolean", description: "Skip CSS linting (default: lint runs for pdf/pdfx)" },
+  "skip-pre-validate": { type: "boolean", description: "Skip pre-build validation" },
+  "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation" }
+};
+var build_default = defineCommand({
+  meta: {
+    name: "build",
+    description: "Build the book to HTML (static-site desktop), PDF, or PDF/X. Use --format to select. Default: pdf."
+  },
+  args: commandArgs,
+  async run({ args, rawArgs }) {
+    try {
+      rejectUnknownFlags(rawArgs, commandArgs, "build");
+      rejectExtraPositionals(args._, 1, "build");
+      const format = parseFormat(args.format, { default: "pdf" });
+      log.info(`Format: ${format}`);
+      const pdfxFlavor = parsePdfxFlavor(args["pdfx-flavor"], format);
+      const { outDir, pdfFileOverride } = splitOutPath(typeof args.out === "string" ? args.out : undefined, format);
+      await runBuild({
+        inputDir: path.resolve(args.input ?? "."),
+        format,
+        outDir,
+        pdfFileOverride,
+        title: typeof args.title === "string" ? args.title : undefined,
+        pdfxFlavor,
+        iccPath: typeof args.icc === "string" ? args.icc : undefined,
+        manifestPath: typeof args.manifest === "string" ? args.manifest : undefined,
+        stripAnnotations: typeof args["strip-annotations"] === "boolean" ? args["strip-annotations"] : undefined,
+        skipLint: !!args["skip-lint"],
+        skipPreValidate: !!args["skip-pre-validate"],
+        skipPostValidate: !!args["skip-post-validate"],
+        rawArgs: args
+      });
+    } catch (error) {
+      if (error instanceof UsageError || error instanceof BuildError) {
+        log.error(error.message);
+        process.exit(error.exitCode);
+      }
+      throw error;
+    }
+  }
+});
+export {
+  build_default as default
+};

package/dist/chapter-01-6fn9pvd0.md

@@ -0,0 +1,31 @@
+# Overview
+
+This is {{TITLE}}, a technical document. Use this first chapter to tell the
+reader what the document covers and who it is for.
+
+## Getting started
+
+Lead with the shortest path to success. Number the steps so the reader can
+follow along:
+
+1. Describe the first thing the reader should do.
+2. Then the next step, building on the first.
+3. Finish with how they confirm it worked.
+
+## Reference
+
+Use a table when you have a set of options or parameters to document:
+
+| Option    | Default | Description                |
+| --------- | ------- | -------------------------- |
+| `verbose` | `false` | Print extra detail.        |
+| `output`  | `out/`  | Where results are written. |
+
+Use `inline code` for commands and identifiers, and fenced blocks for longer
+examples:
+
+```sh
+gutterpress build
+```
+
+Add more files alongside this one for each chapter or section of your document.

package/dist/chapter-01-7jwqg1ct.md

@@ -0,0 +1,20 @@
+# {{TITLE}}
+
+A zine is short, personal, and made to be photocopied and shared. This page is
+your opening spread — keep it punchy.
+
+Write a few lines that set the tone. A zine does not need to explain itself; it
+just needs a voice.
+
+## A short piece
+
+Drop in a quick column of text, a list of things you love this month, or a tiny
+manifesto:
+
+- One small idea
+- A second, louder one
+- Something to argue about
+
+> A pull quote sets a mood and breaks up the page.
+
+When you are ready, add more pages alongside this one. Fold, staple, repeat.

package/dist/chapter-01-jj8ftn4c.md

@@ -0,0 +1,29 @@
+# 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/chapter-01-rkpyvjna.md

@@ -0,0 +1,26 @@
+# Chapter One
+
+Welcome to {{TITLE}}. This is your first chapter, and it is ready for you to
+make it your own. Everything you see on this page is just an example — replace it
+with your own writing whenever you are ready.
+
+You write in plain text. Start a new paragraph by leaving a blank line, like
+this one. Your words will flow onto the page automatically, and gutterpress takes
+care of turning them into a finished, print-ready book.
+
+## A heading for a new section
+
+Use a single `#` at the start of a line for a chapter title, and `##` for the
+sections inside it. Headings help your readers find their way around, and they
+make your book look polished with no extra effort.
+
+You can make a word **bold** for emphasis, or *slightly softer* with italics.
+You can also gather related points into a list:
+
+- A thought worth remembering
+- Another idea, on its own line
+- And one more to round things out
+
+When you are happy with this chapter, add more files alongside it and they will
+become the next chapters of your book. For now, write a few sentences here and
+watch them appear, beautifully laid out, in the preview.

package/dist/checks/asset/approved-fonts.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/extensions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Canonical file-extension sets shared by every asset check.
+ *
+ * Keeping these in ONE place prevents the divergent glob lists that previously
+ * let some formats be size-checked but silently skipped by the header-reader
+ * checks. Divergence here is a validation-coverage bug, so the sets and their
+ * relationship are pinned by image-extension-coverage.test.ts.
+ */
+/**
+ * Raster formats the in-process header reader (`inspectImage`) can actually
+ * parse. The header-reader checks (color-space, resolution, alpha) operate
+ * ONLY over these — they read embedded metadata, which requires a supported
+ * parser. This set is the source of truth for inspectImage's real capability;
+ * do not add a format here unless inspectImage can decode its header.
+ */
+export declare const RASTER_INSPECTABLE_EXTS: readonly ["png", "jpg", "jpeg", "tiff", "tif"];
+/**
+ * Every image extension treated as an "image asset" for byte-level checks
+ * (e.g. file size) that do not decode the header. Superset of
+ * RASTER_INSPECTABLE_EXTS; the extras (webp/svg/gif) are size-checked but
+ * INTENTIONALLY exempt from header inspection because inspectImage cannot
+ * parse them. This exemption is the documented coverage gap — expanding it
+ * requires teaching inspectImage the new format first.
+ */
+export declare const ALL_IMAGE_EXTS: readonly ["png", "jpg", "jpeg", "tiff", "tif", "webp", "svg", "gif"];
+/** Font file extensions shared by the approved-fonts and font-license checks. */
+export declare const FONT_EXTS: readonly ["woff", "woff2", "otf", "ttf", "eot"];
+/**
+ * Directories no asset scan should ever descend into, as glob patterns.
+ *
+ * ONE list, applied at the GLOB level by every asset scan (images and fonts
+ * alike). Doing the exclusion here rather than by choosing which directories
+ * to hand the scanner is what keeps root-level files covered: a previous
+ * approach swapped the project root for its subdirectories whenever an ignored
+ * directory existed, which silently dropped every file sitting at the root —
+ * and scanned NOTHING at all for a project whose only subdirectory was `dist`.
+ *
+ * `dist` is excluded because it holds the build's own copies of the author's
+ * assets; scanning it would double-report every image against itself.
+ */
+export declare const ASSET_SCAN_IGNORE_GLOBS: readonly ["**/node_modules/**", "**/.git/**", "**/dist/**"];

package/dist/checks/asset/font-license.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/image-alpha.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/image-color-space.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/image-file-size.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/image-resolution.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/image-tac.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/asset/index.d.ts

@@ -0,0 +1,7 @@
+import "./image-file-size";
+import "./image-resolution";
+import "./image-color-space";
+import "./image-alpha";
+import "./image-tac";
+import "./approved-fonts";
+import "./font-license";

package/dist/checks/formatter.d.ts

@@ -0,0 +1,3 @@
+import type { RunnerReport } from "./runner";
+export type OutputFormat = "text" | "json";
+export declare function formatReport(report: RunnerReport, format?: OutputFormat): void;

package/dist/checks/heuristic/index.d.ts

@@ -0,0 +1,4 @@
+import "./text-density";
+import "./section-density";
+import "./layer-count";
+import "./placement-variance";

package/dist/checks/heuristic/layer-count.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/heuristic/placement-variance.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/heuristic/section-density.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/heuristic/text-density.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/pdf/bleed.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/pdf/bookmarks.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/pdf/color-spaces.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/pdf/cross-refs.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/checks/pdf/embedded-fonts.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;