@docusaurus/core 2.0.0-beta.16 → 2.0.0-beta.19

package/lib/server/index.js

@@ -6,67 +6,50 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.load = exports.loadPluginConfigs = exports.loadContext = exports.loadSiteConfig = void 0;
+exports.load = exports.loadContext = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
-const path_1 = (0, tslib_1.__importDefault)(require("path"));
-const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
-const ssr_html_template_1 = (0, tslib_1.__importDefault)(require("../webpack/templates/ssr.html.template"));
-const client_modules_1 = (0, tslib_1.__importDefault)(require("./client-modules"));
-const config_1 = (0, tslib_1.__importDefault)(require("./config"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const config_1 = require("./config");
+const clientModules_1 = require("./clientModules");
 const plugins_1 = require("./plugins");
-const presets_1 = (0, tslib_1.__importDefault)(require("./presets"));
-const routes_1 = (0, tslib_1.__importDefault)(require("./routes"));
-const html_tags_1 = require("./html-tags");
-const versions_1 = require("./versions");
-const duplicateRoutes_1 = require("./duplicateRoutes");
+const routes_1 = require("./routes");
+const htmlTags_1 = require("./htmlTags");
+const siteMetadata_1 = require("./siteMetadata");
 const i18n_1 = require("./i18n");
 const translations_1 = require("./translations/translations");
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
-const remark_admonitions_1 = (0, tslib_1.__importDefault)(require("remark-admonitions"));
-const module_1 = require("module");
-const moduleShorthand_1 = require("./moduleShorthand");
-async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
-    const siteConfigPathUnresolved = customConfigFilePath !== null && customConfigFilePath !== void 0 ? customConfigFilePath : utils_1.DEFAULT_CONFIG_FILE_NAME;
-    const siteConfigPath = path_1.default.isAbsolute(siteConfigPathUnresolved)
-        ? siteConfigPathUnresolved
-        : path_1.default.resolve(siteDir, siteConfigPathUnresolved);
-    const siteConfig = await (0, config_1.default)(siteConfigPath);
-    return { siteConfig, siteConfigPath };
-}
-exports.loadSiteConfig = loadSiteConfig;
-async function loadContext(siteDir, options = {}) {
-    var _a;
-    const { customOutDir, locale, customConfigFilePath } = options;
-    const generatedFilesDir = path_1.default.isAbsolute(utils_1.GENERATED_FILES_DIR_NAME)
-        ? utils_1.GENERATED_FILES_DIR_NAME
-        : path_1.default.resolve(siteDir, utils_1.GENERATED_FILES_DIR_NAME);
-    const { siteConfig: initialSiteConfig, siteConfigPath } = await loadSiteConfig({
+/**
+ * Loading context is the very first step in site building. Its options 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(options) {
+    const { siteDir, outDir: baseOutDir = utils_1.DEFAULT_BUILD_DIR_NAME, locale, config: customConfigFilePath, } = options;
+    const generatedFilesDir = path_1.default.resolve(siteDir, utils_1.GENERATED_FILES_DIR_NAME);
+    const { siteConfig: initialSiteConfig, siteConfigPath } = await (0, config_1.loadSiteConfig)({
         siteDir,
         customConfigFilePath,
     });
-    const { ssrTemplate } = initialSiteConfig;
-    const baseOutDir = customOutDir
-        ? path_1.default.resolve(customOutDir)
-        : path_1.default.resolve(siteDir, utils_1.DEFAULT_BUILD_DIR_NAME);
     const i18n = await (0, i18n_1.loadI18n)(initialSiteConfig, { locale });
-    const baseUrl = (0, i18n_1.localizePath)({
+    const baseUrl = (0, utils_1.localizePath)({
         path: initialSiteConfig.baseUrl,
         i18n,
         options,
         pathType: 'url',
     });
-    const outDir = (0, i18n_1.localizePath)({
-        path: baseOutDir,
+    const outDir = (0, utils_1.localizePath)({
+        path: path_1.default.resolve(siteDir, baseOutDir),
         i18n,
         options,
         pathType: 'fs',
     });
     const siteConfig = { ...initialSiteConfig, baseUrl };
-    const codeTranslationFileContent = (_a = (await (0, translations_1.readCodeTranslationFileContent)({
+    const codeTranslationFileContent = (await (0, translations_1.readCodeTranslationFileContent)({
         siteDir,
         locale: i18n.currentLocale,
-    }))) !== null && _a !== void 0 ? _a : {};
+    })) ?? {};
     // We only need key->message for code translations
     const codeTranslations = lodash_1.default.mapValues(codeTranslationFileContent, (value) => value.message);
     return {
@@ -77,191 +60,62 @@ async function loadContext(siteDir, options = {}) {
         outDir,
         baseUrl,
         i18n,
-        ssrTemplate: ssrTemplate !== null && ssrTemplate !== void 0 ? ssrTemplate : ssr_html_template_1.default,
         codeTranslations,
     };
 }
 exports.loadContext = loadContext;
-async function loadPluginConfigs(context) {
-    let { plugins: presetPlugins, themes: presetThemes } = await (0, presets_1.default)(context);
-    const { siteConfig, siteConfigPath } = context;
-    const require = (0, module_1.createRequire)(siteConfigPath);
-    function normalizeShorthand(pluginConfig, pluginType) {
-        var _a;
-        if (typeof pluginConfig === 'string') {
-            return (0, moduleShorthand_1.resolveModuleName)(pluginConfig, require, pluginType);
-        }
-        else if (Array.isArray(pluginConfig) &&
-            typeof pluginConfig[0] === 'string') {
-            return [
-                (0, moduleShorthand_1.resolveModuleName)(pluginConfig[0], require, pluginType),
-                (_a = pluginConfig[1]) !== null && _a !== void 0 ? _a : {},
-            ];
-        }
-        return pluginConfig;
-    }
-    presetPlugins = presetPlugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
-    presetThemes = presetThemes.map((theme) => normalizeShorthand(theme, 'theme'));
-    const standalonePlugins = (siteConfig.plugins || []).map((plugin) => normalizeShorthand(plugin, 'plugin'));
-    const standaloneThemes = (siteConfig.themes || []).map((theme) => normalizeShorthand(theme, 'theme'));
-    return [
-        ...presetPlugins,
-        ...presetThemes,
-        // Site config should be the highest priority.
-        ...standalonePlugins,
-        ...standaloneThemes,
-    ];
-}
-exports.loadPluginConfigs = loadPluginConfigs;
-// Make a fake plugin to:
-// - Resolve aliased theme components
-// - Inject scripts/stylesheets
-function createBootstrapPlugin({ siteConfig, }) {
-    const { stylesheets = [], scripts = [], clientModules: siteConfigClientModules = [], } = siteConfig;
-    return {
-        name: 'docusaurus-bootstrap-plugin',
-        content: null,
-        options: {},
-        version: { type: 'synthetic' },
-        getClientModules() {
-            return siteConfigClientModules;
-        },
-        injectHtmlTags: () => {
-            const stylesheetsTags = stylesheets.map((source) => typeof source === 'string'
-                ? `<link rel="stylesheet" href="${source}">`
-                : {
-                    tagName: 'link',
-                    attributes: {
-                        rel: 'stylesheet',
-                        ...source,
-                    },
-                });
-            const scriptsTags = scripts.map((source) => typeof source === 'string'
-                ? `<script src="${source}"></script>`
-                : {
-                    tagName: 'script',
-                    attributes: {
-                        ...source,
-                    },
-                });
-            return {
-                headTags: [...stylesheetsTags, ...scriptsTags],
-            };
-        },
-    };
-}
 /**
- * Configure Webpack fallback mdx loader for md/mdx files out of content-plugin
- * folders. Adds a "fallback" mdx loader for mdx files that are not processed by
- * content plugins. This allows to do things such as importing repo/README.md as
- * a partial from another doc. Not ideal solution, but good enough for now
+ * 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.
  */
-function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
-    return {
-        name: 'docusaurus-mdx-fallback-plugin',
-        content: null,
-        options: {},
-        version: { type: 'synthetic' },
-        configureWebpack(config, isServer, { getJSLoader }) {
-            // We need the mdx fallback loader to exclude files that were already
-            // processed by content plugins mdx loaders. This works, but a bit
-            // hacky... Not sure there's a way to handle that differently in webpack
-            function getMDXFallbackExcludedPaths() {
-                var _a;
-                const rules = (_a = config === null || config === void 0 ? void 0 : config.module) === null || _a === void 0 ? void 0 : _a.rules;
-                return rules.flatMap((rule) => {
-                    const isMDXRule = rule.test instanceof RegExp && rule.test.test('x.mdx');
-                    return isMDXRule ? rule.include : [];
-                });
-            }
-            return {
-                module: {
-                    rules: [
-                        {
-                            test: /\.mdx?$/i,
-                            exclude: getMDXFallbackExcludedPaths(),
-                            use: [
-                                getJSLoader({ isServer }),
-                                {
-                                    loader: require.resolve('@docusaurus/mdx-loader'),
-                                    options: {
-                                        staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
-                                        siteDir,
-                                        isMDXPartial: (_filename) => true,
-                                        isMDXPartialFrontMatterWarningDisabled: true,
-                                        remarkPlugins: [remark_admonitions_1.default],
-                                    },
-                                },
-                            ],
-                        },
-                    ],
-                },
-            };
-        },
+async function load(options) {
+    const { siteDir } = options;
+    const context = await loadContext(options);
+    const { generatedFilesDir, siteConfig, siteConfigPath, outDir, baseUrl, i18n, codeTranslations: siteCodeTranslations, } = context;
+    const { plugins, pluginsRouteConfigs, globalData } = await (0, plugins_1.loadPlugins)(context);
+    const clientModules = (0, clientModules_1.loadClientModules)(plugins);
+    const { headTags, preBodyTags, postBodyTags } = (0, htmlTags_1.loadHtmlTags)(plugins);
+    const { registry, routesChunkNames, routesConfig, routesPaths } = (0, routes_1.loadRoutes)(pluginsRouteConfigs, baseUrl, siteConfig.onDuplicateRoutes);
+    const codeTranslations = {
+        ...(await (0, translations_1.getPluginsDefaultCodeTranslationMessages)(plugins)),
+        ...siteCodeTranslations,
     };
-}
-async function load(siteDir, options = {}) {
-    // Context.
-    const context = await loadContext(siteDir, options);
-    const { generatedFilesDir, siteConfig, siteConfigPath, outDir, baseUrl, i18n, ssrTemplate, codeTranslations, } = context;
-    // Plugins.
-    const pluginConfigs = await loadPluginConfigs(context);
-    const { plugins, pluginsRouteConfigs, globalData, themeConfigTranslated } = await (0, plugins_1.loadPlugins)({ pluginConfigs, context });
-    // Side-effect to replace the untranslated themeConfig by the translated one
-    context.siteConfig.themeConfig = themeConfigTranslated;
-    (0, duplicateRoutes_1.handleDuplicateRoutes)(pluginsRouteConfigs, siteConfig.onDuplicateRoutes);
+    const siteMetadata = await (0, siteMetadata_1.loadSiteMetadata)({ plugins, siteDir });
+    // === Side-effects part ===
     const genWarning = (0, utils_1.generate)(generatedFilesDir, 'DONT-EDIT-THIS-FOLDER', `This folder stores temp files that Docusaurus' client bundler accesses.
+
 DO NOT hand-modify files in this folder because they will be overwritten in the
 next build. You can clear all build artifacts (including this folder) with the
 \`docusaurus clear\` command.
 `);
-    // Site config must be generated after plugins
-    // We want the generated config to have been normalized by the plugins!
     const genSiteConfig = (0, utils_1.generate)(generatedFilesDir, utils_1.DEFAULT_CONFIG_FILE_NAME, `/*
-AUTOGENERATED - DON'T EDIT
-Your edits in this file will be overwritten in the next build!
-Modify the docusaurus.config.js file at your site's root instead.
-*/
-export default ${JSON.stringify(siteConfig, null, 2)};`);
-    plugins.push(createBootstrapPlugin({ siteConfig }));
-    plugins.push(createMDXFallbackPlugin({ siteDir, siteConfig }));
-    // Load client modules.
-    const clientModules = (0, client_modules_1.default)(plugins);
-    const genClientModules = (0, utils_1.generate)(generatedFilesDir, 'client-modules.js', `export default [\n${clientModules
-        // import() is async so we use require() because client modules can have
-        // CSS and the order matters for loading CSS.
-        .map((module) => `  require('${(0, utils_1.escapePath)(module)}'),`)
-        .join('\n')}\n];\n`);
-    // Load extra head & body html tags.
-    const { headTags, preBodyTags, postBodyTags } = (0, html_tags_1.loadHtmlTags)(plugins);
-    // Routing.
-    const { registry, routesChunkNames, routesConfig, routesPaths } = await (0, routes_1.default)(pluginsRouteConfigs, baseUrl);
+ * AUTOGENERATED - DON'T EDIT
+ * Your edits in this file will be overwritten in the next build!
+ * Modify the docusaurus.config.js file at your site's root instead.
+ */
+export default ${JSON.stringify(siteConfig, null, 2)};
+`);
+    const genClientModules = (0, utils_1.generate)(generatedFilesDir, 'client-modules.js', `export default [
+${clientModules
+        // Use `require()` because `import()` is async but client modules can have CSS
+        // and the order matters for loading CSS.
+        .map((clientModule) => `  require('${(0, utils_1.escapePath)(clientModule)}'),`)
+        .join('\n')}
+];
+`);
     const genRegistry = (0, utils_1.generate)(generatedFilesDir, 'registry.js', `export default {
-${Object.keys(registry)
-        .sort()
-        .map((key) => `  '${key}': [${registry[key].loader}, '${(0, utils_1.escapePath)(registry[key].modulePath)}', require.resolveWeak('${(0, utils_1.escapePath)(registry[key].modulePath)}')],`)
-        .join('\n')}};\n`);
+${Object.entries(registry)
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([chunkName, modulePath]) => `  '${chunkName}': [() => import(/* webpackChunkName: '${chunkName}' */ '${modulePath}'), '${modulePath}', require.resolveWeak('${modulePath}')],`)
+        .join('\n')}};
+`);
     const genRoutesChunkNames = (0, utils_1.generate)(generatedFilesDir, 'routesChunkNames.json', JSON.stringify(routesChunkNames, null, 2));
     const genRoutes = (0, utils_1.generate)(generatedFilesDir, 'routes.js', routesConfig);
     const genGlobalData = (0, utils_1.generate)(generatedFilesDir, 'globalData.json', JSON.stringify(globalData, null, 2));
     const genI18n = (0, utils_1.generate)(generatedFilesDir, 'i18n.json', JSON.stringify(i18n, null, 2));
-    const codeTranslationsWithFallbacks = {
-        ...(await (0, translations_1.getPluginsDefaultCodeTranslationMessages)(plugins)),
-        ...codeTranslations,
-    };
-    const genCodeTranslations = (0, utils_1.generate)(generatedFilesDir, 'codeTranslations.json', JSON.stringify(codeTranslationsWithFallbacks, null, 2));
-    // Version metadata.
-    const siteMetadata = {
-        docusaurusVersion: (await (0, versions_1.getPackageJsonVersion)(path_1.default.join(__dirname, '../../package.json'))),
-        siteVersion: await (0, versions_1.getPackageJsonVersion)(path_1.default.join(siteDir, 'package.json')),
-        pluginVersions: {},
-    };
-    plugins
-        .filter(({ version: { type } }) => type !== 'synthetic')
-        .forEach(({ name, version }) => {
-        siteMetadata.pluginVersions[name] = version;
-    });
-    checkDocusaurusPackagesVersion(siteMetadata);
+    const genCodeTranslations = (0, utils_1.generate)(generatedFilesDir, 'codeTranslations.json', JSON.stringify(codeTranslations, null, 2));
     const genSiteMetadata = (0, utils_1.generate)(generatedFilesDir, 'site-metadata.json', JSON.stringify(siteMetadata, null, 2));
     await Promise.all([
         genWarning,
@@ -275,7 +129,7 @@ ${Object.keys(registry)
         genI18n,
         genCodeTranslations,
     ]);
-    const props = {
+    return {
         siteConfig,
         siteConfigPath,
         siteMetadata,
@@ -290,28 +144,7 @@ ${Object.keys(registry)
         headTags,
         preBodyTags,
         postBodyTags,
-        ssrTemplate,
         codeTranslations,
     };
-    return props;
 }
 exports.load = load;
-// We want all @docusaurus/* packages  to have the exact same version!
-// See https://github.com/facebook/docusaurus/issues/3371
-// See https://github.com/facebook/docusaurus/pull/3386
-function checkDocusaurusPackagesVersion(siteMetadata) {
-    const { docusaurusVersion } = siteMetadata;
-    Object.entries(siteMetadata.pluginVersions).forEach(([plugin, versionInfo]) => {
-        var _a;
-        if (versionInfo.type === 'package' &&
-            ((_a = versionInfo.name) === null || _a === void 0 ? void 0 : _a.startsWith('@docusaurus/')) &&
-            versionInfo.version &&
-            versionInfo.version !== docusaurusVersion) {
-            // should we throw instead?
-            // It still could work with different versions
-            logger_1.default.error `Invalid name=${plugin} version number=${versionInfo.version}.
-All official @docusaurus/* packages should have the exact same version as @docusaurus/core (number=${docusaurusVersion}).
-Maybe you want to check, or regenerate your yarn.lock or package-lock.json file?`;
-        }
-    });
-}

package/lib/server/plugins/configs.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 { LoadContext, PluginModule, PluginOptions } from '@docusaurus/types';
+declare type ImportedPluginModule = PluginModule & {
+    default?: PluginModule;
+};
+export declare type NormalizedPluginConfig = {
+    /**
+     * The default export of the plugin module, or alternatively, what's provided
+     * in the config file as inline plugins. Note that if a file is like:
+     *
+     * ```ts
+     * export default plugin() {...}
+     * export validateOptions() {...}
+     * ```
+     *
+     * Then the static methods may not exist here. `pluginModule.module` will
+     * always take priority.
+     */
+    plugin: PluginModule;
+    /** Options as they are provided in the config, not validated yet. */
+    options: PluginOptions;
+    /** Only available when a string is provided in config. */
+    pluginModule?: {
+        /**
+         * Raw module name as provided in the config. Shorthands have been resolved,
+         * so at least it's directly `require.resolve`able.
+         */
+        path: string;
+        /** Whatever gets imported with `require`. */
+        module: ImportedPluginModule;
+    };
+    /**
+     * Different from `pluginModule.path`, this one is always an absolute path,
+     * used to resolve relative paths returned from lifecycles. If it's an inline
+     * plugin, it will be path to the config file.
+     */
+    entryPath: string;
+};
+/**
+ * Reads the site config's `presets`, `themes`, and `plugins`, imports them, and
+ * normalizes the return value. Plugin configs are ordered, mostly for theme
+ * alias shadowing. Site themes have the highest priority, and preset plugins
+ * are the lowest.
+ */
+export declare function loadPluginConfigs(context: LoadContext): Promise<NormalizedPluginConfig[]>;
+export {};

package/lib/server/plugins/configs.js

@@ -0,0 +1,101 @@
+"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.loadPluginConfigs = void 0;
+const tslib_1 = require("tslib");
+const module_1 = require("module");
+const import_fresh_1 = tslib_1.__importDefault(require("import-fresh"));
+const presets_1 = require("./presets");
+const moduleShorthand_1 = require("./moduleShorthand");
+async function normalizePluginConfig(pluginConfig, configPath, pluginRequire) {
+    // plugins: ["./plugin"]
+    if (typeof pluginConfig === 'string') {
+        const pluginModuleImport = pluginConfig;
+        const pluginPath = pluginRequire.resolve(pluginModuleImport);
+        const pluginModule = (0, import_fresh_1.default)(pluginPath);
+        return {
+            plugin: pluginModule?.default ?? pluginModule,
+            options: {},
+            pluginModule: {
+                path: pluginModuleImport,
+                module: pluginModule,
+            },
+            entryPath: pluginPath,
+        };
+    }
+    // plugins: [() => {...}]
+    if (typeof pluginConfig === 'function') {
+        return {
+            plugin: pluginConfig,
+            options: {},
+            entryPath: configPath,
+        };
+    }
+    // plugins: [
+    //   ["./plugin",options],
+    // ]
+    if (typeof pluginConfig[0] === 'string') {
+        const pluginModuleImport = pluginConfig[0];
+        const pluginPath = pluginRequire.resolve(pluginModuleImport);
+        const pluginModule = (0, import_fresh_1.default)(pluginPath);
+        return {
+            plugin: pluginModule?.default ?? pluginModule,
+            options: pluginConfig[1],
+            pluginModule: {
+                path: pluginModuleImport,
+                module: pluginModule,
+            },
+            entryPath: pluginPath,
+        };
+    }
+    // plugins: [
+    //   [() => {...}, options],
+    // ]
+    return {
+        plugin: pluginConfig[0],
+        options: pluginConfig[1],
+        entryPath: configPath,
+    };
+}
+/**
+ * Reads the site config's `presets`, `themes`, and `plugins`, imports them, and
+ * normalizes the return value. Plugin configs are ordered, mostly for theme
+ * alias shadowing. Site themes have the highest priority, and preset plugins
+ * are the lowest.
+ */
+async function loadPluginConfigs(context) {
+    const preset = await (0, presets_1.loadPresets)(context);
+    const { siteConfig, siteConfigPath } = context;
+    const pluginRequire = (0, module_1.createRequire)(siteConfigPath);
+    function normalizeShorthand(pluginConfig, pluginType) {
+        if (typeof pluginConfig === 'string') {
+            return (0, moduleShorthand_1.resolveModuleName)(pluginConfig, pluginRequire, pluginType);
+        }
+        else if (Array.isArray(pluginConfig) &&
+            typeof pluginConfig[0] === 'string') {
+            return [
+                (0, moduleShorthand_1.resolveModuleName)(pluginConfig[0], pluginRequire, pluginType),
+                pluginConfig[1] ?? {},
+            ];
+        }
+        return pluginConfig;
+    }
+    preset.plugins = preset.plugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
+    preset.themes = preset.themes.map((theme) => normalizeShorthand(theme, 'theme'));
+    const standalonePlugins = siteConfig.plugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
+    const standaloneThemes = siteConfig.themes.map((theme) => normalizeShorthand(theme, 'theme'));
+    const pluginConfigs = [
+        ...preset.plugins,
+        ...preset.themes,
+        // Site config should be the highest priority.
+        ...standalonePlugins,
+        ...standaloneThemes,
+    ].filter((x) => Boolean(x));
+    return Promise.all(pluginConfigs.map((pluginConfig) => normalizePluginConfig(pluginConfig, context.siteConfigPath, pluginRequire)));
+}
+exports.loadPluginConfigs = loadPluginConfigs;

package/lib/server/plugins/index.d.ts

@@ -4,14 +4,15 @@
  * 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, PluginConfig, RouteConfig, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
-export declare function sortConfig(routeConfigs: RouteConfig[], baseUrl?: string): void;
-export declare function loadPlugins({ pluginConfigs, context, }: {
-    pluginConfigs: PluginConfig[];
-    context: LoadContext;
-}): Promise<{
+import type { LoadContext, RouteConfig, GlobalData, LoadedPlugin } from '@docusaurus/types';
+/**
+ * Initializes the plugins, runs `loadContent`, `translateContent`,
+ * `contentLoaded`, and `translateThemeConfig`. Because `contentLoaded` is
+ * side-effect-ful (it generates temp files), so is this function. This function
+ * would also mutate `context.siteConfig.themeConfig` to translate it.
+ */
+export declare function loadPlugins(context: LoadContext): Promise<{
     plugins: LoadedPlugin[];
     pluginsRouteConfigs: RouteConfig[];
-    globalData: unknown;
-    themeConfigTranslated: ThemeConfig;
+    globalData: GlobalData;
 }>;