dumi 2.0.0-rc.0 → 2.0.0-rc.10

package/compiled/@umijs/plugins/index.js

@@ -0,0 +1 @@
+(function(){var e={226:function(e){var n=Object.defineProperty;var t=Object.getOwnPropertyDescriptor;var r=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var __export=(e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:true})};var __copyProps=(e,o,i,c)=>{if(o&&typeof o==="object"||typeof o==="function"){for(let s of r(o))if(!a.call(e,s)&&s!==i)n(e,s,{get:()=>o[s],enumerable:!(c=t(o,s))||c.enumerable})}return e};var __toCommonJS=e=>__copyProps(n({},"__esModule",{value:true}),e);var o={};__export(o,{default:()=>analytics_default});e.exports=__toCommonJS(o);var analytics_default=e=>{const n=process.env.GA_KEY;const t=process.env.GA_V2_KEY;const enableBy=e=>e.config.analytics||n;e.describe({key:"analytics",config:{schema(e){return e.alternatives().try(e.object({baidu:e.string(),ga:e.string(),ga_v2:e.string()}),e.boolean().invalid(true))},onChange:e.ConfigChangeType.reload},enableBy:enableBy});const baiduTpl=e=>`\n    (function() {\n      var hm = document.createElement('script');\n      hm.src = '//hm.baidu.com/hm.js?${e}';\n      var s = document.getElementsByTagName('script')[0];\n      s.parentNode.insertBefore(hm, s);\n    })();\n  `;const gaTpl=e=>`\n    (function(){\n      if (!location.port) {\n        (function (i, s, o, g, r, a, m) {\n          i['GoogleAnalyticsObject'] = r;\n          i[r] = i[r] || function () {\n              (i[r].q = i[r].q || []).push(arguments)\n            }, i[r].l = 1 * new Date();\n          a = s.createElement(o),\n            m = s.getElementsByTagName(o)[0];\n          a.async = 1;\n          a.src = g;\n          m.parentNode.insertBefore(a, m)\n        })(window, document, 'script', '//www.google-analytics.com/analytics.js', 'ga');\n        ga('create', '${e}', 'auto');\n        ga('send', 'pageview');\n      }\n    })();\n  `;const gaV2Tpl=e=>`\n      window.dataLayer = window.dataLayer || [];\n      function gtag(){dataLayer.push(arguments);}\n      gtag('js', new Date());\n      gtag('config', '${e}');\n    `.trim();e.addHTMLHeadScripts((()=>{const r=e.config.analytics||{};const{baidu:a,ga:o=n,ga_v2:i=t}=r;const c=[];if(a){c.push({content:"var _hmt = _hmt || [];"})}if(e.env!=="development"){if(a){c.push({content:baiduTpl(a)})}if(o){c.push({content:gaTpl(o)})}if(i){c.push({async:true,src:`//www.googletagmanager.com/gtag/js?id=${i}`},{content:gaV2Tpl(i)})}}return c.filter(Boolean)}))};0&&0}};var n={};function __nccwpck_require__(t){var r=n[t];if(r!==undefined){return r.exports}var a=n[t]={exports:{}};var o=true;try{e[t](a,a.exports,__nccwpck_require__);o=false}finally{if(o)delete n[t]}return a.exports}if(typeof __nccwpck_require__!=="undefined")__nccwpck_require__.ab=__dirname+"/";var t=__nccwpck_require__(226);module.exports=t})();

package/compiled/@umijs/plugins/package.json

@@ -0,0 +1 @@
+{"name":"@umijs/plugins","version":"4.0.30","authors":["chencheng <sorrycc@gmail.com> (https://github.com/sorrycc)"],"license":"MIT","_lastModified":"2022-11-13T07:05:33.094Z"}

package/dist/assetParsers/block.js

@@ -43,7 +43,7 @@ async function parseBlockAsset(opts) {
     sources: {},
     frontmatter: null
   };
