@docusaurus/core 4.0.0-canary-6870 → 4.0.0-canary-6872

package/bin/beforeCli.mjs

@@ -8,8 +8,8 @@
 // @ts-check
 
 import fs from 'fs-extra';
-import path from 'path';
-import {createRequire} from 'module';
+import path from 'node:path';
+import {createRequire} from 'node:module';
 import {execa} from 'execa';
 import {logger} from '@docusaurus/logger';
 import semver from 'semver';

package/lib/commands/build/buildLocale.js

@@ -9,7 +9,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 path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const bundler_1 = require("@docusaurus/bundler");
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
@@ -96,7 +96,7 @@ async function buildLocale({ siteDir, locale, cliOptions, }) {
     await logger_1.PerfLogger.async('postBuild()', () => executePluginsPostBuild({ plugins, props, collectedData }));
     // TODO execute this in parallel to postBuild?
     await logger_1.PerfLogger.async('Broken links checker', () => executeBrokenLinksCheck({ props, collectedData }));
-    logger_1.default.success `Generated static files in path=${path_1.default.relative(process.cwd(), outDir)}.`;
+    logger_1.default.success `Generated static files in path=${node_path_1.default.relative(process.cwd(), outDir)}.`;
 }
 async function executePluginsPostBuild({ plugins, props, collectedData, }) {
     const routesBuildMetadata = lodash_1.default.mapValues(collectedData, (d) => d.metadata.public);
@@ -163,7 +163,7 @@ async function cleanupServerBundle(serverBundlePath) {
     else {
         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 = path_1.default.dirname(serverBundlePath);
+            const serverDir = node_path_1.default.dirname(serverBundlePath);
             await fs_extra_1.default.rm(serverDir, { recursive: true, force: true });
         });
     }

package/lib/commands/clear.js

