@docusaurus/core 3.1.0 → 3.2.0

package/lib/server/routes.js

@@ -6,115 +6,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadRoutes = exports.handleDuplicateRoutes = exports.genChunkName = void 0;
+exports.getRoutesPaths = exports.handleDuplicateRoutes = void 0;
 const tslib_1 = require("tslib");
-const querystring_1 = tslib_1.__importDefault(require("querystring"));
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
-const utils_2 = require("./utils");
-/** Indents every line of `str` by one level. */
-function indent(str) {
-    return `  ${str.replace(/\n/g, `\n  `)}`;
-}
-const chunkNameCache = new Map();
-const chunkNameCount = new Map();
-/**
- * Generates a unique chunk name that can be used in the chunk registry.
- *
- * @param modulePath A path to generate chunk name from. The actual value has no
- * semantic significance.
- * @param prefix A prefix to append to the chunk name, to avoid name clash.
- * @param preferredName Chunk names default to `modulePath`, and this can supply
- * a more human-readable name.
- * @param shortId When `true`, the chunk name would only be a hash without any
- * other characters. Useful for bundle size. Defaults to `true` in production.
- */
-function genChunkName(modulePath, prefix, preferredName, shortId = process.env.NODE_ENV === 'production') {
-    let chunkName = chunkNameCache.get(modulePath);
-    if (!chunkName) {
-        if (shortId) {
-            chunkName = (0, utils_1.simpleHash)(modulePath, 8);
-        }
-        else {
-            let str = modulePath;
-            if (preferredName) {
-                const shortHash = (0, utils_1.simpleHash)(modulePath, 3);
-                str = `${preferredName}${shortHash}`;
-            }
-            const name = (0, utils_1.docuHash)(str);
-            chunkName = prefix ? `${prefix}---${name}` : name;
-        }
-        const seenCount = (chunkNameCount.get(chunkName) ?? 0) + 1;
-        if (seenCount > 1) {
-            chunkName += seenCount.toString(36);
-        }
-        chunkNameCache.set(modulePath, chunkName);
-        chunkNameCount.set(chunkName, seenCount);
-    }
-    return chunkName;
-}
-exports.genChunkName = genChunkName;
-/**
- * Takes a piece of route config, and serializes it into raw JS code. The shape
- * is the same as react-router's `RouteConfig`. Formatting is similar to
- * `JSON.stringify` but without all the quotes.
- */
-function serializeRouteConfig({ routePath, routeHash, exact, subroutesCodeStrings, props, }) {
-    const parts = [
-        `path: '${routePath}'`,
-        `component: ComponentCreator('${routePath}', '${routeHash}')`,
-    ];
-    if (exact) {
-        parts.push(`exact: true`);
-    }
-    if (subroutesCodeStrings) {
-        parts.push(`routes: [
-${indent(subroutesCodeStrings.join(',\n'))}
-]`);
-    }
-    Object.entries(props).forEach(([propName, propValue]) => {
-        const isIdentifier = /^[$_\p{ID_Start}][$\u200c\u200d\p{ID_Continue}]*$/u.test(propName);
-        const key = isIdentifier ? propName : JSON.stringify(propName);
-        parts.push(`${key}: ${JSON.stringify(propValue)}`);
-    });
-    return `{
-${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
- * like query) and returns the string path it represents.
- */
-function getModulePath(target) {
-    if (typeof target === 'string') {
-        return target;
-    }
-    const queryStr = target.query ? `?${querystring_1.default.stringify(target.query)}` : '';
-    return `${target.path}${queryStr}`;
-}
-function genChunkNames(routeModule, prefix, name, res) {
-    if (isModule(routeModule)) {
-        // This is a leaf node, no need to recurse
-        const modulePath = getModulePath(routeModule);
-        const chunkName = genChunkName(modulePath, prefix, name);
-        res.registry[chunkName] = (0, utils_1.escapePath)(modulePath);
-        return chunkName;
-    }
-    if (Array.isArray(routeModule)) {
-        return routeModule.map((val, index) => genChunkNames(val, `${index}`, name, res));
-    }
-    return lodash_1.default.mapValues(routeModule, (v, key) => genChunkNames(v, key, name, res));
-}
-function handleDuplicateRoutes(pluginsRouteConfigs, onDuplicateRoutes) {
+function handleDuplicateRoutes(routes, onDuplicateRoutes) {
     if (onDuplicateRoutes === 'ignore') {
         return;
     }
-    const allRoutes = (0, utils_2.getAllFinalRoutes)(pluginsRouteConfigs).map((routeConfig) => routeConfig.path);
+    const allRoutes = (0, utils_1.flattenRoutes)(routes).map((routeConfig) => routeConfig.path);
     const seenRoutes = new Set();
     const duplicatePaths = allRoutes.filter((route) => {
         if (seenRoutes.has(route)) {
@@ -130,68 +30,24 @@ This could lead to non-deterministic routing behavior.`;
 }
 exports.handleDuplicateRoutes = handleDuplicateRoutes;
 /**
- * This is the higher level overview of route code generation. For each route
- * config node, it returns the node's serialized form, and mutates `registry`,
- * `routesPaths`, and `routesChunkNames` accordingly.
- */
-function genRouteCode(routeConfig, res) {
-    const { path: routePath, component, modules = {}, context, routes: subroutes, priority, exact, ...props } = routeConfig;
-    if (typeof routePath !== 'string' || !component) {
-        throw new Error(`Invalid route config: path must be a string and component is required.
-${JSON.stringify(routeConfig)}`);
-    }
-    if (!subroutes) {
-        res.routesPaths.push(routePath);
-    }
-    const routeHash = (0, utils_1.simpleHash)(JSON.stringify(routeConfig), 3);
-    res.routesChunkNames[`${routePath}-${routeHash}`] = {
-        // Avoid clash with a prop called "component"
-        ...genChunkNames({ __comp: component }, 'component', component, res),
-        ...(context &&
-            genChunkNames({ __context: context }, 'context', routePath, res)),
-        ...genChunkNames(modules, 'module', routePath, res),
-    };
-    return serializeRouteConfig({
-        routePath: routePath.replace(/'/g, "\\'"),
-        routeHash,
-        subroutesCodeStrings: subroutes?.map((r) => genRouteCode(r, res)),
-        exact,
-        props,
-    });
-}
-/**
- * Routes are prepared into three temp files:
+ * Old stuff
+ * As far as I understand, this is what permits to SSG the 404.html file
+ * This is rendered through the catch-all ComponentCreator("*") route
+ * Note CDNs only understand the 404.html file by convention
+ * The extension probably permits to avoid emitting "/404/index.html"
+ *
+ * TODO we should probably deprecate/remove "postBuild({routesPaths})
+ *  The 404 generation handling can be moved to the SSG code
+ *  We only need getAllFinalRoutes() utils IMHO
+ *  This would be a plugin lifecycle breaking change :/
+ *  Although not many plugins probably use this
  *
- * - `routesConfig`, the route config passed to react-router. This file is kept
- * minimal, because it can't be code-splitted.
- * - `routesChunkNames`, a mapping from route paths (hashed) to code-splitted
- * chunk names.
- * - `registry`, a mapping from chunk names to options for react-loadable.
  */
-function loadRoutes(routeConfigs, baseUrl, onDuplicateRoutes) {
-    handleDuplicateRoutes(routeConfigs, onDuplicateRoutes);
-    const res = {
-        // To be written by `genRouteCode`
-        routesConfig: '',
-        routesChunkNames: {},
-        registry: {},
-        routesPaths: [(0, utils_1.normalizeUrl)([baseUrl, '404.html'])],
-    };
-    // `genRouteCode` would mutate `res`
-    const routeConfigSerialized = routeConfigs
-        .map((r) => genRouteCode(r, res))
-        .join(',\n');
-    res.routesConfig = `import React from 'react';
-import ComponentCreator from '@docusaurus/ComponentCreator';
-
-export default [
-${indent(routeConfigSerialized)},
-  {
-    path: '*',
-    component: ComponentCreator('*'),
-  },
-];
-`;
-    return res;
+const NotFoundRoutePath = '/404.html';
+function getRoutesPaths(routeConfigs, baseUrl) {
+    return [
+        (0, utils_1.normalizeUrl)([baseUrl, NotFoundRoutePath]),
+        ...(0, utils_1.flattenRoutes)(routeConfigs).map((r) => r.path),
+    ];
 }
-exports.loadRoutes = loadRoutes;
+exports.getRoutesPaths = getRoutesPaths;

package/lib/server/{index.d.ts → site.d.ts}

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { LoadContext, Props } from '@docusaurus/types';
-export type LoadContextOptions = {
+import type { LoadContext, Props, PluginIdentifier } from '@docusaurus/types';
+export type LoadContextParams = {
     /** Usually the CWD; can be overridden with command argument. */
     siteDir: string;
     /** Custom output directory. Can be customized with `--out-dir` option */
@@ -22,17 +22,24 @@ export type LoadContextOptions = {
      */
     localizePath?: boolean;
 };
+export type LoadSiteParams = LoadContextParams;
+export type Site = {
+    props: Props;
+    params: LoadSiteParams;
+};
 /**
- * Loading context is the very first step in site building. Its options are
+ * Loading context is the very first step in site building. Its params are
  * directly acquired from CLI options. It mainly loads `siteConfig` and the i18n
  * context (which includes code translations). The `LoadContext` will be passed
  * to plugin constructors.
  */
-export declare function loadContext(options: LoadContextOptions): Promise<LoadContext>;
+export declare function loadContext(params: LoadContextParams): Promise<LoadContext>;
 /**
  * This is the crux of the Docusaurus server-side. It reads everything it needs—
  * code translations, config file, plugin modules... Plugins then use their
  * lifecycles to generate content and other data. It is side-effect-ful because
  * it generates temp files in the `.docusaurus` folder for the bundler.
  */
-export declare function load(options: LoadContextOptions): Promise<Props>;
+export declare function loadSite(params: LoadContextParams): Promise<Site>;
+export declare function reloadSite(site: Site): Promise<Site>;
+export declare function reloadSitePlugin(site: Site, pluginIdentifier: PluginIdentifier): Promise<Site>;

package/lib/server/site.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reloadSitePlugin = exports.reloadSite = exports.loadSite = exports.loadContext = void 0;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const utils_1 = require("@docusaurus/utils");
+const combine_promises_1 = tslib_1.__importDefault(require("combine-promises"));
+const config_1 = require("./config");
+const clientModules_1 = require("./clientModules");
+const plugins_1 = require("./plugins/plugins");
+const htmlTags_1 = require("./htmlTags");
+const siteMetadata_1 = require("./siteMetadata");
+const i18n_1 = require("./i18n");
+const translations_1 = require("./translations/translations");
+const utils_2 = require("../utils");
+const codegen_1 = require("./codegen/codegen");
+const routes_1 = require("./routes");
+/**
+ * Loading context is the very first step in site building. Its params are
+ * directly acquired from CLI options. It mainly loads `siteConfig` and the i18n
+ * context (which includes code translations). The `LoadContext` will be passed
+ * to plugin constructors.
+ */
+async function loadContext(params) {
+    const { siteDir, outDir: baseOutDir = utils_1.DEFAULT_BUILD_DIR_NAME, locale, config: customConfigFilePath, } = 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),
+        loadSiteConfig: (0, config_1.loadSiteConfig)({
+            siteDir,
+            customConfigFilePath,
+        }),
+    });
+    const i18n = await (0, i18n_1.loadI18n)(initialSiteConfig, { locale });
+    const baseUrl = (0, utils_1.localizePath)({
+        path: initialSiteConfig.baseUrl,
+        i18n,
+        options: params,
+        pathType: 'url',
+    });
+    const outDir = (0, utils_1.localizePath)({
+        path: path_1.default.resolve(siteDir, baseOutDir),
+        i18n,
+        options: params,
+        pathType: 'fs',
+    });
+    const localizationDir = path_1.default.resolve(siteDir, i18n.path, i18n.localeConfigs[i18n.currentLocale].path);
+    const siteConfig = { ...initialSiteConfig, baseUrl };
+    const codeTranslations = await (0, translations_1.loadSiteCodeTranslations)({ localizationDir });
+    return {
+        siteDir,
+        siteVersion,
+        generatedFilesDir,
+        localizationDir,
+        siteConfig,
+        siteConfigPath,
+        outDir,
+        baseUrl,
+        i18n,
+        codeTranslations,
+    };
+}
+exports.loadContext = loadContext;
+function createSiteProps(params) {
+    const { plugins, routes, context } = params;
+    const { generatedFilesDir, siteDir, siteVersion, siteConfig, siteConfigPath, outDir, baseUrl, i18n, localizationDir, codeTranslations: siteCodeTranslations, } = context;
+    const { headTags, preBodyTags, postBodyTags } = (0, htmlTags_1.loadHtmlTags)(plugins);
+    const siteMetadata = (0, siteMetadata_1.createSiteMetadata)({ plugins, siteVersion });
+    const codeTranslations = {
+        ...(0, translations_1.getPluginsDefaultCodeTranslations)({ plugins }),
+        ...siteCodeTranslations,
+    };
+    (0, routes_1.handleDuplicateRoutes)(routes, siteConfig.onDuplicateRoutes);
+    const routesPaths = (0, routes_1.getRoutesPaths)(routes, baseUrl);
+    return {
+        siteConfig,
+        siteConfigPath,
+        siteMetadata,
+        siteVersion,
+        siteDir,
+        outDir,
+        baseUrl,
+        i18n,
+        localizationDir,
+        generatedFilesDir,
+        routes,
+        routesPaths,
+        plugins,
+        headTags,
+        preBodyTags,
+        postBodyTags,
+        codeTranslations,
+    };
+}
+// TODO global data should be part of site props?
+async function createSiteFiles({ site, globalData, }) {
+    return utils_2.PerfLogger.async('Create site files', async () => {
+        const { props: { plugins, generatedFilesDir, siteConfig, siteMetadata, i18n, codeTranslations, routes, baseUrl, }, } = site;
+        const clientModules = (0, clientModules_1.getAllClientModules)(plugins);
+        await (0, codegen_1.generateSiteFiles)({
+            generatedFilesDir,
+            clientModules,
+            siteConfig,
+            siteMetadata,
+            i18n,
+            codeTranslations,
+            globalData,
+            routes,
+            baseUrl,
+        });
+    });
+}
+/**
+ * This is the crux of the Docusaurus server-side. It reads everything it needs—
+ * code translations, config file, plugin modules... Plugins then use their
+ * lifecycles to generate content and other data. It is side-effect-ful because
+ * it generates temp files in the `.docusaurus` folder for the bundler.
+ */
+async function loadSite(params) {
+    const context = await utils_2.PerfLogger.async('Load context', () => loadContext(params));
+    const { plugins, routes, globalData } = await (0, plugins_1.loadPlugins)(context);
+    const props = await createSiteProps({ plugins, routes, globalData, context });
+    const site = { props, params };
+    await createSiteFiles({
+        site,
+        globalData,
+    });
+    return site;
+}
+exports.loadSite = loadSite;
+async function reloadSite(site) {
+    // TODO this can be optimized, for example:
+    //  - plugins loading same data as before should not recreate routes/bundles
+    //  - codegen does not need to re-run if nothing changed
+    return loadSite(site.params);
+}
+exports.reloadSite = reloadSite;
+async function reloadSitePlugin(site, pluginIdentifier) {
+    const { plugins, routes, globalData } = await (0, plugins_1.reloadPlugin)({
+        pluginIdentifier,
+        plugins: site.props.plugins,
+        context: site.props,
+    });
+    const newProps = await createSiteProps({
+        plugins,
+        routes,
+        globalData,
+        context: site.props, // Props extends Context
+    });
+    const newSite = {
+        props: newProps,
+        params: site.params,
+    };
+    // TODO optimize, bypass useless codegen if new site is similar to old site
+    await createSiteFiles({ site: newSite, globalData });
+    return newSite;
+}
+exports.reloadSitePlugin = reloadSitePlugin;

package/lib/server/siteMetadata.d.ts

@@ -5,8 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadedPlugin, PluginVersionInformation, SiteMetadata } from '@docusaurus/types';
-export declare function getPluginVersion(pluginPath: string, siteDir: string): Promise<PluginVersionInformation>;
-export declare function loadSiteMetadata({ plugins, siteDir, }: {
+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[];
-    siteDir: string;
-}): Promise<SiteMetadata>;
+}): SiteMetadata;