-  await (0, import_esbuild.build)({
+  const deferrer = (0, import_esbuild.build)({
     write: false,
     bundle: true,
     logLevel: "silent",
@@ -71,7 +71,7 @@ async function parseBlockAsset(opts) {
               return { path: args.path, external: true };
             }
             return {
-              path: import_path.default.join(args.resolveDir, args.path),
+              path: args.kind !== "entry-point" ? opts.resolver(args.resolveDir, args.path) : import_path.default.join(args.resolveDir, args.path),
               pluginData: { kind: args.kind, resolveDir: args.resolveDir }
             };
           });
@@ -116,6 +116,10 @@ async function parseBlockAsset(opts) {
       }
     ]
   });
+  try {
+    await deferrer;
+  } catch {
+  }
   return result;
 }
 var block_default = parseBlockAsset;

package/dist/client/pages/404.js

@@ -1,2 +1,2 @@
 // allow customize 404 via theme slots
-export { default } from 'dumi/theme/slots/NotFound';
+export { default } from "dumi/theme/slots/NotFound";

package/dist/client/pages/{Demo.d.ts → Demo/index.d.ts}

@@ -1,3 +1,4 @@
 import { type FC } from 'react';
+import './index.less';
 declare const DemoRenderPage: FC;
 export default DemoRenderPage;

package/dist/client/pages/{Demo.js → Demo/index.js}

@@ -1,5 +1,6 @@
 import { useParams, useSiteData } from 'dumi';
 import { createElement } from 'react';
+import "./index.less";
 
 var DemoRenderPage = function DemoRenderPage() {
   var _useParams = useParams(),

package/dist/client/pages/Demo/index.less

@@ -0,0 +1,4 @@
+body {
+  margin: 0;
+  padding: 0;
+}

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

@@ -2,8 +2,24 @@ function _extends() { _extends = Object.assign ? Object.assign.bind() : function
 
 import { SP_ROUTE_PREFIX } from "../../constants";
 import { useSiteData } from 'dumi';
-import Previewer from 'dumi/theme/builtins/Previewer';
+import Container from "dumi/theme/builtins/Container";
+import Previewer from "dumi/theme/builtins/Previewer";
 import React, { createElement } from 'react';
+import { ErrorBoundary } from 'react-error-boundary';
+
+var DemoErrorBoundary = function DemoErrorBoundary(props) {
+  return /*#__PURE__*/React.createElement(ErrorBoundary, {
+    fallbackRender: function fallbackRender(_ref) {
+      var error = _ref.error;
+      return /*#__PURE__*/React.createElement(Container, {
+        type: "error"
+      }, /*#__PURE__*/React.createElement("p", null, /*#__PURE__*/React.createElement("strong", null, error.message || 'This demo has been crashed.')), error.stack && /*#__PURE__*/React.createElement("p", null, /*#__PURE__*/React.createElement("details", {
+        open: true
+      }, /*#__PURE__*/React.createElement("summary", null, "Error stack"), /*#__PURE__*/React.createElement("pre", null, error.stack))));
+    }
+  }, props.children);
+};
+
 export var DumiDemo = function DumiDemo(props) {
   var _useSiteData = useSiteData(),
       demos = _useSiteData.demos;
@@ -11,10 +27,14 @@ export var DumiDemo = function DumiDemo(props) {
   var _demos$props$demo$id = demos[props.demo.id],
       component = _demos$props$demo$id.component,
       asset = _demos$props$demo$id.asset;
-  if (props.demo.inline) return /*#__PURE__*/createElement(component);
+
+  if (props.demo.inline) {
+    return /*#__PURE__*/React.createElement(DemoErrorBoundary, null, /*#__PURE__*/createElement(component));
+  }
+
   return /*#__PURE__*/React.createElement(Previewer, _extends({
     asset: asset,
     demoUrl: // allow user override demoUrl by frontmatter
     props.previewerProps.demoUrl || "/".concat(SP_ROUTE_PREFIX, "demos/").concat(props.demo.id)
-  }, props.previewerProps), /*#__PURE__*/createElement(component));
+  }, props.previewerProps), props.previewerProps.iframe ? null : /*#__PURE__*/React.createElement(DemoErrorBoundary, null, /*#__PURE__*/createElement(component)));
 };

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

