dumi
Version:
📖 Documentation Generator of React Component
132 lines (129 loc) • 9.1 kB
JavaScript
function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
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 _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(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
import { useFullSidebarData, useLocale, useSiteData } from 'dumi';
import { useState } from 'react';
import { getLocaleClearPath, getRouteParentPath } from "./useSidebarData";
import { getLocaleNav, pickRouteSortMeta, useLocaleDocRoutes, useRouteDataComparer } from "./utils";
function genNavItem(meta, groups, activePath, link) {
return _objectSpread({
title: meta.title || groups[0].title || groups[0].children[0].title,
order: meta.order || 0,
activePath: activePath
}, link ? {
link: link
} : {});
}
/**
* hook for get nav data
*/
export var useNavData = function useNavData() {
var locale = useLocale();
var routes = useLocaleDocRoutes();
var _useSiteData = useSiteData(),
themeConfig = _useSiteData.themeConfig,
is2LevelNav = _useSiteData._2_level_nav_available;
var sidebar = useFullSidebarData();
var sidebarDataComparer = useRouteDataComparer();
var _useState = useState(function () {
// use user config first
var userNavValue = [];
var mode;
if (themeConfig.nav) {
// 形如：{mode: "append", value: []}
if ('mode' in themeConfig.nav && typeof themeConfig.nav.mode === 'string') {
mode = themeConfig.nav.mode;
userNavValue = getLocaleNav(themeConfig.nav.value, locale);
} else if (!('mode' in themeConfig.nav)) {
// 形如：[] 或 {"zh-CN": []}
userNavValue = getLocaleNav(themeConfig.nav, locale);
}
if (!mode || mode === 'override') return userNavValue;
}
// fallback to generate nav data from sidebar data
var data = Object.values(Object.entries(sidebar)
// make sure shallow nav item before deep
.sort(function (_ref, _ref2) {
var _ref3 = _slicedToArray(_ref, 1),
a = _ref3[0];
var _ref4 = _slicedToArray(_ref2, 1),
b = _ref4[0];
return a.split('/').length - b.split('/').length;
})
// convert sidebar data to nav data
.reduce(function (ret, _ref5) {
var _ref6 = _slicedToArray(_ref5, 2),
link = _ref6[0],
groups = _ref6[1];
var clearPath = getLocaleClearPath(link.replace(/^\//, ''), locale);
var parentPath = link.replace(clearPath, function (s) {
return getRouteParentPath(s, {
is2LevelNav: is2LevelNav,
locale: locale
});
});
var isNestedNav = link.length > parentPath.length && is2LevelNav;
var _Object$values$reduce = Object.values(routes).reduce(function (ret, route) {
// find routes which within the nav path
if (route.path.startsWith(link.slice(1))) {
pickRouteSortMeta(ret[0], 'nav', route.meta.frontmatter);
// generate parent meta for nested nav
if (isNestedNav) pickRouteSortMeta(ret[1], 'nav.second', route.meta.frontmatter);
}
return ret;
}, [{}, {}]),
_Object$values$reduce2 = _slicedToArray(_Object$values$reduce, 2),
firstMeta = _Object$values$reduce2[0],
secondMeta = _Object$values$reduce2[1];
if (isNestedNav) {
var _firstMeta$title, _ret$parentPath, _second$children;
// fallback to use parent path as 1-level nav title
(_firstMeta$title = firstMeta.title) !== null && _firstMeta$title !== void 0 ? _firstMeta$title : firstMeta.title = parentPath.split('/').pop().replace(/^[a-z]/, function (s) {
return s.toUpperCase();
});
// handle nested nav item as parent children
var second = (_ret$parentPath = ret[parentPath]) !== null && _ret$parentPath !== void 0 ? _ret$parentPath : ret[parentPath] = genNavItem(firstMeta, groups, parentPath);
(_second$children = second.children) !== null && _second$children !== void 0 ? _second$children : second.children = [];
second.children.push(genNavItem(secondMeta, groups, link, groups[0].children[0].link));
} else {
// handle root nav item
ret[link] = genNavItem(firstMeta, groups, link, groups[0].children[0].link);
}
return ret;
}, {}));
data.forEach(function (item, i) {
var _item$children;
// item.link => the parent link is not in routes, but has children, will use parent.title or children.title
if (!item.link && ((_item$children = item.children) === null || _item$children === void 0 ? void 0 : _item$children.length) === 1) {
// hoist nav item if only one child
var first = item.children[0];
data[i] = _objectSpread(_objectSpread({}, first), {}, {
title: (item === null || item === void 0 ? void 0 : item.title) || first.title
});
} else if (item.children) {
// sort nav item children by order or title
item.children.sort(sidebarDataComparer);
}
});
// sort nav items by order or title
data.sort(sidebarDataComparer);
if (mode === 'prepend') data.unshift.apply(data, _toConsumableArray(userNavValue));else if (mode === 'append') data.push.apply(data, _toConsumableArray(userNavValue));
return data;
}),
_useState2 = _slicedToArray(_useState, 1),
nav = _useState2[0];
return nav;
};