@docusaurus/utils 3.9.2 → 3.10.1-canary-6591

package/src/vcs/vcsGitAdHoc.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {getGitLastUpdate, getGitCreation} from './gitUtils';
+import type {VcsConfig} from '@docusaurus/types';
+
+/**
+ * A VCS strategy to query Git information in an ad-hoc way.
+ * This is the default/historical Docusaurus Git VCS implementation.
+ * Unfortunately, it is a major bottleneck for large sites/repositories.
+ *
+ * See also https://github.com/facebook/docusaurus/issues/11208
+ */
+export const VcsGitAdHoc: VcsConfig = {
+  initialize: () => {
+    // Nothing to do here for the default/historical Git implementation
+  },
+
+  getFileCreationInfo: async (filePath: string) => {
+    return getGitCreation(filePath);
+  },
+
+  getFileLastUpdateInfo: async (filePath: string) => {
+    return getGitLastUpdate(filePath);
+  },
+};

package/src/vcs/vcsGitEager.ts

@@ -0,0 +1,135 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {resolve, basename} from 'node:path';
+import logger, {PerfLogger} from '@docusaurus/logger';
+import {
+  getGitAllRepoRoots,
+  getGitRepositoryFilesInfo,
+  isGitInsideWorktree,
+} from './gitUtils';
+import type {GitFileInfo, GitFileInfoMap} from './gitUtils';
+import type {VcsConfig} from '@docusaurus/types';
+
+// The Map keys should be absolute file paths, not relative Git paths
+function resolveFileInfoMapPaths(
+  repoRoot: string,
+  filesInfo: GitFileInfoMap,
+): GitFileInfoMap {
+  function transformMapEntry(
+    entry: [string, GitFileInfo],
+  ): [string, GitFileInfo] {
+    // We just resolve the Git paths that are relative to the repo root
+    return [resolve(repoRoot, entry[0]), entry[1]];
+  }
+
+  return new Map(Array.from(filesInfo.entries()).map(transformMapEntry));
+}
+
+function mergeFileMaps(fileMaps: GitFileInfoMap[]): GitFileInfoMap {
+  return new Map(fileMaps.flatMap((m) => [...m]));
+}
+
+async function loadAllGitFilesInfoMap(cwd: string): Promise<GitFileInfoMap> {
+  const roots = await PerfLogger.async('Reading Git root dirs', () =>
+    getGitAllRepoRoots(cwd),
+  );
+
+  const allMaps: GitFileInfoMap[] = await Promise.all(
+    roots.map(async (root) => {
+      const map = await PerfLogger.async(
+        `Reading Git history for repo ${logger.path(basename(root))}`,
+        () => getGitRepositoryFilesInfo(root),
+      );
+      return resolveFileInfoMapPaths(root, map);
+    }),
+  );
+
+  return mergeFileMaps(allMaps);
+}
+
+type InitializeResult =
+  | {
+      type: 'success';
+      filesMap: GitFileInfoMap;
+    }
+  | {
+      type: 'error';
+      reason: 'not-in-worktree' | 'unknown';
+      cause?: Error;
+    };
+
+async function initialize({
+  siteDir,
+}: {
+  siteDir: string;
+}): Promise<InitializeResult> {
+  try {
+    const isInWorktree = await isGitInsideWorktree(siteDir);
+    if (!isInWorktree) {
+      return {type: 'error', reason: 'not-in-worktree'};
+    }
+    const filesMap = await loadAllGitFilesInfoMap(siteDir);
+    return {type: 'success', filesMap};
+  } catch (error) {
+    return {type: 'error', reason: 'unknown', cause: error as Error};
+  }
+}
+
+export function createVcsGitEagerConfig(): VcsConfig {
+  let initPromise: Promise<InitializeResult> | null = null;
+
+  async function getGitFileInfo(filePath: string): Promise<GitFileInfo | null> {
+    const init = (await initPromise)!;
+    if (init.type === 'success') {
+      return init.filesMap.get(filePath) ?? null;
+    } else if (init.reason === 'not-in-worktree') {
+      throw new Error(
+        `This Docusaurus site is outside any Git worktree.
+Unable to read Git info for file ${logger.path(filePath)} `,
+      );
+    } else {
+      throw init.cause;
+    }
+  }
+
+  return {
+    initialize: ({siteDir}) => {
+      if (initPromise) {
+        // We only initialize this VCS once!
+        // For i18n sites, this permits reading ahead of time for all locales
+        // so that it only slows down the first locale
+        // I assume this logic is fine, but we'll see if it causes trouble
+
+        // Note: we could also only call "initialize()" once from the outside,
+        // But maybe it could be useful for custom VCS implementations to be
+        // able to initialize once per locale?
+        PerfLogger.log(
+          'Git Eager VCS strategy already initialized, skipping re-initialization',
+        );
+        return;
+      }
+
+      initPromise = PerfLogger.async('Git Eager VCS init', () =>
+        initialize({siteDir}),
+      );
+    },
+
+    getFileCreationInfo: async (filePath: string) => {
+      const fileInfo = await getGitFileInfo(filePath);
+      return fileInfo?.creation ?? null;
+    },
+
+    getFileLastUpdateInfo: async (filePath: string) => {
+      const fileInfo = await getGitFileInfo(filePath);
+      return fileInfo?.lastUpdate ?? null;
+    },
+  };
+}
+
+// TODO it probably shouldn't be a singleton, but good enough for now
+export const VscGitEager: VcsConfig = createVcsGitEagerConfig();

