@docusaurus/core 0.0.0-5031 → 0.0.0-5034

package/bin/docusaurus.mjs

@@ -126,6 +126,10 @@ cli
     '--poll [interval]',
     'use polling rather than watching for reload (default: false). Can specify a poll interval in milliseconds',
   )
+  .option(
+    '--no-minify',
+    'build website without minimizing JS bundles (default: false)',
+  )
   .action(async (siteDir, options) =>
     start(await resolveDir(siteDir), options),
   );

package/lib/client/serverEntry.js

@@ -9,7 +9,7 @@ import path from 'path';
 import fs from 'fs-extra';
 // eslint-disable-next-line no-restricted-imports
 import _ from 'lodash';
-import logger from '@docusaurus/logger';
+import chalk from 'chalk';
 import * as eta from 'eta';
 import { StaticRouter } from 'react-router-dom';
 import ReactDOMServer from 'react-dom/server';
@@ -32,12 +32,17 @@ export default async function render(locals) {
         return await doRender(locals);
     }
     catch (err) {
-        logger.error `Docusaurus server-side rendering could not render static page with path path=${locals.path}.`;
+        // We are not using logger in this file, because it seems to fail with some
+        // compilers / some polyfill methods. This is very likely a bug, but in the
+        // long term, when we output native ES modules in SSR, the bug will be gone.
+        // prettier-ignore
+        console.error(chalk.red(`${chalk.bold('[ERROR]')} Docusaurus server-side rendering could not render static page with path ${chalk.cyan.underline(locals.path)}.`));
         const isNotDefinedErrorRegex = /(?:window|document|localStorage|navigator|alert|location|buffer|self) is not defined/i;
         if (isNotDefinedErrorRegex.test(err.message)) {
-            logger.info `It looks like you are using code that should run on the client-side only.
-To get around it, try using code=${'<BrowserOnly>'} (url=${'https://docusaurus.io/docs/docusaurus-core/#browseronly'}) or code=${'ExecutionEnvironment'} (url=${'https://docusaurus.io/docs/docusaurus-core/#executionenvironment'}).
-It might also require to wrap your client code in code=${'useEffect'} hook and/or import a third-party library dynamically (if any).`;
+            // prettier-ignore
+            console.info(`${chalk.cyan.bold('[INFO]')} It looks like you are using code that should run on the client-side only.
+To get around it, try using ${chalk.cyan('`<BrowserOnly>`')} (${chalk.cyan.underline('https://docusaurus.io/docs/docusaurus-core/#browseronly')}) or ${chalk.cyan('`ExecutionEnvironment`')} (${chalk.cyan.underline('https://docusaurus.io/docs/docusaurus-core/#executionenvironment')}).
+It might also require to wrap your client code in ${chalk.cyan('`useEffect`')} hook and/or import a third-party library dynamically (if any).`);
         }
         throw err;
     }
@@ -76,7 +81,12 @@ async function doRender(locals) {
     const metaAttributes = metaStrings.filter(Boolean);
     const { generatedFilesDir } = locals;
     const manifestPath = path.join(generatedFilesDir, 'client-manifest.json');
-    const manifest = await fs.readJSON(manifestPath);
+    // Using readJSON seems to fail for users of some plugins, possibly because of
+    // the eval sandbox having a different `Buffer` instance (native one instead
+    // of polyfilled one)
+    const manifest = await fs
+        .readFile(manifestPath, 'utf-8')
+        .then(JSON.parse);
     // Get all required assets for this particular page based on client
     // manifest information.
     const modulesToBeLoaded = [...manifest.entrypoints, ...Array.from(modules)];
@@ -110,7 +120,8 @@ async function doRender(locals) {
         });
     }
     catch (err) {
-        logger.error `Minification of page path=${locals.path} failed.`;
+        // prettier-ignore
+        console.error(chalk.red(`${chalk.bold('[ERROR]')} Minification of page ${chalk.cyan.underline(locals.path)} failed.`));
         throw err;
     }
 }

package/lib/commands/start.d.ts

@@ -10,5 +10,6 @@ export declare type StartCLIOptions = HostPortOptions & Pick<LoadContextOptions,
     hotOnly?: boolean;
     open?: boolean;
     poll?: boolean | number;
+    minify?: boolean;
 };
 export declare function start(siteDir: string, cliOptions: Partial<StartCLIOptions>): Promise<void>;

package/lib/commands/start.js

@@ -93,7 +93,7 @@ async function start(siteDir, cliOptions) {
         ...{ pollingOptions },
     });
     ['add', 'change', 'unlink', 'addDir', 'unlinkDir'].forEach((event) => fsWatcher.on(event, reload));
-    let config = (0, webpack_merge_1.default)(await (0, client_1.default)(props), {
+    let config = (0, webpack_merge_1.default)(await (0, client_1.default)(props, cliOptions.minify), {
         watchOptions: {
             ignored: /node_modules\/(?!@docusaurus)/,
             poll: cliOptions.poll,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-5031",
+  "version": "0.0.0-5034",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -24,10 +24,10 @@
     "docusaurus": "bin/docusaurus.mjs"
   },
   "scripts": {
-    "build": "tsc --build && node ../../admin/scripts/copyUntypedFiles.mjs",
+    "build": "tsc --build && node ../../admin/scripts/copyUntypedFiles.js",
     "watch": "run-p -c copy:watch build:watch",
     "build:watch": "tsc --build --watch",
-    "copy:watch": "node ../../admin/scripts/copyUntypedFiles.mjs --watch"
+    "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch"
   },
   "bugs": {
     "url": "https://github.com/facebook/docusaurus/issues"
@@ -43,19 +43,20 @@
     "@babel/runtime": "^7.17.9",
     "@babel/runtime-corejs3": "^7.17.9",
     "@babel/traverse": "^7.17.12",
-    "@docusaurus/cssnano-preset": "0.0.0-5031",
-    "@docusaurus/logger": "0.0.0-5031",
-    "@docusaurus/mdx-loader": "0.0.0-5031",
+    "@docusaurus/cssnano-preset": "0.0.0-5034",
+    "@docusaurus/logger": "0.0.0-5034",
+    "@docusaurus/mdx-loader": "0.0.0-5034",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-5031",
-    "@docusaurus/utils-common": "0.0.0-5031",
-    "@docusaurus/utils-validation": "0.0.0-5031",
+    "@docusaurus/utils": "0.0.0-5034",
+    "@docusaurus/utils-common": "0.0.0-5034",
+    "@docusaurus/utils-validation": "0.0.0-5034",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.4",
     "@svgr/webpack": "^6.2.1",
     "autoprefixer": "^10.4.7",
     "babel-loader": "^8.2.5",
     "babel-plugin-dynamic-import-node": "2.3.0",
     "boxen": "^6.2.1",
+    "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
     "clean-css": "^5.3.0",
     "cli-table3": "^0.6.2",
@@ -106,8 +107,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-5031",
-    "@docusaurus/types": "0.0.0-5031",
+    "@docusaurus/module-type-aliases": "0.0.0-5034",
+    "@docusaurus/types": "0.0.0-5034",
     "@types/detect-port": "^1.3.2",
     "@types/react-dom": "^18.0.4",
     "@types/react-router-config": "^5.0.6",
@@ -127,5 +128,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "e17d8d388d7e38014a01bf55e5eb113513e25a55"
+  "gitHead": "6c84b6fc46bf2e62af92b1b0c1e36391faec3b04"
 }