@docusaurus/core 3.10.2 → 4.0.0-canary-6809

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.html.d.ts

@@ -4,5 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-declare const _default: "\n<!DOCTYPE html>\n<html <%~ it.htmlAttributes %>>\n  <head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"generator\" content=\"Docusaurus v<%= it.version %>\">\n    <% it.metaAttributes.forEach((metaAttribute) => { %>\n      <%~ metaAttribute %>\n    <% }); %>\n    <%~ it.headTags %>\n    <% it.stylesheets.forEach((stylesheet) => { %>\n      <link rel=\"stylesheet\" href=\"<%= it.baseUrl %><%= stylesheet %>\" />\n    <% }); %>\n    <% it.scripts.forEach((script) => { %>\n      <script src=\"<%= it.baseUrl %><%= script %>\" defer></script>\n    <% }); %>\n  </head>\n  <body <%~ it.bodyAttributes %>>\n    <%~ it.preBodyTags %>\n    <div id=\"__docusaurus\"><%~ it.appHtml %></div>\n    <%~ it.postBodyTags %>\n  </body>\n</html>\n";
+declare const _default = "\n<!DOCTYPE html>\n<html <%~ it.htmlAttributes %>>\n  <head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"generator\" content=\"Docusaurus v<%= it.version %>\">\n    <% it.metaAttributes.forEach((metaAttribute) => { %>\n      <%~ metaAttribute %>\n    <% }); %>\n    <%~ it.headTags %>\n    <% it.stylesheets.forEach((stylesheet) => { %>\n      <link rel=\"stylesheet\" href=\"<%= it.baseUrl %><%= stylesheet %>\" />\n    <% }); %>\n    <% it.scripts.forEach((script) => { %>\n      <script src=\"<%= it.baseUrl %><%= script %>\" defer></script>\n    <% }); %>\n  </head>\n  <body <%~ it.bodyAttributes %>>\n    <%~ it.preBodyTags %>\n    <div id=\"__docusaurus\"><%~ it.appHtml %></div>\n    <%~ it.postBodyTags %>\n  </body>\n</html>\n";
 export default _default;

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-6809",
   "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-6809",
+    "@docusaurus/bundler": "4.0.0-canary-6809",
+    "@docusaurus/logger": "4.0.0-canary-6809",
+    "@docusaurus/mdx-loader": "4.0.0-canary-6809",
+    "@docusaurus/utils": "4.0.0-canary-6809",
+    "@docusaurus/utils-common": "4.0.0-canary-6809",
+    "@docusaurus/utils-validation": "4.0.0-canary-6809",
     "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-6809",
+    "@docusaurus/types": "4.0.0-canary-6809",
     "@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-6809",
+    "@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": "db942b07f3529b5359bcae27ab3796cb07dec10e"
 }