dumi 2.0.0-alpha.1 → 2.0.0-alpha.2

package/dist/assetParsers/block.js

@@ -50,7 +50,7 @@ async function parseBlockAsset(opts) {
   const result = {
     asset,
     sources: {},
-    frontmatter: {}
+    frontmatter: null
   };
   await (0, import_esbuild.build)({
     write: false,

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

@@ -1,14 +1,64 @@
-import React from 'react';
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+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 _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { useMatchedRouteMeta } from 'dumi/theme';
+import React, { useState } from 'react';
 import { DumiDemo } from "./DumiDemo";
 export var DumiDemoGrid = function DumiDemoGrid(props) {
+  var meta = useMatchedRouteMeta();
+
+  var _useState = useState(function () {
+    var _meta$demo;
+
+    var cols = [];
+
+    if ((_meta$demo = meta.demo) !== null && _meta$demo !== void 0 && _meta$demo.cols && meta.demo.cols > 1) {
+      for (var i = 0; i < props.items.length; i += meta.demo.cols) {
+        props.items.slice(i, i + meta.demo.cols).forEach(function (item, j) {
+          var _cols$j;
+
+          (_cols$j = cols[j]) !== null && _cols$j !== void 0 ? _cols$j : cols[j] = [];
+          cols[j].push(item);
+        });
+      }
+
+      return cols;
+    } else {
+      cols.push(props.items);
+    }
+
+    return cols;
+  }),
+      _useState2 = _slicedToArray(_useState, 1),
+      cols = _useState2[0];
+
   return /*#__PURE__*/React.createElement("div", {
     style: {
-      display: 'grid',
-      gridTemplateColumns: 'repeat(2, 1fr)'
+      display: 'flex',
+      margin: -8
     }
-  }, props.items.map(function (item) {
+  }, cols.map(function (col, i) {
     return /*#__PURE__*/React.createElement("section", {
-      key: item.demo.id
-    }, /*#__PURE__*/React.createElement(DumiDemo, item));
+      style: {
+        flex: 1,
+        padding: 8
+      },
+      key: String(i)
+    }, col.map(function (item) {
+      return /*#__PURE__*/React.createElement(DumiDemo, _extends({
+        key: item.demo.id
+      }, item));
+    }));
   }));
 };

package/dist/client/theme-api/context.d.ts

@@ -1,14 +1,10 @@
 import { type ComponentType } from 'react';
-import type { IPreviewerProps } from './types';
+import type { ILocalesConfig, IPreviewerProps } from './types';
 export interface IThemeContext {
     demos: Record<string, {
         component: ComponentType;
         asset: IPreviewerProps['asset'];
     }>;
-    locales: {
-        id: string;
-        name: string;
-        base: string;
-    }[];
+    locales: ILocalesConfig;
 }
 export declare const Context: import("react").Context<IThemeContext>;

package/dist/client/theme-api/index.d.ts

@@ -3,3 +3,4 @@ export * from './context';
 export * from './DumiDemo';
 export * from './DumiDemoGrid';
 export * from './types';
+export * from './useMatchedRouteMeta';

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

@@ -2,4 +2,5 @@ export { useIntl } from 'react-intl';
 export * from "./context";
 export * from "./DumiDemo";
 export * from "./DumiDemoGrid";
-export * from "./types";
+export * from "./types";
+export * from "./useMatchedRouteMeta";

package/dist/client/theme-api/types.d.ts

@@ -9,6 +9,10 @@ export interface IPreviewerProps {
      * description of current demo
      */
     description?: string;
+    /**
+     * file path of current demo
+     */
+    filePath?: string;
     /**
      * asset metadata of current demo
      */
@@ -17,4 +21,27 @@ export interface IPreviewerProps {
      * react node of current demo
      */
     children: ReactNode;
+    [key: string]: any;
+}
+export interface IRouteMeta {
+    title?: string;
+    description?: string;
+    keywords?: string[];
+    category?: string;
+    order?: number;
+    toc?: boolean | 'content' | 'menu';
+    demo?: {
+        cols?: number;
+    };
+    [key: string]: any;
 }
+declare type IBasicLocale = {
+    id: string;
+    name: string;
+};
+export declare type ILocalesConfig = ((IBasicLocale & {
+    base?: string;
+}) | (IBasicLocale & {
+    suffix: string;
+}))[];
+export {};

package/dist/client/theme-api/useMatchedRouteMeta.d.ts

@@ -0,0 +1,5 @@
+import type { IRouteMeta } from './types';
+/**
+ * hook for get matched route meta
+ */
+export declare const useMatchedRouteMeta: () => IRouteMeta;

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

@@ -0,0 +1,55 @@
+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 _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { matchRoutes, useAppData, useLocation, useRouteData } from 'dumi';
+import { useCallback, useEffect, useState } from 'react';
+
+/**
+ * hook for get matched route meta
+ */
+export var useMatchedRouteMeta = function useMatchedRouteMeta() {
+  var _useRouteData = useRouteData(),
+      route = _useRouteData.route;
+
+  var _useLocation = useLocation(),
+      pathname = _useLocation.pathname;
+
+  var _useAppData = useAppData(),
+      clientRoutes = _useAppData.clientRoutes;
+
+  var getter = useCallback(function () {
+    var ret;
+
+    if (route.path === pathname) {
+      // use `useRouteData` result if matched, for performance
+      ret = route.meta;
+    } else {
+      var _matchRoutes, _matched$route;
+
+      // match manually for dynamic route & layout component
+      var matched = (_matchRoutes = matchRoutes(clientRoutes, pathname)) === null || _matchRoutes === void 0 ? void 0 : _matchRoutes.pop();
+      ret = matched === null || matched === void 0 ? void 0 : (_matched$route = matched.route) === null || _matched$route === void 0 ? void 0 : _matched$route.meta;
+    }
+
+    return ret || {};
+  }, [clientRoutes.length, pathname]);
+
+  var _useState = useState(getter),
+      _useState2 = _slicedToArray(_useState, 2),
+      meta = _useState2[0],
+      setMeta = _useState2[1];
+
+  useEffect(function () {
+    setMeta(getter);
+  }, [clientRoutes.length, pathname]);
+  return meta;
+};

package/dist/client/tsconfig.json

@@ -3,6 +3,8 @@
   "compilerOptions": {
     "paths": {
       "@/*": ["src/*"],
+      "@@/*": ["src/.umi/*"],
+      "dumi": ["src"],
       "dumi/theme": ["src/client/theme-api"],
       "dumi/theme/*": ["src/client/theme-default/*"]
     }

package/dist/features/compile.js

@@ -27,17 +27,34 @@ __export(compile_exports, {
 module.exports = __toCommonJS(compile_exports);
 var import_react = __toESM(require("../techStacks/react"));
 var compile_default = (api) => {
-  api.registerTechStack(() => new import_react.default());
+  api.register({
+    key: "registerTechStack",
+    stage: Infinity,
+    fn: () => new import_react.default()
+  });
+  api.modifyDefaultConfig((memo) => {
+    memo.alias.dumi$ = memo.alias.umi;
+    return memo;
+  });
   api.chainWebpack(async (memo) => {
-    const loaderPath = require.resolve("../loaders/markdown");
     const babelInUmi = memo.module.rule("src").use("babel-loader").entries();
     const techStacks = await api.applyPlugins({
       key: "registerTechStack",
       type: api.ApplyPluginsType.add
     });
-    memo.module.rule("dumi-md").type("javascript/auto").test(/\.md$/).oneOf("demo-index").resourceQuery(/meta\.demos/).use("demo-index-loader").loader(loaderPath).options({ techStacks, cwd: api.cwd, mode: "demos" }).end().end().oneOf("md").use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-loader").loader(loaderPath).options({
+    const loaderPath = require.resolve("../loaders/markdown");
+    const loaderBaseOpts = {
       techStacks,
       cwd: api.cwd,
+      codeBlockMode: api.config.resolve.codeBlockMode,
+      extraRemarkPlugins: api.config.extraRemarkPlugins,
+      extraRehypePlugins: api.config.extraRehypePlugins
+    };
+    memo.module.rule("dumi-md").type("javascript/auto").test(/\.md$/).oneOf("demo-index").resourceQuery(/meta$/).use("demo-index-loader").loader(loaderPath).options({
+      ...loaderBaseOpts,
+      mode: "meta"
+    }).end().end().oneOf("md").use("babel-loader").loader(babelInUmi.loader).options(babelInUmi.options).end().use("md-loader").loader(loaderPath).options({
+      ...loaderBaseOpts,
       builtins: api.service.themeData.builtins
     });
     memo.module.rule("dumi-demo").type("javascript/auto").test(/\..+$/).enforce("pre").resourceQuery(/techStack/).use("demo-loader").loader(require.resolve("../loaders/demo")).options({ techStacks, cwd: api.cwd });

package/dist/features/configPlugins/index.js

@@ -27,7 +27,8 @@ var configPlugins_default = (api) => {
   const configDefaults = {
     resolve: {
       docDirs: ["docs"],
-      entityDirs: [{ type: "component", dir: "src" }]
+      entityDirs: [{ type: "component", dir: "src" }],
+      codeBlockMode: "active"
     }
   };
   const schemas = (0, import_schema.getSchemas)();

package/dist/features/configPlugins/schema.js

@@ -22,12 +22,18 @@ __export(schema_exports, {
   getSchemas: () => getSchemas
 });
 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();
+}
 function getSchemas() {
   return {
     resolve: (Joi) => Joi.object({
       docDirs: Joi.array().items(Joi.string()).optional(),
-      entityDirs: Joi.array().items(Joi.object({ type: Joi.string(), dir: Joi.string() })).optional()
-    }).optional()
+      entityDirs: Joi.array().items(Joi.object({ type: Joi.string(), dir: Joi.string() })).optional(),
+      codeBlockMode: Joi.string().valid("active", "passive").optional()
+    }).optional(),
+    extraRemarkPlugins: getUnifiedPluginSchema,
+    extraRehypePlugins: getUnifiedPluginSchema
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/features/locales.js

@@ -26,11 +26,16 @@ var locales_default = (api) => {
   api.describe({
     config: {
       default: [{ id: "zh-CN", name: "\u4E2D\u6587", base: "/" }],
-      schema: (Joi) => Joi.array().items(Joi.object({
-        id: Joi.string().regex(/^[a-z]{2}-[A-Z]{2}$/),
-        name: Joi.string(),
-        base: Joi.string().optional()
-      }))
+      schema: (Joi) => {
+        const basicOpts = { id: Joi.string(), name: Joi.string() };
+        return Joi.alternatives(Joi.array().items(Joi.object({
+          ...basicOpts,
+          base: Joi.string().optional()
+        })), Joi.array().items(Joi.object({
+          ...basicOpts,
+          suffix: Joi.string().allow("")
+        })));
+      }
     }
   });
   api.register({
@@ -39,7 +44,9 @@ var locales_default = (api) => {
     fn: (memo) => {
       var _a;
       (_a = memo.locales) == null ? void 0 : _a.forEach((locale, i) => {
-        locale.base ?? (locale.base = i ? `/${locale.id}` : "/");
+        if (!("suffix" in locale)) {
+          locale.base ?? (locale.base = i ? `/${locale.id}` : "/");
+        }
       });
       return memo;
     }
@@ -64,7 +71,12 @@ const cache = createIntlCache();
 
 const LocalesContainer: FC<{ children: ReactNode }> = (props) => {
   const [locale] = useState(() => {
-    const matched = locales.find((locale) => history.location.pathname.startsWith(locale.base));
+    const matched = locales.find((locale) => (
+      // base mode
+      history.location.pathname.startsWith(locale.base) ||
+      // suffix mode
+      ('suffix' in locale && history.location.pathname.endsWith(locale.suffix))
+    ));
 
     return matched ? matched.id : locales[0].id;
   });

package/dist/features/meta.d.ts

@@ -0,0 +1,3 @@
+import type { IApi } from "../types";
+declare const _default: (api: IApi) => void;
+export default _default;

package/dist/features/meta.js

@@ -0,0 +1,77 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/features/meta.ts
+var meta_exports = {};
+__export(meta_exports, {
+  default: () => meta_default
+});
+module.exports = __toCommonJS(meta_exports);
+var import_plugin_utils = require("umi/plugin-utils");
+var meta_default = (api) => {
+  const mdRouteFiles = [];
+  api.modifyRoutes((routes) => {
+    Object.values(routes).forEach((route) => {
+      if (route.file.endsWith(".md")) {
+        mdRouteFiles.push({
+          index: mdRouteFiles.length,
+          file: route.file,
+          id: route.id
+        });
+      }
+    });
+    return routes;
+  });
+  api.onGenerateFiles(() => {
+    api.writeTmpFile({
+      noPluginDir: true,
+      path: "dumi/meta/index.ts",
+      content: import_plugin_utils.Mustache.render(`{{#mdRouteFiles}}
+import { demos as d{{{index}}}, frontmatter as fm{{{index}}} } from '{{{file}}}?type=meta';
+{{/mdRouteFiles}}
+
+export const demos = {
+  {{#mdRouteFiles}}
+  ...d{{{index}}},
+  {{/mdRouteFiles}}
+};
+
+export const routesMeta = {
+  {{#mdRouteFiles}}
+  '{{{id}}}': fm{{{index}}},
+  {{/mdRouteFiles}}
+}`, { mdRouteFiles })
+    });
+    api.writeTmpFile({
+      noPluginDir: true,
+      path: "dumi/meta/runtime.ts",
+      content: `import { routesMeta } from '.';
+export const patchRoutes = ({ routes }) => {
+  Object.values(routes).forEach((route) => {
+    if (routesMeta[route.id]) {
+      route.meta = { ...route.meta, ...routesMeta[route.id] };
+    }
+  });
+}
+`
+    });
+  });
+  api.addRuntimePlugin(() => "@@/dumi/meta/runtime.ts");
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});

package/dist/features/routes.js

@@ -26,6 +26,7 @@ __export(routes_exports, {
 });
 module.exports = __toCommonJS(routes_exports);
 var import_core = require("@umijs/core");
+var import_utils = require("@umijs/core/dist/route/utils");
 var import_path = __toESM(require("path"));
 var import_pluralize = require("pluralize");
 var import_plugin_utils = require("umi/plugin-utils");
@@ -33,9 +34,10 @@ var CTX_LAYOUT_ID = "dumi-context-layout";
 function localizeUmiRoute(route, locales) {
   const locale = locales.find((locale2) => route.path.endsWith(`/${locale2.id}`) && import_path.default.parse(route.file).name.endsWith(`.${locale2.id}`));
   if (locale) {
-    const base = locale.base === "/" ? "" : locale.base;
-    route.path = `${base}${route.path.replace(new RegExp(`/${locale.id}$`), "").replace(/(index|README)$/, "")}`;
-    route.path = route.path !== "/" ? `/${route.path}` : route.path;
+    const base = !("base" in locale) || locale.base === "/" ? "" : locale.base.replace(/^(\/)(.+)$/, "$2$1");
+    const suffix = "suffix" in locale ? locale.suffix : "";
+    route.path = `${base}${route.path.replace(new RegExp(`/${locale.id}$`), "").replace(/(\/index|\/README)$/, "")}${suffix}`;
+    route.absPath = route.path !== "/" ? `/${route.path}` : route.path;
   }
 }
 var routes_default = (api) => {
@@ -46,6 +48,17 @@ var routes_default = (api) => {
     };
     return memo;
   });
+  api.modifyDefaultConfig((memo) => {
+    if (api.userConfig.resolve) {
+      const keys = ["docDirs", "entityDirs"];
+      keys.forEach((key) => {
+        var _a;
+        if (((_a = api.userConfig.resolve[key]) == null ? void 0 : _a.length) === 0)
+          memo.resolve[key] = [];
+      });
+    }
+    return memo;
+  });
   api.modifyRoutes((oRoutes) => {
     const routes = Object.values(oRoutes).reduce((ret, route) => {
       if (route.isLayout) {
@@ -88,7 +101,7 @@ var routes_default = (api) => {
       const entityFiles = import_plugin_utils.glob.sync("{*,*/index,*/index.*,*/README,*/README.*}.md", { cwd: base });
       entityFiles.forEach((file) => {
         const routePath = (0, import_plugin_utils.winPath)(import_path.default.join((0, import_pluralize.plural)(type), file)).replace(/(\/index|\/README)?\.md$/, "").replace(/\./g, "/");
-        const routeId = `${dir}/${routePath}`;
+        const routeId = (0, import_utils.createRouteId)(file);
         routes[routeId] = {
           id: routeId,
           path: routePath,

package/dist/features/sideEffects/docSideEffectsWebpackPlugin.d.ts

@@ -0,0 +1,14 @@
+import type { webpack } from 'umi';
+interface IOpts {
+    sideEffects: string[];
+    pkgPath: string;
+}
+/**
+ * webpack plugin for add extra sideEffects item if user configured sideEffects in package.json
+ */
+export default class docSideEffectsWebpackPlugin {
+    opts: IOpts;
+    constructor(opts: IOpts);
+    apply(compiler: webpack.Compiler): void;
+}
+export {};

package/dist/features/sideEffects/docSideEffectsWebpackPlugin.js

@@ -0,0 +1,50 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/features/sideEffects/docSideEffectsWebpackPlugin.ts
+var docSideEffectsWebpackPlugin_exports = {};
+__export(docSideEffectsWebpackPlugin_exports, {
+  default: () => docSideEffectsWebpackPlugin
+});
+module.exports = __toCommonJS(docSideEffectsWebpackPlugin_exports);
+var import_path = __toESM(require("path"));
+var docSideEffectsWebpackPlugin = class {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  apply(compiler) {
+    compiler.hooks.normalModuleFactory.tap(this.constructor.name, (normalModuleFactory) => {
+      normalModuleFactory.hooks.afterResolve.tap(this.constructor.name, (data) => {
+        var _a;
+        const createData = data.createData || data;
+        const resourceResolveData = createData.resourceResolveData;
+        const sideEffectsFlag = (_a = resourceResolveData == null ? void 0 : resourceResolveData.descriptionFileData) == null ? void 0 : _a.sideEffects;
+        if (resourceResolveData && (sideEffectsFlag === false || Array.isArray(sideEffectsFlag)) && import_path.default.normalize(resourceResolveData.descriptionFilePath) === this.opts.pkgPath) {
+          const list = new Set(sideEffectsFlag || []);
+          this.opts.sideEffects.forEach((item) => list.add(item));
+          resourceResolveData.descriptionFileData.sideEffects = Array.from(list);
+        }
+      });
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});

package/dist/features/sideEffects/index.d.ts

@@ -0,0 +1,7 @@
+import type { IApi } from 'umi';
+/**
+ * plugin for register the doc side-effects webpack plugin
+ * to avoid tree-shaking for .umi & .dumi/theme directory if package.json has sideEffects: false
+ */
+declare const _default: (api: IApi) => void;
+export default _default;

package/dist/features/sideEffects/index.js

@@ -0,0 +1,47 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/features/sideEffects/index.ts
+var sideEffects_exports = {};
+__export(sideEffects_exports, {
+  default: () => sideEffects_default
+});
+module.exports = __toCommonJS(sideEffects_exports);
+var import_path = __toESM(require("path"));
+var import_plugin_utils = require("umi/plugin-utils");
+var import_docSideEffectsWebpackPlugin = __toESM(require("./docSideEffectsWebpackPlugin"));
+var sideEffects_default = (api) => {
+  api.describe({ key: "dumi:sideEffects" });
+  api.chainWebpack((memo) => {
+    memo.plugin("docSideEffects").use(import_docSideEffectsWebpackPlugin.default, [
+      {
+        sideEffects: [
+          (0, import_plugin_utils.winPath)(import_path.default.relative(api.cwd, import_path.default.join(api.paths.absTmpPath, "**"))),
+          ".dumi/theme/**"
+        ],
+        pkgPath: import_path.default.join(api.cwd, "package.json")
+      }
+    ]);
+    return memo;
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});