@docusaurus/core 3.10.2 → 4.0.0-canary-6808

package/bin/beforeCli.mjs

@@ -10,14 +10,14 @@
 import fs from 'fs-extra';
 import path from 'path';
 import {createRequire} from 'module';
-import execa from 'execa';
+import {execa} from 'execa';
 import {logger} from '@docusaurus/logger';
 import semver from 'semver';
 import updateNotifier from 'update-notifier';
 import boxen from 'boxen';
 import {DOCUSAURUS_VERSION} from '@docusaurus/utils';
 
-const packageJson = /** @type {import("../package.json")} */ (
+const packageJson = /** @type {typeof import("../package.json")} */ (
   createRequire(import.meta.url)('../package.json')
 );
 /** @type {Record<string, any>} */
@@ -111,15 +111,13 @@ export default async function beforeCli() {
         return undefined;
       }
 
-      const yarnVersionResult = await execa.command('yarn --version');
-      if (yarnVersionResult.exitCode === 0) {
-        const majorVersion = parseInt(
-          yarnVersionResult.stdout?.trim().split('.')[0] ?? '',
-          10,
-        );
-        if (!Number.isNaN(majorVersion)) {
-          return majorVersion;
-        }
+      const yarnVersionResult = await execa`yarn --version`;
+      const majorVersion = parseInt(
+        yarnVersionResult.stdout?.trim().split('.')[0] ?? '',
+        10,
+      );
+      if (!Number.isNaN(majorVersion)) {
+        return majorVersion;
       }
 
       return undefined;

package/lib/client/exports/ComponentCreator.js

@@ -94,14 +94,12 @@ export default function ComponentCreator(path, hash) {
                 });
                 val[keyPaths[keyPaths.length - 1]] = chunk;
             });
-            /* eslint-disable no-underscore-dangle */
             const Component = loadedModules.__comp;
             delete loadedModules.__comp;
             const routeContext = loadedModules.__context;
             delete loadedModules.__context;
             const routeProps = loadedModules.__props;
             delete loadedModules.__props;
-            /* eslint-enable no-underscore-dangle */
             // Is there any way to put this RouteContextProvider upper in the tree?
             return (<RouteContextProvider value={routeContext}>
           <Component {...loadedModules} {...routeProps} {...props}/>

package/lib/client/exports/Link.d.ts

@@ -4,7 +4,7 @@
  * 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';
+import { type ReactNode } from 'react';
 import type { Props } from '@docusaurus/Link';
-declare const _default: React.ForwardRefExoticComponent<Omit<Props, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
-export default _default;
+declare function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLinkCheck': noBrokenLinkCheck, autoAddBaseUrl, ...props }: Props): ReactNode;
+export default Link;

package/lib/client/exports/Link.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React, { useEffect, useImperativeHandle, useRef, } from 'react';
+import React, { useCallback, useEffect, useImperativeHandle, useRef, } from 'react';
 import { NavLink, Link as RRLink } from 'react-router-dom';
 import { applyTrailingSlash } from '@docusaurus/utils-common';
 import useDocusaurusContext from './useDocusaurusContext';
@@ -18,14 +18,14 @@ import { useBaseUrlUtils } from './useBaseUrl';
 // this is because useBaseUrl() actually transforms relative links
 // like "introduction" to "/baseUrl/introduction" => bad behavior to fix
 const shouldAddBaseUrlAutomatically = (to) => to.startsWith('/');
-function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLinkCheck': noBrokenLinkCheck, autoAddBaseUrl = true, ...props }, forwardedRef) {
+function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLinkCheck': noBrokenLinkCheck, autoAddBaseUrl = true, ...props }) {
     const { siteConfig } = useDocusaurusContext();
     const { trailingSlash, baseUrl } = siteConfig;
     const router = siteConfig.future.experimental_router;
     const { withBaseUrl } = useBaseUrlUtils();
     const brokenLinks = useBrokenLinks();
     const innerRef = useRef(null);
-    useImperativeHandle(forwardedRef, () => innerRef.current);
+    useImperativeHandle(props.ref, () => innerRef.current);
     // IMPORTANT: using to or href should not change anything
     // For example, MDX links will ALWAYS give us the href props
     // Using one prop or the other should not be used to distinguish
@@ -64,18 +64,23 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
     const LinkComponent = (isNavLink ? NavLink : RRLink);
     const IOSupported = ExecutionEnvironment.canUseIntersectionObserver;
     const ioRef = useRef(undefined);
-    const handleRef = (el) => {
+    const handleRef = useCallback((el) => {
         innerRef.current = el;
+        ioRef.current?.disconnect();
+        ioRef.current = undefined;
         if (IOSupported && el && isInternal) {
             // If IO supported and element reference found, set up Observer.
-            ioRef.current = new window.IntersectionObserver((entries) => {
+            const observer = new window.IntersectionObserver((entries) => {
                 entries.forEach((entry) => {
                     if (el === entry.target) {
                         // If element is in viewport, stop observing and run callback.
                         // https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API
                         if (entry.isIntersecting || entry.intersectionRatio > 0) {
-                            ioRef.current.unobserve(el);
-                            ioRef.current.disconnect();
+                            observer.unobserve(el);
+                            observer.disconnect();
+                            if (ioRef.current === observer) {
+                                ioRef.current = undefined;
+                            }
                             if (targetLink != null) {
                                 window.docusaurus.prefetch(targetLink);
                             }
@@ -84,9 +89,10 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
                 });
             });
             // Add element to the observer.
-            ioRef.current.observe(el);
+            ioRef.current = observer;
+            observer.observe(el);
         }
-    };
+    }, [IOSupported, isInternal, targetLink]);
     const onInteractionEnter = () => {
         if (!preloaded.current && targetLink != null) {
             window.docusaurus.preload(targetLink);
@@ -100,13 +106,7 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
                 window.docusaurus.prefetch(targetLink);
             }
         }
-        // When unmounting, stop intersection observer from watching.
-        return () => {
-            if (IOSupported && ioRef.current) {
-                ioRef.current.disconnect();
-            }
-        };
-    }, [ioRef, targetLink, IOSupported, isInternal]);
+    }, [targetLink, IOSupported, isInternal]);
     // It is simple local anchor link targeting current page?
     const isAnchorLink = targetLink?.startsWith('#') ?? false;
     // See also RR logic:
@@ -139,4 +139,4 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
     // element"
     {...(isNavLink && { isActive, activeClassName })} {...testOnlyProps}/>);
 }
