@docusaurus/core 0.0.0-4798 → 0.0.0-4801

package/lib/server/htmlTags.js

@@ -0,0 +1,62 @@
+"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.loadHtmlTags = void 0;
+const tslib_1 = require("tslib");
+const html_tags_1 = tslib_1.__importDefault(require("html-tags"));
+const void_1 = tslib_1.__importDefault(require("html-tags/void"));
+const escape_html_1 = tslib_1.__importDefault(require("escape-html"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+function assertIsHtmlTagObject(val) {
+    if (typeof val !== 'object' || !val) {
+        throw new Error(`"${val}" is not a valid HTML tag object.`);
+    }
+    if (typeof val.tagName !== 'string') {
+        throw new Error(`${JSON.stringify(val)} is not a valid HTML tag object. "tagName" must be defined as a string.`);
+    }
+    if (!html_tags_1.default.includes(val.tagName)) {
+        throw new Error(`Error loading ${JSON.stringify(val)}, "${val.tagName}" is not a valid HTML tag.`);
+    }
+}
+function htmlTagObjectToString(tag) {
+    assertIsHtmlTagObject(tag);
+    const isVoidTag = void_1.default.includes(tag.tagName);
+    const tagAttributes = tag.attributes ?? {};
+    const attributes = Object.keys(tagAttributes)
+        .map((attr) => {
+        const value = tagAttributes[attr];
+        if (typeof value === 'boolean') {
+            return value ? attr : undefined;
+        }
+        return `${attr}="${(0, escape_html_1.default)(value)}"`;
+    })
+        .filter((str) => Boolean(str));
+    const openingTag = `<${[tag.tagName].concat(attributes).join(' ')}>`;
+    const innerHTML = (!isVoidTag && tag.innerHTML) || '';
+    const closingTag = isVoidTag ? '' : `</${tag.tagName}>`;
+    return openingTag + innerHTML + closingTag;
+}
+function createHtmlTagsString(tags) {
+    return (Array.isArray(tags) ? tags : [tags])
+        .filter(Boolean)
+        .map((val) => (typeof val === 'string' ? val : htmlTagObjectToString(val)))
+        .join('\n');
+}
+/**
+ * Runs the `injectHtmlTags` lifecycle, and aggregates all plugins' tags into
+ * directly render-able HTML markup.
+ */
+function loadHtmlTags(plugins) {
+    const pluginHtmlTags = plugins.map((plugin) => plugin.injectHtmlTags?.({ content: plugin.content }) ?? {});
+    const tagTypes = ['headTags', 'preBodyTags', 'postBodyTags'];
+    return Object.fromEntries(lodash_1.default.zip(tagTypes, tagTypes.map((type) => pluginHtmlTags
+        .map((tags) => createHtmlTagsString(tags[type]))
+        .join('\n')
+        .trim())));
+}
+exports.loadHtmlTags = loadHtmlTags;

package/lib/server/i18n.d.ts

@@ -5,15 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { I18n, DocusaurusConfig, I18nLocaleConfig } from '@docusaurus/types';
+import type { LoadContextOptions } from './index';
 export declare function getDefaultLocaleConfig(locale: string): I18nLocaleConfig;
-export declare function loadI18n(config: DocusaurusConfig, options: {
-    locale?: string;
-}): Promise<I18n>;
-export declare function localizePath({ pathType, path: originalPath, i18n, options, }: {
-    pathType: 'fs' | 'url';
-    path: string;
-    i18n: I18n;
-    options?: {
-        localizePath?: boolean;
-    };
-}): string;
+export declare function loadI18n(config: DocusaurusConfig, options: Pick<LoadContextOptions, 'locale'>): Promise<I18n>;

package/lib/server/i18n.js

@@ -6,10 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localizePath = exports.loadI18n = exports.getDefaultLocaleConfig = void 0;
+exports.loadI18n = exports.getDefaultLocaleConfig = void 0;
 const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const utils_1 = require("@docusaurus/utils");
 const rtl_detect_1 = require("rtl-detect");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 function getDefaultLocaleLabel(locale) {
@@ -49,18 +47,3 @@ Note: Docusaurus only support running one locale at a time.`;
     };
 }
 exports.loadI18n = loadI18n;
-function localizePath({ pathType, path: originalPath, i18n, options = {}, }) {
-    const shouldLocalizePath = 
-    // By default, we don't localize the path of defaultLocale
-    options.localizePath ?? i18n.currentLocale !== i18n.defaultLocale;
-    if (!shouldLocalizePath) {
-        return originalPath;
-    }
-    // FS paths need special care, for Windows support
-    if (pathType === 'fs') {
-        return path_1.default.join(originalPath, i18n.currentLocale);
-    }
-    // Url paths; add a trailing slash so it's a valid base URL
-    return (0, utils_1.normalizeUrl)([originalPath, i18n.currentLocale, '/']);
-}
-exports.localizePath = localizePath;

package/lib/server/index.d.ts

@@ -4,20 +4,35 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { DocusaurusConfig, LoadContext, PluginConfig, Props } from '@docusaurus/types';
+import type { LoadContext, Props } from '@docusaurus/types';
 export declare type LoadContextOptions = {
+    /** Usually the CWD; can be overridden with command argument. */
+    siteDir: string;
+    /** Can be customized with `--out-dir` option */
     customOutDir?: string;
+    /** Can be customized with `--config` option */
     customConfigFilePath?: string;
+    /** Default is `i18n.defaultLocale` */
     locale?: string;
+    /**
+     * `true` means the paths will have the locale prepended; `false` means they
+     * won't (useful for `yarn build -l zh-Hans` where the output should be
+     * emitted into `build/` instead of `build/zh-Hans/`); `undefined` is like the
+     * "smart" option where only non-default locale paths are localized
+     */
     localizePath?: boolean;
 };
-export declare function loadSiteConfig({ siteDir, customConfigFilePath, }: {
-    siteDir: string;
-    customConfigFilePath?: string;
-}): Promise<{
-    siteConfig: DocusaurusConfig;
-    siteConfigPath: string;
-}>;
-export declare function loadContext(siteDir: string, options?: LoadContextOptions): Promise<LoadContext>;
-export declare function loadPluginConfigs(context: LoadContext): Promise<PluginConfig[]>;
-export declare function load(siteDir: string, options?: LoadContextOptions): Promise<Props>;
+/**
+ * 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.
+ */
+export declare function loadContext(options: LoadContextOptions): 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>;

package/lib/server/index.js

@@ -6,50 +6,42 @@
  * 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 lodash_1 = tslib_1.__importDefault(require("lodash"));
 const path_1 = tslib_1.__importDefault(require("path"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const config_1 = require("./config");
 const ssr_html_template_1 = tslib_1.__importDefault(require("../webpack/templates/ssr.html.template"));
-const client_modules_1 = tslib_1.__importDefault(require("./client-modules"));
-const config_1 = tslib_1.__importDefault(require("./config"));
+const clientModules_1 = require("./clientModules");
 const plugins_1 = require("./plugins");
-const presets_1 = tslib_1.__importDefault(require("./presets"));
-const routes_1 = 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 = tslib_1.__importDefault(require("lodash"));
-const remark_admonitions_1 = tslib_1.__importDefault(require("remark-admonitions"));
-const module_1 = require("module");
-const moduleShorthand_1 = require("./moduleShorthand");
-async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
-    const siteConfigPath = path_1.default.resolve(siteDir, customConfigFilePath ?? utils_1.DEFAULT_CONFIG_FILE_NAME);
-    const siteConfig = await (0, config_1.default)(siteConfigPath);
-    return { siteConfig, siteConfigPath };
-}
-exports.loadSiteConfig = loadSiteConfig;
-async function loadContext(siteDir, options = {}) {
-    const { customOutDir, locale, customConfigFilePath } = options;
+/**
+ * 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, customOutDir, locale, customConfigFilePath } = options;
     const generatedFilesDir = path_1.default.resolve(siteDir, utils_1.GENERATED_FILES_DIR_NAME);
-    const { siteConfig: initialSiteConfig, siteConfigPath } = await loadSiteConfig({
+    const { siteConfig: initialSiteConfig, siteConfigPath } = await (0, config_1.loadSiteConfig)({
         siteDir,
         customConfigFilePath,
     });
-    const { ssrTemplate } = initialSiteConfig;
-    const baseOutDir = path_1.default.resolve(siteDir, customOutDir ?? 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, customOutDir ?? utils_1.DEFAULT_BUILD_DIR_NAME),
         i18n,
         options,
         pathType: 'fs',
@@ -69,144 +61,33 @@ async function loadContext(siteDir, options = {}) {
         outDir,
         baseUrl,
         i18n,
-        ssrTemplate: ssrTemplate ?? ssr_html_template_1.default,
+        ssrTemplate: siteConfig.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) {
-        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),
-                pluginConfig[1] ?? {},
-            ];
-        }
-        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({ siteDir, siteConfig, }) {
-    const { stylesheets, scripts, clientModules: siteConfigClientModules, } = siteConfig;
-    return {
-        name: 'docusaurus-bootstrap-plugin',
-        content: null,
-        options: {
-            id: 'default',
-        },
-        version: { type: 'synthetic' },
-        path: siteDir,
-        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: {
-            id: 'default',
-        },
-        version: { type: 'synthetic' },
-        // Synthetic, the path doesn't matter much
-        path: '.',
-        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() {
-                const rules = config?.module?.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: () => true,
-                                        isMDXPartialFrontMatterWarningDisabled: true,
-                                        remarkPlugins: [remark_admonitions_1.default],
-                                    },
-                                },
-                            ],
-                        },
-                    ],
-                },
-            };
-        },
-    };
-}
-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 });
+async function load(options) {
+    const { siteDir } = options;
+    const context = await loadContext(options);
+    const { generatedFilesDir, siteConfig, siteConfigPath, outDir, baseUrl, i18n, ssrTemplate, codeTranslations: siteCodeTranslations, } = context;
+    const { plugins, pluginsRouteConfigs, globalData, themeConfigTranslated } = await (0, plugins_1.loadPlugins)(context);
     // Side-effect to replace the untranslated themeConfig by the translated one
     context.siteConfig.themeConfig = themeConfigTranslated;
-    (0, duplicateRoutes_1.handleDuplicateRoutes)(pluginsRouteConfigs, siteConfig.onDuplicateRoutes);
+    const clientModules = (0, clientModules_1.loadClientModules)(plugins);
+    const { headTags, preBodyTags, postBodyTags } = (0, htmlTags_1.loadHtmlTags)(plugins);
+    const { registry, routesChunkNames, routesConfig, routesPaths } = await (0, routes_1.loadRoutes)(pluginsRouteConfigs, baseUrl, siteConfig.onDuplicateRoutes);
+    const codeTranslations = {
+        ...(await (0, translations_1.getPluginsDefaultCodeTranslationMessages)(plugins)),
+        ...siteCodeTranslations,
+    };
+    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
@@ -222,9 +103,6 @@ next build. You can clear all build artifacts (including this folder) with the
  */
 export default ${JSON.stringify(siteConfig, null, 2)};
 `);
-    plugins.push(createBootstrapPlugin({ siteDir, siteConfig }), 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 [
 ${clientModules
         // import() is async so we use require() because client modules can have
@@ -233,10 +111,6 @@ ${clientModules
         .join('\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);
     const genRegistry = (0, utils_1.generate)(generatedFilesDir, 'registry.js', `export default {
 ${Object.entries(registry)
         .sort((a, b) => a[0].localeCompare(b[0]))
@@ -247,23 +121,7 @@ ${Object.entries(registry)
     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,
@@ -277,7 +135,7 @@ ${Object.entries(registry)
         genI18n,
         genCodeTranslations,
     ]);
-    const props = {
+    return {
         siteConfig,
         siteConfigPath,
         siteMetadata,
@@ -295,24 +153,5 @@ ${Object.entries(registry)
         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]) => {
-        if (versionInfo.type === 'package' &&
-            versionInfo.name?.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,14 @@
+/**
+ * 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, NormalizedPluginConfig } from '@docusaurus/types';
+/**
+ * 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[]>;

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,
+    ];
+    return Promise.all(pluginConfigs.map((pluginConfig) => normalizePluginConfig(pluginConfig, context.siteConfigPath, pluginRequire)));
+}
+exports.loadPluginConfigs = loadPluginConfigs;

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

@@ -4,12 +4,12 @@
  * 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, GlobalData, 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, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
+/**
+ * Initializes the plugins, runs `loadContent`, `translateContent`,
+ * `contentLoaded`, and `translateThemeConfig`.
+ */
+export declare function loadPlugins(context: LoadContext): Promise<{
     plugins: LoadedPlugin[];
     pluginsRouteConfigs: RouteConfig[];
     globalData: GlobalData;