dumi 2.0.0-beta.7 → 2.0.0-beta.9

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

@@ -10,14 +10,28 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
-import { useRouteMeta, useSiteData } from 'dumi';
+import { useLocation, useRouteMeta, useSiteData } from 'dumi';
 import ContentTabs from 'dumi/theme/slots/ContentTabs';
 import React, { useEffect, useState } from 'react';
+import { useTabQueryState } from "./useTabMeta";
 export var DumiPage = function DumiPage(props) {
+  var _useLocation = useLocation(),
+      hash = _useLocation.hash;
+
   var _useRouteMeta = useRouteMeta(),
       tabs = _useRouteMeta.tabs;
 
-  var _useState = useState(),
+  var _useTabQueryState = useTabQueryState(),
+      _useTabQueryState2 = _slicedToArray(_useTabQueryState, 2),
+      tabKey = _useTabQueryState2[0],
+      setTabKey = _useTabQueryState2[1];
+
+  var _useState = useState(function () {
+    return tabs === null || tabs === void 0 ? void 0 : tabs.find(function (_ref) {
+      var key = _ref.key;
+      return key === tabKey;
+    });
+  }),
       _useState2 = _slicedToArray(_useState, 2),
       tab = _useState2[0],
       setTab = _useState2[1];
@@ -28,12 +42,18 @@ export var DumiPage = function DumiPage(props) {
 
   useEffect(function () {
     setLoading(false);
-  }, []);
+  }, []); // handle hash change
+
+  useEffect(function () {
+    var elm = document.getElementById(hash.replace('#', ''));
+    if (elm) elm.scrollIntoView();
+  }, [hash]);
   return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(ContentTabs, {
     tabs: tabs,
-    tabKey: tab === null || tab === void 0 ? void 0 : tab.key,
+    tabKey: tabKey,
     onChange: function onChange(val) {
       setTab(val);
+      setTabKey(val === null || val === void 0 ? void 0 : val.key);
     }
   }), tab ? /*#__PURE__*/React.createElement(tab.components.default) : props.children);
 };

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

