es-git 0.2.0-next.113 → 0.2.0-next.115

package/index.d.ts

@@ -3,6 +3,72 @@
 
 /* auto-generated by NAPI-RS */
 
+/**
+ * Represents a hunk of a blame operation, which is a range of lines
+ * and information about who last modified them.
+ */
+export interface BlameHunk {
+  /** The oid of the commit where this line was last changed. */
+  finalCommitId: string
+  /** The 1-based line number in the final file where this hunk starts. */
+  finalStartLineNumber: number
+  /** The number of lines in this hunk. */
+  linesInHunk: number
+  /** The signature of the commit where this line was last changed. */
+  finalSignature?: Signature
+  /** The path to the file where this line was originally written. */
+  path?: string
+  /** The 1-based line number in the original file where this hunk starts. */
+  origStartLineNumber: number
+  /** The oid of the commit where this line was originally written. */
+  origCommitId: string
+  /** The signature of the commit where this line was originally written. */
+  origSignature?: Signature
+  /**
+   * True if the hunk has been determined to be a boundary commit (the commit
+   * when the file was first introduced to the repository).
+   */
+  isBoundary: boolean
+}
+/** Options for controlling blame behavior */
+export interface BlameOptions {
+  /** The minimum line number to blame (1-based index) */
+  minLine?: number
+  /** The maximum line number to blame (1-based index) */
+  maxLine?: number
+  /**
+   * The oid of the newest commit to consider. The blame algorithm will stop
+   * when this commit is reached.
+   */
+  newestCommit?: string
+  /**
+   * The oid of the oldest commit to consider. The blame algorithm will
+   * stop when this commit is reached.
+   */
+  oldestCommit?: string
+  /**
+   * The path to the file being worked on. Path has to be relative to the
+   * repo root.
+   */
+  path?: string
+  /**
+   * Track lines that have moved within a file. This is the git-blame -M
+   * option.
+   */
+  trackLinesMovement?: boolean
+  /** Restrict search to commits reachable following only first parents. */
+  firstParent?: boolean
+  /** Ignore whitespace differences. */
+  ignoreWhitespace?: boolean
+  /** Track lines that have been copied from another file that exists in any commit. */
+  trackCopiesAnyCommitCopies?: boolean
+  /** Track lines that have been copied from another file that exists in the same commit. */
+  trackCopiesSameCommitCopies?: boolean
+  /** Track lines that have moved across files in the same commit. */
+  trackCopiesSameCommitMoves?: boolean
+  /** Use mailmap file to map author and committer names and email addresses to canonical real names and email addresses. */
+  useMailmap?: boolean
+}
 /**
  * Ensure the branch name is well-formed.
  *
@@ -1376,6 +1442,66 @@ export interface SignaturePayload {
   email: string
   timeOptions?: SignatureTimeOptions
 }
+export interface Status {
+  current: boolean
+  indexNew: boolean
+  indexModified: boolean
+  indexDeleted: boolean
+  indexRenamed: boolean
+  indexTypechange: boolean
+  wtNew: boolean
+  wtModified: boolean
+  wtDeleted: boolean
+  wtTypechange: boolean
+  wtRenamed: boolean
+  ignored: boolean
+  conflicted: boolean
+}
+/**
+ * - `Index` : Only gives status based on HEAD to index comparison, not looking at
+ * working directory changes.
+ * - `Workdir` : Only gives status based on index to working directory comparison, not
+ * comparing the index to the HEAD.
+ * - `IndexAndWorkdi` : The default, this roughly matches `git status --porcelain` regarding
+ * which files are included and in what order.
+ */
+export type StatusShow = 'Index' | 'Workdir' | 'IndexAndWorkdir';
+export interface StatusOptions {
+  /**
+   * Select the files on which to report status.
+   * The default, if unspecified, is to show the index and the working directory.
+   */
+  show?: StatusShow
+  /**
+   * Path patterns to match (using fnmatch-style matching).
+   * If the `disablePathspecMatch` option is given, then this is a literal
+   * path to match. If this is not called, then there will be no patterns to
+   * match and the entire directory will be used.
+   */
+  pathspecs?: Array<string>
+  /**
+   * Flag whether untracked files will be included.
+   * Untracked files will only be included if the workdir files are included
+   * in the status "show" option.
+   */
+  includeUntracked?: boolean
+  includeIgnored?: boolean
+  includeUnmodified?: boolean
+  excludeSubmodules?: boolean
+  recurseUntrackedDirs?: boolean
+  disablePathspecMatch?: boolean
+  recurseIgnoredDirs?: boolean
+  renamesHeadToIndex?: boolean
+  renamesIndexToWorkdir?: boolean
+  sortCaseSensitively?: boolean
+  sortCaseInsensitively?: boolean
+  renamesFromRewrites?: boolean
+  noRefresh?: boolean
+  updateIndex?: boolean
+  includeUnreadable?: boolean
+  includeUnreadableAsUntracked?: boolean
+  renameThreshold?: number
+}
 /**
  * Determine whether a tag name is valid, meaning that (when prefixed with refs/tags/) that
  * it is a valid reference name, and that any additional tag name restrictions are imposed
@@ -1420,6 +1546,146 @@ export interface CreateLightweightTagOptions {
  * - `PostOrder` : Runs the traversal in post-order.
  */
 export type TreeWalkMode = 'PreOrder' | 'PostOrder';