@@ -11,13 +11,12 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
 import { useLocation, useRouteMeta, useSiteData } from 'dumi';
-import ContentTabs from 'dumi/theme/slots/ContentTabs';
+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,
-      pathname = _useLocation.pathname;
+      hash = _useLocation.hash;
 
   var _useRouteMeta = useRouteMeta(),
       tabs = _useRouteMeta.tabs;
@@ -47,13 +46,11 @@ export var DumiPage = function DumiPage(props) {
 
   useEffect(function () {
     var id = hash.replace('#', '');
-    var elm = id && document.getElementById(id);
-    if (elm) elm.scrollIntoView();
-  }, [hash]); // handle pathname change
-
-  useEffect(function () {
-    document.documentElement.scrollTo(0, 0);
-  }, [pathname]);
+    setTimeout(function () {
+      var elm = id && document.getElementById(decodeURIComponent(id));
+      if (elm) document.documentElement.scrollTo(0, elm.offsetTop - 80);
+    }, 1);
+  }, [hash]);
   return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(ContentTabs, {
     tabs: tabs,
     tabKey: tabKey,

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

@@ -86,6 +86,10 @@ export interface IRouteMeta {
         id: string;
         depth: number;
         title: string;
+        /**
+         * private field, will be removed in the future
+         */
+        _debug_demo?: boolean;
     }[];
     texts: {
         type?: 'content';
@@ -127,10 +131,11 @@ export declare type ILocalesConfig = ILocale[];
 export interface INavItem {
     title: string;
     link: string;
+    order: number;
     activePath?: string;
     [key: string]: any;
 }
-interface ISidebarItem {
+export interface ISidebarItem {
     title: string;
     link: string;
     order: number;

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

@@ -1,5 +1,3 @@
-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."); }
@@ -14,7 +12,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
 import { useFullSidebarData, useSiteData } from 'dumi';
 import { useState } from 'react';
-import { useLocaleDocRoutes } from "./utils";
+import { pickRouteSortMeta, useLocaleDocRoutes, useRouteDataComparer } from "./utils";
 /**
  * hook for get nav data
  */
@@ -26,6 +24,7 @@ export var useNavData = function useNavData() {
       themeConfig = _useSiteData.themeConfig;
 
   var sidebar = useFullSidebarData();
+  var sidebarDataComparer = useRouteDataComparer();
 
   var _useState = useState(function () {
     // use user config first
@@ -37,22 +36,9 @@ export var useNavData = function useNavData() {
           groups = _ref2[1];
 
       var meta = Object.values(routes).reduce(function (ret, route) {
-        var _route$meta, _frontmatter$nav$orde;
-
         // find routes which within the nav path
         if (route.path.startsWith(link.slice(1))) {
-          switch (_typeof((_route$meta = route.meta) === null || _route$meta === void 0 ? void 0 : _route$meta.frontmatter.nav)) {
-            case 'object':
-              ret.title = route.meta.frontmatter.nav.title || ret.title;
-              ret.order = (_frontmatter$nav$orde = route.meta.frontmatter.nav.order) !== null && _frontmatter$nav$orde !== void 0 ? _frontmatter$nav$orde : ret.order;
-              break;
-
-            case 'string':
-              ret.title = route.meta.frontmatter.nav || ret.title;
-              break;
-
-            default:
-          }
+          pickRouteSortMeta(ret, 'nav', route.meta.frontmatter);
         }
 
         return ret;
@@ -65,11 +51,7 @@ export var useNavData = function useNavData() {
       };
     }); // TODO: 2-level nav data
 
-    return data.sort(function (a, b) {
-      var _a$title;
-
-      return a.order - b.order || ((_a$title = a.title) === null || _a$title === void 0 ? void 0 : _a$title.localeCompare(b.title));
-    });
+    return data.sort(sidebarDataComparer);
   }),
       _useState2 = _slicedToArray(_useState, 1),
       nav = _useState2[0];

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

@@ -11,11 +11,12 @@ 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, useLayoutEffect, useState } from 'react';
-
+import { useCallback, useState } from 'react';
+import { useIsomorphicLayoutEffect } from "./utils";
 /**
  * hook for get matched route meta
  */
+
 export var useRouteMeta = function useRouteMeta() {
   var _useRouteData = useRouteData(),
       route = _useRouteData.route;
@@ -52,7 +53,7 @@ export var useRouteMeta = function useRouteMeta() {
       meta = _useState2[0],
       setMeta = _useState2[1];
 
-  useLayoutEffect(function () {
+  useIsomorphicLayoutEffect(function () {
     setMeta(getter);
   }, [clientRoutes.length, pathname]);
   return meta;

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

@@ -3,7 +3,18 @@ import type { ISidebarGroup } from './types';
  * hook for get sidebar data for all nav
  */
 export declare const useFullSidebarData: () => Record<string, ISidebarGroup[]>;
+interface ITreeSidebarLeaf {
+    path: string;
+    title: string;
+    order: number;
+    children: (ITreeSidebarLeaf | ISidebarGroup)[];
+}
+/**
+ * hook for get full sidebar data in tree structure
+ */
+export declare const useTreeSidebarData: () => ITreeSidebarLeaf[];
 /**
  * hook for get sidebar data for current nav
  */
 export declare const useSidebarData: () => ISidebarGroup[];
+export {};

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

@@ -1,3 +1,11 @@
+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 _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."); }
@@ -6,8 +14,6 @@ function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symb
 
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 
-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."); }
@@ -22,7 +28,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
 import { useLocale, useLocation, useSiteData } from 'dumi';
 import { useState } from 'react';
-import { useLocaleDocRoutes } from "./utils";
+import { pickRouteSortMeta, useLocaleDocRoutes, useRouteDataComparer } from "./utils";
 var DEFAULT_GROUP_STUB_TITLE = '$default-group-title';
 
 var getLocaleClearPath = function getLocaleClearPath(routePath, locale) {
@@ -40,6 +46,8 @@ export var useFullSidebarData = function useFullSidebarData() {
   var _useSiteData = useSiteData(),
       themeConfig = _useSiteData.themeConfig;
 
+  var sidebarDataComparer = useRouteDataComparer();
+
   var _useState = useState(function () {
     // auto generate sidebar data from routes
     var data = Object.values(routes).reduce(function (ret, route) {
@@ -55,12 +63,11 @@ export var useFullSidebarData = function useFullSidebarData() {
         // en-US/a/b => /en-US/a
         var parentPath = "/".concat(route.path.replace(/\/[^/]+$/, ''));
 
-        var _ref = _typeof(route.meta.frontmatter.group) === 'object' ? route.meta.frontmatter.group : {
-          title: route.meta.frontmatter.group
-        },
-            title = _ref.title,
-            _ref$order = _ref.order,
-            order = _ref$order === void 0 ? 0 : _ref$order;
+        var _pickRouteSortMeta = pickRouteSortMeta({
+          order: 0
+        }, 'group', route.meta.frontmatter),
+            title = _pickRouteSortMeta.title,
+            order = _pickRouteSortMeta.order;
 
         var titleKey = title || DEFAULT_GROUP_STUB_TITLE; // create group data by nav path & group name
 
@@ -80,25 +87,15 @@ export var useFullSidebarData = function useFullSidebarData() {
       return ret;
     }, {}); // destruct sidebar data into sidebar config
 
-    var sidebarConfig = Object.entries(data).reduce(function (ret, _ref2) {
-      var _ref3 = _slicedToArray(_ref2, 2),
-          navPath = _ref3[0],
-          groups = _ref3[1];
-
-      ret[navPath] = Object.values(groups).sort(function (a, b) {
-        var _a$title;
+    var sidebarConfig = Object.entries(data).reduce(function (ret, _ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+          navPath = _ref2[0],
+          groups = _ref2[1];
 
-        return (// sort by group order
-          a.order - b.order || (a.title ? // sort by group title
-          (_a$title = a.title) === null || _a$title === void 0 ? void 0 : _a$title.localeCompare(b.title || '') : // put non-title group at the end
-          1)
-        );
-      }); // sort group children by order or title
+      ret[navPath] = Object.values(groups).sort(sidebarDataComparer); // sort group children by order or title
 
       ret[navPath].forEach(function (group) {
-        return group.children.sort(function (a, b) {
-          return a.order - b.order || a.title.localeCompare(b.title);
-        });
+        return group.children.sort(sidebarDataComparer);
       });
       return ret;
     }, {}); // allow user partial override
@@ -110,6 +107,106 @@ export var useFullSidebarData = function useFullSidebarData() {
 
   return sidebar;
 };
+
+function getLeafMeta(data) {
+  var leafMeta = {
+    order: 0,
+    title: ''
+  };
+
+  var _iterator = _createForOfIteratorHelper(data),
+      _step;
+
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var group = _step.value;
+
+      var _iterator2 = _createForOfIteratorHelper(group.children),
+          _step2;
+
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var item = _step2.value;
+
+          if ('frontmatter' in item) {
+            pickRouteSortMeta(leafMeta, 'nav', item.frontmatter);
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+
+  return leafMeta;
+}
+/**
+ * hook for get full sidebar data in tree structure
+ */
+
+
+export var useTreeSidebarData = function useTreeSidebarData() {
+  var original = useFullSidebarData();
+  var sidebarDataComparer = useRouteDataComparer();
+
+  var _useState3 = useState(function () {
+    var data = Object.entries(original) // match from the deepest level
+    .sort(function (a, b) {
+      return b[0].split('/').length - a[0].split('/').length;
+    }).reduce(function (ret, _ref3) {
+      var _ref4 = _slicedToArray(_ref3, 2),
+          path = _ref4[0],
+          data = _ref4[1];
+
+      var parent = path.replace(/\/[^/]+$/, '');
+
+      if (parent) {
+        var _ret$parent;
+
+        // handle nested sidebar data
+        // init parent first
+        (_ret$parent = ret[parent]) !== null && _ret$parent !== void 0 ? _ret$parent : ret[parent] = _objectSpread({
+          path: parent,
+          children: original[parent] || []
+        }, getLeafMeta(original[parent] || []));
+
+        if (ret[path]) {
+          // sort children first
+          ret[path].children.sort(sidebarDataComparer); // put n-level sidebar data as parent children
+
+          ret[parent].children.push(ret[path]);
+          delete ret[path];
+        } else {
+          var _ret$parent$children;
+
+          // put last-level sidebar data as parent children
+          (_ret$parent$children = ret[parent].children).push.apply(_ret$parent$children, _toConsumableArray(data));
+        }
+      } else {
+        // sort children first
+        data.sort(sidebarDataComparer); // put top-level sidebar data
+
+        ret[path] = _objectSpread({
+          path: path,
+          children: data
+        }, getLeafMeta(data));
+      }
+
+      return ret;
+    }, {});
+    return Object.values(data);
+  }),
+      _useState4 = _slicedToArray(_useState3, 1),
+      sidebar = _useState4[0];
+
+  return sidebar;
+};
 /**
  * hook for get sidebar data for current nav
  */

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

@@ -1,4 +1,5 @@
-import type { IRoutesById } from './types';
+import { useEffect } from 'react';
+import type { INavItem, IRouteMeta, IRoutesById } from './types';
 export declare const useLocaleDocRoutes: () => IRoutesById;
 /**
  * 在 react 18 中需要新的 render 方式，这个函数用来处理不同的 jsx 模式。
@@ -6,3 +7,17 @@ export declare const useLocaleDocRoutes: () => IRoutesById;
  * @returns code string
  */
 export declare const genReactRenderCode: (version: string) => string;
+export declare const useIsomorphicLayoutEffect: typeof useEffect;
+/**
+ * common comparer for sidebar/nav items
+ */
+export declare const useRouteDataComparer: <T extends {
+    order?: number | undefined;
+    link?: string | undefined;
+    path?: string | undefined;
+    title?: string | undefined;
+}>() => (a: T, b: T) => number;
+/**
+ * common util for pick meta to sort sidebar/nav items
+ */
+export declare const pickRouteSortMeta: (original: Partial<Pick<INavItem, 'order' | 'title'>>, field: 'nav' | 'group', fm: IRouteMeta['frontmatter']) => Partial<Pick<INavItem, "title" | "order">>;

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

@@ -1,3 +1,5 @@
+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."); }
@@ -11,7 +13,8 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
 import { useAppData, useIntl, useSiteData } from 'dumi';
-import { useState } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useState } from 'react';
+import { useLocale } from "./useLocale";
 export var useLocaleDocRoutes = function useLocaleDocRoutes() {
   var intl = useIntl();
 
@@ -55,5 +58,45 @@ export var genReactRenderCode = function genReactRenderCode(version) {
     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);");
+  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)
+      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 = 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;
 };

package/dist/features/assets.d.ts

@@ -5,6 +5,10 @@ declare const examples: ExampleAsset[];
  * internal function to add example assets
  */
 export declare function addExampleAssets(data: typeof examples): void;
+/**
+ * internal function to get atom assets
+ */
+export declare function getExampleAssets(): ExampleAsset[];
 /**
  * internal function to add meta for atom
  */

package/dist/features/assets.js

@@ -24,7 +24,8 @@ var assets_exports = {};
 __export(assets_exports, {
   addAtomMeta: () => addAtomMeta,
   addExampleAssets: () => addExampleAssets,
-  default: () => assets_default
+  default: () => assets_default,
+  getExampleAssets: () => getExampleAssets
 });
 module.exports = __toCommonJS(assets_exports);
 var import_fs = __toESM(require("fs"));
@@ -35,6 +36,9 @@ var atomsMeta = {};
 function addExampleAssets(data) {
   examples.push(...data);
 }
+function getExampleAssets() {
+  return examples;
+}
 function addAtomMeta(atomId, data) {
   atomsMeta[atomId] = import_plugin_utils.lodash.pick(data, ["title", "keywords", "deprecated"]);
 }
@@ -69,5 +73,6 @@ var assets_default = (api) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   addAtomMeta,
-  addExampleAssets
+  addExampleAssets,
+  getExampleAssets
 });

package/dist/features/compile/babelLoaderCustomize.d.ts

@@ -0,0 +1,4 @@
+import type { PartialConfig } from '@umijs/bundler-utils/compiled/@babel/core';
+export default function babelLoaderCustomize(): {
+    config(config: PartialConfig): import("@umijs/bundler-utils/compiled/@babel/core").TransformOptions;
+};

package/dist/features/compile/babelLoaderCustomize.js

@@ -0,0 +1,37 @@
+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/compile/babelLoaderCustomize.ts
+var babelLoaderCustomize_exports = {};
+__export(babelLoaderCustomize_exports, {
+  default: () => babelLoaderCustomize
+});
+module.exports = __toCommonJS(babelLoaderCustomize_exports);
+function babelLoaderCustomize() {
+  return {
+    config(config) {
+      const context = this;
+      if (config.options.filename && context.resourceQuery.includes("type=meta")) {
+        config.options.filename += context.resourceQuery;
+      }
+      return config.options;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {});

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

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