package/src/vcs/vcsHardcoded.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import type {VcsConfig, VcsChangeInfo} from '@docusaurus/types';
+
+export const VCS_HARDCODED_CREATION_INFO: VcsChangeInfo = {
+  timestamp: 1490997600000, // 1st Apr 2017
+  author: 'Creator',
+};
+
+export const VCS_HARDCODED_LAST_UPDATE_INFO: VcsChangeInfo = {
+  timestamp: 1539502055000, // 14th Oct 2018
+  author: 'Author',
+};
+
+export const VCS_HARDCODED_UNTRACKED_FILE_PATH = `file/path/${Math.random()}.mdx`;
+
+/**
+ * This VCS implementation always returns hardcoded values for testing purposes.
+ * It is also useful in dev environments where VCS info is not important.
+ * Reading information from the VCS can be slow and is not always necessary.
+ */
+export const VcsHardcoded: VcsConfig = {
+  initialize: () => {
+    // Noop
+  },
+
+  getFileCreationInfo: async (filePath: string) => {
+    if (filePath === VCS_HARDCODED_UNTRACKED_FILE_PATH) {
+      return null;
+    }
+    return VCS_HARDCODED_CREATION_INFO;
+  },
+
+  getFileLastUpdateInfo: async (filePath: string) => {
+    if (filePath === VCS_HARDCODED_UNTRACKED_FILE_PATH) {
+      return null;
+    }
+    return VCS_HARDCODED_LAST_UPDATE_INFO;
+  },
+};

package/lib/cliUtils.d.ts

@@ -1,14 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-type PreferredLanguage = 'javascript' | 'typescript';
-type AskPreferredLanguageOptions = {
-    fallback: PreferredLanguage | undefined;
-    exit: boolean;
-};
-export declare function askPreferredLanguage(options?: Partial<AskPreferredLanguageOptions>): Promise<'javascript' | 'typescript'>;
-export {};
-//# sourceMappingURL=cliUtils.d.ts.map

package/lib/cliUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cliUtils.d.ts","sourceRoot":"","sources":["../src/cliUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,KAAK,iBAAiB,GAAG,YAAY,GAAG,YAAY,CAAC;AAErD,KAAK,2BAA2B,GAAG;IACjC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AASF,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACjD,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC,CAsCtC"}

package/lib/cliUtils.js

