@scolladon/tsgit 1.1.0 → 1.2.0

package/dist/types/chunks/write-tree-BXCDChvv.d.ts

@@ -0,0 +1,154 @@
+import { O as ObjectId, d as FilePath, b as Context, R as RefName, h as HookName } from './context-BORy7yXb.js';
+import { F as FileMode, a as CatFileBatchOptions, C as CatFileBatchEntry, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, s as TreeDiff, R as ReadObjectOptions, B as Blob, G as GitObject, T as Tree, r as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, b as Commit, v as WalkSubmodulesOptions, S as SubmoduleEntry, x as WalkTreeOptions, w as WalkTreeEntry, z as WalkWorkingTreeOptions, y as WalkWorkingTreeEntry, t as TreeEntry } from './reflog-entry-D9P2hCgv.js';
+
+interface IndexEntryFlags {
+    readonly assumeValid: boolean;
+    readonly stage: 0 | 1 | 2 | 3;
+    /** Index v3 extended flag — the path is intentionally absent from the working tree. */
+    readonly skipWorktree: boolean;
+    /** Index v3 extended flag — `git add -N` placeholder. Modelled for faithful round-tripping. */
+    readonly intentToAdd: boolean;
+}
+interface IndexEntry {
+    readonly ctimeSeconds: number;
+    readonly ctimeNanoseconds: number;
+    readonly mtimeSeconds: number;
+    readonly mtimeNanoseconds: number;
+    readonly dev: number;
+    readonly ino: number;
+    readonly mode: FileMode;
+    readonly uid: number;
+    readonly gid: number;
+    readonly fileSize: number;
+    readonly id: ObjectId;
+    readonly flags: IndexEntryFlags;
+    readonly path: FilePath;
+}
+interface IndexExtension {
+    readonly signature: string;
+    readonly data: Uint8Array;
+}
+interface GitIndex {
+    readonly version: 2 | 3;
+    readonly entries: ReadonlyArray<IndexEntry>;
+    readonly extensions: ReadonlyArray<IndexExtension>;
+}
+
+declare function catFileBatch(ctx: Context, ids: AsyncIterable<ObjectId> | Iterable<ObjectId>, options?: CatFileBatchOptions): AsyncIterable<CatFileBatchEntry>;
+
+declare function createCommit(ctx: Context, input: CreateCommitInput): Promise<ObjectId>;
+
+declare function diffTrees(ctx: Context, a: DiffTreesInput, b: DiffTreesInput, options?: DiffTreesOptions): Promise<TreeDiff>;
+
+/**
+ * Compute a merge base — the first commit reachable from BOTH `a` and `b`.
+ *
+ * Algorithm: bidirectional BFS with two visited sets. After each layer
+ * advance, check the intersection. When non-empty, return the
+ * lexicographically smallest oid (deterministic tie-breaker).
+ *
+ * Returns `undefined` for unrelated histories. Documented limitation: cherry-picks
+ * and criss-cross merges may yield non-optimal bases — `recursive`-strategy
+ * multi-base resolution is v2.
+ */
+declare const mergeBase: (ctx: Context, a: ObjectId, b: ObjectId) => Promise<ObjectId | undefined>;
+
+/**
+ * Pure path helpers composing `ctx.layout.gitDir` with known sub-paths.
+ * No I/O. No port access. Primitive step 3.
+ */
+
+/**
+ * Repository working-tree root. Returns the workDir from the current context;
+ * facade-tier code is responsible for discovery / realpath pinning
+ * at construction time. Primitives consume the already-resolved path.
+ */
+declare const getRepoRoot: (ctx: Context) => FilePath;
+declare const sparseCheckoutPath: (gitDir: string) => string;
+
+declare function readBlob(ctx: Context, id: ObjectId, options?: ReadObjectOptions): Promise<Blob>;
+
+declare function readIndex(ctx: Context): Promise<GitIndex>;
+
+declare function readObject(ctx: Context, id: ObjectId, options?: ReadObjectOptions): Promise<GitObject>;
+
+declare function readTree(ctx: Context, ref: RefName | ObjectId): Promise<Tree>;
+
+/**
+ * The single reflog *writer*. Self-contained: reads config, applies the gate,
+ * resolves identity, sanitises the message, and appends one entry. Callers
+ * supply only a human-readable message.
+ */
+
+/**
+ * Append a reflog entry for `ref` if logging applies. A no-op when the gate is
+ * closed for `ref` — once a reflog file exists every update appends to it,
+ * otherwise the `core.logAllRefUpdates` prefix rule decides.
+ */
+declare function recordRefUpdate(ctx: Context, ref: RefName, oldId: ObjectId, newId: ObjectId, message: string): Promise<void>;
+
+declare function resolveRef(ctx: Context, name: RefName | 'HEAD', options?: ResolveRefOptions): Promise<ObjectId>;
+
+/** Optional arguments and stdin a caller threads into a hook invocation. */
+interface HookInput {
+    readonly args?: ReadonlyArray<string>;
+    readonly stdin?: string;
+}
+/**
+ * Run a named git hook through `ctx.hooks`. A no-op when no `HookRunner` is
+ * wired (browser, or opted out), when the hook file is absent / not executable
+ * (`skipped`), or when the hook exits 0. Throws `HOOK_FAILED` on a non-zero
+ * exit.
+ */
+declare const runHook: (ctx: Context, name: HookName, input?: HookInput) => Promise<void>;
+
+declare function updateRef(ctx: Context, name: RefName, newId: ObjectId, options: UpdateRefOptions): Promise<void>;
+
+declare function walkCommits(ctx: Context, options: WalkCommitsOptions): AsyncIterable<Commit>;
+
+/**
+ * Yield every gitlink reachable in `ref`'s tree, joined with its `.gitmodules`
+ * metadata. With `recursive: true`, descend into each nested submodule whose
+ * absorbed gitdir (`${gitDir}/modules/<name>`) is locally available; nested
+ * yields carry `depth >= 1` and a `parent` path. Uninitialised / missing /
+ * cyclic nested submodules contribute their own entry but no children — the
+ * absence of further yields is the signal, matching `git submodule status
+ * --recursive`.
+ */
+declare function walkSubmodules(ctx: Context, options?: WalkSubmodulesOptions): AsyncIterable<SubmoduleEntry>;
+
+declare function walkTree(ctx: Context, treeIdOrObject: ObjectId | Tree, options?: WalkTreeOptions): AsyncIterable<WalkTreeEntry>;
+
+/**
+ * Depth-first walk of the working tree starting at `ctx.layout.workDir`.
+ *
+ * Yields leaf entries (files and symlinks) as `{ path, stat }`. Directories
+ * are descended into, not yielded. `.git` at any level is skipped
+ * (case-insensitive, NTFS-trimmed). Embedded repositories (directories
+ * containing a `.git` child) are skipped entirely — yields nothing under
+ * them. Symlinks are surfaced via `lstat` (no follow); a symlink to a
+ * directory is yielded as a leaf, not descended into.
+ *
+ * The host repository's own `.git` is NOT treated as an embedded-repo
+ * marker — at the workDir root we only skip the `.git` entry itself, not
+ * the workDir.
+ */
+declare function walkWorkingTree(ctx: Context, options?: WalkWorkingTreeOptions): AsyncIterable<WalkWorkingTreeEntry>;
+
+declare function writeObject(ctx: Context, object: GitObject): Promise<ObjectId>;
+
+/**
+ * Write a symbolic ref atomically. Used for HEAD updates that point at a
+ * branch, branch renames affecting the current HEAD, and `clone`/`init`
+ * to set the initial HEAD.
+ *
+ * Single-level only in v1: target MUST be a direct ref name (no chained
+ * symrefs). Validation runs through `validateRefName` for both `name` and
+ * `target` — invalid inputs throw INVALID_REF before any I/O.
+ */
+declare const writeSymbolicRef: (ctx: Context, name: RefName, target: RefName) => Promise<void>;
+
+declare function writeTree(ctx: Context, entries: ReadonlyArray<TreeEntry>): Promise<ObjectId>;
+
+export { createCommit as a, readIndex as b, catFileBatch as c, diffTrees as d, readObject as e, readTree as f, getRepoRoot as g, recordRefUpdate as h, resolveRef as i, runHook as j, walkSubmodules as k, walkTree as l, mergeBase as m, walkWorkingTree as n, writeObject as o, writeSymbolicRef as p, writeTree as q, readBlob as r, sparseCheckoutPath as s, updateRef as u, walkCommits as w };
+export type { GitIndex as G, HookInput as H, IndexEntry as I };

