@docusaurus/core 3.7.0 → 3.8.0

package/bin/beforeCli.mjs

@@ -10,7 +10,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import {createRequire} from 'module';
-import shell from 'shelljs';
+import execa from 'execa';
 import {logger} from '@docusaurus/logger';
 import semver from 'semver';
 import updateNotifier from 'update-notifier';
@@ -111,8 +111,8 @@ export default async function beforeCli() {
         return undefined;
       }
 
-      const yarnVersionResult = shell.exec('yarn --version', {silent: true});
-      if (yarnVersionResult?.code === 0) {
+      const yarnVersionResult = await execa.command('yarn --version');
+      if (yarnVersionResult.exitCode === 0) {
         const majorVersion = parseInt(
           yarnVersionResult.stdout?.trim().split('.')[0] ?? '',
           10,

package/lib/client/App.js

@@ -10,6 +10,7 @@ import routes from '@generated/routes';
 import { useLocation } from '@docusaurus/router';
 import renderRoutes from '@docusaurus/renderRoutes';
 import Root from '@theme/Root';
+import ThemeProvider from '@theme/ThemeProvider';
 import SiteMetadata from '@theme/SiteMetadata';
 import normalizeLocation from './normalizeLocation';
 import { BrowserContextProvider } from './browserContext';
@@ -34,10 +35,12 @@ export default function App() {
       <DocusaurusContextProvider>
         <BrowserContextProvider>
           <Root>
-            <SiteMetadataDefaults />
-            <SiteMetadata />
-            <BaseUrlIssueBanner />
-            <AppNavigation />
+            <ThemeProvider>
+              <SiteMetadataDefaults />
+              <SiteMetadata />
+              <BaseUrlIssueBanner />
+              <AppNavigation />
+            </ThemeProvider>
           </Root>
           <HasHydratedDataAttribute />
         </BrowserContextProvider>

package/lib/client/serverEntry.js

@@ -12,7 +12,8 @@ import { renderToHtml } from './renderToHtml';
 import preload from './preload';
 import App from './App';
 import { createStatefulBrokenLinks, BrokenLinksProvider, } from './BrokenLinksContext';
-const render = async ({ pathname }) => {
+import { toPageCollectedMetadataInternal } from './serverHelmetUtils';
+const render = async ({ pathname, v4RemoveLegacyPostBuildHeadAttribute, }) => {
     await preload(pathname);
     const modules = new Set();
     const routerContext = {};
@@ -30,10 +31,15 @@ const render = async ({ pathname }) => {
       </HelmetProvider>
     </Loadable.Capture>);
     const html = await renderToHtml(app);
+    const { helmet } = helmetContext;
+    const metadata = toPageCollectedMetadataInternal({ helmet });
+    // TODO Docusaurus v4 remove with deprecated postBuild({head}) API
+    //  the returned collectedData must be serializable to run in workers
+    if (v4RemoveLegacyPostBuildHeadAttribute) {
+        metadata.helmet = null;
+    }
     const collectedData = {
-        // TODO Docusaurus v4 refactor: helmet state is non-serializable
-        //  this makes it impossible to run SSG in a worker thread
-        helmet: helmetContext.helmet,
+        metadata,
         anchors: statefulBrokenLinks.getCollectedAnchors(),
         links: statefulBrokenLinks.getCollectedLinks(),
         modules: Array.from(modules),

package/lib/client/serverHelmetUtils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { PageCollectedMetadataInternal } from '../common';
+import type { HelmetServerState } from 'react-helmet-async';
+export declare function toPageCollectedMetadataInternal({ helmet, }: {
+    helmet: HelmetServerState;
+}): PageCollectedMetadataInternal;

package/lib/client/serverHelmetUtils.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+function getBuildMetaTags(helmet) {
+    // @ts-expect-error: see  https://github.com/staylor/react-helmet-async/pull/167
+    const metaElements = helmet.meta.toComponent() ?? [];
+    return metaElements.map((el) => el.props);
+}
+function isNoIndexTag(tag) {
+    if (!tag.name || !tag.content) {
+        return false;
+    }
+    return (
+    // meta name is not case-sensitive
+    tag.name.toLowerCase() === 'robots' &&
+        // Robots directives are not case-sensitive
+        tag.content.toLowerCase().includes('noindex'));
+}
+export function toPageCollectedMetadataInternal({ helmet, }) {
+    const tags = getBuildMetaTags(helmet);
+    const noIndex = tags.some(isNoIndexTag);
+    return {
+        helmet, // TODO Docusaurus v4 remove
+        public: {
+            noIndex,
+        },
+        internal: {
+            htmlAttributes: helmet.htmlAttributes.toString(),
+            bodyAttributes: helmet.bodyAttributes.toString(),
+            title: helmet.title.toString(),
+            meta: helmet.meta.toString(),
+            link: helmet.link.toString(),
+            script: helmet.script.toString(),
+        },
+    };
+}

package/lib/client/theme-fallback/ThemeProvider/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type ReactNode } from 'react';
+import type { Props } from '@theme/ThemeProvider';
+export default function ThemeProvider({ children }: Props): ReactNode;

package/lib/client/theme-fallback/ThemeProvider/index.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+// Wrapper component expected to be implemented by a theme
+// Unlike <Layout>, it applies to all sites routes and never unmounts
+//
+// Unlike <Root>, the theme is expected to provide an implementation
+// <Root> is empty and the implementation is expected to be provided by the user
+//
+// Tree order: Root > ThemeProvider > Layout
+export default function ThemeProvider({ children }) {
+    return <>{children}</>;
+}

package/lib/commands/build/buildLocale.js

@@ -19,6 +19,9 @@ const client_1 = require("../../webpack/client");
 const server_1 = tslib_1.__importDefault(require("../../webpack/server"));
 const configure_1 = require("../../webpack/configure");
 const ssgExecutor_1 = require("../../ssg/ssgExecutor");
+const clearPath_1 = tslib_1.__importDefault(require("../utils/clearPath"));
+const SkipBundling = process.env.DOCUSAURUS_SKIP_BUNDLING === 'true';
+const ExitAfterBundling = process.env.DOCUSAURUS_EXIT_AFTER_BUNDLING === 'true';
 async function buildLocale({ siteDir, locale, cliOptions, }) {
     // Temporary workaround to unlock the ability to translate the site config
     // We'll remove it if a better official API can be designed
@@ -47,16 +50,32 @@ async function buildLocale({ siteDir, locale, cliOptions, }) {
             props,
             configureWebpackUtils,
         }),
+        // We also clear website/build dir
+        // returns void, no useful result needed before compilation
+        // See also https://github.com/facebook/docusaurus/pull/11037
+        SkipBundling ? undefined : (0, clearPath_1.default)(outDir),
     ]));
-    // Run webpack to build JS bundle (client) and static html files (server).
-    await logger_1.PerfLogger.async(`Bundling with ${props.currentBundler.name}`, () => {
-        return (0, bundler_1.compile)({
-            configs: 
-            // For hash router we don't do SSG and can skip the server bundle
-            router === 'hash' ? [clientConfig] : [clientConfig, serverConfig],
-            currentBundler: configureWebpackUtils.currentBundler,
+    if (SkipBundling) {
+        console.warn(`Skipping the Docusaurus bundling step because DOCUSAURUS_SKIP_BUNDLING='true'`);
+    }
+    else {
+        const cleanupBundlerTracing = await (0, bundler_1.registerBundlerTracing)({
+            currentBundler: props.currentBundler,
         });
-    });
+        // Run webpack to build JS bundle (client) and static html files (server).
+        await logger_1.PerfLogger.async(`Bundling with ${props.currentBundler.name}`, () => {
+            return (0, bundler_1.compile)({
+                configs: 
+                // For hash router we don't do SSG and can skip the server bundle
+                router === 'hash' ? [clientConfig] : [clientConfig, serverConfig],
+                currentBundler: configureWebpackUtils.currentBundler,
+            });
+        });
+        await cleanupBundlerTracing();
+    }
+    if (ExitAfterBundling) {
+        return process.exit(0);
+    }
     const { collectedData } = await logger_1.PerfLogger.async('SSG', () => (0, ssgExecutor_1.executeSSG)({
         props,
         serverBundlePath,
@@ -71,7 +90,10 @@ async function buildLocale({ siteDir, locale, cliOptions, }) {
     logger_1.default.success `Generated static files in path=${path_1.default.relative(process.cwd(), outDir)}.`;
 }
 async function executePluginsPostBuild({ plugins, props, collectedData, }) {
-    const head = lodash_1.default.mapValues(collectedData, (d) => d.helmet);
+    const head = props.siteConfig.future.v4.removeLegacyPostBuildHeadAttribute
+        ? {}
+        : lodash_1.default.mapValues(collectedData, (d) => d.metadata.helmet);
+    const routesBuildMetadata = lodash_1.default.mapValues(collectedData, (d) => d.metadata.public);
     await Promise.all(plugins.map(async (plugin) => {
         if (!plugin.postBuild) {
             return;
@@ -79,6 +101,7 @@ async function executePluginsPostBuild({ plugins, props, collectedData, }) {
         await plugin.postBuild({
             ...props,
             head,
+            routesBuildMetadata,
             content: plugin.content,
         });
     }));
@@ -131,7 +154,7 @@ async function getBuildServerConfig({ props, configureWebpackUtils, }) {
 // Remove /build/server server.bundle.js because it is not needed.
 async function cleanupServerBundle(serverBundlePath) {
     if (process.env.DOCUSAURUS_KEEP_SERVER_BUNDLE === 'true') {
-        logger_1.default.warn("Will NOT delete server bundle because DOCUSAURUS_KEEP_SERVER_BUNDLE is set to 'true'");
+        logger_1.default.warn("Will NOT delete server bundle because DOCUSAURUS_KEEP_SERVER_BUNDLE='true'");
     }
     else {
         await logger_1.PerfLogger.async('Deleting server bundle', async () => {

package/lib/commands/clear.js

@@ -12,13 +12,14 @@ const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("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"));
 async function removePath(entry) {
     if (!(await fs_extra_1.default.pathExists(entry.path))) {
         return;
     }
     try {
-        await fs_extra_1.default.remove(entry.path);
-        logger_1.default.success `Removed the ${entry.description} at path=${entry.path}.`;
+        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)}.`;
     }
     catch (err) {
         logger_1.default.error `Could not remove the ${entry.description} at path=${entry.path}.`;
@@ -38,7 +39,7 @@ async function clear(siteDirParam = '.') {
     // 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'),
-        description: 'Webpack persistent cache folder',
+        description: 'bundler persistent cache folder',
     }));
     await Promise.all([generatedFolder, buildFolder, ...cacheFolders].map(removePath));
 }

package/lib/commands/deploy.js

@@ -12,7 +12,7 @@ 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 logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const shelljs_1 = tslib_1.__importDefault(require("shelljs"));
+const execa_1 = tslib_1.__importDefault(require("execa"));
 const utils_1 = require("@docusaurus/utils");
 const site_1 = require("../server/site");
 const build_1 = require("./build/build");
@@ -21,19 +21,41 @@ function obfuscateGitPass(str) {
     const gitPass = process.env.GIT_PASS;
     return gitPass ? str.replace(gitPass, 'GIT_PASS') : str;
 }
+const debugMode = !!process.env.DOCUSAURUS_DEPLOY_DEBUG;
 // Log executed commands so that user can figure out mistakes on his own
 // for example: https://github.com/facebook/docusaurus/issues/3875
-function shellExecLog(cmd) {
+function exec(cmd, options) {
+    const log = options?.log ?? true;
+    const failfast = options?.failfast ?? false;
     try {
-        const result = shelljs_1.default.exec(cmd);
-        logger_1.default.info `code=${obfuscateGitPass(cmd)} subdue=${`code: ${result.code}`}`;
+        // TODO migrate to execa(file,[...args]) instead
+        //  Use async/await everything
+        //  Avoid execa.command: the args need to be escaped manually
+        const result = execa_1.default.commandSync(cmd);
+        if (log || debugMode) {
+            logger_1.default.info `code=${obfuscateGitPass(cmd)} subdue=${`code: ${result.exitCode}`}`;
+        }
+        if (debugMode) {
+            console.log(result);
+        }
+        if (failfast && result.exitCode !== 0) {
+            throw new Error(`Command returned unexpected exitCode ${result.exitCode}`);
+        }
         return result;
     }
     catch (err) {
-        logger_1.default.error `code=${obfuscateGitPass(cmd)}`;
-        throw err;
+        throw new Error(logger_1.default.interpolate `Error while executing command code=${obfuscateGitPass(cmd)}
+In CWD code=${process.cwd()}`, { cause: err });
     }
 }
+// Execa escape args and add necessary quotes automatically
+// When using Execa.command, the args containing spaces must be escaped manually
+function escapeArg(arg) {
+    return arg.replaceAll(' ', '\\ ');
+}
+function hasGit() {
+    return exec('git --version').exitCode === 0;
+}
 async function deploy(siteDirParam = '.', cliOptions = {}) {
     const siteDir = await fs_extra_1.default.realpath(siteDirParam);
     const { outDir, siteConfig, siteConfigPath } = await (0, site_1.loadContext)({
@@ -48,16 +70,23 @@ This behavior can have SEO impacts and create relative link issues.
 `);
     }
     logger_1.default.info('Deploy command invoked...');
-    if (!shelljs_1.default.which('git')) {
-        throw new Error('Git not installed or on the PATH!');
+    if (!hasGit()) {
+        throw new Error('Git not installed or not added to PATH!');
     }
     // Source repo is the repo from where the command is invoked
-    const sourceRepoUrl = shelljs_1.default
-        .exec('git remote get-url origin', { silent: true })
-        .stdout.trim();
+    const { stdout } = exec('git remote get-url origin', {
+        log: false,
+        failfast: true,
+    });
+    const sourceRepoUrl = stdout.trim();
     // The source branch; defaults to the currently checked out branch
     const sourceBranch = process.env.CURRENT_BRANCH ??
-        shelljs_1.default.exec('git rev-parse --abbrev-ref HEAD', { silent: true }).stdout.trim();
+        exec('git rev-parse --abbrev-ref HEAD', {
+            log: false,
+            failfast: true,
+        })
+            ?.stdout?.toString()
+            .trim();
     const gitUser = process.env.GIT_USER;
     let useSSH = process.env.USE_SSH !== undefined &&
         process.env.USE_SSH.toLowerCase() === 'true';
@@ -87,8 +116,11 @@ This behavior can have SEO impacts and create relative link issues.
     // We never deploy on pull request.
     const isPullRequest = process.env.CI_PULL_REQUEST ?? process.env.CIRCLE_PULL_REQUEST;
     if (isPullRequest) {
-        shelljs_1.default.echo('Skipping deploy on a pull request.');
-        shelljs_1.default.exit(0);
+        exec('echo "Skipping deploy on a pull request."', {
+            log: false,
+            failfast: true,
+        });
+        process.exit(0);
     }
     // github.io indicates organization repos that deploy via default branch. All
     // others use gh-pages (either case can be configured actually, but we can
@@ -126,21 +158,24 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
     }
     // Save the commit hash that triggers publish-gh-pages before checking
     // out to deployment branch.
-    const currentCommit = shellExecLog('git rev-parse HEAD').stdout.trim();
+    const currentCommit = exec('git rev-parse HEAD')?.stdout?.toString().trim();
     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}`));
-        shelljs_1.default.cd(toPath);
+        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
         // repository default branch.
-        if (shellExecLog(`git clone --depth 1 --branch ${deploymentBranch} ${deploymentRepoURL} "${toPath}"`).code !== 0) {
-            shellExecLog(`git clone --depth 1 ${deploymentRepoURL} "${toPath}"`);
-            shellExecLog(`git checkout -b ${deploymentBranch}`);
+        if (exec(`git clone --depth 1 --branch ${deploymentBranch} ${deploymentRepoURL} ${escapeArg(toPath)}`).exitCode !== 0) {
+            exec(`git clone --depth 1 ${deploymentRepoURL} ${escapeArg(toPath)}`);
+            exec(`git checkout -b ${deploymentBranch}`);
         }
         // Clear out any existing contents in the target directory
-        shellExecLog(`git rm -rf ${targetDirectory}`);
+        exec(`git rm -rf ${escapeArg(targetDirectory)}`, {
+            log: false,
+            failfast: true,
+        });
         const targetPath = path_1.default.join(toPath, targetDirectory);
         try {
             await fs_extra_1.default.copy(fromPath, targetPath);
@@ -149,22 +184,24 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
             logger_1.default.error `Copying build assets from path=${fromPath} to path=${targetPath} failed.`;
             throw err;
         }
-        shellExecLog('git add --all');
+        exec('git add --all', { failfast: true });
         const gitUserName = process.env.GIT_USER_NAME;
         if (gitUserName) {
-            shellExecLog(`git config user.name "${gitUserName}"`);
+            exec(`git config user.name ${escapeArg(gitUserName)}`, { failfast: true });
         }
         const gitUserEmail = process.env.GIT_USER_EMAIL;
         if (gitUserEmail) {
-            shellExecLog(`git config user.email "${gitUserEmail}"`);
+            exec(`git config user.email ${escapeArg(gitUserEmail)}`, {
+                failfast: true,
+            });
         }
         const commitMessage = process.env.CUSTOM_COMMIT_MESSAGE ??
             `Deploy website - based on ${currentCommit}`;
-        const commitResults = shellExecLog(`git commit -m "${commitMessage}"`);
-        if (shellExecLog(`git push --force origin ${deploymentBranch}`).code !== 0) {
+        const commitResults = exec(`git commit -m ${escapeArg(commitMessage)} --allow-empty`);
+        if (exec(`git push --force origin ${deploymentBranch}`).exitCode !== 0) {
             throw new Error('Running "git push" command failed. Does the GitHub user account you are using have push access to the repository?');
         }
-        else if (commitResults.code === 0) {
+        else if (commitResults.exitCode === 0) {
             // The commit might return a non-zero value when site is up to date.
             let websiteURL = '';
             if (githubHost === 'github.com') {
@@ -176,8 +213,13 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
                 // GitHub enterprise hosting.
                 websiteURL = `https://${githubHost}/pages/${organizationName}/${projectName}/`;
             }
-            shelljs_1.default.echo(`Website is live at "${websiteURL}".`);
-            shelljs_1.default.exit(0);
+            try {
+                exec(`echo "Website is live at ${websiteURL}."`, { failfast: true });
+                process.exit(0);
+            }
+            catch (err) {
+                throw new Error(`Failed to execute command: ${err}`);
+            }
         }
     };
     if (!cliOptions.skipBuild) {

package/lib/commands/serve.js

@@ -14,8 +14,8 @@ const path_1 = tslib_1.__importDefault(require("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 openBrowser_1 = tslib_1.__importDefault(require("react-dev-utils/openBrowser"));
 const utils_common_1 = require("@docusaurus/utils-common");
+const openBrowser_1 = tslib_1.__importDefault(require("./utils/openBrowser/openBrowser"));
 const config_1 = require("../server/config");
 const build_1 = require("./build/build");
 const getHostPort_1 = require("../server/getHostPort");
@@ -86,6 +86,6 @@ async function serve(siteDirParam = '.', cliOptions = {}) {
     logger_1.default.success `Serving path=${buildDir} directory at: url=${url}`;
     server.listen(port);
     if (cliOptions.open && !process.env.CI) {
-        (0, openBrowser_1.default)(url);
+        await (0, openBrowser_1.default)(url);
     }
 }

package/lib/commands/start/start.js

@@ -8,12 +8,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.start = start;
 const tslib_1 = require("tslib");
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const openBrowser_1 = tslib_1.__importDefault(require("react-dev-utils/openBrowser"));
+const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
+const openBrowser_1 = tslib_1.__importDefault(require("../utils/openBrowser/openBrowser"));
 const watcher_1 = require("./watcher");
 const webpack_1 = require("./webpack");
 const utils_1 = require("./utils");
-async function start(siteDirParam = '.', cliOptions = {}) {
+async function doStart(siteDirParam = '.', cliOptions = {}) {
     logger_1.default.info('Starting the development server...');
     // Temporary workaround to unlock the ability to translate the site config
     // We'll remove it if a better official API can be designed
@@ -41,6 +41,9 @@ async function start(siteDirParam = '.', cliOptions = {}) {
     });
     await devServer.start();
     if (cliOptions.open) {
-        (0, openBrowser_1.default)(reloadableSite.getOpenUrl());
+        await (0, openBrowser_1.default)(reloadableSite.getOpenUrl());
     }
 }
+async function start(siteDirParam = '.', cliOptions = {}) {
+    return logger_1.PerfLogger.async('CLI start', () => doStart(siteDirParam, cliOptions));
+}

package/lib/commands/start/utils.js

@@ -10,13 +10,28 @@ exports.createOpenUrlContext = createOpenUrlContext;
 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 lodash_1 = tslib_1.__importDefault(require("lodash"));
-const WebpackDevServerUtils_1 = require("react-dev-utils/WebpackDevServerUtils");
 const utils_1 = require("@docusaurus/utils");
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
 const getHostPort_1 = require("../../server/getHostPort");
 const site_1 = require("../../server/site");
 const pluginsUtils_1 = require("../../server/plugins/pluginsUtils");
+// This code was historically in CRA/react-dev-utils (deprecated in 2025)
+// We internalized it, refactored and removed useless code paths
+// See https://github.com/facebook/docusaurus/pull/10956
+// See https://github.com/facebook/create-react-app/blob/main/packages/react-dev-utils/WebpackDevServerUtils.js
+function getOpenUrlOrigin(protocol, host, port) {
+    const isUnspecifiedHost = host === '0.0.0.0' || host === '::';
+    const prettyHost = isUnspecifiedHost ? 'localhost' : host;
+    const localUrlForBrowser = url_1.default.format({
+        protocol,
+        hostname: prettyHost,
+        port,
+        pathname: '/',
+    });
+    return localUrlForBrowser;
+}
 async function createOpenUrlContext({ cliOptions, }) {
     const protocol = process.env.HTTPS === 'true' ? 'https' : 'http';
     const { host, port } = await (0, getHostPort_1.getHostPort)(cliOptions);
@@ -24,9 +39,8 @@ async function createOpenUrlContext({ cliOptions, }) {
         return process.exit();
     }
     const getOpenUrl = ({ baseUrl, router }) => {
-        const urls = (0, WebpackDevServerUtils_1.prepareUrls)(protocol, host, port);
         return (0, utils_1.normalizeUrl)([
-            urls.localUrlForBrowser,
+            getOpenUrlOrigin(protocol, host, port),
             router === 'hash' ? '/#/' : '',
             baseUrl,
         ]);

package/lib/commands/start/webpack.js

@@ -13,7 +13,7 @@ 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"));
 const webpack_dev_server_1 = tslib_1.__importDefault(require("webpack-dev-server"));
-const evalSourceMapMiddleware_1 = tslib_1.__importDefault(require("react-dev-utils/evalSourceMapMiddleware"));
+const evalSourceMapMiddleware_1 = tslib_1.__importDefault(require("../utils/legacy/evalSourceMapMiddleware"));
 const watcher_1 = require("./watcher");
 const getHttpsConfig_1 = tslib_1.__importDefault(require("../../webpack/utils/getHttpsConfig"));
 const configure_1 = require("../../webpack/configure");

package/lib/commands/utils/clearPath.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * @param pathToClear
+ */
+export default function clearPath(pathToClear: string): Promise<void>;

package/lib/commands/utils/clearPath.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = clearPath;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const promises_1 = require("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 () => {
+        await (0, promises_1.rm)(pathToClear, { recursive: true, force: true });
+    });
+}

package/lib/commands/utils/legacy/evalSourceMapMiddleware.d.ts

@@ -0,0 +1,2 @@
+declare function _exports(server: import("webpack-dev-server").default): import("express").Handler;
+export = _exports;

package/lib/commands/utils/legacy/evalSourceMapMiddleware.js

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// TODO Legacy CRA react-dev-utils package code
+//  This code was in CRA/react-dev-utils (deprecated in 2025)
+//  We just copied the code as-is to remove a fat/useless dependency subtree
+//  See https://github.com/facebook/docusaurus/pull/10956
+//  See https://github.com/facebook/create-react-app/blob/main/packages/react-dev-utils/evalSourceMapMiddleware.js
+
+/* eslint-disable */
+
+function base64SourceMap(source) {
+  const base64 = Buffer.from(JSON.stringify(source.map()), 'utf8').toString(
+    'base64',
+  );
+  return `data:application/json;charset=utf-8;base64,${base64}`;
+}
+
+function getSourceById(server, id) {
+  const module = Array.from(server._stats.compilation.modules).find(
+    (m) => server._stats.compilation.chunkGraph.getModuleId(m) == id,
+  );
+  return module.originalSource();
+}
+
+/**
+ * Middleware responsible for retrieving a generated source
+ * Receives a webpack internal url: "webpack-internal:///<module-id>"
+ * Returns a generated source: "<source-text><sourceMappingURL><sourceURL>"
+ *
+ * Based on EvalSourceMapDevToolModuleTemplatePlugin.js
+ *
+ * @param {import("webpack-dev-server").default} server
+ * @returns {import("express").Handler}
+ */
+module.exports = function createEvalSourceMapMiddleware(server) {
+  return function handleWebpackInternalMiddleware(req, res, next) {
+    if (req.url.startsWith('/__get-internal-source')) {
+      const fileName = req.query.fileName;
+      const id = fileName.match(/webpack-internal:\/\/\/(.+)/)[1];
+      if (!id || !server._stats) {
+        next();
+      }
+
+      const source = getSourceById(server, id);
+      const sourceMapURL = `//# sourceMappingURL=${base64SourceMap(source)}`;
+      const sourceURL = `//# sourceURL=webpack-internal:///${module.id}`;
+      res.end(`${source.source()}\n${sourceMapURL}\n${sourceURL}`);
+    } else {
+      next();
+    }
+  };
+};

package/lib/commands/utils/openBrowser/openBrowser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Returns true if it opened a browser
+ */
+export default function openBrowser(url: string): Promise<boolean>;