@docusaurus/core 0.0.0-4917 → 0.0.0-4923

package/bin/docusaurus.mjs

@@ -54,14 +54,8 @@ cli
     '--no-minify',
     'build website without minimizing JS bundles (default: false)',
   )
-  .action(async (siteDir, {bundleAnalyzer, config, outDir, locale, minify}) => {
-    build(await resolveDir(siteDir), {
-      bundleAnalyzer,
-      outDir,
-      config,
-      locale,
-      minify,
-    });
+  .action(async (siteDir, options) => {
+    build(await resolveDir(siteDir), options);
   });
 
 cli
@@ -86,9 +80,9 @@ cli
     'copy TypeScript theme files when possible (default: false)',
   )
   .option('--danger', 'enable swizzle for unsafe component of themes')
-  .action(async (themeName, componentName, siteDir, options) => {
-    swizzle(await resolveDir(siteDir), themeName, componentName, options);
-  });
+  .action(async (themeName, componentName, siteDir, options) =>
+    swizzle(await resolveDir(siteDir), themeName, componentName, options),
+  );
 
 cli
   .command('deploy [siteDir]')
@@ -109,13 +103,9 @@ cli
     '--skip-build',
     'skip building website before deploy it (default: false)',
   )
-  .action(async (siteDir, {outDir, skipBuild, config}) => {
-    deploy(await resolveDir(siteDir), {
-      outDir,
-      config,
-      skipBuild,
-    });
-  });
+  .action(async (siteDir, options) =>
+    deploy(await resolveDir(siteDir), options),
+  );
 
 cli
   .command('start [siteDir]')
@@ -136,18 +126,8 @@ cli
     '--poll [interval]',
     'use polling rather than watching for reload (default: false). Can specify a poll interval in milliseconds',
   )
