@docusaurus/core 3.6.0 → 3.6.1-canary-6143

package/lib/server/site.d.ts

@@ -22,7 +22,9 @@ export type LoadContextParams = {
      */
     localizePath?: boolean;
 };
-export type LoadSiteParams = LoadContextParams;
+export type LoadSiteParams = LoadContextParams & {
+    isReload?: boolean;
+};
 export type Site = {
     props: Props;
     params: LoadSiteParams;
@@ -40,6 +42,6 @@ export declare function loadContext(params: LoadContextParams): Promise<LoadCont
  * lifecycles to generate content and other data. It is side-effect-ful because
  * it generates temp files in the `.docusaurus` folder for the bundler.
  */
-export declare function loadSite(params: LoadContextParams): Promise<Site>;
+export declare function loadSite(params: LoadSiteParams): Promise<Site>;
 export declare function reloadSite(site: Site): Promise<Site>;
 export declare function reloadSitePlugin(site: Site, pluginIdentifier: PluginIdentifier): Promise<Site>;

package/lib/server/site.js

@@ -26,6 +26,7 @@ const translations_1 = require("./translations/translations");
 const codegen_1 = require("./codegen/codegen");
 const routes_1 = require("./routes");
 const storage_1 = require("./storage");
+const siteMessages_1 = require("./siteMessages");
 /**
  * Loading context is the very first step in site building. Its params are
  * directly acquired from CLI options. It mainly loads `siteConfig` and the i18n
@@ -147,13 +148,20 @@ async function loadSite(params) {
         site,
         globalData,
     });
+    // For now, we don't re-emit messages on site reloads, it's too verbose
+    if (!params.isReload) {
+        await (0, siteMessages_1.emitSiteMessages)({ site });
+    }
     return site;
 }
 async function reloadSite(site) {
     // TODO this can be optimized, for example:
     //  - plugins loading same data as before should not recreate routes/bundles
     //  - codegen does not need to re-run if nothing changed
-    return loadSite(site.params);
+    return loadSite({
+        ...site.params,
+        isReload: true,
+    });
 }
 async function reloadSitePlugin(site, pluginIdentifier) {
     const { plugins, routes, globalData } = await (0, plugins_1.reloadPlugin)({

package/lib/server/siteMessages.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 { Site } from './site';
+type Params = {
+    site: Site;
+};
+type SiteMessage = {
+    type: 'warning' | 'error';
+    message: string;
+};
+export declare function collectAllSiteMessages(params: Params): Promise<SiteMessage[]>;
+export declare function emitSiteMessages(params: Params): Promise<void>;
+export {};

package/lib/server/siteMessages.js

@@ -0,0 +1,49 @@
+"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.collectAllSiteMessages = collectAllSiteMessages;
+exports.emitSiteMessages = emitSiteMessages;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const babel_1 = require("@docusaurus/babel");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const uselessBabelConfigMessages = async ({ site }) => {
+    const { props: { siteDir, siteConfig }, } = site;
+    if (siteConfig.future.experimental_faster.swcJsLoader) {
+        const babelConfigFilePath = await (0, babel_1.getCustomBabelConfigFilePath)(siteDir);
+        if (babelConfigFilePath) {
+            return [
+                {
+                    type: 'warning',
+                    message: `Your site is using the SWC js loader. You can safely remove the Babel config file at ${logger_1.default.code(path_1.default.relative(process.cwd(), babelConfigFilePath))}.`,
+                },
+            ];
+        }
+    }
+    return [];
+};
+async function collectAllSiteMessages(params) {
+    const messageCreators = [uselessBabelConfigMessages];
+    return (await Promise.all(messageCreators.map((createMessages) => createMessages(params)))).flat();
+}
+function printSiteMessages(siteMessages) {
+    const [errors, warnings] = lodash_1.default.partition(siteMessages, (sm) => sm.type === 'error');
+    if (errors.length > 0) {
+        logger_1.default.error(`Docusaurus site errors:
+- ${errors.map((sm) => sm.message).join('\n- ')}`);
+    }
+    if (warnings.length > 0) {
+        logger_1.default.warn(`Docusaurus site warnings:
+- ${warnings.map((sm) => sm.message).join('\n- ')}`);
+    }
+}
+async function emitSiteMessages(params) {
+    const siteMessages = await collectAllSiteMessages(params);
+    printSiteMessages(siteMessages);
+}

package/lib/webpack/base.js

@@ -89,10 +89,24 @@ async function createBaseConfig({ props, isServer, minify, faster, configureWebp
             },
         };
     }
+    function getExperiments() {
+        if (props.currentBundler.name === 'rspack') {
+            return {
+                // This is mostly useful in dev
+                // See https://rspack.dev/config/experiments#experimentsincremental
+                // Produces warnings in production builds
+                // See https://github.com/web-infra-dev/rspack/pull/8311#issuecomment-2476014664
+                // @ts-expect-error: Rspack-only
+                incremental: !isProd,
+            };
+        }
+        return undefined;
+    }
     return {
         mode,
         name,
         cache: getCache(),
+        experiments: getExperiments(),
         output: {
             pathinfo: false,
             path: outDir,

package/lib/webpack/plugins/StaticDirectoriesCopyPlugin.js

@@ -36,6 +36,12 @@ async function createStaticDirectoriesCopyPlugin({ props, }) {
             from: dir,
             to: outDir,
             toType: 'dir',
+            info: {
+                // Prevents Webpack from minimizing static files (js/css)
+                // see https://github.com/facebook/docusaurus/pull/10658
+                // see https://github.com/webpack-contrib/copy-webpack-plugin#skip-running-javascript-files-through-a-minimizer
+                minimized: true,
+            },
         })),
     });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "3.6.0",
+  "version": "3.6.1-canary-6143",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,13 +33,13 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "3.6.0",
-    "@docusaurus/bundler": "3.6.0",
-    "@docusaurus/logger": "3.6.0",
-    "@docusaurus/mdx-loader": "3.6.0",
-    "@docusaurus/utils": "3.6.0",
-    "@docusaurus/utils-common": "3.6.0",
-    "@docusaurus/utils-validation": "3.6.0",
+    "@docusaurus/babel": "3.6.1-canary-6143",
+    "@docusaurus/bundler": "3.6.1-canary-6143",
+    "@docusaurus/logger": "3.6.1-canary-6143",
+    "@docusaurus/mdx-loader": "3.6.1-canary-6143",
+    "@docusaurus/utils": "3.6.1-canary-6143",
+    "@docusaurus/utils-common": "3.6.1-canary-6143",
+    "@docusaurus/utils-validation": "3.6.1-canary-6143",
     "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.6.0",
-    "@docusaurus/types": "3.6.0",
+    "@docusaurus/module-type-aliases": "3.6.1-canary-6143",
+    "@docusaurus/types": "3.6.1-canary-6143",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^18.2.7",
@@ -100,5 +100,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "05bba6d4f495ef6b0bec5d41453932bb97981830"
+  "gitHead": "c1af1828b1f2aa5e90702eb927d0b5de0918abd7"
 }