@docusaurus/core 3.10.1-canary-6655 → 3.10.2

package/lib/client/BaseUrlIssueBanner/index.js

@@ -53,7 +53,7 @@ function insertBanner() {
   var suggestedBaseUrl = actualHomePagePath.substr(-1) === '/'
         ? actualHomePagePath
         : actualHomePagePath + '/';
-  suggestionContainer.innerHTML = suggestedBaseUrl;
+  suggestionContainer.textContent = suggestedBaseUrl;
 }
 `;
 }

package/lib/client/exports/ComponentCreator.js

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

package/lib/client/exports/Link.js

@@ -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 }) {
+function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLinkCheck': noBrokenLinkCheck, autoAddBaseUrl = true, ...props }, forwardedRef) {
     const { siteConfig } = useDocusaurusContext();
     const { trailingSlash, baseUrl } = siteConfig;
     const router = siteConfig.future.experimental_router;
     const { withBaseUrl } = useBaseUrlUtils();
     const brokenLinks = useBrokenLinks();
     const innerRef = useRef(null);
-    useImperativeHandle(props.ref, () => innerRef.current);
+    useImperativeHandle(forwardedRef, () => 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
@@ -139,4 +139,4 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
     // element"
     {...(isNavLink && { isActive, activeClassName })} {...testOnlyProps}/>);
 }
-export default Link;
+export default React.forwardRef(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-Z][A-Z\d+.-]*:|\/\/)/i.test(url);
+    return /^(?:[A-Za-z][A-Za-z\d+.-]*:|\/\/)/.test(url);
 }
 export default function isInternalUrl(url) {
     return typeof url !== 'undefined' && !hasProtocol(url);

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 }) => {
+const render = async ({ pathname, v4RemoveLegacyPostBuildHeadAttribute, }) => {
     await preload(pathname);
     const modules = new Set();
     const routerContext = {};
@@ -33,6 +33,11 @@ const render = async ({ pathname }) => {
     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,6 +23,7 @@ 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 type { BuildCLIOptions } from './build';
+import { BuildCLIOptions } from './build';
 export type BuildLocaleParams = {
     siteDir: string;
     locale: string;

package/lib/commands/build/buildLocale.js

@@ -99,6 +99,9 @@ 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) {
@@ -106,6 +109,7 @@ 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 type { BuildCLIOptions } from './build';
+import { 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,9 +109,21 @@ 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)')
-        .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.')
+        /*
+        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.',
+        )
+        */
         .action(start_1.start);
     cli
         .command('serve [siteDir]')

package/lib/commands/deploy.js

@@ -203,7 +203,7 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
         }
         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,8 +213,13 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
                 // GitHub enterprise hosting.
                 websiteURL = `https://${githubHost}/pages/${organizationName}/${projectName}/`;
             }
-            exec(`echo "Website is live at ${websiteURL}."`, { failfast: true });
-            process.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

