just-git 1.3.7 → 1.4.0

package/dist/repo/index.d.ts

@@ -1,4 +1,5 @@
-import { g as GitRepo, a1 as RefEntry, e as Commit, a7 as TreeEntry, i as ObjectId, h as Identity, a8 as TreeDiffEntry, j as ObjectType, d as GitContext, F as FileSystem } from '../hooks-DNBNCTgb.js';
+import { g as GitRepo, Z as RefEntry, e as Commit, a3 as TreeEntry, i as ObjectId, h as Identity, a4 as TreeDiffEntry, d as GitContext, F as FileSystem } from '../hooks-C7c_BLqp.js';
+export { B as BuildCommitOptions, C as CommitAuthor, a as CommitIdentity, b as CommitOptions, c as CommitResult, d as CreateAnnotatedTagOptions, e as CreateCommitOptions, T as TreeEntryInput, f as TreeUpdate, g as buildCommit, h as commit, i as createAnnotatedTag, j as createCommit, u as updateTree, w as writeBlob, k as writeTree } from '../writing-CnM1ufDP.js';
 
 /**
  * Core grep matching logic shared by the `git grep` command and the
@@ -216,152 +217,6 @@ declare function walkCommitHistory(repo: GitRepo, startHash: string | string[],
     paths?: string[];
 }): AsyncGenerator<CommitInfo>;
 
-/**
- * Simplified identity for the public API. When `date` is omitted,
- * defaults to the current time. Accepts either this form or the
- * internal `Identity` (with `timestamp`/`timezone`) for full control.
- */
-interface CommitAuthor {
-    name: string;
-    email: string;
-    /** Defaults to `new Date()` (current time). */
-    date?: Date;
-}
-/** Accepts either the simplified {@link CommitAuthor} or the internal `Identity` with raw timestamp/timezone. */
-type CommitIdentity = CommitAuthor | Identity;
-/** Options for {@link createCommit}. */
-interface CreateCommitOptions {
-    /** Hash of the tree object for this commit. */
-    tree: string;
-    /** Parent commit hashes (empty for root commits). */
-    parents: string[];
-    /** Author identity. Accepts `{ name, email, date? }` or full `Identity`. */
-    author: CommitIdentity;
-    /** Committer identity. Defaults to `author` when omitted. */
-    committer?: CommitIdentity;
-    message: string;
-    /**
-     * When set, advances `refs/heads/<branch>` to the new commit.
-     * If HEAD does not exist yet, it is created as a symbolic ref
-     * pointing to the branch — matching `git init` + `git commit`.
-     */
-    branch?: string;
-}
-/**
- * Create a commit object directly in the object store.
- * Returns the new commit's hash.
- *
- * When `branch` is provided, also advances the branch ref and
- * (if HEAD is absent) initializes HEAD as a symbolic ref to it.
- * Without `branch`, no refs are updated.
- */
-declare function createCommit(repo: GitRepo, options: CreateCommitOptions): Promise<string>;
-/** Options for {@link createAnnotatedTag}. */
-interface CreateAnnotatedTagOptions {
-    /** Hash of the target object (usually a commit). */
-    target: string;
-    /** Tag name (written into the tag object and used for the ref). */
-    name: string;
-    /** Tagger identity. Accepts `{ name, email, date? }` or full `Identity`. */
-    tagger: CommitIdentity;
-    message: string;
-    /** Type of the target object. Defaults to `"commit"`. */
-    targetType?: ObjectType;
-}
-/**
- * Create an annotated tag object and its ref.
- * Returns the tag object's hash.
- *
- * ```ts
- * await createAnnotatedTag(repo, {
- *   target: commitHash,
- *   name: "v1.0.0",
- *   tagger: { name: "Alice", email: "alice@example.com" },
- *   message: "Release 1.0.0",
- * });
- * ```
- */
-declare function createAnnotatedTag(repo: GitRepo, options: CreateAnnotatedTagOptions): Promise<string>;
-/** Options for {@link commit}. */
-interface CommitOptions {
-    /**
-     * Files to add, update, or delete.
-     * - `string` values are written as UTF-8 blobs.
-     * - `Uint8Array` values are written as raw blobs.
-     * - `null` deletes the file from the tree.
-     */
-    files: Record<string, string | Uint8Array | null>;
-    message: string;
-    /** Author identity. Accepts `{ name, email, date? }` or full `Identity`. Timestamp defaults to now. */
-    author: CommitIdentity;
-    /** Committer identity. Defaults to `author` when omitted. */
-    committer?: CommitIdentity;
-    /** Branch to commit to. Parent is auto-resolved from the current branch tip. */
-    branch: string;
-}
-/**
- * Commit files to a branch in one call.
- *
- * Handles blob creation, tree construction, parent resolution, and
- * ref advancement. When the branch already exists, the specified
- * files are applied on top of the existing tree (unmentioned files
- * are preserved). When the branch doesn't exist, a root commit is
- * created with only the specified files.
- *
- * ```ts
- * await commit(repo, {
- *   files: { "README.md": "# Hello\n", "src/index.ts": "export {};\n" },
- *   message: "initial commit",
- *   author: { name: "Alice", email: "alice@example.com" },
- *   branch: "main",
- * });
- * ```
- */
-declare function commit(repo: GitRepo, options: CommitOptions): Promise<string>;
-/** An entry to include in a tree built by {@link writeTree}. */
-interface TreeEntryInput {
-    /** Filename (not a path — nesting is achieved by including tree entries). */
-    name: string;
-    /** Hash of the blob or tree object. */
-    hash: string;
-    /** File mode (e.g. "100644"). Auto-detected from the object store when omitted. */
-    mode?: string;
-}
-/**
- * Build a tree object from a flat list of entries and write it to the
- * object store. When `mode` is omitted, the object store is consulted:
- * tree objects get "040000", everything else gets "100644".
- */
-declare function writeTree(repo: GitRepo, entries: TreeEntryInput[]): Promise<string>;
-/**
- * Write a UTF-8 string as a blob to the object store.
- * Returns the blob's hash.
- */
-declare function writeBlob(repo: GitRepo, content: string): Promise<string>;
-/** A file to add or update in a tree via {@link updateTree}. */
-interface TreeUpdate {
-    /** Full repo-relative path (e.g. `"src/lib/foo.ts"`). */
-    path: string;
-    /** Blob hash. When `null`, the file is removed. */
-    hash: string | null;
-    /** File mode (default `"100644"`). Ignored when `hash` is `null`. */
-    mode?: string;
-}
-/**
- * Apply path-based additions, updates, and deletions to an existing
- * tree, handling nested subtree construction automatically.
- * Returns the new root tree hash.
- *
- * ```ts
- * const blob = await writeBlob(repo, "hello world\n");
- * const newTree = await updateTree(repo, commit.tree, [
- *   { path: "src/new-file.ts", hash: blob },
- *   { path: "old-file.txt", hash: null },
- * ]);
- * ```
- */
-declare function updateTree(repo: GitRepo, treeHash: string, updates: TreeUpdate[]): Promise<string>;
-
 interface MergeConflict {
     path: string;
     reason: "content" | "delete-modify" | "add-add" | "rename-delete" | "rename-rename" | "directory-rename";
@@ -544,4 +399,4 @@ declare function readonlyRepo(repo: GitRepo): GitRepo;
  */
 declare function overlayRepo(repo: GitRepo): GitRepo;
 
-export { type BlameEntry, Commit, type CommitAuthor, type CommitIdentity, type CommitInfo, type CommitOptions, type CreateAnnotatedTagOptions, type CreateCommitOptions, type CreateWorktreeOptions, type DiffHunk, type ExtractTreeResult, type FileDiff, type FlatTreeEntry, GitRepo, type GrepFileMatch, type GrepMatch, type GrepOptions, Identity, type MergeConflict, type MergeTreesResult, RefEntry, TreeDiffEntry, TreeEntry, type TreeEntryInput, type TreeUpdate, type WorktreeResult, blame, commit, countAheadBehind, createAnnotatedTag, createCommit, createSandboxWorktree, createWorktree, diffCommits, diffTrees, extractTree, findMergeBases, flattenTree, getChangedFiles, getNewCommits, grep, isAncestor, listBranches, listTags, mergeTrees, mergeTreesFromTreeHashes, overlayRepo, readBlob, readBlobText, readCommit, readFileAtCommit, readTree, readonlyRepo, resolveRef, updateTree, walkCommitHistory, writeBlob, writeTree };
+export { type BlameEntry, Commit, type CommitInfo, type CreateWorktreeOptions, type DiffHunk, type ExtractTreeResult, type FileDiff, type FlatTreeEntry, GitRepo, type GrepFileMatch, type GrepMatch, type GrepOptions, Identity, type MergeConflict, type MergeTreesResult, RefEntry, TreeDiffEntry, TreeEntry, type WorktreeResult, blame, countAheadBehind, createSandboxWorktree, createWorktree, diffCommits, diffTrees, extractTree, findMergeBases, flattenTree, getChangedFiles, getNewCommits, grep, isAncestor, listBranches, listTags, mergeTrees, mergeTreesFromTreeHashes, overlayRepo, readBlob, readBlobText, readCommit, readFileAtCommit, readTree, readonlyRepo, resolveRef, walkCommitHistory };