@docusaurus/core 0.0.0-5776 → 0.0.0-5781

package/bin/docusaurus.mjs

@@ -218,6 +218,9 @@ cli.arguments('<command>').action((cmd) => {
   logger.error`    Unknown command name=${cmd}.`;
 });
 
+// === The above is the commander configuration ===
+// They don't start any code execution yet until cli.parse() is called below
+
 /**
  * @param {string | undefined} command
  */
@@ -237,12 +240,29 @@ function isInternalCommand(command) {
   );
 }
 
-if (!isInternalCommand(process.argv.slice(2)[0])) {
-  await externalCommand(cli);
-}
+// process.argv always looks like this:
+// [
+//   '/path/to/node',
+//   '/path/to/docusaurus.mjs',
+//   '<subcommand>',
+//   ...subcommandArgs
+// ]
 
-if (!process.argv.slice(2).length) {
+// There is no subcommand
+// TODO: can we use commander to handle this case?
+if (process.argv.length < 3 || process.argv[2]?.startsWith('--')) {
   cli.outputHelp();
+  process.exit(1);
+}
+
+// There is an unrecognized subcommand
+// Let plugins extend the CLI before parsing
+if (!isInternalCommand(process.argv[2])) {
+  // TODO: in this step, we must assume default site structure because there's
+  // no way to know the siteDir/config yet. Maybe the root cli should be
+  // responsible for parsing these arguments?
+  // https://github.com/facebook/docusaurus/issues/8903
+  await externalCommand(cli);
 }
 
 cli.parse(process.argv);

package/lib/server/configValidation.d.ts

@@ -5,8 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { Joi } from '@docusaurus/utils-validation';
-import type { DocusaurusConfig, I18nConfig } from '@docusaurus/types';
+import type { DocusaurusConfig, I18nConfig, MarkdownConfig } from '@docusaurus/types';
 export declare const DEFAULT_I18N_CONFIG: I18nConfig;
+export declare const DEFAULT_MARKDOWN_CONFIG: MarkdownConfig;
 export declare const DEFAULT_CONFIG: Pick<DocusaurusConfig, 'i18n' | 'onBrokenLinks' | 'onBrokenMarkdownLinks' | 'onDuplicateRoutes' | 'plugins' | 'themes' | 'presets' | 'headTags' | 'stylesheets' | 'scripts' | 'clientModules' | 'customFields' | 'themeConfig' | 'titleDelimiter' | 'noIndex' | 'tagline' | 'baseUrlIssueBanner' | 'staticDirectories' | 'markdown'>;
 export declare const ConfigSchema: Joi.ObjectSchema<DocusaurusConfig>;
 export declare function validateConfig(config: unknown, siteConfigPath: string): DocusaurusConfig;

package/lib/server/configValidation.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateConfig = exports.ConfigSchema = exports.DEFAULT_CONFIG = exports.DEFAULT_I18N_CONFIG = void 0;
+exports.validateConfig = exports.ConfigSchema = exports.DEFAULT_CONFIG = exports.DEFAULT_MARKDOWN_CONFIG = exports.DEFAULT_I18N_CONFIG = void 0;
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const DEFAULT_I18N_LOCALE = 'en';
@@ -16,6 +16,17 @@ exports.DEFAULT_I18N_CONFIG = {
     locales: [DEFAULT_I18N_LOCALE],
     localeConfigs: {},
 };
+exports.DEFAULT_MARKDOWN_CONFIG = {
+    format: 'mdx',
+    mermaid: false,
+    preprocessor: undefined,
+    parseFrontMatter: utils_1.DEFAULT_PARSE_FRONT_MATTER,
+    mdx1Compat: {
+        comments: true,
+        admonitions: true,
+        headingIds: true,
+    },
+};
 exports.DEFAULT_CONFIG = {
     i18n: exports.DEFAULT_I18N_CONFIG,
     onBrokenLinks: 'throw',
@@ -35,16 +46,7 @@ exports.DEFAULT_CONFIG = {
     tagline: '',
     baseUrlIssueBanner: true,
     staticDirectories: [utils_1.DEFAULT_STATIC_DIR_NAME],
-    markdown: {
-        format: 'mdx',
-        mermaid: false,
-        preprocessor: undefined,
-        mdx1Compat: {
-            comments: true,
-            admonitions: true,
-            headingIds: true,
-        },
-    },
+    markdown: exports.DEFAULT_MARKDOWN_CONFIG,
 };
 function createPluginSchema(theme) {
     return (utils_validation_1.Joi.alternatives()
@@ -214,6 +216,7 @@ exports.ConfigSchema = utils_validation_1.Joi.object({
         format: utils_validation_1.Joi.string()
             .equal('mdx', 'md', 'detect')
             .default(exports.DEFAULT_CONFIG.markdown.format),
+        parseFrontMatter: utils_validation_1.Joi.function().default(() => exports.DEFAULT_CONFIG.markdown.parseFrontMatter),
         mermaid: utils_validation_1.Joi.boolean().default(exports.DEFAULT_CONFIG.markdown.mermaid),
         preprocessor: utils_validation_1.Joi.function()
             .arity(1)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-5776",
+  "version": "0.0.0-5781",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -43,13 +43,13 @@
     "@babel/runtime": "^7.22.6",
     "@babel/runtime-corejs3": "^7.22.6",
     "@babel/traverse": "^7.22.8",
-    "@docusaurus/cssnano-preset": "0.0.0-5776",
-    "@docusaurus/logger": "0.0.0-5776",
-    "@docusaurus/mdx-loader": "0.0.0-5776",
+    "@docusaurus/cssnano-preset": "0.0.0-5781",
+    "@docusaurus/logger": "0.0.0-5781",
+    "@docusaurus/mdx-loader": "0.0.0-5781",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-5776",
-    "@docusaurus/utils-common": "0.0.0-5776",
-    "@docusaurus/utils-validation": "0.0.0-5776",
+    "@docusaurus/utils": "0.0.0-5781",
+    "@docusaurus/utils-common": "0.0.0-5781",
+    "@docusaurus/utils-validation": "0.0.0-5781",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.7",
     "@svgr/webpack": "^6.5.1",
     "autoprefixer": "^10.4.14",
@@ -104,8 +104,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-5776",
-    "@docusaurus/types": "0.0.0-5776",
+    "@docusaurus/module-type-aliases": "0.0.0-5781",
+    "@docusaurus/types": "0.0.0-5781",
     "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^18.2.7",
     "@types/react-router-config": "^5.0.7",
@@ -124,5 +124,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "651d33bcb60ba72ed7455d217aaa290797b6d8fb"
+  "gitHead": "18240ff945c64b1e9efb1bb390b7ab748452c5ce"
 }