gutterpress 0.11.23-beta.2 → 0.11.23

package/dist/index.js

@@ -6,6 +6,7 @@ import {
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   BUILT_IN_TEMPLATE_IDS,
   EXTENSION_KINDS,
+  EXTENSION_KIND_ALIASES,
   FileTokenStore,
   GDRIVE_HOST,
   GITHUB_HOST,
@@ -42,6 +43,7 @@ import {
   executeAndReport,
   executeValidation,
   exportVersionTree,
+  extensionKindFor,
   extractUrlCredential,
   extractVariables,
   forgeKindForHost,
@@ -122,14 +124,16 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-0k43evt0.js";
+} from "./index-rzdn6r10.js";
 import {
+  BUILT_IN_LOOKS,
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
   PRESETS,
   PRESET_IDS,
   TARGETS,
   TARGET_IDS,
+  addBuiltInStyleSet,
   addExtension,
   checkExtensionUpdates,
   describeExtension,
@@ -152,9 +156,10 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-ytjkvwy5.js";
+} from "./index-7wgf4bqz.js";
 import {
   BUNDLED_EXTENSIONS,
+  BUNDLED_EXTENSION_DETAILS,
   EXTENSION_MANIFEST_FILENAME,
   assertExtensionContained,
   bundledExtension,
@@ -169,12 +174,12 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-80vg3ed6.js";
+} from "./index-37cxffyb.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-2t1gdma7.js";
-import"./index-swfdgn2n.js";
+} from "./index-santcs4q.js";
+import"./index-d9w3r89w.js";
 import {
   BuildError
 } from "./index-tayzfr9c.js";
@@ -199,10 +204,11 @@ import {
   revisionNameFrom,
   switchBranch,
   whenGitIdle
-} from "./index-7j3hkwya.js";
+} from "./index-kw4tbthz.js";
 import {
-  EXTENSIONS_DIR
-} from "./index-5x42amh8.js";
+  EXTENSIONS_DIR,
+  PLUGINS_DIR
+} from "./index-g3te5ey1.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -327,7 +333,22 @@ function insertDeclaration(root, name, value) {
   root.raws.after = `
 `;
 }