@@ -1,49 +0,0 @@
-"use strict";
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askPreferredLanguage = askPreferredLanguage;
-const tslib_1 = require("tslib");
-const prompts_1 = tslib_1.__importDefault(require("prompts"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const DefaultOptions = {
-    fallback: undefined,
-    exit: false,
-};
-const ExitChoice = { title: logger_1.default.yellow('[Exit]'), value: '[Exit]' };
-async function askPreferredLanguage(options = {}) {
-    const { fallback, exit } = { ...DefaultOptions, ...options };
-    const choices = [
-        { title: logger_1.default.bold('JavaScript'), value: 'javascript' },
-        { title: logger_1.default.bold('TypeScript'), value: 'typescript' },
-    ];
-    if (exit) {
-        choices.push(ExitChoice);
-    }
-    const { language } = await (0, prompts_1.default)({
-        type: 'select',
-        name: 'language',
-        message: 'Which language do you want to use?',
-        choices,
-    }, {
-        onCancel() {
-            exit && process.exit(0);
-        },
-    });
-    if (language === ExitChoice.value) {
-        process.exit(0);
-    }
-    if (!language) {
-        if (fallback) {
-            logger_1.default.info `Falling back to language=${fallback}`;
-            return fallback;
-        }
-        process.exit(0);
-    }
-    return language;
-}
-//# sourceMappingURL=cliUtils.js.map

package/lib/cliUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cliUtils.js","sourceRoot":"","sources":["../src/cliUtils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAmBH,oDAwCC;;AAzDD,8DAA6C;AAC7C,wEAAwC;AASxC,MAAM,cAAc,GAAgC;IAClD,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,UAAU,GAAW,EAAC,KAAK,EAAE,gBAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAC,CAAC;AAEtE,KAAK,UAAU,oBAAoB,CACxC,UAAgD,EAAE;IAElD,MAAM,EAAC,QAAQ,EAAE,IAAI,EAAC,GAAG,EAAC,GAAG,cAAc,EAAE,GAAG,OAAO,EAAC,CAAC;IAEzD,MAAM,OAAO,GAAa;QACxB,EAAC,KAAK,EAAE,gBAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,YAAY,EAAC;QACvD,EAAC,KAAK,EAAE,gBAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,YAAY,EAAC;KACxD,CAAC;IACF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,EAAC,QAAQ,EAAC,GAAG,MAAM,IAAA,iBAAO,EAC9B;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,oCAAoC;QAC7C,OAAO;KACR,EACD;QACE,QAAQ;YACN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;KACF,CACF,CAAC;IAEF,IAAI,QAAQ,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,QAAQ,EAAE,CAAC;YACb,gBAAM,CAAC,IAAI,CAAA,4BAA4B,QAAQ,EAAE,CAAC;YAClD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/lib/gitUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gitUtils.d.ts","sourceRoot":"","sources":["../src/gitUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH,2DAA2D;AAC3D,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,uEAAuE;AACvE,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB;AACrC,iCAAiC;AACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ;;;OAGG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,uEAAuE;IACvE,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,GACA,OAAO,CAAC;IACT,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AACH;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB;AACrC,iCAAiC;AACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ;;;OAGG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,aAAa,EAAE,IAAI,CAAC;CACrB,GACA,OAAO,CAAC;IACT,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC"}

package/lib/gitUtils.js

@@ -1,103 +0,0 @@
-"use strict";
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileNotTrackedError = exports.GitNotFoundError = void 0;
-exports.getFileCommitDate = getFileCommitDate;
-const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const os_1 = tslib_1.__importDefault(require("os"));
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
-const execa_1 = tslib_1.__importDefault(require("execa"));
-const p_queue_1 = tslib_1.__importDefault(require("p-queue"));
-// Quite high/conservative concurrency value (it was previously "Infinity")
-// See https://github.com/facebook/docusaurus/pull/10915
-const DefaultGitCommandConcurrency = 
-// TODO Docusaurus v4: bump node, availableParallelism() now always exists
-(typeof os_1.default.availableParallelism === 'function'
-    ? os_1.default.availableParallelism()
-    : os_1.default.cpus().length) * 4;
-const GitCommandConcurrencyEnv = process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY
-    ? parseInt(process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY, 10)
-    : undefined;
-const GitCommandConcurrency = GitCommandConcurrencyEnv && GitCommandConcurrencyEnv > 0
-    ? GitCommandConcurrencyEnv
-    : DefaultGitCommandConcurrency;
-// We use a queue to avoid running too many concurrent Git commands at once
-// See https://github.com/facebook/docusaurus/issues/10348
-const GitCommandQueue = new p_queue_1.default({
-    concurrency: GitCommandConcurrency,
-});
-const realHasGitFn = () => {
-    try {
-        return execa_1.default.sync('git', ['--version']).exitCode === 0;
-    }
-    catch (error) {
-        return false;
-    }
-};
-// The hasGit call is synchronous IO so we memoize it
-// The user won't install Git in the middle of a build anyway...
-const hasGit = process.env.NODE_ENV === 'test' ? realHasGitFn : lodash_1.default.memoize(realHasGitFn);
-/** Custom error thrown when git is not found in `PATH`. */
-class GitNotFoundError extends Error {
-}
-exports.GitNotFoundError = GitNotFoundError;
-/** Custom error thrown when the current file is not tracked by git. */
-class FileNotTrackedError extends Error {
-}
-exports.FileNotTrackedError = FileNotTrackedError;
-async function getFileCommitDate(file, { age = 'oldest', includeAuthor = false, }) {
-    if (!hasGit()) {
-        throw new GitNotFoundError(`Failed to retrieve git history for "${file}" because git is not installed.`);
-    }
-    if (!(await fs_extra_1.default.pathExists(file))) {
-        throw new Error(`Failed to retrieve git history for "${file}" because the file does not exist.`);
-    }
-    // We add a "RESULT:" prefix to make parsing easier
-    // See why: https://github.com/facebook/docusaurus/pull/10022
-    const resultFormat = includeAuthor ? 'RESULT:%ct,%an' : 'RESULT:%ct';
-    const args = [
-        `--format=${resultFormat}`,
-        '--max-count=1',
-        age === 'oldest' ? '--follow --diff-filter=A' : undefined,
-    ]
-        .filter(Boolean)
-        .join(' ');
-    const command = `git -c log.showSignature=false log ${args} -- "${path_1.default.basename(file)}"`;
-    const result = (await GitCommandQueue.add(() => {
-        return (0, execa_1.default)(command, {
-            cwd: path_1.default.dirname(file),
-            shell: true,
-        });
-    }));
-    if (result.exitCode !== 0) {
-        throw new Error(`Failed to retrieve the git history for file "${file}" with exit code ${result.exitCode}: ${result.stderr}`);
-    }
-    // We only parse the output line starting with our "RESULT:" prefix
-    // See why https://github.com/facebook/docusaurus/pull/10022
-    const regex = includeAuthor
-        ? /(?:^|\n)RESULT:(?<timestamp>\d+),(?<author>.+)(?:$|\n)/
-        : /(?:^|\n)RESULT:(?<timestamp>\d+)(?:$|\n)/;
-    const output = result.stdout.trim();
-    if (!output) {
-        throw new FileNotTrackedError(`Failed to retrieve the git history for file "${file}" because the file is not tracked by git.`);
-    }
-    const match = output.match(regex);
-    if (!match) {
-        throw new Error(`Failed to retrieve the git history for file "${file}" with unexpected output: ${output}`);
-    }
-    const timestampInSeconds = Number(match.groups.timestamp);
-    const timestamp = timestampInSeconds * 1000;
-    const date = new Date(timestamp);
-    if (includeAuthor) {
-        return { date, timestamp, author: match.groups.author };
-    }
-    return { date, timestamp };
-}
-//# sourceMappingURL=gitUtils.js.map

package/lib/gitUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"gitUtils.js","sourceRoot":"","sources":["../src/gitUtils.ts"],"names":[],"mappings":"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"}

package/src/cliUtils.ts

@@ -1,65 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import prompts, {type Choice} from 'prompts';
-import logger from '@docusaurus/logger';
-
-type PreferredLanguage = 'javascript' | 'typescript';
-
-type AskPreferredLanguageOptions = {
-  fallback: PreferredLanguage | undefined;
-  exit: boolean;
-};
-
-const DefaultOptions: AskPreferredLanguageOptions = {
-  fallback: undefined,
-  exit: false,
-};
-
-const ExitChoice: Choice = {title: logger.yellow('[Exit]'), value: '[Exit]'};
-
-export async function askPreferredLanguage(
-  options: Partial<AskPreferredLanguageOptions> = {},
-): Promise<'javascript' | 'typescript'> {
-  const {fallback, exit} = {...DefaultOptions, ...options};
-
-  const choices: Choice[] = [
-    {title: logger.bold('JavaScript'), value: 'javascript'},
-    {title: logger.bold('TypeScript'), value: 'typescript'},
-  ];
-  if (exit) {
-    choices.push(ExitChoice);
-  }
-
-  const {language} = await prompts(
-    {
-      type: 'select',
-      name: 'language',
-      message: 'Which language do you want to use?',
-      choices,
-    },
-    {
-      onCancel() {
-        exit && process.exit(0);
-      },
-    },
-  );
-
-  if (language === ExitChoice.value) {
-    process.exit(0);
-  }
-
-  if (!language) {
-    if (fallback) {
-      logger.info`Falling back to language=${fallback}`;
-      return fallback;
-    }
-    process.exit(0);
-  }
-
-  return language;
-}

package/src/gitUtils.ts

@@ -1,200 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import path from 'path';
-import fs from 'fs-extra';
-import os from 'os';
-import _ from 'lodash';
-import execa from 'execa';
-import PQueue from 'p-queue';
-
-// Quite high/conservative concurrency value (it was previously "Infinity")
-// See https://github.com/facebook/docusaurus/pull/10915
-const DefaultGitCommandConcurrency =
-  // TODO Docusaurus v4: bump node, availableParallelism() now always exists
-  (typeof os.availableParallelism === 'function'
-    ? os.availableParallelism()
-    : os.cpus().length) * 4;
-
-const GitCommandConcurrencyEnv = process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY
-  ? parseInt(process.env.DOCUSAURUS_GIT_COMMAND_CONCURRENCY, 10)
-  : undefined;
-
-const GitCommandConcurrency =
-  GitCommandConcurrencyEnv && GitCommandConcurrencyEnv > 0
-    ? GitCommandConcurrencyEnv
-    : DefaultGitCommandConcurrency;
-
-// We use a queue to avoid running too many concurrent Git commands at once
-// See https://github.com/facebook/docusaurus/issues/10348
-const GitCommandQueue = new PQueue({
-  concurrency: GitCommandConcurrency,
-});
-
-const realHasGitFn = () => {
-  try {
-    return execa.sync('git', ['--version']).exitCode === 0;
-  } catch (error) {
-    return false;
-  }
-};
-
-// The hasGit call is synchronous IO so we memoize it
-// The user won't install Git in the middle of a build anyway...
-const hasGit =
-  process.env.NODE_ENV === 'test' ? realHasGitFn : _.memoize(realHasGitFn);
-
-/** Custom error thrown when git is not found in `PATH`. */
-export class GitNotFoundError extends Error {}
-
-/** Custom error thrown when the current file is not tracked by git. */
-export class FileNotTrackedError extends Error {}
-
-/**
- * Fetches the git history of a file and returns a relevant commit date.
- * It gets the commit date instead of author date so that amended commits
- * can have their dates updated.
- *
- * @throws {@link GitNotFoundError} If git is not found in `PATH`.
- * @throws {@link FileNotTrackedError} If the current file is not tracked by git.
- * @throws Also throws when `git log` exited with non-zero, or when it outputs
- * unexpected text.
- */
-export async function getFileCommitDate(
-  /** Absolute path to the file. */
-  file: string,
-  args: {
-    /**
-     * `"oldest"` is the commit that added the file, following renames;
-     * `"newest"` is the last commit that edited the file.
-     */
-    age?: 'oldest' | 'newest';
-    /** Use `includeAuthor: true` to get the author information as well. */
-    includeAuthor?: false;
-  },
-): Promise<{
-  /** Relevant commit date. */
-  date: Date;
-  /** Timestamp returned from git, converted to **milliseconds**. */
-  timestamp: number;
-}>;
-/**
- * Fetches the git history of a file and returns a relevant commit date.
- * It gets the commit date instead of author date so that amended commits
- * can have their dates updated.
- *
- * @throws {@link GitNotFoundError} If git is not found in `PATH`.
- * @throws {@link FileNotTrackedError} If the current file is not tracked by git.
- * @throws Also throws when `git log` exited with non-zero, or when it outputs
- * unexpected text.
- */
-export async function getFileCommitDate(
-  /** Absolute path to the file. */
-  file: string,
-  args: {
-    /**
-     * `"oldest"` is the commit that added the file, following renames;
-     * `"newest"` is the last commit that edited the file.
-     */
-    age?: 'oldest' | 'newest';
-    includeAuthor: true;
-  },
-): Promise<{
-  /** Relevant commit date. */
-  date: Date;
-  /** Timestamp returned from git, converted to **milliseconds**. */
-  timestamp: number;
-  /** The author's name, as returned from git. */
-  author: string;
-}>;
-
-export async function getFileCommitDate(
-  file: string,
-  {
-    age = 'oldest',
-    includeAuthor = false,
-  }: {
-    age?: 'oldest' | 'newest';
-    includeAuthor?: boolean;
-  },
-): Promise<{
-  date: Date;
-  timestamp: number;
-  author?: string;
-}> {
-  if (!hasGit()) {
-    throw new GitNotFoundError(
-      `Failed to retrieve git history for "${file}" because git is not installed.`,
-    );
-  }
-
-  if (!(await fs.pathExists(file))) {
-    throw new Error(
-      `Failed to retrieve git history for "${file}" because the file does not exist.`,
-    );
-  }
-
-  // We add a "RESULT:" prefix to make parsing easier
-  // See why: https://github.com/facebook/docusaurus/pull/10022
-  const resultFormat = includeAuthor ? 'RESULT:%ct,%an' : 'RESULT:%ct';
-
-  const args = [
-    `--format=${resultFormat}`,
-    '--max-count=1',
-    age === 'oldest' ? '--follow --diff-filter=A' : undefined,
-  ]
-    .filter(Boolean)
-    .join(' ');
-
-  const command = `git -c log.showSignature=false log ${args} -- "${path.basename(
-    file,
-  )}"`;
-
-  const result = (await GitCommandQueue.add(() => {
-    return execa(command, {
-      cwd: path.dirname(file),
-      shell: true,
-    });
-  }))!;
-
-  if (result.exitCode !== 0) {
-    throw new Error(
-      `Failed to retrieve the git history for file "${file}" with exit code ${result.exitCode}: ${result.stderr}`,
-    );
-  }
-
-  // We only parse the output line starting with our "RESULT:" prefix
-  // See why https://github.com/facebook/docusaurus/pull/10022
-  const regex = includeAuthor
-    ? /(?:^|\n)RESULT:(?<timestamp>\d+),(?<author>.+)(?:$|\n)/
-    : /(?:^|\n)RESULT:(?<timestamp>\d+)(?:$|\n)/;
-
-  const output = result.stdout.trim();
-
-  if (!output) {
-    throw new FileNotTrackedError(
-      `Failed to retrieve the git history for file "${file}" because the file is not tracked by git.`,
-    );
-  }
-
-  const match = output.match(regex);
-
-  if (!match) {
-    throw new Error(
-      `Failed to retrieve the git history for file "${file}" with unexpected output: ${output}`,
-    );
-  }
-
-  const timestampInSeconds = Number(match.groups!.timestamp);
-  const timestamp = timestampInSeconds * 1_000;
-  const date = new Date(timestamp);
-
-  if (includeAuthor) {
-    return {date, timestamp, author: match.groups!.author!};
-  }
-  return {date, timestamp};
-}