@docusaurus/core 4.0.0-canary-6885 → 4.0.0-canary-6888

package/bin/beforeCli.mjs

@@ -7,7 +7,6 @@
 
 // @ts-check
 
-import fs from 'fs-extra';
 import path from 'node:path';
 import {createRequire} from 'node:module';
 import {execa} from 'execa';
@@ -16,6 +15,7 @@ import semver from 'semver';
 import updateNotifier from 'update-notifier';
 import boxen from 'boxen';
 import {DOCUSAURUS_VERSION} from '@docusaurus/utils';
+import {pathExists} from '@docusaurus/fs';
 
 const packageJson = /** @type {typeof import("../package.json")} */ (
   createRequire(import.meta.url)('../package.json')
@@ -108,7 +108,7 @@ export default async function beforeCli() {
       .join(' ');
 
     const getYarnVersion = async () => {
-      if (!(await fs.pathExists(path.resolve('yarn.lock')))) {
+      if (!(await pathExists(path.resolve('yarn.lock')))) {
         return undefined;
       }
 

package/lib/commands/build/build.js

@@ -8,9 +8,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.build = build;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const i18n_1 = require("../../server/i18n");
 const buildLocale_1 = require("./buildLocale");
 const config_1 = require("../../server/config");
@@ -22,7 +22,7 @@ async function build(siteDirParam = '.', cliOptions = {}) {
         process.env.BABEL_ENV = 'development';
         process.env.NODE_ENV = 'development';
     }
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     ['SIGINT', 'SIGTERM'].forEach((sig) => {
         process.on(sig, () => process.exit());
     });

package/lib/commands/build/buildLocale.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildLocale = buildLocale;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const bundler_1 = require("@docusaurus/bundler");
@@ -164,7 +164,7 @@ async function cleanupServerBundle(serverBundlePath) {
         await logger_1.PerfLogger.async('Deleting server bundle', async () => {
             // For now we assume server entry is at the root of the server out dir
             const serverDir = node_path_1.default.dirname(serverBundlePath);
-            await fs_extra_1.default.rm(serverDir, { recursive: true, force: true });
+            await promises_1.default.rm(serverDir, { recursive: true, force: true });
         });
     }
 }

package/lib/commands/clear.js

@@ -8,13 +8,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.clear = clear;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const clearPath_1 = tslib_1.__importDefault(require("./utils/clearPath"));
 async function removePath(entry) {
-    if (!(await fs_extra_1.default.pathExists(entry.path))) {
+    if (!(await (0, fs_1.pathExists)(entry.path))) {
         return;
     }
     try {
@@ -27,7 +27,7 @@ async function removePath(entry) {
     }
 }
 async function clear(siteDirParam = '.') {
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     const generatedFolder = {
         path: node_path_1.default.join(siteDir, utils_1.GENERATED_FILES_DIR_NAME),
         description: 'generated folder',

package/lib/commands/deploy.js

@@ -8,12 +8,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deploy = deploy;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const node_os_1 = tslib_1.__importDefault(require("node:os"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const execa_1 = require("execa");
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const site_1 = require("../server/site");
 const build_1 = require("./build/build");
 // GIT_PASS env variable should not appear in logs
@@ -51,7 +52,7 @@ async function hasGit() {
     return (await exec('git', ['--version'], { failfast: false })).exitCode === 0;
 }
 async function deploy(siteDirParam = '.', cliOptions = {}) {
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     const { outDir, siteConfig, siteConfigPath } = await (0, site_1.loadContext)({
         siteDir,
         config: cliOptions.config,
@@ -146,7 +147,7 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
     const runDeploy = async (outputDirectory) => {
         const targetDirectory = cliOptions.targetDir ?? '.';
         const fromPath = outputDirectory;
-        const toPath = await fs_extra_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), `${projectName}-${deploymentBranch}`));
+        const toPath = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), `${projectName}-${deploymentBranch}`));
         process.chdir(toPath);
         // Clones the repo into the temp folder and checks out the target branch.
         // If the branch doesn't exist, it creates a new one based on the
@@ -168,7 +169,11 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
         await exec('git', ['rm', '-rf', targetDirectory], { log: false });
         const targetPath = node_path_1.default.join(toPath, targetDirectory);
         try {
-            await fs_extra_1.default.copy(fromPath, targetPath);
+            // verbatimSymlinks: keep relative symlinks relative
+            await promises_1.default.cp(fromPath, targetPath, {
+                recursive: true,
+                verbatimSymlinks: true,
+            });
         }
         catch (err) {
             throw new Error(`Failed to copy build assets from path=${fromPath} to path=${targetPath}.`, { cause: err });

package/lib/commands/external.js

@@ -7,12 +7,11 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.externalCommand = externalCommand;
-const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const fs_1 = require("@docusaurus/fs");
 const site_1 = require("../server/site");
 const init_1 = require("../server/plugins/init");
 async function externalCommand({ cli, siteDir: siteDirInput, config, }) {
-    const siteDir = await fs_extra_1.default.realpath(siteDirInput);
+    const siteDir = await (0, fs_1.realpath)(siteDirInput);
     const context = await (0, site_1.loadContext)({ siteDir, config });
     const plugins = await (0, init_1.initPlugins)(context);
     // Plugin Lifecycle - extendCli.

package/lib/commands/serve.js

@@ -8,13 +8,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serve = serve;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const node_http_1 = tslib_1.__importDefault(require("node:http"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const serve_handler_1 = tslib_1.__importDefault(require("serve-handler"));
 const utils_common_1 = require("@docusaurus/utils-common");
+const fs_1 = require("@docusaurus/fs");
 const openBrowser_1 = tslib_1.__importDefault(require("./utils/openBrowser/openBrowser"));
 const config_1 = require("../server/config");
 const build_1 = require("./build/build");
@@ -27,7 +27,7 @@ function redirect(res, location) {
     res.end();
 }
 async function serve(siteDirParam = '.', cliOptions = {}) {
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     const buildDir = cliOptions.dir ?? utils_1.DEFAULT_BUILD_DIR_NAME;
     const outDir = node_path_1.default.resolve(siteDir, buildDir);
     if (cliOptions.build) {

package/lib/commands/start/utils.js

@@ -8,11 +8,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createReloadableSite = createReloadableSite;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const node_url_1 = tslib_1.__importDefault(require("node:url"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
+const fs_1 = require("@docusaurus/fs");
 const getHostPort_1 = require("../../server/getHostPort");
 const site_1 = require("../../server/site");
 const pluginsUtils_1 = require("../../server/plugins/pluginsUtils");
@@ -47,7 +47,7 @@ async function createOpenUrlContext({ cliOptions, }) {
     return { host, port, getOpenUrl };
 }
 async function createLoadSiteParams({ siteDirParam, cliOptions, }) {
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     return {
         siteDir,
         config: cliOptions.config,

package/lib/commands/swizzle/actions.js

@@ -11,11 +11,12 @@ exports.getAction = getAction;
 exports.eject = eject;
 exports.wrap = wrap;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const glob_1 = require("@docusaurus/glob");
 const prompts_1 = require("./prompts");
 exports.SwizzleActions = ['wrap', 'eject'];
@@ -29,7 +30,7 @@ async function getAction(componentConfig, options) {
     return (0, prompts_1.askSwizzleAction)(componentConfig);
 }
 async function isDir(dirPath) {
-    return ((await fs_extra_1.default.pathExists(dirPath)) && (await fs_extra_1.default.stat(dirPath)).isDirectory());
+    return (await (0, fs_1.pathExists)(dirPath)) && (await promises_1.default.stat(dirPath)).isDirectory();
 }
 async function eject({ siteDir, themePath, componentName, typescript, }) {
     const fromPath = node_path_1.default.join(themePath, componentName);
@@ -58,12 +59,12 @@ async function eject({ siteDir, themePath, componentName, typescript, }) {
         throw new Error(logger_1.default.interpolate `No files to copy from path=${fromPath} with glob code=${globPatternPosix}`);
     }
     const toPath = node_path_1.default.join(siteDir, utils_1.THEME_PATH);
-    await fs_extra_1.default.ensureDir(toPath);
+    await promises_1.default.mkdir(toPath, { recursive: true });
     const createdFiles = await Promise.all(filesToCopy.map(async (sourceFile) => {
         const targetFile = node_path_1.default.join(toPath, node_path_1.default.relative(themePath, sourceFile));
         try {
-            const fileContents = await fs_extra_1.default.readFile(sourceFile, 'utf-8');
-            await fs_extra_1.default.outputFile(targetFile, fileContents.trimStart().replace(/^\/\*.+?\*\/\s*/ms, ''));
+            const fileContents = await promises_1.default.readFile(sourceFile, 'utf-8');
+            await (0, fs_1.outputFile)(targetFile, fileContents.trimStart().replace(/^\/\*.+?\*\/\s*/ms, ''));
         }
         catch (err) {
             logger_1.default.error `Could not copy file from path=${sourceFile} to path=${targetFile}`;
@@ -79,7 +80,7 @@ async function wrap({ siteDir, themePath, componentName: themeComponentName, typ
     const componentName = lodash_1.default.last(themeComponentName.split('/'));
     const wrapperComponentName = `${componentName}Wrapper`;
     const wrapperFileName = `${themeComponentName}${isDirectory ? '/index' : ''}${typescript ? '.tsx' : '.js'}`;
-    await fs_extra_1.default.ensureDir(node_path_1.default.resolve(siteDir, utils_1.THEME_PATH));
+    await promises_1.default.mkdir(node_path_1.default.resolve(siteDir, utils_1.THEME_PATH), { recursive: true });
     const toPath = node_path_1.default.resolve(siteDir, utils_1.THEME_PATH, wrapperFileName);
     const content = typescript
         ? `import type {ReactNode} from 'react';
@@ -107,6 +108,6 @@ export default function ${wrapperComponentName}(props) {
   );
 }
 `;
-    await fs_extra_1.default.outputFile(toPath, content);
+    await (0, fs_1.outputFile)(toPath, content);
     return { createdFiles: [toPath] };
 }

package/lib/commands/swizzle/components.js

@@ -11,11 +11,12 @@ exports.readComponentNames = readComponentNames;
 exports.getThemeComponents = getThemeComponents;
 exports.getComponentName = getComponentName;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const prompts_1 = require("./prompts");
 const common_1 = require("./common");
 const tables_1 = require("./tables");
@@ -42,13 +43,13 @@ function getMissingIntermediateComponentFolderNames(componentNames) {
 }
 const skipReadDirNames = ['__test__', '__tests__', '__mocks__', '__fixtures__'];
 async function readComponentNames(themePath) {
-    if (!(await fs_extra_1.default.pathExists(themePath))) {
+    if (!(await (0, fs_1.pathExists)(themePath))) {
         return [];
     }
     async function walk(dir) {
-        const files = await Promise.all((await fs_extra_1.default.readdir(dir)).flatMap(async (file) => {
+        const files = await Promise.all((await promises_1.default.readdir(dir)).flatMap(async (file) => {
             const fullPath = node_path_1.default.join(dir, file);
-            const stat = await fs_extra_1.default.stat(fullPath);
+            const stat = await promises_1.default.stat(fullPath);
             const isDir = stat.isDirectory();
             return { file, fullPath, isDir };
         }));

package/lib/commands/swizzle/index.js

@@ -8,8 +8,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.swizzle = swizzle;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const fs_1 = require("@docusaurus/fs");
 const themes_1 = require("./themes");
 const components_1 = require("./components");
 const tables_1 = require("./tables");
@@ -77,7 +77,7 @@ If you want to swizzle it, use the code=${'--danger'} flag, or confirm that you
     return undefined;
 }
 async function swizzle(themeNameParam = undefined, componentNameParam = undefined, siteDirParam = '.', optionsParam = {}) {
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     const options = (0, common_1.normalizeOptions)(optionsParam);
     const { list, danger } = options;
     const { plugins } = await (0, context_1.initSwizzleContext)(siteDir, options);

package/lib/commands/writeHeadingIds.js

@@ -8,10 +8,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeHeadingIds = writeHeadingIds;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const glob_1 = require("@docusaurus/glob");
+const fs_1 = require("@docusaurus/fs");
 const site_1 = require("../server/site");
 const init_1 = require("../server/plugins/init");
 function inferFallbackSyntax(_filepath) {
@@ -27,14 +28,14 @@ function getHeadingIdSyntax(filepath, options) {
     return options?.syntax ?? inferFallbackSyntax(filepath);
 }
 async function transformMarkdownFile(filepath, options) {
-    const content = await fs_extra_1.default.readFile(filepath, 'utf8');
+    const content = await promises_1.default.readFile(filepath, 'utf8');
     const syntax = getHeadingIdSyntax(filepath, options);
     const updatedContent = (0, utils_1.writeMarkdownHeadingId)(content, {
         ...options,
         syntax,
     });
     if (content !== updatedContent) {
-        await fs_extra_1.default.writeFile(filepath, updatedContent);
+        await promises_1.default.writeFile(filepath, updatedContent);
         return filepath;
     }
     return undefined;
@@ -66,14 +67,14 @@ function validateOptions(options) {
 }
 async function writeHeadingIds(siteDirParam = '.', files = [], options = {}) {
     validateOptions(options);
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     const patterns = files.length ? files : await getPathsToWatch(siteDir);
     const markdownFiles = await globMarkdownFiles(patterns);
     if (markdownFiles.length === 0) {
         logger_1.default.warn `No markdown files found in siteDir path=${siteDir} for patterns: ${patterns}`;
         return;
     }
-    const result = await Promise.all(markdownFiles.map((p) => transformMarkdownFile(p, options)));
+    const result = await Promise.all(markdownFiles.map((p) => (0, fs_1.queueFileOperation)(() => transformMarkdownFile(p, options))));
     const pathsModified = result.filter(Boolean);
     if (pathsModified.length) {
         logger_1.default.success `Heading ids added to Markdown files (number=${`${pathsModified.length}/${markdownFiles.length}`} files): ${pathsModified}`;

package/lib/commands/writeTranslations.js

@@ -8,9 +8,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeTranslations = writeTranslations;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const glob_1 = require("@docusaurus/glob");
+const fs_1 = require("@docusaurus/fs");
 const site_1 = require("../server/site");
 const init_1 = require("../server/plugins/init");
 const translations_1 = require("../server/translations/translations");
@@ -54,7 +54,7 @@ async function writePluginTranslationFiles({ localizationDir, plugin, options, }
     }
 }
 async function writeTranslations(siteDirParam = '.', options = {}) {
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
+    const siteDir = await (0, fs_1.realpath)(siteDirParam);
     const context = await (0, site_1.loadContext)({
         siteDir,
         config: options.config,

package/lib/server/config.js

@@ -9,14 +9,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadSiteConfig = loadSiteConfig;
 const tslib_1 = require("tslib");
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const configValidation_1 = require("./configValidation");
 async function findConfig(siteDir) {
     // We could support .mjs, .ts, etc. in the future
     const candidates = ['.ts', '.mts', '.cts', '.js', '.mjs', '.cjs'].map((ext) => utils_1.DEFAULT_CONFIG_FILE_NAME + ext);
-    const configPath = await (0, utils_1.findAsyncSequential)(candidates.map((file) => node_path_1.default.join(siteDir, file)), fs_extra_1.default.pathExists);
+    const configPath = await (0, utils_1.findAsyncSequential)(candidates.map((file) => node_path_1.default.join(siteDir, file)), fs_1.pathExists);
     if (!configPath) {
         const relativeSiteDir = node_path_1.default.relative(process.cwd(), siteDir);
         throw new Error(logger_1.default.interpolate `No config file found in site dir code=${relativeSiteDir}.
@@ -30,7 +30,7 @@ async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
     const siteConfigPath = customConfigFilePath
         ? node_path_1.default.resolve(siteDir, customConfigFilePath)
         : await findConfig(siteDir);
-    if (!(await fs_extra_1.default.pathExists(siteConfigPath))) {
+    if (!(await (0, fs_1.pathExists)(siteConfigPath))) {
         throw new Error(`Config file at "${siteConfigPath}" not found.`);
     }
     const importedConfig = await (0, utils_1.loadFreshModule)(siteConfigPath, { default: true });

package/lib/server/i18n.js

@@ -11,10 +11,10 @@ exports.getLocaleList = getLocaleList;
 exports.loadI18n = loadI18n;
 const tslib_1 = require("tslib");
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const combine_promises_1 = tslib_1.__importDefault(require("combine-promises"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 function inferLanguageDisplayName(locale) {
     const tryLocale = (l) => {
         try {
@@ -112,7 +112,7 @@ async function loadI18n({ siteDir, config, currentLocale, automaticBaseUrlLocali
         // By default, translations will be enabled if i18n/<locale> dir exists
         async function inferTranslate() {
             const localizationDir = node_path_1.default.resolve(siteDir, i18nConfig.path, localeConfig.path);
-            return fs_extra_1.default.pathExists(localizationDir);
+            return (0, fs_1.pathExists)(localizationDir);
         }
         function getInferredBaseUrl() {
             const addLocaleSegment = locale !== i18nConfig.defaultLocale &&

package/lib/server/siteMetadata.js

@@ -10,13 +10,14 @@ exports.tryLoadSitePackageJson = tryLoadSitePackageJson;
 exports.loadPluginVersion = loadPluginVersion;
 exports.createSiteMetadata = createSiteMetadata;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 async function tryLoadPackageJson(packageJsonPath) {
-    if (await fs_extra_1.default.pathExists(packageJsonPath)) {
+    if (await (0, fs_1.pathExists)(packageJsonPath)) {
         try {
-            return (await fs_extra_1.default.readJSON(packageJsonPath));
+            return (await (0, fs_1.readJSON)(packageJsonPath));
         }
         catch (error) {
             throw new Error(`Couldn't load package.json file at ${packageJsonPath}`, {
@@ -33,8 +34,8 @@ async function loadPluginVersion(pluginPath, siteDir) {
     let potentialPluginPackageJsonDirectory = node_path_1.default.dirname(pluginPath);
     while (potentialPluginPackageJsonDirectory !== '/') {
         const packageJsonPath = node_path_1.default.join(potentialPluginPackageJsonDirectory, 'package.json');
-        if ((await fs_extra_1.default.pathExists(packageJsonPath)) &&
-            (await fs_extra_1.default.lstat(packageJsonPath)).isFile()) {
+        if ((await (0, fs_1.pathExists)(packageJsonPath)) &&
+            (await promises_1.default.lstat(packageJsonPath)).isFile()) {
             if (potentialPluginPackageJsonDirectory === siteDir) {
                 // If the plugin belongs to the same docusaurus project, we classify it
                 // as local plugin.

package/lib/server/translations/translations.js

@@ -16,11 +16,11 @@ exports.applyDefaultCodeTranslations = applyDefaultCodeTranslations;
 exports.loadSiteCodeTranslations = loadSiteCodeTranslations;
 const tslib_1 = require("tslib");
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
+const fs_1 = require("@docusaurus/fs");
 const TranslationFileContentSchema = utils_validation_1.Joi.object()
     .pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
     message: utils_validation_1.Joi.string().allow('').required(),
@@ -35,9 +35,9 @@ function ensureTranslationFileContent(content) {
     });
 }
 async function readTranslationFileContent(filePath) {
-    if (await fs_extra_1.default.pathExists(filePath)) {
+    if (await (0, fs_1.pathExists)(filePath)) {
         try {
-            const content = await fs_extra_1.default.readJSON(filePath);
+            const content = await (0, fs_1.readJSON)(filePath);
             ensureTranslationFileContent(content);
             return content;
         }
@@ -83,7 +83,7 @@ Maybe you should remove them? ${unknownKeys}`;
     // Avoid creating empty translation files
     if (Object.keys(mergedContent).length > 0) {
         logger_1.default.info `number=${Object.keys(mergedContent).length} translations will be written at path=${(0, utils_1.toMessageRelativeFilePath)(filePath)}.`;
-        await fs_extra_1.default.outputFile(filePath, `${JSON.stringify(mergedContent, null, 2)}\n`);
+        await (0, fs_1.outputFile)(filePath, `${JSON.stringify(mergedContent, null, 2)}\n`);
     }
 }
 function getCodeTranslationsFilePath(context) {

package/lib/ssg/ssgParams.js

@@ -8,12 +8,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSSGParams = createSSGParams;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const utils_1 = require("@docusaurus/utils");
 const logger_1 = require("@docusaurus/logger");
+const fs_1 = require("@docusaurus/fs");
 const ssgTemplate_html_1 = tslib_1.__importDefault(require("./ssgTemplate.html"));
 async function createSSGParams({ props, serverBundlePath, clientManifestPath, }) {
-    const manifest = await logger_1.PerfLogger.async('Read client manifest', () => fs_extra_1.default.readJSON(clientManifestPath, 'utf-8'));
+    const manifest = await logger_1.PerfLogger.async('Read client manifest', () => (0, fs_1.readJSON)(clientManifestPath));
     const params = {
         trailingSlash: props.siteConfig.trailingSlash,
         outDir: props.outDir,

package/lib/ssg/ssgRenderer.js

@@ -11,7 +11,7 @@ const tslib_1 = require("tslib");
 const node_module_1 = require("node:module");
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const node_vm_1 = require("node:vm");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const p_map_1 = tslib_1.__importDefault(require("p-map"));
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
 const bundler_1 = require("@docusaurus/bundler");
@@ -29,7 +29,7 @@ function evaluateServerBundle({ source, serverBundlePath, }) {
     return module.exports;
 }
 async function loadAppRenderer({ serverBundlePath, }) {
-    const source = await logger_1.PerfLogger.async(`Load server bundle`, () => fs_extra_1.default.readFile(serverBundlePath, 'utf8'));
+    const source = await logger_1.PerfLogger.async(`Load server bundle`, () => promises_1.default.readFile(serverBundlePath, 'utf8'));
     const serverEntry = await logger_1.PerfLogger.async(`Evaluate server bundle`, () => evaluateServerBundle({ source, serverBundlePath }));
     if (!serverEntry?.default || typeof serverEntry.default !== 'function') {
         throw new Error(`Docusaurus Bug: server bundle export from "${serverBundlePath}" must be a function that renders the Docusaurus React app, not ${typeof serverEntry?.default}`);

package/lib/ssg/ssgUtils.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateHashRouterEntrypoint = generateHashRouterEntrypoint;
 exports.writeStaticFile = writeStaticFile;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 function pathnameToFilename({ pathname, trailingSlash, }) {
     const outputFileName = pathname.replace(/^[/\\]/, ''); // Remove leading slashes for webpack-dev-server
@@ -44,6 +44,6 @@ async function writeStaticFile({ content, pathname, params, }) {
         trailingSlash: params.trailingSlash,
     });
     const filePath = node_path_1.default.join(params.outDir, filename);
-    await fs_extra_1.default.ensureDir(node_path_1.default.dirname(filePath));
-    await fs_extra_1.default.writeFile(filePath, content);
+    await promises_1.default.mkdir(node_path_1.default.dirname(filePath), { recursive: true });
+    await promises_1.default.writeFile(filePath, content);
 }

package/lib/webpack/aliases/index.js

@@ -11,11 +11,12 @@ exports.createAliasesForTheme = createAliasesForTheme;
 exports.loadThemeAliases = loadThemeAliases;
 exports.loadDocusaurusAliases = loadDocusaurusAliases;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 const glob_1 = require("@docusaurus/glob");
+const fs_1 = require("@docusaurus/fs");
 const ThemeFallbackDir = node_path_1.default.join(__dirname, '../../client/theme-fallback');
 /**
  * Order of Webpack aliases is important because one alias can shadow another.
@@ -35,7 +36,7 @@ function sortAliases(aliases) {
     return Object.fromEntries(entries);
 }
 async function createAliasesForTheme(themePath, addOriginalAlias) {
-    if (!(await fs_extra_1.default.pathExists(themePath))) {
+    if (!(await (0, fs_1.pathExists)(themePath))) {
         return {};
     }
     const themeComponentFiles = await (0, glob_1.glob)(['**/*.{js,jsx,ts,tsx}'], {
@@ -102,7 +103,7 @@ async function loadDocusaurusAliases() {
     const dirPath = node_path_1.default.resolve(__dirname, '../../client/exports');
     const extensions = ['.js', '.ts', '.tsx'];
     const aliases = {};
-    (await fs_extra_1.default.readdir(dirPath))
+    (await promises_1.default.readdir(dirPath))
         .filter((fileName) => extensions.includes(node_path_1.default.extname(fileName)))
         .forEach((fileName) => {
         const fileNameWithoutExtension = node_path_1.default.basename(fileName, node_path_1.default.extname(fileName));

package/lib/webpack/base.js

@@ -10,11 +10,11 @@ exports.clientDir = void 0;
 exports.excludeJS = excludeJS;
 exports.createBaseConfig = createBaseConfig;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const babel_1 = require("@docusaurus/babel");
 const bundler_1 = require("@docusaurus/bundler");
 const utils_1 = require("@docusaurus/utils");
+const fs_1 = require("@docusaurus/fs");
 const aliases_1 = require("./aliases");
 const BundlerCPUProfilerPlugin_1 = require("./plugins/BundlerCPUProfilerPlugin");
 const CSS_REGEX = /\.css$/i;
@@ -155,7 +155,7 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
             modules: [
                 node_path_1.default.resolve(__dirname, '..', '..', 'node_modules'),
                 'node_modules',
-                node_path_1.default.resolve(await fs_extra_1.default.realpath(process.cwd()), 'node_modules'),
+                node_path_1.default.resolve(await (0, fs_1.realpath)(process.cwd()), 'node_modules'),
             ],
         },
         resolveLoader: {

package/lib/webpack/plugins/BundlerCPUProfilerPlugin.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BundlerCPUProfilerPlugin = void 0;
 const tslib_1 = require("tslib");
 const node_inspector_1 = tslib_1.__importDefault(require("node:inspector"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 // Bundle CPU profiling plugin, contributed by the Rspack team
 // Can be opened in https://www.speedscope.app/
 // See also https://github.com/jerrykingxyz/docusaurus/pull/1
@@ -33,7 +33,7 @@ class BundlerCPUProfilerPlugin {
                     console.error('Failed to generate JS CPU profile:', error);
                     return;
                 }
-                fs_extra_1.default.writeFile(this.output, JSON.stringify(param.profile)).catch(console.error);
+                promises_1.default.writeFile(this.output, JSON.stringify(param.profile)).catch(console.error);
             });
         });
     }

package/lib/webpack/plugins/StaticDirectoriesCopyPlugin.js

@@ -9,8 +9,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStaticDirectoriesCopyPlugin = createStaticDirectoriesCopyPlugin;
 const tslib_1 = require("tslib");
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const bundler_1 = require("@docusaurus/bundler");
+const fs_1 = require("@docusaurus/fs");
 async function createStaticDirectoriesCopyPlugin({ props, }) {
     const CopyPlugin = await (0, bundler_1.getCopyPlugin)({
         currentBundler: props.currentBundler,
@@ -22,8 +23,8 @@ async function createStaticDirectoriesCopyPlugin({ props, }) {
     // in the first place (the default option should always "work").
     const staticDirectories = (await Promise.all(staticDirectoriesOption.map(async (dir) => {
         const staticDir = node_path_1.default.resolve(siteDir, dir);
-        if ((await fs_extra_1.default.pathExists(staticDir)) &&
-            (await fs_extra_1.default.readdir(staticDir)).length > 0) {
+        if ((await (0, fs_1.pathExists)(staticDir)) &&
+            (await promises_1.default.readdir(staticDir)).length > 0) {
             return staticDir;
         }
         return '';

package/lib/webpack/utils/getHttpsConfig.js

@@ -8,10 +8,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = getHttpsConfig;
 const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const promises_1 = tslib_1.__importDefault(require("node:fs/promises"));
 const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const node_crypto_1 = tslib_1.__importDefault(require("node:crypto"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const fs_1 = require("@docusaurus/fs");
 // Ensure the certificate and key provided are valid and if not
 // throw an easy to debug error.
 //
@@ -47,14 +48,14 @@ function getExplicitHttps(options) {
             : undefined));
 }
 async function readCryptoFile(filepath, source) {
-    if (!(await fs_extra_1.default.pathExists(filepath))) {
+    if (!(await (0, fs_1.pathExists)(filepath))) {
         throw new Error(logger_1.default.interpolate `You specified ${source}, but file at path path=${filepath} can't be found.`);
     }
     try {
         return {
             path: filepath,
             source,
-            content: await fs_extra_1.default.readFile(filepath),
+            content: await promises_1.default.readFile(filepath),
         };
     }
     catch (error) {
@@ -96,7 +97,7 @@ You only provided a ${cert ? 'certificate' : 'key'} (with ${fileProvided.source}
 // Return cert files if provided via CLI or env, otherwise just true or false.
 // CLI options take precedence over env vars.
 async function getHttpsConfig(options = {}) {
-    const cwd = await fs_extra_1.default.realpath(process.cwd());
+    const cwd = await (0, fs_1.realpath)(process.cwd());
     const [cert, key] = await Promise.all([
         getCert(options, cwd),
         getKeyFile(options, cwd),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "4.0.0-canary-6885",
+  "version": "4.0.0-canary-6888",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,14 +33,15 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "4.0.0-canary-6885",
-    "@docusaurus/bundler": "4.0.0-canary-6885",
-    "@docusaurus/glob": "4.0.0-canary-6885",
-    "@docusaurus/logger": "4.0.0-canary-6885",
-    "@docusaurus/mdx-loader": "4.0.0-canary-6885",
-    "@docusaurus/utils": "4.0.0-canary-6885",
-    "@docusaurus/utils-common": "4.0.0-canary-6885",
-    "@docusaurus/utils-validation": "4.0.0-canary-6885",
+    "@docusaurus/babel": "4.0.0-canary-6888",
+    "@docusaurus/bundler": "4.0.0-canary-6888",
+    "@docusaurus/fs": "4.0.0-canary-6888",
+    "@docusaurus/glob": "4.0.0-canary-6888",
+    "@docusaurus/logger": "4.0.0-canary-6888",
+    "@docusaurus/mdx-loader": "4.0.0-canary-6888",
+    "@docusaurus/utils": "4.0.0-canary-6888",
+    "@docusaurus/utils-common": "4.0.0-canary-6888",
+    "@docusaurus/utils-validation": "4.0.0-canary-6888",
     "boxen": "^9.0.0",
     "cli-table3": "^0.6.5",
     "combine-promises": "^1.2.0",
@@ -49,7 +50,6 @@
     "escape-html": "^1.0.3",
     "eta": "^4.6.0",
     "execa": "^10.0.1",
-    "fs-extra": "^11.4.0",
     "html-tags": "^5.1.0",
     "leven": "^4.1.0",
     "lodash": "^4.18.1",
@@ -72,8 +72,8 @@
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "4.0.0-canary-6885",
-    "@docusaurus/types": "4.0.0-canary-6885",
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6888",
+    "@docusaurus/types": "4.0.0-canary-6888",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/escape-html": "^1.0.4",
     "@types/history": "^4.7.11",
@@ -87,7 +87,7 @@
     "utility-types": "^3.11.0"
   },
   "peerDependencies": {
-    "@docusaurus/faster": "4.0.0-canary-6885",
+    "@docusaurus/faster": "4.0.0-canary-6888",
     "@mdx-js/react": "^3.1.1",
     "react": "^19.3.0",
     "react-dom": "^19.3.0"
@@ -100,5 +100,5 @@
   "engines": {
     "node": ">=24.21"
   },
-  "gitHead": "7d9062fc85a858f25784b589ba163999eb653232"
+  "gitHead": "5019a662590dcb2722926890c1ade27194bc3b70"
 }