dumi 2.2.1-alpha.0 → 2.2.2

package/dist/client/theme-api/utils.js

@@ -1,103 +1,97 @@
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
-
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
-function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
-
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-
 import { useAppData, useIntl, useSiteData } from 'dumi';
 import { useCallback, useEffect, useLayoutEffect, useState } from 'react';
 import { useLocale } from "./useLocale";
+
+/**
+ * private instance, do not use it in your code
+ */
+export var pluginManager;
+export var setPluginManager = function setPluginManager(pm) {
+  pluginManager = pm;
+};
 export var useLocaleDocRoutes = function useLocaleDocRoutes() {
   var intl = useIntl();
-
   var _useAppData = useAppData(),
-      routes = _useAppData.routes;
-
+    routes = _useAppData.routes;
   var _useSiteData = useSiteData(),
-      locales = _useSiteData.locales;
-
+    locales = _useSiteData.locales;
   var _useState = useState(function () {
-    var reversedLocales = locales.slice().reverse();
-    return Object.values(routes).reduce(function (ret, route) {
-      var matched = reversedLocales.find(function (locale) {
-        return 'suffix' in locale ? // suffix mode
-        route.path.endsWith(locale.suffix) : // base mode
-        route.path.startsWith(locale.base.slice(1));
-      });
-
-      if (route.parentId === 'DocLayout' && matched.id === intl.locale) {
-        ret[route.id] = route;
-      }
-
-      return ret;
-    }, {});
-  }),
-      _useState2 = _slicedToArray(_useState, 1),
-      localeDocRoutes = _useState2[0];
-
+      var reversedLocales = locales.slice().reverse();
+      return Object.values(routes).reduce(function (ret, route) {
+        var matched = reversedLocales.find(function (locale) {
+          return 'suffix' in locale ?
+          // suffix mode
+          route.path.endsWith(locale.suffix) :
+          // base mode
+          route.path.startsWith(locale.base.slice(1));
+        });
+        if (route.parentId === 'DocLayout' && matched.id === intl.locale) {
+          ret[route.id] = route;
+        }
+        return ret;
+      }, {});
+    }),
+    _useState2 = _slicedToArray(_useState, 1),
+    localeDocRoutes = _useState2[0];
   return localeDocRoutes;
 };
+
 /**
  * 在 react 18 中需要新的 render 方式，这个函数用来处理不同的 jsx 模式。
  * @param version react version
  * @returns code string
  */
-
 export var genReactRenderCode = function genReactRenderCode(version) {
   var annotation = "/**\n * This is an auto-generated demo by dumi\n * if you think it is not working as expected,\n * please report the issue at\n * https://github.com/umijs/dumi/issues\n */";
-
   if (version.startsWith('18.') || version === 'latest') {
     return "".concat(annotation, "\n\nimport React from 'react';\nimport { createRoot } from \"react-dom/client\";\nimport App from \"./App\";\n\nconst rootElement = document.getElementById(\"root\");\nconst root = createRoot(rootElement);\n\nroot.render(<App />);");
   }
-
   return "".concat(annotation, "\n\nimport React from 'react';\nimport ReactDOM from 'react-dom';\nimport App from './App';\n\nReactDOM.render(\n  <App />,\n  document.getElementById('root'),\n);");
 };
 export var useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
+
 /**
  * common comparer for sidebar/nav items
  */
