isomorphic-git 1.37.8 → 1.38.0

package/README.md

@@ -1,5 +1,11 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/isomorphic-git/isomorphic-git/main/website/static/img/isomorphic-git-logo.svg?sanitize=true" alt="" height="150"/>
+  <a href="https://isomorphic-git.org/" target="_blank" rel="noopener">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/isomorphic-git/isomorphic-git/blob/main/.github/images/isomorphic-git-dark.svg?raw=true" />
+      <source media="(prefers-color-scheme: light)" srcset="https://github.com/isomorphic-git/isomorphic-git/blob/main/.github/images/isomorphic-git-light.svg?raw=true" />
+      <img alt="Isomorphic Git logo" src="https://github.com/isomorphic-git/isomorphic-git/blob/main/.github/images/isomorphic-git-light.svg?raw=true" height="150" />
+    </picture>
+  </a>
 </p>
 
 # isomorphic-git
@@ -281,7 +287,23 @@ Cross-browser device testing is provided by:
 
 [![BrowserStack](https://user-images.githubusercontent.com/587740/39730261-9c65c4d8-522e-11e8-9f12-16b349377a35.png)](http://browserstack.com/)
 
-[![SauceLabs](https://saucelabs.com/content/images/logo.png)](https://saucelabs.com)
+<a href="https://saucelabs.com" target="_blank" rel="noopener">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://saucelabs.com/images/logo-white.svg" />
+    <source media="(prefers-color-scheme: light)" srcset="https://saucelabs.com/images/logo.svg" />
+    <img alt="Sauce Labs logo" src="https://saucelabs.com/images/logo.svg" height="40" />
+  </picture>
+</a>
+
+Code Review AI provided by:
+
+<a href="https://coderabbit.ai" target="_blank" rel="noopener">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/isomorphic-git/isomorphic-git/blob/main/.github/images/coderabbit-dark.svg?raw=true" />
+    <source media="(prefers-color-scheme: light)" srcset="https://github.com/isomorphic-git/isomorphic-git/blob/main/.github/images/coderabbit-light.svg?raw=true" />
+    <img alt="CodeRabbit logo" src="https://github.com/isomorphic-git/isomorphic-git/blob/main/.github/images/coderabbit-light.svg?raw=true" height="40" />
+  </picture>
+</a>
 
 ## Contributors
 
@@ -411,6 +433,7 @@ Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds
   <tr>
     <td align="center"><a href="https://github.com/N0zoM1z0"><img src="https://avatars.githubusercontent.com/u/161784452?v=4?s=60" width="60px;" alt=""/><br /><sub><b>N0zoM1z0</b></sub></a><br /><a href="#security-N0zoM1z0" title="Security">🛡️</a></td>
     <td align="center"><a href="https://github.com/amxmln"><img src="https://avatars.githubusercontent.com/u/15271679?v=4?s=60" width="60px;" alt=""/><br /><sub><b>Amadeus Maximilian</b></sub></a><br /><a href="https://github.com/isomorphic-git/isomorphic-git/commits?author=amxmln" title="Code">💻</a> <a href="https://github.com/isomorphic-git/isomorphic-git/issues?q=author%3Aamxmln" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="http://toxik.us/"><img src="https://avatars.githubusercontent.com/u/235319?v=4?s=60" width="60px;" alt=""/><br /><sub><b>Alexandru Georoceanu</b></sub></a><br /><a href="https://github.com/isomorphic-git/isomorphic-git/commits?author=toxik" title="Code">💻</a></td>
   </tr>
 </table>
 

package/index.cjs

@@ -4510,11 +4510,12 @@ function TREE({ ref = 'HEAD' } = {}) {
 // @ts-check
 
 class GitWalkerFs {
-  constructor({ fs, dir, gitdir, cache }) {
+  constructor({ fs, dir, gitdir, cache, refresh = true }) {
     this.fs = fs;
     this.cache = cache;
     this.dir = dir;
     this.gitdir = gitdir;
+    this.refresh = refresh;
 
     this.config = null;
     const walker = this;
@@ -4650,7 +4651,9 @@ class GitWalkerFs {
               // Update the stats in the index so we will get a "cache hit" next time
               // 1) if we can (because the oid and mode are the same)
               // 2) and only if we need to (because other stats differ)
+              // 3) and only if the caller opted in to refreshing the index
               if (
+                self.refresh &&
                 stage &&
                 oid === stage.oid &&
                 (!filemode || stats.mode === stage.mode) &&
@@ -4686,13 +4689,17 @@ class GitWalkerFs {
 // @ts-check
 
 /**
+ * @param {object} [opts]
+ * @param {boolean} [opts.refresh=true] - When false, suppress the stat-cache
+ *   refresh that would rewrite `.git/index` when a working-tree file's stat
+ *   info has drifted but its content still matches the staged blob.
  * @returns {Walker}
  */
-function WORKDIR() {
+function WORKDIR({ refresh = true } = {}) {
   const o = Object.create(null);
   Object.defineProperty(o, GitWalkSymbol, {
     value: function ({ fs, dir, gitdir, cache }) {
-      return new GitWalkerFs({ fs, dir, gitdir, cache })
+      return new GitWalkerFs({ fs, dir, gitdir, cache, refresh })
     },
   });
   Object.freeze(o);
@@ -9343,8 +9350,8 @@ function filterCapabilities(server, client) {
 
 const pkg = {
   name: 'isomorphic-git',
-  version: '1.37.8',
-  agent: 'git/isomorphic-git@1.37.8',
+  version: '1.38.0',
+  agent: 'git/isomorphic-git@1.38.0',
 };
 
 class FIFO {
@@ -16044,6 +16051,11 @@ async function stash({
  * @param {string} [args.gitdir=join(dir, '.git')] - [required] The [git directory](dir-vs-gitdir.md) path
  * @param {string} args.filepath - The path to the file to query
  * @param {object} [args.cache] - a [cache](cache.md) object
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache when the working-tree file's contents still match
+ *   the staged blob. The call becomes read-only with respect to the index, at
+ *   the cost of recomputing the SHA1 on subsequent calls for files whose
+ *   stat info has drifted.
  *
  * @returns {Promise<'ignored'|'unmodified'|'*modified'|'*deleted'|'*added'|'absent'|'modified'|'deleted'|'added'|'*unmodified'|'*absent'|'*undeleted'|'*undeletemodified'>} Resolves successfully with the file's git status
  *
@@ -16058,6 +16070,7 @@ async function status({
   gitdir = join(dir, '.git'),
   filepath,
   cache = {},
+  refresh = true,
 }) {
   try {
     assertParameter('fs', _fs);
@@ -16109,7 +16122,7 @@ async function status({
           object,
         });
         // If the oid in the index === working dir oid but stats differed update cache
-        if (I && indexEntry.oid === workdirOid) {
+        if (refresh && I && indexEntry.oid === workdirOid) {
           // and as long as our fs.stats aren't bad.
           // size of -1 happens over a BrowserFS HTTP Backend that doesn't serve Content-Length headers
           // (like the Karma webserver) because BrowserFS HTTP Backend uses HTTP HEAD requests to do fs.stat
@@ -16362,6 +16375,11 @@ async function getHeadTree({ fs, cache, gitdir: updatedGitdir }) {
  * @param {function(string): boolean} [args.filter] - Filter the results to only those whose filepath matches a function.
  * @param {object} [args.cache] - a [cache](cache.md) object
  * @param {boolean} [args.ignored = false] - include ignored files in the result
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache for files whose contents still match the staged
+ *   blob. The call becomes read-only with respect to the index, at the cost
+ *   of recomputing the SHA1 on subsequent calls for files whose stat info
+ *   has drifted.
  *
  * @returns {Promise<Array<StatusRow>>} Resolves with a status matrix, described below.
  * @see StatusRow
@@ -16375,6 +16393,7 @@ async function statusMatrix({
   filter,
   cache = {},
   ignored: shouldIgnore = false,
+  refresh = true,
 }) {
   try {
     assertParameter('fs', _fs);
@@ -16388,7 +16407,7 @@ async function statusMatrix({
       cache,
       dir,
       gitdir: updatedGitdir,
-      trees: [TREE({ ref }), WORKDIR(), STAGE()],
+      trees: [TREE({ ref }), WORKDIR({ refresh }), STAGE()],
       map: async function (filepath, [head, workdir, stage]) {
         // Ignore ignored files, but only if they are not already tracked.
         if (!head && !stage && workdir) {

package/index.d.cts

@@ -675,9 +675,15 @@ export function TREE({ ref }?: {
     ref?: string | undefined;
 }): Walker;
 /**
+ * @param {object} [opts]
+ * @param {boolean} [opts.refresh=true] - When false, suppress the stat-cache
+ *   refresh that would rewrite `.git/index` when a working-tree file's stat
+ *   info has drifted but its content still matches the staged blob.
  * @returns {Walker}
  */
-export function WORKDIR(): Walker;
+export function WORKDIR({ refresh }?: {
+    refresh?: boolean | undefined;
+}): Walker;
 /**
  * Abort a merge in progress.
  *
@@ -3173,6 +3179,11 @@ export function stash({ fs, dir, gitdir, op, message, refIdx, }: {
  * @param {string} [args.gitdir=join(dir, '.git')] - [required] The [git directory](dir-vs-gitdir.md) path
  * @param {string} args.filepath - The path to the file to query
  * @param {object} [args.cache] - a [cache](cache.md) object
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache when the working-tree file's contents still match
+ *   the staged blob. The call becomes read-only with respect to the index, at
+ *   the cost of recomputing the SHA1 on subsequent calls for files whose
+ *   stat info has drifted.
  *
  * @returns {Promise<'ignored'|'unmodified'|'*modified'|'*deleted'|'*added'|'absent'|'modified'|'deleted'|'added'|'*unmodified'|'*absent'|'*undeleted'|'*undeletemodified'>} Resolves successfully with the file's git status
  *
@@ -3181,12 +3192,13 @@ export function stash({ fs, dir, gitdir, op, message, refIdx, }: {
  * console.log(status)
  *
  */
-export function status({ fs: _fs, dir, gitdir, filepath, cache, }: {
+export function status({ fs: _fs, dir, gitdir, filepath, cache, refresh, }: {
     fs: FsClient;
     dir: string;
     gitdir?: string | undefined;
     filepath: string;
     cache?: object;
+    refresh?: boolean | undefined;
 }): Promise<"ignored" | "unmodified" | "*modified" | "*deleted" | "*added" | "absent" | "modified" | "deleted" | "added" | "*unmodified" | "*absent" | "*undeleted" | "*undeletemodified">;
 /**
  * Efficiently get the status of multiple files at once.
@@ -3327,11 +3339,16 @@ export function status({ fs: _fs, dir, gitdir, filepath, cache, }: {
  * @param {function(string): boolean} [args.filter] - Filter the results to only those whose filepath matches a function.
  * @param {object} [args.cache] - a [cache](cache.md) object
  * @param {boolean} [args.ignored = false] - include ignored files in the result
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache for files whose contents still match the staged
+ *   blob. The call becomes read-only with respect to the index, at the cost
+ *   of recomputing the SHA1 on subsequent calls for files whose stat info
+ *   has drifted.
  *
  * @returns {Promise<Array<StatusRow>>} Resolves with a status matrix, described below.
  * @see StatusRow
  */
-export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cache, ignored: shouldIgnore, }: {
+export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cache, ignored: shouldIgnore, refresh, }: {
     fs: FsClient;
     dir: string;
     gitdir?: string | undefined;
@@ -3340,6 +3357,7 @@ export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cac
     filter?: ((arg0: string) => boolean) | undefined;
     cache?: object;
     ignored?: boolean | undefined;
+    refresh?: boolean | undefined;
 }): Promise<Array<StatusRow>>;
 /**
  * Create a lightweight tag

package/index.d.ts

@@ -747,9 +747,15 @@ export function TREE({ ref }?: {
     ref?: string | undefined;
 }): Walker;
 /**
+ * @param {object} [opts]
+ * @param {boolean} [opts.refresh=true] - When false, suppress the stat-cache
+ *   refresh that would rewrite `.git/index` when a working-tree file's stat
+ *   info has drifted but its content still matches the staged blob.
  * @returns {Walker}
  */
-export function WORKDIR(): Walker;
+export function WORKDIR({ refresh }?: {
+    refresh?: boolean | undefined;
+}): Walker;
 /**
  * Abort a merge in progress.
  *
@@ -3172,6 +3178,11 @@ export function stash({ fs, dir, gitdir, op, message, refIdx, }: {
  * @param {string} [args.gitdir=join(dir, '.git')] - [required] The [git directory](dir-vs-gitdir.md) path
  * @param {string} args.filepath - The path to the file to query
  * @param {object} [args.cache] - a [cache](cache.md) object
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache when the working-tree file's contents still match
+ *   the staged blob. The call becomes read-only with respect to the index, at
+ *   the cost of recomputing the SHA1 on subsequent calls for files whose
+ *   stat info has drifted.
  *
  * @returns {Promise<'ignored'|'unmodified'|'*modified'|'*deleted'|'*added'|'absent'|'modified'|'deleted'|'added'|'*unmodified'|'*absent'|'*undeleted'|'*undeletemodified'>} Resolves successfully with the file's git status
  *
@@ -3180,12 +3191,13 @@ export function stash({ fs, dir, gitdir, op, message, refIdx, }: {
  * console.log(status)
  *
  */
-export function status({ fs: _fs, dir, gitdir, filepath, cache, }: {
+export function status({ fs: _fs, dir, gitdir, filepath, cache, refresh, }: {
     fs: FsClient;
     dir: string;
     gitdir?: string | undefined;
     filepath: string;
     cache?: object;
+    refresh?: boolean | undefined;
 }): Promise<"ignored" | "unmodified" | "*modified" | "*deleted" | "*added" | "absent" | "modified" | "deleted" | "added" | "*unmodified" | "*absent" | "*undeleted" | "*undeletemodified">;
 /**
  * Efficiently get the status of multiple files at once.
@@ -3326,11 +3338,16 @@ export function status({ fs: _fs, dir, gitdir, filepath, cache, }: {
  * @param {function(string): boolean} [args.filter] - Filter the results to only those whose filepath matches a function.
  * @param {object} [args.cache] - a [cache](cache.md) object
  * @param {boolean} [args.ignored = false] - include ignored files in the result
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache for files whose contents still match the staged
+ *   blob. The call becomes read-only with respect to the index, at the cost
+ *   of recomputing the SHA1 on subsequent calls for files whose stat info
+ *   has drifted.
  *
  * @returns {Promise<Array<StatusRow>>} Resolves with a status matrix, described below.
  * @see StatusRow
  */
-export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cache, ignored: shouldIgnore, }: {
+export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cache, ignored: shouldIgnore, refresh, }: {
     fs: FsClient;
     dir: string;
     gitdir?: string | undefined;
@@ -3339,6 +3356,7 @@ export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cac
     filter?: ((arg0: string) => boolean) | undefined;
     cache?: object;
     ignored?: boolean | undefined;
+    refresh?: boolean | undefined;
 }): Promise<Array<StatusRow>>;
 /**
  * Create a lightweight tag

package/index.js

@@ -4497,11 +4497,12 @@ function TREE({ ref = 'HEAD' } = {}) {
 // @ts-check
 
 class GitWalkerFs {
-  constructor({ fs, dir, gitdir, cache }) {
+  constructor({ fs, dir, gitdir, cache, refresh = true }) {
     this.fs = fs;
     this.cache = cache;
     this.dir = dir;
     this.gitdir = gitdir;
+    this.refresh = refresh;
 
     this.config = null;
     const walker = this;
@@ -4637,7 +4638,9 @@ class GitWalkerFs {
               // Update the stats in the index so we will get a "cache hit" next time
               // 1) if we can (because the oid and mode are the same)
               // 2) and only if we need to (because other stats differ)
+              // 3) and only if the caller opted in to refreshing the index
               if (
+                self.refresh &&
                 stage &&
                 oid === stage.oid &&
                 (!filemode || stats.mode === stage.mode) &&
@@ -4673,13 +4676,17 @@ class GitWalkerFs {
 // @ts-check
 
 /**
+ * @param {object} [opts]
+ * @param {boolean} [opts.refresh=true] - When false, suppress the stat-cache
+ *   refresh that would rewrite `.git/index` when a working-tree file's stat
+ *   info has drifted but its content still matches the staged blob.
  * @returns {Walker}
  */
-function WORKDIR() {
+function WORKDIR({ refresh = true } = {}) {
   const o = Object.create(null);
   Object.defineProperty(o, GitWalkSymbol, {
     value: function ({ fs, dir, gitdir, cache }) {
-      return new GitWalkerFs({ fs, dir, gitdir, cache })
+      return new GitWalkerFs({ fs, dir, gitdir, cache, refresh })
     },
   });
   Object.freeze(o);
@@ -9330,8 +9337,8 @@ function filterCapabilities(server, client) {
 
 const pkg = {
   name: 'isomorphic-git',
-  version: '1.37.8',
-  agent: 'git/isomorphic-git@1.37.8',
+  version: '1.38.0',
+  agent: 'git/isomorphic-git@1.38.0',
 };
 
 class FIFO {
@@ -16031,6 +16038,11 @@ async function stash({
  * @param {string} [args.gitdir=join(dir, '.git')] - [required] The [git directory](dir-vs-gitdir.md) path
  * @param {string} args.filepath - The path to the file to query
  * @param {object} [args.cache] - a [cache](cache.md) object
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache when the working-tree file's contents still match
+ *   the staged blob. The call becomes read-only with respect to the index, at
+ *   the cost of recomputing the SHA1 on subsequent calls for files whose
+ *   stat info has drifted.
  *
  * @returns {Promise<'ignored'|'unmodified'|'*modified'|'*deleted'|'*added'|'absent'|'modified'|'deleted'|'added'|'*unmodified'|'*absent'|'*undeleted'|'*undeletemodified'>} Resolves successfully with the file's git status
  *
@@ -16045,6 +16057,7 @@ async function status({
   gitdir = join(dir, '.git'),
   filepath,
   cache = {},
+  refresh = true,
 }) {
   try {
     assertParameter('fs', _fs);
@@ -16096,7 +16109,7 @@ async function status({
           object,
         });
         // If the oid in the index === working dir oid but stats differed update cache
-        if (I && indexEntry.oid === workdirOid) {
+        if (refresh && I && indexEntry.oid === workdirOid) {
           // and as long as our fs.stats aren't bad.
           // size of -1 happens over a BrowserFS HTTP Backend that doesn't serve Content-Length headers
           // (like the Karma webserver) because BrowserFS HTTP Backend uses HTTP HEAD requests to do fs.stat
@@ -16349,6 +16362,11 @@ async function getHeadTree({ fs, cache, gitdir: updatedGitdir }) {
  * @param {function(string): boolean} [args.filter] - Filter the results to only those whose filepath matches a function.
  * @param {object} [args.cache] - a [cache](cache.md) object
  * @param {boolean} [args.ignored = false] - include ignored files in the result
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache for files whose contents still match the staged
+ *   blob. The call becomes read-only with respect to the index, at the cost
+ *   of recomputing the SHA1 on subsequent calls for files whose stat info
+ *   has drifted.
  *
  * @returns {Promise<Array<StatusRow>>} Resolves with a status matrix, described below.
  * @see StatusRow
@@ -16362,6 +16380,7 @@ async function statusMatrix({
   filter,
   cache = {},
   ignored: shouldIgnore = false,
+  refresh = true,
 }) {
   try {
     assertParameter('fs', _fs);
@@ -16375,7 +16394,7 @@ async function statusMatrix({
       cache,
       dir,
       gitdir: updatedGitdir,
-      trees: [TREE({ ref }), WORKDIR(), STAGE()],
+      trees: [TREE({ ref }), WORKDIR({ refresh }), STAGE()],
       map: async function (filepath, [head, workdir, stage]) {
         // Ignore ignored files, but only if they are not already tracked.
         if (!head && !stage && workdir) {

package/index.umd.min.d.ts

@@ -747,9 +747,15 @@ export function TREE({ ref }?: {
     ref?: string | undefined;
 }): Walker;
 /**
+ * @param {object} [opts]
+ * @param {boolean} [opts.refresh=true] - When false, suppress the stat-cache
+ *   refresh that would rewrite `.git/index` when a working-tree file's stat
+ *   info has drifted but its content still matches the staged blob.
  * @returns {Walker}
  */
-export function WORKDIR(): Walker;
+export function WORKDIR({ refresh }?: {
+    refresh?: boolean | undefined;
+}): Walker;
 /**
  * Abort a merge in progress.
  *
@@ -3172,6 +3178,11 @@ export function stash({ fs, dir, gitdir, op, message, refIdx, }: {
  * @param {string} [args.gitdir=join(dir, '.git')] - [required] The [git directory](dir-vs-gitdir.md) path
  * @param {string} args.filepath - The path to the file to query
  * @param {object} [args.cache] - a [cache](cache.md) object
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache when the working-tree file's contents still match
+ *   the staged blob. The call becomes read-only with respect to the index, at
+ *   the cost of recomputing the SHA1 on subsequent calls for files whose
+ *   stat info has drifted.
  *
  * @returns {Promise<'ignored'|'unmodified'|'*modified'|'*deleted'|'*added'|'absent'|'modified'|'deleted'|'added'|'*unmodified'|'*absent'|'*undeleted'|'*undeletemodified'>} Resolves successfully with the file's git status
  *
@@ -3180,12 +3191,13 @@ export function stash({ fs, dir, gitdir, op, message, refIdx, }: {
  * console.log(status)
  *
  */
-export function status({ fs: _fs, dir, gitdir, filepath, cache, }: {
+export function status({ fs: _fs, dir, gitdir, filepath, cache, refresh, }: {
     fs: FsClient;
     dir: string;
     gitdir?: string | undefined;
     filepath: string;
     cache?: object;
+    refresh?: boolean | undefined;
 }): Promise<"ignored" | "unmodified" | "*modified" | "*deleted" | "*added" | "absent" | "modified" | "deleted" | "added" | "*unmodified" | "*absent" | "*undeleted" | "*undeletemodified">;
 /**
  * Efficiently get the status of multiple files at once.
@@ -3326,11 +3338,16 @@ export function status({ fs: _fs, dir, gitdir, filepath, cache, }: {
  * @param {function(string): boolean} [args.filter] - Filter the results to only those whose filepath matches a function.
  * @param {object} [args.cache] - a [cache](cache.md) object
  * @param {boolean} [args.ignored = false] - include ignored files in the result
+ * @param {boolean} [args.refresh = true] - when false, do not refresh the
+ *   `.git/index` stat cache for files whose contents still match the staged
+ *   blob. The call becomes read-only with respect to the index, at the cost
+ *   of recomputing the SHA1 on subsequent calls for files whose stat info
+ *   has drifted.
  *
  * @returns {Promise<Array<StatusRow>>} Resolves with a status matrix, described below.
  * @see StatusRow
  */
-export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cache, ignored: shouldIgnore, }: {
+export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cache, ignored: shouldIgnore, refresh, }: {
     fs: FsClient;
     dir: string;
     gitdir?: string | undefined;
@@ -3339,6 +3356,7 @@ export function statusMatrix({ fs: _fs, dir, gitdir, ref, filepaths, filter, cac
     filter?: ((arg0: string) => boolean) | undefined;
     cache?: object;
     ignored?: boolean | undefined;
+    refresh?: boolean | undefined;
 }): Promise<Array<StatusRow>>;
 /**
  * Create a lightweight tag