package/dist/types/commands/index.d.cts

@@ -1,5 +1,5 @@
-import { d as FilePath, b as Context, R as RefName, O as ObjectId } from '../chunks/context-D84z1i5F.cjs';
-import { A as AuthorIdentity, T as TreeDiff } from '../chunks/diff-change-Bm1zvVsC.cjs';
+import { d as FilePath, b as Context, R as RefName, O as ObjectId, m as PromisorRemote } from '../chunks/context-CMrHCVwK.cjs';
+import { C as CatFileBatchEntry, A as AuthorIdentity, s as TreeDiff, q as ReflogEntry, S as SubmoduleEntry } from '../chunks/reflog-entry-BIf-zt__.cjs';
 import '../chunks/http-transport-DirKfK2S.cjs';
 
 interface AddOptions {
@@ -66,6 +66,30 @@ type BranchResult = {
 };
 declare const branch: (ctx: Context, action: BranchAction) => Promise<BranchResult>;
 
+type ConflictType = 'content' | 'add-add' | 'modify-delete' | 'type-change' | 'rename-rename' | 'gitlink' | 'binary';
+
+/**
+ * Tier-1 `catFile` command — wraps the streaming `catFileBatch` primitive in
+ * a request/response shape matching the other v2 commands (`submodules`,
+ * `log`, `reflog`). String ids are coerced at the boundary via
+ * `ObjectId.from`, which throws `INVALID_OBJECT_ID` on malformed input
+ * before any read happens.
+ *
+ * For streaming use cases, callers reach for `repo.primitives.catFileBatch`
+ * directly — see `docs/design/cat-file-batch.md` §2.
+ */
+
+interface CatFileInput {
+    readonly ids: ReadonlyArray<ObjectId | string>;
+    /** Per-object byte cap; forwarded to the underlying `readObject` call. */
+    readonly maxBytes?: number;
+}
+interface CatFileResult {
+    readonly kind: 'batch';
+    readonly entries: ReadonlyArray<CatFileBatchEntry>;
+}
+declare const catFile: (ctx: Context, opts: CatFileInput) => Promise<CatFileResult>;
+
 interface CheckoutSwitchOptions {
     readonly target: string;
     readonly detach?: boolean;
@@ -100,6 +124,12 @@ interface CloneOptions {
     readonly resolver?: DnsResolver;
     readonly allowInsecure?: boolean;
     readonly allowPrivateNetworks?: boolean;
+    /**
+     * Partial-clone object filter (`blob:none`, `blob:limit=<n>`, `tree:<n>`).
+     * When set, the server omits the filtered objects, a promisor remote is
+     * recorded in `.git/config`, and omitted objects are lazy-fetched on read.
+     */
+    readonly filter?: string;
 }
 interface CloneResult {
     readonly path: FilePath;
@@ -117,6 +147,8 @@ interface CommitOptions {
     readonly committer?: AuthorIdentity;
     readonly allowEmpty?: boolean;
     readonly allowEmptyMessage?: boolean;
+    /** Skip the `pre-commit` and `commit-msg` hooks (git's `--no-verify`). */
+    readonly noVerify?: boolean;
 }
 interface CommitResult {
     readonly id: ObjectId;
@@ -135,8 +167,6 @@ interface CommitResult {
  */
 declare const commit: (ctx: Context, opts: CommitOptions) => Promise<CommitResult>;
 
-type ConflictType = 'content' | 'add-add' | 'modify-delete' | 'type-change' | 'rename-rename' | 'gitlink' | 'binary';
-
 interface DiffOptions {
     /** Resolve to a tree. Accepts ref name, oid, or 'HEAD'. */
     readonly from?: string;
@@ -175,6 +205,30 @@ interface FetchResult {
 }
 declare const fetch: (ctx: Context, opts?: FetchOptions) => Promise<FetchResult>;
 
+interface FetchMissingOptions {
+    /** Object ids to fetch. Ones already present locally are skipped. */
+    readonly oids: ReadonlyArray<ObjectId>;
+}
+interface FetchMissingResult {
+    /** The promisor remote the objects were fetched from. */
+    readonly remote: string;
+    /** Objects the caller asked for. */
+    readonly requested: number;
+    /** Objects that were missing locally and got fetched. */
+    readonly fetched: number;
+}
+/**
+ * Fetch the named objects from the repository's promisor remote. Throws
+ * `NO_PROMISOR_REMOTE` when the repository is not a partial clone.
+ */
+declare const fetchMissing: (ctx: Context, opts: FetchMissingOptions) => Promise<FetchMissingResult>;
+/**
+ * `PromisorRemote` port implementation — the seam `readObject` calls on a
+ * miss. A non-partial repository yields `attempted: false` (rather than
+ * throwing) so `readObject` falls through to its normal `OBJECT_NOT_FOUND`.
+ */
+declare const createPromisorRemote: (ctx: Context) => PromisorRemote;
+
 interface InitOptions {
     readonly initialBranch?: string;
     readonly bare?: boolean;
@@ -266,6 +320,8 @@ interface PushOptions {
     readonly refspecs?: ReadonlyArray<string>;
     readonly force?: boolean;
     readonly forceWithLease?: ObjectId | 'auto';
+    /** Skip the `pre-push` hook (git's `--no-verify`). */
+    readonly noVerify?: boolean;
 }
 interface PushedRef {
     readonly name: RefName;
@@ -281,6 +337,47 @@ interface PushResult {
 }
 declare const push: (ctx: Context, opts?: PushOptions) => Promise<PushResult>;
 
+type ReflogAction = {
+    readonly action?: 'show';
+    readonly ref?: string;
+} | {
+    readonly action: 'exists';
+    readonly ref: string;
+} | {
+    readonly action: 'delete';
+    readonly ref: string;
+    readonly index: number;
+    readonly rewrite?: boolean;
+} | {
+    readonly action: 'expire';
+    readonly ref?: string;
+    readonly all?: boolean;
+    readonly expire?: string;
+    readonly expireUnreachable?: string;
+};
+/** One reflog entry as `show` presents it: newest-first, with a selector. */
+interface ReflogShowEntry {
+    readonly index: number;
+    readonly selector: string;
+    readonly entry: ReflogEntry;
+}
+type ReflogResult = {
+    readonly kind: 'show';
+    readonly ref: RefName;
+    readonly entries: ReadonlyArray<ReflogShowEntry>;
+} | {
+    readonly kind: 'exists';
+    readonly exists: boolean;
+} | {
+    readonly kind: 'expire';
+    readonly removed: number;
+    readonly kept: number;
+} | {
+    readonly kind: 'delete';
+    readonly removed: ReflogEntry;
+};
+declare const reflog: (ctx: Context, opts?: ReflogAction) => Promise<ReflogResult>;
+
 type ResetMode = 'soft' | 'mixed' | 'hard';
 interface ResetOptions {
     readonly mode: ResetMode;
@@ -324,6 +421,37 @@ interface RmResult {
  */
 declare const rm: (ctx: Context, paths: ReadonlyArray<string>, opts?: RmOptions) => Promise<RmResult>;
 
+type SparseCheckoutAction = {
+    readonly action: 'list';
+} | {
+    readonly action: 'set';
+    readonly patterns: ReadonlyArray<string>;
+    readonly cone?: boolean;
+    readonly force?: boolean;
+} | {
+    readonly action: 'add';
+    readonly patterns: ReadonlyArray<string>;
+    readonly force?: boolean;
+} | {
+    readonly action: 'reapply';
+    readonly force?: boolean;
+} | {
+    readonly action: 'disable';
+    readonly force?: boolean;
+};
+type SparseCheckoutResult = {
+    readonly kind: 'list';
+    readonly cone: boolean;
+    readonly patterns: ReadonlyArray<string>;
+} | {
+    readonly kind: 'applied';
+    readonly cone: boolean;
+    readonly materialized: number;
+    readonly removed: number;
+    readonly retained: ReadonlyArray<FilePath>;
+};
+declare const sparseCheckout: (ctx: Context, opts: SparseCheckoutAction) => Promise<SparseCheckoutResult>;
+
 type ChangeKind = 'modified' | 'added' | 'deleted' | 'untracked';
 interface ChangeEntry {
     readonly kind: ChangeKind;
@@ -350,6 +478,24 @@ interface StatusResult {
  */
 declare const status: (ctx: Context) => Promise<StatusResult>;
 
+type SubmodulesAction = {
+    readonly action?: 'list';
+    /** Tree-ish to walk. Default: `'HEAD'`. */
+    readonly ref?: string;
+    /** Descend into nested submodules' own `.gitmodules`. Default: `false`. */
+    readonly recursive?: boolean;
+    /**
+     * Cap on recursion depth. Default: `MAX_SUBMODULE_DEPTH`. Entries at exactly
+     * this depth are yielded but not recursed into.
+     */
+    readonly maxDepth?: number;
+};
+type SubmodulesResult = {
+    readonly kind: 'list';
+    readonly entries: ReadonlyArray<SubmoduleEntry>;
+};
+declare const submodules: (ctx: Context, opts?: SubmodulesAction) => Promise<SubmodulesResult>;
+
 type TagAction = {
     readonly kind: 'list';
 } | {
@@ -378,5 +524,5 @@ type TagResult = {
 };
 declare const tag: (ctx: Context, action: TagAction) => Promise<TagResult>;
 
-export { add, branch, checkout, clone, commit, diff, fetch, init, log, merge, push, reset, revParse, rm, status, tag };
-export type { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, StatusResult, TagAction, TagInfo, TagResult };
+export { CatFileBatchEntry, SubmoduleEntry, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag };
+export type { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult };

package/dist/types/commands/index.d.ts

@@ -1,5 +1,5 @@
-import { d as FilePath, b as Context, R as RefName, O as ObjectId } from '../chunks/context-o5TPfMB2.js';
-import { A as AuthorIdentity, T as TreeDiff } from '../chunks/diff-change-alGRzD_j.js';
+import { d as FilePath, b as Context, R as RefName, O as ObjectId, m as PromisorRemote } from '../chunks/context-BORy7yXb.js';
+import { C as CatFileBatchEntry, A as AuthorIdentity, s as TreeDiff, q as ReflogEntry, S as SubmoduleEntry } from '../chunks/reflog-entry-D9P2hCgv.js';
 import '../chunks/http-transport-DirKfK2S.js';
 
 interface AddOptions {
@@ -66,6 +66,30 @@ type BranchResult = {
 };
 declare const branch: (ctx: Context, action: BranchAction) => Promise<BranchResult>;
 
+type ConflictType = 'content' | 'add-add' | 'modify-delete' | 'type-change' | 'rename-rename' | 'gitlink' | 'binary';
+
+/**
+ * Tier-1 `catFile` command — wraps the streaming `catFileBatch` primitive in
+ * a request/response shape matching the other v2 commands (`submodules`,
+ * `log`, `reflog`). String ids are coerced at the boundary via
+ * `ObjectId.from`, which throws `INVALID_OBJECT_ID` on malformed input
+ * before any read happens.
+ *
+ * For streaming use cases, callers reach for `repo.primitives.catFileBatch`
+ * directly — see `docs/design/cat-file-batch.md` §2.
+ */
+
+interface CatFileInput {
+    readonly ids: ReadonlyArray<ObjectId | string>;
+    /** Per-object byte cap; forwarded to the underlying `readObject` call. */
+    readonly maxBytes?: number;
+}
+interface CatFileResult {
+    readonly kind: 'batch';
+    readonly entries: ReadonlyArray<CatFileBatchEntry>;
+}
+declare const catFile: (ctx: Context, opts: CatFileInput) => Promise<CatFileResult>;
+
 interface CheckoutSwitchOptions {
     readonly target: string;
     readonly detach?: boolean;
@@ -100,6 +124,12 @@ interface CloneOptions {
     readonly resolver?: DnsResolver;
     readonly allowInsecure?: boolean;
     readonly allowPrivateNetworks?: boolean;
+    /**
+     * Partial-clone object filter (`blob:none`, `blob:limit=<n>`, `tree:<n>`).
+     * When set, the server omits the filtered objects, a promisor remote is
+     * recorded in `.git/config`, and omitted objects are lazy-fetched on read.
+     */
+    readonly filter?: string;
 }
 interface CloneResult {
     readonly path: FilePath;
@@ -117,6 +147,8 @@ interface CommitOptions {
     readonly committer?: AuthorIdentity;
     readonly allowEmpty?: boolean;
     readonly allowEmptyMessage?: boolean;
+    /** Skip the `pre-commit` and `commit-msg` hooks (git's `--no-verify`). */
+    readonly noVerify?: boolean;
 }
 interface CommitResult {
     readonly id: ObjectId;
@@ -135,8 +167,6 @@ interface CommitResult {
  */
 declare const commit: (ctx: Context, opts: CommitOptions) => Promise<CommitResult>;
 
-type ConflictType = 'content' | 'add-add' | 'modify-delete' | 'type-change' | 'rename-rename' | 'gitlink' | 'binary';
-
 interface DiffOptions {
     /** Resolve to a tree. Accepts ref name, oid, or 'HEAD'. */
     readonly from?: string;
@@ -175,6 +205,30 @@ interface FetchResult {
 }
 declare const fetch: (ctx: Context, opts?: FetchOptions) => Promise<FetchResult>;
 
+interface FetchMissingOptions {
+    /** Object ids to fetch. Ones already present locally are skipped. */
+    readonly oids: ReadonlyArray<ObjectId>;
+}
+interface FetchMissingResult {
+    /** The promisor remote the objects were fetched from. */
+    readonly remote: string;
+    /** Objects the caller asked for. */
+    readonly requested: number;
+    /** Objects that were missing locally and got fetched. */
+    readonly fetched: number;
+}
+/**
+ * Fetch the named objects from the repository's promisor remote. Throws
+ * `NO_PROMISOR_REMOTE` when the repository is not a partial clone.
+ */
+declare const fetchMissing: (ctx: Context, opts: FetchMissingOptions) => Promise<FetchMissingResult>;
+/**
+ * `PromisorRemote` port implementation — the seam `readObject` calls on a
+ * miss. A non-partial repository yields `attempted: false` (rather than
+ * throwing) so `readObject` falls through to its normal `OBJECT_NOT_FOUND`.
+ */
+declare const createPromisorRemote: (ctx: Context) => PromisorRemote;
+
 interface InitOptions {
     readonly initialBranch?: string;
     readonly bare?: boolean;
@@ -266,6 +320,8 @@ interface PushOptions {
     readonly refspecs?: ReadonlyArray<string>;
     readonly force?: boolean;
     readonly forceWithLease?: ObjectId | 'auto';
+    /** Skip the `pre-push` hook (git's `--no-verify`). */
+    readonly noVerify?: boolean;
 }
 interface PushedRef {
     readonly name: RefName;
@@ -281,6 +337,47 @@ interface PushResult {
 }
 declare const push: (ctx: Context, opts?: PushOptions) => Promise<PushResult>;
 
+type ReflogAction = {
+    readonly action?: 'show';
+    readonly ref?: string;
+} | {
+    readonly action: 'exists';
+    readonly ref: string;
+} | {
+    readonly action: 'delete';
+    readonly ref: string;
+    readonly index: number;
+    readonly rewrite?: boolean;
+} | {
+    readonly action: 'expire';
+    readonly ref?: string;
+    readonly all?: boolean;
+    readonly expire?: string;
+    readonly expireUnreachable?: string;
+};
+/** One reflog entry as `show` presents it: newest-first, with a selector. */
+interface ReflogShowEntry {
+    readonly index: number;
+    readonly selector: string;
+    readonly entry: ReflogEntry;
+}
+type ReflogResult = {
+    readonly kind: 'show';
+    readonly ref: RefName;
+    readonly entries: ReadonlyArray<ReflogShowEntry>;
+} | {
+    readonly kind: 'exists';
+    readonly exists: boolean;
+} | {
+    readonly kind: 'expire';
+    readonly removed: number;
+    readonly kept: number;
+} | {
+    readonly kind: 'delete';
+    readonly removed: ReflogEntry;
+};
+declare const reflog: (ctx: Context, opts?: ReflogAction) => Promise<ReflogResult>;
+
 type ResetMode = 'soft' | 'mixed' | 'hard';
 interface ResetOptions {
     readonly mode: ResetMode;
@@ -324,6 +421,37 @@ interface RmResult {
  */
 declare const rm: (ctx: Context, paths: ReadonlyArray<string>, opts?: RmOptions) => Promise<RmResult>;
 
+type SparseCheckoutAction = {
+    readonly action: 'list';
+} | {
+    readonly action: 'set';
+    readonly patterns: ReadonlyArray<string>;
+    readonly cone?: boolean;
+    readonly force?: boolean;
+} | {
+    readonly action: 'add';
+    readonly patterns: ReadonlyArray<string>;
+    readonly force?: boolean;
+} | {
+    readonly action: 'reapply';
+    readonly force?: boolean;
+} | {
+    readonly action: 'disable';
+    readonly force?: boolean;
+};
+type SparseCheckoutResult = {
+    readonly kind: 'list';
+    readonly cone: boolean;
+    readonly patterns: ReadonlyArray<string>;
+} | {
+    readonly kind: 'applied';
+    readonly cone: boolean;
+    readonly materialized: number;
+    readonly removed: number;
+    readonly retained: ReadonlyArray<FilePath>;
+};
+declare const sparseCheckout: (ctx: Context, opts: SparseCheckoutAction) => Promise<SparseCheckoutResult>;
+
 type ChangeKind = 'modified' | 'added' | 'deleted' | 'untracked';
 interface ChangeEntry {
     readonly kind: ChangeKind;
@@ -350,6 +478,24 @@ interface StatusResult {
  */
 declare const status: (ctx: Context) => Promise<StatusResult>;
 
+type SubmodulesAction = {
+    readonly action?: 'list';
+    /** Tree-ish to walk. Default: `'HEAD'`. */
+    readonly ref?: string;
+    /** Descend into nested submodules' own `.gitmodules`. Default: `false`. */
+    readonly recursive?: boolean;
+    /**
+     * Cap on recursion depth. Default: `MAX_SUBMODULE_DEPTH`. Entries at exactly
+     * this depth are yielded but not recursed into.
+     */
+    readonly maxDepth?: number;
+};
+type SubmodulesResult = {
+    readonly kind: 'list';
+    readonly entries: ReadonlyArray<SubmoduleEntry>;
+};
+declare const submodules: (ctx: Context, opts?: SubmodulesAction) => Promise<SubmodulesResult>;
+
 type TagAction = {
     readonly kind: 'list';
 } | {
@@ -378,5 +524,5 @@ type TagResult = {
 };
 declare const tag: (ctx: Context, action: TagAction) => Promise<TagResult>;
 
-export { add, branch, checkout, clone, commit, diff, fetch, init, log, merge, push, reset, revParse, rm, status, tag };
-export type { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, StatusResult, TagAction, TagInfo, TagResult };
+export { CatFileBatchEntry, SubmoduleEntry, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag };
+export type { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult };

package/dist/types/index.browser.d.cts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-23evW2h-.cjs';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BqibvTOu.cjs';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.cjs';
-export { P as ProgressReporter } from './chunks/context-D84z1i5F.cjs';
+export { P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
 import './commands/index.cjs';
-import './chunks/diff-change-Bm1zvVsC.cjs';
-import './chunks/write-tree-DVp0RJ_r.cjs';
+import './chunks/reflog-entry-BIf-zt__.cjs';
+import './chunks/write-tree-B8G6kgTy.cjs';
 import './chunks/http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/index.browser.d.ts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BT7Xq1kJ.js';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-C4rN09Am.js';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.js';
-export { P as ProgressReporter } from './chunks/context-o5TPfMB2.js';
+export { P as ProgressReporter } from './chunks/context-BORy7yXb.js';
 import './commands/index.js';
-import './chunks/diff-change-alGRzD_j.js';
-import './chunks/write-tree-DNjhjS3t.js';
+import './chunks/reflog-entry-D9P2hCgv.js';
+import './chunks/write-tree-BXCDChvv.js';
 import './chunks/http-transport-DirKfK2S.js';
 
 /**

package/dist/types/index.d.cts

@@ -1,9 +1,9 @@
-import { f as FileSystem, H as HashService, C as Compressor, P as ProgressReporter } from './chunks/context-D84z1i5F.cjs';
-export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContextParts, D as DirEntry, e as FileStat, g as Hasher, L as Logger, h as RepositoryConfig, i as RepositoryLayout, j as createContext, n as noopLogger, w as wrapLoggerSanitizer } from './chunks/context-D84z1i5F.cjs';
+import { f as FileSystem, H as HashService, C as Compressor, P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
+export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContextParts, D as DirEntry, e as FileStat, g as Hasher, h as HookName, i as HookRequest, j as HookResult, k as HookRunner, L as Logger, l as PromisorFetchOutcome, m as PromisorRemote, n as RepositoryConfig, o as RepositoryLayout, p as createContext, q as noopLogger, w as wrapLoggerSanitizer } from './chunks/context-CMrHCVwK.cjs';
 import { b as HttpTransport } from './chunks/http-transport-DirKfK2S.cjs';
 export { H as HttpRequest, a as HttpResponse } from './chunks/http-transport-DirKfK2S.cjs';
-export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, StatusResult, TagAction, TagInfo, TagResult, add, branch, checkout, clone, commit, diff, fetch, init, log, merge, push, reset, revParse, rm, status, tag } from './commands/index.cjs';
-import './chunks/diff-change-Bm1zvVsC.cjs';
+export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from './commands/index.cjs';
+export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-BIf-zt__.cjs';
 
 /**
  * The four adapter ports the facade plumbs into the Context. Each runtime

package/dist/types/index.d.ts

@@ -1,9 +1,9 @@
-import { f as FileSystem, H as HashService, C as Compressor, P as ProgressReporter } from './chunks/context-o5TPfMB2.js';
-export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContextParts, D as DirEntry, e as FileStat, g as Hasher, L as Logger, h as RepositoryConfig, i as RepositoryLayout, j as createContext, n as noopLogger, w as wrapLoggerSanitizer } from './chunks/context-o5TPfMB2.js';
+import { f as FileSystem, H as HashService, C as Compressor, P as ProgressReporter } from './chunks/context-BORy7yXb.js';
+export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContextParts, D as DirEntry, e as FileStat, g as Hasher, h as HookName, i as HookRequest, j as HookResult, k as HookRunner, L as Logger, l as PromisorFetchOutcome, m as PromisorRemote, n as RepositoryConfig, o as RepositoryLayout, p as createContext, q as noopLogger, w as wrapLoggerSanitizer } from './chunks/context-BORy7yXb.js';
 import { b as HttpTransport } from './chunks/http-transport-DirKfK2S.js';
 export { H as HttpRequest, a as HttpResponse } from './chunks/http-transport-DirKfK2S.js';
-export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, StatusResult, TagAction, TagInfo, TagResult, add, branch, checkout, clone, commit, diff, fetch, init, log, merge, push, reset, revParse, rm, status, tag } from './commands/index.js';
-import './chunks/diff-change-alGRzD_j.js';
+export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from './commands/index.js';
+export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-D9P2hCgv.js';
 
 /**
  * The four adapter ports the facade plumbs into the Context. Each runtime