-
 export var useRouteDataComparer = function useRouteDataComparer() {
   var locale = useLocale();
   return useCallback(function (a, b) {
-    return (// smaller before larger for all
-      ('order' in a && 'order' in b ? a.order - b.order : 0) || ( // shallower before deeper for sidebar item
-      'link' in a && 'link' in b ? a.link.split('/').length - b.link.split('/').length : 0) || ( // shallower before deeper for sidebar leaf
-      'path' in a && 'path' in b ? a.path.split('/').length - b.path.split('/').length : 0) || ( // fallback to compare title (put non-title item at the end)
+    return (
+      // smaller before larger for all
+      ('order' in a && 'order' in b ? a.order - b.order : 0) || (
+      // shallower before deeper for sidebar item
+      'link' in a && 'link' in b ? a.link.split('/').length - b.link.split('/').length : 0) || (
+      // shallower before deeper for sidebar leaf
+      'path' in a && 'path' in b ? a.path.split('/').length - b.path.split('/').length : 0) || (
+      // fallback to compare title (put non-title item at the end)
       a.title ? a.title.localeCompare(b.title || '', locale.id) : -1)
     );
   }, []);
 };
+
 /**
  * common util for pick meta to sort sidebar/nav items
  */
-
 export var pickRouteSortMeta = function pickRouteSortMeta(original, field, fm) {
   var _sub$order;
-
   var sub = field === 'nav.second' ? _typeof(fm.nav) === 'object' ? fm.nav.second : {} : fm[field];
-
   switch (_typeof(sub)) {
     case 'object':
       original.title = sub.title || original.title;
       original.order = (_sub$order = sub.order) !== null && _sub$order !== void 0 ? _sub$order : original.order;
       break;
-
     case 'string':
       original.title = sub || original.title;
       break;
-
     default:
   }
-
   return original;
 };
 export function getLocaleNav(nav, locale) {

package/dist/client/typings.d.ts

@@ -1,8 +1,3 @@
-declare module '*.less' {
-  const classes: CSSModuleClasses;
-  export default classes;
-}
-
 declare module '*.svg' {
   import * as React from 'react';
   export const ReactComponent: React.FunctionComponent<

package/dist/constants.d.ts

@@ -16,3 +16,4 @@ export declare const PICKED_PKG_FIELDS: {
 };
 export declare const USELESS_TMP_FILES: string[];
 export declare const VERSION_2_LEVEL_NAV = "^2.2.0";
+export declare const VERSION_2_DEPRECATE_SOFT_BREAKS = "^2.2.0";

package/dist/constants.js

@@ -28,6 +28,7 @@ __export(constants_exports, {
   SP_ROUTE_PREFIX: () => SP_ROUTE_PREFIX,
   THEME_PREFIX: () => THEME_PREFIX,
   USELESS_TMP_FILES: () => USELESS_TMP_FILES,
+  VERSION_2_DEPRECATE_SOFT_BREAKS: () => VERSION_2_DEPRECATE_SOFT_BREAKS,
   VERSION_2_LEVEL_NAV: () => VERSION_2_LEVEL_NAV
 });
 module.exports = __toCommonJS(constants_exports);
@@ -49,6 +50,7 @@ var PICKED_PKG_FIELDS = {
 };
 var USELESS_TMP_FILES = ["tsconfig.json", "typings.d.ts"];
 var VERSION_2_LEVEL_NAV = "^2.2.0";
+var VERSION_2_DEPRECATE_SOFT_BREAKS = "^2.2.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LOCAL_DUMI_DIR,
@@ -60,5 +62,6 @@ var VERSION_2_LEVEL_NAV = "^2.2.0";
   SP_ROUTE_PREFIX,
   THEME_PREFIX,
   USELESS_TMP_FILES,
+  VERSION_2_DEPRECATE_SOFT_BREAKS,
   VERSION_2_LEVEL_NAV
 });

package/dist/features/assets.js

@@ -16,7 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/features/assets.ts
@@ -65,7 +72,10 @@ var assets_default = (api) => {
     name: "getAssetsMetadata",
     async fn() {
       await compileDeferrer;
-      const { components } = api.service.atomParser ? await api.service.atomParser.parse() : { components: {} };
+      const { components } = api.service.atomParser ? await api.service.atomParser.parse() : (
+        // allow generate assets.json without atoms when parser is not available
+        { components: {} }
+      );
       return await api.applyPlugins({
         key: "modifyAssetsMetadata",
         initialValue: {
@@ -77,7 +87,12 @@ var assets_default = (api) => {
           homepage: api.pkg.homepage,
           repository: api.pkg.repository,
           assets: {
-            atoms: Object.values(components).map((atom) => Object.assign(atom, atomsMeta[atom.id] || {})),
+            atoms: Object.values(components).map(
+              (atom) => (
+                // assign extra meta data from md frontmatter
+                Object.assign(atom, atomsMeta[atom.id] || {})
+              )
+            ),
             examples: import_plugin_utils.lodash.uniqBy(examples, "id")
           }
         }
@@ -86,7 +101,11 @@ var assets_default = (api) => {
   });
   api.onBuildComplete(async () => {
     const assets = await api.getAssetsMetadata();
-    import_fs.default.writeFileSync(import_path.default.join(api.cwd, "assets.json"), JSON.stringify(assets, null, 2), "utf-8");
+    import_fs.default.writeFileSync(
+      import_path.default.join(api.cwd, "assets.json"),
+      JSON.stringify(assets, null, 2),
+      "utf-8"
+    );
   });
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/features/autoAlias.js

@@ -16,7 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/features/autoAlias.ts
@@ -65,5 +72,3 @@ var autoAlias_default = (api) => {
     return memo;
   });
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});

package/dist/features/compile/babelLoaderCustomize.js

@@ -33,5 +33,3 @@ function babelLoaderCustomize() {
     }
   };
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});