+function assertDeclarationValue(name, value) {
+  let single = false;
+  try {
+    const nodes = postcss.parse(`:root{${name}:${value}}`).nodes;
+    const rule = nodes[0];
+    single = nodes.length === 1 && rule?.type === "rule" && rule.nodes.length === 1 && rule.nodes[0].type === "decl";
+  } catch {
+    single = false;
+  }
+  if (!single)
+    throw new Error(`"${value}" can't be saved as ${name}: it is not one CSS value.`);
+}
 function applyTokenUpdates(sheets, target, updates) {
+  for (const { name, value } of updates)
+    if (value !== null)
+      assertDeclarationValue(name, value);
   const roots = sheets.map((css) => postcss.parse(css));
   const changed = new Set;
   for (const { name, value } of updates) {
@@ -550,6 +571,7 @@ export {
   extractVariables,
   extractUrlCredential,
   extensionStyleList,
+  extensionKindFor,
   extensionEntry,
   extensionCarries,
   exportVersionTree,
@@ -585,6 +607,7 @@ export {
   assertExtensionContained,
   adoptFolder,
   addExtension,
+  addBuiltInStyleSet,
   VERSION_CHANGES_SHOWN,
   TARGET_IDS,
   TARGETS,
@@ -598,6 +621,7 @@ export {
   PublishSelectionsStore,
   PRESET_IDS,
   PRESETS,
+  PLUGINS_DIR,
   MAX_SEARCH_BYTES,
   MANIFEST_FILENAMES,
   HISTORY_PAGE_LIMIT,
@@ -608,13 +632,16 @@ export {
   GDRIVE_HOST,
   FileTokenStore,
   EXTENSION_MANIFEST_FILENAME,
+  EXTENSION_KIND_ALIASES,
   EXTENSION_KINDS,
   EXTENSIONS_DIR,
   DEFAULT_PRINT_OPTS,
   DEFAULT_NPM_REGISTRY,
   BuildError,
+  BUNDLED_EXTENSION_DETAILS,
   BUNDLED_EXTENSIONS,
   BUILT_IN_TEMPLATE_IDS,
+  BUILT_IN_LOOKS,
   BUILD_DIAGNOSTIC_CODES,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,

package/dist/lib/check-options.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The options a check takes in its `checks:` entry (#443, #483): the numbers
+ * and the list it measures against. The preset and the publish target set
+ * them; a book overrides one in the same entry that sets the check's level.
+ *
+ *   checks:
+ *     pdf.print.ink-coverage: { maxTac: 300 }
+ *     pdf.print.image-resolution: { level: error, minImageResolution: 200 }
+ *
+ * Each option lands at ONE place in the resolved config, `at`, which is what
+ * the check reads (and, for `maxTac`, what the PDF/X conversion holds the ink
+ * to). `at` is also how a 0.11.22 manifest spelled the option
+ * (`ink.maxTac`, `validate.pdf.minImageResolution`, `page.tolerance`), so
+ * manifest-old-spellings.ts translates the old keys from this same table.
+ *
+ * No filesystem or check-registry imports: manifest.ts resolves with it, and
+ * the Book setup writers use {@link setCheckOption}.
+ */
+import { type Document } from "yaml";
+import type { CheckLevelInput, ResolvedConfig } from "../schema/manifest.types";
+/** What an option's value is: points/bytes/DPI/a count, a `{ min, max }` range, or a list of file patterns. */
+type OptionKind = "number" | "range" | "patterns";
+interface CheckOption {
+    /** Where the value lands in the resolved config, and the 0.11.22 manifest spelling. */
+    at: string;
+    kind: OptionKind;
+}
+/** Check id -> option name -> where it lands. */
+export declare const CHECK_OPTIONS: Readonly<Record<string, Readonly<Record<string, CheckOption>>>>;
+/** The check id and option name a 0.11.22 spelling (`ink.maxTac`) moved to, if it is one. */
+export declare function optionForOldSpelling(at: string): {
+    id: string;
+    option: string;
+} | undefined;
+/** A `checks:` level as a manifest may write it: `off`, `on`, `info`, `warn` (`warning`), `error`, or a boolean. */
+export declare function isCheckLevelInput(value: unknown): value is CheckLevelInput;
+/**
+ * A 0.11.22 threshold (`validate.heuristics.maxDecorativeLayers`) read as
+ * the option it became, or undefined when the key was never a threshold.
+ * 0.11.22 passed any value through, and a check given one it could not use
+ * measured nothing, so a value the option cannot take is NOT an error here:
+ * `mustBe` says what it should have been and the caller reports it and
+ * ignores it, and a book that built in 0.11.22 still builds. A range keeps
+ * whichever of `min` and `max` are numbers, as 0.11.22's merge did.
+ */
+export declare function readOldThreshold(at: string, value: unknown): {
+    id: string;
+    option: string;
+    value?: unknown;
+    mustBe?: string;
+} | undefined;
+/**
+ * Read the options of one `checks:` entry (every key but `level`). A key the
+ * check does not take is a usage error naming the ones it does, so a typo
+ * never silently keeps the preset's number. A `null` value is left unset.
+ */
+export declare function readCheckOptions(id: string, entry: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Write read options into a resolved config, over the preset's and the
+ * target's values. A range merges key by key, so `{ max: 4000 }` keeps the
+ * preset's `min`; a list replaces the preset's whole.
+ */
+export declare function applyCheckOptions(config: ResolvedConfig, options: Record<string, Record<string, unknown>>): void;
+/**
+ * Set one option in a manifest Document, keeping the entry's level: a bare
+ * level (`warn`) becomes `{ level: warn, <option>: value }`. Used where Book
+ * setup and `gutterpress new` write a check's option.
+ */
+export declare function setCheckOption(doc: Document, id: string, option: string, value: unknown): void;
+export {};

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

@@ -4,7 +4,7 @@ import type { ResolvedExtensionConfig } from "../schema/manifest.types.ts";
 /** The folder (relative to the project root) a book's extensions live under:
  *  vendored npm copies in `extensions/npm/`, zip and URL imports beside them
  *  (extension-import.ts). Path entries elsewhere are never moved. */
-export { EXTENSIONS_DIR } from "./plugin-vendor.ts";
+export { EXTENSIONS_DIR, PLUGINS_DIR } from "./plugin-vendor.ts";
 /** How an `extensions:` entry resolves — the form of its specifier decides. */
 export type ExtensionSourceKind = "bundled" | "path" | "npm";
 /** One configured extension, as surfaced to the CLI and the desktop. */
@@ -194,6 +194,21 @@ export interface BundledExtensionInfo {
 }
 /** The bundled extensions, in table order. */
 export declare function listBundledExtensions(): BundledExtensionInfo[];
+/** The built-in looks' names (the bundled extensions that carry a stylesheet), in table order. */
+export declare const BUILT_IN_LOOKS: readonly string[];
+/**
+ * Make an editable copy of a built-in look (0.11.22's, restored in #482): its
+ * stylesheet and a package.json land in `extensions/<id>/`, the author's own
+ * files from then on, and the book lists the copy as `./extensions/<id>` — a
+ * plain path extension, loaded and built like any folder the author owns.
+ *
+ * A book that lists the built-in by name gets the copy in that entry's place
+ * (on or off as it was), so the look is not listed twice and the cascade
+ * order holds; otherwise the copy is added at the end. Idempotent: a folder
+ * already there is kept as it is — the author's edits survive — and only
+ * (re-)referenced.
+ */
+export declare function addBuiltInStyleSet(projectDir: string, id: string): Promise<ProjectExtensionEntry>;
 /** A folder name under `extensions/` not yet taken: `<slug>`, `<slug>-2`, … */
 export declare function uniqueExtensionId(projectDir: string, base: string): Promise<string>;
 /**

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

@@ -2,6 +2,19 @@
 export type ExtensionKind = "plugin" | "look";
 /** The kinds `--kind` accepts, for CLI help text and pickers. */
 export declare const EXTENSION_KINDS: readonly ["plugin", "look"];
+/**
+ * Older names for a kind, read wherever a kind is given (`scaffoldExtension`,
+ * `gutterpress new --kind`) and never offered: 0.11.22 called a look a
+ * `theme` (#483). Kept apart from {@link EXTENSION_KINDS} so help text and
+ * pickers keep showing one word per kind.
+ */
+export declare const EXTENSION_KIND_ALIASES: {
+    readonly theme: "look";
+};
+/** An older name {@link EXTENSION_KIND_ALIASES} reads. */
+export type ExtensionKindAlias = keyof typeof EXTENSION_KIND_ALIASES;
+/** The kind a word names — a kind, or an older name for one — or undefined. */
+export declare function extensionKindFor(word: string): ExtensionKind | undefined;
 /**
  * The class/property prefix a scaffolded extension is FORBIDDEN to take.
  * `gp-` is Gutterpress core's own vocabulary (CLAUDE.md §6); an extension
@@ -13,8 +26,8 @@ export declare const RESERVED_PREFIX = "gp-";
 export interface ScaffoldExtensionOptions {
     /** Human-friendly package name, e.g. "Field Notes". Required. */
     name: string;
-    /** Which starter to create. Required. */
-    kind: ExtensionKind;
+    /** Which starter to create. Required. `theme` (0.11.22's word) makes a look. */
+    kind: ExtensionKind | ExtensionKindAlias;
     /** Absolute path to the PARENT directory the folder is created in. */
     parentDir: string;
     /** Folder name under `parentDir`. Defaults to a slug of `name`. */

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

@@ -20,7 +20,14 @@ export interface BundledExtension {
     /** A look's stylesheet. Absent for a markdown feature. */
     css?: string;
 }
-export declare const BUNDLED_EXTENSIONS: readonly BundledExtension[];
+export declare const BUNDLED_EXTENSION_DETAILS: readonly BundledExtension[];
+/**
+ * The bundled names, in table order: the shape this export had in 0.11.22,
+ * so `BUNDLED_EXTENSIONS.includes(name)` still answers "is this bundled?".
+ * Each one's label, description and stylesheet are in
+ * {@link BUNDLED_EXTENSION_DETAILS}.
+ */
+export declare const BUNDLED_EXTENSIONS: readonly string[];
 export declare function bundledExtension(name: string): BundledExtension | undefined;
 export declare function isBundledExtension(name: string): boolean;
 /** `./x`, `../x`, `/x`, or a Windows drive path (`C:\x`). Nothing else is a path. */

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

@@ -17,7 +17,9 @@ export interface ProjectConfigFields {
  * Only the keys present in `updates` are written; everything else is left
  * untouched (so unrelated comments + sections survive). `sourceFiles: null`
  * deletes the `chapters` entry (back to "all chapter files"). Either way an
- * older book's `source.files` is taken out, so the list has one spelling.
+ * older book's `source.files` is taken out, so the list has one spelling, and
+ * the thresholds it spells the 0.11.22 way are written as their checks'
+ * options (`rewriteOldThresholds`).
  */
 export declare function setManifestFields(projectDir: string, updates: ProjectConfigFields): Promise<ProjectConfigFields>;
 /**

package/dist/lib/manifest-old-spellings.d.ts

@@ -2,8 +2,10 @@
  * The manifest spellings 0.11.23 replaced, read for this release only so a
  * book written for 0.11.22 still builds. Every old key found is translated
  * to its new spelling (or dropped, when nothing replaces it) and named in ONE
- * notice. Delete this module, and its call in `loadManifestWithPath`, in the
- * release after 0.11.23.
+ * notice. Book setup writes the new spelling of a threshold when it saves
+ * (`rewriteOldThresholds`). Delete this module, its call in
+ * `loadManifestWithPath` and the two calls of `rewriteOldThresholds`
+ * (manifest-config.ts, page-size.ts) in the release after 0.11.23.
  *
  *   source.files                     -> chapters
  *   validate.checks, lint.rules      -> checks (off | on | info | warn | error)
@@ -14,17 +16,27 @@
  *   validate.pdf.requireBookmarks,
  *   validate.pdf.requireTocLinks,
  *   validate.pdf.requireBleed,
- *   validate.pdf.forbidTransparency  -> the matching check, on or off
+ *   validate.pdf.forbidTransparency  -> the matching check, on or off; a level
+ *                                       the same book set for it is kept
+ *   ink.*, page.tolerance and the
+ *   validate.assets / pdf /
+ *   heuristics thresholds            -> an option of their check:
+ *                                       checks: { <id>: { <option>: value } }
+ *                                       (lib/check-options.ts)
  *   validate.source.<tool>: <path>   -> dropped: the config file is found by
  *                                       its usual name in the book's folder
  *                                       or a folder above it
- *   ink.*, page.tolerance,
- *   validate thresholds,
- *   validate.enabled, lint.configPath,
- *   and the keys
- *   0.11.22 already ignored           -> dropped: the preset and the publish
- *                                       target set the thresholds
+ *   validate.enabled, lint.configPath
+ *   and the keys 0.11.22 already
+ *   ignored                          -> dropped
+ *
+ * Nothing read from an old spelling can stop a book from building: 0.11.22
+ * passed any value through, so a threshold, a severity or a rule level it
+ * could not have used (`maxDecorativeLayers: many`, `severity: critical`) is
+ * named in the notice and ignored. The new spelling, written directly, is
+ * checked strictly (`resolveConfig`).
  */
+import { type Document } from "yaml";
 import type { CheckLevelInput, GutterpressManifest } from "../schema/manifest.types";
 type OldCheckEntry = boolean | {
     enabled?: boolean;
@@ -61,4 +73,15 @@ export interface OldSpellings {
  * removed before 0.11.23 with an actionable error.
  */
 export declare function readOldSpellings(raw: GutterpressManifest & OldSpellings): GutterpressManifest;
+/**
+ * Book setup's save: move every 0.11.22 threshold key in a manifest Document
+ * (`ink.maxTac`, `validate.pdf.minImageResolution`, `page.tolerance`, …) to
+ * its check's option, the way `setManifestFields` moves `source.files` to
+ * `chapters`. An option the new spelling already sets keeps its value; a
+ * block left empty goes. A value the option cannot take stays where it is,
+ * as written: moved, the new spelling's strict check would stop the book
+ * from building, and left, it is named and ignored at load. Every other key
+ * stays as written.
+ */
+export declare function rewriteOldThresholds(doc: Document): void;
 export {};

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

@@ -5,7 +5,7 @@ import type MarkdownIt from "markdown-it";
  *
  * Bundled, OPT-IN markdown feature (`gutterpress-math` in
  * `BUILTIN_OPTIONAL_PLUGINS`, renderer.ts; "Math" in
- * `BUNDLED_EXTENSIONS`, extension-specifier.ts), exactly like the Callouts
+ * `BUNDLED_EXTENSION_DETAILS`, extension-specifier.ts), exactly like the Callouts
  * feature: a book that never lists it renders `$` as the character it is.
  *
  * WHY SVG. Each formula is written as a drawing of its own glyphs, so the

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

@@ -9,4 +9,5 @@ import type MarkdownIt from "markdown-it";
  */
 export declare const QUOTES: Record<string, string | string[]>;
 export declare function quotesFor(language?: string): string | string[];
+/** Replaces markdown-it's `replacements` rule, at its place in the core chain. */
 export declare function gpTypography(md: MarkdownIt): void;

package/dist/lib/page-size.d.ts

@@ -10,6 +10,8 @@ export interface CustomPageOptions {
     width: number;
     /** Trim height in points (72pt = 1in). */
     height: number;
+    /** How far (pt) the built PDF may differ from it, written as the page-size check's option. Default: the preset's 0.5. */
+    tolerance?: number;
 }
 /** A page size in points. */
 export interface PageSizePoints {
@@ -50,9 +52,10 @@ export interface PageSetup {
     presetSizeOverridden: boolean;
 }
 /**
- * Write the manifest's `page:` bounds. A `tolerance` an older book carries
- * goes (the preset sets it); the block's other keys stay as written; a
- * `page:` that is not a map is replaced.
+ * Write the manifest's `page:` bounds, and a `tolerance` given with them as
+ * the page-size check's option (one already recorded stays when none is
+ * given). The block's other keys stay as written; a `page:` that is not a
+ * map is replaced.
  */
 export declare function writePageBounds(doc: Document, page: CustomPageOptions): void;
 /** Remove the bounds a preset owns and nothing else; a `page:` left empty goes too. */
@@ -67,6 +70,8 @@ export declare function numberAt(doc: Document, keyPath: string[]): number | und
 export declare function pageSizeForChoice(choice: PageSizeChoice): PageSizePoints;
 /** Read a book's page geometry back from its manifest (and, for margins it does not set, its stylesheets). */
 export declare function readPageSetup(projectDir: string): Promise<PageSetup>;
+/** @deprecated 0.11.22's call shape: pass `{ size: { preset, page } }`. */
+export declare function setPageSetup(projectDir: string, choice: PageSizeChoice): Promise<PageSetup>;
 /**
  * Change a book's page geometry in the manifest. The size mirrors what the
  * wizard records — `dtrpg` / `book` carry their own bounds (the `page:` block's
@@ -74,6 +79,9 @@ export declare function readPageSetup(projectDir: string): Promise<PageSetup>;
  * other keys stay), `custom` records the typed trim. The margins go to
  * `page.margin`, validated against the size being written, else the recorded
  * one; `margins: null` removes `page.margin`. Nothing is written unless the
- * whole change validates.
+ * whole change validates. A 0.11.22 caller's `{ preset, page? }` (a size
+ * choice, before margins joined it) is read as `{ size: { preset, page } }`.
+ * The thresholds a 0.11.22 manifest spells the old way are written the new
+ * way (`rewriteOldThresholds`).
  */
 export declare function setPageSetup(projectDir: string, change: PageSetupChange): Promise<PageSetup>;

package/dist/lib/plugin-vendor.d.ts

@@ -1,5 +1,11 @@
 /** Project-relative folder every extension a book carries lives under: vendored npm copies in `npm/`, imports beside them. */
 export declare const EXTENSIONS_DIR = "extensions";
+/**
+ * @deprecated 0.11.22's name for the folder vendored npm extensions go in;
+ * the same folder as {@link EXTENSIONS_DIR}, kept so a caller of the lib keeps
+ * working. Books vendored before 0.11.23 keep theirs in {@link LEGACY_PLUGINS_DIR}.
+ */
+export declare const PLUGINS_DIR = "extensions";
 /** Where books vendored before 0.11.23 keep their npm copies. Read, never written. */
 export declare const LEGACY_PLUGINS_DIR = "plugins";
 export declare const VENDORED_NPM_DIR = "npm";

package/dist/lib/presets.d.ts

@@ -7,8 +7,8 @@ import type { ResolvedConfig } from "../schema/manifest.types";
  *
  * Geometry, build and print values are overridable from the manifest, leaf
  * by leaf (resolveConfig's mergeShape; precedence cli > manifest > target >
- * preset). The check thresholds (`ink`, `validate`) are the preset's and the
- * target's alone; a book changes a check's level in `checks:`.
+ * preset). The check thresholds (`ink`, `validate`, `page.tolerance`) are
+ * overridden in the check's own `checks:` entry (lib/check-options.ts).
  */
 export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" | "language" | "preset" | "targets" | "page"> {
     /** This preset's id: what the manifest's `preset:` names and a resolved config reports. */

package/dist/lib/root-tokens.d.ts

@@ -71,6 +71,7 @@ export declare function rootTokens(css: string): RootToken[];
  * added to `sheets[target]`. A null value removes the token from every
  * sheet, so what the looks set shows through. Returns the sheets' new text;
  * a sheet nothing changed comes back as it was given. Throws postcss's
- * `CssSyntaxError` for a sheet it cannot parse.
+ * `CssSyntaxError` for a sheet it cannot parse, and refuses the whole batch,
+ * writing nothing, when a value is not one declaration's value.
  */
 export declare function applyTokenUpdates(sheets: readonly string[], target: number, updates: readonly TokenUpdate[]): string[];

package/dist/lib/style-resolver.d.ts

@@ -14,7 +14,8 @@ export declare function relDisplay(projectDir: string, absPath: string): string;
  * BOTH the renderer (to `<link>` them) and the editor (to edit them), so they
  * can never disagree. Returns project-relative paths:
  *   1. the manifest `styles:` list, if it has any entries; else
- *   2. `styles/book.css`, when the project has it; else
+ *   2. the first conventional stylesheet the project actually has
+ *      (`FALLBACK_PRIORITY`); else
  *   3. the first discovered `.css` anywhere we scan (deterministic); else
  *   4. `[]` — the project has no stylesheet (an honest empty, never a phantom
  *      link to a missing file).

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

@@ -22,6 +22,12 @@ export interface VersionEntry extends SnapshotEntry {
     /** True = online too; false = on this computer only; null = no online copy to compare with. */
     backedUp: boolean | null;
 }
+/** A version in the online copy that this computer has not got, with the files it changed. */
+export interface OnlineVersionEntry extends VersionEntry {
+    changes: VersionFileChange[];
+    /** Changed files beyond the ones listed. */
+    moreChanges: number;
+}
 /** 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. */
@@ -62,8 +68,8 @@ export declare function commitsAhead(dir: string, fromOid: string, baseOid: stri
 /**
  * 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 this computer has not got. Quiet on every failure,
- * reporting why, like `checkRemoteUpdates`.
+ * and describe the commits this computer has not got, each with the files it
+ * changed. Quiet on every failure, reporting why, like `checkRemoteUpdates`.
  */
 export declare function listOnlineVersions(options: {
     projectDir: string;
@@ -71,7 +77,7 @@ export declare function listOnlineVersions(options: {
     tokenStore?: TokenStore;
     httpClient?: typeof defaultGitHttp;
 }): Promise<{
-    entries: VersionEntry[];
+    entries: OnlineVersionEntry[];
     reason?: "no-remote" | "auth" | "offline";
 }>;
 /**