@docusaurus/core 2.0.0-beta.15d451942 → 2.0.0-beta.18

package/lib/client/theme-fallback/Loading/index.js

@@ -4,133 +4,65 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 import React from 'react';
-
-export default ({error, retry, pastDelay}) => {
-  if (error) {
-    return (
-      <div
-        style={{
-          align: 'center',
-          color: '#fff',
-          backgroundColor: '#fa383e',
-          borderColor: '#fa383e',
-          borderStyle: 'solid',
-          borderRadius: '0.25rem',
-          borderWidth: '1px',
-          boxSizing: 'border-box',
-          display: 'block',
-          padding: '1rem',
-          flex: '0 0 50%',
-          marginLeft: '25%',
-          marginRight: '25%',
-          marginTop: '5rem',
-          maxWidth: '50%',
-          width: '100%',
-        }}>
+export default function Loading({ error, retry, pastDelay, }) {
+    if (error) {
+        return (<div style={{
+                textAlign: 'center',
+                color: '#fff',
+                backgroundColor: '#fa383e',
+                borderColor: '#fa383e',
+                borderStyle: 'solid',
+                borderRadius: '0.25rem',
+                borderWidth: '1px',
+                boxSizing: 'border-box',
+                display: 'block',
+                padding: '1rem',
+                flex: '0 0 50%',
+                marginLeft: '25%',
+                marginRight: '25%',
+                marginTop: '5rem',
+                maxWidth: '50%',
+                width: '100%',
+            }}>
         <p>{error.message}</p>
         <div>
           <button type="button" onClick={retry}>
             Retry
           </button>
         </div>
-      </div>
-    );
-  }
-
-  if (pastDelay) {
-    return (
-      <div
-        style={{
-          display: 'flex',
-          justifyContent: 'center',
-          alignItems: 'center',
-          height: '100vh',
-        }}>
-        <svg
-          id="loader"
-          style={{
-            width: 128,
-            height: 110,
-            position: 'absolute',
-            top: 'calc(100vh - 64%)',
-          }}
-          viewBox="0 0 45 45"
-          xmlns="http://www.w3.org/2000/svg"
-          stroke="#61dafb">
-          <g
-            fill="none"
-            fillRule="evenodd"
-            transform="translate(1 1)"
-            strokeWidth="2">
+      </div>);
+    }
+    if (pastDelay) {
+        return (<div style={{
+                display: 'flex',
+                justifyContent: 'center',
+                alignItems: 'center',
+                height: '100vh',
+            }}>
+        <svg id="loader" style={{
+                width: 128,
+                height: 110,
+                position: 'absolute',
+                top: 'calc(100vh - 64%)',
+            }} viewBox="0 0 45 45" xmlns="http://www.w3.org/2000/svg" stroke="#61dafb">
+          <g fill="none" fillRule="evenodd" transform="translate(1 1)" strokeWidth="2">
             <circle cx="22" cy="22" r="6" strokeOpacity="0">
-              <animate
-                attributeName="r"
-                begin="1.5s"
-                dur="3s"
-                values="6;22"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-opacity"
-                begin="1.5s"
-                dur="3s"
-                values="1;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-width"
-                begin="1.5s"
-                dur="3s"
-                values="2;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
+              <animate attributeName="r" begin="1.5s" dur="3s" values="6;22" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-opacity" begin="1.5s" dur="3s" values="1;0" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-width" begin="1.5s" dur="3s" values="2;0" calcMode="linear" repeatCount="indefinite"/>
             </circle>
             <circle cx="22" cy="22" r="6" strokeOpacity="0">
-              <animate
-                attributeName="r"
-                begin="3s"
-                dur="3s"
-                values="6;22"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-opacity"
-                begin="3s"
-                dur="3s"
-                values="1;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-width"
-                begin="3s"
-                dur="3s"
-                values="2;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
+              <animate attributeName="r" begin="3s" dur="3s" values="6;22" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-opacity" begin="3s" dur="3s" values="1;0" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-width" begin="3s" dur="3s" values="2;0" calcMode="linear" repeatCount="indefinite"/>
             </circle>
             <circle cx="22" cy="22" r="8">
-              <animate
-                attributeName="r"
-                begin="0s"
-                dur="1.5s"
-                values="6;1;2;3;4;5;6"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
+              <animate attributeName="r" begin="0s" dur="1.5s" values="6;1;2;3;4;5;6" calcMode="linear" repeatCount="indefinite"/>
             </circle>
           </g>
         </svg>
-      </div>
-    );
-  }
-
-  return null;
-};
+      </div>);
+    }
+    return null;
+}