@@ -9,7 +9,7 @@ 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 path_1 = tslib_1.__importDefault(require("path"));
+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 clearPath_1 = tslib_1.__importDefault(require("./utils/clearPath"));
@@ -19,7 +19,7 @@ async function removePath(entry) {
     }
     try {
         await (0, clearPath_1.default)(entry.path);
-        logger_1.default.success `Removed the ${entry.description} at path=${path_1.default.relative(process.cwd(), entry.path)}.`;
+        logger_1.default.success `Removed the ${entry.description} at path=${node_path_1.default.relative(process.cwd(), entry.path)}.`;
     }
     catch (err) {
         logger_1.default.error `Could not remove the ${entry.description} at path=${entry.path}.`;
@@ -29,16 +29,16 @@ async function removePath(entry) {
 async function clear(siteDirParam = '.') {
     const siteDir = await fs_extra_1.default.realpath(siteDirParam);
     const generatedFolder = {
-        path: path_1.default.join(siteDir, utils_1.GENERATED_FILES_DIR_NAME),
+        path: node_path_1.default.join(siteDir, utils_1.GENERATED_FILES_DIR_NAME),
         description: 'generated folder',
     };
     const buildFolder = {
-        path: path_1.default.join(siteDir, utils_1.DEFAULT_BUILD_DIR_NAME),
+        path: node_path_1.default.join(siteDir, utils_1.DEFAULT_BUILD_DIR_NAME),
         description: 'build output folder',
     };
     // In Yarn PnP, cache is stored in `.yarn/.cache` because n_m doesn't exist
     const cacheFolders = ['node_modules', '.yarn'].map((p) => ({
-        path: path_1.default.join(siteDir, p, '.cache'),
+        path: node_path_1.default.join(siteDir, p, '.cache'),
         description: 'bundler persistent cache folder',
     }));
     await Promise.all([generatedFolder, buildFolder, ...cacheFolders].map(removePath));

package/lib/commands/deploy.js

@@ -9,8 +9,8 @@ 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 path_1 = tslib_1.__importDefault(require("path"));
-const os_1 = tslib_1.__importDefault(require("os"));
+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");
@@ -146,7 +146,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(path_1.default.join(os_1.default.tmpdir(), `${projectName}-${deploymentBranch}`));
+        const toPath = await fs_extra_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
@@ -166,7 +166,7 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
         }
         // Clear out any existing contents in the target directory
         await exec('git', ['rm', '-rf', targetDirectory], { log: false });
-        const targetPath = path_1.default.join(toPath, targetDirectory);
+        const targetPath = node_path_1.default.join(toPath, targetDirectory);
         try {
             await fs_extra_1.default.copy(fromPath, targetPath);
         }

package/lib/commands/serve.js

@@ -9,8 +9,8 @@ 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 http_1 = tslib_1.__importDefault(require("http"));
-const path_1 = tslib_1.__importDefault(require("path"));
+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"));
@@ -29,7 +29,7 @@ function redirect(res, location) {
 async function serve(siteDirParam = '.', cliOptions = {}) {
     const siteDir = await fs_extra_1.default.realpath(siteDirParam);
     const buildDir = cliOptions.dir ?? utils_1.DEFAULT_BUILD_DIR_NAME;
-    const outDir = path_1.default.resolve(siteDir, buildDir);
+    const outDir = node_path_1.default.resolve(siteDir, buildDir);
     if (cliOptions.build) {
         await (0, build_1.build)(siteDir, {
             config: cliOptions.config,
@@ -45,7 +45,7 @@ async function serve(siteDirParam = '.', cliOptions = {}) {
         customConfigFilePath: cliOptions.config,
     });
     const servingUrl = `http://${host}:${port}`;
-    const server = http_1.default.createServer((req, res) => {
+    const server = node_http_1.default.createServer((req, res) => {
         // Automatically redirect requests to /baseUrl/
         if (!req.url?.startsWith(baseUrl)) {
             redirect(res, baseUrl);

package/lib/commands/start/utils.js

@@ -9,7 +9,7 @@ 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 url_1 = tslib_1.__importDefault(require("url"));
+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"));
@@ -23,7 +23,7 @@ const pluginsUtils_1 = require("../../server/plugins/pluginsUtils");
 function getOpenUrlOrigin(protocol, host, port) {
     const isUnspecifiedHost = host === '0.0.0.0' || host === '::';
     const prettyHost = isUnspecifiedHost ? 'localhost' : host;
-    const localUrlForBrowser = url_1.default.format({
+    const localUrlForBrowser = node_url_1.default.format({
         protocol,
         hostname: prettyHost,
         port,

package/lib/commands/start/watcher.js

@@ -10,7 +10,7 @@ exports.createPollingOptions = createPollingOptions;
 exports.getPluginPathsToWatch = getPluginPathsToWatch;
 exports.setupSiteFileWatchers = setupSiteFileWatchers;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const glob_1 = require("@docusaurus/glob");
 const utils_1 = require("@docusaurus/utils");
 function createPollingOptions(cliOptions) {
@@ -44,8 +44,8 @@ function getSitePathsToWatch({ props }) {
 }
 function getPluginPathsToWatch({ siteDir, plugin, }) {
     const normalizeToSiteDir = (filepath) => {
-        if (filepath && path_1.default.isAbsolute(filepath)) {
-            return (0, utils_1.posixPath)(path_1.default.relative(siteDir, filepath));
+        if (filepath && node_path_1.default.isAbsolute(filepath)) {
+            return (0, utils_1.posixPath)(node_path_1.default.relative(siteDir, filepath));
         }
         return (0, utils_1.posixPath)(filepath);
     };

package/lib/commands/start/webpack.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createWebpackDevServer = createWebpackDevServer;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const bundler_1 = require("@docusaurus/bundler");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
@@ -71,7 +71,7 @@ async function createDevServerConfig({ cliOptions, props, host, port, }) {
         },
         static: siteConfig.staticDirectories.map((dir) => ({
             publicPath: baseUrl,
-            directory: path_1.default.resolve(siteDir, dir),
+            directory: node_path_1.default.resolve(siteDir, dir),
             watch: {
                 // Useful options for our own monorepo using symlinks!
                 // See https://github.com/webpack/webpack/issues/11612#issuecomment-879259806

package/lib/commands/swizzle/actions.js

@@ -12,7 +12,7 @@ exports.eject = eject;
 exports.wrap = wrap;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
+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");
@@ -32,11 +32,11 @@ async function isDir(dirPath) {
     return ((await fs_extra_1.default.pathExists(dirPath)) && (await fs_extra_1.default.stat(dirPath)).isDirectory());
 }
 async function eject({ siteDir, themePath, componentName, typescript, }) {
-    const fromPath = path_1.default.join(themePath, componentName);
+    const fromPath = node_path_1.default.join(themePath, componentName);
     const isDirectory = await isDir(fromPath);
     const globPattern = isDirectory
         ? // Do we really want to copy all components?
-            path_1.default.join(fromPath, '**/*')
+            node_path_1.default.join(fromPath, '**/*')
         : `${fromPath}.*`;
     const globPatternPosix = (0, utils_1.posixPath)(globPattern);
     const filesToCopy = await (0, glob_1.glob)(globPatternPosix, {
@@ -57,10 +57,10 @@ async function eject({ siteDir, themePath, componentName, typescript, }) {
         // This should never happen
         throw new Error(logger_1.default.interpolate `No files to copy from path=${fromPath} with glob code=${globPatternPosix}`);
     }
-    const toPath = path_1.default.join(siteDir, utils_1.THEME_PATH);
+    const toPath = node_path_1.default.join(siteDir, utils_1.THEME_PATH);
     await fs_extra_1.default.ensureDir(toPath);
     const createdFiles = await Promise.all(filesToCopy.map(async (sourceFile) => {
-        const targetFile = path_1.default.join(toPath, path_1.default.relative(themePath, 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, ''));
@@ -74,13 +74,13 @@ async function eject({ siteDir, themePath, componentName, typescript, }) {
     return { createdFiles };
 }
 async function wrap({ siteDir, themePath, componentName: themeComponentName, typescript, importType = 'original', }) {
-    const isDirectory = await isDir(path_1.default.join(themePath, themeComponentName));
+    const isDirectory = await isDir(node_path_1.default.join(themePath, themeComponentName));
     // Top/Parent/ComponentName => ComponentName
     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(path_1.default.resolve(siteDir, utils_1.THEME_PATH));
-    const toPath = path_1.default.resolve(siteDir, utils_1.THEME_PATH, wrapperFileName);
+    await fs_extra_1.default.ensureDir(node_path_1.default.resolve(siteDir, utils_1.THEME_PATH));
+    const toPath = node_path_1.default.resolve(siteDir, utils_1.THEME_PATH, wrapperFileName);
     const content = typescript
         ? `import React, {type ReactNode} from 'react';
 import ${componentName} from '@theme-${importType}/${themeComponentName}';

package/lib/commands/swizzle/components.js

@@ -12,7 +12,7 @@ exports.getThemeComponents = getThemeComponents;
 exports.getComponentName = getComponentName;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
+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");
@@ -47,7 +47,7 @@ async function readComponentNames(themePath) {
     }
     async function walk(dir) {
         const files = await Promise.all((await fs_extra_1.default.readdir(dir)).flatMap(async (file) => {
-            const fullPath = path_1.default.join(dir, file);
+            const fullPath = node_path_1.default.join(dir, file);
             const stat = await fs_extra_1.default.stat(fullPath);
             const isDir = stat.isDirectory();
             return { file, fullPath, isDir };
@@ -63,7 +63,7 @@ async function readComponentNames(themePath) {
             // TODO can probably be refactored
             /(?<!\.d)\.[jt]sx?$/.test(file.fullPath) &&
                 !/(?<!\.d)\.(?:test|tests|story|stories)\.[jt]sx?$/.test(file.fullPath)) {
-                const componentName = formatComponentName((0, utils_1.posixPath)(path_1.default.relative(themePath, file.fullPath)));
+                const componentName = formatComponentName((0, utils_1.posixPath)(node_path_1.default.relative(themePath, file.fullPath)));
                 return [{ ...file, componentName }];
             }
             return [];

package/lib/commands/swizzle/themes.js

@@ -11,7 +11,7 @@ exports.getThemeNames = getThemeNames;
 exports.getThemeName = getThemeName;
 exports.getThemePath = getThemePath;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+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 leven_1 = tslib_1.__importDefault(require("leven"));
@@ -88,9 +88,9 @@ function getThemePath({ plugins, themeName, typescript, }) {
     const pluginInstance = getPluginByThemeName(plugins, themeName);
     const themePath = typescript
         ? pluginInstance.instance.getTypeScriptThemePath &&
-            path_1.default.resolve(pluginInstance.instance.path, pluginInstance.instance.getTypeScriptThemePath())
+            node_path_1.default.resolve(pluginInstance.instance.path, pluginInstance.instance.getTypeScriptThemePath())
         : pluginInstance.instance.getThemePath &&
-            path_1.default.resolve(pluginInstance.instance.path, pluginInstance.instance.getThemePath());
+            node_path_1.default.resolve(pluginInstance.instance.path, pluginInstance.instance.getThemePath());
     if (!themePath) {
         logger_1.default.warn(typescript
             ? logger_1.default.interpolate `name=${themeName} does not provide TypeScript theme code via ${'getTypeScriptThemePath()'}.`

package/lib/commands/utils/clearPath.js

@@ -8,14 +8,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = clearPath;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const promises_1 = require("fs/promises");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const promises_1 = require("node:fs/promises");
 const logger_1 = require("@docusaurus/logger");
 /**
  * @param pathToClear
  */
 async function clearPath(pathToClear) {
-    return logger_1.PerfLogger.async(`clearPath ${path_1.default.relative(process.cwd(), pathToClear)}`, async () => {
+    return logger_1.PerfLogger.async(`clearPath ${node_path_1.default.relative(process.cwd(), pathToClear)}`, async () => {
         await (0, promises_1.rm)(pathToClear, { recursive: true, force: true });
     });
 }

package/lib/commands/utils/openBrowser/openBrowser.js

@@ -13,11 +13,11 @@ const tslib_1 = require("tslib");
 // See https://github.com/facebook/docusaurus/pull/10956
 // See https://github.com/facebook/create-react-app/blob/main/packages/react-dev-utils/openBrowser.js
 /* eslint-disable */
-const child_process_1 = require("child_process");
-const util_1 = require("util");
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
 const open_1 = tslib_1.__importStar(require("open"));
 const logger_1 = require("@docusaurus/logger");
-const execPromise = (0, util_1.promisify)(child_process_1.exec);
+const execPromise = (0, node_util_1.promisify)(node_child_process_1.exec);
 // Not sure if we need this, but let's keep a secret escape hatch
 // CRA/react-dev-utils supported BROWSER/BROWSER_ARGS
 const BrowserEnv = process.env.DOCUSAURUS_BROWSER;

package/lib/commands/writeTranslations.js

@@ -9,7 +9,7 @@ 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 path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const glob_1 = require("@docusaurus/glob");
 const site_1 = require("../server/site");
 const init_1 = require("../server/plugins/init");
@@ -17,7 +17,7 @@ const translations_1 = require("../server/translations/translations");
 const translationsExtractor_1 = require("../server/translations/translationsExtractor");
 function resolveThemeCommonLibDir() {
     try {
-        return path_1.default.dirname(require.resolve('@docusaurus/theme-common'));
+        return node_path_1.default.dirname(require.resolve('@docusaurus/theme-common'));
     }
     catch {
         return undefined;

package/lib/server/clientModules.js

@@ -8,12 +8,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAllClientModules = getAllClientModules;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 /**
  * Runs the `getClientModules` lifecycle. The returned file paths are all
  * absolute.
  */
 function getAllClientModules(plugins) {
-    return plugins.flatMap((plugin) => plugin.getClientModules?.().map((p) => path_1.default.resolve(plugin.path, p)) ??
+    return plugins.flatMap((plugin) => plugin.getClientModules?.().map((p) => node_path_1.default.resolve(plugin.path, p)) ??
         []);
 }

package/lib/server/codegen/codegenRoutes.js

@@ -11,8 +11,8 @@ exports.generateRoutesCode = generateRoutesCode;
 exports.generateRoutePropFilename = generateRoutePropFilename;
 exports.generateRouteFiles = generateRouteFiles;
 const tslib_1 = require("tslib");
-const querystring_1 = tslib_1.__importDefault(require("querystring"));
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_querystring_1 = tslib_1.__importDefault(require("node:querystring"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 /** Indents every line of `str` by one level. */
@@ -94,7 +94,7 @@ function getModulePath(target) {
     if (typeof target === 'string') {
         return target;
     }
-    const queryStr = target.query ? `?${querystring_1.default.stringify(target.query)}` : '';
+    const queryStr = target.query ? `?${node_querystring_1.default.stringify(target.query)}` : '';
     return `${target.path}${queryStr}`;
 }
 function genChunkNames(routeModule, prefix, name, res) {
@@ -221,9 +221,9 @@ async function generateRoutePropModule({ generatedFilesDir, route, plugin, }) {
     const moduleContent = JSON.stringify(route.props);
     // TODO we should aim to reduce this path length
     // This adds bytes to the global module registry
-    const relativePath = path_1.default.posix.join(plugin.name, plugin.id, 'p', generateRoutePropFilename(route));
-    const modulePath = path_1.default.posix.join(generatedFilesDir, relativePath);
-    const aliasedPath = path_1.default.posix.join('@generated', relativePath);
+    const relativePath = node_path_1.default.posix.join(plugin.name, plugin.id, 'p', generateRoutePropFilename(route));
+    const modulePath = node_path_1.default.posix.join(generatedFilesDir, relativePath);
+    const aliasedPath = node_path_1.default.posix.join('@generated', relativePath);
     await (0, utils_1.generate)(generatedFilesDir, modulePath, moduleContent);
     return aliasedPath;
 }

package/lib/server/config.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadSiteConfig = loadSiteConfig;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+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");
@@ -16,9 +16,9 @@ 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) => 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_extra_1.default.pathExists);
     if (!configPath) {
-        const relativeSiteDir = path_1.default.relative(process.cwd(), siteDir);
+        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}.
 Expected one of:${candidates.map(logger_1.default.code)}
 You can provide a custom config path with the code=${'--config'} option.
@@ -28,7 +28,7 @@ You can provide a custom config path with the code=${'--config'} option.
 }
 async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
     const siteConfigPath = customConfigFilePath
-        ? path_1.default.resolve(siteDir, customConfigFilePath)
+        ? node_path_1.default.resolve(siteDir, customConfigFilePath)
         : await findConfig(siteDir);
     if (!(await fs_extra_1.default.pathExists(siteConfigPath))) {
         throw new Error(`Config file at "${siteConfigPath}" not found.`);
@@ -37,6 +37,6 @@ async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
     const loadedConfig = typeof importedConfig === 'function'
         ? await importedConfig()
         : await importedConfig;
-    const siteConfig = (0, configValidation_1.validateConfig)(loadedConfig, path_1.default.relative(siteDir, siteConfigPath));
+    const siteConfig = (0, configValidation_1.validateConfig)(loadedConfig, node_path_1.default.relative(siteDir, siteConfigPath));
     return { siteConfig, siteConfigPath };
 }

package/lib/server/getHostPort.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getHostPort = getHostPort;
 const tslib_1 = require("tslib");
-const child_process_1 = require("child_process");
+const node_child_process_1 = require("node:child_process");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const detect_port_1 = tslib_1.__importDefault(require("detect-port"));
 const utils_1 = require("@docusaurus/utils");
@@ -22,11 +22,11 @@ function clearConsole() {
 }
 function getProcessForPort(port) {
     try {
-        const processId = (0, child_process_1.execSync)(`lsof -i:${port} -P -t -sTCP:LISTEN`, execOptions)
+        const processId = (0, node_child_process_1.execSync)(`lsof -i:${port} -P -t -sTCP:LISTEN`, execOptions)
             .split('\n')[0]
             .trim();
-        const directory = (0, child_process_1.execSync)(`lsof -p ${processId} | awk '$4=="cwd" {for (i=9; i<=NF; i++) printf "%s ", $i}'`, execOptions).trim();
-        const command = (0, child_process_1.execSync)(`ps -o command -p ${processId} | sed -n 2p`, execOptions).replace(/\n$/, '');
+        const directory = (0, node_child_process_1.execSync)(`lsof -p ${processId} | awk '$4=="cwd" {for (i=9; i<=NF; i++) printf "%s ", $i}'`, execOptions).trim();
+        const command = (0, node_child_process_1.execSync)(`ps -o command -p ${processId} | sed -n 2p`, execOptions).replace(/\n$/, '');
         return logger_1.default.interpolate `code=${command} subdue=${`(pid ${processId})`} in path=${directory}`;
     }
     catch {

package/lib/server/i18n.js

@@ -10,7 +10,7 @@ exports.getDefaultLocaleConfig = getDefaultLocaleConfig;
 exports.getLocaleList = getLocaleList;
 exports.loadI18n = loadI18n;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+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"));
@@ -111,7 +111,7 @@ async function loadI18n({ siteDir, config, currentLocale, automaticBaseUrlLocali
         };
         // By default, translations will be enabled if i18n/<locale> dir exists
         async function inferTranslate() {
-            const localizationDir = path_1.default.resolve(siteDir, i18nConfig.path, localeConfig.path);
+            const localizationDir = node_path_1.default.resolve(siteDir, i18nConfig.path, localeConfig.path);
             return fs_extra_1.default.pathExists(localizationDir);
         }
         function getInferredBaseUrl() {

package/lib/server/plugins/actions.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPluginActionsUtils = createPluginActionsUtils;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const utils_1 = require("@docusaurus/utils");
 const routeConfig_1 = require("./routeConfig");
 // TODO refactor historical action system and make this side-effect-free
@@ -21,15 +21,15 @@ async function createPluginActionsUtils({ plugin, generatedFilesDir, baseUrl, tr
     // TODO Docusaurus v4 breaking change
     //  module aliasing should be automatic
     //  we should never find local absolute FS paths in the codegen registry
-    const aliasedSource = (source) => `@generated/${(0, utils_1.posixPath)(path_1.default.relative(generatedFilesDir, source))}`;
+    const aliasedSource = (source) => `@generated/${(0, utils_1.posixPath)(node_path_1.default.relative(generatedFilesDir, source))}`;
     // TODO use @generated data dir here!
     // The module registry should not contain absolute paths
-    const dataDir = path_1.default.join(generatedFilesDir, plugin.name, pluginId);
+    const dataDir = node_path_1.default.join(generatedFilesDir, plugin.name, pluginId);
     const pluginRouteContext = {
         name: plugin.name,
         id: pluginId,
     };
-    const pluginRouteContextModulePath = path_1.default.join(dataDir, `__plugin.json`);
+    const pluginRouteContextModulePath = node_path_1.default.join(dataDir, `__plugin.json`);
     // TODO not ideal place to generate that file
     // move to codegen step instead!
     await (0, utils_1.generate)('/', pluginRouteContextModulePath, JSON.stringify(pluginRouteContext, null, 2));
@@ -51,7 +51,7 @@ async function createPluginActionsUtils({ plugin, generatedFilesDir, baseUrl, tr
             });
         },
         async createData(name, data) {
-            const modulePath = path_1.default.join(dataDir, name);
+            const modulePath = node_path_1.default.join(dataDir, name);
             const dataString = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
             await (0, utils_1.generate)(dataDir, name, dataString);
             return modulePath;

package/lib/server/plugins/configs.js

@@ -7,7 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadPluginConfigs = loadPluginConfigs;
-const module_1 = require("module");
+const node_module_1 = require("node:module");
 const utils_1 = require("@docusaurus/utils");
 const presets_1 = require("./presets");
 const moduleShorthand_1 = require("./moduleShorthand");
@@ -70,7 +70,7 @@ async function normalizePluginConfig(pluginConfig, configPath, pluginRequire) {
 async function loadPluginConfigs(context) {
     const preset = await (0, presets_1.loadPresets)(context);
     const { siteConfig, siteConfigPath } = context;
-    const pluginRequire = (0, module_1.createRequire)(siteConfigPath);
+    const pluginRequire = (0, node_module_1.createRequire)(siteConfigPath);
     function normalizeShorthand(pluginConfig, pluginType) {
         if (typeof pluginConfig === 'string') {
             return (0, moduleShorthand_1.resolveModuleName)(pluginConfig, pluginRequire, pluginType);

package/lib/server/plugins/init.js

@@ -9,8 +9,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.initPluginsConfigs = initPluginsConfigs;
 exports.initPlugins = initPlugins;
 const tslib_1 = require("tslib");
-const module_1 = require("module");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_module_1 = require("node:module");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const siteMetadata_1 = require("../siteMetadata");
@@ -45,7 +45,7 @@ function onlyInitializedPlugins(initPluginsConfigsResults) {
 async function initPluginsConfigs(context, pluginConfigs) {
     // We need to resolve plugins from the perspective of the site config, as if
     // we are using `require.resolve` on those module names.
-    const pluginRequire = (0, module_1.createRequire)(context.siteConfigPath);
+    const pluginRequire = (0, node_module_1.createRequire)(context.siteConfigPath);
     async function doLoadPluginVersion(normalizedPluginConfig) {
         if (normalizedPluginConfig.pluginModule?.path) {
             const pluginPath = pluginRequire.resolve(normalizedPluginConfig.pluginModule.path);
@@ -108,7 +108,7 @@ Note that even inline/anonymous plugin functions require a 'name' property.`);
             ...pluginInstance,
             options: pluginOptions,
             version: pluginVersion,
-            path: path_1.default.dirname(normalizedPluginConfig.entryPath),
+            path: node_path_1.default.dirname(normalizedPluginConfig.entryPath),
         };
         return {
             config: normalizedPluginConfig,

package/lib/server/plugins/presets.js

@@ -7,7 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadPresets = loadPresets;
-const module_1 = require("module");
+const node_module_1 = require("node:module");
 const utils_1 = require("@docusaurus/utils");
 const moduleShorthand_1 = require("./moduleShorthand");
 /**
@@ -17,7 +17,7 @@ const moduleShorthand_1 = require("./moduleShorthand");
 async function loadPresets(context) {
     // We need to resolve plugins from the perspective of the site config, as if
     // we are using `require.resolve` on those module names.
-    const presetRequire = (0, module_1.createRequire)(context.siteConfigPath);
+    const presetRequire = (0, node_module_1.createRequire)(context.siteConfigPath);
     const presets = context.siteConfig.presets.filter((p) => !!p);
     async function loadPreset(presetItem) {
         let presetModuleImport;

package/lib/server/plugins/synthetic.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBootstrapPlugin = createBootstrapPlugin;
 exports.createMDXFallbackPlugin = createMDXFallbackPlugin;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const mdx_loader_1 = require("@docusaurus/mdx-loader");
 /**
  * Make a synthetic plugin to:
@@ -62,7 +62,7 @@ async function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
     const mdxLoaderItem = await (0, mdx_loader_1.createMDXLoaderItem)({
         useCrossCompilerCache: siteConfig.future.faster.mdxCrossCompilerCache,
         admonitions: true,
-        staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
+        staticDirs: siteConfig.staticDirectories.map((dir) => node_path_1.default.resolve(siteDir, dir)),
         siteDir,
         // External MDX files are always meant to be imported as partials
         isMDXPartial: () => true,

package/lib/server/site.js

@@ -11,7 +11,7 @@ exports.loadSite = loadSite;
 exports.reloadSite = reloadSite;
 exports.reloadSitePlugin = reloadSitePlugin;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const utils_1 = require("@docusaurus/utils");
 const logger_1 = require("@docusaurus/logger");
 const combine_promises_1 = tslib_1.__importDefault(require("combine-promises"));
@@ -35,7 +35,7 @@ const siteMessages_1 = require("./siteMessages");
  */
 async function loadContext(params) {
     const { siteDir, outDir: baseOutDir = utils_1.DEFAULT_BUILD_DIR_NAME, locale, config: customConfigFilePath, automaticBaseUrlLocalizationDisabled, } = params;
-    const generatedFilesDir = path_1.default.resolve(siteDir, utils_1.GENERATED_FILES_DIR_NAME);
+    const generatedFilesDir = node_path_1.default.resolve(siteDir, utils_1.GENERATED_FILES_DIR_NAME);
     const { siteVersion, loadSiteConfig: { siteConfig: initialSiteConfig, siteConfigPath }, } = await (0, combine_promises_1.default)({
         siteVersion: (0, siteMetadata_1.tryLoadSitePackageJson)(siteDir).then((pkg) => pkg?.version),
         loadSiteConfig: (0, config_1.loadSiteConfig)({
@@ -74,8 +74,8 @@ async function loadContext(params) {
     // which is the case if an explicit locale baseUrl is not provided
     // but in practice a custom locale baseUrl could be anything now
     const outDirBaseUrl = baseUrl.replace(initialSiteConfig.baseUrl, '/');
-    const outDir = path_1.default.join(path_1.default.resolve(siteDir, baseOutDir), outDirBaseUrl);
-    const localizationDir = path_1.default.resolve(siteDir, i18n.path, (0, utils_1.getLocaleConfig)(i18n).path);
+    const outDir = node_path_1.default.join(node_path_1.default.resolve(siteDir, baseOutDir), outDirBaseUrl);
+    const localizationDir = node_path_1.default.resolve(siteDir, i18n.path, (0, utils_1.getLocaleConfig)(i18n).path);
     const siteConfig = {
         ...initialSiteConfig,
         url: localeConfig.url,

package/lib/server/siteMessages.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.collectAllSiteMessages = collectAllSiteMessages;
 exports.emitSiteMessages = emitSiteMessages;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const babel_1 = require("@docusaurus/babel");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
@@ -21,7 +21,7 @@ const uselessBabelConfigMessages = async ({ site }) => {
             return [
                 {
                     type: 'warning',
-                    message: `Your site is using the SWC js loader. You can safely remove the Babel config file at ${logger_1.default.code(path_1.default.relative(process.cwd(), babelConfigFilePath))}.`,
+                    message: `Your site is using the SWC js loader. You can safely remove the Babel config file at ${logger_1.default.code(node_path_1.default.relative(process.cwd(), babelConfigFilePath))}.`,
                 },
             ];
         }

package/lib/server/siteMetadata.js

@@ -11,7 +11,7 @@ exports.loadPluginVersion = loadPluginVersion;
 exports.createSiteMetadata = createSiteMetadata;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const utils_1 = require("@docusaurus/utils");
 async function tryLoadPackageJson(packageJsonPath) {
     if (await fs_extra_1.default.pathExists(packageJsonPath)) {
@@ -27,12 +27,12 @@ async function tryLoadPackageJson(packageJsonPath) {
     return undefined;
 }
 async function tryLoadSitePackageJson(siteDir) {
-    return tryLoadPackageJson(path_1.default.join(siteDir, 'package.json'));
+    return tryLoadPackageJson(node_path_1.default.join(siteDir, 'package.json'));
 }
 async function loadPluginVersion(pluginPath, siteDir) {
-    let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
+    let potentialPluginPackageJsonDirectory = node_path_1.default.dirname(pluginPath);
     while (potentialPluginPackageJsonDirectory !== '/') {
-        const packageJsonPath = path_1.default.join(potentialPluginPackageJsonDirectory, 'package.json');
+        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 (potentialPluginPackageJsonDirectory === siteDir) {
@@ -47,7 +47,7 @@ async function loadPluginVersion(pluginPath, siteDir) {
                 version: packageJson?.version,
             };
         }
-        potentialPluginPackageJsonDirectory = path_1.default.dirname(potentialPluginPackageJsonDirectory);
+        potentialPluginPackageJsonDirectory = node_path_1.default.dirname(potentialPluginPackageJsonDirectory);
     }
     // In the case where a plugin is a path where no parent directory contains
     // package.json, we can only classify it as local. Could happen if one puts a

package/lib/server/translations/translations.js

@@ -15,7 +15,7 @@ exports.getPluginsDefaultCodeTranslations = getPluginsDefaultCodeTranslations;
 exports.applyDefaultCodeTranslations = applyDefaultCodeTranslations;
 exports.loadSiteCodeTranslations = loadSiteCodeTranslations;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+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"));
@@ -87,7 +87,7 @@ Maybe you should remove them? ${unknownKeys}`;
     }
 }
 function getCodeTranslationsFilePath(context) {
-    return path_1.default.join(context.localizationDir, utils_1.CODE_TRANSLATIONS_FILE_NAME);
+    return node_path_1.default.join(context.localizationDir, utils_1.CODE_TRANSLATIONS_FILE_NAME);
 }
 async function readCodeTranslationFileContent(context) {
     return readTranslationFileContent(getCodeTranslationsFilePath(context));
@@ -115,7 +115,7 @@ function getPluginTranslationFilePath({ localizationDir, plugin, translationFile
         pluginId: plugin.options.id,
     });
     const filePath = addTranslationFileExtension(translationFilePath);
-    return path_1.default.join(dirPath, filePath);
+    return node_path_1.default.join(dirPath, filePath);
 }
 async function writePluginTranslations({ localizationDir, plugin, translationFile, options, }) {
     const filePath = getPluginTranslationFilePath({

package/lib/server/translations/translationsExtractor.js

@@ -8,13 +8,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractSiteSourceCodeTranslations = extractSiteSourceCodeTranslations;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+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 glob_1 = require("@docusaurus/glob");
 const babel_1 = require("@docusaurus/babel");
 function getSiteSourceCodeFilePaths(siteDir) {
-    return [path_1.default.join(siteDir, utils_1.SRC_DIR_NAME)];
+    return [node_path_1.default.join(siteDir, utils_1.SRC_DIR_NAME)];
 }
 function getPluginSourceCodeFilePaths(plugin) {
     // The getPathsToWatch() generally returns the js/jsx/ts/tsx/md/mdx file paths
@@ -27,7 +27,7 @@ function getPluginSourceCodeFilePaths(plugin) {
     if (themePath) {
         codePaths.push(themePath);
     }
-    return codePaths.map((p) => path_1.default.resolve(plugin.path, p));
+    return codePaths.map((p) => node_path_1.default.resolve(plugin.path, p));
 }
 async function getSourceCodeFilePaths(siteDir, plugins) {
     const sitePaths = getSiteSourceCodeFilePaths(siteDir);

package/lib/ssg/ssgExecutor.js

@@ -8,9 +8,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.executeSSG = executeSSG;
 const tslib_1 = require("tslib");
-const path = tslib_1.__importStar(require("path"));
+const path = tslib_1.__importStar(require("node:path"));
 const node_url_1 = require("node:url");
-const os_1 = tslib_1.__importDefault(require("os"));
+const node_os_1 = tslib_1.__importDefault(require("node:os"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
 const ssgParams_1 = require("./ssgParams");
@@ -34,7 +34,7 @@ function getNumberOfThreads(pathnames) {
         return ssgEnv_1.SSGWorkerThreadCount;
     }
     // See also https://github.com/tinylibs/tinypool/pull/108
-    const cpuCount = os_1.default.availableParallelism();
+    const cpuCount = node_os_1.default.availableParallelism();
     return inferNumberOfThreads({
         pageCount: pathnames.length,
         cpuCount,

package/lib/ssg/ssgRenderer.js

@@ -8,9 +8,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadSSGRenderer = loadSSGRenderer;
 const tslib_1 = require("tslib");
-const module_1 = require("module");
-const path_1 = tslib_1.__importDefault(require("path"));
-const vm_1 = require("vm");
+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 p_map_1 = tslib_1.__importDefault(require("p-map"));
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
@@ -23,9 +23,9 @@ const ssgUtils_1 = require("./ssgUtils");
 // that already isolate it from the main Docusaurus process
 // Running in the current context is faster and avoids reading all the globals
 function evaluateServerBundle({ source, serverBundlePath, }) {
-    const moduleFunction = (0, vm_1.compileFunction)(source, ['exports', 'require', 'module', '__filename', '__dirname'], { filename: serverBundlePath });
+    const moduleFunction = (0, node_vm_1.compileFunction)(source, ['exports', 'require', 'module', '__filename', '__dirname'], { filename: serverBundlePath });
     const module = { exports: {} };
-    moduleFunction.call(module.exports, module.exports, (0, module_1.createRequire)(serverBundlePath), module, serverBundlePath, path_1.default.dirname(serverBundlePath));
+    moduleFunction.call(module.exports, module.exports, (0, node_module_1.createRequire)(serverBundlePath), module, serverBundlePath, node_path_1.default.dirname(serverBundlePath));
     return module.exports;
 }
 async function loadAppRenderer({ serverBundlePath, }) {

package/lib/ssg/ssgUtils.js

@@ -10,7 +10,7 @@ exports.generateHashRouterEntrypoint = generateHashRouterEntrypoint;
 exports.writeStaticFile = writeStaticFile;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
+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
     // Paths ending with .html are left untouched
@@ -19,12 +19,12 @@ function pathnameToFilename({ pathname, trailingSlash, }) {
     }
     // Legacy retro-compatible behavior
     if (typeof trailingSlash === 'undefined') {
-        return path_1.default.join(outputFileName, 'index.html');
+        return node_path_1.default.join(outputFileName, 'index.html');
     }
     // New behavior: we can say if we prefer file/folder output
     // Useful resource: https://github.com/slorber/trailing-slash-guide
     if (pathname === '' || pathname.endsWith('/') || trailingSlash) {
-        return path_1.default.join(outputFileName, 'index.html');
+        return node_path_1.default.join(outputFileName, 'index.html');
     }
     return `${outputFileName}.html`;
 }
@@ -43,7 +43,7 @@ async function writeStaticFile({ content, pathname, params, }) {
         pathname: removeBaseUrl(pathname, params.baseUrl),
         trailingSlash: params.trailingSlash,
     });
-    const filePath = path_1.default.join(params.outDir, filename);
-    await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
+    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);
 }

package/lib/webpack/aliases/index.js

@@ -12,11 +12,11 @@ exports.loadThemeAliases = loadThemeAliases;
 exports.loadDocusaurusAliases = loadDocusaurusAliases;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
+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 ThemeFallbackDir = path_1.default.join(__dirname, '../../client/theme-fallback');
+const ThemeFallbackDir = node_path_1.default.join(__dirname, '../../client/theme-fallback');
 /**
  * Order of Webpack aliases is important because one alias can shadow another.
  * This ensures `@theme/NavbarItem` alias is after
@@ -50,7 +50,7 @@ async function createAliasesForTheme(themePath, addOriginalAlias) {
     });
     const aliases = {};
     themeComponentFiles.forEach((relativeSource) => {
-        const filePath = path_1.default.join(themePath, relativeSource);
+        const filePath = node_path_1.default.join(themePath, relativeSource);
         const fileName = (0, utils_1.fileToPath)(relativeSource);
         const aliasName = (0, utils_1.posixPath)((0, utils_1.normalizeUrl)(['@theme', fileName]).replace(/\/$/, ''));
         aliases[aliasName] = filePath;
@@ -88,9 +88,9 @@ async function createThemeAliases(themePaths, userThemePaths) {
 }
 function loadThemeAliases({ siteDir, plugins, }) {
     const pluginThemes = plugins
-        .map((plugin) => plugin.getThemePath && path_1.default.resolve(plugin.path, plugin.getThemePath()))
+        .map((plugin) => plugin.getThemePath && node_path_1.default.resolve(plugin.path, plugin.getThemePath()))
         .filter((x) => Boolean(x));
-    const userTheme = path_1.default.resolve(siteDir, utils_1.THEME_PATH);
+    const userTheme = node_path_1.default.resolve(siteDir, utils_1.THEME_PATH);
     return createThemeAliases([ThemeFallbackDir, ...pluginThemes], [userTheme]);
 }
 /**
@@ -99,15 +99,15 @@ function loadThemeAliases({ siteDir, plugins, }) {
  * aliases instead.
  */
 async function loadDocusaurusAliases() {
-    const dirPath = path_1.default.resolve(__dirname, '../../client/exports');
+    const dirPath = node_path_1.default.resolve(__dirname, '../../client/exports');
     const extensions = ['.js', '.ts', '.tsx'];
     const aliases = {};
     (await fs_extra_1.default.readdir(dirPath))
-        .filter((fileName) => extensions.includes(path_1.default.extname(fileName)))
+        .filter((fileName) => extensions.includes(node_path_1.default.extname(fileName)))
         .forEach((fileName) => {
-        const fileNameWithoutExtension = path_1.default.basename(fileName, path_1.default.extname(fileName));
+        const fileNameWithoutExtension = node_path_1.default.basename(fileName, node_path_1.default.extname(fileName));
         const aliasName = `@docusaurus/${fileNameWithoutExtension}`;
-        aliases[aliasName] = path_1.default.resolve(dirPath, fileName);
+        aliases[aliasName] = node_path_1.default.resolve(dirPath, fileName);
     });
     return aliases;
 }

package/lib/webpack/base.js

@@ -11,7 +11,7 @@ exports.excludeJS = excludeJS;
 exports.createBaseConfig = createBaseConfig;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
+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");
@@ -19,7 +19,7 @@ const aliases_1 = require("./aliases");
 const BundlerCPUProfilerPlugin_1 = require("./plugins/BundlerCPUProfilerPlugin");
 const CSS_REGEX = /\.css$/i;
 const CSS_MODULE_REGEX = /\.module\.css$/i;
-exports.clientDir = path_1.default.join(__dirname, '..', 'client');
+exports.clientDir = node_path_1.default.join(__dirname, '..', 'client');
 function getReactAliases(siteDir) {
     // Escape hatch
     if (process.env.DOCUSAURUS_NO_REACT_ALIASES) {
@@ -27,9 +27,9 @@ function getReactAliases(siteDir) {
     }
     const resolveSitePkg = (id) => require.resolve(id, { paths: [siteDir] });
     return {
-        react: path_1.default.dirname(resolveSitePkg('react/package.json')),
-        'react-dom': path_1.default.dirname(resolveSitePkg('react-dom/package.json')),
-        '@mdx-js/react': path_1.default.dirname(resolveSitePkg('@mdx-js/react')),
+        react: node_path_1.default.dirname(resolveSitePkg('react/package.json')),
+        'react-dom': node_path_1.default.dirname(resolveSitePkg('react-dom/package.json')),
+        '@mdx-js/react': node_path_1.default.dirname(resolveSitePkg('@mdx-js/react')),
     };
 }
 function excludeJS(modulePath) {
@@ -71,7 +71,7 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
     function getCacheBuildDependencies() {
         return [
             __filename,
-            path_1.default.join(__dirname, isServer ? 'server.js' : 'client.js'),
+            node_path_1.default.join(__dirname, isServer ? 'server.js' : 'client.js'),
             // Docusaurus config changes can affect MDX/JSX compilation, so we'd
             // rather evict the cache.
             // See https://github.com/questdb/questdb.io/issues/493
@@ -136,7 +136,7 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
                 // Allow resolution of url("/fonts/xyz.ttf") by webpack
                 // See https://webpack.js.org/configuration/resolve/#resolveroots
                 // See https://github.com/webpack-contrib/css-loader/issues/1256
-                ...siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
+                ...siteConfig.staticDirectories.map((dir) => node_path_1.default.resolve(siteDir, dir)),
                 siteDir,
                 process.cwd(),
             ],
@@ -153,13 +153,13 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
             // own node_modules, but core depends on core-js@2, we should use
             // core-js@2.
             modules: [
-                path_1.default.resolve(__dirname, '..', '..', 'node_modules'),
+                node_path_1.default.resolve(__dirname, '..', '..', 'node_modules'),
                 'node_modules',
-                path_1.default.resolve(await fs_extra_1.default.realpath(process.cwd()), 'node_modules'),
+                node_path_1.default.resolve(await fs_extra_1.default.realpath(process.cwd()), 'node_modules'),
             ],
         },
         resolveLoader: {
-            modules: ['node_modules', path_1.default.join(siteDir, 'node_modules')],
+            modules: ['node_modules', node_path_1.default.join(siteDir, 'node_modules')],
         },
         optimization: {
             // The optimization.mergeDuplicateChunks is expensive

package/lib/webpack/client.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStartClientConfig = createStartClientConfig;
 exports.createBuildClientConfig = createBuildClientConfig;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const react_loadable_ssr_addon_v5_slorber_1 = tslib_1.__importDefault(require("react-loadable-ssr-addon-v5-slorber"));
 const bundler_1 = require("@docusaurus/bundler");
@@ -35,7 +35,7 @@ async function createBaseClientConfig({ props, hydrate, minify, faster, configur
         // Useless, disabled on purpose (errors on existing sites with no
         // browserslist config)
         // target: 'browserslist',
-        entry: path_1.default.resolve(__dirname, '../client/clientEntry.js'),
+        entry: node_path_1.default.resolve(__dirname, '../client/clientEntry.js'),
         optimization: {
             // Keep the runtime chunk separated to enable long term caching
             // https://x.com/wSokra/status/969679223278505985
@@ -99,7 +99,7 @@ async function createBuildClientConfig({ props, minify, faster, configureWebpack
     // With the hash router, we don't hydrate the React app, even in build mode!
     // This is because it will always be a client-rendered React app
     const hydrate = router !== 'hash';
-    const clientManifestPath = path_1.default.join(generatedFilesDir, 'client-manifest.json');
+    const clientManifestPath = node_path_1.default.join(generatedFilesDir, 'client-manifest.json');
     const config = (0, webpack_merge_1.default)(await createBaseClientConfig({
         props,
         minify,

package/lib/webpack/plugins/StaticDirectoriesCopyPlugin.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createStaticDirectoriesCopyPlugin = createStaticDirectoriesCopyPlugin;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const bundler_1 = require("@docusaurus/bundler");
 async function createStaticDirectoriesCopyPlugin({ props, }) {
@@ -21,7 +21,7 @@ async function createStaticDirectoriesCopyPlugin({ props, }) {
     // just silently filter them out, because user could have never configured it
     // in the first place (the default option should always "work").
     const staticDirectories = (await Promise.all(staticDirectoriesOption.map(async (dir) => {
-        const staticDir = path_1.default.resolve(siteDir, 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) {
             return staticDir;

package/lib/webpack/server.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = createServerConfig;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const utils_1 = require("@docusaurus/utils");
 const bundler_1 = require("@docusaurus/bundler");
@@ -25,12 +25,12 @@ async function createServerConfig({ props, configureWebpackUtils, }) {
         currentBundler: props.currentBundler,
     });
     const outputFilename = 'server.bundle.js';
-    const outputDir = path_1.default.join(props.outDir, '__server');
-    const serverBundlePath = path_1.default.join(outputDir, outputFilename);
+    const outputDir = node_path_1.default.join(props.outDir, '__server');
+    const serverBundlePath = node_path_1.default.join(outputDir, outputFilename);
     const config = (0, webpack_merge_1.default)(baseConfig, {
         target: `node${utils_1.NODE_MAJOR_VERSION}.${utils_1.NODE_MINOR_VERSION}`,
         entry: {
-            main: path_1.default.resolve(__dirname, '../client/serverEntry.js'),
+            main: node_path_1.default.resolve(__dirname, '../client/serverEntry.js'),
         },
         output: {
             path: outputDir,

package/lib/webpack/utils/getHttpsConfig.js

@@ -9,8 +9,8 @@ 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 path_1 = tslib_1.__importDefault(require("path"));
-const crypto_1 = tslib_1.__importDefault(require("crypto"));
+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"));
 // Ensure the certificate and key provided are valid and if not
 // throw an easy to debug error.
@@ -21,14 +21,14 @@ const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 function validateKeyAndCerts({ cert, key }) {
     let certPublicKey;
     try {
-        certPublicKey = new crypto_1.default.X509Certificate(cert.content).publicKey;
+        certPublicKey = new node_crypto_1.default.X509Certificate(cert.content).publicKey;
     }
     catch (error) {
         throw new Error(logger_1.default.interpolate `The certificate path=${cert.path} is invalid.`, { cause: error });
     }
     let keyPublicKey;
     try {
-        keyPublicKey = crypto_1.default.createPublicKey(crypto_1.default.createPrivateKey(key.content));
+        keyPublicKey = node_crypto_1.default.createPublicKey(node_crypto_1.default.createPrivateKey(key.content));
     }
     catch (error) {
         throw new Error(logger_1.default.interpolate `The certificate key path=${key.path} is invalid.`, { cause: error });
@@ -63,25 +63,25 @@ async function readCryptoFile(filepath, source) {
 }
 function getCert(options, cwd) {
     if (options.sslCert) {
-        return readCryptoFile(path_1.default.resolve(cwd, options.sslCert), 'CLI arg --ssl-cert');
+        return readCryptoFile(node_path_1.default.resolve(cwd, options.sslCert), 'CLI arg --ssl-cert');
     }
     if (process.env.DOCUSAURUS_SSL_CRT_FILE) {
-        return readCryptoFile(path_1.default.resolve(cwd, process.env.DOCUSAURUS_SSL_CRT_FILE), 'env DOCUSAURUS_SSL_CRT_FILE');
+        return readCryptoFile(node_path_1.default.resolve(cwd, process.env.DOCUSAURUS_SSL_CRT_FILE), 'env DOCUSAURUS_SSL_CRT_FILE');
     }
     if (process.env.SSL_CRT_FILE) {
-        return readCryptoFile(path_1.default.resolve(cwd, process.env.SSL_CRT_FILE), 'env SSL_CRT_FILE');
+        return readCryptoFile(node_path_1.default.resolve(cwd, process.env.SSL_CRT_FILE), 'env SSL_CRT_FILE');
     }
     return null;
 }
 function getKeyFile(options, cwd) {
     if (options.sslKey) {
-        return readCryptoFile(path_1.default.resolve(cwd, options.sslKey), 'CLI arg --ssl-key');
+        return readCryptoFile(node_path_1.default.resolve(cwd, options.sslKey), 'CLI arg --ssl-key');
     }
     if (process.env.DOCUSAURUS_SSL_KEY_FILE) {
-        return readCryptoFile(path_1.default.resolve(cwd, process.env.DOCUSAURUS_SSL_KEY_FILE), 'env DOCUSAURUS_SSL_KEY_FILE');
+        return readCryptoFile(node_path_1.default.resolve(cwd, process.env.DOCUSAURUS_SSL_KEY_FILE), 'env DOCUSAURUS_SSL_KEY_FILE');
     }
     if (process.env.SSL_KEY_FILE) {
-        return readCryptoFile(path_1.default.resolve(cwd, process.env.SSL_KEY_FILE), 'env SSL_KEY_FILE');
+        return readCryptoFile(node_path_1.default.resolve(cwd, process.env.SSL_KEY_FILE), 'env SSL_KEY_FILE');
     }
     return null;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "4.0.0-canary-6870",
+  "version": "4.0.0-canary-6872",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,14 +33,14 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "4.0.0-canary-6870",
-    "@docusaurus/bundler": "4.0.0-canary-6870",
-    "@docusaurus/glob": "4.0.0-canary-6870",
-    "@docusaurus/logger": "4.0.0-canary-6870",
-    "@docusaurus/mdx-loader": "4.0.0-canary-6870",
-    "@docusaurus/utils": "4.0.0-canary-6870",
-    "@docusaurus/utils-common": "4.0.0-canary-6870",
-    "@docusaurus/utils-validation": "4.0.0-canary-6870",
+    "@docusaurus/babel": "4.0.0-canary-6872",
+    "@docusaurus/bundler": "4.0.0-canary-6872",
+    "@docusaurus/glob": "4.0.0-canary-6872",
+    "@docusaurus/logger": "4.0.0-canary-6872",
+    "@docusaurus/mdx-loader": "4.0.0-canary-6872",
+    "@docusaurus/utils": "4.0.0-canary-6872",
+    "@docusaurus/utils-common": "4.0.0-canary-6872",
+    "@docusaurus/utils-validation": "4.0.0-canary-6872",
     "boxen": "^9.0.0",
     "cli-table3": "^0.6.5",
     "combine-promises": "^1.2.0",
@@ -73,8 +73,8 @@
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "4.0.0-canary-6870",
-    "@docusaurus/types": "4.0.0-canary-6870",
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6872",
+    "@docusaurus/types": "4.0.0-canary-6872",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/escape-html": "^1.0.4",
     "@types/history": "^4.7.11",
@@ -88,7 +88,7 @@
     "utility-types": "^3.11.0"
   },
   "peerDependencies": {
-    "@docusaurus/faster": "4.0.0-canary-6870",
+    "@docusaurus/faster": "4.0.0-canary-6872",
     "@mdx-js/react": "^3.1.1",
     "react": "^19.3.0",
     "react-dom": "^19.3.0"
@@ -101,5 +101,5 @@
   "engines": {
     "node": ">=24.21"
   },
-  "gitHead": "ea3b6292c97af2e26f559f112cf9ea75a58a09c8"
+  "gitHead": "97ddb0451f086d8a1c20967f0d324d667dc58ebf"
 }