gutterpress 0.11.21 → 0.11.22-alpha.1

package/dist/index.js

@@ -4,58 +4,42 @@ import {
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
-  BUILT_IN_STYLE_SET_IDS,
   BUILT_IN_TEMPLATE_IDS,
-  BUNDLED_EXTENSIONS,
-  DEFAULT_NPM_REGISTRY,
-  EXTENSIONS_DIR,
   EXTENSION_KINDS,
-  EXTENSION_MANIFEST_FILENAME,
   FileTokenStore,
   GDRIVE_HOST,
   GITHUB_HOST,
   GOOGLE_NOT_CONFIGURED_MESSAGE,
   GitHubAuthProvider,
   GoogleAuthProvider,
-  MANIFEST_FILENAMES,
   MAX_SEARCH_BYTES,
-  PRESETS,
-  PRESET_IDS,
   PublishSelectionsStore,
-  RECOMMENDED_EXTENSIONS,
   REPAIR_SNAPSHOT_MESSAGE,
   RESERVED_PREFIX,
   SEARCH_KEYWORDS,
   SNIPPETS_DIR,
   SYNC_SNAPSHOT_MESSAGE,
-  TARGETS,
-  TARGET_IDS,
-  addBuiltInStyleSet,
-  addExtension,
+  VERSION_CHANGES_SHOWN,
   adoptFolder,
-  assertExtensionContained,
   autoSnapshotDelayMs,
   autoSyncDelayMs,
   checkCss,
-  checkExtensionUpdates,
   checkRemoteUpdates,
   checkToolAvailability,
   cloneRepository,
+  compareVersionFile,
   connectGenericHost,
   connectGoogleDrive,
   connectPublishProvider,
   defaultConfigDir,
   deleteSnippet,
-  describeExtension,
+  describeVersions,
   diagnoseProjectRemote,
   disconnectPublishCredential,
-  ensureProjectGitignore,
   escapeYamlScalar,
   executeAndReport,
   executeValidation,
-  extensionCarries,
-  extensionEntry,
-  extensionStyleList,
+  exportVersionTree,
   extractUrlCredential,
   extractVariables,
   forgeKindForHost,
@@ -63,18 +47,15 @@ import {
   getCheckById,
   getChecks,
   getSystemDiagnostics,
-  hasProjectManifest,
   importExtensionFromFile,
   importExtensionFromUrl,
   importTemplateFromFolder,
   inspectImage,
-  isBundledExtension,
   isGitInternalPath,
-  isPathSpecifier,
   isSshRemoteUrl,
   isValidRepositoryName,
   knownForgeTokenUrl,
-  listBuiltInStyleSets,
+  listBookPublishProviders,
   listBuiltInTemplates,
   listCustomTemplates,
   listGitHubBranches,
@@ -82,49 +63,34 @@ import {
   listLocationVariants,
   listMarkerComponents,
   listMergedSnippets,
-  listNpmVersions,
-  listProjectExtensions,
+  listOnlineVersions,
   listProjectStyles,
   listPublishAccounts,
   listPublishProviders,
   listRepoBooks,
   listSnippets,
-  loadManifest,
-  loadManifestWithPath,
-  log,
-  npmRegistryUrl,
   openPath,
-  parseExtensionSpecifier,
   parseRemoteOrigin,
-  pathEscapesFolder,
   pkceChallengeFromVerifier,
   publishConnectionStatus,
   publishCredentialKey,
   publishProviderFor,
-  publishTargetFor,
-  readExtensionCss,
-  readExtensionMeta,
   readManifestFields,
   readPageSetup,
   readPublishSettings,
   refreshRemoteCopies,
-  removeExtension,
-  reorderExtensions,
   repairOnlineBackup,
   reportMissingTools,
   requireGoogleClientCredentials,
   resolveActiveStyles,
   resolveCheckSelectors,
-  resolveConfig,
-  resolveExtension,
   resolveExtensionPrefix,
   resolveGitHubClientId,
   resolveGoogleClientId,
   resolveGoogleClientSecret,
   resolvePublishFormat,
+  resolvePublishProvider,
   resolvePublishRequest,
-  restoreFailureMessage,
-  restorePinnedExtensions,
   revokeGoogleCredential,
   ruleRemoteUrls,
   ruleRiskyProps,
@@ -132,7 +98,6 @@ import {
   runBuild,
   runChecks,
   runPublish,
-  sameExtension,
   sanitizeCloneFolderName,
   saveProjectAsTemplate,
   saveSnippet,
@@ -141,7 +106,6 @@ import {
   scorchedEarth,
   searchNpmExtensions,
   setActiveStyles,
-  setExtensionEnabled,
   setManifestFields,
   setPageSetup,
   setPublishProviderConfig,
@@ -151,17 +115,65 @@ import {
   startPreviewServer,
   substituteVariables,
   syncProject,
-  testRemoteAccess,
+  testRemoteAccess
+} from "./index-tkjvs1gf.js";
+import {
+  BUILT_IN_STYLE_SET_IDS,
+  BUNDLED_EXTENSIONS,
+  DEFAULT_NPM_REGISTRY,
+  EXTENSIONS_DIR,
+  MANIFEST_FILENAMES,
+  PRESETS,
+  PRESET_IDS,
+  RECOMMENDED_EXTENSIONS,
+  TARGETS,
+  TARGET_IDS,
+  addBuiltInStyleSet,
+  addExtension,
+  checkExtensionUpdates,
+  describeExtension,
+  ensureProjectGitignore,
+  hasProjectManifest,
+  isBundledExtension,
+  isPathSpecifier,
+  listBuiltInStyleSets,
+  listNpmVersions,
+  listProjectExtensions,
+  loadManifest,
+  loadManifestWithPath,
+  npmRegistryUrl,
+  parseExtensionSpecifier,
+  publishTargetFor,
+  readExtensionCss,
+  removeExtension,
+  reorderExtensions,
+  resolveConfig,
+  restoreFailureMessage,
+  restorePinnedExtensions,
+  sameExtension,
+  setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-mr7zs8mv.js";
+} from "./index-dm7hx46j.js";
+import {
+  EXTENSION_MANIFEST_FILENAME,
+  assertExtensionContained,
+  extensionCarries,
+  extensionEntry,
+  extensionStyleList,
+  log,
+  pathEscapesFolder,
+  readExtensionMeta,
+  resolveExtension
+} from "./index-38e18a7j.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-t7r8g75c.js";
+} from "./index-gmfh6n05.js";
+import"./index-5h9a38jn.js";
 import {
   BuildError
-} from "./index-mr72vt8n.js";
+} from "./index-dhknsvfz.js";
 import"./index-sth219v1.js";
 import {
   DEFAULT_PRINT_OPTS,
@@ -171,7 +183,6 @@ import {
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
-  PLUGINS_DIR,
   RESTORE_BACKUP_MESSAGE,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   countUnversionedChanges,
@@ -182,7 +193,10 @@ import {
   restoreVersionWithBackup,
   switchBranch,
   whenGitIdle
-} from "./index-qf7y4d85.js";
+} from "./index-93pqkvty.js";
+import {
+  PLUGINS_DIR
+} from "./index-r7jcsk6h.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -227,6 +241,7 @@ export {
   restorePinnedExtensions,
   restoreFailureMessage,
   resolvePublishRequest,
+  resolvePublishProvider,
   resolvePublishFormat,
   resolveLogger,
   resolveGoogleClientSecret,
@@ -271,6 +286,7 @@ export {
   listPublishAccounts,
   listProjectStyles,
   listProjectExtensions,
+  listOnlineVersions,
   listNpmVersions,
   listMergedSnippets,
   listMarkerComponents,
@@ -281,6 +297,7 @@ export {
   listCustomTemplates,
   listBuiltInTemplates,
   listBuiltInStyleSets,
+  listBookPublishProviders,
   knownForgeTokenUrl,
   isValidRepositoryName,
   isSshRemoteUrl,
@@ -304,6 +321,7 @@ export {
   extensionStyleList,
   extensionEntry,
   extensionCarries,
+  exportVersionTree,
   executeValidation,
   executeAndReport,
   escapeYamlScalar,
@@ -311,6 +329,7 @@ export {
   disconnectPublishCredential,
   diagnoseProjectRemote,
   detectProjectSource,
+  describeVersions,
   describeExtension,
   deleteSnippet,
   defaultConfigDir,
@@ -318,6 +337,7 @@ export {
   connectPublishProvider,
   connectGoogleDrive,
   connectGenericHost,
+  compareVersionFile,
   cloneRepository,
   checkToolAvailability,
   checkRemoteUpdates,
@@ -331,6 +351,7 @@ export {
   adoptFolder,
   addExtension,
   addBuiltInStyleSet,
+  VERSION_CHANGES_SHOWN,
   TARGET_IDS,
   TARGETS,
   SYNC_SNAPSHOT_MESSAGE,

package/dist/lib/extension-manifest.d.ts

@@ -70,6 +70,15 @@ export interface ExtensionMetadata {
      * does the merge.
      */
     snippets?: string;
+    /**
+     * `gutterpress.publish: true` — EXPERIMENTAL (#381): the package is a
+     * publishing plugin. Its entry (npm `main`/`exports`, or a folder's `main`)
+     * exports a named `publish` function and contributes NO markdown-it plugin,
+     * so the markdown loader skips it without importing it. A boolean, not a
+     * path: it lets core recognise a publisher from package.json alone, without
+     * executing its code. Anything other than literal `true` reads as absent.
+     */
+    publish?: boolean;
     /**
      * npm `engines.gutterpress` — the Gutterpress versions the extension works
      * with, as a semver range (e.g. `">=0.11.20-alpha.3"`). Checked when the
@@ -98,7 +107,8 @@ export declare function extensionStyleList(meta: ExtensionMetadata): string[];
  * The markdown-it entry of a FOLDER extension: an explicit
  * `gutterpress.markdown` when the package's `main` is not the plugin,
  * otherwise npm's own `main`. `undefined` for a folder that carries no
- * markdown behaviour at all (a look).
+ * markdown behaviour at all (a look, or a publishing plugin — whose `main` is
+ * its publish module, not a markdown-it plugin).
  */
 export declare function extensionEntry(meta: ExtensionMetadata): string | undefined;
 /** What an extension declares, by field — the desktop's one-list filter. */
@@ -107,8 +117,19 @@ export interface ExtensionCarries {
     styles: boolean;
     snippets: boolean;
     components: boolean;
+    /** A publishing plugin (experimental, #381). */
+    publish: boolean;
 }
 export declare function extensionCarries(meta: ExtensionMetadata): ExtensionCarries;
+/**
+ * A publishing plugin (experimental, #381) is a publisher and nothing else:
+ * its entry is never imported while a book renders, so a markdown entry,
+ * styles, components or snippets it also declared would either load (a
+ * folder) or be dropped without a word (a vendored copy). One rule, checked
+ * here, keeps both load paths and the publish path agreeing. Not a listing
+ * guard — `readExtensionMeta` stays tolerant.
+ */
+export declare function assertPublishOnly(meta: ExtensionMetadata, ref: string): void;
 /**
  * True when a declared relative path escapes its own folder (absolute, or a
  * `..` segment) — the traversal shape every containment check in this

package/dist/lib/markdown/plugins.d.ts

@@ -1,4 +1,5 @@
 import type { ResolvedExtensionConfig } from "../../schema/manifest.types";
+import type { PublishPluginFunction } from "../publish/types";
 import type { LoadedPlugin } from "./renderer";
 export type { GutterpressComponent, GutterpressComponentBlock, GutterpressComponentProblem, GutterpressMarkerDeclaration, GutterpressMarkerLabel, GutterpressMarkerTable, GutterpressPlugin, GutterpressPluginMetadata, GutterpressPluginExport, LoadedPlugin, } from "./renderer";
 export { applyPlugins, collectPluginCss, collectPluginStylePaths, collectPluginStyleGroups } from "./renderer";
@@ -7,6 +8,25 @@ import { type PluginStyleGroup } from "./renderer";
 /** Test-only: reset the path-plugin cache between test cases. */
 export declare function __resetPathPluginCacheForTests(): void;
 export declare function loadPlugin(config: ResolvedExtensionConfig, baseDir: string): Promise<LoadedPlugin>;
+/** Where a publishing plugin's package sits, as discovery found it. */
+export interface PublishPluginLocation {
+    /** The package folder: a `path:` folder, or the vendored copy's package dir. */
+    dir: string;
+    /** The vendored install root of an npm entry; `null` for a folder. */
+    installRoot: string | null;
+    /** The manifest spelling, for messages. */
+    ref: string;
+}
+/**
+ * EXPERIMENTAL (#381): import a publishing plugin's entry and return its
+ * named `publish` export. Only the publish path calls this — never a build or
+ * preview (see the skip in {@link loadPlugin}). The package is the one
+ * discovery located, so there is no second lookup and no fall-through to a
+ * same-named package elsewhere: a vendored copy loads through
+ * {@link importVendoredEntry}, a folder's `main` through the mtime cache, so
+ * the long-lived desktop host sees edits.
+ */
+export declare function loadPublishFunction({ dir, installRoot, ref }: PublishPluginLocation): Promise<PublishPluginFunction>;
 /**
  * Load all plugins from the resolved configuration.
  *

package/dist/lib/markdown/two-versions.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `two_versions` — renders a passage the converge merge left with TWO
+ * versions as two labelled boxes instead of broken markdown.
+ *
+ * After a sync that found a passage edited both here and online, the file
+ * holds both versions inside the marker family `two-versions-markers.ts`
+ * spells out. Those lines are valid markdown — `=======` is a setext
+ * underline, `>>>>>>>` seven nested blockquotes — so until this rule the
+ * preview showed the author's paragraph as a chapter-sized heading, listed
+ * `<<<<<<< your version` in the outline, and gave no way to read either
+ * version as it would print. The `source.sync.merge-markers` check still
+ * reports every block as an error, so a build never ships one; this rule
+ * only decides what the LIVE PREVIEW shows while the author chooses.
+ *
+ * The output is plain HTML + CSS: a `div.gp-two-versions` holding two
+ * `div.gp-version`s (`-yours`, `-online`), each labelled through
+ * `data-label` and each parsed as ordinary block markdown, so a heading or
+ * a list inside a version renders as one. No viewer or print code reads
+ * these classes; `TWO_VERSIONS_CSS` is the whole styling. Matching is as
+ * exact as the check's: the three fixed lines, at the start of a line, in
+ * order; anything else (a bare `=======`, a half-deleted family) is left
+ * to markdown as before.
+ */
+import type MarkdownIt from "markdown-it";
+/** The styling for the block above — injected by assemble.ts with MARKER_CSS. */
+export declare const TWO_VERSIONS_CSS = "\n.gp-two-versions {\n  margin: 1em 0;\n  border: 2px dashed #b7791f;\n  border-radius: 6px;\n  break-inside: avoid;\n}\n.gp-two-versions > .gp-version {\n  padding: 0.5em 0.9em;\n}\n.gp-two-versions > .gp-version + .gp-version {\n  border-top: 2px dashed #b7791f;\n}\n.gp-two-versions > .gp-version > .gp-version-text {\n  margin: 0;\n  white-space: pre-wrap;\n  overflow-wrap: anywhere;\n  font-size: 0.85em;\n}\n.gp-two-versions > .gp-version::before {\n  content: attr(data-label);\n  display: block;\n  margin-bottom: 0.35em;\n  font-family: system-ui, sans-serif;\n  font-size: 0.7em;\n  font-weight: 700;\n  letter-spacing: 0.06em;\n  text-transform: uppercase;\n  color: #b7791f;\n}\n";
+/**
+ * markdown-it plugin. Before `html_block` so the `<` opener is ours first;
+ * listed as a paragraph terminator so a block that starts right under a
+ * line of prose (as the merge writes it) still opens.
+ */
+export default function gpTwoVersions(md: MarkdownIt): void;

package/dist/lib/publish/plugin-provider.d.ts

@@ -0,0 +1,16 @@
+import type { PublishProvider, PublishProviderInfo } from "./types.ts";
+/** The book whose `extensions:` are searched — the pair runPublish takes. */
+export interface PublishBook {
+    projectDir: string;
+    manifestPath?: string;
+}
+/** Built-in providers, then the book's enabled publishing plugins. Reads
+ *  package.json only; a book whose manifest can't be read lists the built-ins. */
+export declare function listBookPublishProviders(book: PublishBook): Promise<PublishProviderInfo[]>;
+/**
+ * The provider for `id`: a built-in (exactly as `publishProviderFor`), else
+ * one of the book's publishing plugins. An npm entry of that name is restored
+ * first, so a fresh clone can publish. Throws on an unknown id, naming every
+ * destination the book has.
+ */
+export declare function resolvePublishProvider(id: string, book: PublishBook): Promise<PublishProvider>;

package/dist/lib/publish/run-publish.d.ts

@@ -1,4 +1,4 @@
-import type { PreflightIssue, PublishArtifactFormat, PublishDeps, PublishOutcome, PublishProviderInfo, PublishRequest } from "./types.ts";
+import type { PreflightIssue, PublishArtifactFormat, PublishDeps, PublishOutcome, PublishProvider, PublishProviderInfo, PublishRequest } from "./types.ts";
 export interface RunPublishOptions {
     projectDir: string;
     providerId: string;
@@ -10,6 +10,12 @@ export interface RunPublishOptions {
     artifactPath?: string;
     /** Stop after preflight — report issues without contacting the platform. */
     dryRun?: boolean;
+    /**
+     * The provider, when the caller has already resolved it (the CLI does, to
+     * map a failed restore to its own exit code): no second lookup or restore.
+     * Default: {@link resolvePublishProvider}(`providerId`).
+     */
+    provider?: PublishProvider;
 }
 export interface RunPublishResult {
     ok: boolean;
@@ -33,11 +39,13 @@ export interface RunPublishResult {
  * with a preflight error over one bad manifest field.
  */
 export declare function resolvePublishFormat(info: PublishProviderInfo, providerConfig: Record<string, unknown>): PublishArtifactFormat;
+type RequestOptions = Pick<RunPublishOptions, "projectDir" | "providerId" | "manifestPath" | "artifactPath">;
 /**
- * Resolve the {@link PublishRequest} for a provider from the project's
- * manifest — shared by `runPublish` and by hosts that call individual
- * provider methods (authenticate, listProducts) outside a full publish.
+ * Resolve the {@link PublishRequest} for a BUILT-IN provider from the
+ * project's manifest — for hosts that call individual provider methods
+ * (authenticate, listProducts, destinations) outside a full publish.
  */
-export declare function resolvePublishRequest(options: Pick<RunPublishOptions, "projectDir" | "providerId" | "manifestPath" | "artifactPath">, deps: PublishDeps): Promise<PublishRequest>;
+export declare function resolvePublishRequest(options: RequestOptions, deps: PublishDeps): Promise<PublishRequest>;
 /** Preflight → authenticate → upload, with structured results throughout. */
 export declare function runPublish(options: RunPublishOptions, deps: PublishDeps): Promise<RunPublishResult>;
+export {};

package/dist/lib/publish/types.d.ts

@@ -39,13 +39,17 @@ export type PublishProviderId = "local" | "itch" | "drivethrurpg" | "kdp" | "azu
  *   - "api"    — real programmatic upload (itch.io, Azure SWA, Shopify)
  *   - "guided" — no upload API exists; we validate + stage a package and open
  *                the platform's upload page with a checklist (DTRPG, KDP)
+ *   - "plugin" — a publishing plugin (experimental, #381): the book's own
+ *                extension runs the upload and handles its own sign-in
  */
-export type PublishProviderKind = "api" | "guided";
+export type PublishProviderKind = "api" | "guided" | "plugin";
 /** Which build output the provider consumes. */
 export type PublishArtifactFormat = "pdf" | "html";
 /** Static, UI-facing description of a provider. */
 export interface PublishProviderInfo {
-    id: PublishProviderId;
+    /** A built-in {@link PublishProviderId}, or a publishing plugin's package
+     *  name (experimental, #381). */
+    id: string;
     /** Human name ("itch.io"). */
     label: string;
     kind: PublishProviderKind;
@@ -106,7 +110,35 @@ export interface PublishProviderInfo {
         label: string;
         canCreate: boolean;
     };
+    /** A badge, not a kind: the provider may change or go away. Set on every
+     *  publishing plugin today (#381). */
+    experimental?: true;
+}
+export interface PublishPluginContext {
+    project: {
+        dir: string;
+        title: string;
+        authors: string[];
+    };
+    /** The one build output validated for this run: a PDF file, or the
+     *  website export directory. */
+    artifact: PublishArtifact;
+    /** The manifest's `publish.<package-name>` section, minus the two keys core
+     *  reads from it: `format` (which build to publish) and `credential`. */
+    settings: Record<string, unknown>;
+    /** Progress line sink. Use this, never `console.log`: stdout carries
+     *  `--json` output. */
+    log: (message: string) => void;
+}
+export interface PublishPluginResult {
+    /** Where the published work lives — kept only when it is an http(s) URL. */
+    url?: string;
+    /** One-line summary shown to the author. */
+    detail?: string;
 }
+/** `outputDir` is the folder holding `context.artifact.path`: the website
+ *  export directory for html, the PDF's folder for pdf. */
+export type PublishPluginFunction = (outputDir: string, context: PublishPluginContext) => Promise<PublishPluginResult | void>;
 /** The project being published (resolved from the manifest by the orchestrator). */
 export interface PublishProject {
     projectDir: string;

package/dist/lib/text-diff.d.ts

@@ -0,0 +1,43 @@
+/**
+ * text-diff.ts — a small two-way sequence diff for the Versions view.
+ *
+ * Two readers: the what-changed hint on a version card ("3 paragraphs
+ * changed") and the side-by-side file compare (lines aligned, changed ones
+ * marked). Myers' O(ND) algorithm over any array, with a budget: when two
+ * texts have almost nothing in common the edit script is as long as both
+ * texts and the trace would grow with its square, so past the budget the
+ * result is "everything after the common ends changed" — honest for the
+ * hint, readable in the compare view, and bounded in memory. Pure, no I/O.
+ */
+export type DiffOp<T> = {
+    kind: "equal";
+    a: T;
+    b: T;
+} | {
+    kind: "delete";
+    a: T;
+} | {
+    kind: "insert";
+    b: T;
+};
+export declare function diffSequences<T>(a: readonly T[], b: readonly T[]): DiffOp<T>[];
+/**
+ * How many items changed, counting an edited item once: each run of
+ * deletes and inserts counts as the larger of the two, so a reworded
+ * paragraph is "1 paragraph changed", not a removal plus an addition.
+ */
+export declare function countChanged<T>(ops: readonly DiffOp<T>[]): number;
+/** One row of the side-by-side compare: a line on each side, or a gap. */
+export interface CompareRow {
+    then: string | null;
+    now: string | null;
+    changed: boolean;
+}
+/**
+ * Lay a line diff out as two aligned columns: equal lines share a row;
+ * within a changed run the removed and added lines pair up in order and
+ * the longer side's extra lines face a gap.
+ */
+export declare function alignRows(ops: readonly DiffOp<string>[]): CompareRow[];
+/** Split into lines for diffing; a CR before the break is not content. */
+export declare function textLines(text: string): string[];

package/dist/lib/two-versions-markers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The exact lines a converge merge writes around a passage edited both here
+ * and online (`remote-auth/converge-merge.ts`):
+ *
+ *     <<<<<<< your version
+ *     …the passage as edited on this computer…
+ *     =======
+ *     …the passage as edited online…
+ *     >>>>>>> online version
+ *
+ * Three consumers read them back and must agree byte for byte: the merge
+ * that writes them, the `source.sync.merge-markers` check that reports them,
+ * and the markdown rule that renders them as two labelled versions instead
+ * of a setext heading (`markdown/two-versions.ts`). This file imports
+ * nothing, so the node-free `/render` graph can depend on it too.
+ *
+ * (The desktop's editor panel keeps its own copy of the two sentinels — the
+ * renderer may not value-import the lib — pinned to the merge's real output
+ * by `packages/desktop/tests/editor/two-versions.test.ts`.)
+ */
+/** Marker labels — author language, never git jargon. */
+export declare const YOUR_VERSION_LABEL = "your version";
+export declare const ONLINE_VERSION_LABEL = "online version";
+export declare const TWO_VERSIONS_OPEN = "<<<<<<< your version";
+export declare const TWO_VERSIONS_SEPARATOR = "=======";
+export declare const TWO_VERSIONS_CLOSE = ">>>>>>> online version";

package/dist/lib/version-changes.d.ts

@@ -0,0 +1,87 @@
+import { type SnapshotEntry } from "./source-provider.ts";
+import { defaultGitHttp } from "./remote-auth/git-http.ts";
+import type { HostCredential, TokenStore } from "./remote-auth/token-store.ts";
+import { type CompareRow } from "./text-diff.ts";
+export type { CompareRow };
+export interface VersionFileChange {
+    /** Repo-relative path, forward slashes. */
+    path: string;
+    kind: "added" | "removed" | "changed";
+    /** Plain size hint: "3 paragraphs changed", "1 rule changed", "replaced", "added", "removed". */
+    hint: string;
+    /** Both sides are text, so the compare view can show them. */
+    text: boolean;
+}
+export interface VersionChanges {
+    files: VersionFileChange[];
+    /** Changed files beyond the ones listed (the list is capped). */
+    more: number;
+}
+/** A history entry with what it changed and where it is kept. */
+export interface VersionEntry extends SnapshotEntry {
+    changes: VersionFileChange[];
+    moreChanges: number;
+    /** True = online too; false = on this computer only; null = no online copy to compare with. */
+    backedUp: boolean | null;
+}
+/** How many changed files a version card lists before "and N more". */
+export declare const VERSION_CHANGES_SHOWN = 8;
+/** The size hint for a text file that changed between two versions. */
+export declare function changeHint(filepath: string, before: string, after: string): string;
+/**
+ * The files `oid` changed against its first parent (every file, for a
+ * version with no parent), sorted by path and capped to
+ * {@link VERSION_CHANGES_SHOWN}.
+ */
+export declare function listVersionChanges(dir: string, oid: string, options?: {
+    cache?: object;
+}): Promise<VersionChanges>;
+/**
+ * A history page with each version's changes and whether it is backed up.
+ * Versions come newest-first, and everything older than the first backed-up
+ * one is backed up too, so the ancestry walk runs only over the versions
+ * that are on this computer only.
+ */
+export declare function describeVersions(projectDir: string, entries: SnapshotEntry[]): Promise<VersionEntry[]>;
+/**
+ * The commits reachable from `fromOid` that `baseOid`'s history does not
+ * have, newest first, down to (not including) their merge base. None when
+ * the two share no history.
+ */
+export declare function commitsAhead(dir: string, fromOid: string, baseOid: string, cache?: object, limit?: number): Promise<SnapshotEntry[]>;
+/**
+ * What is online that this computer has not got: fetch the book's branch
+ * (remote-tracking ref only — no merge, no checkout, safe on a dirty tree)
+ * and describe the commits above the merge base. Quiet on every failure,
+ * reporting why, like `checkRemoteUpdates`.
+ */
+export declare function listOnlineVersions(options: {
+    projectDir: string;
+    credential?: HostCredential;
+    tokenStore?: TokenStore;
+    httpClient?: typeof defaultGitHttp;
+}): Promise<{
+    entries: VersionEntry[];
+    reason?: "no-remote" | "auth" | "offline";
+}>;
+/**
+ * One file at version `id` beside the same file as it is on disk now, as
+ * aligned rows for the compare view. `binary` when either side is not text.
+ * A side that does not exist (the file was added since, or removed) is an
+ * empty column.
+ */
+export declare function compareVersionFile(projectDir: string, id: string, filepath: string): Promise<{
+    binary: true;
+} | {
+    binary: false;
+    rows: CompareRow[];
+}>;
+/**
+ * Write every file of version `id` under `destDir` (the whole repository
+ * tree, so a book inside a larger repository still finds its shared
+ * stylesheets) and return the folder the preview should render — the
+ * book's own subfolder of it.
+ */
+export declare function exportVersionTree(projectDir: string, id: string, destDir: string): Promise<{
+    inputDir: string;
+}>;