package/lib/server/siteMetadata.js

@@ -6,23 +6,27 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadSiteMetadata = exports.getPluginVersion = void 0;
+exports.createSiteMetadata = exports.loadPluginVersion = exports.loadSiteVersion = void 0;
 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 getPackageJsonVersion(packageJsonPath) {
+async function loadPackageJsonVersion(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;
     }
     return undefined;
 }
-async function getPackageJsonName(packageJsonPath) {
+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 getPluginVersion(pluginPath, siteDir) {
+async function loadSiteVersion(siteDir) {
+    return loadPackageJsonVersion(path_1.default.join(siteDir, 'package.json'));
+}
+exports.loadSiteVersion = loadSiteVersion;
+async function loadPluginVersion(pluginPath, siteDir) {
     let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
     while (potentialPluginPackageJsonDirectory !== '/') {
         const packageJsonPath = path_1.default.join(potentialPluginPackageJsonDirectory, 'package.json');
@@ -35,8 +39,8 @@ async function getPluginVersion(pluginPath, siteDir) {
             }
             return {
                 type: 'package',
-                name: await getPackageJsonName(packageJsonPath),
-                version: await getPackageJsonVersion(packageJsonPath),
+                name: await loadPackageJsonName(packageJsonPath),
+                version: await loadPackageJsonVersion(packageJsonPath),
             };
         }
         potentialPluginPackageJsonDirectory = path_1.default.dirname(potentialPluginPackageJsonDirectory);
@@ -46,7 +50,7 @@ async function getPluginVersion(pluginPath, siteDir) {
     // script in the parent directory of the site.
     return { type: 'local' };
 }
-exports.getPluginVersion = getPluginVersion;
+exports.loadPluginVersion = loadPluginVersion;
 /**
  * We want all `@docusaurus/*` packages to have the exact same version!
  * @see https://github.com/facebook/docusaurus/issues/3371
@@ -65,10 +69,10 @@ Maybe you want to check, or regenerate your yarn.lock or package-lock.json file?
         }
     });
 }
-async function loadSiteMetadata({ plugins, siteDir, }) {
+function createSiteMetadata({ siteVersion, plugins, }) {
     const siteMetadata = {
         docusaurusVersion: utils_1.DOCUSAURUS_VERSION,
-        siteVersion: await getPackageJsonVersion(path_1.default.join(siteDir, 'package.json')),
+        siteVersion,
         pluginVersions: Object.fromEntries(plugins
             .filter(({ version: { type } }) => type !== 'synthetic')
             .map(({ name, version }) => [name, version])),
@@ -76,4 +80,4 @@ async function loadSiteMetadata({ plugins, siteDir, }) {
     checkDocusaurusPackagesVersion(siteMetadata);
     return siteMetadata;
 }
-exports.loadSiteMetadata = loadSiteMetadata;
+exports.createSiteMetadata = createSiteMetadata;

package/lib/server/translations/translations.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 { TranslationFileContent, TranslationFile, CodeTranslations, InitializedPlugin } from '@docusaurus/types';
+import type { TranslationFileContent, TranslationFile, CodeTranslations, InitializedPlugin, LoadedPlugin } from '@docusaurus/types';
 export type WriteTranslationsOptions = {
     override?: boolean;
     messagePrefix?: string;
@@ -23,9 +23,16 @@ export declare function localizePluginTranslationFile({ localizationDir, plugin,
     plugin: InitializedPlugin;
     translationFile: TranslationFile;
 }): Promise<TranslationFile>;
-export declare function getPluginsDefaultCodeTranslationMessages(plugins: InitializedPlugin[]): Promise<CodeTranslations>;
+export declare function mergeCodeTranslations(codeTranslations: CodeTranslations[]): CodeTranslations;
+export declare function loadPluginsDefaultCodeTranslationMessages(plugins: InitializedPlugin[]): Promise<CodeTranslations>;
+export declare function getPluginsDefaultCodeTranslations({ plugins, }: {
+    plugins: LoadedPlugin[];
+}): CodeTranslations;
 export declare function applyDefaultCodeTranslations({ extractedCodeTranslations, defaultCodeMessages, }: {
     extractedCodeTranslations: TranslationFileContent;
     defaultCodeMessages: CodeTranslations;
 }): TranslationFileContent;
+export declare function loadSiteCodeTranslations({ localizationDir, }: {
+    localizationDir: string;
+}): Promise<CodeTranslations>;
 export {};

package/lib/server/translations/translations.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyDefaultCodeTranslations = exports.getPluginsDefaultCodeTranslationMessages = exports.localizePluginTranslationFile = exports.writePluginTranslations = exports.writeCodeTranslations = exports.readCodeTranslationFileContent = void 0;
+exports.loadSiteCodeTranslations = exports.applyDefaultCodeTranslations = exports.getPluginsDefaultCodeTranslations = exports.loadPluginsDefaultCodeTranslationMessages = exports.mergeCodeTranslations = exports.localizePluginTranslationFile = exports.writePluginTranslations = exports.writeCodeTranslations = exports.readCodeTranslationFileContent = void 0;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
@@ -145,11 +145,22 @@ async function localizePluginTranslationFile({ localizationDir, plugin, translat
     return translationFile;
 }
 exports.localizePluginTranslationFile = localizePluginTranslationFile;
-async function getPluginsDefaultCodeTranslationMessages(plugins) {
+function mergeCodeTranslations(codeTranslations) {
+    return codeTranslations.reduce((allCodeTranslations, current) => ({
+        ...allCodeTranslations,
+        ...current,
+    }), {});
+}
+exports.mergeCodeTranslations = mergeCodeTranslations;
+async function loadPluginsDefaultCodeTranslationMessages(plugins) {
     const pluginsMessages = await Promise.all(plugins.map((plugin) => plugin.getDefaultCodeTranslationMessages?.() ?? {}));
-    return pluginsMessages.reduce((allMessages, pluginMessages) => ({ ...allMessages, ...pluginMessages }), {});
+    return mergeCodeTranslations(pluginsMessages);
+}
+exports.loadPluginsDefaultCodeTranslationMessages = loadPluginsDefaultCodeTranslationMessages;
+function getPluginsDefaultCodeTranslations({ plugins, }) {
+    return mergeCodeTranslations(plugins.map((p) => p.defaultCodeTranslations));
 }
-exports.getPluginsDefaultCodeTranslationMessages = getPluginsDefaultCodeTranslationMessages;
+exports.getPluginsDefaultCodeTranslations = getPluginsDefaultCodeTranslations;
 function applyDefaultCodeTranslations({ extractedCodeTranslations, defaultCodeMessages, }) {
     const unusedDefaultCodeMessages = lodash_1.default.difference(Object.keys(defaultCodeMessages), Object.keys(extractedCodeTranslations));
     if (unusedDefaultCodeMessages.length > 0) {
@@ -162,3 +173,9 @@ Please report this Docusaurus issue. name=${unusedDefaultCodeMessages}`;
     }));
 }
 exports.applyDefaultCodeTranslations = applyDefaultCodeTranslations;
+async function loadSiteCodeTranslations({ localizationDir, }) {
+    const codeTranslationFileContent = (await readCodeTranslationFileContent({ localizationDir })) ?? {};
+    // We only need key->message for code translations
+    return lodash_1.default.mapValues(codeTranslationFileContent, (value) => value.message);
+}
+exports.loadSiteCodeTranslations = loadSiteCodeTranslations;

package/lib/server/utils.d.ts

@@ -5,6 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { Globby } from '@docusaurus/utils';
-import type { RouteConfig } from '@docusaurus/types';
-export declare function getAllFinalRoutes(routeConfig: RouteConfig[]): RouteConfig[];
 export declare function safeGlobby(patterns: string[], options?: Globby.GlobbyOptions): Promise<string[]>;

package/lib/server/utils.js

@@ -6,18 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeGlobby = exports.getAllFinalRoutes = void 0;
+exports.safeGlobby = void 0;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
-// Recursively get the final routes (routes with no subroutes)
-function getAllFinalRoutes(routeConfig) {
-    function getFinalRoutes(route) {
-        return route.routes ? route.routes.flatMap(getFinalRoutes) : [route];
-    }
-    return routeConfig.flatMap(getFinalRoutes);
-}
-exports.getAllFinalRoutes = getAllFinalRoutes;
 // Globby that fix Windows path patterns
 // See https://github.com/facebook/docusaurus/pull/4222#issuecomment-795517329
 async function safeGlobby(patterns, options) {

package/lib/ssg.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { AppRenderer, SiteCollectedData } from './common';
+import type { Manifest } from 'react-loadable-ssr-addon-v5-slorber';
+import type { SSRTemplateCompiled } from './templates/templates';
+export type SSGParams = {
+    trailingSlash: boolean | undefined;
+    manifest: Manifest;
+    headTags: string;
+    preBodyTags: string;
+    postBodyTags: string;
+    outDir: string;
+    baseUrl: string;
+    noIndex: boolean;
+    DOCUSAURUS_VERSION: string;
+    ssrTemplate: SSRTemplateCompiled;
+};
+export declare function loadAppRenderer({ serverBundlePath, }: {
+    serverBundlePath: string;
+}): Promise<AppRenderer>;
+export declare function generateStaticFiles({ pathnames, renderer, params, }: {
+    pathnames: string[];
+    renderer: AppRenderer;
+    params: SSGParams;
+}): Promise<{
+    collectedData: SiteCollectedData;
+}>;