@docusaurus/utils 4.0.0-canary-6896 → 4.0.0-canary-6899

package/lib/lastUpdateUtils.js

@@ -18,7 +18,7 @@ async function readLastUpdateData(filePath, options, lastUpdateFrontMatter, vcsP
     // This also ensures unit tests keep working without extra setup
     // We still want to ensure type safety by requiring the VCS param
     // TODO Docusaurus v4: refactor all these Git read APIs
-    const vcs = vcsParam ?? (0, vcs_1.getVcsPreset)('default-v1');
+    const vcs = vcsParam ?? (0, vcs_1.getVcsPreset)('default-v3');
     const { showLastUpdateAuthor, showLastUpdateTime } = options;
     if (!showLastUpdateAuthor && !showLastUpdateTime) {
         return { lastUpdatedBy: undefined, lastUpdatedAt: undefined };

package/lib/vcs/vcs.js

@@ -12,15 +12,15 @@ const vcsHardcoded_1 = require("./vcsHardcoded");
 const vcsGitAdHoc_1 = require("./vcsGitAdHoc");
 const vcsGitEager_1 = require("./vcsGitEager");
 const vcsDisabled_1 = require("./vcsDisabled");
-const vcsDefaultV1_1 = require("./vcsDefaultV1");
-const vcsDefaultV2_1 = require("./vcsDefaultV2");
+const vcsDefault_1 = require("./vcsDefault");
+const vcsDefaultV3_1 = require("./vcsDefaultV3");
 const VcsPresets = {
     'git-ad-hoc': vcsGitAdHoc_1.VcsGitAdHoc,
     'git-eager': vcsGitEager_1.VscGitEager,
     hardcoded: vcsHardcoded_1.VcsHardcoded,
     disabled: vcsDisabled_1.VcsDisabled,
-    'default-v1': vcsDefaultV1_1.VcsDefaultV1,
-    'default-v2': vcsDefaultV2_1.VcsDefaultV2,
+    default: vcsDefault_1.VcsDefault,
+    'default-v3': vcsDefaultV3_1.VcsDefaultV3,
 };
 exports.VcsPresetNames = Object.keys(VcsPresets);
 function findVcsPreset(presetName) {

package/lib/vcs/vcs.js.map

@@ -1 +1 @@
-{"version":3,"file":"vcs.js","sourceRoot":"","sources":["../../src/vcs/vcs.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,iDAKwB;AACxB,+CAA0C;AAC1C,+CAA0C;AAC1C,+CAA0C;AAC1C,iDAA4C;AAC5C,iDAA4C;AAG5C,MAAM,UAAU,GAAiC;IAC/C,YAAY,EAAE,yBAAW;IACzB,WAAW,EAAE,yBAAW;IACxB,SAAS,EAAE,2BAAY;IACvB,QAAQ,EAAE,yBAAW;IAErB,YAAY,EAAE,2BAAY;IAC1B,YAAY,EAAE,2BAAY;CAC3B,CAAC;AAEW,QAAA,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAgB,CAAC;AAErE,SAAS,aAAa,CAAC,UAAkB;IACvC,OAAO,UAAU,CAAC,UAAuB,CAAC,CAAC;AAC7C,CAAC;AAED,sBAA6B,UAAqB;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAC;IACb,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,4DAA4D;AAC/C,QAAA,QAAQ,GAAG;IACtB,aAAa,EAAE,0CAA2B;IAC1C,gBAAgB,EAAE,6CAA8B;IAChD,mBAAmB,EAAE,gDAAiC;IACtD,GAAG,2BAAY;CAChB,CAAC"}
+{"version":3,"file":"vcs.js","sourceRoot":"","sources":["../../src/vcs/vcs.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,iDAKwB;AACxB,+CAA0C;AAC1C,+CAA0C;AAC1C,+CAA0C;AAC1C,6CAAwC;AACxC,iDAA4C;AAG5C,MAAM,UAAU,GAAiC;IAC/C,YAAY,EAAE,yBAAW;IACzB,WAAW,EAAE,yBAAW;IACxB,SAAS,EAAE,2BAAY;IACvB,QAAQ,EAAE,yBAAW;IAErB,OAAO,EAAE,uBAAU;IACnB,YAAY,EAAE,2BAAY;CAC3B,CAAC;AAEW,QAAA,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAgB,CAAC;AAErE,SAAS,aAAa,CAAC,UAAkB;IACvC,OAAO,UAAU,CAAC,UAAuB,CAAC,CAAC;AAC7C,CAAC;AAED,sBAA6B,UAAqB;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAC;IACb,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,uCAAuC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,4DAA4D;AAC/C,QAAA,QAAQ,GAAG;IACtB,aAAa,EAAE,0CAA2B;IAC1C,gBAAgB,EAAE,6CAA8B;IAChD,mBAAmB,EAAE,gDAAiC;IACtD,GAAG,2BAAY;CAChB,CAAC"}

package/lib/vcs/{vcsDefaultV2.d.ts → vcsDefault.d.ts}

@@ -6,8 +6,8 @@
  */
 import type { VcsConfig } from '@docusaurus/types';
 /**
- * This VCS implements the new eager Git automatic strategy.
+ * This VCS implements the default eager Git automatic strategy.
  * It is only enabled in production mode, reading the git repository eagerly.
  */
-export declare const VcsDefaultV2: VcsConfig;
-//# sourceMappingURL=vcsDefaultV2.d.ts.map
+export declare const VcsDefault: VcsConfig;
+//# sourceMappingURL=vcsDefault.d.ts.map

package/lib/vcs/vcsDefault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcsDefault.d.ts","sourceRoot":"","sources":["../../src/vcs/vcsDefault.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AASjD;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC"}

package/lib/vcs/{vcsDefaultV2.js → vcsDefault.js}

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VcsDefaultV2 = void 0;
+exports.VcsDefault = void 0;
 const vcsHardcoded_1 = require("./vcsHardcoded");
 const vcsGitEager_1 = require("./vcsGitEager");
 function getStrategy() {
@@ -16,10 +16,10 @@ function getStrategy() {
         : vcsGitEager_1.VscGitEager;
 }
 /**
- * This VCS implements the new eager Git automatic strategy.
+ * This VCS implements the default eager Git automatic strategy.
  * It is only enabled in production mode, reading the git repository eagerly.
  */
-exports.VcsDefaultV2 = {
+exports.VcsDefault = {
     initialize: (...params) => {
         return getStrategy().initialize(...params);
     },
@@ -30,4 +30,4 @@ exports.VcsDefaultV2 = {
         return getStrategy().getFileLastUpdateInfo(...params);
     },
 };
-//# sourceMappingURL=vcsDefaultV2.js.map
+//# sourceMappingURL=vcsDefault.js.map

package/lib/vcs/vcsDefault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcsDefault.js","sourceRoot":"","sources":["../../src/vcs/vcsDefault.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAA4C;AAC5C,+CAA0C;AAG1C,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAC/B,CAAC,CAAC,2BAAY;QACd,CAAC,CAAC,yBAAW,CAAC;AAClB,CAAC;AAED;;;GAGG;AACU,QAAA,UAAU,GAAc;IACnC,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACxB,OAAO,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,mBAAmB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACjC,OAAO,WAAW,EAAE,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,CAAC;IACtD,CAAC;IACD,qBAAqB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACnC,OAAO,WAAW,EAAE,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/lib/vcs/{vcsDefaultV1.d.ts → vcsDefaultV3.d.ts}

@@ -6,8 +6,8 @@
  */
 import type { VcsConfig } from '@docusaurus/types';
 /**
- * This VCS implements the historical Git automatic strategy.
+ * This VCS implements the historical Docusaurus v3 Git automatic strategy.
  * It is only enabled in production mode, using ad-hoc git log commands.
  */
-export declare const VcsDefaultV1: VcsConfig;
-//# sourceMappingURL=vcsDefaultV1.d.ts.map
+export declare const VcsDefaultV3: VcsConfig;
+//# sourceMappingURL=vcsDefaultV3.d.ts.map

package/lib/vcs/vcsDefaultV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcsDefaultV3.d.ts","sourceRoot":"","sources":["../../src/vcs/vcsDefaultV3.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AASjD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAU1B,CAAC"}

package/lib/vcs/{vcsDefaultV1.js → vcsDefaultV3.js}

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VcsDefaultV1 = void 0;
+exports.VcsDefaultV3 = void 0;
 const vcsHardcoded_1 = require("./vcsHardcoded");
 const vcsGitAdHoc_1 = require("./vcsGitAdHoc");
 function getDynamicStrategy() {
@@ -16,10 +16,10 @@ function getDynamicStrategy() {
         : vcsGitAdHoc_1.VcsGitAdHoc;
 }
 /**
- * This VCS implements the historical Git automatic strategy.
+ * This VCS implements the historical Docusaurus v3 Git automatic strategy.
  * It is only enabled in production mode, using ad-hoc git log commands.
  */
-exports.VcsDefaultV1 = {
+exports.VcsDefaultV3 = {
     initialize: (...params) => {
         return getDynamicStrategy().initialize(...params);
     },
@@ -30,4 +30,4 @@ exports.VcsDefaultV1 = {
         return getDynamicStrategy().getFileLastUpdateInfo(...params);
     },
 };
-//# sourceMappingURL=vcsDefaultV1.js.map
+//# sourceMappingURL=vcsDefaultV3.js.map

package/lib/vcs/{vcsDefaultV1.js.map → vcsDefaultV3.js.map}

@@ -1 +1 @@
-{"version":3,"file":"vcsDefaultV1.js","sourceRoot":"","sources":["../../src/vcs/vcsDefaultV1.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAA4C;AAC5C,+CAA0C;AAG1C,SAAS,kBAAkB;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAC/B,CAAC,CAAC,2BAAY;QACd,CAAC,CAAC,yBAAW,CAAC;AAClB,CAAC;AAED;;;GAGG;AACU,QAAA,YAAY,GAAc;IACrC,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACxB,OAAO,kBAAkB,EAAE,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,mBAAmB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACjC,OAAO,kBAAkB,EAAE,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,qBAAqB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACnC,OAAO,kBAAkB,EAAE,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/D,CAAC;CACF,CAAC"}
+{"version":3,"file":"vcsDefaultV3.js","sourceRoot":"","sources":["../../src/vcs/vcsDefaultV3.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAA4C;AAC5C,+CAA0C;AAG1C,SAAS,kBAAkB;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAC/B,CAAC,CAAC,2BAAY;QACd,CAAC,CAAC,yBAAW,CAAC;AAClB,CAAC;AAED;;;GAGG;AACU,QAAA,YAAY,GAAc;IACrC,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACxB,OAAO,kBAAkB,EAAE,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,mBAAmB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACjC,OAAO,kBAAkB,EAAE,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,qBAAqB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACnC,OAAO,kBAAkB,EAAE,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/D,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/utils",
-  "version": "4.0.0-canary-6896",
+  "version": "4.0.0-canary-6899",
   "description": "Node utility functions for Docusaurus packages.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -19,9 +19,9 @@
   "license": "MIT",
   "dependencies": {
     "@11ty/gray-matter": "^3.0.0",
-    "@docusaurus/fs": "4.0.0-canary-6896",
-    "@docusaurus/logger": "4.0.0-canary-6896",
-    "@docusaurus/types": "4.0.0-canary-6896",
+    "@docusaurus/fs": "4.0.0-canary-6899",
+    "@docusaurus/logger": "4.0.0-canary-6899",
+    "@docusaurus/types": "4.0.0-canary-6899",
     "execa": "^10.0.1",
     "file-loader": "^6.2.0",
     "github-slugger": "^2.0.0",
@@ -42,5 +42,5 @@
     "@types/react-dom": "^19.3.0",
     "dedent": "^1.7.2"
   },
-  "gitHead": "ff0fc69d74156d041b6ddfd675f19ad7c461a26c"
+  "gitHead": "72622a2308261a457ca37d1e090d3efe608558cc"
 }

package/src/lastUpdateUtils.ts

@@ -52,7 +52,7 @@ export async function readLastUpdateData(
   // This also ensures unit tests keep working without extra setup
   // We still want to ensure type safety by requiring the VCS param
   // TODO Docusaurus v4: refactor all these Git read APIs
-  const vcs = vcsParam ?? getVcsPreset('default-v1');
+  const vcs = vcsParam ?? getVcsPreset('default-v3');
 
   const {showLastUpdateAuthor, showLastUpdateTime} = options;
 

package/src/vcs/vcs.ts

@@ -14,8 +14,8 @@ import {
 import {VcsGitAdHoc} from './vcsGitAdHoc';
 import {VscGitEager} from './vcsGitEager';
 import {VcsDisabled} from './vcsDisabled';
-import {VcsDefaultV1} from './vcsDefaultV1';
-import {VcsDefaultV2} from './vcsDefaultV2';
+import {VcsDefault} from './vcsDefault';
+import {VcsDefaultV3} from './vcsDefaultV3';
 import type {VcsConfig, VcsPreset} from '@docusaurus/types';
 
 const VcsPresets: Record<VcsPreset, VcsConfig> = {
@@ -24,8 +24,8 @@ const VcsPresets: Record<VcsPreset, VcsConfig> = {
   hardcoded: VcsHardcoded,
   disabled: VcsDisabled,
 
-  'default-v1': VcsDefaultV1,
-  'default-v2': VcsDefaultV2,
+  default: VcsDefault,
+  'default-v3': VcsDefaultV3,
 };
 
 export const VcsPresetNames = Object.keys(VcsPresets) as VcsPreset[];

package/src/vcs/{vcsDefaultV2.ts → vcsDefault.ts}

@@ -17,10 +17,10 @@ function getStrategy(): VcsConfig {
 }
 
 /**
- * This VCS implements the new eager Git automatic strategy.
+ * This VCS implements the default eager Git automatic strategy.
  * It is only enabled in production mode, reading the git repository eagerly.
  */
-export const VcsDefaultV2: VcsConfig = {
+export const VcsDefault: VcsConfig = {
   initialize: (...params) => {
     return getStrategy().initialize(...params);
   },

package/src/vcs/{vcsDefaultV1.ts → vcsDefaultV3.ts}

@@ -17,10 +17,10 @@ function getDynamicStrategy(): VcsConfig {
 }
 
 /**
- * This VCS implements the historical Git automatic strategy.
+ * This VCS implements the historical Docusaurus v3 Git automatic strategy.
  * It is only enabled in production mode, using ad-hoc git log commands.
  */
-export const VcsDefaultV1: VcsConfig = {
+export const VcsDefaultV3: VcsConfig = {
   initialize: (...params) => {
     return getDynamicStrategy().initialize(...params);
   },

package/lib/vcs/vcsDefaultV1.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vcsDefaultV1.d.ts","sourceRoot":"","sources":["../../src/vcs/vcsDefaultV1.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AASjD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAU1B,CAAC"}

package/lib/vcs/vcsDefaultV2.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vcsDefaultV2.d.ts","sourceRoot":"","sources":["../../src/vcs/vcsDefaultV2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AASjD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,SAU1B,CAAC"}

package/lib/vcs/vcsDefaultV2.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"vcsDefaultV2.js","sourceRoot":"","sources":["../../src/vcs/vcsDefaultV2.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iDAA4C;AAC5C,+CAA0C;AAG1C,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;QAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAC/B,CAAC,CAAC,2BAAY;QACd,CAAC,CAAC,yBAAW,CAAC;AAClB,CAAC;AAED;;;GAGG;AACU,QAAA,YAAY,GAAc;IACrC,UAAU,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACxB,OAAO,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,mBAAmB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACjC,OAAO,WAAW,EAAE,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC,CAAC;IACtD,CAAC;IACD,qBAAqB,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE;QACnC,OAAO,WAAW,EAAE,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}