package/lib/client/{exports/context.js → theme-fallback/NotFound/index.d.ts}

@@ -4,5 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React from 'react';
-export default React.createContext(null);
+/// <reference types="react" />
+export default function NotFound(): JSX.Element;

package/lib/client/theme-fallback/NotFound/index.js

@@ -4,25 +4,24 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 import React from 'react';
 import Layout from '@theme/Layout';
-
-function NotFound() {
-  return (
-    <Layout title="Page Not Found">
-      <div
-        style={{
-          display: 'flex',
-          justifyContent: 'center',
-          alignItems: 'center',
-          height: '50vh',
-          fontSize: '20px',
+import Head from '@docusaurus/Head';
+export default function NotFound() {
+    return (<>
+      <Head>
+        <title>Page Not Found</title>
+      </Head>
+      <Layout>
+        <div style={{
+            display: 'flex',
+            justifyContent: 'center',
+            alignItems: 'center',
+            height: '50vh',
+            fontSize: '20px',
         }}>
-        <h1>Oops, page not found </h1>
-      </div>
-    </Layout>
-  );
+          <h1>Oops, page not found </h1>
+        </div>
+      </Layout>
+    </>);
 }
-
-export default NotFound;

package/lib/client/theme-fallback/Root/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+/// <reference types="@docusaurus/module-type-aliases" />
+/// <reference types="react" />
+import type { Props } from '@theme/Root';
+export default function Root({ children }: Props): JSX.Element;

package/lib/client/theme-fallback/Root/index.js

@@ -4,9 +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 React from 'react';
-
 // Wrapper at the very top of the app, that is applied constantly
 // and does not depend on current route (unlike the layout)
 //
@@ -14,8 +12,6 @@ import React from 'react';
 // and these providers won't reset state when we navigate
 //
 // See https://github.com/facebook/docusaurus/issues/3919
-function Root({children}) {
-  return <>{children}</>;
+export default function Root({ children }) {
+    return <>{children}</>;
 }
-
-export default Root;

package/lib/client/theme-fallback/SiteMetadata/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ */
+/// <reference types="react" />
+export default function SiteMetadata(): JSX.Element | null;

package/lib/client/theme-fallback/SiteMetadata/index.js

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+// To be implemented by the theme with <Head>
+export default function SiteMetadata() {
+    return null;
+}

package/lib/commands/build.d.ts

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

package/lib/commands/build.js

@@ -7,14 +7,13 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const react_loadable_ssr_addon_v5_slorber_1 = tslib_1.__importDefault(require("react-loadable-ssr-addon-v5-slorber"));
 const webpack_bundle_analyzer_1 = require("webpack-bundle-analyzer");
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
-const constants_1 = require("../constants");
 const server_1 = require("../server");
 const brokenLinks_1 = require("../server/brokenLinks");
 const client_1 = tslib_1.__importDefault(require("../webpack/client"));
@@ -24,11 +23,16 @@ const CleanWebpackPlugin_1 = tslib_1.__importDefault(require("../webpack/plugins
 const i18n_1 = require("../server/i18n");
 const utils_2 = require("@docusaurus/utils");
 async function build(siteDir, cliOptions = {}, 
-// TODO what's the purpose of this arg ?
+// When running build, we force terminate the process to prevent async
+// operations from never returning. However, if run as part of docusaurus
+// deploy, we have to let deploy finish.
+// See https://github.com/facebook/docusaurus/pull/2496
 forceTerminate = true) {
+    ['SIGINT', 'SIGTERM'].forEach((sig) => {
+        process.on(sig, () => process.exit());
+    });
     async function tryToBuildLocale({ locale, isLastLocale, }) {
         try {
-            // console.log(chalk.green(`Site successfully built in locale=${locale}`));
             return await buildLocale({
                 siteDir,
                 locale,
@@ -37,60 +41,58 @@ forceTerminate = true) {
                 isLastLocale,
             });
         }
-        catch (e) {
-            console.error(`Unable to build website for locale ${locale}.`);
-            throw e;
+        catch (err) {
+            logger_1.default.error `Unable to build website for locale name=${locale}.`;
+            throw err;
         }
     }
-    const context = await server_1.loadContext(siteDir, {
+    const context = await (0, server_1.loadContext)(siteDir, {
         customOutDir: cliOptions.outDir,
         customConfigFilePath: cliOptions.config,
         locale: cliOptions.locale,
         localizePath: cliOptions.locale ? false : undefined,
     });
-    const i18n = await i18n_1.loadI18n(context.siteConfig, {
+    const i18n = await (0, i18n_1.loadI18n)(context.siteConfig, {
         locale: cliOptions.locale,
     });
     if (cliOptions.locale) {
         return tryToBuildLocale({ locale: cliOptions.locale, isLastLocale: true });
     }
-    else {
-        if (i18n.locales.length > 1) {
-            console.log(chalk_1.default.yellow(`\nSite will be built for all these locales:
-- ${i18n.locales.join('\n- ')}`));
-        }
-        // We need the default locale to always be the 1st in the list
-        // If we build it last, it would "erase" the localized sites built in subfolders
-        const orderedLocales = [
-            i18n.defaultLocale,
-            ...i18n.locales.filter((locale) => locale !== i18n.defaultLocale),
-        ];
-        const results = await utils_2.mapAsyncSequencial(orderedLocales, (locale) => {
-            const isLastLocale = orderedLocales.indexOf(locale) === orderedLocales.length - 1;
-            return tryToBuildLocale({ locale, isLastLocale });
-        });
-        return results[0];
+    if (i18n.locales.length > 1) {
+        logger_1.default.info `Website will be built for all these locales: ${i18n.locales}`;
     }
+    // We need the default locale to always be the 1st in the list. If we build it
+    // last, it would "erase" the localized sites built in sub-folders
+    const orderedLocales = [
+        i18n.defaultLocale,
+        ...i18n.locales.filter((locale) => locale !== i18n.defaultLocale),
+    ];
+    const results = await (0, utils_2.mapAsyncSequential)(orderedLocales, (locale) => {
+        const isLastLocale = orderedLocales.indexOf(locale) === orderedLocales.length - 1;
+        return tryToBuildLocale({ locale, isLastLocale });
+    });
+    return results[0];
 }
 exports.default = build;
 async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLastLocale, }) {
     process.env.BABEL_ENV = 'production';
     process.env.NODE_ENV = 'production';
-    console.log(chalk_1.default.blue(`\n[${locale}] Creating an optimized production build...`));
-    const props = await server_1.load(siteDir, {
+    logger_1.default.info `name=${`[${locale}]`} Creating an optimized production build...`;
+    const props = await (0, server_1.load)(siteDir, {
         customOutDir: cliOptions.outDir,
         customConfigFilePath: cliOptions.config,
         locale,
         localizePath: cliOptions.locale ? false : undefined,
     });
     // Apply user webpack config.
-    const { outDir, generatedFilesDir, plugins, siteConfig: { baseUrl, onBrokenLinks }, routes, } = props;
+    const { outDir, generatedFilesDir, plugins, siteConfig: { baseUrl, onBrokenLinks, staticDirectories }, routes, } = props;
     const clientManifestPath = path_1.default.join(generatedFilesDir, 'client-manifest.json');
-    let clientConfig = webpack_merge_1.default(client_1.default(props, cliOptions.minify), {
+    let clientConfig = (0, webpack_merge_1.default)(await (0, client_1.default)(props, cliOptions.minify), {
         plugins: [
             // Remove/clean build folders before building bundles.
             new CleanWebpackPlugin_1.default({ verbose: false }),
-            // Visualize size of webpack output files with an interactive zoomable treemap.
+            // Visualize size of webpack output files with an interactive zoomable
+            // tree map.
             cliOptions.bundleAnalyzer && new webpack_bundle_analyzer_1.BundleAnalyzerPlugin(),
             // Generate client manifests file that will be used for server bundle.
             new react_loadable_ssr_addon_v5_slorber_1.default({
@@ -99,39 +101,35 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         ].filter(Boolean),
     });
     const allCollectedLinks = {};
-    let serverConfig = server_2.default({
+    let serverConfig = await (0, server_2.default)({
         props,
         onLinksCollected: (staticPagePath, links) => {
             allCollectedLinks[staticPagePath] = links;
         },
     });
-    const staticDir = path_1.default.resolve(siteDir, constants_1.STATIC_DIR_NAME);
-    if (await fs_extra_1.default.pathExists(staticDir)) {
-        serverConfig = webpack_merge_1.default(serverConfig, {
+    if (staticDirectories.length > 0) {
+        await Promise.all(staticDirectories.map((dir) => fs_extra_1.default.ensureDir(dir)));
+        serverConfig = (0, webpack_merge_1.default)(serverConfig, {
             plugins: [
                 new copy_webpack_plugin_1.default({
-                    patterns: [
-                        {
-                            from: staticDir,
-                            to: outDir,
-                        },
-                    ],
+                    patterns: staticDirectories
+                        .map((dir) => path_1.default.resolve(siteDir, dir))
+                        .map((dir) => ({ from: dir, to: outDir })),
                 }),
             ],
         });
     }
     // Plugin Lifecycle - configureWebpack and configurePostCss.
     plugins.forEach((plugin) => {
-        var _a, _b;
         const { configureWebpack, configurePostCss } = plugin;
         if (configurePostCss) {
-            clientConfig = utils_1.applyConfigurePostCss(configurePostCss, clientConfig);
+            clientConfig = (0, utils_1.applyConfigurePostCss)(configurePostCss.bind(plugin), clientConfig);
         }
         if (configureWebpack) {
-            clientConfig = utils_1.applyConfigureWebpack(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
-            clientConfig, false, (_a = props.siteConfig.webpack) === null || _a === void 0 ? void 0 : _a.jsLoader);
-            serverConfig = utils_1.applyConfigureWebpack(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
-            serverConfig, true, (_b = props.siteConfig.webpack) === null || _b === void 0 ? void 0 : _b.jsLoader);
+            clientConfig = (0, utils_1.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
+            clientConfig, false, props.siteConfig.webpack?.jsLoader, plugin.content);
+            serverConfig = (0, utils_1.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
+            serverConfig, true, props.siteConfig.webpack?.jsLoader, plugin.content);
         }
     });
     // Make sure generated client-manifest is cleaned first so we don't reuse
@@ -140,11 +138,9 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         await fs_extra_1.default.unlink(clientManifestPath);
     }
     // Run webpack to build JS bundle (client) and static html files (server).
-    await utils_1.compile([clientConfig, serverConfig]);
+    await (0, utils_1.compile)([clientConfig, serverConfig]);
     // Remove server.bundle.js because it is not needed.
-    if (serverConfig.output &&
-        serverConfig.output.filename &&
-        typeof serverConfig.output.filename === 'string') {
+    if (typeof serverConfig.output?.filename === 'string') {
         const serverBundle = path_1.default.join(outDir, serverConfig.output.filename);
         if (await fs_extra_1.default.pathExists(serverBundle)) {
             await fs_extra_1.default.unlink(serverBundle);
@@ -155,18 +151,18 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         if (!plugin.postBuild) {
             return;
         }
-        await plugin.postBuild(props);
+        await plugin.postBuild({ ...props, content: plugin.content });
     }));
-    await brokenLinks_1.handleBrokenLinks({
+    await (0, brokenLinks_1.handleBrokenLinks)({
         allCollectedLinks,
         routes,
         onBrokenLinks,
         outDir,
         baseUrl,
     });
-    console.log(`${chalk_1.default.green(`Success!`)} Generated static files in ${chalk_1.default.cyan(path_1.default.relative(process.cwd(), outDir))}.`);
+    logger_1.default.success `Generated static files in path=${path_1.default.relative(process.cwd(), outDir)}.`;
     if (isLastLocale) {
-        console.log(`\nUse ${chalk_1.default.greenBright('`npm run serve`')} to test your build locally.\n`);
+        logger_1.default.info `Use code=${'npm run serve'} command to test your build locally.`;
     }
     if (forceTerminate && isLastLocale && !cliOptions.bundleAnalyzer) {
         process.exit(0);

package/lib/commands/clear.d.ts

@@ -1 +1,7 @@
+/**
+ * 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.
+ */
 export default function clear(siteDir: string): Promise<unknown>;

package/lib/commands/clear.js

@@ -1,32 +1,43 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
 /**
  * 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 });
+const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
-const chalk = require("chalk");
-const constants_1 = require("../constants");
-function removePath(fsPath) {
-    return fs_extra_1.default
-        .remove(path_1.default.join(fsPath))
-        .then(() => {
-        console.log(`${chalk.green(`Removing ${fsPath}`)}`);
-    })
-        .catch((err) => {
-        console.error(`Could not remove ${fsPath}`);
-        console.error(err);
-    });
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const utils_1 = require("@docusaurus/utils");
+async function removePath(entry) {
+    if (!(await fs_extra_1.default.pathExists(entry.path))) {
+        return;
+    }
+    try {
+        await fs_extra_1.default.remove(entry.path);
+        logger_1.default.success `Removed the ${entry.description} at path=${entry.path}.`;
+    }
+    catch (err) {
+        logger_1.default.error `Could not remove the ${entry.description} at path=${entry.path}.`;
+        logger_1.default.error(err);
+    }
 }
 async function clear(siteDir) {
-    return Promise.all([
-        removePath(path_1.default.join(siteDir, constants_1.GENERATED_FILES_DIR_NAME)),
-        removePath(path_1.default.join(siteDir, constants_1.DEFAULT_BUILD_DIR_NAME)),
-        removePath(path_1.default.join(siteDir, 'node_modules', '.cache')),
-    ]);
+    const generatedFolder = {
+        path: path_1.default.join(siteDir, utils_1.GENERATED_FILES_DIR_NAME),
+        description: 'generated folder',
+    };
+    const buildFolder = {
+        path: path_1.default.join(siteDir, utils_1.DEFAULT_BUILD_DIR_NAME),
+        description: 'build output folder',
+    };
+    // In Yarn PnP, cache is stored in `.yarn/.cache` because n_m doesn't exist
+    const cacheFolders = ['node_modules', '.yarn'].map((p) => ({
+        path: path_1.default.join(siteDir, p, '.cache'),
+        description: 'Webpack persistent cache folder',
+    }));
+    return Promise.all([generatedFolder, buildFolder, ...cacheFolders].map(removePath));
 }
 exports.default = clear;

package/lib/commands/commandUtils.d.ts

@@ -1,3 +1,9 @@
-import { HostPortCLIOptions } from '@docusaurus/types';
+/**
+ * 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 { HostPortCLIOptions } from '@docusaurus/types';
 export declare function getCLIOptionHost(hostOption: HostPortCLIOptions['host']): string;
 export declare function getCLIOptionPort(portOption: HostPortCLIOptions['port'], host: string): Promise<number | null>;

package/lib/commands/commandUtils.js

@@ -1,21 +1,21 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCLIOptionPort = exports.getCLIOptionHost = void 0;
-const tslib_1 = require("tslib");
 /**
  * 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.getCLIOptionPort = exports.getCLIOptionHost = void 0;
+const tslib_1 = require("tslib");
 const choosePort_1 = tslib_1.__importDefault(require("../choosePort"));
-const constants_1 = require("../constants");
+const utils_1 = require("@docusaurus/utils");
 function getCLIOptionHost(hostOption) {
-    return hostOption || 'localhost';
+    return hostOption ?? 'localhost';
 }
 exports.getCLIOptionHost = getCLIOptionHost;
 async function getCLIOptionPort(portOption, host) {
-    const basePort = portOption ? parseInt(portOption, 10) : constants_1.DEFAULT_PORT;
-    return choosePort_1.default(host, basePort);
+    const basePort = portOption ? parseInt(portOption, 10) : utils_1.DEFAULT_PORT;
+    return (0, choosePort_1.default)(host, basePort);
 }
 exports.getCLIOptionPort = getCLIOptionPort;

package/lib/commands/deploy.d.ts

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