@@ -19,6 +19,7 @@ const openBrowser_1 = tslib_1.__importDefault(require("./utils/openBrowser/openB
 const config_1 = require("../server/config");
 const build_1 = require("./build/build");
 const getHostPort_1 = require("../server/getHostPort");
+const listenToServer_1 = require("./utils/listenToServer");
 function redirect(res, location) {
     res.writeHead(302, {
         Location: location,
@@ -56,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-z\d]{1,4}$/i);
+            const looksLikeAsset = !!req.url.match(/\.[a-zA-Z\d]{1,4}$/);
             if (!looksLikeAsset) {
                 const normalizedUrl = (0, utils_common_1.applyTrailingSlash)(req.url, {
                     trailingSlash,
@@ -84,7 +85,7 @@ async function serve(siteDirParam = '.', cliOptions = {}) {
     });
     const url = servingUrl + baseUrl;
     logger_1.default.success `Serving path=${buildDir} directory at: url=${url}`;
-    server.listen(port);
+    await (0, listenToServer_1.listenToServer)({ server, host, port });
     if (cliOptions.open && !process.env.CI) {
         await (0, openBrowser_1.default)(url);
     }

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

@@ -11,8 +11,5 @@ 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

@@ -12,7 +12,6 @@ const path_1 = tslib_1.__importDefault(require("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"));
-// eslint-disable-next-line import/default
 const webpack_dev_server_1 = tslib_1.__importDefault(require("webpack-dev-server"));
 const evalSourceMapMiddleware_1 = tslib_1.__importDefault(require("../utils/legacy/evalSourceMapMiddleware"));
 const watcher_1 = require("./watcher");
@@ -43,9 +42,13 @@ 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)({
-        https: cliOptions.https,
-        sslCert: cliOptions.sslCert,
-        sslKey: cliOptions.sslKey,
+    /*
+    TODO Docusaurus v4: wire new CLI parameters
+    https: cliOptions.https,
+    sslCert: cliOptions.sslCert,
+    sslKey: cliOptions.sslKey,
+
+     */
     });
     // https://webpack.js.org/configuration/dev-server
     return {

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

@@ -0,0 +1,5 @@
+export declare function listenToServer({ server, port, host, }: {
+    server: import('node:http').Server;
+    port: number;
+    host: string;
+}): Promise<void>;

package/lib/commands/utils/listenToServer.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listenToServer = listenToServer;
+/**
+ * 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.
+ */
+const logger_1 = require("@docusaurus/logger");
+async function listenToServer({ server, port, host, }) {
+    return new Promise((resolve, reject) => {
+        server.once('listening', () => resolve());
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new Error(logger_1.logger.interpolate `Address in use, another server is already listening on the requested port number=${port} and host name=${host}`, { cause: err }));
+            }
+            else {
+                reject(err);
+            }
+        });
+        server.listen(port, host);
+    });
+}

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

@@ -51,7 +51,12 @@ async function tryOpenWithAppleScript({ url, browser, }) {
             ];
             // Among all the supported browsers, retrieves to stdout the active ones
             const command = `ps cax -o command | grep -E "^(${supportedChromiumBrowsers.join('|')})$"`;
-            const result = await Promise.try(() => execPromise(command)).catch(() => {
+            const result = await Promise
+                // TODO Docusaurus v4: use Promise.try()
+                // See why here https://github.com/facebook/docusaurus/issues/11204#issuecomment-3073480330
+                .resolve()
+                .then(() => execPromise(command))
+                .catch(() => {
                 // Ignore all errors
                 // In particular grep errors when macOS user has no Chromium-based browser open
                 // See https://github.com/facebook/docusaurus/issues/11204

package/lib/server/codegen/codegenRoutes.js

@@ -85,6 +85,7 @@ ${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, { default: true });
+    const importedConfig = await (0, utils_1.loadFreshModule)(siteConfigPath);
     const loadedConfig = typeof importedConfig === 'function'
         ? await importedConfig()
         : await importedConfig;

package/lib/server/configValidation.js

@@ -70,6 +70,7 @@ exports.DEFAULT_FASTER_CONFIG_TRUE = {
     gitEagerVcs: true,
 };
 exports.DEFAULT_FUTURE_V4_CONFIG = {
+    removeLegacyPostBuildHeadAttribute: false,
     useCssCascadeLayers: false,
     siteStorageNamespacing: false,
     fasterByDefault: false,
@@ -77,6 +78,7 @@ 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,
@@ -225,6 +227,7 @@ 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),
@@ -349,7 +352,7 @@ exports.ConfigSchema = utils_validation_1.Joi.object({
             is: utils_validation_1.Joi.valid(true),
             then: utils_validation_1.Joi.optional(),
             otherwise: utils_validation_1.Joi.object()
-                .pattern(/[\w-]+/, utils_validation_1.Joi.string())
+                .pattern(/[\w-]+/, utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.boolean()))
                 .required(),
         }),
         customElement: utils_validation_1.Joi.bool().default(false),
@@ -467,6 +470,12 @@ 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/getHostPort.js

@@ -69,8 +69,7 @@ Would you like to run the app on another port instead?`),
         return shouldChangePort ? port : null;
     }
     catch (err) {
-        logger_1.default.error `Could not find an open port at ${host}.`;
-        throw err;
+        throw new Error(logger_1.default.interpolate `Could not find an open port at ${host}.`, { cause: err });
     }
 }
 async function getHostPort(options) {

package/lib/server/i18n.js

@@ -23,7 +23,7 @@ function inferLanguageDisplayName(locale) {
                 fallback: 'code',
             }).of(l);
         }
-        catch {
+        catch (e) {
             // 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,7 +64,11 @@ 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
-    return locale.getTextInfo().direction ?? 'ltr';
+    // 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';
 }
 function getDefaultLocaleConfig(
 // Locale "key/identifier"

package/lib/server/plugins/plugins.js

@@ -169,7 +169,15 @@ async function reloadPlugin({ pluginIdentifier, plugins: previousPlugins, contex
             plugin: previousPlugin,
             context,
         });
-        const plugins = previousPlugins.with(previousPlugins.indexOf(previousPlugin), plugin);
+        /*
+      // 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 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.tryLoadSitePackageJson)(siteDir).then((pkg) => pkg?.version),
+        siteVersion: (0, siteMetadata_1.loadSiteVersion)(siteDir),
         loadSiteConfig: (0, config_1.loadSiteConfig)({
             siteDir,
             customConfigFilePath,

package/lib/server/siteMetadata.d.ts

@@ -5,14 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadedPlugin, PluginVersionInformation, SiteMetadata } from '@docusaurus/types';
-type PackageJson = {
-    name?: string;
-    version?: string;
-};
-export declare function tryLoadSitePackageJson(siteDir: string): Promise<PackageJson | undefined>;
+export declare function loadSiteVersion(siteDir: string): Promise<string | 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,28 +6,26 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tryLoadSitePackageJson = tryLoadSitePackageJson;
+exports.loadSiteVersion = loadSiteVersion;
 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 tryLoadPackageJson(packageJsonPath) {
+async function loadPackageJsonVersion(packageJsonPath) {
     if (await fs_extra_1.default.pathExists(packageJsonPath)) {
-        try {
-            return (await fs_extra_1.default.readJSON(packageJsonPath));
-        }
-        catch (error) {
-            throw new Error(`Couldn't load package.json file at ${packageJsonPath}`, {
-                cause: error,
-            });
-        }
+        // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
+        return require(packageJsonPath).version;
     }
     return undefined;
 }
