@docusaurus/core 0.0.0-4797 → 0.0.0-4800

package/lib/commands/build.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BuildCLIOptions } from '@docusaurus/types';
-export default function build(siteDir: string, cliOptions?: Partial<BuildCLIOptions>, forceTerminate?: boolean): Promise<string>;
+export declare function build(siteDir: string, cliOptions?: Partial<BuildCLIOptions>, forceTerminate?: boolean): Promise<string>;

package/lib/commands/build.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.build = void 0;
 const tslib_1 = require("tslib");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
@@ -46,7 +47,8 @@ forceTerminate = true) {
             throw err;
         }
     }
-    const context = await (0, server_1.loadContext)(siteDir, {
+    const context = await (0, server_1.loadContext)({
+        siteDir,
         customOutDir: cliOptions.outDir,
         customConfigFilePath: cliOptions.config,
         locale: cliOptions.locale,
@@ -73,12 +75,13 @@ forceTerminate = true) {
     });
     return results[0];
 }
-exports.default = build;
+exports.build = build;
 async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLastLocale, }) {
     process.env.BABEL_ENV = 'production';
     process.env.NODE_ENV = 'production';
     logger_1.default.info `name=${`[${locale}]`} Creating an optimized production build...`;
-    const props = await (0, server_1.load)(siteDir, {
+    const props = await (0, server_1.load)({
+        siteDir,
         customOutDir: cliOptions.outDir,
         customConfigFilePath: cliOptions.config,
         locale,

package/lib/commands/clear.d.ts

@@ -4,4 +4,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export default function clear(siteDir: string): Promise<unknown>;
+export declare function clear(siteDir: string): Promise<unknown>;

package/lib/commands/clear.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.clear = 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"));
@@ -40,4 +41,4 @@ async function clear(siteDir) {
     }));
     return Promise.all([generatedFolder, buildFolder, ...cacheFolders].map(removePath));
 }
-exports.default = clear;
+exports.clear = clear;

package/lib/commands/commandUtils.js

@@ -7,8 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCLIOptionPort = exports.getCLIOptionHost = void 0;
-const tslib_1 = require("tslib");
-const choosePort_1 = tslib_1.__importDefault(require("../choosePort"));
+const choosePort_1 = require("../server/choosePort");
 const utils_1 = require("@docusaurus/utils");
 function getCLIOptionHost(hostOption) {
     return hostOption ?? 'localhost';
@@ -16,6 +15,6 @@ function getCLIOptionHost(hostOption) {
 exports.getCLIOptionHost = getCLIOptionHost;
 async function getCLIOptionPort(portOption, host) {
     const basePort = portOption ? parseInt(portOption, 10) : utils_1.DEFAULT_PORT;
-    return (0, choosePort_1.default)(host, basePort);
+    return (0, choosePort_1.choosePort)(host, basePort);
 }
 exports.getCLIOptionPort = getCLIOptionPort;

package/lib/commands/deploy.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BuildCLIOptions } from '@docusaurus/types';
-export default function deploy(siteDir: string, cliOptions?: Partial<BuildCLIOptions>): Promise<void>;
+export declare function deploy(siteDir: string, cliOptions?: Partial<BuildCLIOptions>): Promise<void>;

package/lib/commands/deploy.js

@@ -6,13 +6,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy = void 0;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const shelljs_1 = tslib_1.__importDefault(require("shelljs"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const server_1 = require("../server");
-const build_1 = tslib_1.__importDefault(require("./build"));
+const build_1 = require("./build");
 const path_1 = tslib_1.__importDefault(require("path"));
 const os_1 = tslib_1.__importDefault(require("os"));
 // GIT_PASS env variable should not appear in logs
@@ -34,7 +35,8 @@ function shellExecLog(cmd) {
     }
 }
 async function deploy(siteDir, cliOptions = {}) {
-    const { outDir, siteConfig, siteConfigPath } = await (0, server_1.loadContext)(siteDir, {
+    const { outDir, siteConfig, siteConfigPath } = await (0, server_1.loadContext)({
+        siteDir,
         customConfigFilePath: cliOptions.config,
         customOutDir: cliOptions.outDir,
     });
@@ -172,7 +174,7 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
     if (!cliOptions.skipBuild) {
         // Build site, then push to deploymentBranch branch of specified repo.
         try {
-            await runDeploy(await (0, build_1.default)(siteDir, cliOptions, false));
+            await runDeploy(await (0, build_1.build)(siteDir, cliOptions, false));
         }
         catch (err) {
             logger_1.default.error('Deployment of the build output failed.');
@@ -184,4 +186,4 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
         await runDeploy(outDir);
     }
 }
-exports.default = deploy;
+exports.deploy = deploy;

package/lib/commands/external.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { CommanderStatic } from 'commander';
-export default function externalCommand(cli: CommanderStatic, siteDir: string): Promise<void>;
+export declare function externalCommand(cli: CommanderStatic, siteDir: string): Promise<void>;

package/lib/commands/external.js

@@ -6,16 +6,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
+exports.externalCommand = void 0;
 const server_1 = require("../server");
-const init_1 = tslib_1.__importDefault(require("../server/plugins/init"));
+const init_1 = require("../server/plugins/init");
 async function externalCommand(cli, siteDir) {
-    const context = await (0, server_1.loadContext)(siteDir);
-    const pluginConfigs = await (0, server_1.loadPluginConfigs)(context);
-    const plugins = await (0, init_1.default)({ pluginConfigs, context });
+    const context = await (0, server_1.loadContext)({ siteDir });
+    const plugins = await (0, init_1.initPlugins)(context);
     // Plugin Lifecycle - extendCli.
     plugins.forEach((plugin) => {
         plugin.extendCli?.(cli);
     });
 }
-exports.default = externalCommand;
+exports.externalCommand = externalCommand;

package/lib/commands/serve.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { ServeCLIOptions } from '@docusaurus/types';
-export default function serve(siteDir: string, cliOptions: ServeCLIOptions): Promise<void>;
+export declare function serve(siteDir: string, cliOptions: ServeCLIOptions): Promise<void>;

package/lib/commands/serve.js

@@ -6,18 +6,19 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.serve = void 0;
 const tslib_1 = require("tslib");
 const http_1 = tslib_1.__importDefault(require("http"));
 const serve_handler_1 = tslib_1.__importDefault(require("serve-handler"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const path_1 = tslib_1.__importDefault(require("path"));
-const server_1 = require("../server");
-const build_1 = tslib_1.__importDefault(require("./build"));
+const config_1 = require("../server/config");
+const build_1 = require("./build");
 const commandUtils_1 = require("./commandUtils");
 async function serve(siteDir, cliOptions) {
     let dir = path_1.default.resolve(siteDir, cliOptions.dir);
     if (cliOptions.build) {
-        dir = await (0, build_1.default)(siteDir, {
+        dir = await (0, build_1.build)(siteDir, {
             config: cliOptions.config,
             outDir: dir,
         }, false);
@@ -27,7 +28,7 @@ async function serve(siteDir, cliOptions) {
     if (port === null) {
         process.exit();
     }
-    const { siteConfig: { baseUrl, trailingSlash }, } = await (0, server_1.loadSiteConfig)({
+    const { siteConfig: { baseUrl, trailingSlash }, } = await (0, config_1.loadSiteConfig)({
         siteDir,
         customConfigFilePath: cliOptions.config,
     });
@@ -54,4 +55,4 @@ async function serve(siteDir, cliOptions) {
     logger_1.default.success `Serving path=${cliOptions.dir} directory at url=${servingUrl + baseUrl}.`;
     server.listen(port);
 }
-exports.default = serve;
+exports.serve = serve;

package/lib/commands/start.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { StartCLIOptions } from '@docusaurus/types';
-export default function start(siteDir: string, cliOptions: Partial<StartCLIOptions>): Promise<void>;
+export declare function start(siteDir: string, cliOptions: Partial<StartCLIOptions>): Promise<void>;

package/lib/commands/start.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.start = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
@@ -29,7 +30,8 @@ async function start(siteDir, cliOptions) {
     process.env.BABEL_ENV = 'development';
     logger_1.default.info('Starting the development server...');
     function loadSite() {
-        return (0, server_1.load)(siteDir, {
+        return (0, server_1.load)({
+            siteDir,
             customConfigFilePath: cliOptions.config,
             locale: cliOptions.locale,
             localizePath: undefined, // should this be configurable?
@@ -198,4 +200,4 @@ async function start(siteDir, cliOptions) {
         });
     });
 }
-exports.default = start;
+exports.start = start;

package/lib/commands/swizzle/common.d.ts

@@ -4,8 +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 { InitializedPlugin, SwizzleAction, SwizzleActionStatus } from '@docusaurus/types';
-import type { NormalizedPluginConfig } from '../../server/plugins/init';
+import type { InitializedPlugin, SwizzleAction, SwizzleActionStatus, NormalizedPluginConfig } from '@docusaurus/types';
 export declare const SwizzleActions: SwizzleAction[];
 export declare const SwizzleActionsStatuses: SwizzleActionStatus[];
 export declare const PartiallySafeHint: string;

package/lib/commands/swizzle/context.js

@@ -7,20 +7,16 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initSwizzleContext = void 0;
-const tslib_1 = require("tslib");
 const server_1 = require("../../server");
-const init_1 = tslib_1.__importStar(require("../../server/plugins/init"));
+const init_1 = require("../../server/plugins/init");
+const configs_1 = require("../../server/plugins/configs");
 async function initSwizzleContext(siteDir) {
-    const context = await (0, server_1.loadContext)(siteDir);
-    const pluginConfigs = await (0, server_1.loadPluginConfigs)(context);
-    const plugins = await (0, init_1.default)({
-        pluginConfigs,
-        context,
-    });
-    const pluginsNormalized = await (0, init_1.normalizePluginConfigs)(pluginConfigs, context.siteConfigPath);
+    const context = await (0, server_1.loadContext)({ siteDir });
+    const plugins = await (0, init_1.initPlugins)(context);
+    const pluginConfigs = await (0, configs_1.loadPluginConfigs)(context);
     return {
         plugins: plugins.map((plugin, pluginIndex) => ({
-            plugin: pluginsNormalized[pluginIndex],
+            plugin: pluginConfigs[pluginIndex],
             instance: plugin,
         })),
     };

package/lib/commands/swizzle/index.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { SwizzleOptions } from './common';
-export default function swizzle(siteDir: string, themeNameParam: string | undefined, componentNameParam: string | undefined, optionsParam: Partial<SwizzleOptions>): Promise<void>;
+export declare function swizzle(siteDir: string, themeNameParam: string | undefined, componentNameParam: string | undefined, optionsParam: Partial<SwizzleOptions>): Promise<void>;

package/lib/commands/swizzle/index.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.swizzle = void 0;
 const tslib_1 = require("tslib");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const themes_1 = require("./themes");
@@ -112,4 +113,4 @@ Ejected name=${componentName} from name=${themeName} to path=${result.createdFil
     await executeAction();
     return process.exit(0);
 }
-exports.default = swizzle;
+exports.swizzle = swizzle;

package/lib/commands/writeHeadingIds.d.ts

@@ -5,4 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { type WriteHeadingIDOptions } from '@docusaurus/utils';
-export default function writeHeadingIds(siteDir: string, files?: string[], options?: WriteHeadingIDOptions): Promise<void>;
+export declare function writeHeadingIds(siteDir: string, files?: string[], options?: WriteHeadingIDOptions): Promise<void>;

package/lib/commands/writeHeadingIds.js

@@ -6,12 +6,13 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeHeadingIds = void 0;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const server_1 = require("../server");
-const init_1 = tslib_1.__importDefault(require("../server/plugins/init"));
+const init_1 = require("../server/plugins/init");
 const utils_2 = require("../server/utils");
 async function transformMarkdownFile(filepath, options) {
     const content = await fs_extra_1.default.readFile(filepath, 'utf8');
@@ -29,12 +30,8 @@ async function transformMarkdownFile(filepath, options) {
  * transformed
  */
 async function getPathsToWatch(siteDir) {
-    const context = await (0, server_1.loadContext)(siteDir);
-    const pluginConfigs = await (0, server_1.loadPluginConfigs)(context);
-    const plugins = await (0, init_1.default)({
-        pluginConfigs,
-        context,
-    });
+    const context = await (0, server_1.loadContext)({ siteDir });
+    const plugins = await (0, init_1.initPlugins)(context);
     return plugins.flatMap((plugin) => plugin?.getPathsToWatch?.() ?? []);
 }
 async function writeHeadingIds(siteDir, files, options) {
@@ -50,4 +47,4 @@ async function writeHeadingIds(siteDir, files, options) {
         logger_1.default.warn `number=${markdownFiles.length} Markdown files already have explicit heading IDs. If you intend to overwrite the existing heading IDs, use the code=${'--overwrite'} option.`;
     }
 }
-exports.default = writeHeadingIds;
+exports.writeHeadingIds = writeHeadingIds;

package/lib/commands/writeTranslations.d.ts

@@ -6,6 +6,6 @@
  */
 import type { ConfigOptions } from '@docusaurus/types';
 import { type WriteTranslationsOptions } from '../server/translations/translations';
-export default function writeTranslations(siteDir: string, options: WriteTranslationsOptions & ConfigOptions & {
+export declare function writeTranslations(siteDir: string, options: WriteTranslationsOptions & ConfigOptions & {
     locale?: string;
 }): Promise<void>;

package/lib/commands/writeTranslations.js

@@ -6,10 +6,11 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeTranslations = void 0;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const server_1 = require("../server");
-const init_1 = tslib_1.__importDefault(require("../server/plugins/init"));
+const init_1 = require("../server/plugins/init");
 const translations_1 = require("../server/translations/translations");
 const translationsExtractor_1 = require("../server/translations/translationsExtractor");
 const utils_1 = require("../webpack/utils");
@@ -47,15 +48,12 @@ async function writePluginTranslationFiles({ siteDir, plugin, locale, options, }
     }
 }
 async function writeTranslations(siteDir, options) {
-    const context = await (0, server_1.loadContext)(siteDir, {
+    const context = await (0, server_1.loadContext)({
+        siteDir,
         customConfigFilePath: options.config,
         locale: options.locale,
     });
-    const pluginConfigs = await (0, server_1.loadPluginConfigs)(context);
-    const plugins = await (0, init_1.default)({
-        pluginConfigs,
-        context,
-    });
+    const plugins = await (0, init_1.initPlugins)(context);
     const locale = options.locale ?? context.i18n.defaultLocale;
     if (!context.i18n.locales.includes(locale)) {
         throw new Error(`Can't write-translation for locale "${locale}" that is not in the locale configuration file.
@@ -76,4 +74,4 @@ Available locales are: ${context.i18n.locales.join(',')}.`);
         await writePluginTranslationFiles({ siteDir, plugin, locale, options });
     }));
 }
-exports.default = writeTranslations;
+exports.writeTranslations = writeTranslations;

package/lib/index.d.ts

@@ -4,13 +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 build from './commands/build';
-import clear from './commands/clear';
-import deploy from './commands/deploy';
-import externalCommand from './commands/external';
-import serve from './commands/serve';
-import start from './commands/start';
-import swizzle from './commands/swizzle';
-import writeHeadingIds from './commands/writeHeadingIds';
-import writeTranslations from './commands/writeTranslations';
-export { build, clear, deploy, externalCommand, serve, start, swizzle, writeHeadingIds, writeTranslations, };
+export { build } from './commands/build';
+export { clear } from './commands/clear';
+export { deploy } from './commands/deploy';
+export { externalCommand } from './commands/external';
+export { serve } from './commands/serve';
+export { start } from './commands/start';
+export { swizzle } from './commands/swizzle';
+export { writeHeadingIds } from './commands/writeHeadingIds';
+export { writeTranslations } from './commands/writeTranslations';

package/lib/index.js

@@ -7,22 +7,21 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeTranslations = exports.writeHeadingIds = exports.swizzle = exports.start = exports.serve = exports.externalCommand = exports.deploy = exports.clear = exports.build = void 0;
-const tslib_1 = require("tslib");
-const build_1 = tslib_1.__importDefault(require("./commands/build"));
-exports.build = build_1.default;
-const clear_1 = tslib_1.__importDefault(require("./commands/clear"));
-exports.clear = clear_1.default;
-const deploy_1 = tslib_1.__importDefault(require("./commands/deploy"));
-exports.deploy = deploy_1.default;
-const external_1 = tslib_1.__importDefault(require("./commands/external"));
-exports.externalCommand = external_1.default;
-const serve_1 = tslib_1.__importDefault(require("./commands/serve"));
-exports.serve = serve_1.default;
-const start_1 = tslib_1.__importDefault(require("./commands/start"));
-exports.start = start_1.default;
-const swizzle_1 = tslib_1.__importDefault(require("./commands/swizzle"));
-exports.swizzle = swizzle_1.default;
-const writeHeadingIds_1 = tslib_1.__importDefault(require("./commands/writeHeadingIds"));
-exports.writeHeadingIds = writeHeadingIds_1.default;
-const writeTranslations_1 = tslib_1.__importDefault(require("./commands/writeTranslations"));
-exports.writeTranslations = writeTranslations_1.default;
+var build_1 = require("./commands/build");
+Object.defineProperty(exports, "build", { enumerable: true, get: function () { return build_1.build; } });
+var clear_1 = require("./commands/clear");
+Object.defineProperty(exports, "clear", { enumerable: true, get: function () { return clear_1.clear; } });
+var deploy_1 = require("./commands/deploy");
+Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return deploy_1.deploy; } });
+var external_1 = require("./commands/external");
+Object.defineProperty(exports, "externalCommand", { enumerable: true, get: function () { return external_1.externalCommand; } });
+var serve_1 = require("./commands/serve");
+Object.defineProperty(exports, "serve", { enumerable: true, get: function () { return serve_1.serve; } });
+var start_1 = require("./commands/start");
+Object.defineProperty(exports, "start", { enumerable: true, get: function () { return start_1.start; } });
+var swizzle_1 = require("./commands/swizzle");
+Object.defineProperty(exports, "swizzle", { enumerable: true, get: function () { return swizzle_1.swizzle; } });
+var writeHeadingIds_1 = require("./commands/writeHeadingIds");
+Object.defineProperty(exports, "writeHeadingIds", { enumerable: true, get: function () { return writeHeadingIds_1.writeHeadingIds; } });
+var writeTranslations_1 = require("./commands/writeTranslations");
+Object.defineProperty(exports, "writeTranslations", { enumerable: true, get: function () { return writeTranslations_1.writeTranslations; } });

package/lib/server/choosePort.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+/**
+ * Detects if program is running on port, and prompts user to choose another if
+ * port is already being used. This feature was heavily inspired by
+ * create-react-app and uses many of the same utility functions to implement it.
+ */
+export declare function choosePort(host: string, defaultPort: number): Promise<number | null>;

package/lib/{choosePort.js → server/choosePort.js}

@@ -6,17 +6,12 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.choosePort = void 0;
 const tslib_1 = require("tslib");
-/**
- * This feature was heavily inspired by create-react-app and
- * uses many of the same utility functions to implement it.
- */
 const child_process_1 = require("child_process");
 const detect_port_1 = tslib_1.__importDefault(require("detect-port"));
-const is_root_1 = tslib_1.__importDefault(require("is-root"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const prompts_1 = tslib_1.__importDefault(require("prompts"));
-const isInteractive = process.stdout.isTTY;
 const execOptions = {
     encoding: 'utf8',
     stdio: [
@@ -57,8 +52,9 @@ function getProcessForPort(port) {
     }
 }
 /**
- * Detects if program is running on port and prompts user
- * to choose another if port is already being used
+ * Detects if program is running on port, and prompts user to choose another if
+ * port is already being used. This feature was heavily inspired by
+ * create-react-app and uses many of the same utility functions to implement it.
  */
 async function choosePort(host, defaultPort) {
     try {
@@ -66,7 +62,9 @@ async function choosePort(host, defaultPort) {
         if (port === defaultPort) {
             return port;
         }
-        const message = process.platform !== 'win32' && defaultPort < 1024 && !(0, is_root_1.default)()
+        const isRoot = process.getuid?.() === 0;
+        const isInteractive = process.stdout.isTTY;
+        const message = process.platform !== 'win32' && defaultPort < 1024 && !isRoot
             ? `Admin permissions are required to run a server on a port below 1024.`
             : `Something is already running on port ${defaultPort}.`;
         if (!isInteractive) {
@@ -90,4 +88,4 @@ Would you like to run the app on another port instead?`),
         throw err;
     }
 }
-exports.default = choosePort;
+exports.choosePort = choosePort;

package/lib/server/{client-modules/index.d.ts → clientModules.d.ts}

@@ -5,4 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadedPlugin } from '@docusaurus/types';
-export default function loadClientModules(plugins: LoadedPlugin<unknown>[]): string[];
+/**
+ * Runs the `getClientModules` lifecycle. The returned file paths are all
+ * absolute.
+ */
+export declare function loadClientModules(plugins: LoadedPlugin[]): string[];

package/lib/server/{client-modules/index.js → clientModules.js}

@@ -6,10 +6,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadClientModules = void 0;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
+/**
+ * Runs the `getClientModules` lifecycle. The returned file paths are all
+ * absolute.
+ */
 function loadClientModules(plugins) {
     return plugins.flatMap((plugin) => plugin.getClientModules?.().map((p) => path_1.default.resolve(plugin.path, p)) ??
         []);
 }
-exports.default = loadClientModules;
+exports.loadClientModules = loadClientModules;

package/lib/server/config.d.ts

@@ -4,5 +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 { DocusaurusConfig } from '@docusaurus/types';
-export default function loadConfig(configPath: string): Promise<DocusaurusConfig>;
+import type { LoadContext } from '@docusaurus/types';
+export declare function loadSiteConfig({ siteDir, customConfigFilePath, }: {
+    siteDir: string;
+    customConfigFilePath?: string;
+}): Promise<Pick<LoadContext, 'siteConfig' | 'siteConfigPath'>>;

package/lib/server/config.js

@@ -6,18 +6,23 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSiteConfig = 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"));
 const import_fresh_1 = tslib_1.__importDefault(require("import-fresh"));
+const utils_1 = require("@docusaurus/utils");
 const configValidation_1 = require("./configValidation");
-async function loadConfig(configPath) {
-    if (!(await fs_extra_1.default.pathExists(configPath))) {
-        throw new Error(`Config file at "${configPath}" not found.`);
+async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
+    const siteConfigPath = path_1.default.resolve(siteDir, customConfigFilePath ?? utils_1.DEFAULT_CONFIG_FILE_NAME);
+    if (!(await fs_extra_1.default.pathExists(siteConfigPath))) {
+        throw new Error(`Config file at "${siteConfigPath}" not found.`);
     }
-    const importedConfig = (0, import_fresh_1.default)(configPath);
+    const importedConfig = (0, import_fresh_1.default)(siteConfigPath);
     const loadedConfig = typeof importedConfig === 'function'
         ? await importedConfig()
         : await importedConfig;
-    return (0, configValidation_1.validateConfig)(loadedConfig);
+    const siteConfig = (0, configValidation_1.validateConfig)(loadedConfig);
+    return { siteConfig, siteConfigPath };
 }
-exports.default = loadConfig;
+exports.loadSiteConfig = loadSiteConfig;

package/lib/server/htmlTags.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { Props, LoadedPlugin } from '@docusaurus/types';
+/**
+ * Runs the `injectHtmlTags` lifecycle, and aggregates all plugins' tags into
+ * directly render-able HTML markup.
+ */
+export declare function loadHtmlTags(plugins: LoadedPlugin[]): Pick<Props, 'headTags' | 'preBodyTags' | 'postBodyTags'>;