dumi 2.0.0-alpha.2 → 2.0.0-alpha.4

package/dist/client/pages/404.d.ts

@@ -0,0 +1 @@
+export { default } from 'dumi/theme/slots/NotFound';

package/dist/client/pages/404.js

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

package/dist/client/pages/Demo.d.ts

@@ -0,0 +1,3 @@
+import { type FC } from 'react';
+declare const DemoRenderPage: FC;
+export default DemoRenderPage;

package/dist/client/pages/Demo.js

@@ -0,0 +1,17 @@
+import { useParams, useSiteData } from 'dumi';
+import { createElement } from 'react';
+
+var DemoRenderPage = function DemoRenderPage() {
+  var _useParams = useParams(),
+      id = _useParams.id;
+
+  var _useSiteData = useSiteData(),
+      demos = _useSiteData.demos;
+
+  var _ref = demos[id] || {},
+      component = _ref.component;
+
+  return component && /*#__PURE__*/createElement(component);
+};
+
+export default DemoRenderPage;

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

@@ -1,16 +1,19 @@
 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); }
 
+import { SP_ROUTE_PREFIX } from "../../constants";
+import { useSiteData } from 'dumi';
 import Previewer from 'dumi/theme/builtins/Previewer';
-import React, { createElement, useContext } from 'react';
-import { Context } from "./context";
+import React, { createElement } from 'react';
 export var DumiDemo = function DumiDemo(props) {
-  var _useContext = useContext(Context),
-      demos = _useContext.demos;
+  var _useSiteData = useSiteData(),
+      demos = _useSiteData.demos;
 
   var _demos$props$demo$id = demos[props.demo.id],
       component = _demos$props$demo$id.component,
       asset = _demos$props$demo$id.asset;
   return /*#__PURE__*/React.createElement(Previewer, _extends({
-    asset: asset
+    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));
 };

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

@@ -1,5 +1,5 @@
 import { type FC } from 'react';
-import { IDumiDemoProps } from './DumiDemo';
+import type { IDumiDemoProps } from './DumiDemo';
 export interface IDumiDemoGridProps {
     items: IDumiDemoProps[];
 }

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

@@ -12,20 +12,20 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
-import { useMatchedRouteMeta } from 'dumi/theme';
+import { DumiDemo, useRouteMeta } from 'dumi';
 import React, { useState } from 'react';
-import { DumiDemo } from "./DumiDemo";
 export var DumiDemoGrid = function DumiDemoGrid(props) {
-  var meta = useMatchedRouteMeta();
+  var _useRouteMeta = useRouteMeta(),
+      fm = _useRouteMeta.frontmatter;
 
   var _useState = useState(function () {
-    var _meta$demo;
+    var _fm$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) {
+    if ((_fm$demo = fm.demo) !== null && _fm$demo !== void 0 && _fm$demo.cols && fm.demo.cols > 1) {
+      for (var i = 0; i < props.items.length; i += fm.demo.cols) {
+        props.items.slice(i, i + fm.demo.cols).forEach(function (item, j) {
           var _cols$j;
 
           (_cols$j = cols[j]) !== null && _cols$j !== void 0 ? _cols$j : cols[j] = [];
@@ -47,7 +47,8 @@ export var DumiDemoGrid = function DumiDemoGrid(props) {
     style: {
       display: 'flex',
       margin: -8
-    }
+    },
+    "data-dumi-demo-grid": true
   }, cols.map(function (col, i) {
     return /*#__PURE__*/React.createElement("section", {
       style: {

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

@@ -1,10 +1,13 @@
 import { type ComponentType } from 'react';
-import type { ILocalesConfig, IPreviewerProps } from './types';
-export interface IThemeContext {
+import type { ILocalesConfig, IPreviewerProps, IThemeConfig } from './types';
+interface ISiteContext {
     demos: Record<string, {
         component: ComponentType;
         asset: IPreviewerProps['asset'];
     }>;
-    locales: ILocalesConfig;
+    locales: NonNullable<ILocalesConfig>;
+    themeConfig: IThemeConfig;
 }
-export declare const Context: import("react").Context<IThemeContext>;
+export declare const SiteContext: import("react").Context<ISiteContext>;
+export declare const useSiteData: () => ISiteContext;
+export {};

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

@@ -1,5 +1,9 @@
-import { createContext } from 'react';
-export var Context = /*#__PURE__*/createContext({
+import { createContext, useContext } from 'react';
+export var SiteContext = /*#__PURE__*/createContext({
   demos: {},
-  locales: []
-});
+  locales: [],
+  themeConfig: {}
+});
+export var useSiteData = function useSiteData() {
+  return useContext(SiteContext);
+};

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

@@ -1,6 +1,9 @@
 export { useIntl } from 'react-intl';
-export * from './context';
-export * from './DumiDemo';
-export * from './DumiDemoGrid';
-export * from './types';
-export * from './useMatchedRouteMeta';
+export { useSiteData } from './context';
+export { DumiDemo } from './DumiDemo';
+export { DumiDemoGrid } from './DumiDemoGrid';
+export type { IPreviewerProps } from './types';
+export { useLocale } from './useLocale';
+export { useNavData } from './useNavData';
+export { useRouteMeta } from './useRouteMeta';
+export { useFullSidebarData, useSidebarData } from './useSidebarData';

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

@@ -1,6 +1,8 @@
 export { useIntl } from 'react-intl';
-export * from "./context";
-export * from "./DumiDemo";
-export * from "./DumiDemoGrid";
-export * from "./types";
-export * from "./useMatchedRouteMeta";
+export { useSiteData } from "./context";
+export { DumiDemo } from "./DumiDemo";
+export { DumiDemoGrid } from "./DumiDemoGrid";
+export { useLocale } from "./useLocale";
+export { useNavData } from "./useNavData";
+export { useRouteMeta } from "./useRouteMeta";
+export { useFullSidebarData, useSidebarData } from "./useSidebarData";

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

@@ -13,6 +13,26 @@ export interface IPreviewerProps {
      * file path of current demo
      */
     filePath?: string;
+    /**
+     * use iframe to render demo
+     */
+    iframe?: boolean | number;
+    /**
+     * debug mark (will only render in dev by default)
+     */
+    debug?: boolean;
+    /**
+     * disable demo content padding
+     */
+    compact?: boolean;
+    /**
+     * add transform property for handle absolute/fixed position element
+     */
+    transform?: boolean;
+    /**
+     * background color for demo content
+     */
+    background?: string;
     /**
      * asset metadata of current demo
      */
@@ -24,15 +44,30 @@ export interface IPreviewerProps {
     [key: string]: any;
 }
 export interface IRouteMeta {
-    title?: string;
-    description?: string;
-    keywords?: string[];
-    category?: string;
-    order?: number;
-    toc?: boolean | 'content' | 'menu';
-    demo?: {
-        cols?: number;
+    frontmatter: {
+        title: string;
+        description?: string;
+        keywords?: string[];
+        nav?: string | {
+            title?: string;
+            order?: number;
+        };
+        group?: string | {
+            title?: string;
+            order?: number;
+        };
+        order?: number;
+        toc?: boolean | 'content' | 'menu';
+        demo?: {
+            cols?: number;
+            tocDepth?: number;
+        };
     };
+    toc: {
+        id: string;
+        depth: number;
+        title: string;
+    }[];
     [key: string]: any;
 }
 declare type IBasicLocale = {
@@ -40,8 +75,41 @@ declare type IBasicLocale = {
     name: string;
 };
 export declare type ILocalesConfig = ((IBasicLocale & {
-    base?: string;
+    base: string;
 }) | (IBasicLocale & {
     suffix: string;
 }))[];
+export interface INavItem {
+    title: string;
+    link: string;
+    activePath?: string;
+    [key: string]: any;
+}
+interface ISidebarItem {
+    title: string;
+    link: string;
+    [key: string]: any;
+}
+export interface ISidebarGroup {
+    title?: string;
+    children: ISidebarItem[];
+    [key: string]: any;
+}
+export interface IThemeConfig {
+    name?: string;
+    logo?: string;
+    nav?: (INavItem & {
+        children?: INavItem[];
+    })[];
+    sidebar?: Record<string, ISidebarGroup[]>;
+    [key: string]: any;
+}
+export declare type IRoutesById = Record<string, {
+    path?: string;
+    parentId?: string;
+    meta?: IRouteMeta;
+    id: string;
+    redirect?: string;
+    [key: string]: any;
+}>;
 export {};

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

@@ -0,0 +1 @@
+export declare const useLocale: () => any;

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

@@ -0,0 +1,31 @@
+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 { useIntl, useSiteData } from 'dumi';
+import { useState } from 'react';
+export var useLocale = function useLocale() {
+  var intl = useIntl();
+
+  var _useSiteData = useSiteData(),
+      locales = _useSiteData.locales;
+
+  var _useState = useState(function () {
+    return locales.find(function (_ref) {
+      var id = _ref.id;
+      return id === intl.locale;
+    });
+  }),
+      _useState2 = _slicedToArray(_useState, 1),
+      locale = _useState2[0];
+
+  return locale;
+};

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

@@ -0,0 +1,6 @@
+/**
+ * hook for get nav data
+ */
+export declare const useNavData: () => (import("./types").INavItem & {
+    children?: import("./types").INavItem[] | undefined;
+})[];

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

@@ -0,0 +1,78 @@
+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 _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { useFullSidebarData, useSiteData } from 'dumi';
+import { useState } from 'react';
+import { useLocaleDocRoutes } from "./utils";
+/**
+ * hook for get nav data
+ */
+
+export var useNavData = function useNavData() {
+  var routes = useLocaleDocRoutes();
+
+  var _useSiteData = useSiteData(),
+      themeConfig = _useSiteData.themeConfig;
+
+  var sidebar = useFullSidebarData();
+
+  var _useState = useState(function () {
+    // use user config first
+    if (themeConfig.nav) return themeConfig.nav; // fallback to generate nav data from sidebar data
+
+    var data = Object.entries(sidebar).map(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+          link = _ref2[0],
+          groups = _ref2[1];
+
+      var meta = Object.values(routes).reduce(function (ret, route) {
+        var _frontmatter$nav$orde;
+
+        // find routes which within the nav path
+        if (route.path.startsWith(link.slice(1))) {
+          switch (_typeof(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:
+          }
+        }
+
+        return ret;
+      }, {});
+      return {
+        title: meta.title || groups[0].title || groups[0].children[0].title,
+        order: meta.order || 0,
+        link: groups[0].children[0].link,
+        activePath: link
+      };
+    }); // 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));
+    });
+  }),
+      _useState2 = _slicedToArray(_useState, 1),
+      nav = _useState2[0];
+
+  return nav;
+};

package/dist/client/theme-api/{useMatchedRouteMeta.d.ts → useRouteMeta.d.ts}

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

package/dist/client/theme-api/{useMatchedRouteMeta.js → useRouteMeta.js}

@@ -16,7 +16,7 @@ import { useCallback, useEffect, useState } from 'react';
 /**
  * hook for get matched route meta
  */
-export var useMatchedRouteMeta = function useMatchedRouteMeta() {
+export var useRouteMeta = function useRouteMeta() {
   var _useRouteData = useRouteData(),
       route = _useRouteData.route;
 
@@ -29,7 +29,7 @@ export var useMatchedRouteMeta = function useMatchedRouteMeta() {
   var getter = useCallback(function () {
     var ret;
 
-    if (route.path === pathname) {
+    if (route.path === pathname && !('isLayout' in route)) {
       // use `useRouteData` result if matched, for performance
       ret = route.meta;
     } else {
@@ -40,7 +40,10 @@ export var useMatchedRouteMeta = function useMatchedRouteMeta() {
       ret = matched === null || matched === void 0 ? void 0 : (_matched$route = matched.route) === null || _matched$route === void 0 ? void 0 : _matched$route.meta;
     }
 
-    return ret || {};
+    return ret || {
+      frontmatter: {},
+      toc: []
+    };
   }, [clientRoutes.length, pathname]);
 
   var _useState = useState(getter),

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

@@ -0,0 +1,8 @@
+/**
+ * hook for get sidebar data for all nav
+ */
+export declare const useFullSidebarData: () => any;
+/**
+ * hook for get sidebar data for current nav
+ */
+export declare const useSidebarData: () => any;

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

@@ -0,0 +1,131 @@
+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 _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 _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 _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { useLocale, useLocation, useSiteData } from 'dumi';
+import { useState } from 'react';
+import { useLocaleDocRoutes } from "./utils";
+var DEFAULT_GROUP_STUB_TITLE = '$default-group-title';
+
+var getLocaleClearPath = function getLocaleClearPath(routePath, locale) {
+  return 'base' in locale ? routePath.replace(locale.base.slice(1), '').replace(/^\//, '') : routePath;
+};
+/**
+ * hook for get sidebar data for all nav
+ */
+
+
+export var useFullSidebarData = function useFullSidebarData() {
+  var locale = useLocale();
+  var routes = useLocaleDocRoutes();
+
+  var _useSiteData = useSiteData(),
+      themeConfig = _useSiteData.themeConfig;
+
+  var _useState = useState(function () {
+    // auto generate sidebar data from routes
+    var data = Object.values(routes).reduce(function (ret, route) {
+      var clearPath = getLocaleClearPath(route.path, locale); // skip index routes
+
+      if (clearPath && route.meta) {
+        var _ret$parentPath, _ret$parentPath$title, _ret$parentPath$title2;
+
+        // extract parent path from route path
+        // a => /a
+        // en-US/a => /en-US/a
+        // a/b => /a
+        // 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 titleKey = title || DEFAULT_GROUP_STUB_TITLE; // create group data by nav path & group name
+
+        (_ret$parentPath = ret[parentPath]) !== null && _ret$parentPath !== void 0 ? _ret$parentPath : ret[parentPath] = {};
+        ret[parentPath][titleKey] = {
+          title: title,
+          order: ((_ret$parentPath$title = ret[parentPath][titleKey]) === null || _ret$parentPath$title === void 0 ? void 0 : _ret$parentPath$title.order) || order,
+          children: [].concat(_toConsumableArray(((_ret$parentPath$title2 = ret[parentPath][titleKey]) === null || _ret$parentPath$title2 === void 0 ? void 0 : _ret$parentPath$title2.children) || []), [{
+            title: route.meta.frontmatter.title,
+            link: "/".concat(route.path),
+            order: route.meta.frontmatter.order || 0
+          }])
+        };
+      }
+
+      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;
+
+        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].forEach(function (group) {
+        return group.children.sort(function (a, b) {
+          return a.order - b.order || a.title.localeCompare(b.title);
+        });
+      });
+      return ret;
+    }, {}); // allow user partial override
+
+    return Object.assign(sidebarConfig, themeConfig.sidebar);
+  }),
+      _useState2 = _slicedToArray(_useState, 1),
+      sidebar = _useState2[0];
+
+  return sidebar;
+};
+/**
+ * hook for get sidebar data for current nav
+ */
+
+export var useSidebarData = function useSidebarData() {
+  var locale = useLocale();
+  var sidebar = useFullSidebarData();
+
+  var _useLocation = useLocation(),
+      pathname = _useLocation.pathname;
+
+  var clearPath = getLocaleClearPath(pathname.slice(1), locale); // extract parent path from location pathname
+  // /a => /a
+  // /a/b => /a
+  // /en-US/a => /en-US/a
+  // /en-US/a/b => /en-US/a
+
+  var parentPath = clearPath ? pathname.replace(/(\/[^/]+)(\/[^/]+)$/, '$1') : pathname;
+  return parentPath ? sidebar[parentPath] : [];
+};

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

@@ -0,0 +1,2 @@
+import type { IRoutesById } from './types';
+export declare const useLocaleDocRoutes: () => IRoutesById;

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

@@ -0,0 +1,44 @@
+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 { useAppData, useIntl, useSiteData } from 'dumi';
+import { useState } from 'react';
+export var useLocaleDocRoutes = function useLocaleDocRoutes() {
+  var intl = useIntl();
+
+  var _useAppData = useAppData(),
+      routes = _useAppData.routes;
+
+  var _useSiteData = useSiteData(),
+      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];
+
+  return localeDocRoutes;
+};

package/dist/client/tsconfig.json

@@ -7,6 +7,7 @@
       "dumi": ["src"],
       "dumi/theme": ["src/client/theme-api"],
       "dumi/theme/*": ["src/client/theme-default/*"]
-    }
+    },
+    "types": ["../../src/.umi/typings"]
   }
 }

package/dist/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const LOCAL_THEME_DIR = ".dumi/theme";
 export declare const THEME_PREFIX = "dumi-theme-";
+export declare const SP_ROUTE_PREFIX = "~";