-async function tryLoadSitePackageJson(siteDir) {
-    return tryLoadPackageJson(path_1.default.join(siteDir, 'package.json'));
+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 loadPluginVersion(pluginPath, siteDir) {
     let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
@@ -40,11 +38,10 @@ async function loadPluginVersion(pluginPath, siteDir) {
                 // as local plugin.
                 return { type: 'project' };
             }
-            const packageJson = await tryLoadPackageJson(packageJsonPath);
             return {
                 type: 'package',
-                name: packageJson?.name,
-                version: packageJson?.version,
+                name: await loadPackageJsonName(packageJsonPath),
+                version: await loadPackageJsonVersion(packageJsonPath),
             };
         }
         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,8 +9,9 @@ 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?
-exports.SSGConcurrency = process.env.DOCUSAURUS_SSG_CONCURRENCY
-    ? parseInt(process.env.DOCUSAURUS_SSG_CONCURRENCY, 10)
+// TODO Docusaurus v4, rename SSR => SSG
+exports.SSGConcurrency = process.env.DOCUSAURUS_SSR_CONCURRENCY
+    ? parseInt(process.env.DOCUSAURUS_SSR_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,7 +51,11 @@ function getNumberOfThreads(pathnames) {
         return ssgEnv_1.SSGWorkerThreadCount;
     }
     // See also https://github.com/tinylibs/tinypool/pull/108
-    const cpuCount = os_1.default.availableParallelism();
+    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;
     return inferNumberOfThreads({
         pageCount: pathnames.length,
         cpuCount,

package/lib/ssg/ssgGlobalResult.js

@@ -17,11 +17,20 @@ 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,
+            warnings: success.result.warnings.filter(keepWarning),
         };
     })
         .filter((result) => result.warnings.length > 0);

package/lib/ssg/ssgParams.d.ts

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

package/lib/ssg/ssgWorkerThread.js

@@ -11,6 +11,7 @@ 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/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.1-canary-6655",
+  "version": "3.10.2",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,13 +33,13 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "3.10.1-canary-6655",
-    "@docusaurus/bundler": "3.10.1-canary-6655",
-    "@docusaurus/logger": "3.10.1-canary-6655",
-    "@docusaurus/mdx-loader": "3.10.1-canary-6655",
-    "@docusaurus/utils": "3.10.1-canary-6655",
-    "@docusaurus/utils-common": "3.10.1-canary-6655",
-    "@docusaurus/utils-validation": "3.10.1-canary-6655",
+    "@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",
     "boxen": "^6.2.1",
     "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
@@ -47,14 +47,14 @@
     "combine-promises": "^1.1.0",
     "commander": "^5.1.0",
     "core-js": "^3.31.1",
-    "detect-port": "^1.5.1",
+    "detect-port": "^2.1.0",
     "escape-html": "^1.0.3",
     "eta": "^2.2.0",
     "eval": "^0.1.8",
     "execa": "^5.1.1",
-    "fs-extra": "^11.2.0",
+    "fs-extra": "^11.1.1",
     "html-tags": "^3.3.1",
-    "html-webpack-plugin": "^5.6.7",
+    "html-webpack-plugin": "^5.6.0",
     "leven": "^3.1.0",
     "lodash": "^4.17.21",
     "open": "^8.4.0",
@@ -66,34 +66,34 @@
     "react-router": "^5.3.4",
     "react-router-config": "^5.1.1",
     "react-router-dom": "^5.3.4",
-    "semver": "^7.7.4",
+    "semver": "^7.5.4",
     "serve-handler": "^6.1.7",
-    "tinypool": "^2.1.0",
+    "tinypool": "^1.0.2",
     "tslib": "^2.6.0",
     "update-notifier": "^6.0.2",
-    "webpack": "^5.106.2",
-    "webpack-bundle-analyzer": "^5.3.0",
-    "webpack-dev-server": "^5.2.3",
+    "webpack": "^5.95.0",
+    "webpack-bundle-analyzer": "^4.10.2",
+    "webpack-dev-server": "^5.2.2",
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.10.1-canary-6655",
-    "@docusaurus/types": "3.10.1-canary-6655",
+    "@docusaurus/module-type-aliases": "3.10.2",
+    "@docusaurus/types": "3.10.2",
     "@total-typescript/shoehorn": "^0.1.2",
-    "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^19.2.3",
     "@types/react-router-config": "^5.0.7",
     "@types/serve-handler": "^6.1.4",
     "@types/update-notifier": "^6.0.4",
     "@types/webpack-bundle-analyzer": "^4.7.0",
     "@types/webpack-env": "^1.18.8",
+    "tmp-promise": "^3.0.3",
     "tree-node-cli": "^1.6.0"
   },
   "peerDependencies": {
     "@docusaurus/faster": "*",
-    "@mdx-js/react": "^3.1.1",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5"
+    "@mdx-js/react": "^3.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
     "@docusaurus/faster": {
@@ -101,7 +101,7 @@
     }
   },
   "engines": {
-    "node": ">=24.14"
+    "node": ">=20.0"
   },
-  "gitHead": "6e93a3055178dd0af922ba627f787229dcdf948b"
+  "gitHead": "f37f9035584917a97a260b91fc2842cba4f8b94f"
 }