zzz-pc-view 0.0.51 → 0.0.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zzz-pc-view",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "main": "src/index.umd.js",
   "module": "src/index.es.js",
   "types": "src/index.d.ts",

package/src/index.es.js

@@ -2152,20 +2152,20 @@ class WebSocketManager {
   }
 }
 var ZNavTypeEnum = /* @__PURE__ */ ((ZNavTypeEnum2) => {
-  ZNavTypeEnum2[ZNavTypeEnum2["Folder"] = 1] = "Folder";
+  ZNavTypeEnum2[ZNavTypeEnum2["FOLDER"] = 1] = "FOLDER";
   ZNavTypeEnum2[ZNavTypeEnum2["MENU"] = 2] = "MENU";
   ZNavTypeEnum2[ZNavTypeEnum2["BUTTON"] = 3] = "BUTTON";
   return ZNavTypeEnum2;
 })(ZNavTypeEnum || {});
 class ZBaseNav extends WithPrototype {
 }
-class ZNavDir extends ZBaseNav {
+class ZNavFolder extends ZBaseNav {
   constructor() {
     super(...arguments);
     /**
-     * 导航目录的类型，固定为 ZNavTypeEnum.Folder
+     * 导航目录的类型，固定为 ZNavTypeEnum.FOLDER
      * @readonly
-     * @type {ZNavTypeEnum.Folder}
+     * @type {ZNavTypeEnum.FOLDER}
      */
     __publicField(this, "type", 1);
   }
@@ -2204,7 +2204,7 @@ class ZNavButton extends ZBaseNav {
   }
 }
 const getNavsCategory = (navs, pageViewMap) => {
-  const navDirs = [];
+  const navFolders = [];
   const navMenus = [];
   const navLinks = [];
   const navButtons = [];
@@ -2213,7 +2213,7 @@ const getNavsCategory = (navs, pageViewMap) => {
     const nav = navs[i];
     switch (nav.type) {
       case 1:
-        navDirs.push(ZNavDir.bindObject(nav));
+        navFolders.push(ZNavFolder.bindObject(nav));
         break;
       case 2:
         const { name } = nav;
@@ -2231,7 +2231,7 @@ const getNavsCategory = (navs, pageViewMap) => {
     }
   }
   return {
-    navDirs,
+    navFolders,
     navMenus: sort(navMenus, "orderNo"),
     navLinks,
     navButtons: sort(navButtons, "orderNo")
@@ -2389,11 +2389,34 @@ const setRoutes = (option) => {
   });
 };
 const navTreeRef = shallowRef(list$1);
-const navChildrenMapRef = shallowRef(object);
-const setNavTree = (navDirs, navMenus, navLinks) => {
+const navWithoutButtonsComputed = computed(() => toFlat(navTreeRef.value, "children"));
+const navWithoutButtonsMapComputed = computed(
+  () => toKeyValue(navWithoutButtonsComputed.value, "id")
+);
+const navFoldersComputed = computed(
+  () => navWithoutButtonsComputed.value.filter(
+    (nav) => nav.type === 1
+    /* FOLDER */
+  )
+);
+const navMenusComputed = computed(
+  () => navWithoutButtonsComputed.value.filter(
+    (nav) => nav.type === 2
+    /* MENU */
+  )
+);
+const navButtonsRef = shallowRef([]);
+const navMenuButtonMapComputed = computed(() => toKeyValues(navButtonsRef.value, "parentId"));
+const navsComputed = computed(() => [...navWithoutButtonsComputed.value, ...navButtonsRef.value]);
+const navMapComputed = computed(() => toKeyValue(navsComputed.value, "id"));
+const setMenuButtons = (navButtons) => {
+  const navWithoutButtonsMap = navWithoutButtonsMapComputed.value;
+  navButtonsRef.value = navButtons.filter((navButton) => navWithoutButtonsMap[navButton.parentId]);
+};
+const setNavTree = (navFolders, navMenus, navLinks) => {
   const buildList = navMenus.filter((navMenu) => !navMenu.isHide);
   buildList.push(...navLinks);
-  const navDirMap = toKeyValue(navDirs, "id");
+  const navFolderMap = toKeyValue(navFolders, "id");
   const childrenMap = {};
   const roots = [];
   for (let nav; nav = buildList.shift(); ) {
@@ -2402,7 +2425,7 @@ const setNavTree = (navDirs, navMenus, navLinks) => {
       roots.push(nav);
       continue;
     }
-    const parent = navDirMap[parentId];
+    const parent = navFolderMap[parentId];
     if (!parent) {
       continue;
     }
@@ -2417,11 +2440,6 @@ const setNavTree = (navDirs, navMenus, navLinks) => {
     childrenMap[key2] = sort(childrenMap[key2], "orderNo");
   }
   navTreeRef.value = sort(roots, "orderNo");
-  navChildrenMapRef.value = childrenMap;
-};
-const menuButtonMapRef = shallowRef({});
-const setMenuButtonMap = (navButtons) => {
-  menuButtonMapRef.value = toKeyValues(navButtons, "parentId");
 };
 const setNavs = (option) => {
   const pageViewMap = getComponentViewMap(option.pageViewMap);
@@ -2429,27 +2447,25 @@ const setNavs = (option) => {
   const { navMenus, navButtons } = navsCategory;
   setRoutes({
     RootPageView: option.RootPageView,
-    // 根页面视图
     navMenus,
-    // 导航菜单
     pageViewMap,
-    // 页面视图映射
     navButtons,
-    // 导航按钮
     NotFoundPageView: option.NotFoundPageView
-    // 404页面视图
   });
-  setNavTree(navsCategory.navDirs, navsCategory.navMenus, navsCategory.navLinks);
-  setMenuButtonMap(navButtons);
+  setNavTree(navsCategory.navFolders, navsCategory.navMenus, navsCategory.navLinks);
+  setMenuButtons(navButtons);
 };
 const clear = (option) => {
   navTreeRef.value = list$1;
-  navChildrenMapRef.value = object;
+  navButtonsRef.value = list$1;
   if (option) {
     const { path } = option;
     router.addRoute({
+      // 根路由的名称
       name: ROOT_ROUTE_NAME,
+      // 根路由的路径
       path,
+      // 根路由对应的组件
       component: option.PageView
     });
     router.replace(path).then(() => {
@@ -2467,7 +2483,7 @@ const currentRootNavComputed = computed(() => {
   if (raw instanceof ZNavMenu && navTree.includes(raw)) {
     return;
   }
-  let navDir = void 0;
+  let navFolder = void 0;
   const navTreeLen = navTree.length;
   for (let i = 0; i < navTreeLen; i++) {
     const nav = navTree[i];
@@ -2478,12 +2494,12 @@ const currentRootNavComputed = computed(() => {
         (nav2) => nav2 === raw
       );
       if (navMenu) {
-        navDir = nav;
+        navFolder = nav;
         break;
       }
     }
   }
-  return navDir;
+  return navFolder;
 });
 const response = {
   /**
@@ -2518,25 +2534,57 @@ const response = {
     return navTreeRef.value;
   },
   /**
-   * 获取菜单按钮映射的 getter 方法。
-   * 返回一个包含所有菜单按钮的映射对象，其中键为父级导航项的 ID，值为该父级导航项下的按钮数组。
-   * @returns {Record<ZBaseNav['id'], ZNavButton[]>} - 菜单按钮映射对象
+   * 获取包含所有导航项的数组的 getter 方法。
+   * 该方法返回 `navsComputed` 计算属性的值，包含所有的导航项，方便统一处理导航项。
+   * @returns {ZNav[]} - 包含所有导航项的数组。
    */
-  get menuButtonMap() {
-    return menuButtonMapRef.value;
+  get navs() {
+    return navsComputed.value;
   },
   /**
-   * 获取导航目录的子导航项映射的 getter 方法。
-   * @type {Function}
-   * @returns {Record<ZNavDir['id'], ZNavWithoutButton[]>} - 导航目录的子导航项映射。
+   * 获取导航项 ID 到导航项对象的映射的 getter 方法。
+   * 该方法返回 `navMapComputed` 计算属性的值，键为导航项的 ID，值为对应的导航项对象，方便通过 ID 快速查找导航项。
+   * @returns {Record<ZNav['id'], ZNav>} - 导航项 ID 到导航项对象的映射。
+   */
+  get navMap() {
+    return navMapComputed.value;
+  },
+  /**
+   * 获取导航目录项数组的 getter 方法。
+   * 该方法返回 `navFoldersComputed` 计算属性的值，包含所有的导航目录项。
+   * @returns {ZNavFolder[]} - 导航目录项数组。
+   */
+  get navFolders() {
+    return navFoldersComputed.value;
+  },
+  /**
+   * 获取导航菜单项数组的 getter 方法。
+   * 该方法返回 `navMenusComputed` 计算属性的值，包含所有的导航菜单项。
+   * @returns {ZNavMenu[]} - 导航菜单项数组。
+   */
+  get navMenus() {
+    return navMenusComputed.value;
+  },
+  /**
+   * 获取导航按钮项数组的 getter 方法。
+   * 该方法返回 `navButtonsRef` 浅引用的值，包含所有的导航按钮项。
+   * @returns {ZNavButton[]} - 导航按钮项数组。
+   */
+  get navButtons() {
+    return navButtonsRef.value;
+  },
+  /**
+   * 获取父级导航项 ID 到导航按钮项数组的映射的 getter 方法。
+   * 该方法返回 `navMenuButtonMapComputed` 计算属性的值，键为父级导航项的 ID，值为该父级导航项下的导航按钮项数组，方便通过父级导航项 ID 快速查找对应的导航按钮项。
+   * @returns {Record<ZNavButton['parentId'], ZNavButton[]>} - 父级导航项 ID 到导航按钮项数组的映射。
    */
-  get navChildrenMap() {
-    return navChildrenMapRef.value;
+  get navMenuButtonMap() {
+    return navMenuButtonMapComputed.value;
   },
   /**
    * 获取当前路由对应的根导航目录的 getter 方法。
    * 该属性返回一个计算属性 currentRootNavComputed 的值，用于获取与当前路由关联的根导航目录。
-   * @returns {ZNavDir | undefined} - 当前路由对应的根导航目录对象，如果找不到则返回 undefined。
+   * @returns {ZNavFolder | undefined} - 当前路由对应的根导航目录对象，如果找不到则返回 undefined。
    */
   get currentRouteNav() {
     return currentRootNavComputed.value;
@@ -2544,14 +2592,14 @@ const response = {
   /**
    * 设置当前路由到指定根导航目录的第一个菜单项。
    * 如果指定的根导航目录已经是当前根导航目录，则不进行任何操作。
-   * @param {ZNavDir} rootNavDir - 要设置的根导航目录对象。
+   * @param {ZNavFolder} rootNavFolder - 要设置的根导航目录对象。
    */
-  setRoute: (rootNavDir) => {
-    if (currentRootNavComputed.value === rootNavDir) {
+  setRoute: (rootNavFolder) => {
+    if (currentRootNavComputed.value === rootNavFolder) {
       return;
     }
     const firstNav = findLeafNode(
-      rootNavDir.children || [],
+      rootNavFolder.children || [],
       "children",
       (nav) => nav instanceof ZNavMenu
     );
@@ -2686,7 +2734,7 @@ const ZWebUtils = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePro
   ZBaseNav,
   ZBaseNavMenu,
   ZNavButton,
-  ZNavDir,
+  ZNavFolder,
   ZNavLink,
   ZNavMenu,
   ZNavTypeEnum,
@@ -11511,8 +11559,8 @@ const _sfc_main$4 = /* @__PURE__ */ defineComponent({
         return openBlock(), createElementBlock(Fragment, {
           key: nav.id
         }, [
-          nav.type === unref(ZWebUtils).ZNavTypeEnum.Folder ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
-            nav.type === unref(ZWebUtils).ZNavTypeEnum.Folder && _ctx.onlyShowRoot ? (openBlock(), createElementBlock("li", {
+          nav.type === unref(ZWebUtils).ZNavTypeEnum.FOLDER ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
+            nav.type === unref(ZWebUtils).ZNavTypeEnum.FOLDER && _ctx.onlyShowRoot ? (openBlock(), createElementBlock("li", {
               key: 0,
               tabindex: "0",
               class: normalizeClass(["flex center layout-nav-link el-menu-item", {