package/dist/features/compile/index.js

@@ -16,7 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/features/compile/index.ts
@@ -36,7 +43,9 @@ var compile_default = (api) => {
   });
   api.modifyConfig((memo) => {
     if (memo.babelLoaderCustomize) {
-      api.logger.warn("Config `babelLoaderCustomize` will be override by dumi, please report issue if you need it.");
+      api.logger.warn(
+        "Config `babelLoaderCustomize` will be override by dumi, please report issue if you need it."
+      );
     }
     memo.babelLoaderCustomize = require.resolve("./babelLoaderCustomize");
     return memo;
@@ -55,17 +64,22 @@ var compile_default = (api) => {
       resolve: api.config.resolve,
       extraRemarkPlugins: api.config.extraRemarkPlugins,
       extraRehypePlugins: api.config.extraRehypePlugins,
-      routes: api.appData.routes
+      routes: api.appData.routes,
+      locales: api.config.locales,
+      pkg: api.pkg
     };
     memo.module.rule("dumi-md").type("javascript/auto").test(/\.md$/).oneOf("md-meta").resourceQuery(/meta$/).use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-meta-loader").loader(loaderPath).options({
       ...loaderBaseOpts,
       mode: "meta",
       onResolveDemos(demos) {
-        const assets = demos.reduce((ret, demo) => {
-          if ("asset" in demo)
-            ret.push(demo.asset);
-          return ret;
-        }, []);
+        const assets = demos.reduce(
+          (ret, demo) => {
+            if ("asset" in demo)
+              ret.push(demo.asset);
+            return ret;
+          },
+          []
+        );
         (0, import_assets.addExampleAssets)(assets);
       },
       onResolveAtomMeta: import_assets.addAtomMeta
@@ -87,5 +101,3 @@ var compile_default = (api) => {
     return memo;
   });
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});

package/dist/features/configPlugins/index.js

@@ -32,9 +32,10 @@ var configPlugins_default = (api) => {
       forceKebabCaseRouting: true
     },
     themeConfig: {
-      footer: `Copyright \xA9 ${new Date().getFullYear()} | Powered by <a href="https://d.umijs.org" target="_blank" rel="noreferrer">dumi</a>`,
+      footer: `Copyright © ${(/* @__PURE__ */ new Date()).getFullYear()} | Powered by <a href="https://d.umijs.org" target="_blank" rel="noreferrer">dumi</a>`,
       prefersColor: { default: "light", switch: true },
-      nprogress: true
+      nprogress: true,
+      lastUpdated: true
     }
   };
   const schemas = (0, import_schema.getSchemas)();
