@docusaurus/core 3.7.0-canary-6261 → 3.7.0-canary-6262

package/lib/commands/start/start.js

@@ -8,12 +8,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.start = start;
 const tslib_1 = require("tslib");
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const logger_1 = tslib_1.__importStar(require("@docusaurus/logger"));
 const openBrowser_1 = tslib_1.__importDefault(require("../utils/openBrowser/openBrowser"));
 const watcher_1 = require("./watcher");
 const webpack_1 = require("./webpack");
 const utils_1 = require("./utils");
-async function start(siteDirParam = '.', cliOptions = {}) {
+async function doStart(siteDirParam = '.', cliOptions = {}) {
     logger_1.default.info('Starting the development server...');
     // Temporary workaround to unlock the ability to translate the site config
     // We'll remove it if a better official API can be designed
@@ -44,3 +44,6 @@ async function start(siteDirParam = '.', cliOptions = {}) {
         await (0, openBrowser_1.default)(reloadableSite.getOpenUrl());
     }
 }
+async function start(siteDirParam = '.', cliOptions = {}) {
+    return logger_1.PerfLogger.async('CLI start', () => doStart(siteDirParam, cliOptions));
+}

package/lib/webpack/base.js

@@ -16,6 +16,7 @@ const babel_1 = require("@docusaurus/babel");
 const bundler_1 = require("@docusaurus/bundler");
 const utils_1 = require("@docusaurus/utils");
 const aliases_1 = require("./aliases");
+const BundlerCPUProfilerPlugin_1 = require("./plugins/BundlerCPUProfilerPlugin");
 const CSS_REGEX = /\.css$/i;
 const CSS_MODULE_REGEX = /\.module\.css$/i;
 exports.clientDir = path_1.default.join(__dirname, '..', 'client');
@@ -283,6 +284,8 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
                 // for more reasoning
                 ignoreOrder: true,
             }),
-        ],
+            process.env.DOCUSAURUS_BUNDLER_CPU_PROFILE &&
+                new BundlerCPUProfilerPlugin_1.BundlerCPUProfilerPlugin(),
+        ].filter(Boolean),
     };
 }

package/lib/webpack/plugins/BundlerCPUProfilerPlugin.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 { Compiler } from 'webpack';
+export declare class BundlerCPUProfilerPlugin {
+    output: string;
+    constructor(output?: string);
+    apply(compiler: Compiler): void;
+}

package/lib/webpack/plugins/BundlerCPUProfilerPlugin.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * 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.BundlerCPUProfilerPlugin = void 0;
+const tslib_1 = require("tslib");
+const node_inspector_1 = tslib_1.__importDefault(require("node:inspector"));
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+// Bundle CPU profiling plugin, contributed by the Rspack team
+// Can be opened in https://www.speedscope.app/
+// See also https://github.com/jerrykingxyz/docusaurus/pull/1
+// See also https://github.com/facebook/docusaurus/pull/10985
+class BundlerCPUProfilerPlugin {
+    constructor(output) {
+        this.output = output ?? './bundler-cpu-profile.json';
+    }
+    apply(compiler) {
+        const session = new node_inspector_1.default.Session();
+        session.connect();
+        session.post('Profiler.enable');
+        session.post('Profiler.start');
+        // In dev/watch mode, we restart the profiler before each compilation
+        compiler.hooks.watchRun.tapPromise(BundlerCPUProfilerPlugin.name, async () => {
+            session.post('Profiler.start');
+        });
+        compiler.hooks.done.tapPromise(BundlerCPUProfilerPlugin.name, async () => {
+            session.post('Profiler.stop', (error, param) => {
+                if (error) {
+                    console.error('Failed to generate JS CPU profile:', error);
+                    return;
+                }
+                fs_extra_1.default.writeFile(this.output, JSON.stringify(param.profile)).catch(console.error);
+            });
+        });
+    }
+}
+exports.BundlerCPUProfilerPlugin = BundlerCPUProfilerPlugin;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "3.7.0-canary-6261",
+  "version": "3.7.0-canary-6262",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,13 +33,13 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "3.7.0-canary-6261",
-    "@docusaurus/bundler": "3.7.0-canary-6261",
-    "@docusaurus/logger": "3.7.0-canary-6261",
-    "@docusaurus/mdx-loader": "3.7.0-canary-6261",
-    "@docusaurus/utils": "3.7.0-canary-6261",
-    "@docusaurus/utils-common": "3.7.0-canary-6261",
-    "@docusaurus/utils-validation": "3.7.0-canary-6261",
+    "@docusaurus/babel": "3.7.0-canary-6262",
+    "@docusaurus/bundler": "3.7.0-canary-6262",
+    "@docusaurus/logger": "3.7.0-canary-6262",
+    "@docusaurus/mdx-loader": "3.7.0-canary-6262",
+    "@docusaurus/utils": "3.7.0-canary-6262",
+    "@docusaurus/utils-common": "3.7.0-canary-6262",
+    "@docusaurus/utils-validation": "3.7.0-canary-6262",
     "boxen": "^6.2.1",
     "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
@@ -78,8 +78,8 @@
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.7.0-canary-6261",
-    "@docusaurus/types": "3.7.0-canary-6261",
+    "@docusaurus/module-type-aliases": "3.7.0-canary-6262",
+    "@docusaurus/types": "3.7.0-canary-6262",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^18.2.7",
@@ -99,5 +99,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "a93b982c4a8fd345bae11d2d896c5381af5af2b0"
+  "gitHead": "dece03f917b38ae183df551a66752d6d482d85a2"
 }