@@ -7,6 +7,7 @@ interface ISiteContext {
     demos: Record<string, {
         component: ComponentType;
         asset: IPreviewerProps['asset'];
+        routeId: string;
     }>;
     components: Record<string, AtomComponentAsset>;
     locales: NonNullable<ILocalesConfig>;

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

@@ -9,3 +9,5 @@ export { useLocale } from './useLocale';
 export { useNavData } from './useNavData';
 export { useRouteMeta } from './useRouteMeta';
 export { useFullSidebarData, useSidebarData } from './useSidebarData';
+export { useSiteSearch } from './useSiteSearch';
+export { useTabMeta } from './useTabMeta';

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

@@ -7,4 +7,6 @@ export { useAtomAssets } from "./useAtomAssets";
 export { useLocale } from "./useLocale";
 export { useNavData } from "./useNavData";
 export { useRouteMeta } from "./useRouteMeta";
-export { useFullSidebarData, useSidebarData } from "./useSidebarData";
+export { useFullSidebarData, useSidebarData } from "./useSidebarData";
+export { useSiteSearch } from "./useSiteSearch";
+export { useTabMeta } from "./useTabMeta";

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

@@ -57,6 +57,22 @@ export interface IRouteMeta {
             order?: number;
         };
         order?: number;
+        hero?: {
+            title?: string;
+            description?: string;
+            background?: string;
+            links?: {
+                title: string;
+                link: string;
+            }[];
+            [key: string]: any;
+        };
+        features?: {
+            emoji?: string;
+            title?: string;
+            description?: string;
+            [key: string]: any;
+        }[];
         toc?: boolean | 'content' | 'menu';
         demo?: {
             cols?: number;
@@ -68,6 +84,18 @@ export interface IRouteMeta {
         depth: number;
         title: string;
     }[];
+    texts: {
+        type?: 'content';
+        value: string;
+        /**
+         * paragraph index
+         */
+        paraId: number;
+        /**
+         * title index in toc
+         */
+        tocIndex?: number;
+    }[];
     tabs?: {
         key: string;
         components: {
@@ -75,9 +103,12 @@ export interface IRouteMeta {
             Extra: ComponentType;
             Action: ComponentType;
         };
-        frontmatter: Omit<IRouteMeta['frontmatter'], 'description' | 'keywords' | 'nav' | 'group'>;
-        toc: IRouteMeta['toc'];
-        [key: string]: any;
+        meta: {
+            frontmatter: Omit<IRouteMeta['frontmatter'], 'description' | 'keywords' | 'nav' | 'group' | 'hero' | 'features'>;
+            toc: IRouteMeta['toc'];
+            texts: IRouteMeta['texts'];
+            [key: string]: any;
+        };
     }[];
     [key: string]: any;
 }

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

@@ -11,7 +11,7 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
 import { matchRoutes, useAppData, useLocation, useRouteData } from 'dumi';
-import { useCallback, useEffect, useState } from 'react';
+import { useCallback, useLayoutEffect, useState } from 'react';
 
 /**
  * hook for get matched route meta
@@ -42,7 +42,8 @@ export var useRouteMeta = function useRouteMeta() {
 
     return ret || {
       frontmatter: {},
-      toc: []
+      toc: [],
+      texts: []
     };
   }, [clientRoutes.length, pathname]);
 
@@ -51,7 +52,7 @@ export var useRouteMeta = function useRouteMeta() {
       meta = _useState2[0],
       setMeta = _useState2[1];
 
-  useEffect(function () {
+  useLayoutEffect(function () {
     setMeta(getter);
   }, [clientRoutes.length, pathname]);
   return meta;

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

@@ -0,0 +1,23 @@
+interface IHighlightText {
+    highlighted?: boolean;
+    text: string;
+}
+interface ISearchNavResult {
+    title?: string;
+    priority: number;
+    hints: {
+        type: 'page' | 'title' | 'demo' | 'content';
+        link: string;
+        priority: number;
+        highlightTitleTexts: IHighlightText[];
+        highlightTexts: IHighlightText[];
+    }[];
+}
+declare type ISearchResult = ISearchNavResult[];
+export declare const useSiteSearch: () => {
+    keywords: string;
+    setKeywords: (val: string) => void;
+    result: ISearchResult;
+    loading: boolean;
+};
+export {};

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

@@ -0,0 +1,347 @@
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return 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 _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; }
+
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(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; }
+
+import { useNavData, useSiteData } from 'dumi';
+import { findAll } from 'highlight-words-core';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { TAB_QUERY_KEY } from "./useTabMeta";
+import { useLocaleDocRoutes } from "./utils";
+
+function createMetadataSection(rawTitle, title, link, texts, tocIndex) {
+  var allowEmptyParas = tocIndex !== undefined;
+  var paragraphs = texts.reduce(function (acc, text) {
+    if (text.tocIndex === tocIndex) {
+      acc[text.paraId] = (acc[text.paraId] || '').concat(text.value);
+    }
+
+    return acc;
+  }, []).filter(Boolean);
+  return Boolean(paragraphs.length) || allowEmptyParas ? {
+    rawTitle: rawTitle,
+    title: title,
+    link: link,
+    paragraphs: texts.reduce(function (acc, text) {
+      if (text.tocIndex === tocIndex) {
+        var _text$paraId, _acc$_text$paraId;
+
+        (_acc$_text$paraId = acc[_text$paraId = text.paraId]) !== null && _acc$_text$paraId !== void 0 ? _acc$_text$paraId : acc[_text$paraId] = '';
+        acc[text.paraId] += text.value;
+      }
+
+      return acc;
+    }, []).filter(Boolean)
+  } : null;
+}
+
+function generateSearchMetadata(routes, demos, nav) {
+  var metadata = []; // generate demos mapping by route.id
+
+  var demosMapping = Object.values(demos).reduce(function (acc, demo) {
+    if (demo.asset) {
+      var _demo$routeId, _acc$_demo$routeId;
+
+      (_acc$_demo$routeId = acc[_demo$routeId = demo.routeId]) !== null && _acc$_demo$routeId !== void 0 ? _acc$_demo$routeId : acc[_demo$routeId] = [];
+      acc[demo.routeId].push(demo);
+    }
+
+    return acc;
+  }, {});
+  Object.values(routes).forEach(function (route) {
+    // only process content route
+    if ('meta' in route && !('isLayout' in route)) {
+      var _demosMapping$route$i;
+
+      var routeMeta = route.meta;
+      var routeAbsPath = route.path.replace(/^([^/])/, '/$1') || '/';
+      var routeNav = nav.find(function (item) {
+        return routeAbsPath === item.link || routeAbsPath.startsWith("".concat(item.activePath, "/"));
+      });
+      var demoIds = (demosMapping[route.id] || []).map(function (demo) {
+        var _demo$asset;
+
+        return (_demo$asset = demo.asset) === null || _demo$asset === void 0 ? void 0 : _demo$asset.id;
+      });
+      var orphanSection = createMetadataSection('', routeMeta.frontmatter.title, routeAbsPath, routeMeta.texts);
+      var tocSections = routeMeta.toc.reduce(function (acc, toc, i) {
+        // exclude demo id, to avoid duplicate
+        if (!demoIds.includes(toc.id) && toc.depth > 1) {
+          acc.push(createMetadataSection(toc.title, "".concat(routeMeta.frontmatter.title, " - ").concat(toc.title), "".concat(routeAbsPath, "#").concat(toc.id), routeMeta.texts, i));
+        }
+
+        return acc;
+      }, []);
+      var tabSections = (routeMeta.tabs || []).reduce(function (acc, _ref) {
+        var key = _ref.key,
+            meta = _ref.meta;
+        // collect orphan section that not in toc
+        var tabOrphanSection = createMetadataSection('', "".concat(routeMeta.frontmatter.title, " - ").concat(meta.frontmatter.title), "".concat(routeAbsPath, "?").concat(TAB_QUERY_KEY, "=").concat(key), meta.texts);
+        if (tabOrphanSection) acc.push(tabOrphanSection); // collect sections by toc
+
+        acc.push.apply(acc, _toConsumableArray(meta.toc.map(function (toc, i) {
+          return createMetadataSection(toc.title, "".concat(routeMeta.frontmatter.title, " - ").concat(meta.frontmatter.title, " - ").concat(toc.title), "".concat(routeAbsPath, "?").concat(TAB_QUERY_KEY, "=").concat(key, "#").concat(toc.id), meta.texts, i);
+        })));
+        return acc;
+      }, []);
+      metadata.push({
+        navTitle: routeNav === null || routeNav === void 0 ? void 0 : routeNav.title,
+        navOrder: routeNav ? nav.indexOf(routeNav) : Infinity,
+        title: routeMeta.frontmatter.title,
+        link: routeAbsPath,
+        sections: [].concat(_toConsumableArray(orphanSection ? [orphanSection] : []), _toConsumableArray(tocSections), _toConsumableArray(tabSections)),
+        demos: ((_demosMapping$route$i = demosMapping[route.id]) === null || _demosMapping$route$i === void 0 ? void 0 : _demosMapping$route$i.map(function (demo) {
+          return {
+            link: "".concat(routeAbsPath, "#").concat(demo.asset.id),
+            rawTitle: demo.asset.title || '',
+            title: demo.asset.title || routeMeta.frontmatter.title,
+            description: demo.asset.description || '',
+            keywords: demo.asset.keywords || []
+          };
+        })) || []
+      });
+    }
+  });
+  return metadata;
+}
+
+function generateHighlightTexts() {
+  var str = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  var keywords = arguments.length > 1 ? arguments[1] : undefined;
+  var chunks = findAll({
+    textToHighlight: str,
+    searchWords: keywords,
+    autoEscape: true
+  }); // save matched keywords
+
+  var matchedMapping = {};
+  return [chunks.map(function (_ref2, i) {
+    var start = _ref2.start,
+        end = _ref2.end,
+        highlight = _ref2.highlight;
+    var highlightText = {
+      text: str.slice(start, end)
+    }; // omit long str before the first highlighted text
+
+    if (i === 0 && !highlight && chunks.length > 1 && highlightText.text.length > 20) {
+      highlightText.text = "...".concat(highlightText.text.slice(-20));
+    } // mark highlight
+
+
+    if (highlight) {
+      highlightText.highlighted = true;
+      matchedMapping[keywords.find(function (k) {
+        return highlightText.text.includes(k);
+      })] = true;
+    }
+
+    return highlightText;
+  }), matchedMapping];
+}
+
+function generateSearchResult(metadata, keywordsStr) {
+  var keywords = keywordsStr.split(' ');
+  var matchReg = new RegExp(keywordsStr.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(' ', '|'), 'gi');
+  var resultMapping = {}; // traverse metadata from all routes
+
+  metadata.forEach(function (data) {
+    var hints = []; // find content & section hints
+
+    data.sections.forEach(function (sec) {
+      // find matched keywords in paragraph
+      var _iterator = _createForOfIteratorHelper(sec.paragraphs),
+          _step;
+
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var p = _step.value;
+
+          if (matchReg.test(p)) {
+            var _generateHighlightTex3 = generateHighlightTexts(sec.title, keywords),
+                _generateHighlightTex4 = _slicedToArray(_generateHighlightTex3, 2),
+                _highlightTitleTexts = _generateHighlightTex4[0],
+                _titleMatchMapping = _generateHighlightTex4[1];
+
+            var _generateHighlightTex5 = generateHighlightTexts(p, keywords),
+                _generateHighlightTex6 = _slicedToArray(_generateHighlightTex5, 2),
+                highlightTexts = _generateHighlightTex6[0],
+                matchMapping = _generateHighlightTex6[1];
+
+            hints.push({
+              type: 'content',
+              link: sec.link,
+              priority: Object.keys(_objectSpread(_objectSpread({}, _titleMatchMapping), matchMapping)).length,
+              highlightTitleTexts: _highlightTitleTexts,
+              highlightTexts: highlightTexts
+            }); // match at most once in the same section
+
+            return;
+          }
+        } // find matched keywords in section title
+
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+
+      if (matchReg.test(sec.rawTitle)) {
+        var _generateHighlightTex = generateHighlightTexts(sec.title, keywords),
+            _generateHighlightTex2 = _slicedToArray(_generateHighlightTex, 2),
+            highlightTitleTexts = _generateHighlightTex2[0],
+            titleMatchMapping = _generateHighlightTex2[1];
+
+        hints.push({
+          type: 'title',
+          link: sec.link,
+          priority: Object.keys(titleMatchMapping).length,
+          highlightTitleTexts: highlightTitleTexts,
+          highlightTexts: generateHighlightTexts(sec.paragraphs[0] || '', keywords)[0]
+        });
+      }
+    }); // find demo hints
+
+    data.demos.forEach(function (demo) {
+      if (matchReg.test(demo.rawTitle) || matchReg.test(demo.description)) {
+        var _generateHighlightTex7 = generateHighlightTexts(demo.title, keywords),
+            _generateHighlightTex8 = _slicedToArray(_generateHighlightTex7, 2),
+            highlightTitleTexts = _generateHighlightTex8[0],
+            titleMatchMapping = _generateHighlightTex8[1];
+
+        var _generateHighlightTex9 = generateHighlightTexts(demo.description, keywords),
+            _generateHighlightTex10 = _slicedToArray(_generateHighlightTex9, 2),
+            highlightTexts = _generateHighlightTex10[0],
+            matchMapping = _generateHighlightTex10[1];
+
+        hints.push({
+          type: 'demo',
+          link: demo.link,
+          priority: Object.keys(_objectSpread(_objectSpread({}, titleMatchMapping), matchMapping)).length,
+          highlightTitleTexts: highlightTitleTexts,
+          highlightTexts: highlightTexts
+        });
+      }
+    }); // find page hints
+
+    if (matchReg.test(data.title)) {
+      var _data$sections$;
+
+      var _generateHighlightTex11 = generateHighlightTexts(data.title, keywords),
+          _generateHighlightTex12 = _slicedToArray(_generateHighlightTex11, 2),
+          highlightTitleTexts = _generateHighlightTex12[0],
+          titleMatchMapping = _generateHighlightTex12[1];
+
+      hints.push({
+        type: 'page',
+        link: data.link,
+        priority: Object.keys(titleMatchMapping).length,
+        highlightTitleTexts: highlightTitleTexts,
+        highlightTexts: generateHighlightTexts(((_data$sections$ = data.sections[0]) === null || _data$sections$ === void 0 ? void 0 : _data$sections$.paragraphs[0]) || '', keywords)[0]
+      });
+    } // create nav result if there has any hint
+
+
+    if (hints.length) {
+      var _resultMapping$key, _resultMapping$key$hi;
+
+      var key = data.navTitle || '$ROOT';
+      (_resultMapping$key = resultMapping[key]) !== null && _resultMapping$key !== void 0 ? _resultMapping$key : resultMapping[key] = {
+        title: data.navTitle,
+        priority: data.navOrder,
+        hints: []
+      };
+
+      (_resultMapping$key$hi = resultMapping[key].hints).push.apply(_resultMapping$key$hi, hints);
+    }
+  }); // sort hints
+
+  Object.values(resultMapping).forEach(function (_ref3) {
+    var hints = _ref3.hints;
+    hints.sort(function (prev, next) {
+      return next.priority - prev.priority;
+    });
+  });
+  return Object.values(resultMapping).sort(function (prev, next) {
+    return next.priority - prev.priority;
+  });
+}
+
+export var useSiteSearch = function useSiteSearch() {
+  var debounceTimer = useRef();
+  var routes = useLocaleDocRoutes();
+
+  var _useSiteData = useSiteData(),
+      demos = _useSiteData.demos;
+
+  var _useState = useState(false),
+      _useState2 = _slicedToArray(_useState, 2),
+      loading = _useState2[0],
+      setLoading = _useState2[1];
+
+  var _useState3 = useState(''),
+      _useState4 = _slicedToArray(_useState3, 2),
+      keywords = _useState4[0],
+      setKeywords = _useState4[1];
+
+  var navData = useNavData();
+
+  var _useState5 = useState([]),
+      _useState6 = _slicedToArray(_useState5, 2),
+      metadata = _useState6[0],
+      setMetadata = _useState6[1];
+
+  var _useState7 = useState([]),
+      _useState8 = _slicedToArray(_useState7, 2),
+      result = _useState8[0],
+      setResult = _useState8[1];
+
+  var setter = useCallback(function (val) {
+    setLoading(true);
+    setKeywords(val);
+  }, []);
+  useEffect(function () {
+    setMetadata(generateSearchMetadata(routes, demos, navData));
+  }, [routes, demos, navData]);
+  useEffect(function () {
+    var str = keywords.trim();
+
+    if (str) {
+      clearTimeout(debounceTimer.current);
+      debounceTimer.current = window.setTimeout(function () {
+        setResult(generateSearchResult(metadata, str));
+        setLoading(false);
+      }, 100);
+    } else {
+      setResult([]);
+    }
+  }, [keywords, metadata]);
+  return {
+    keywords: keywords,
+    setKeywords: setter,
+    result: result,
+    loading: loading
+  };
+};

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

@@ -0,0 +1,4 @@
+import type { IRouteMeta } from './types';
+export declare const TAB_QUERY_KEY = "tab";
+export declare const useTabQueryState: () => [string | null, (val?: string) => void];
+export declare const useTabMeta: () => NonNullable<IRouteMeta['tabs']>[0]['meta'] | undefined;

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

@@ -0,0 +1,47 @@
+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 { history, useLocation, useRouteMeta, useSearchParams } from 'dumi';
+import { useCallback } from 'react';
+export var TAB_QUERY_KEY = 'tab';
+export var useTabQueryState = function useTabQueryState() {
+  var _useLocation = useLocation(),
+      pathname = _useLocation.pathname;
+
+  var _useSearchParams = useSearchParams(),
+      _useSearchParams2 = _slicedToArray(_useSearchParams, 1),
+      params = _useSearchParams2[0];
+
+  var setTabQueryState = useCallback(function (val) {
+    if (val) params.set(TAB_QUERY_KEY, val);else params.delete(TAB_QUERY_KEY);
+    history.push({
+      pathname: pathname,
+      search: params.toString()
+    });
+  }, [params]);
+  return [params.get(TAB_QUERY_KEY), setTabQueryState];
+};
+export var useTabMeta = function useTabMeta() {
+  var _tabs$find;
+
+  var _useRouteMeta = useRouteMeta(),
+      tabs = _useRouteMeta.tabs;
+
+  var _useTabQueryState = useTabQueryState(),
+      _useTabQueryState2 = _slicedToArray(_useTabQueryState, 1),
+      tabKey = _useTabQueryState2[0];
+
+  return tabs === null || tabs === void 0 ? void 0 : (_tabs$find = tabs.find(function (_ref) {
+    var key = _ref.key;
+    return tabKey === key;
+  })) === null || _tabs$find === void 0 ? void 0 : _tabs$find.meta;
+};

package/dist/features/configPlugins/index.js

@@ -27,7 +27,7 @@ var configPlugins_default = (api) => {
   const configDefaults = {
     resolve: {
       docDirs: ["docs"],
-      entityDirs: [{ type: "component", dir: "src" }],
+      atomDirs: [{ type: "component", dir: "src" }],
       codeBlockMode: "active"
     },
     themeConfig: {}

package/dist/features/configPlugins/schema.js

@@ -29,13 +29,15 @@ 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(),
-      entityDirs: Joi.array().items(Joi.object({ type: Joi.string(), dir: Joi.string() })).optional(),
+      atomDirs: Joi.array().items(Joi.object({ type: Joi.string(), dir: Joi.string() })).optional(),
+      entityDirs: Joi.forbidden().error(new Error("`entityDirs` is already deprecated, please rename it to `atomDirs` in `.umirc.ts` or `config/config.ts`")),
       codeBlockMode: Joi.string().valid("active", "passive").optional(),
       entryFile: Joi.string().optional()
     }).optional(),
     extraRemarkPlugins: getUnifiedPluginSchema,
     extraRehypePlugins: getUnifiedPluginSchema,
-    themeConfig: (Joi) => Joi.object().optional()
+    themeConfig: (Joi) => Joi.object().optional(),
+    logo: (Joi) => Joi.string()
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/features/exports.d.ts

@@ -1,3 +1,8 @@
 import type { IApi } from "../types";
+/**
+ * exclude pre-compiling modules in mfsu mode
+ * and make sure there has no multiple instances problem (such as react)
+ */
+export declare function safeExcludeInMFSU(api: IApi, excludes: RegExp[]): void;
 declare const _default: (api: IApi) => void;
 export default _default;

package/dist/features/exports.js

@@ -22,12 +22,31 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/features/exports.ts
 var exports_exports = {};
 __export(exports_exports, {
-  default: () => exports_default
+  default: () => exports_default,
+  safeExcludeInMFSU: () => safeExcludeInMFSU
 });
 module.exports = __toCommonJS(exports_exports);
 var import_plugin_utils = require("umi/plugin-utils");
+function safeExcludeInMFSU(api, excludes) {
+  if (api.userConfig.mfsu !== false) {
+    api.modifyDefaultConfig((memo) => {
+      memo.mfsu ?? (memo.mfsu = {});
+      memo.mfsu.exclude = (0, import_plugin_utils.deepmerge)(memo.mfsu.exclude || [], excludes);
+      memo.extraBabelIncludes ?? (memo.extraBabelIncludes = []);
+      memo.extraBabelIncludes.push(...excludes);
+      return memo;
+    });
+  }
+}
 var exports_default = (api) => {
   api.describe({ key: void 0 });
+  safeExcludeInMFSU(api, [new RegExp("dumi/dist/client")]);
+  api.modifyDefaultConfig((memo) => {
+    if (api.userConfig.mfsu !== false) {
+      memo.mfsu = { strategy: "normal" };
+    }
+    return memo;
+  });
   api.modifyConfig((memo) => {
     memo.alias["dumi$"] = "@@/dumi/exports";
     return memo;
@@ -42,4 +61,6 @@ export * from '${(0, import_plugin_utils.winPath)(require.resolve("../client/the
   });
 };
 // Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {});
+0 && (module.exports = {
+  safeExcludeInMFSU
+});