@@ -54,5 +55,3 @@ var configPlugins_default = (api) => {
     ]);
   }
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});

package/dist/features/configPlugins/schema.d.ts

@@ -1,4 +1,4 @@
 import type { IApi } from 'umi';
-declare type JoiRoot = Parameters<NonNullable<NonNullable<Parameters<IApi['describe']>[0]['config']>['schema']>>[0];
+type JoiRoot = Parameters<NonNullable<NonNullable<Parameters<IApi['describe']>[0]['config']>['schema']>>[0];
 export declare function getSchemas(): Record<string, (Joi: JoiRoot) => any>;
 export {};

package/dist/features/configPlugins/schema.js

@@ -23,13 +23,30 @@ __export(schema_exports, {
 });
 module.exports = __toCommonJS(schema_exports);
 function getUnifiedPluginSchema(Joi) {
-  return Joi.array().items(Joi.alternatives(Joi.string(), Joi.func(), Joi.array().items(Joi.alternatives(Joi.string(), Joi.func()), Joi.object()).length(2))).optional();
+  return Joi.array().items(
+    Joi.alternatives(
+      Joi.string(),
+      Joi.func(),
+      Joi.array().items(Joi.alternatives(Joi.string(), Joi.func()), Joi.object()).length(2)
+    )
+  ).optional();
 }
 function getSchemas() {
   return {
     resolve: (Joi) => Joi.object({
-      docDirs: Joi.array().items(Joi.alternatives(Joi.string(), Joi.object({ dir: Joi.string(), type: Joi.string().optional() }))).optional(),
-      atomDirs: Joi.array().items(Joi.object({ type: Joi.string(), dir: Joi.string() })).optional(),
+      docDirs: Joi.array().items(
+        Joi.alternatives(
+          Joi.string(),
+          Joi.object({ dir: Joi.string(), type: Joi.string().optional() })
+        )
+      ).optional(),
+      atomDirs: Joi.array().items(
+        Joi.object({
+          type: Joi.string(),
+          subType: Joi.string().optional(),
+          dir: Joi.string()
+        })
+      ).optional(),
       codeBlockMode: Joi.string().valid("active", "passive").optional(),
       entryFile: Joi.string().optional(),
       forceKebabCaseRouting: Joi.bool().optional()

package/dist/features/derivative.js

@@ -16,7 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/features/derivative.ts
@@ -32,7 +39,13 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_plugin_utils = require("umi/plugin-utils");
 function isMFSUAvailable(api) {
-  return process.platform !== "win32" && api.userConfig.mfsu !== false && api.pkg.type !== "module";
+  return (
+    // maybe not working on windows
+    process.platform !== "win32" && // allow user to disable mfsu
+    api.userConfig.mfsu !== false && // mfsu will interrupt 2-level esm for strip-ansi with unknown reason
+    // ref: https://github.com/umijs/dumi/issues/1587
+    api.pkg.type !== "module"
+  );
 }
 function safeExcludeInMFSU(api, excludes) {
   if (isMFSUAvailable(api)) {
@@ -68,38 +81,63 @@ var derivative_default = (api) => {
       (0, import_assert.default)(!api.config[key], `${key} is not supported yet!`);
     });
     if (typeof api.config.mfsu === "object") {
-      (0, import_assert.default)(api.config.mfsu.strategy !== "eager", "MFSU eager mode is not supported yet!");
-      (0, import_assert.default)(api.config.mfsu.esbuild !== true, "MFSU esbuild bundler is not supported yet!");
+      (0, import_assert.default)(
+        api.config.mfsu.strategy !== "eager",
+        "MFSU eager mode is not supported yet!"
+      );
+      (0, import_assert.default)(
+        api.config.mfsu.esbuild !== true,
+        "MFSU esbuild bundler is not supported yet!"
+      );
     }
-    (0, import_assert.default)(!api.config.ssr || api.config.ssr.builder === "webpack", "Only `webpack` builder is supported in SSR mode!");
-    (0, import_assert.default)(((_a = api.config.cssLoader) == null ? void 0 : _a.modules) === void 0 && api.config.cssLoaderModules === void 0, "CSS Modules is not supported! Because it is not suitable for UI library development, please use normal CSS, Less, etc. instead.");
+    (0, import_assert.default)(
+      !api.config.ssr || api.config.ssr.builder === "webpack",
+      "Only `webpack` builder is supported in SSR mode!"
+    );
+    (0, import_assert.default)(
+      ((_a = api.config.cssLoader) == null ? void 0 : _a.modules) === void 0 && api.config.cssLoaderModules === void 0,
+      "CSS Modules is not supported! Because it is not suitable for UI library development, please use normal CSS, Less, etc. instead."
+    );
     if (api.userConfig.history && api.userConfig.history.type === "hash") {
-      import_plugin_utils.logger.warn("Hash history is temporarily incompatible, it is recommended to use browser history for now.");
+      import_plugin_utils.logger.warn(
+        "Hash history is temporarily incompatible, it is recommended to use browser history for now."
+      );
     }
     const { themeConfig } = api.config;
     if (themeConfig == null ? void 0 : themeConfig.nav) {
       const hasOrder = !!JSON.stringify(themeConfig.nav).includes('"order":');
       if (hasOrder) {
-        import_plugin_utils.logger.warn(`\`order\` is deprecated in \`themeConfig.nav\`, you can order them directly in config`);
+        import_plugin_utils.logger.warn(
+          `\`order\` is deprecated in \`themeConfig.nav\`, you can order them directly in config`
+        );
       }
     }
     try {
       const tsconfig = require(import_path.default.join(api.cwd, "tsconfig.json"));
       const expected = [".dumi/**/*"];
       if ((_c = (_b = api.service.configManager) == null ? void 0 : _b.mainConfigFile) == null ? void 0 : _c.endsWith(".ts")) {
-        expected.push((0, import_plugin_utils.winPath)(import_path.default.relative(api.cwd, api.service.configManager.mainConfigFile)));
+        expected.push(
+          (0, import_plugin_utils.winPath)(
+            import_path.default.relative(api.cwd, api.service.configManager.mainConfigFile)
+          )
+        );
       }
       if (!expected.every((f) => {
         var _a2;
         return (_a2 = tsconfig.include) == null ? void 0 : _a2.includes(f);
       })) {
-        import_plugin_utils.logger.warn(`Please append ${expected.map((e) => `\`${e}\``).join(" & ")} into \`include\` option of \`tsconfig.json\`, to make sure the types exported by framework works.`);
+        import_plugin_utils.logger.warn(
+          `Please append ${expected.map((e) => `\`${e}\``).join(
+            " & "
+          )} into \`include\` option of \`tsconfig.json\`, to make sure the types exported by framework works.`
+        );
       }
     } catch {
     }
   });
   safeExcludeInMFSU(api, [
     new RegExp("dumi/dist/client"),
+    // for useSiteSearch api
     new RegExp("compiled/_internal/searchWorker")
   ]);
   api.modifyDefaultConfig((memo) => {
@@ -131,7 +169,9 @@ var derivative_default = (api) => {
     if ((_a = api.userConfig.alias) == null ? void 0 : _a["@"]) {
       memo.alias["@"] = api.userConfig.alias["@"];
     } else {
-      memo.alias["@"] = (0, import_plugin_utils.winPath)([import_path.default.join(api.cwd, "src"), api.cwd].find(import_fs.default.existsSync));
+      memo.alias["@"] = (0, import_plugin_utils.winPath)(
+        [import_path.default.join(api.cwd, "src"), api.cwd].find(import_fs.default.existsSync)
+      );
     }
     return memo;
   });
@@ -141,6 +181,7 @@ var derivative_default = (api) => {
   });
   api.register({
     key: "onGenerateFiles",
+    // make sure after umi generate files
     stage: Infinity,
     fn() {
       import_constants.USELESS_TMP_FILES.forEach((file) => {
@@ -150,7 +191,9 @@ var derivative_default = (api) => {
   });
   api.registerPlugins([require.resolve("../../compiled/@umijs/plugins")]);
   [
+    // skip prepare plugin since umi@4.0.48, because it is not compatible with dumi currently
     "prepare",
+    // skip routeProps plugin since umi@4.0.53, because dumi support conventional route props by default
     "routeProps"
   ].forEach((plugin) => {
     if (api.isPluginEnable(plugin))

package/dist/features/exportStatic.js

@@ -25,6 +25,8 @@ module.exports = __toCommonJS(exportStatic_exports);
 var import_constants = require("../constants");
 var import_assets = require("./assets");
 var NO_PRERENDER_ROUTES = [
+  // disable prerender for demo render page, because umi-hd doesn't support ssr
+  // ref: https://github.com/umijs/dumi/pull/1451
   "demo-render"
 ];
 var exportStatic_default = (api) => {
@@ -33,6 +35,7 @@ var exportStatic_default = (api) => {
     enableBy: ({ env }) => env === "production" && api.isPluginEnable("exportStatic")
   });
   api.modifyRoutes({
+    // make sure be the last
     stage: Infinity,
     fn(memo) {
       NO_PRERENDER_ROUTES.forEach((id) => {
@@ -43,15 +46,18 @@ var exportStatic_default = (api) => {
     }
   });
   api.modifyExportHTMLFiles({
+    // make sure before umi exportStatic
     before: "exportStatic",
     fn(memo) {
       const routePrefix = `${import_constants.SP_ROUTE_PREFIX}demos`;
       const examples = (0, import_assets.getExampleAssets)();
-      api.appData.exportHtmlData.push(...examples.map(({ id }) => ({
-        route: { path: `/${routePrefix}/${id}` },
-        file: `${routePrefix}/${id}/index.html`,
-        prerender: false
-      })));
+      api.appData.exportHtmlData.push(
+        ...examples.map(({ id }) => ({
+          route: { path: `/${routePrefix}/${id}` },
+          file: `${routePrefix}/${id}/index.html`,
+          prerender: false
+        }))
+      );
       return memo;
     }
   });
@@ -75,5 +81,3 @@ export function modifyClientRenderOpts(memo: any) {
     return [`@@/dumi/exportStaticRuntimePlugin.ts`];
   });
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});

package/dist/features/exports.js

@@ -16,7 +16,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/features/exports.ts
@@ -41,5 +48,3 @@ export * from '${(0, import_plugin_utils.winPath)(require.resolve("../client/the
     });
   });
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});

package/dist/features/html2sketch.js

@@ -101,11 +101,13 @@ export const getSketchJSON = ${api.config.html2sketch ? `async (
 `
     });
   });
-  api.addEntryImports(() => api.config.html2sketch ? { source: "@@/plugin-html2sketch/msgExecutor" } : []);
+  api.addEntryImports(
+    () => api.config.html2sketch ? { source: "@@/plugin-html2sketch/msgExecutor" } : []
+  );
   api.addHTMLHeadScripts(() => {
-    return api.config.html2sketch ? [api.config.html2sketch.scriptUrl || SCRIPT_URL] : [];
+    return api.config.html2sketch ? [{ src: api.config.html2sketch.scriptUrl || SCRIPT_URL, async: true }] : [];
   });
-  api.addRuntimePluginKey(() => api.config.html2sketch ? [RUNTIME_CONFIG] : []);
+  api.addRuntimePluginKey(
+    () => api.config.html2sketch ? [RUNTIME_CONFIG] : []
+  );
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});