-  .action(
-    async (siteDir, {port, host, locale, config, hotOnly, open, poll}) => {
-      start(await resolveDir(siteDir), {
-        port,
-        host,
-        locale,
-        config,
-        hotOnly,
-        open,
-        poll,
-      });
-    },
+  .action(async (siteDir, options) =>
+    start(await resolveDir(siteDir), options),
   );
 
 cli
@@ -164,44 +144,25 @@ cli
   .option('-p, --port <port>', 'use specified port (default: 3000)')
   .option('--build', 'build website before serving (default: false)')
   .option('-h, --host <host>', 'use specified host (default: localhost)')
-  .action(
-    async (
-      siteDir,
-      {
-        dir = 'build',
-        port = 3000,
-        host = 'localhost',
-        build: buildSite = false,
-        config,
-      },
-    ) => {
-      serve(await resolveDir(siteDir), {
-        dir,
-        port,
-        build: buildSite,
-        config,
-        host,
-      });
-    },
+  .action(async (siteDir, options) =>
+    serve(await resolveDir(siteDir), options),
   );
 
 cli
   .command('clear [siteDir]')
   .description('Remove build artifacts.')
-  .action(async (siteDir) => {
-    clear(await resolveDir(siteDir));
-  });
+  .action(async (siteDir) => clear(await resolveDir(siteDir)));
 
 cli
   .command('write-translations [siteDir]')
   .description('Extract required translations of your site.')
   .option(
     '-l, --locale <locale>',
-    'the locale folder to write the translations\n"--locale fr" will write translations in ./i18n/fr folder)',
+    'the locale folder to write the translations.\n"--locale fr" will write translations in the ./i18n/fr folder.',
   )
   .option(
     '--override',
-    'by default, we only append missing translation messages to existing translation files. This option allows to override existing translation messages. Make sure to commit or backup your existing translations, as they may be overridden',
+    'By default, we only append missing translation messages to existing translation files. This option allows to override existing translation messages. Make sure to commit or backup your existing translations, as they may be overridden. (default: false)',
   )
   .option(
     '--config <config>',
@@ -209,20 +170,10 @@ cli
   )
   .option(
     '--messagePrefix <messagePrefix>',
-    'allows to init new written messages with a given prefix. This might help you to highlight untranslated message to make them stand out in the UI',
+    'Allows to init new written messages with a given prefix. This might help you to highlight untranslated message by making them stand out in the UI (default: "")',
   )
-  .action(
-    async (
-      siteDir,
-      {locale = undefined, override = false, messagePrefix = '', config},
-    ) => {
-      writeTranslations(await resolveDir(siteDir), {
-        locale,
-        override,
-        config,
-        messagePrefix,
-      });
-    },
+  .action(async (siteDir, options) =>
+    writeTranslations(await resolveDir(siteDir), options),
   );
 
 cli

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 declare 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

@@ -23,7 +23,7 @@ const utils_1 = require("../webpack/utils");
 const CleanWebpackPlugin_1 = tslib_1.__importDefault(require("../webpack/plugins/CleanWebpackPlugin"));
 const i18n_1 = require("../server/i18n");
 const utils_2 = require("@docusaurus/utils");
-async function build(siteDir, cliOptions = {}, 
+async function build(siteDir, cliOptions, 
 // 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.

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 declare function clear(siteDir: string): Promise<unknown>;
+export declare function clear(siteDir: string): Promise<void>;

package/lib/commands/clear.js

@@ -39,6 +39,6 @@ async function clear(siteDir) {
         path: path_1.default.join(siteDir, p, '.cache'),
         description: 'Webpack persistent cache folder',
     }));
-    return Promise.all([generatedFolder, buildFolder, ...cacheFolders].map(removePath));
+    await Promise.all([generatedFolder, buildFolder, ...cacheFolders].map(removePath));
 }
 exports.clear = clear;

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 declare 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

@@ -34,7 +34,7 @@ function shellExecLog(cmd) {
         throw err;
     }
 }
-async function deploy(siteDir, cliOptions = {}) {
+async function deploy(siteDir, cliOptions) {
     const { outDir, siteConfig, siteConfigPath } = await (0, server_1.loadContext)({
         siteDir,
         customConfigFilePath: cliOptions.config,

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 declare function serve(siteDir: string, cliOptions: ServeCLIOptions): Promise<void>;
+export declare function serve(siteDir: string, cliOptions: Partial<ServeCLIOptions>): Promise<void>;

package/lib/commands/serve.js

@@ -15,8 +15,10 @@ const path_1 = tslib_1.__importDefault(require("path"));
 const config_1 = require("../server/config");
 const build_1 = require("./build");
 const commandUtils_1 = require("./commandUtils");
+const utils_1 = require("@docusaurus/utils");
 async function serve(siteDir, cliOptions) {
-    let dir = path_1.default.resolve(siteDir, cliOptions.dir);
+    const buildDir = cliOptions.dir ?? utils_1.DEFAULT_BUILD_DIR_NAME;
+    let dir = path_1.default.resolve(siteDir, buildDir);
     if (cliOptions.build) {
         dir = await (0, build_1.build)(siteDir, {
             config: cliOptions.config,
@@ -52,7 +54,7 @@ async function serve(siteDir, cliOptions) {
             directoryListing: false,
         });
     });
-    logger_1.default.success `Serving path=${cliOptions.dir} directory at url=${servingUrl + baseUrl}.`;
+    logger_1.default.success `Serving path=${buildDir} directory at url=${servingUrl + baseUrl}.`;
     server.listen(port);
 }
 exports.serve = serve;

package/lib/commands/start.js

@@ -95,6 +95,10 @@ async function start(siteDir, cliOptions) {
     });
     ['add', 'change', 'unlink', 'addDir', 'unlinkDir'].forEach((event) => fsWatcher.on(event, reload));
     let config = (0, webpack_merge_1.default)(await (0, client_1.default)(props), {
+        watchOptions: {
+            ignored: /node_modules\/(?!@docusaurus)/,
+            poll: cliOptions.poll,
+        },
         infrastructureLogging: {
             // Reduce log verbosity, see https://github.com/facebook/docusaurus/pull/5420#issuecomment-906613105
             level: 'warn',

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 declare 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/writeTranslations.d.ts

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-4917",
+  "version": "0.0.0-4923",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -41,13 +41,13 @@
     "@babel/runtime": "^7.17.9",
     "@babel/runtime-corejs3": "^7.17.9",
     "@babel/traverse": "^7.17.9",
-    "@docusaurus/cssnano-preset": "0.0.0-4917",
-    "@docusaurus/logger": "0.0.0-4917",
-    "@docusaurus/mdx-loader": "0.0.0-4917",
+    "@docusaurus/cssnano-preset": "0.0.0-4923",
+    "@docusaurus/logger": "0.0.0-4923",
+    "@docusaurus/mdx-loader": "0.0.0-4923",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-4917",
-    "@docusaurus/utils-common": "0.0.0-4917",
-    "@docusaurus/utils-validation": "0.0.0-4917",
+    "@docusaurus/utils": "0.0.0-4923",
+    "@docusaurus/utils-common": "0.0.0-4923",
+    "@docusaurus/utils-validation": "0.0.0-4923",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.4",
     "@svgr/webpack": "^6.2.1",
     "autoprefixer": "^10.4.4",
@@ -105,8 +105,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-4917",
-    "@docusaurus/types": "0.0.0-4917",
+    "@docusaurus/module-type-aliases": "0.0.0-4923",
+    "@docusaurus/types": "0.0.0-4923",
     "@types/detect-port": "^1.3.2",
     "@types/nprogress": "^0.2.0",
     "@types/react-dom": "^18.0.2",
@@ -127,5 +127,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "8a94c90547096df5a45a0de6c3f162475f2006b4"
+  "gitHead": "0d7f61e267384e2c272cc3c0df059bdfe16609fd"
 }