@rushstack/package-deps-hash 4.6.7 → 4.7.0

package/CHANGELOG.json

@@ -1,6 +1,38 @@
 {
   "name": "@rushstack/package-deps-hash",
   "entries": [
+    {
+      "version": "4.7.0",
+      "tag": "@rushstack/package-deps-hash_v4.7.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "4.6.8",
+      "tag": "@rushstack/package-deps-hash_v4.6.8",
+      "date": "Sat, 07 Feb 2026 01:13:26 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.1.14`"
+          }
+        ]
+      }
+    },
     {
       "version": "4.6.7",
       "tag": "@rushstack/package-deps-hash_v4.6.7",

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Change Log - @rushstack/package-deps-hash
 
-This log was last generated on Wed, 04 Feb 2026 20:42:47 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:04:53 GMT and should not be manually modified.
+
+## 4.7.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
+
+## 4.6.8
+Sat, 07 Feb 2026 01:13:26 GMT
+
+_Version update only_
 
 ## 4.6.7
 Wed, 04 Feb 2026 20:42:47 GMT

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.56.1"
+      "packageVersion": "7.56.3"
     }
   ]
 }

package/lib-esm/getPackageDeps.js

@@ -0,0 +1,222 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import * as path from 'node:path';
+import { Executable } from '@rushstack/node-core-library';
+import { ensureGitMinimumVersion } from './getRepoState';
+/**
+ * Parses a quoted filename sourced from the output of the "git status" command.
+ *
+ * Paths with non-standard characters will be enclosed with double-quotes, and non-standard
+ * characters will be backslash escaped (ex. double-quotes, non-ASCII characters). The
+ * escaped chars can be included in one of two ways:
+ * - backslash-escaped chars (ex. \")
+ * - octal encoded chars (ex. \347)
+ *
+ * See documentation: https://git-scm.com/docs/git-status
+ */
+export function parseGitFilename(filename) {
+    // If there are no double-quotes around the string, then there are no escaped characters
+    // to decode, so just return
+    if (!filename.match(/^".+"$/)) {
+        return filename;
+    }
+    // Need to hex encode '%' since we will be decoding the converted octal values from hex
+    filename = filename.replace(/%/g, '%25');
+    // Replace all instances of octal literals with percent-encoded hex (ex. '\347\275\221' -> '%E7%BD%91').
+    // This is done because the octal literals represent UTF-8 bytes, and by converting them to percent-encoded
+    // hex, we can use decodeURIComponent to get the Unicode chars.
+    filename = filename.replace(/(?:\\(\d{1,3}))/g, (match, ...[octalValue, index, source]) => {
+        // We need to make sure that the backslash is intended to escape the octal value. To do this, walk
+        // backwards from the match to ensure that it's already escaped.
+        const trailingBackslashes = source
+            .slice(0, index)
+            .match(/\\*$/);
+        return trailingBackslashes && trailingBackslashes.length > 0 && trailingBackslashes[0].length % 2 === 0
+            ? `%${parseInt(octalValue, 8).toString(16)}`
+            : match;
+    });
+    // Finally, decode the filename and unescape the escaped UTF-8 chars
+    return JSON.parse(decodeURIComponent(filename));
+}
+/**
+ * Parses the output of the "git ls-tree" command
+ */
+export function parseGitLsTree(output) {
+    const changes = new Map();
+    if (output) {
+        // A line is expected to look like:
+        // 100644 blob 3451bccdc831cb43d7a70ed8e628dcf9c7f888c8    src/typings/tsd.d.ts
+        // 160000 commit c5880bf5b0c6c1f2e2c43c95beeb8f0a808e8bac  rushstack
+        const gitRegex = /([0-9]{6})\s(blob|commit)\s([a-f0-9]{40})\s*(.*)/;
+        // Note: The output of git ls-tree uses \n newlines regardless of OS.
+        const outputLines = output.trim().split('\n');
+        for (const line of outputLines) {
+            if (line) {
+                // Take everything after the "100644 blob", which is just the hash and filename
+                const matches = line.match(gitRegex);
+                if (matches && matches[3] && matches[4]) {
+                    const hash = matches[3];
+                    const filename = parseGitFilename(matches[4]);
+                    changes.set(filename, hash);
+                }
+                else {
+                    throw new Error(`Cannot parse git ls-tree input: "${line}"`);
+                }
+            }
+        }
+    }
+    return changes;
+}
+/**
+ * Parses the output of the "git status" command
+ */
+export function parseGitStatus(output, packagePath) {
+    const changes = new Map();
+    /*
+     * Typically, output will look something like:
+     * M temp_modules/rush-package-deps-hash/package.json
+     * D package-deps-hash/src/index.ts
+     */
+    // If there was an issue with `git ls-tree`, or there are no current changes, processOutputBlocks[1]
+    // will be empty or undefined
+    if (!output) {
+        return changes;
+    }
+    // Note: The output of git hash-object uses \n newlines regardless of OS.
+    const outputLines = output.trim().split('\n');
+    for (const line of outputLines) {
+        /*
+         * changeType is in the format of "XY" where "X" is the status of the file in the index and "Y" is the status of
+         * the file in the working tree. Some example statuses:
+         *   - 'D' == deletion
+         *   - 'M' == modification
+         *   - 'A' == addition
+         *   - '??' == untracked
+         *   - 'R' == rename
+         *   - 'RM' == rename with modifications
+         *   - '[MARC]D' == deleted in work tree
+         * Full list of examples: https://git-scm.com/docs/git-status#_short_format
+         */
+        const match = line.match(/("(\\"|[^"])+")|(\S+\s*)/g);
+        if (match && match.length > 1) {
+            const [changeType, ...filenameMatches] = match;
+            // We always care about the last filename in the filenames array. In the case of non-rename changes,
+            // the filenames array only contains one file, so we can join all segments that were split on spaces.
+            // In the case of rename changes, the last item in the array is the path to the file in the working tree,
+            // which is the only one that we care about. It is also surrounded by double-quotes if spaces are
+            // included, so no need to worry about joining different segments
+            let lastFilename = changeType.startsWith('R')
+                ? filenameMatches[filenameMatches.length - 1]
+                : filenameMatches.join('');
+            lastFilename = parseGitFilename(lastFilename);
+            changes.set(lastFilename, changeType.trimRight());
+        }
+    }
+    return changes;
+}
+/**
+ * Takes a list of files and returns the current git hashes for them
+ *
+ * @public
+ */
+export function getGitHashForFiles(filesToHash, packagePath, gitPath) {
+    const changes = new Map();
+    if (filesToHash.length) {
+        // Use --stdin-paths arg to pass the list of files to git in order to avoid issues with
+        // command length
+        const result = Executable.spawnSync(gitPath || 'git', ['hash-object', '--stdin-paths'], { input: filesToHash.map((x) => path.resolve(packagePath, x)).join('\n') });
+        if (result.status !== 0) {
+            ensureGitMinimumVersion(gitPath);
+            throw new Error(`git hash-object exited with status ${result.status}: ${result.stderr}`);
+        }
+        const hashStdout = result.stdout.trim();
+        // The result of "git hash-object" will be a list of file hashes delimited by newlines
+        const hashes = hashStdout.split('\n');
+        if (hashes.length !== filesToHash.length) {
+            throw new Error(`Passed ${filesToHash.length} file paths to Git to hash, but received ${hashes.length} hashes.`);
+        }
+        for (let i = 0; i < hashes.length; i++) {
+            const hash = hashes[i];
+            const filePath = filesToHash[i];
+            changes.set(filePath, hash);
+        }
+    }
+    return changes;
+}
+/**
+ * Executes "git ls-tree" in a folder
+ */
+export function gitLsTree(cwdPath, gitPath) {
+    const result = Executable.spawnSync(gitPath || 'git', ['ls-tree', 'HEAD', '-r'], {
+        currentWorkingDirectory: cwdPath
+    });
+    if (result.status !== 0) {
+        ensureGitMinimumVersion(gitPath);
+        throw new Error(`git ls-tree exited with status ${result.status}: ${result.stderr}`);
+    }
+    return result.stdout;
+}
+/**
+ * Executes "git status" in a folder
+ */
+export function gitStatus(cwdPath, gitPath) {
+    /**
+     * -s - Short format. Will be printed as 'XY PATH' or 'XY ORIG_PATH -> PATH'. Paths with non-standard
+     *      characters will be escaped using double-quotes, and non-standard characters will be backslash
+     *      escaped (ex. spaces, tabs, double-quotes)
+     * -u - Untracked files are included
+     *
+     * See documentation here: https://git-scm.com/docs/git-status
+     */
+    const result = Executable.spawnSync(gitPath || 'git', ['status', '-s', '-u', '.'], {
+        currentWorkingDirectory: cwdPath
+    });
+    if (result.status !== 0) {
+        ensureGitMinimumVersion(gitPath);
+        throw new Error(`git status exited with status ${result.status}: ${result.stderr}`);
+    }
+    return result.stdout;
+}
+/**
+ * Builds an object containing hashes for the files under the specified `packagePath` folder.
+ * @param packagePath - The folder path to derive the package dependencies from. This is typically the folder
+ *                      containing package.json.  If omitted, the default value is the current working directory.
+ * @param excludedPaths - An optional array of file path exclusions. If a file should be omitted from the list
+ *                         of dependencies, use this to exclude it.
+ * @returns the package-deps.json file content
+ *
+ * @public
+ */
+export function getPackageDeps(packagePath = process.cwd(), excludedPaths, gitPath) {
+    const gitLsOutput = gitLsTree(packagePath, gitPath);
+    // Add all the checked in hashes
+    const result = parseGitLsTree(gitLsOutput);
+    // Remove excluded paths
+    if (excludedPaths) {
+        for (const excludedPath of excludedPaths) {
+            result.delete(excludedPath);
+        }
+    }
+    // Update the checked in hashes with the current repo status
+    const gitStatusOutput = gitStatus(packagePath, gitPath);
+    const currentlyChangedFiles = parseGitStatus(gitStatusOutput, packagePath);
+    const filesToHash = [];
+    const excludedPathSet = new Set(excludedPaths);
+    for (const [filename, changeType] of currentlyChangedFiles) {
+        // See comments inside parseGitStatus() for more information
+        if (changeType === 'D' || (changeType.length === 2 && changeType.charAt(1) === 'D')) {
+            result.delete(filename);
+        }
+        else {
+            if (!excludedPathSet.has(filename)) {
+                filesToHash.push(filename);
+            }
+        }
+    }
+    const currentlyChangedFileHashes = getGitHashForFiles(filesToHash, packagePath, gitPath);
+    for (const [filename, hash] of currentlyChangedFileHashes) {
+        result.set(filename, hash);
+    }
+    return result;
+}
+//# sourceMappingURL=getPackageDeps.js.map

package/lib-esm/getPackageDeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPackageDeps.js","sourceRoot":"","sources":["../src/getPackageDeps.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type * as child_process from 'node:child_process';\nimport * as path from 'node:path';\n\nimport { Executable } from '@rushstack/node-core-library';\n\nimport { ensureGitMinimumVersion } from './getRepoState';\n\n/**\n * Parses a quoted filename sourced from the output of the \"git status\" command.\n *\n * Paths with non-standard characters will be enclosed with double-quotes, and non-standard\n * characters will be backslash escaped (ex. double-quotes, non-ASCII characters). The\n * escaped chars can be included in one of two ways:\n * - backslash-escaped chars (ex. \\\")\n * - octal encoded chars (ex. \\347)\n *\n * See documentation: https://git-scm.com/docs/git-status\n */\nexport function parseGitFilename(filename: string): string {\n  // If there are no double-quotes around the string, then there are no escaped characters\n  // to decode, so just return\n  if (!filename.match(/^\".+\"$/)) {\n    return filename;\n  }\n\n  // Need to hex encode '%' since we will be decoding the converted octal values from hex\n  filename = filename.replace(/%/g, '%25');\n  // Replace all instances of octal literals with percent-encoded hex (ex. '\\347\\275\\221' -> '%E7%BD%91').\n  // This is done because the octal literals represent UTF-8 bytes, and by converting them to percent-encoded\n  // hex, we can use decodeURIComponent to get the Unicode chars.\n  filename = filename.replace(/(?:\\\\(\\d{1,3}))/g, (match, ...[octalValue, index, source]) => {\n    // We need to make sure that the backslash is intended to escape the octal value. To do this, walk\n    // backwards from the match to ensure that it's already escaped.\n    const trailingBackslashes: RegExpMatchArray | null = (source as string)\n      .slice(0, index as number)\n      .match(/\\\\*$/);\n    return trailingBackslashes && trailingBackslashes.length > 0 && trailingBackslashes[0].length % 2 === 0\n      ? `%${parseInt(octalValue, 8).toString(16)}`\n      : match;\n  });\n\n  // Finally, decode the filename and unescape the escaped UTF-8 chars\n  return JSON.parse(decodeURIComponent(filename));\n}\n\n/**\n * Parses the output of the \"git ls-tree\" command\n */\nexport function parseGitLsTree(output: string): Map<string, string> {\n  const changes: Map<string, string> = new Map<string, string>();\n\n  if (output) {\n    // A line is expected to look like:\n    // 100644 blob 3451bccdc831cb43d7a70ed8e628dcf9c7f888c8    src/typings/tsd.d.ts\n    // 160000 commit c5880bf5b0c6c1f2e2c43c95beeb8f0a808e8bac  rushstack\n    const gitRegex: RegExp = /([0-9]{6})\\s(blob|commit)\\s([a-f0-9]{40})\\s*(.*)/;\n\n    // Note: The output of git ls-tree uses \\n newlines regardless of OS.\n    const outputLines: string[] = output.trim().split('\\n');\n    for (const line of outputLines) {\n      if (line) {\n        // Take everything after the \"100644 blob\", which is just the hash and filename\n        const matches: RegExpMatchArray | null = line.match(gitRegex);\n        if (matches && matches[3] && matches[4]) {\n          const hash: string = matches[3];\n          const filename: string = parseGitFilename(matches[4]);\n\n          changes.set(filename, hash);\n        } else {\n          throw new Error(`Cannot parse git ls-tree input: \"${line}\"`);\n        }\n      }\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Parses the output of the \"git status\" command\n */\nexport function parseGitStatus(output: string, packagePath: string): Map<string, string> {\n  const changes: Map<string, string> = new Map<string, string>();\n\n  /*\n   * Typically, output will look something like:\n   * M temp_modules/rush-package-deps-hash/package.json\n   * D package-deps-hash/src/index.ts\n   */\n\n  // If there was an issue with `git ls-tree`, or there are no current changes, processOutputBlocks[1]\n  // will be empty or undefined\n  if (!output) {\n    return changes;\n  }\n\n  // Note: The output of git hash-object uses \\n newlines regardless of OS.\n  const outputLines: string[] = output.trim().split('\\n');\n  for (const line of outputLines) {\n    /*\n     * changeType is in the format of \"XY\" where \"X\" is the status of the file in the index and \"Y\" is the status of\n     * the file in the working tree. Some example statuses:\n     *   - 'D' == deletion\n     *   - 'M' == modification\n     *   - 'A' == addition\n     *   - '??' == untracked\n     *   - 'R' == rename\n     *   - 'RM' == rename with modifications\n     *   - '[MARC]D' == deleted in work tree\n     * Full list of examples: https://git-scm.com/docs/git-status#_short_format\n     */\n    const match: RegExpMatchArray | null = line.match(/(\"(\\\\\"|[^\"])+\")|(\\S+\\s*)/g);\n\n    if (match && match.length > 1) {\n      const [changeType, ...filenameMatches] = match;\n\n      // We always care about the last filename in the filenames array. In the case of non-rename changes,\n      // the filenames array only contains one file, so we can join all segments that were split on spaces.\n      // In the case of rename changes, the last item in the array is the path to the file in the working tree,\n      // which is the only one that we care about. It is also surrounded by double-quotes if spaces are\n      // included, so no need to worry about joining different segments\n      let lastFilename: string = changeType.startsWith('R')\n        ? filenameMatches[filenameMatches.length - 1]\n        : filenameMatches.join('');\n      lastFilename = parseGitFilename(lastFilename);\n\n      changes.set(lastFilename, changeType.trimRight());\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Takes a list of files and returns the current git hashes for them\n *\n * @public\n */\nexport function getGitHashForFiles(\n  filesToHash: string[],\n  packagePath: string,\n  gitPath?: string\n): Map<string, string> {\n  const changes: Map<string, string> = new Map<string, string>();\n\n  if (filesToHash.length) {\n    // Use --stdin-paths arg to pass the list of files to git in order to avoid issues with\n    // command length\n    const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(\n      gitPath || 'git',\n      ['hash-object', '--stdin-paths'],\n      { input: filesToHash.map((x) => path.resolve(packagePath, x)).join('\\n') }\n    );\n\n    if (result.status !== 0) {\n      ensureGitMinimumVersion(gitPath);\n\n      throw new Error(`git hash-object exited with status ${result.status}: ${result.stderr}`);\n    }\n\n    const hashStdout: string = result.stdout.trim();\n\n    // The result of \"git hash-object\" will be a list of file hashes delimited by newlines\n    const hashes: string[] = hashStdout.split('\\n');\n\n    if (hashes.length !== filesToHash.length) {\n      throw new Error(\n        `Passed ${filesToHash.length} file paths to Git to hash, but received ${hashes.length} hashes.`\n      );\n    }\n\n    for (let i: number = 0; i < hashes.length; i++) {\n      const hash: string = hashes[i];\n      const filePath: string = filesToHash[i];\n      changes.set(filePath, hash);\n    }\n  }\n\n  return changes;\n}\n\n/**\n * Executes \"git ls-tree\" in a folder\n */\nexport function gitLsTree(cwdPath: string, gitPath?: string): string {\n  const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(\n    gitPath || 'git',\n    ['ls-tree', 'HEAD', '-r'],\n    {\n      currentWorkingDirectory: cwdPath\n    }\n  );\n\n  if (result.status !== 0) {\n    ensureGitMinimumVersion(gitPath);\n\n    throw new Error(`git ls-tree exited with status ${result.status}: ${result.stderr}`);\n  }\n\n  return result.stdout;\n}\n\n/**\n * Executes \"git status\" in a folder\n */\nexport function gitStatus(cwdPath: string, gitPath?: string): string {\n  /**\n   * -s - Short format. Will be printed as 'XY PATH' or 'XY ORIG_PATH -> PATH'. Paths with non-standard\n   *      characters will be escaped using double-quotes, and non-standard characters will be backslash\n   *      escaped (ex. spaces, tabs, double-quotes)\n   * -u - Untracked files are included\n   *\n   * See documentation here: https://git-scm.com/docs/git-status\n   */\n  const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(\n    gitPath || 'git',\n    ['status', '-s', '-u', '.'],\n    {\n      currentWorkingDirectory: cwdPath\n    }\n  );\n\n  if (result.status !== 0) {\n    ensureGitMinimumVersion(gitPath);\n\n    throw new Error(`git status exited with status ${result.status}: ${result.stderr}`);\n  }\n\n  return result.stdout;\n}\n\n/**\n * Builds an object containing hashes for the files under the specified `packagePath` folder.\n * @param packagePath - The folder path to derive the package dependencies from. This is typically the folder\n *                      containing package.json.  If omitted, the default value is the current working directory.\n * @param excludedPaths - An optional array of file path exclusions. If a file should be omitted from the list\n *                         of dependencies, use this to exclude it.\n * @returns the package-deps.json file content\n *\n * @public\n */\nexport function getPackageDeps(\n  packagePath: string = process.cwd(),\n  excludedPaths?: string[],\n  gitPath?: string\n): Map<string, string> {\n  const gitLsOutput: string = gitLsTree(packagePath, gitPath);\n\n  // Add all the checked in hashes\n  const result: Map<string, string> = parseGitLsTree(gitLsOutput);\n\n  // Remove excluded paths\n  if (excludedPaths) {\n    for (const excludedPath of excludedPaths) {\n      result.delete(excludedPath);\n    }\n  }\n\n  // Update the checked in hashes with the current repo status\n  const gitStatusOutput: string = gitStatus(packagePath, gitPath);\n  const currentlyChangedFiles: Map<string, string> = parseGitStatus(gitStatusOutput, packagePath);\n  const filesToHash: string[] = [];\n  const excludedPathSet: Set<string> = new Set<string>(excludedPaths);\n  for (const [filename, changeType] of currentlyChangedFiles) {\n    // See comments inside parseGitStatus() for more information\n    if (changeType === 'D' || (changeType.length === 2 && changeType.charAt(1) === 'D')) {\n      result.delete(filename);\n    } else {\n      if (!excludedPathSet.has(filename)) {\n        filesToHash.push(filename);\n      }\n    }\n  }\n\n  const currentlyChangedFileHashes: Map<string, string> = getGitHashForFiles(\n    filesToHash,\n    packagePath,\n    gitPath\n  );\n  for (const [filename, hash] of currentlyChangedFileHashes) {\n    result.set(filename, hash);\n  }\n\n  return result;\n}\n"]}

package/lib-esm/getRepoState.js

@@ -0,0 +1,444 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { once } from 'node:events';
+import { Readable, pipeline } from 'node:stream';
+import { Executable } from '@rushstack/node-core-library/lib/Executable';
+import { FileSystem } from '@rushstack/node-core-library/lib/FileSystem';
+const MINIMUM_GIT_VERSION = {
+    major: 2,
+    minor: 35,
+    patch: 0
+};
+const STANDARD_GIT_OPTIONS = [
+    // Don't request any optional file locks
+    '--no-optional-locks',
+    // Ensure that commands don't run automatic maintenance, since performance of the command itself is paramount
+    '-c',
+    'maintenance.auto=false'
+];
+const OBJECTMODE_SUBMODULE = '160000';
+const OBJECTMODE_SYMLINK = '120000';
+const OBJECTMODE_FILE_NONEXECUTABLE = '100644';
+const OBJECTMODE_FILE_EXECUTABLE = '100755';
+// Note that `type` is a stub that is being ignored by the parser in favor of using `mode` to infer, since `%(objecttype)` requires git 2.51.0+
+// e.g. 10644 blob <hash>\t<path>
+const GIT_LSTREE_FORMAT = '%(objectmode) type %(objectname)%x09%(path)';
+/**
+ * Parses the output of the "git ls-tree -r -z" command or of other commands that have been coerced to match its format.
+ * @internal
+ */
+export function parseGitLsTree(output) {
+    const files = new Map();
+    const symlinks = new Map();
+    const submodules = new Map();
+    // Parse the output
+    // With the -z modifier, paths are delimited by nulls
+    // A line looks like:
+    // <mode> <type> <newhash>\t<path>\0
+    // 100644 blob a300ccb0b36bd2c85ef18e3c619a2c747f95959e\ttools/prettier-git/prettier-git.js\0
+    let last = 0;
+    let index = output.indexOf('\0', last);
+    while (index >= 0) {
+        const item = output.slice(last, index);
+        const tabIndex = item.indexOf('\t');
+        const filePath = item.slice(tabIndex + 1);
+        // The newHash will be all zeros if the file is deleted, or a hash if it exists
+        const hash = item.slice(tabIndex - 40, tabIndex);
+        const mode = item.slice(0, item.indexOf(' '));
+        switch (mode) {
+            case OBJECTMODE_SUBMODULE: {
+                // This is a submodule
+                submodules.set(filePath, hash);
+                break;
+            }
+            case OBJECTMODE_SYMLINK: {
+                // This is a symbolic link
+                symlinks.set(filePath, hash);
+                break;
+            }
+            case OBJECTMODE_FILE_NONEXECUTABLE:
+            case OBJECTMODE_FILE_EXECUTABLE:
+            default: {
+                files.set(filePath, hash);
+                break;
+            }
+        }
+        last = index + 1;
+        index = output.indexOf('\0', last);
+    }
+    return {
+        files,
+        symlinks,
+        submodules
+    };
+}
+/**
+ * Parses the output of `git hash-object`
+ * yields [filePath, hash] pairs.
+ * @internal
+ */
+export function* parseGitHashObject(output, filePaths) {
+    const expected = filePaths.length;
+    if (expected === 0) {
+        return;
+    }
+    output = output.trim();
+    let last = 0;
+    let i = 0;
+    let index = output.indexOf('\n', last);
+    for (; i < expected && index > 0; i++) {
+        const hash = output.slice(last, index);
+        yield [filePaths[i], hash];
+        last = index + 1;
+        index = output.indexOf('\n', last);
+    }
+    // Handle last line. Will be non-empty to due trim() call.
+    if (index < 0) {
+        const hash = output.slice(last);
+        yield [filePaths[i], hash];
+        i++;
+    }
+    if (i !== expected) {
+        throw new Error(`Expected ${expected} hashes from "git hash-object" but received ${i}`);
+    }
+}
+/**
+ * Parses the output of `git diff-index --color=never --no-renames --no-commit-id -z <REVISION> --
+ * Returns a map of file path to diff
+ * @internal
+ */
+export function parseGitDiffIndex(output) {
+    const result = new Map();
+    // Parse the output
+    // With the -z modifier, paths are delimited by nulls
+    // A line looks like:
+    // :<oldmode> <newmode> <oldhash> <newhash> <status>\0<path>\0
+    // :100644 100644 a300ccb0b36bd2c85ef18e3c619a2c747f95959e 0000000000000000000000000000000000000000 M\0tools/prettier-git/prettier-git.js\0
+    let last = 0;
+    let index = output.indexOf('\0', last);
+    while (index >= 0) {
+        const header = output.slice(last, index);
+        const status = header.slice(-1);
+        last = index + 1;
+        index = output.indexOf('\0', last);
+        const filePath = output.slice(last, index);
+        // We passed --no-renames above, so a rename will be a delete of the old location and an add at the new.
+        // The newHash will be all zeros if the file is deleted, or a hash if it exists
+        const mode = header.slice(8, 14);
+        const oldhash = header.slice(-83, -43);
+        const newhash = header.slice(-42, -2);
+        result.set(filePath, {
+            mode,
+            oldhash,
+            newhash,
+            status
+        });
+        last = index + 1;
+        index = output.indexOf('\0', last);
+    }
+    return result;
+}
+/**
+ * Parses the output of `git status -z -u` to extract the set of files that have changed since HEAD.
+ *
+ * @param output - The raw output from Git
+ * @returns a map of file path to if it exists
+ * @internal
+ */
+export function parseGitStatus(output) {
+    const result = new Map();
+    // Parse the output
+    // With the -z modifier, paths are delimited by nulls
+    // A line looks like:
+    // XY <path>\0
+    //  M tools/prettier-git/prettier-git.js\0
+    let startOfLine = 0;
+    let eolIndex = output.indexOf('\0', startOfLine);
+    while (eolIndex >= 0) {
+        // We passed --no-renames above, so a rename will be a delete of the old location and an add at the new.
+        // charAt(startOfLine) is the index status, charAt(startOfLine + 1) is the working tree status
+        const workingTreeStatus = output.charAt(startOfLine + 1);
+        // Deleted in working tree, or not modified in working tree and deleted in index
+        const deleted = workingTreeStatus === 'D' || (workingTreeStatus === ' ' && output.charAt(startOfLine) === 'D');
+        const filePath = output.slice(startOfLine + 3, eolIndex);
+        result.set(filePath, !deleted);
+        startOfLine = eolIndex + 1;
+        eolIndex = output.indexOf('\0', startOfLine);
+    }
+    return result;
+}
+const repoRootCache = new Map();
+/**
+ * Finds the root of the current Git repository
+ *
+ * @param currentWorkingDirectory - The working directory for which to locate the repository
+ * @param gitPath - The path to the Git executable
+ *
+ * @returns The full path to the root directory of the Git repository
+ * @beta
+ */
+export function getRepoRoot(currentWorkingDirectory, gitPath) {
+    let cachedResult = repoRootCache.get(currentWorkingDirectory);
+    if (!cachedResult) {
+        const result = Executable.spawnSync(gitPath || 'git', ['--no-optional-locks', 'rev-parse', '--show-toplevel'], {
+            currentWorkingDirectory
+        });
+        if (result.status !== 0) {
+            ensureGitMinimumVersion(gitPath);
+            throw new Error(`git rev-parse exited with status ${result.status}: ${result.stderr}`);
+        }
+        cachedResult = result.stdout.trim();
+        repoRootCache.set(currentWorkingDirectory, cachedResult);
+        // To ensure that calling getRepoRoot on the result is a no-op.
+        repoRootCache.set(cachedResult, cachedResult);
+    }
+    return cachedResult;
+}
+/**
+ * Helper function for async process invocation with optional stdin support.
+ * @param gitPath - Path to the Git executable
+ * @param args - The process arguments
+ * @param currentWorkingDirectory - The working directory. Should be the repository root.
+ * @param stdin - An optional Readable stream to use as stdin to the process.
+ */
+async function spawnGitAsync(gitPath, args, currentWorkingDirectory, stdin) {
+    const spawnOptions = {
+        currentWorkingDirectory,
+        stdio: ['pipe', 'pipe', 'pipe']
+    };
+    let stdout = '';
+    let stderr = '';
+    const proc = Executable.spawn(gitPath || 'git', args, spawnOptions);
+    proc.stdout.setEncoding('utf-8');
+    proc.stderr.setEncoding('utf-8');
+    proc.stdout.on('data', (chunk) => {
+        stdout += chunk.toString();
+    });
+    proc.stderr.on('data', (chunk) => {
+        stderr += chunk.toString();
+    });
+    if (stdin) {
+        /**
+         * For `git hash-object` data is piped in asynchronously. In the event that one of the
+         * passed filenames cannot be hashed, subsequent writes to `proc.stdin` will error.
+         * Silence this error since it will be handled by the non-zero exit code of the process.
+         */
+        pipeline(stdin, proc.stdin, (err) => { });
+    }
+    const [status] = await once(proc, 'close');
+    if (status !== 0) {
+        ensureGitMinimumVersion(gitPath);
+        throw new Error(`git ${args[0]} exited with code ${status}:\n${stderr}`);
+    }
+    return stdout;
+}
+function isIterable(value) {
+    return Symbol.iterator in value;
+}
+/**
+ * Uses `git hash-object` to hash the provided files. Unlike `getGitHashForFiles`, this API is asynchronous, and also allows for
+ * the input file paths to be specified as an async iterable.
+ *
+ * @param rootDirectory - The root directory to which paths are specified relative. Must be the root of the Git repository.
+ * @param filesToHash - The file paths to hash using `git hash-object`
+ * @param gitPath - The path to the Git executable
+ * @returns An iterable of [filePath, hash] pairs
+ *
+ * @remarks
+ * The input file paths must be specified relative to the Git repository root, or else be absolute paths.
+ * @beta
+ */
+export async function hashFilesAsync(rootDirectory, filesToHash, gitPath) {
+    const hashPaths = [];
+    const input = Readable.from(isIterable(filesToHash)
+        ? (function* () {
+            for (const file of filesToHash) {
+                hashPaths.push(file);
+                yield `${file}\n`;
+            }
+        })()
+        : (async function* () {
+            for await (const file of filesToHash) {
+                hashPaths.push(file);
+                yield `${file}\n`;
+            }
+        })(), {
+        encoding: 'utf-8',
+        objectMode: false,
+        autoDestroy: true
+    });
+    const hashObjectResult = await spawnGitAsync(gitPath, STANDARD_GIT_OPTIONS.concat(['hash-object', '--stdin-paths']), rootDirectory, input);
+    return parseGitHashObject(hashObjectResult, hashPaths);
+}
+/**
+ * Gets the object hashes for all files in the Git repo, combining the current commit with working tree state.
+ * Uses async operations and runs all primary Git calls in parallel.
+ * @param rootDirectory - The root directory of the Git repository
+ * @param additionalRelativePathsToHash - Root-relative file paths to have Git hash and include in the results
+ * @param gitPath - The path to the Git executable
+ * @beta
+ */
+export async function getRepoStateAsync(rootDirectory, additionalRelativePathsToHash, gitPath, filterPath) {
+    const { files } = await getDetailedRepoStateAsync(rootDirectory, additionalRelativePathsToHash, gitPath, filterPath);
+    return files;
+}
+/**
+ * Gets the object hashes for all files in the Git repo, combining the current commit with working tree state.
+ * Uses async operations and runs all primary Git calls in parallel.
+ * @param rootDirectory - The root directory of the Git repository
+ * @param additionalRelativePathsToHash - Root-relative file paths to have Git hash and include in the results
+ * @param gitPath - The path to the Git executable
+ * @beta
+ */
+export async function getDetailedRepoStateAsync(rootDirectory, additionalRelativePathsToHash, gitPath, filterPath) {
+    const statePromise = spawnGitAsync(gitPath, STANDARD_GIT_OPTIONS.concat([
+        'ls-files',
+        // Read from the index only
+        '--cached',
+        // Use NUL as the separator
+        '-z',
+        // Specify the full path to files relative to the root
+        '--full-name',
+        // Match the format of "git ls-tree". The %(objecttype) placeholder requires git 2.51.0+, so not using yet.
+        `--format=${GIT_LSTREE_FORMAT}`,
+        '--',
+        ...(filterPath !== null && filterPath !== void 0 ? filterPath : [])
+    ]), rootDirectory).then(parseGitLsTree);
+    const locallyModifiedPromise = spawnGitAsync(gitPath, STANDARD_GIT_OPTIONS.concat([
+        'status',
+        // Use NUL as the separator
+        '-z',
+        // Include untracked files
+        '-u',
+        // Disable rename detection so that renames show up as add + delete
+        '--no-renames',
+        // Don't process submodules with this command; they'll be handled individually
+        '--ignore-submodules',
+        // Don't compare against the remote
+        '--no-ahead-behind',
+        '--',
+        ...(filterPath !== null && filterPath !== void 0 ? filterPath : [])
+    ]), rootDirectory).then(parseGitStatus);
+    async function* getFilesToHash() {
+        if (additionalRelativePathsToHash) {
+            for (const file of additionalRelativePathsToHash) {
+                yield file;
+            }
+        }
+        const [{ files, symlinks }, locallyModified] = await Promise.all([statePromise, locallyModifiedPromise]);
+        for (const [filePath, exists] of locallyModified) {
+            if (exists && !symlinks.has(filePath)) {
+                yield filePath;
+            }
+            else {
+                files.delete(filePath);
+                symlinks.delete(filePath);
+            }
+        }
+    }
+    const hashObjectPromise = hashFilesAsync(rootDirectory, getFilesToHash(), gitPath);
+    const [{ files, symlinks, submodules }, locallyModifiedFiles] = await Promise.all([
+        statePromise,
+        locallyModifiedPromise
+    ]);
+    // The result of "git hash-object" will be a list of file hashes delimited by newlines
+    for (const [filePath, hash] of await hashObjectPromise) {
+        files.set(filePath, hash);
+    }
+    // Existence check for the .gitmodules file
+    const hasSubmodules = submodules.size > 0 && FileSystem.exists(`${rootDirectory}/.gitmodules`);
+    if (hasSubmodules) {
+        // Submodules are not the normal critical path. Accept serial performance rather than investing in complexity.
+        // Can revisit if submodules become more commonly used.
+        for (const submodulePath of submodules.keys()) {
+            const submoduleState = await getRepoStateAsync(`${rootDirectory}/${submodulePath}`, [], gitPath);
+            for (const [filePath, hash] of submoduleState) {
+                files.set(`${submodulePath}/${filePath}`, hash);
+            }
+        }
+    }
+    return {
+        hasSubmodules,
+        hasUncommittedChanges: locallyModifiedFiles.size > 0,
+        files,
+        symlinks
+    };
+}
+/**
+ * Find all changed files tracked by Git, their current hashes, and the nature of the change. Only useful if all changes are staged or committed.
+ * @param currentWorkingDirectory - The working directory. Only used to find the repository root.
+ * @param revision - The Git revision specifier to detect changes relative to. Defaults to HEAD (i.e. will compare staged vs. committed)
+ *   If comparing against a different branch, call `git merge-base` first to find the target commit.
+ * @param gitPath - The path to the Git executable
+ * @returns A map from the Git file path to the corresponding file change metadata
+ * @beta
+ */
+export function getRepoChanges(currentWorkingDirectory, revision = 'HEAD', gitPath) {
+    const rootDirectory = getRepoRoot(currentWorkingDirectory, gitPath);
+    const result = Executable.spawnSync(gitPath || 'git', STANDARD_GIT_OPTIONS.concat([
+        'diff-index',
+        '--color=never',
+        '--no-renames',
+        '--no-commit-id',
+        '--cached',
+        '-z',
+        revision,
+        '--'
+    ]), {
+        currentWorkingDirectory: rootDirectory
+    });
+    if (result.status !== 0) {
+        ensureGitMinimumVersion(gitPath);
+        throw new Error(`git diff-index exited with status ${result.status}: ${result.stderr}`);
+    }
+    const changes = parseGitDiffIndex(result.stdout);
+    return changes;
+}
+/**
+ * Checks the git version and throws an error if it is less than the minimum required version.
+ *
+ * @public
+ */
+export function ensureGitMinimumVersion(gitPath) {
+    const gitVersion = getGitVersion(gitPath);
+    if (gitVersion.major < MINIMUM_GIT_VERSION.major ||
+        (gitVersion.major === MINIMUM_GIT_VERSION.major && gitVersion.minor < MINIMUM_GIT_VERSION.minor) ||
+        (gitVersion.major === MINIMUM_GIT_VERSION.major &&
+            gitVersion.minor === MINIMUM_GIT_VERSION.minor &&
+            gitVersion.patch < MINIMUM_GIT_VERSION.patch)) {
+        throw new Error(`The minimum Git version required is ` +
+            `${MINIMUM_GIT_VERSION.major}.${MINIMUM_GIT_VERSION.minor}.${MINIMUM_GIT_VERSION.patch}. ` +
+            `Your version is ${gitVersion.major}.${gitVersion.minor}.${gitVersion.patch}.`);
+    }
+}
+function getGitVersion(gitPath) {
+    const result = Executable.spawnSync(gitPath || 'git', STANDARD_GIT_OPTIONS.concat(['version']));
+    if (result.status !== 0) {
+        throw new Error(`While validating the Git installation, the "git version" command failed with ` +
+            `status ${result.status}: ${result.stderr}`);
+    }
+    return parseGitVersion(result.stdout);
+}
+export function parseGitVersion(gitVersionOutput) {
+    // This regexp matches output of "git version" that looks like `git version <number>.<number>.<number>(+whatever)`
+    // Examples:
+    // - git version 1.2.3
+    // - git version 1.2.3.4.5
+    // - git version 1.2.3windows.1
+    // - git version 1.2.3.windows.1
+    const versionRegex = /^git version (\d+)\.(\d+)\.(\d+)/;
+    const match = versionRegex.exec(gitVersionOutput);
+    if (!match) {
+        throw new Error(`While validating the Git installation, the "git version" command produced ` +
+            `unexpected output: "${gitVersionOutput}"`);
+    }
+    const major = parseInt(match[1], 10);
+    const minor = parseInt(match[2], 10);
+    const patch = parseInt(match[3], 10);
+    return {
+        major,
+        minor,
+        patch
+    };
+}
+//# sourceMappingURL=getRepoState.js.map

package/lib-esm/getRepoState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRepoState.js","sourceRoot":"","sources":["../src/getRepoState.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type * as child_process from 'node:child_process';\nimport { once } from 'node:events';\nimport { Readable, pipeline } from 'node:stream';\n\nimport { Executable, type IExecutableSpawnOptions } from '@rushstack/node-core-library/lib/Executable';\nimport { FileSystem } from '@rushstack/node-core-library/lib/FileSystem';\n\nexport interface IGitVersion {\n  major: number;\n  minor: number;\n  patch: number;\n}\n\nconst MINIMUM_GIT_VERSION: IGitVersion = {\n  major: 2,\n  minor: 35,\n  patch: 0\n};\n\nconst STANDARD_GIT_OPTIONS: readonly string[] = [\n  // Don't request any optional file locks\n  '--no-optional-locks',\n  // Ensure that commands don't run automatic maintenance, since performance of the command itself is paramount\n  '-c',\n  'maintenance.auto=false'\n];\n\nconst OBJECTMODE_SUBMODULE: '160000' = '160000';\nconst OBJECTMODE_SYMLINK: '120000' = '120000';\nconst OBJECTMODE_FILE_NONEXECUTABLE: '100644' = '100644';\nconst OBJECTMODE_FILE_EXECUTABLE: '100755' = '100755';\n\n// Note that `type` is a stub that is being ignored by the parser in favor of using `mode` to infer, since `%(objecttype)` requires git 2.51.0+\n// e.g. 10644 blob <hash>\\t<path>\nconst GIT_LSTREE_FORMAT: string = '%(objectmode) type %(objectname)%x09%(path)';\n\ninterface IGitTreeState {\n  files: Map<string, string>; // type \"blob\"\n  symlinks: Map<string, string>; // type \"link\"\n  submodules: Map<string, string>; // type \"commit\"\n}\n\n/**\n * Parses the output of the \"git ls-tree -r -z\" command or of other commands that have been coerced to match its format.\n * @internal\n */\nexport function parseGitLsTree(output: string): IGitTreeState {\n  const files: Map<string, string> = new Map();\n  const symlinks: Map<string, string> = new Map();\n  const submodules: Map<string, string> = new Map();\n\n  // Parse the output\n  // With the -z modifier, paths are delimited by nulls\n  // A line looks like:\n  // <mode> <type> <newhash>\\t<path>\\0\n  // 100644 blob a300ccb0b36bd2c85ef18e3c619a2c747f95959e\\ttools/prettier-git/prettier-git.js\\0\n\n  let last: number = 0;\n  let index: number = output.indexOf('\\0', last);\n  while (index >= 0) {\n    const item: string = output.slice(last, index);\n\n    const tabIndex: number = item.indexOf('\\t');\n    const filePath: string = item.slice(tabIndex + 1);\n\n    // The newHash will be all zeros if the file is deleted, or a hash if it exists\n    const hash: string = item.slice(tabIndex - 40, tabIndex);\n\n    const mode: string = item.slice(0, item.indexOf(' '));\n\n    switch (mode) {\n      case OBJECTMODE_SUBMODULE: {\n        // This is a submodule\n        submodules.set(filePath, hash);\n        break;\n      }\n      case OBJECTMODE_SYMLINK: {\n        // This is a symbolic link\n        symlinks.set(filePath, hash);\n        break;\n      }\n      case OBJECTMODE_FILE_NONEXECUTABLE:\n      case OBJECTMODE_FILE_EXECUTABLE:\n      default: {\n        files.set(filePath, hash);\n        break;\n      }\n    }\n\n    last = index + 1;\n    index = output.indexOf('\\0', last);\n  }\n\n  return {\n    files,\n    symlinks,\n    submodules\n  };\n}\n\n/**\n * Parses the output of `git hash-object`\n * yields [filePath, hash] pairs.\n * @internal\n */\nexport function* parseGitHashObject(\n  output: string,\n  filePaths: ReadonlyArray<string>\n): IterableIterator<[string, string]> {\n  const expected: number = filePaths.length;\n  if (expected === 0) {\n    return;\n  }\n\n  output = output.trim();\n\n  let last: number = 0;\n  let i: number = 0;\n  let index: number = output.indexOf('\\n', last);\n  for (; i < expected && index > 0; i++) {\n    const hash: string = output.slice(last, index);\n    yield [filePaths[i], hash];\n    last = index + 1;\n    index = output.indexOf('\\n', last);\n  }\n\n  // Handle last line. Will be non-empty to due trim() call.\n  if (index < 0) {\n    const hash: string = output.slice(last);\n    yield [filePaths[i], hash];\n    i++;\n  }\n\n  if (i !== expected) {\n    throw new Error(`Expected ${expected} hashes from \"git hash-object\" but received ${i}`);\n  }\n}\n\n/**\n * Information about the changes to a file.\n * @beta\n */\nexport interface IFileDiffStatus {\n  mode: string;\n  oldhash: string;\n  newhash: string;\n  status: 'A' | 'D' | 'M';\n}\n\n/**\n * Parses the output of `git diff-index --color=never --no-renames --no-commit-id -z <REVISION> --\n * Returns a map of file path to diff\n * @internal\n */\nexport function parseGitDiffIndex(output: string): Map<string, IFileDiffStatus> {\n  const result: Map<string, IFileDiffStatus> = new Map();\n\n  // Parse the output\n  // With the -z modifier, paths are delimited by nulls\n  // A line looks like:\n  // :<oldmode> <newmode> <oldhash> <newhash> <status>\\0<path>\\0\n  // :100644 100644 a300ccb0b36bd2c85ef18e3c619a2c747f95959e 0000000000000000000000000000000000000000 M\\0tools/prettier-git/prettier-git.js\\0\n\n  let last: number = 0;\n  let index: number = output.indexOf('\\0', last);\n  while (index >= 0) {\n    const header: string = output.slice(last, index);\n    const status: IFileDiffStatus['status'] = header.slice(-1) as IFileDiffStatus['status'];\n\n    last = index + 1;\n    index = output.indexOf('\\0', last);\n    const filePath: string = output.slice(last, index);\n\n    // We passed --no-renames above, so a rename will be a delete of the old location and an add at the new.\n    // The newHash will be all zeros if the file is deleted, or a hash if it exists\n    const mode: string = header.slice(8, 14);\n    const oldhash: string = header.slice(-83, -43);\n    const newhash: string = header.slice(-42, -2);\n    result.set(filePath, {\n      mode,\n      oldhash,\n      newhash,\n      status\n    });\n\n    last = index + 1;\n    index = output.indexOf('\\0', last);\n  }\n\n  return result;\n}\n\n/**\n * Parses the output of `git status -z -u` to extract the set of files that have changed since HEAD.\n *\n * @param output - The raw output from Git\n * @returns a map of file path to if it exists\n * @internal\n */\nexport function parseGitStatus(output: string): Map<string, boolean> {\n  const result: Map<string, boolean> = new Map();\n\n  // Parse the output\n  // With the -z modifier, paths are delimited by nulls\n  // A line looks like:\n  // XY <path>\\0\n  //  M tools/prettier-git/prettier-git.js\\0\n\n  let startOfLine: number = 0;\n  let eolIndex: number = output.indexOf('\\0', startOfLine);\n  while (eolIndex >= 0) {\n    // We passed --no-renames above, so a rename will be a delete of the old location and an add at the new.\n    // charAt(startOfLine) is the index status, charAt(startOfLine + 1) is the working tree status\n    const workingTreeStatus: string = output.charAt(startOfLine + 1);\n    // Deleted in working tree, or not modified in working tree and deleted in index\n    const deleted: boolean =\n      workingTreeStatus === 'D' || (workingTreeStatus === ' ' && output.charAt(startOfLine) === 'D');\n\n    const filePath: string = output.slice(startOfLine + 3, eolIndex);\n    result.set(filePath, !deleted);\n\n    startOfLine = eolIndex + 1;\n    eolIndex = output.indexOf('\\0', startOfLine);\n  }\n\n  return result;\n}\n\nconst repoRootCache: Map<string, string> = new Map();\n\n/**\n * Finds the root of the current Git repository\n *\n * @param currentWorkingDirectory - The working directory for which to locate the repository\n * @param gitPath - The path to the Git executable\n *\n * @returns The full path to the root directory of the Git repository\n * @beta\n */\nexport function getRepoRoot(currentWorkingDirectory: string, gitPath?: string): string {\n  let cachedResult: string | undefined = repoRootCache.get(currentWorkingDirectory);\n  if (!cachedResult) {\n    const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(\n      gitPath || 'git',\n      ['--no-optional-locks', 'rev-parse', '--show-toplevel'],\n      {\n        currentWorkingDirectory\n      }\n    );\n\n    if (result.status !== 0) {\n      ensureGitMinimumVersion(gitPath);\n\n      throw new Error(`git rev-parse exited with status ${result.status}: ${result.stderr}`);\n    }\n\n    cachedResult = result.stdout.trim();\n\n    repoRootCache.set(currentWorkingDirectory, cachedResult);\n    // To ensure that calling getRepoRoot on the result is a no-op.\n    repoRootCache.set(cachedResult, cachedResult);\n  }\n\n  return cachedResult;\n}\n\n/**\n * Helper function for async process invocation with optional stdin support.\n * @param gitPath - Path to the Git executable\n * @param args - The process arguments\n * @param currentWorkingDirectory - The working directory. Should be the repository root.\n * @param stdin - An optional Readable stream to use as stdin to the process.\n */\nasync function spawnGitAsync(\n  gitPath: string | undefined,\n  args: string[],\n  currentWorkingDirectory: string,\n  stdin?: Readable\n): Promise<string> {\n  const spawnOptions: IExecutableSpawnOptions = {\n    currentWorkingDirectory,\n    stdio: ['pipe', 'pipe', 'pipe']\n  };\n\n  let stdout: string = '';\n  let stderr: string = '';\n\n  const proc: child_process.ChildProcess = Executable.spawn(gitPath || 'git', args, spawnOptions);\n  proc.stdout!.setEncoding('utf-8');\n  proc.stderr!.setEncoding('utf-8');\n\n  proc.stdout!.on('data', (chunk: string) => {\n    stdout += chunk.toString();\n  });\n  proc.stderr!.on('data', (chunk: string) => {\n    stderr += chunk.toString();\n  });\n\n  if (stdin) {\n    /**\n     * For `git hash-object` data is piped in asynchronously. In the event that one of the\n     * passed filenames cannot be hashed, subsequent writes to `proc.stdin` will error.\n     * Silence this error since it will be handled by the non-zero exit code of the process.\n     */\n    pipeline(stdin, proc.stdin!, (err) => {});\n  }\n\n  const [status] = await once(proc, 'close');\n  if (status !== 0) {\n    ensureGitMinimumVersion(gitPath);\n\n    throw new Error(`git ${args[0]} exited with code ${status}:\\n${stderr}`);\n  }\n\n  return stdout;\n}\n\nfunction isIterable<T>(value: Iterable<T> | AsyncIterable<T>): value is Iterable<T> {\n  return Symbol.iterator in value;\n}\n\n/**\n * Uses `git hash-object` to hash the provided files. Unlike `getGitHashForFiles`, this API is asynchronous, and also allows for\n * the input file paths to be specified as an async iterable.\n *\n * @param rootDirectory - The root directory to which paths are specified relative. Must be the root of the Git repository.\n * @param filesToHash - The file paths to hash using `git hash-object`\n * @param gitPath - The path to the Git executable\n * @returns An iterable of [filePath, hash] pairs\n *\n * @remarks\n * The input file paths must be specified relative to the Git repository root, or else be absolute paths.\n * @beta\n */\nexport async function hashFilesAsync(\n  rootDirectory: string,\n  filesToHash: Iterable<string> | AsyncIterable<string>,\n  gitPath?: string\n): Promise<Iterable<[string, string]>> {\n  const hashPaths: string[] = [];\n\n  const input: Readable = Readable.from(\n    isIterable(filesToHash)\n      ? (function* (): IterableIterator<string> {\n          for (const file of filesToHash) {\n            hashPaths.push(file);\n            yield `${file}\\n`;\n          }\n        })()\n      : (async function* (): AsyncIterableIterator<string> {\n          for await (const file of filesToHash) {\n            hashPaths.push(file);\n            yield `${file}\\n`;\n          }\n        })(),\n    {\n      encoding: 'utf-8',\n      objectMode: false,\n      autoDestroy: true\n    }\n  );\n\n  const hashObjectResult: string = await spawnGitAsync(\n    gitPath,\n    STANDARD_GIT_OPTIONS.concat(['hash-object', '--stdin-paths']),\n    rootDirectory,\n    input\n  );\n\n  return parseGitHashObject(hashObjectResult, hashPaths);\n}\n\n/**\n * Gets the object hashes for all files in the Git repo, combining the current commit with working tree state.\n * Uses async operations and runs all primary Git calls in parallel.\n * @param rootDirectory - The root directory of the Git repository\n * @param additionalRelativePathsToHash - Root-relative file paths to have Git hash and include in the results\n * @param gitPath - The path to the Git executable\n * @beta\n */\nexport async function getRepoStateAsync(\n  rootDirectory: string,\n  additionalRelativePathsToHash?: string[],\n  gitPath?: string,\n  filterPath?: string[]\n): Promise<Map<string, string>> {\n  const { files } = await getDetailedRepoStateAsync(\n    rootDirectory,\n    additionalRelativePathsToHash,\n    gitPath,\n    filterPath\n  );\n\n  return files;\n}\n\n/**\n * Information about the detailed state of the Git repository.\n * @beta\n */\nexport interface IDetailedRepoState {\n  /**\n   * The Git file hashes for all files in the repository, including uncommitted changes.\n   */\n  files: Map<string, string>;\n  /**\n   * The Git file hashes for all symbolic links in the repository, including uncommitted changes.\n   */\n  symlinks: Map<string, string>;\n  /**\n   * A boolean indicating whether the repository has submodules.\n   */\n  hasSubmodules: boolean;\n  /**\n   * A boolean indicating whether the repository has uncommitted changes.\n   */\n  hasUncommittedChanges: boolean;\n}\n\n/**\n * Gets the object hashes for all files in the Git repo, combining the current commit with working tree state.\n * Uses async operations and runs all primary Git calls in parallel.\n * @param rootDirectory - The root directory of the Git repository\n * @param additionalRelativePathsToHash - Root-relative file paths to have Git hash and include in the results\n * @param gitPath - The path to the Git executable\n * @beta\n */\nexport async function getDetailedRepoStateAsync(\n  rootDirectory: string,\n  additionalRelativePathsToHash?: string[],\n  gitPath?: string,\n  filterPath?: string[]\n): Promise<IDetailedRepoState> {\n  const statePromise: Promise<IGitTreeState> = spawnGitAsync(\n    gitPath,\n    STANDARD_GIT_OPTIONS.concat([\n      'ls-files',\n      // Read from the index only\n      '--cached',\n      // Use NUL as the separator\n      '-z',\n      // Specify the full path to files relative to the root\n      '--full-name',\n      // Match the format of \"git ls-tree\". The %(objecttype) placeholder requires git 2.51.0+, so not using yet.\n      `--format=${GIT_LSTREE_FORMAT}`,\n      '--',\n      ...(filterPath ?? [])\n    ]),\n    rootDirectory\n  ).then(parseGitLsTree);\n  const locallyModifiedPromise: Promise<Map<string, boolean>> = spawnGitAsync(\n    gitPath,\n    STANDARD_GIT_OPTIONS.concat([\n      'status',\n      // Use NUL as the separator\n      '-z',\n      // Include untracked files\n      '-u',\n      // Disable rename detection so that renames show up as add + delete\n      '--no-renames',\n      // Don't process submodules with this command; they'll be handled individually\n      '--ignore-submodules',\n      // Don't compare against the remote\n      '--no-ahead-behind',\n      '--',\n      ...(filterPath ?? [])\n    ]),\n    rootDirectory\n  ).then(parseGitStatus);\n\n  async function* getFilesToHash(): AsyncIterableIterator<string> {\n    if (additionalRelativePathsToHash) {\n      for (const file of additionalRelativePathsToHash) {\n        yield file;\n      }\n    }\n\n    const [{ files, symlinks }, locallyModified] = await Promise.all([statePromise, locallyModifiedPromise]);\n\n    for (const [filePath, exists] of locallyModified) {\n      if (exists && !symlinks.has(filePath)) {\n        yield filePath;\n      } else {\n        files.delete(filePath);\n        symlinks.delete(filePath);\n      }\n    }\n  }\n\n  const hashObjectPromise: Promise<Iterable<[string, string]>> = hashFilesAsync(\n    rootDirectory,\n    getFilesToHash(),\n    gitPath\n  );\n\n  const [{ files, symlinks, submodules }, locallyModifiedFiles] = await Promise.all([\n    statePromise,\n    locallyModifiedPromise\n  ]);\n\n  // The result of \"git hash-object\" will be a list of file hashes delimited by newlines\n  for (const [filePath, hash] of await hashObjectPromise) {\n    files.set(filePath, hash);\n  }\n\n  // Existence check for the .gitmodules file\n  const hasSubmodules: boolean = submodules.size > 0 && FileSystem.exists(`${rootDirectory}/.gitmodules`);\n\n  if (hasSubmodules) {\n    // Submodules are not the normal critical path. Accept serial performance rather than investing in complexity.\n    // Can revisit if submodules become more commonly used.\n    for (const submodulePath of submodules.keys()) {\n      const submoduleState: Map<string, string> = await getRepoStateAsync(\n        `${rootDirectory}/${submodulePath}`,\n        [],\n        gitPath\n      );\n      for (const [filePath, hash] of submoduleState) {\n        files.set(`${submodulePath}/${filePath}`, hash);\n      }\n    }\n  }\n\n  return {\n    hasSubmodules,\n    hasUncommittedChanges: locallyModifiedFiles.size > 0,\n    files,\n    symlinks\n  };\n}\n\n/**\n * Find all changed files tracked by Git, their current hashes, and the nature of the change. Only useful if all changes are staged or committed.\n * @param currentWorkingDirectory - The working directory. Only used to find the repository root.\n * @param revision - The Git revision specifier to detect changes relative to. Defaults to HEAD (i.e. will compare staged vs. committed)\n *   If comparing against a different branch, call `git merge-base` first to find the target commit.\n * @param gitPath - The path to the Git executable\n * @returns A map from the Git file path to the corresponding file change metadata\n * @beta\n */\nexport function getRepoChanges(\n  currentWorkingDirectory: string,\n  revision: string = 'HEAD',\n  gitPath?: string\n): Map<string, IFileDiffStatus> {\n  const rootDirectory: string = getRepoRoot(currentWorkingDirectory, gitPath);\n\n  const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(\n    gitPath || 'git',\n    STANDARD_GIT_OPTIONS.concat([\n      'diff-index',\n      '--color=never',\n      '--no-renames',\n      '--no-commit-id',\n      '--cached',\n      '-z',\n      revision,\n      '--'\n    ]),\n    {\n      currentWorkingDirectory: rootDirectory\n    }\n  );\n\n  if (result.status !== 0) {\n    ensureGitMinimumVersion(gitPath);\n\n    throw new Error(`git diff-index exited with status ${result.status}: ${result.stderr}`);\n  }\n\n  const changes: Map<string, IFileDiffStatus> = parseGitDiffIndex(result.stdout);\n\n  return changes;\n}\n\n/**\n * Checks the git version and throws an error if it is less than the minimum required version.\n *\n * @public\n */\nexport function ensureGitMinimumVersion(gitPath?: string): void {\n  const gitVersion: IGitVersion = getGitVersion(gitPath);\n  if (\n    gitVersion.major < MINIMUM_GIT_VERSION.major ||\n    (gitVersion.major === MINIMUM_GIT_VERSION.major && gitVersion.minor < MINIMUM_GIT_VERSION.minor) ||\n    (gitVersion.major === MINIMUM_GIT_VERSION.major &&\n      gitVersion.minor === MINIMUM_GIT_VERSION.minor &&\n      gitVersion.patch < MINIMUM_GIT_VERSION.patch)\n  ) {\n    throw new Error(\n      `The minimum Git version required is ` +\n        `${MINIMUM_GIT_VERSION.major}.${MINIMUM_GIT_VERSION.minor}.${MINIMUM_GIT_VERSION.patch}. ` +\n        `Your version is ${gitVersion.major}.${gitVersion.minor}.${gitVersion.patch}.`\n    );\n  }\n}\n\nfunction getGitVersion(gitPath?: string): IGitVersion {\n  const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(\n    gitPath || 'git',\n    STANDARD_GIT_OPTIONS.concat(['version'])\n  );\n\n  if (result.status !== 0) {\n    throw new Error(\n      `While validating the Git installation, the \"git version\" command failed with ` +\n        `status ${result.status}: ${result.stderr}`\n    );\n  }\n\n  return parseGitVersion(result.stdout);\n}\n\nexport function parseGitVersion(gitVersionOutput: string): IGitVersion {\n  // This regexp matches output of \"git version\" that looks like `git version <number>.<number>.<number>(+whatever)`\n  // Examples:\n  // - git version 1.2.3\n  // - git version 1.2.3.4.5\n  // - git version 1.2.3windows.1\n  // - git version 1.2.3.windows.1\n  const versionRegex: RegExp = /^git version (\\d+)\\.(\\d+)\\.(\\d+)/;\n  const match: RegExpMatchArray | null = versionRegex.exec(gitVersionOutput);\n  if (!match) {\n    throw new Error(\n      `While validating the Git installation, the \"git version\" command produced ` +\n        `unexpected output: \"${gitVersionOutput}\"`\n    );\n  }\n\n  const major: number = parseInt(match[1], 10);\n  const minor: number = parseInt(match[2], 10);\n  const patch: number = parseInt(match[3], 10);\n\n  return {\n    major,\n    minor,\n    patch\n  };\n}\n"]}

package/lib-esm/index.js

@@ -0,0 +1,16 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * This package builds a JSON object containing the git hashes of all files used to produce a given NPM package.
+ * The {@link https://rushjs.io/ | Rush} tool uses this library to implement incremental build detection.
+ *
+ * @remarks
+ *
+ * For more info, please see the package {@link https://www.npmjs.com/package/@rushstack/package-deps-hash
+ * | README}.
+ *
+ * @packageDocumentation
+ */
+export { getPackageDeps, getGitHashForFiles } from './getPackageDeps';
+export { getDetailedRepoStateAsync, getRepoChanges, getRepoRoot, getRepoStateAsync, ensureGitMinimumVersion, hashFilesAsync } from './getRepoState';
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAGL,yBAAyB,EACzB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACf,MAAM,gBAAgB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * This package builds a JSON object containing the git hashes of all files used to produce a given NPM package.\n * The {@link https://rushjs.io/ | Rush} tool uses this library to implement incremental build detection.\n *\n * @remarks\n *\n * For more info, please see the package {@link https://www.npmjs.com/package/@rushstack/package-deps-hash\n * | README}.\n *\n * @packageDocumentation\n */\n\nexport { getPackageDeps, getGitHashForFiles } from './getPackageDeps';\nexport {\n  type IFileDiffStatus,\n  type IDetailedRepoState,\n  getDetailedRepoStateAsync,\n  getRepoChanges,\n  getRepoRoot,\n  getRepoStateAsync,\n  ensureGitMinimumVersion,\n  hashFilesAsync\n} from './getRepoState';\n"]}

package/package.json

@@ -1,9 +1,30 @@
 {
   "name": "@rushstack/package-deps-hash",
-  "version": "4.6.7",
+  "version": "4.7.0",
   "description": "",
-  "main": "lib/index.js",
-  "typings": "dist/package-deps-hash.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/package-deps-hash.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/package-deps-hash.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,12 +33,13 @@
   },
   "devDependencies": {
     "eslint": "~9.37.0",
-    "@rushstack/heft": "1.1.13",
+    "@rushstack/heft": "1.2.0",
     "local-node-rig": "1.0.0"
   },
   "dependencies": {
-    "@rushstack/node-core-library": "5.19.1"
+    "@rushstack/node-core-library": "5.20.0"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "heft build --clean",
     "_phase:build": "heft run --only build -- --clean",