+/** A wrapper around git2::Blame providing Node.js bindings */
+export declare class Blame {
+  /**
+   * Gets the number of hunks in the blame result
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   getHunkCount(): number;
+   * }
+   * ```
+   *
+   * @returns The number of hunks in the blame result
+   */
+  getHunkCount(): number
+  /**
+   * Checks if the blame result is empty
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   isEmpty(): boolean;
+   * }
+   * ```
+   *
+   * @returns True if the blame result contains no hunks
+   */
+  isEmpty(): boolean
+  /**
+   * Gets blame information for the specified index
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   getHunkByIndex(index: number): BlameHunk;
+   * }
+   * ```
+   *
+   * @param {number} index - Index of the hunk to get (0-based)
+   * @returns Blame information for the specified index
+   * @throws If no hunk is found at the index
+   */
+  getHunkByIndex(index: number): BlameHunk
+  /**
+   * Gets blame information for the specified line
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   getHunkByLine(line: number): BlameHunk;
+   * }
+   * ```
+   *
+   * @param {number} line - Line number to get blame information for (1-based)
+   * @returns Blame information for the specified line
+   * @throws If no hunk is found for the line
+   */
+  getHunkByLine(line: number): BlameHunk
+  /**
+   * Gets all blame hunks as an iterator
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   iter(): Generator<BlameHunk>;
+   * }
+   * ```
+   *
+   * @returns Iterator of all blame hunks
+   * @example
+   * ```ts
+   * // Using for...of loop
+   * for (const hunk of blame.iter()) {
+   *   console.log(hunk.finalCommitId);
+   * }
+   *
+   * // Using spread operator to collect all hunks
+   * const hunks = [...blame.iter()];
+   * ```
+   */
+  iter(): BlameHunks
+  /**
+   * Collects blame hunks by scanning file lines as an iterator
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   iterByLine(): Generator<BlameHunk>;
+   * }
+   * ```
+   *
+   * @returns Iterator of blame hunks collected by line scanning
+   * @example
+   * ```ts
+   * // Using for...of loop
+   * for (const hunk of blame.iterByLine()) {
+   *   console.log(hunk.finalCommitId);
+   * }
+   *
+   * // Using spread operator to collect all hunks
+   * const hunks = [...blame.iterByLine()];
+   * ```
+   */
+  iterByLine(): BlameHunksByLine
+  /**
+   * Generates blame information from an in-memory buffer
+   *
+   * @category Blame/Methods
+   * @signature
+   * ```ts
+   * class Blame {
+   *   buffer(buffer: Buffer): Blame;
+   * }
+   * ```
+   *
+   * @example
+   * ```ts
+   * const buffer = Buffer.from('modified content');
+   * const bufferBlame = blame.buffer(buffer);
+   * ```
+   *
+   * @param {Buffer} buffer - Buffer containing file content to blame
+   * @returns A new Blame object for the buffer content
+   */
+  buffer(buffer: Buffer): Blame
+}
+/** An iterator over blame hunks. */
+export declare class BlameHunks {
+  [Symbol.iterator](): Iterator<BlameHunk, void, void>
+}
+/** Iterator over blame hunks collected line by line. */
+export declare class BlameHunksByLine {
+  [Symbol.iterator](): Iterator<BlameHunk, void, void>
+}
 /**
  * A class to represent a git [blob][1].
  * [1]: https://git-scm.com/book/en/Git-Internals-Git-Objects
@@ -3413,6 +3679,35 @@ export declare class Remote {
  * This class corresponds to a git repository in libgit2.
  */
 export declare class Repository {
+  /**
+   * Creates a blame object for the file at the given path
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   blameFile(path: string, options?: BlameOptions): Blame;
+   * }
+   * ```
+   *
+   * @example
+   * ```ts
+   * // Blame the entire file
+   * const blame = repo.blameFile('path/to/file.js');
+   *
+   * // Blame a single line
+   * const lineBlame = repo.blameFile('path/to/file.js', { minLine: 10, maxLine: 10 });
+   *
+   * // Blame a range of lines
+   * const rangeBlame = repo.blameFile('path/to/file.js', { minLine: 5, maxLine: 15 });
+   * ```
+   *
+   * @param {string} path - Path to the file to blame
+   * @param {BlameOptions} [options] - Options to control blame behavior
+   * @returns Blame object for the specified file
+   * @throws If the file doesn't exist or can't be opened
+   */
+  blameFile(path: string, options?: BlameOptions | undefined | null): Blame
   /**
    * Create a new branch pointing at a target commit
    *
@@ -4079,6 +4374,108 @@ export declare class Repository {
    * @returns Revwalk to traverse the commit graph in this repository.
    */
   revwalk(): Revwalk
+  /**
+   * Test if the ignore rules apply to a given file.
+   *
+   * This function checks the ignore rules to see if they would apply to the
+   * given file. This indicates if the file would be ignored regardless of
+   * whether the file is already in the index or committed to the repository.
+   *
+   * One way to think of this is if you were to do "git add ." on the
+   * directory containing the file, would it be added or not?
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   statusShouldIgnore(path: string): boolean;
+   * }
+   * ```
+   *
+   * @param {string} path - A given file path.
+   * @returns Returns `true` if the ignore rules apply to a given file.
+   */
+  statusShouldIgnore(path: string): boolean
+  /**
+   * Get file status for a single file.
+   *
+   * This tries to get status for the filename that you give. If no files
+   * match that name (in either the HEAD, index, or working directory), this
+   * returns NotFound.
+   *
+   * If the name matches multiple files (for example, if the path names a
+   * directory or if running on a case- insensitive filesystem and yet the
+   * HEAD has two entries that both match the path), then this returns
+   * Ambiguous because it cannot give correct results.
+   *
+   * This does not do any sort of rename detection. Renames require a set of
+   * targets and because of the path filtering, there is not enough
+   * information to check renames correctly. To check file status with rename
+   * detection, there is no choice but to do a full `statuses` and scan
+   * through looking for the path that you are interested in.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   getStatusFile(path: string): Status;
+   * }
+   * ```
+   *
+   * @param {string} path - A single file path.
+   * @returns The `Status` of this single file.
+   * @throws Throws error if the status file does not exist.
+   */
+  getStatusFile(path: string): Status
+  /**
+   * Get file status for a single file.
+   *
+   * This tries to get status for the filename that you give. If no files
+   * match that name (in either the HEAD, index, or working directory), this
+   * returns NotFound.
+   *
+   * If the name matches multiple files (for example, if the path names a
+   * directory or if running on a case- insensitive filesystem and yet the
+   * HEAD has two entries that both match the path), then this returns
+   * Ambiguous because it cannot give correct results.
+   *
+   * This does not do any sort of rename detection. Renames require a set of
+   * targets and because of the path filtering, there is not enough
+   * information to check renames correctly. To check file status with rename
+   * detection, there is no choice but to do a full `statuses` and scan
+   * through looking for the path that you are interested in.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   findStatusFile(path: string): Status | null;
+   * }
+   * ```
+   *
+   * @param {string} path - A single file path.
+   * @returns The `Status` of this single file. If the status file does not exists, returns `null`.
+   */
+  findStatusFile(path: string): Status | null
+  /**
+   * Gather file status information and populate the returned structure.
+   *
+   * Note that if a pathspec is given in the options to filter the
+   * status, then the results from rename detection (if you enable it) may
+   * not be accurate. To do rename detection properly, this must be called
+   * with no pathspec so that all files can be considered.
+   *
+   * @category Repository/Methods
+   * @signature
+   * ```ts
+   * class Repository {
+   *   statuses(): Statuses;
+   * }
+   * ```
+   *
+   * @returns A container for a list of status information about a repository.
+   */
+  statuses(): Statuses
   /**
    * Lookup a tag object by prefix hash from the repository.
    *
@@ -4524,6 +4921,123 @@ export declare class Revwalk {
    */
   hideRef(reference: string): this
 }