-export default React.forwardRef(Link);
+export default Link;

package/lib/client/exports/isInternalUrl.js

@@ -8,7 +8,7 @@
 // Spec: https://datatracker.ietf.org/doc/html/rfc3986#section-3.1
 // In particular: scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )
 export function hasProtocol(url) {
-    return /^(?:[A-Za-z][A-Za-z\d+.-]*:|\/\/)/.test(url);
+    return /^(?:[A-Z][A-Z\d+.-]*:|\/\/)/i.test(url);
 }
 export default function isInternalUrl(url) {
     return typeof url !== 'undefined' && !hasProtocol(url);

package/lib/client/preload.js

@@ -15,8 +15,6 @@ import { matchRoutes } from 'react-router-config';
  * @returns Promise object represents whether pathname has been preloaded
  */
 export default function preload(pathname) {
-    const matches = Array.from(new Set([pathname, decodeURI(pathname)]))
-        .map((p) => matchRoutes(routes, p))
-        .flat();
+    const matches = Array.from(new Set([pathname, decodeURI(pathname)])).flatMap((p) => matchRoutes(routes, p));
     return Promise.all(matches.map((match) => match.route.component.preload?.()));
 }

package/lib/client/serverEntry.js

@@ -13,7 +13,7 @@ import preload from './preload';
 import App from './App';
 import { createStatefulBrokenLinks, BrokenLinksProvider, } from './BrokenLinksContext';
 import { toPageCollectedMetadataInternal } from './serverHelmetUtils';
-const render = async ({ pathname, v4RemoveLegacyPostBuildHeadAttribute, }) => {
+const render = async ({ pathname }) => {
     await preload(pathname);
     const modules = new Set();
     const routerContext = {};
@@ -33,11 +33,6 @@ const render = async ({ pathname, v4RemoveLegacyPostBuildHeadAttribute, }) => {
     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 = {
         metadata,
         anchors: statefulBrokenLinks.getCollectedAnchors(),

package/lib/client/serverHelmetUtils.js

@@ -23,7 +23,6 @@ export function toPageCollectedMetadataInternal({ helmet, }) {
     const tags = getBuildMetaTags(helmet);
     const noIndex = tags.some(isNoIndexTag);
     return {
-        helmet, // TODO Docusaurus v4 remove
         public: {
             noIndex,
         },

package/lib/commands/build/buildLocale.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { BuildCLIOptions } from './build';
+import type { BuildCLIOptions } from './build';
 export type BuildLocaleParams = {
     siteDir: string;
     locale: string;

package/lib/commands/build/buildLocale.js

@@ -99,9 +99,6 @@ 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 = 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) {
@@ -109,7 +106,6 @@ async function executePluginsPostBuild({ plugins, props, collectedData, }) {
         }
         await plugin.postBuild({
             ...props,
-            head,
             routesBuildMetadata,
             content: plugin.content,
         });

package/lib/commands/build/buildUtils.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { BuildCLIOptions } from './build';
+import type { BuildCLIOptions } from './build';
 /**
  * We disable locale path localization if CLI has a single "--locale" option
  * yarn build --locale fr => baseUrl=/ instead of baseUrl=/fr/

package/lib/commands/cli.js

@@ -109,21 +109,9 @@ async function createCLIProgram({ cli, cliArgs, siteDir, config, }) {
         .option('--no-open', 'do not open page in the browser (default: false)')
         .option('--poll [interval]', 'use polling rather than watching for reload (default: false). Can specify a poll interval in milliseconds', normalizePollValue)
         .option('--no-minify', 'build website without minimizing JS bundles (default: false)')
-        /*
-        TODO
-        .option(
-          '--https',
-          'serve the dev site over HTTPS using a self-signed cert (default: false). Preferred over the HTTPS=true env var. Implied when both --ssl-cert and --ssl-key are provided.',
-        )
-        .option(
-          '--ssl-cert <path>',
-          'path to a TLS certificate file (implies HTTPS). Preferred over the SSL_CRT_FILE env var; CLI takes precedence if both are set.',
-        )
-        .option(
-          '--ssl-key <path>',
-          'path to a TLS private key file (implies HTTPS). Preferred over the SSL_KEY_FILE env var; CLI takes precedence if both are set.',
-        )
-        */
+        .option('--https', 'serve the dev site over HTTPS using a self-signed cert (default: false). Preferred over the HTTPS=true env var. Implied when both --ssl-cert and --ssl-key are provided.')
+        .option('--ssl-cert <path>', 'path to a TLS certificate file (implies HTTPS). Preferred over the SSL_CRT_FILE env var; CLI takes precedence if both are set.')
+        .option('--ssl-key <path>', 'path to a TLS private key file (implies HTTPS). Preferred over the SSL_KEY_FILE env var; CLI takes precedence if both are set.')
         .action(start_1.start);
     cli
         .command('serve [siteDir]')

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 execa_1 = tslib_1.__importDefault(require("execa"));
+const execa_1 = require("execa");
 const utils_1 = require("@docusaurus/utils");
 const site_1 = require("../server/site");
 const build_1 = require("./build/build");
@@ -24,14 +24,12 @@ function obfuscateGitPass(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 exec(cmd, options) {
+async function exec(file, args, options) {
     const log = options?.log ?? true;
-    const failfast = options?.failfast ?? false;
+    const failfast = options?.failfast ?? true;
+    const cmd = [file, ...args].join(' ');
     try {
-        // 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);
+        const result = await (0, execa_1.execa)(file, args, { reject: false });
         if (log || debugMode) {
             logger_1.default.info `code=${obfuscateGitPass(cmd)} subdue=${`code: ${result.exitCode}`}`;
         }
@@ -39,7 +37,8 @@ function exec(cmd, options) {
             console.log(result);
         }
         if (failfast && result.exitCode !== 0) {
-            throw new Error(`Command returned unexpected exitCode ${result.exitCode}`);
+            throw new Error(`Command returned unexpected exitCode ${result.exitCode}
+${result.stderr}`);
         }
         return result;
     }
@@ -48,13 +47,8 @@ function exec(cmd, options) {
 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 hasGit() {
+    return (await exec('git', ['--version'], { failfast: false })).exitCode === 0;
 }
 async function deploy(siteDirParam = '.', cliOptions = {}) {
     const siteDir = await fs_extra_1.default.realpath(siteDirParam);
@@ -70,23 +64,16 @@ This behavior can have SEO impacts and create relative link issues.
 `);
     }
     logger_1.default.info('Deploy command invoked...');
-    if (!hasGit()) {
+    if (!(await hasGit())) {
         throw new Error('Git not installed or not added to PATH!');
     }
     // Source repo is the repo from where the command is invoked
-    const { stdout } = exec('git remote get-url origin', {
+    const sourceRepoUrl = (await exec('git', ['remote', 'get-url', 'origin'], {
         log: false,
-        failfast: true,
-    });
-    const sourceRepoUrl = stdout.trim();
+    })).stdout.trim();
     // The source branch; defaults to the currently checked out branch
     const sourceBranch = process.env.CURRENT_BRANCH ??
-        exec('git rev-parse --abbrev-ref HEAD', {
-            log: false,
-            failfast: true,
-        })
-            ?.stdout?.toString()
-            .trim();
+        (await exec('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { log: false })).stdout.trim();
     const gitUser = process.env.GIT_USER;
     let useSSH = process.env.USE_SSH !== undefined &&
         process.env.USE_SSH.toLowerCase() === 'true';
@@ -116,10 +103,7 @@ 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) {
-        exec('echo "Skipping deploy on a pull request."', {
-            log: false,
-            failfast: true,
-        });
+        logger_1.default.info('Skipping deploy on a pull request.');
         process.exit(0);
     }
     // github.io indicates organization repos that deploy via default branch. All
@@ -158,7 +142,7 @@ 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 = exec('git rev-parse HEAD')?.stdout?.toString().trim();
+    const currentCommit = (await exec('git', ['rev-parse', 'HEAD'])).stdout.trim();
     const runDeploy = async (outputDirectory) => {
         const targetDirectory = cliOptions.targetDir ?? '.';
         const fromPath = outputDirectory;
@@ -167,43 +151,47 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
         // 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 (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}`);
+        const cloneResult = await exec('git', [
+            'clone',
+            '--depth',
+            '1',
+            '--branch',
+            deploymentBranch,
+            deploymentRepoURL,
+            toPath,
+        ], { failfast: false });
+        if (cloneResult.exitCode !== 0) {
+            await exec('git', ['clone', '--depth', '1', deploymentRepoURL, toPath]);
+            await exec('git', ['checkout', '-b', deploymentBranch]);
         }
         // Clear out any existing contents in the target directory
-        exec(`git rm -rf ${escapeArg(targetDirectory)}`, {
-            log: false,
-            failfast: true,
-        });
+        await exec('git', ['rm', '-rf', targetDirectory], { log: false });
         const targetPath = path_1.default.join(toPath, targetDirectory);
         try {
             await fs_extra_1.default.copy(fromPath, targetPath);
         }
         catch (err) {
-            logger_1.default.error `Copying build assets from path=${fromPath} to path=${targetPath} failed.`;
-            throw err;
+            throw new Error(`Failed to copy build assets from path=${fromPath} to path=${targetPath}.`, { cause: err });
         }
-        exec('git add --all', { failfast: true });
+        await exec('git', ['add', '--all']);
         const gitUserName = process.env.GIT_USER_NAME;
         if (gitUserName) {
-            exec(`git config user.name ${escapeArg(gitUserName)}`, { failfast: true });
+            await exec('git', ['config', 'user.name', gitUserName]);
         }
         const gitUserEmail = process.env.GIT_USER_EMAIL;
         if (gitUserEmail) {
-            exec(`git config user.email ${escapeArg(gitUserEmail)}`, {
-                failfast: true,
-            });
+            await exec('git', ['config', 'user.email', gitUserEmail]);
         }
         const commitMessage = process.env.CUSTOM_COMMIT_MESSAGE ??
             `Deploy website - based on ${currentCommit}`;
-        const commitResults = exec(`git commit -m ${escapeArg(commitMessage)} --allow-empty`);
-        if (exec(`git push --force origin ${deploymentBranch}`).exitCode !== 0) {
+        // The commit might return a non-zero value when site is up to date.
+        const commitResults = await exec('git', ['commit', '-m', commitMessage, '--allow-empty'], { failfast: false });
+        const pushResult = await exec('git', ['push', '--force', 'origin', deploymentBranch], { failfast: false });
+        if (pushResult.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.exitCode === 0) {
-            // The commit might return a non-zero value when site is up to date.
-            let websiteURL = '';
+            let websiteURL;
             if (githubHost === 'github.com') {
                 websiteURL = projectName.includes('.github.io')
                     ? `https://${organizationName}.github.io/`
@@ -213,13 +201,8 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
                 // GitHub enterprise hosting.
                 websiteURL = `https://${githubHost}/pages/${organizationName}/${projectName}/`;
             }
-            try {
-                exec(`echo "Website is live at ${websiteURL}."`, { failfast: true });
-                process.exit(0);
-            }
-            catch (err) {
-                throw new Error(`Failed to execute command: ${err}`);
-            }
+            logger_1.default.success `Website is live at url=${websiteURL}.`;
+            process.exit(0);
         }
     };
     if (!cliOptions.skipBuild) {

package/lib/commands/serve.js

@@ -57,7 +57,7 @@ async function serve(siteDirParam = '.', cliOptions = {}) {
         if (baseUrl !== '/') {
             // Not super robust, but should be good enough for our use case
             // See https://github.com/facebook/docusaurus/pull/10090
-            const looksLikeAsset = !!req.url.match(/\.[a-zA-Z\d]{1,4}$/);
+            const looksLikeAsset = !!req.url.match(/\.[a-z\d]{1,4}$/i);
             if (!looksLikeAsset) {
                 const normalizedUrl = (0, utils_common_1.applyTrailingSlash)(req.url, {
                     trailingSlash,

package/lib/commands/start/start.d.ts

@@ -11,5 +11,8 @@ export type StartCLIOptions = HostPortOptions & Pick<LoadContextParams, 'locale'
     open?: boolean;
     poll?: boolean | number;
     minify?: boolean;
+    https?: true;
+    sslCert?: string;
+    sslKey?: string;
 };
 export declare function start(siteDirParam?: string, cliOptions?: Partial<StartCLIOptions>): Promise<void>;

package/lib/commands/start/webpack.js

@@ -42,13 +42,9 @@ async function createDevServerConfig({ cliOptions, props, host, port, }) {
     const { baseUrl, siteDir, siteConfig } = props;
     const pollingOptions = (0, watcher_1.createPollingOptions)(cliOptions);
     const httpsConfig = await (0, getHttpsConfig_1.default)({
-    /*
-    TODO Docusaurus v4: wire new CLI parameters
-    https: cliOptions.https,
-    sslCert: cliOptions.sslCert,
-    sslKey: cliOptions.sslKey,
-
-     */
+        https: cliOptions.https,
+        sslCert: cliOptions.sslCert,
+        sslKey: cliOptions.sslKey,
     });
     // https://webpack.js.org/configuration/dev-server
     return {
@@ -142,5 +138,19 @@ async function createWebpackDevServer({ props, cliOptions, openUrlContext, }) {
     });
     // Allow plugin authors to customize/override devServer config
     const devServerConfig = (0, webpack_merge_1.default)([defaultDevServerConfig, config.devServer].filter(Boolean));
-    return new webpack_dev_server_1.default(devServerConfig, compiler);
+    return createDevServer({
+        devServerConfig,
+        compiler,
+        currentBundler: props.currentBundler,
+    });
+}
+async function createDevServer({ devServerConfig, compiler, currentBundler, }) {
+    if (currentBundler.name === 'webpack') {
+        return new webpack_dev_server_1.default(devServerConfig, compiler);
+    }
+    else {
+        const RspackDevServer = await (0, bundler_1.importRspackDevServer)();
+        // @ts-expect-error: different types
+        return new RspackDevServer(devServerConfig, compiler);
+    }
 }

package/lib/commands/swizzle/actions.js

@@ -39,6 +39,11 @@ async function eject({ siteDir, themePath, componentName, typescript, }) {
         : `${fromPath}.*`;
     const globPatternPosix = (0, utils_1.posixPath)(globPattern);
     const filesToCopy = await (0, utils_1.Globby)(globPatternPosix, {
+        // Workaround for Tinyglobby bug?
+        // We glob absolute from the theme root path, not from cwd
+        // See https://github.com/SuperchupuDev/tinyglobby/issues/186
+        cwd: themePath,
+        absolute: true,
         ignore: lodash_1.default.compact([
             '**/*.{story,stories,test,tests}.{js,jsx,ts,tsx}',
             // When ejecting JS components, we want to avoid emitting TS files

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

@@ -15,7 +15,7 @@ const tslib_1 = require("tslib");
 /* eslint-disable */
 const child_process_1 = require("child_process");
 const util_1 = require("util");
-const open_1 = tslib_1.__importDefault(require("open"));
+const open_1 = tslib_1.__importStar(require("open"));
 const logger_1 = require("@docusaurus/logger");
 const execPromise = (0, util_1.promisify)(child_process_1.exec);
 // Not sure if we need this, but let's keep a secret escape hatch
@@ -101,9 +101,9 @@ function toOpenApp(params) {
         return undefined;
     }
     // Handles "cross-platform" shortcuts like "chrome", "firefox", "edge"
-    if (open_1.default.apps[params.browser]) {
+    if (open_1.apps[params.browser]) {
         return {
-            name: open_1.default.apps[params.browser],
+            name: open_1.apps[params.browser],
             arguments: params.browserArgs,
         };
     }

package/lib/commands/writeHeadingIds.js

@@ -63,9 +63,9 @@ async function writeHeadingIds(siteDirParam = '.', files = [], options = {}) {
     validateOptions(options);
     const siteDir = await fs_extra_1.default.realpath(siteDirParam);
     const patterns = files.length ? files : await getPathsToWatch(siteDir);
-    const markdownFiles = await (0, utils_1.safeGlobby)(patterns, {
-        expandDirectories: ['**/*.{md,mdx}'],
-    });
+    const markdownFiles = (await (0, utils_1.safeGlobby)(patterns, {
+        expandDirectories: true,
+    })).filter((file) => file.endsWith('.md') || file.endsWith('.mdx'));
     if (markdownFiles.length === 0) {
         logger_1.default.warn `No markdown files found in siteDir path=${siteDir} for patterns: ${patterns}`;
         return;

package/lib/server/codegen/codegenRoutes.js

@@ -85,7 +85,6 @@ ${indent(parts.join(',\n'))}
 }
 const isModule = (value) => typeof value === 'string' ||
     (typeof value === 'object' &&
-        // eslint-disable-next-line no-underscore-dangle
         !!value?.__import);
 /**
  * Takes a {@link Module} (which is nothing more than a path plus some metadata

package/lib/server/config.js

@@ -33,7 +33,7 @@ async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
     if (!(await fs_extra_1.default.pathExists(siteConfigPath))) {
         throw new Error(`Config file at "${siteConfigPath}" not found.`);
     }
-    const importedConfig = await (0, utils_1.loadFreshModule)(siteConfigPath);
+    const importedConfig = await (0, utils_1.loadFreshModule)(siteConfigPath, { default: true });
     const loadedConfig = typeof importedConfig === 'function'
         ? await importedConfig()
         : await importedConfig;

package/lib/server/configValidation.js

@@ -16,15 +16,14 @@ const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const DEFAULT_I18N_LOCALE = 'en';
 const SiteUrlSchema = utils_validation_1.Joi.string()
     .custom((value, helpers) => {
-    try {
-        const { pathname } = new URL(value);
-        if (pathname !== '/') {
-            return helpers.error('docusaurus.subPathError', { pathname });
-        }
-    }
-    catch {
+    const url = URL.parse(value);
+    if (url === null) {
         return helpers.error('any.invalid');
     }
+    const { pathname } = url;
+    if (pathname !== '/') {
+        return helpers.error('docusaurus.subPathError', { pathname });
+    }
     return (0, utils_common_1.removeTrailingSlash)(value);
 })
     .messages({
@@ -70,7 +69,6 @@ exports.DEFAULT_FASTER_CONFIG_TRUE = {
     gitEagerVcs: true,
 };
 exports.DEFAULT_FUTURE_V4_CONFIG = {
-    removeLegacyPostBuildHeadAttribute: false,
     useCssCascadeLayers: false,
     siteStorageNamespacing: false,
     fasterByDefault: false,
@@ -78,7 +76,6 @@ exports.DEFAULT_FUTURE_V4_CONFIG = {
 };
 // When using the "v4: true" shortcut
 exports.DEFAULT_FUTURE_V4_CONFIG_TRUE = {
-    removeLegacyPostBuildHeadAttribute: true,
     useCssCascadeLayers: true,
     siteStorageNamespacing: true,
     fasterByDefault: true,
@@ -93,6 +90,7 @@ exports.DEFAULT_FUTURE_CONFIG = {
 exports.DEFAULT_MARKDOWN_HOOKS = {
     onBrokenMarkdownLinks: 'warn',
     onBrokenMarkdownImages: 'throw',
+    onUnusedMarkdownDirectives: 'warn',
 };
 exports.DEFAULT_MARKDOWN_MDX1COMPAT = {
     comments: true,
@@ -227,7 +225,6 @@ const FASTER_CONFIG_SCHEMA = utils_validation_1.Joi.alternatives()
     .optional();
 const FUTURE_V4_SCHEMA = utils_validation_1.Joi.alternatives()
     .try(utils_validation_1.Joi.object({
-    removeLegacyPostBuildHeadAttribute: utils_validation_1.Joi.boolean().default(exports.DEFAULT_FUTURE_V4_CONFIG.removeLegacyPostBuildHeadAttribute),
     useCssCascadeLayers: utils_validation_1.Joi.boolean().default(exports.DEFAULT_FUTURE_V4_CONFIG.useCssCascadeLayers),
     siteStorageNamespacing: utils_validation_1.Joi.boolean().default(exports.DEFAULT_FUTURE_V4_CONFIG.siteStorageNamespacing),
     fasterByDefault: utils_validation_1.Joi.boolean().default(exports.DEFAULT_FUTURE_V4_CONFIG.fasterByDefault),
@@ -415,6 +412,9 @@ exports.ConfigSchema = utils_validation_1.Joi.object({
             onBrokenMarkdownImages: utils_validation_1.Joi.alternatives()
                 .try(utils_validation_1.Joi.string().equal('ignore', 'log', 'warn', 'throw'), utils_validation_1.Joi.function())
                 .default(exports.DEFAULT_CONFIG.markdown.hooks.onBrokenMarkdownImages),
+            onUnusedMarkdownDirectives: utils_validation_1.Joi.alternatives()
+                .try(utils_validation_1.Joi.string().equal('ignore', 'log', 'warn', 'throw'), utils_validation_1.Joi.function())
+                .default(exports.DEFAULT_CONFIG.markdown.hooks.onUnusedMarkdownDirectives),
         }).default(exports.DEFAULT_CONFIG.markdown.hooks),
     }).default({
         ...exports.DEFAULT_CONFIG.markdown,
@@ -470,12 +470,6 @@ Please migrate and move this option to code=${'siteConfig.markdown.hooks.onBroke
             : (0, utils_1.getVcsPreset)('disabled');
         config.future.experimental_vcs = vcsConfig;
     }
-    if (config.future.faster.ssgWorkerThreads &&
-        !config.future.v4.removeLegacyPostBuildHeadAttribute) {
-        throw new Error(`Docusaurus config ${logger_1.default.code('future.faster.ssgWorkerThreads')} requires the future flag ${logger_1.default.code('future.v4.removeLegacyPostBuildHeadAttribute')} to be turned on.
-If you use Docusaurus Faster, we recommend that you also activate Docusaurus v4 future flags: ${logger_1.default.code('{future: {v4: true}}')}
-All the v4 future flags are documented here: https://docusaurus.io/docs/api/docusaurus-config#future`);
-    }
     if (config.future.faster.rspackPersistentCache &&
         !config.future.faster.rspackBundler) {
         throw new Error(`Docusaurus config flag ${logger_1.default.code('future.faster.rspackPersistentCache')} requires the flag ${logger_1.default.code('future.faster.rspackBundler')} to be turned on.`);

package/lib/server/htmlTags.js

@@ -9,8 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadHtmlTags = loadHtmlTags;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
-const html_tags_1 = tslib_1.__importDefault(require("html-tags"));
-const void_1 = tslib_1.__importDefault(require("html-tags/void"));
+const html_tags_1 = tslib_1.__importStar(require("html-tags"));
 const escape_html_1 = tslib_1.__importDefault(require("escape-html"));
 // TODO this should be done at config validation time, not here
 function assertIsHtmlTagObject(val) {
@@ -34,7 +33,7 @@ function hashRouterAbsoluteToRelativeTagAttribute(name, value) {
 }
 function htmlTagObjectToString({ tag, router, }) {
     assertIsHtmlTagObject(tag);
-    const isVoidTag = void_1.default.includes(tag.tagName);
+    const isVoidTag = html_tags_1.voidHtmlTags.includes(tag.tagName);
     const tagAttributes = tag.attributes ?? {};
     const attributes = Object.keys(tagAttributes)
         .map((attr) => {

package/lib/server/i18n.js

@@ -23,7 +23,7 @@ function inferLanguageDisplayName(locale) {
                 fallback: 'code',
             }).of(l);
         }
-        catch (e) {
+        catch {
             // This is to compensate "of()" that is a bit strict
             // Looks like starting Node 22, this locale throws: "en-US-u-ca-buddhist"
             // RangeError: invalid_argument
@@ -64,11 +64,7 @@ function getDefaultDirection(localeStr) {
     const locale = new Intl.Locale(localeStr);
     // see https://github.com/tc39/proposal-intl-locale-info
     // see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTextInfo
-    // Node 18.0 implements a former version of the getTextInfo() proposal
-    // TODO Docusaurus v4: remove the fallback to locale.textInfo
-    // @ts-expect-error: The TC39 proposal was updated
-    const textInto = locale.getTextInfo?.() ?? locale.textInfo;
-    return textInto.direction ?? 'ltr';
+    return locale.getTextInfo().direction ?? 'ltr';
 }
 function getDefaultLocaleConfig(
 // Locale "key/identifier"

package/lib/server/plugins/plugins.js

@@ -169,15 +169,7 @@ async function reloadPlugin({ pluginIdentifier, plugins: previousPlugins, contex
             plugin: previousPlugin,
             context,
         });
-        /*
-      // TODO Docusaurus v4 - upgrade to Node 20, use array.with()
-      const plugins = previousPlugins.with(
-        previousPlugins.indexOf(previousPlugin),
-        plugin,
-      );
-       */
-        const plugins = [...previousPlugins];
-        plugins[previousPlugins.indexOf(previousPlugin)] = plugin;
+        const plugins = previousPlugins.with(previousPlugins.indexOf(previousPlugin), plugin);
         const allContentLoadedResult = await executeAllPluginsAllContentLoaded({
             plugins,
             context,

package/lib/server/site.js

@@ -37,7 +37,7 @@ 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 { siteVersion, loadSiteConfig: { siteConfig: initialSiteConfig, siteConfigPath }, } = await (0, combine_promises_1.default)({
-        siteVersion: (0, siteMetadata_1.loadSiteVersion)(siteDir),
+        siteVersion: (0, siteMetadata_1.tryLoadSitePackageJson)(siteDir).then((pkg) => pkg?.version),
         loadSiteConfig: (0, config_1.loadSiteConfig)({
             siteDir,
             customConfigFilePath,

package/lib/server/siteMetadata.d.ts

@@ -5,9 +5,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadedPlugin, PluginVersionInformation, SiteMetadata } from '@docusaurus/types';
-export declare function loadSiteVersion(siteDir: string): Promise<string | undefined>;
+type PackageJson = {
+    name?: string;
+    version?: string;
+};
+export declare function tryLoadSitePackageJson(siteDir: string): Promise<PackageJson | undefined>;
 export declare function loadPluginVersion(pluginPath: string, siteDir: string): Promise<PluginVersionInformation>;
 export declare function createSiteMetadata({ siteVersion, plugins, }: {
     siteVersion: string | undefined;
     plugins: LoadedPlugin[];
 }): SiteMetadata;
+export {};

package/lib/server/siteMetadata.js

@@ -6,26 +6,28 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadSiteVersion = loadSiteVersion;
+exports.tryLoadSitePackageJson = tryLoadSitePackageJson;
 exports.loadPluginVersion = loadPluginVersion;
 exports.createSiteMetadata = createSiteMetadata;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
-async function loadPackageJsonVersion(packageJsonPath) {
+async function tryLoadPackageJson(packageJsonPath) {
     if (await fs_extra_1.default.pathExists(packageJsonPath)) {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
-        return require(packageJsonPath).version;
+        try {
+            return (await fs_extra_1.default.readJSON(packageJsonPath));
+        }
+        catch (error) {
+            throw new Error(`Couldn't load package.json file at ${packageJsonPath}`, {
+                cause: error,
+            });
+        }
     }
     return undefined;
 }
-async function loadPackageJsonName(packageJsonPath) {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
-    return require(packageJsonPath).name;
-}
-async function loadSiteVersion(siteDir) {
-    return loadPackageJsonVersion(path_1.default.join(siteDir, 'package.json'));
+async function tryLoadSitePackageJson(siteDir) {
+    return tryLoadPackageJson(path_1.default.join(siteDir, 'package.json'));
 }
 async function loadPluginVersion(pluginPath, siteDir) {
     let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
@@ -38,10 +40,11 @@ async function loadPluginVersion(pluginPath, siteDir) {
                 // as local plugin.
                 return { type: 'project' };
             }
+            const packageJson = await tryLoadPackageJson(packageJsonPath);
             return {
                 type: 'package',
-                name: await loadPackageJsonName(packageJsonPath),
-                version: await loadPackageJsonVersion(packageJsonPath),
+                name: packageJson?.name,
+                version: packageJson?.version,
             };
         }
         potentialPluginPackageJsonDirectory = path_1.default.dirname(potentialPluginPackageJsonDirectory);

package/lib/server/translations/translations.js

@@ -62,7 +62,7 @@ function mergeTranslationFileContent({ existingContent = {}, newContent, options
             // If messages already exist, we don't override them (unless requested)
             message: options.override
                 ? message
-                : existingContent[key]?.message ?? message,
+                : (existingContent[key]?.message ?? message),
             description,
         };
     });

package/lib/ssg/ssgEnv.js

@@ -9,9 +9,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SSGWorkerThreadRecyclerMaxMemory = exports.SSGWorkerThreadTaskSize = exports.SSGWorkerThreadCount = exports.SSGConcurrency = void 0;
 // Secret way to set SSR plugin async concurrency option
 // Waiting for feedback before documenting this officially?
-// TODO Docusaurus v4, rename SSR => SSG
-exports.SSGConcurrency = process.env.DOCUSAURUS_SSR_CONCURRENCY
-    ? parseInt(process.env.DOCUSAURUS_SSR_CONCURRENCY, 10)
+exports.SSGConcurrency = process.env.DOCUSAURUS_SSG_CONCURRENCY
+    ? parseInt(process.env.DOCUSAURUS_SSG_CONCURRENCY, 10)
     : // Not easy to define a reasonable option default
         // Will still be better than Infinity
         // See also https://github.com/sindresorhus/p-map/issues/24

package/lib/ssg/ssgExecutor.js

@@ -51,11 +51,7 @@ function getNumberOfThreads(pathnames) {
         return ssgEnv_1.SSGWorkerThreadCount;
     }
     // See also https://github.com/tinylibs/tinypool/pull/108
-    const cpuCount = 
-    // TODO Docusaurus v4: bump node, availableParallelism() now always exists
-    typeof os_1.default.availableParallelism === 'function'
-        ? os_1.default.availableParallelism()
-        : os_1.default.cpus().length;
+    const cpuCount = os_1.default.availableParallelism();
     return inferNumberOfThreads({
         pageCount: pathnames.length,
         cpuCount,
@@ -64,6 +60,21 @@ function getNumberOfThreads(pathnames) {
         minPagesPerCpu: 100,
     });
 }
+// Workaround for Node styleText() limitation
+// See https://github.com/nodejs/node/issues/65766
+function getWorkerColorEnv() {
+    // Preserve an explicit user choice
+    if (process.env.FORCE_COLOR !== undefined) {
+        return {};
+    }
+    const depth = process.stdout.isTTY
+        ? (process.stdout.getColorDepth?.() ?? 0)
+        : 0;
+    if (depth > 2) {
+        return { FORCE_COLOR: depth >= 24 ? '3' : depth >= 8 ? '2' : '1' };
+    }
+    return {};
+}
 const createPooledSSGExecutor = async ({ params, pathnames, }) => {
     const numberOfThreads = getNumberOfThreads(pathnames);
     // When the inferred or provided number of threads is just 1
@@ -84,6 +95,12 @@ const createPooledSSGExecutor = async ({ params, pathnames, }) => {
             runtime: 'worker_threads',
             isolateWorkers: false,
             workerData: { params },
+            env: {
+                // Cast is safe
+                // See https://github.com/tinylibs/tinypool/issues/136
+                ...process.env,
+                ...getWorkerColorEnv(),
+            },
             // WORKER MEMORY MANAGEMENT
             // Allows containing SSG memory leaks with a thread recycling workaround
             // See https://github.com/facebook/docusaurus/pull/11166

package/lib/ssg/ssgGlobalResult.js

@@ -17,20 +17,11 @@ function printSSGWarnings(results) {
     if (process.env.DOCUSAURUS_IGNORE_SSG_WARNINGS === 'true') {
         return;
     }
-    const ignoredWarnings = [
-        // TODO Docusaurus v4: remove with React 19 upgrade
-        //  React 18 emit NULL chars, and minifier detects it
-        //  see https://github.com/facebook/docusaurus/issues/9985
-        'Unexpected null character',
-    ];
-    const keepWarning = (warning) => {
-        return !ignoredWarnings.some((iw) => warning.includes(iw));
-    };
     const resultsWithWarnings = results
         .map((success) => {
         return {
             ...success,
-            warnings: success.result.warnings.filter(keepWarning),
+            warnings: success.result.warnings,
         };
     })
         .filter((result) => result.warnings.length > 0);

package/lib/ssg/ssgParams.d.ts

@@ -20,7 +20,6 @@ export type SSGParams = {
     htmlMinifierType: HtmlMinifierType;
     serverBundlePath: string;
     ssgTemplateContent: string;
-    v4RemoveLegacyPostBuildHeadAttribute: boolean;
 };
 export declare function createSSGParams({ props, serverBundlePath, clientManifestPath, }: {
     props: Props;

package/lib/ssg/ssgParams.js

@@ -29,7 +29,6 @@ async function createSSGParams({ props, serverBundlePath, clientManifestPath, })
         htmlMinifierType: props.siteConfig.future.faster.swcHtmlMinimizer
             ? 'swc'
             : 'terser',
-        v4RemoveLegacyPostBuildHeadAttribute: props.siteConfig.future.v4.removeLegacyPostBuildHeadAttribute,
     };
     // Useless but ensures that SSG params remain serializable
     return structuredClone(params);

package/lib/ssg/ssgRenderer.js

@@ -86,7 +86,6 @@ function reduceCollectedData(pageCollectedData) {
         anchors: pageCollectedData.anchors,
         metadata: {
             public: pageCollectedData.metadata.public,
-            helmet: pageCollectedData.metadata.helmet,
         },
         links: pageCollectedData.links,
     };
@@ -94,10 +93,7 @@ function reduceCollectedData(pageCollectedData) {
 async function generateStaticFile({ pathname, appRenderer, params, htmlMinifier, ssgTemplate, }) {
     try {
         // This only renders the app HTML
-        const appRenderResult = await appRenderer.render({
-            pathname,
-            v4RemoveLegacyPostBuildHeadAttribute: params.v4RemoveLegacyPostBuildHeadAttribute,
-        });
+        const appRenderResult = await appRenderer.render({ pathname });
         // This renders the full page HTML, including head tags...
         const fullPageHtml = (0, ssgTemplate_1.renderSSGTemplate)({
             params,

package/lib/ssg/ssgTemplate.js

@@ -9,15 +9,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.compileSSGTemplate = compileSSGTemplate;
 exports.renderSSGTemplate = renderSSGTemplate;
 exports.renderHashRouterTemplate = renderHashRouterTemplate;
-const tslib_1 = require("tslib");
-const eta = tslib_1.__importStar(require("eta"));
+const eta_1 = require("eta");
 const react_loadable_ssr_addon_v5_slorber_1 = require("react-loadable-ssr-addon-v5-slorber");
 const logger_1 = require("@docusaurus/logger");
 async function compileSSGTemplate(template) {
-    const compiledTemplate = eta.compile(template.trim(), {
-        rmWhitespace: true,
-    });
-    return (data) => compiledTemplate(data, eta.defaultConfig);
+    const eta = new eta_1.Eta({ rmWhitespace: true });
+    const compiledTemplate = eta.compile(template.trim());
+    return (data) => eta.render(compiledTemplate, data);
 }
 /**
  * Given a list of modules that were SSR an d

package/lib/ssg/ssgWorkerThread.js

@@ -11,7 +11,6 @@ const tslib_1 = require("tslib");
 const node_worker_threads_1 = require("node:worker_threads");
 const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
 const ssgRenderer_js_1 = require("./ssgRenderer.js");
-// eslint-disable-next-line no-underscore-dangle
 const workerId = process?.__tinypool_state__?.workerId;
 if (!workerId) {
     throw new Error('SSG Worker Thread not executing in Tinypool context?');

package/lib/webpack/base.js

@@ -87,9 +87,14 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
         }
         if (props.currentBundler.name === 'rspack') {
             if (props.siteConfig.future.faster.rspackPersistentCache) {
-                // Use cache: true + experiments.cache.type: "persistent"
-                // See https://rspack.dev/config/experiments#persistent-cache
-                return true;
+                return {
+                    type: 'persistent',
+                    // Rspack doesn't have "cache.name" like Webpack
+                    // This is not ideal but work around is to merge name/version
+                    // See https://github.com/web-infra-dev/rspack/pull/8920#issuecomment-2658938695
+                    version: `${getCacheName()}-${getCacheVersion()}`,
+                    buildDependencies: getCacheBuildDependencies(),
+                };
             }
             else {
                 return disabledPersistentCacheValue;
@@ -104,29 +109,10 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
             },
         };
     }
-    function getExperiments() {
-        if (props.currentBundler.name === 'rspack') {
-            // TODO find a way to type this
-            const experiments = {};
-            if (!process.env.DOCUSAURUS_NO_PERSISTENT_CACHE) {
-                experiments.cache = {
-                    type: 'persistent',
-                    // Rspack doesn't have "cache.name" like Webpack
-                    // This is not ideal but work around is to merge name/version
-                    // See https://github.com/web-infra-dev/rspack/pull/8920#issuecomment-2658938695
-                    version: `${getCacheName()}-${getCacheVersion()}`,
-                    buildDependencies: getCacheBuildDependencies(),
-                };
-            }
-            return experiments;
-        }
-        return undefined;
-    }
     return {
         mode,
         name,
         cache: getCache(),
-        experiments: getExperiments(),
         output: {
             pathinfo: false,
             path: outDir,
@@ -251,6 +237,10 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
                             // See https://github.com/facebook/docusaurus/pull/10423
                             localIdentName: `[local]_[contenthash:base64:4]`,
                             exportOnlyLocals: isServer,
+                            // Export CSS module class names compatible with css-loader v6
+                            // export ".themedComponent--dark" instead of .themedComponentDark
+                            // See https://github.com/webpack/css-loader/releases/tag/v7.0.0
+                            exportLocalsConvention: 'as-is',
                         },
                         importLoaders: 1,
                         sourceMap: !isProd,

package/lib/webpack/server.js

@@ -35,7 +35,7 @@ async function createServerConfig({ props, configureWebpackUtils, }) {
         output: {
             path: outputDir,
             filename: outputFilename,
-            libraryTarget: 'commonjs2',
+            library: { type: 'commonjs2' },
         },
         plugins: [
             new ProgressBarPlugin({

package/lib/webpack/utils/getHttpsConfig.js

@@ -40,10 +40,10 @@ function validateKeyAndCerts({ cert, key }) {
 function getExplicitHttps(options) {
     return (options.https ??
         (typeof process.env.DOCUSAURUS_HTTPS !== 'undefined'
-            ? process.env.DOCUSAURUS_HTTPS === 'true'
+            ? process.env.DOCUSAURUS_HTTPS == 'true'
             : undefined) ??
         (typeof process.env.HTTPS !== 'undefined'
-            ? process.env.HTTPS === 'true'
+            ? process.env.HTTPS == 'true'
             : undefined));
 }
 async function readCryptoFile(filepath, source) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "3.10.2",
+  "version": "4.0.0-canary-6808",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,31 +33,30 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "3.10.2",
-    "@docusaurus/bundler": "3.10.2",
-    "@docusaurus/logger": "3.10.2",
-    "@docusaurus/mdx-loader": "3.10.2",
-    "@docusaurus/utils": "3.10.2",
-    "@docusaurus/utils-common": "3.10.2",
-    "@docusaurus/utils-validation": "3.10.2",
+    "@docusaurus/babel": "4.0.0-canary-6808",
+    "@docusaurus/bundler": "4.0.0-canary-6808",
+    "@docusaurus/logger": "4.0.0-canary-6808",
+    "@docusaurus/mdx-loader": "4.0.0-canary-6808",
+    "@docusaurus/utils": "4.0.0-canary-6808",
+    "@docusaurus/utils-common": "4.0.0-canary-6808",
+    "@docusaurus/utils-validation": "4.0.0-canary-6808",
     "boxen": "^6.2.1",
-    "chalk": "^4.1.2",
-    "chokidar": "^3.5.3",
-    "cli-table3": "^0.6.3",
-    "combine-promises": "^1.1.0",
+    "chokidar": "^3.6.0",
+    "cli-table3": "^0.6.5",
+    "combine-promises": "^1.2.0",
     "commander": "^5.1.0",
-    "core-js": "^3.31.1",
+    "core-js": "^3.50.0",
     "detect-port": "^2.1.0",
     "escape-html": "^1.0.3",
-    "eta": "^2.2.0",
+    "eta": "^4.6.0",
     "eval": "^0.1.8",
-    "execa": "^5.1.1",
-    "fs-extra": "^11.1.1",
-    "html-tags": "^3.3.1",
-    "html-webpack-plugin": "^5.6.0",
+    "execa": "^10.0.1",
+    "fs-extra": "^11.4.0",
+    "html-tags": "^5.1.0",
+    "html-webpack-plugin": "^5.6.8",
     "leven": "^3.1.0",
-    "lodash": "^4.17.21",
-    "open": "^8.4.0",
+    "lodash": "^4.18.1",
+    "open": "^11.0.2",
     "p-map": "^4.0.0",
     "prompts": "^2.4.2",
     "react-helmet-async": "npm:@slorber/react-helmet-async@1.3.0",
@@ -66,34 +65,36 @@
     "react-router": "^5.3.4",
     "react-router-config": "^5.1.1",
     "react-router-dom": "^5.3.4",
-    "semver": "^7.5.4",
+    "semver": "^7.8.5",
     "serve-handler": "^6.1.7",
-    "tinypool": "^1.0.2",
-    "tslib": "^2.6.0",
+    "tinypool": "^2.1.2",
+    "tslib": "^2.8.1",
     "update-notifier": "^6.0.2",
-    "webpack": "^5.95.0",
-    "webpack-bundle-analyzer": "^4.10.2",
-    "webpack-dev-server": "^5.2.2",
+    "webpack": "^5.110.3",
+    "webpack-bundle-analyzer": "^5.3.2",
+    "webpack-dev-server": "^6.0.0",
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.10.2",
-    "@docusaurus/types": "3.10.2",
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6808",
+    "@docusaurus/types": "4.0.0-canary-6808",
     "@total-typescript/shoehorn": "^0.1.2",
-    "@types/react-dom": "^19.2.3",
-    "@types/react-router-config": "^5.0.7",
+    "@types/escape-html": "^1.0.4",
+    "@types/history": "^4.7.11",
+    "@types/react-dom": "^19.3.0",
+    "@types/react-router-config": "^5.0.11",
+    "@types/react-router-dom": "^5.3.3",
     "@types/serve-handler": "^6.1.4",
-    "@types/update-notifier": "^6.0.4",
+    "@types/update-notifier": "^6.0.8",
     "@types/webpack-bundle-analyzer": "^4.7.0",
     "@types/webpack-env": "^1.18.8",
-    "tmp-promise": "^3.0.3",
-    "tree-node-cli": "^1.6.0"
+    "tree-node-cli": "^3.0.0"
   },
   "peerDependencies": {
-    "@docusaurus/faster": "*",
-    "@mdx-js/react": "^3.0.0",
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "@docusaurus/faster": "4.0.0-canary-6808",
+    "@mdx-js/react": "^3.1.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
   "peerDependenciesMeta": {
     "@docusaurus/faster": {
@@ -101,7 +102,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0"
+    "node": ">=24.14"
   },
-  "gitHead": "f37f9035584917a97a260b91fc2842cba4f8b94f"
+  "gitHead": "91e445730a91fbe20dd5fefae560303a0c655aa7"
 }