+/**
+ * A container for a list of status information about a repository.
+ *
+ * Each instance appears as if it were a collection, having a length and
+ * allowing indexing, as well as providing an iterator.
+ */
+export declare class Statuses {
+  /**
+   * Gets a status entry from this list at the specified index.
+   *
+   * @category Status/Statuses
+   * @signature
+   * ```ts
+   * class Statuses {
+   *   get(index: number): StatusEntry | null;
+   * }
+   * ```
+   *
+   * @param {number} index - Index of the status entry to get.
+   * @returns A status entry from this list at the specified index. Returns `null` if the status
+   * entry does not exist.
+   */
+  get(index: number): StatusEntry | null
+  /**
+   * Gets the count of status entries in this list.
+   *
+   * @category Status/Statuses
+   * @signature
+   * ```ts
+   * class Statuses {
+   *   len(): number;
+   * }
+   * ```
+   *
+   * @returns If there are no changes in status (according to the options given
+   * when the status list was created), this should return 0.
+   */
+  len(): bigint
+  /**
+   * @category Status/Statuses
+   * @signature
+   * ```ts
+   * class Statuses {
+   *   isEmpty(): boolean;
+   * }
+   * ```
+   *
+   * @returns Return `true` if there is no status entry in this list.
+   */
+  isEmpty(): boolean
+  /** Returns an iterator over the statuses in this list. */
+  iter(): StatusesIter
+}
+export declare class StatusesIter {
+  [Symbol.iterator](): Iterator<StatusEntry, void, void>
+}
+/** A structure representing an entry in the `Statuses` structure. */
+export declare class StatusEntry {
+  /**
+   * Access this entry's path name as a string.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   path(): string;
+   * }
+   * ```
+   *
+   * @returns The path of this entry.
+   */
+  path(): string
+  /**
+   * Access the status for this file.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   status(): Status;
+   * }
+   * ```
+   *
+   * @returns Status data for this entry.
+   */
+  status(): Status
+  /**
+   * Access detailed information about the differences between the file in
+   * `HEAD` and the file in the index.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   headToIndex(): DiffDelta | null;
+   * }
+   * ```
+   *
+   * @returns The differences between the file in `HEAD` and the file in the index.
+   */
+  headToIndex(): DiffDelta | null
+  /**
+   * Access detailed information about the differences between the file in
+   * the index and the file in the working directory.
+   *
+   * @category Status/StatusEntry
+   * @signature
+   * ```ts
+   * class StatusEntry {
+   *   indexToWorkdir(): DiffDelta | null;
+   * }
+   * ```
+   *
+   * @returns Differences between the file in the index and the file in the working directory.
+   */
+  indexToWorkdir(): DiffDelta | null
+}
 /**
  * A class to represent a git [tag][1].
  *

package/index.js

@@ -310,8 +310,11 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { Blob, isValidBranchName, Branch, Branches, BranchType, Commit, ConfigLevel, ConfigEntries, Config, openConfig, openDefaultConfig, findGlobalConfigPath, findSystemConfigPath, findXdgConfigPath, parseConfigBool, parseConfigI32, parseConfigI64, DiffFlags, diffFlagsContains, DeltaType, DiffFormat, Diff, DiffStats, Deltas, DiffDelta, FileMode, DiffFile, IndexStage, Index, IndexEntries, ObjectType, GitObject, isValidOid, isZeroOid, zeroOid, hashObjectOid, hashFileOid, ReferenceType, Reference, isValidReferenceName, ReferenceFormat, normalizeReferenceName, Direction, CredentialType, FetchPrune, AutotagOption, RemoteRedirect, Remote, RepositoryState, RepositoryInitMode, Repository, initRepository, openRepository, discoverRepository, cloneRepository, RevparseMode, revparseModeContains, RevwalkSort, Revwalk, createSignature, isValidTagName, Tag, TreeWalkMode, Tree, TreeIter, TreeEntry } = nativeBinding
+const { Blame, BlameHunks, BlameHunksByLine, Blob, isValidBranchName, Branch, Branches, BranchType, Commit, ConfigLevel, ConfigEntries, Config, openConfig, openDefaultConfig, findGlobalConfigPath, findSystemConfigPath, findXdgConfigPath, parseConfigBool, parseConfigI32, parseConfigI64, DiffFlags, diffFlagsContains, DeltaType, DiffFormat, Diff, DiffStats, Deltas, DiffDelta, FileMode, DiffFile, IndexStage, Index, IndexEntries, ObjectType, GitObject, isValidOid, isZeroOid, zeroOid, hashObjectOid, hashFileOid, ReferenceType, Reference, isValidReferenceName, ReferenceFormat, normalizeReferenceName, Direction, CredentialType, FetchPrune, AutotagOption, RemoteRedirect, Remote, RepositoryState, RepositoryInitMode, Repository, initRepository, openRepository, discoverRepository, cloneRepository, RevparseMode, revparseModeContains, RevwalkSort, Revwalk, createSignature, StatusShow, Statuses, StatusesIter, StatusEntry, isValidTagName, Tag, TreeWalkMode, Tree, TreeIter, TreeEntry } = nativeBinding
 
+module.exports.Blame = Blame
+module.exports.BlameHunks = BlameHunks
+module.exports.BlameHunksByLine = BlameHunksByLine
 module.exports.Blob = Blob
 module.exports.isValidBranchName = isValidBranchName
 module.exports.Branch = Branch
@@ -372,6 +375,10 @@ module.exports.revparseModeContains = revparseModeContains
 module.exports.RevwalkSort = RevwalkSort
 module.exports.Revwalk = Revwalk
 module.exports.createSignature = createSignature
+module.exports.StatusShow = StatusShow
+module.exports.Statuses = Statuses
+module.exports.StatusesIter = StatusesIter
+module.exports.StatusEntry = StatusEntry
 module.exports.isValidTagName = isValidTagName
 module.exports.Tag = Tag
 module.exports.TreeWalkMode = TreeWalkMode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-git",
-  "version": "0.2.0-next.113+22576a9",
+  "version": "0.2.0-next.115+0a7a680",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
@@ -57,15 +57,15 @@
     "vitest": "^3.0.5"
   },
   "optionalDependencies": {
-    "es-git-darwin-x64": "0.2.0-next.113+22576a9",
-    "es-git-darwin-arm64": "0.2.0-next.113+22576a9",
-    "es-git-win32-x64-msvc": "0.2.0-next.113+22576a9",
-    "es-git-win32-arm64-msvc": "0.2.0-next.113+22576a9",
-    "es-git-linux-x64-gnu": "0.2.0-next.113+22576a9",
-    "es-git-linux-x64-musl": "0.2.0-next.113+22576a9",
-    "es-git-android-arm64": "0.2.0-next.113+22576a9",
-    "es-git-linux-arm64-gnu": "0.2.0-next.113+22576a9",
-    "es-git-linux-arm64-musl": "0.2.0-next.113+22576a9",
-    "es-git-android-arm-eabi": "0.2.0-next.113+22576a9"
+    "es-git-darwin-x64": "0.2.0-next.115+0a7a680",
+    "es-git-darwin-arm64": "0.2.0-next.115+0a7a680",
+    "es-git-win32-x64-msvc": "0.2.0-next.115+0a7a680",
+    "es-git-win32-arm64-msvc": "0.2.0-next.115+0a7a680",
+    "es-git-linux-x64-gnu": "0.2.0-next.115+0a7a680",
+    "es-git-linux-x64-musl": "0.2.0-next.115+0a7a680",
+    "es-git-android-arm64": "0.2.0-next.115+0a7a680",
+    "es-git-linux-arm64-gnu": "0.2.0-next.115+0a7a680",
+    "es-git-linux-arm64-musl": "0.2.0-next.115+0a7a680",
+    "es-git-android-arm-eabi": "0.2.0-next.115+0a7a680"
   }
 }