@litianxiang/portal-core 0.1.11 → 0.1.13

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as vue_router from 'vue-router';
 import { RouteRecordRaw } from 'vue-router';
+import { Dayjs } from 'dayjs';
 
 interface AppRouterOptions {
     staticRoutes: RouteRecordRaw[];
@@ -121,5 +122,100 @@ interface MenuHelper {
     getBreadcrumb: (path: string) => BreadcrumbItem[];
 }
 declare function createMenuHelper(options: MenuHelperOptions): MenuHelper;
+/**
+ * 标准化后的菜单节点结构，供各前端站点复用
+ * 不依赖具体项目的 IMenu 类型
+ */
+interface CoreMenuItem {
+    id: string | number;
+    parent_id?: string | number | null;
+    category?: string;
+    name?: string;
+    path?: string;
+    icon?: string;
+    order_num?: number;
+    site?: string;
+    children?: CoreMenuItem[];
+}
+interface TransformMenuOptions {
+    /**
+     * 当后端未返回 site 字段时使用的默认站点标识
+     * 示例：manage、hr-kq 等
+     */
+    defaultSite?: string;
+}
+/**
+ * 将后端返回的原始菜单数据转换为前端通用的 CoreMenuItem 结构
+ * - 主要是结构统一与 children 递归转换
+ * - 是否从 snake_case 转 camelCase 由后端约定，这里只做字段透传
+ */
+declare function transformMenuTree(menuList: any[], options?: TransformMenuOptions): CoreMenuItem[];
+/**
+ * 生成包含完整 children 的菜单树（包括 page 下的按钮等）
+ * 一般用于：
+ * - 权限判断（页面 + 按钮）
+ * - 侧边菜单折叠前的完整数据源
+ */
+declare function buildAllMenuTree(menuList: CoreMenuItem[]): CoreMenuItem[];
+/**
+ * 从完整菜单树中裁剪出 page + button 列表结构
+ * - 去掉纯 module 节点
+ * - 常用于“页面+按钮权限”一体的菜单视图
+ */
+declare function buildPageMenuList(menuList: CoreMenuItem[]): CoreMenuItem[];
+/**
+ * 递归查找菜单树中的第一个 page 页面路径
+ * 常用于：登录后或进入某模块时，自动跳转到第一个页面
+ */
+declare function findFirstPagePath(menuList: CoreMenuItem[]): string | null;
+
+type TimeInput = string | number | Date | Dayjs;
+interface TimeRange<T = Dayjs> {
+    start: T;
+    end: T;
+}
+/**
+ * 标准时间格式化
+ */
+declare function formatTime(date: TimeInput, format?: string): string;
+/**
+ * 人性化相对时间（如：3分钟前）
+ */
+declare function humanizeTime(date: TimeInput): string;
+/**
+ * 计算时间差（毫秒）
+ */
+declare function timeDiff(start: TimeInput, end?: TimeInput): number;
+/**
+ * 将日期转换为月-日格式
+ */
+declare function formatToMonthDay(date: TimeInput): string;
+/**
+ * 生成日期区间对象（Dayjs）
+ */
+declare function createRange(start: TimeInput, end: TimeInput): TimeRange<Dayjs>;
+/**
+ * 将日期区间格式化为字符串：2026-02-01 ~ 2026-02-23
+ */
+declare function formatRange(start: TimeInput, end: TimeInput, format?: string): string;
+type PresetRangeKey = 'today' | 'yesterday' | 'last7days' | 'last30days' | 'thisMonth' | 'lastMonth';
+/**
+ * 获取常用日期区间（用于统计/筛选快捷选项）
+ */
+declare function getPresetRange(key: PresetRangeKey, now?: TimeInput): TimeRange<Dayjs>;
+/**
+ * 判断某个时间是否在区间内（含边界）
+ */
+declare function isInRange(value: TimeInput, range: TimeRange<TimeInput>): boolean;
+declare function useTime(): {
+    formatTime: typeof formatTime;
+    humanizeTime: typeof humanizeTime;
+    timeDiff: typeof timeDiff;
+    formatToMonthDay: typeof formatToMonthDay;
+    createRange: typeof createRange;
+    formatRange: typeof formatRange;
+    getPresetRange: typeof getPresetRange;
+    isInRange: typeof isInRange;
+};
 
-export { type AppRouterOptions, type BreadcrumbItem, type CreateAuthHttpClientOptions, type InactivityConfig, type InactivityResult, type LogoutToAuthOptions, type MenuHelper, type MenuHelperOptions, type PermissionHelper, type PermissionHelperOptions, calcInactivityAction, createAppRouter, createAuthHttpClient, createLogoutToAuth, createMenuHelper, createPermissionHelper };
+export { type AppRouterOptions, type BreadcrumbItem, type CoreMenuItem, type CreateAuthHttpClientOptions, type InactivityConfig, type InactivityResult, type LogoutToAuthOptions, type MenuHelper, type MenuHelperOptions, type PermissionHelper, type PermissionHelperOptions, type PresetRangeKey, type TimeInput, type TimeRange, type TransformMenuOptions, buildAllMenuTree, buildPageMenuList, calcInactivityAction, createAppRouter, createAuthHttpClient, createLogoutToAuth, createMenuHelper, createPermissionHelper, createRange, findFirstPagePath, formatRange, formatTime, formatToMonthDay, getPresetRange, humanizeTime, isInRange, timeDiff, transformMenuTree, useTime };

package/dist/index.js

@@ -1,4 +1,4 @@
-// src/router.ts
+// src/router/router.ts
 import { createRouter, createWebHashHistory } from "vue-router";
 function createAppRouter(options) {
   const { staticRoutes, getUserStore, getTabStore, getFirstPage, authLoginUrl } = options;
@@ -154,7 +154,7 @@ function createAppRouter(options) {
   return router;
 }
 
-// src/auth.ts
+// src/auth/auth.ts
 function createLogoutToAuth(options) {
   const {
     getUserStore,
@@ -223,7 +223,7 @@ function calcInactivityAction(lastActiveTime, now, config = {}) {
   };
 }
 
-// src/http.ts
+// src/http/http.ts
 function createAuthHttpClient(options) {
   const {
     axios,
@@ -371,7 +371,7 @@ function createAuthHttpClient(options) {
   return { http, logoutToAuth };
 }
 
-// src/permission.ts
+// src/permission/permission.ts
 function normalizePath(raw) {
   if (!raw) return "";
   const [base] = raw.split("?");
@@ -427,7 +427,7 @@ function createPermissionHelper(options) {
   };
 }
 
-// src/menu.ts
+// src/menu/menu.ts
 function normalizePath2(raw) {
   if (!raw) return "";
   const [base] = raw.split("?");
@@ -513,11 +513,204 @@ function createMenuHelper(options) {
     getBreadcrumb
   };
 }
+function transformMenuTree(menuList, options) {
+  const defaultSite = options?.defaultSite;
+  return (menuList || []).map((item) => {
+    const children = Array.isArray(item?.children) ? transformMenuTree(item.children, options) : void 0;
+    return {
+      id: item?.id,
+      parent_id: item?.parent_id ?? null,
+      category: item?.category,
+      name: item?.name,
+      path: item?.path,
+      icon: item?.icon,
+      order_num: item?.order_num,
+      site: item?.site ?? defaultSite,
+      children
+    };
+  });
+}
+function buildAllMenuTree(menuList) {
+  const result = [];
+  for (const item of menuList || []) {
+    result.push({
+      id: item.id,
+      parent_id: item.parent_id ?? null,
+      category: item.category,
+      name: item.name,
+      path: item.path,
+      icon: item.icon,
+      order_num: item.order_num,
+      site: item.site,
+      children: item.children && item.children.length > 0 ? buildAllMenuTree(item.children) : []
+    });
+  }
+  return result;
+}
+function buildPageMenuList(menuList) {
+  const pages = [];
+  for (const item of menuList || []) {
+    if (item.category !== "module") {
+      pages.push({
+        id: item.id,
+        parent_id: item.parent_id ?? null,
+        category: item.category,
+        name: item.name,
+        path: item.path,
+        icon: item.icon,
+        order_num: item.order_num,
+        site: item.site,
+        children: item.children ? buildPageMenuList(item.children) : []
+      });
+    } else if (item.children && item.children.length > 0) {
+      const childMenus = buildPageMenuList(item.children);
+      if (childMenus.length > 0) {
+        for (const child of childMenus) {
+          pages.push({
+            id: child.id,
+            parent_id: child.parent_id ?? null,
+            category: child.category,
+            name: child.name,
+            path: child.path,
+            icon: child.icon,
+            order_num: child.order_num,
+            site: child.site,
+            children: child.children
+          });
+        }
+      }
+    }
+  }
+  return pages;
+}
+function findFirstPagePath(menuList) {
+  for (const item of menuList || []) {
+    if (item.category === "page" && item.path) {
+      return item.path;
+    }
+    if (item.children && item.children.length > 0) {
+      const childFirst = findFirstPagePath(item.children);
+      if (childFirst) return childFirst;
+    }
+  }
+  return null;
+}
+
+// src/time/time.ts
+import dayjs from "dayjs";
+import relativeTime from "dayjs/plugin/relativeTime";
+import isSameOrAfter from "dayjs/plugin/isSameOrAfter";
+import isSameOrBefore from "dayjs/plugin/isSameOrBefore";
+import "dayjs/locale/zh-cn";
+dayjs.extend(relativeTime);
+dayjs.extend(isSameOrAfter);
+dayjs.extend(isSameOrBefore);
+dayjs.locale("zh-cn");
+function formatTime(date, format = "YYYY-MM-DD HH:mm:ss") {
+  const d = dayjs(date);
+  if (!d.isValid()) return "";
+  return d.format(format);
+}
+function humanizeTime(date) {
+  return dayjs(date).fromNow();
+}
+function timeDiff(start, end = Date.now()) {
+  return dayjs(end).diff(dayjs(start));
+}
+function formatToMonthDay(date) {
+  const d = dayjs(date);
+  if (!d.isValid()) return "";
+  return d.format("MM-DD");
+}
+function createRange(start, end) {
+  const s = dayjs(start);
+  const e = dayjs(end);
+  return s.isBefore(e) ? { start: s, end: e } : { start: e, end: s };
+}
+function formatRange(start, end, format = "YYYY-MM-DD") {
+  const { start: s, end: e } = createRange(start, end);
+  if (!s.isValid() || !e.isValid()) return "";
+  return `${s.format(format)} ~ ${e.format(format)}`;
+}
+function getPresetRange(key, now = dayjs()) {
+  const base = dayjs(now);
+  switch (key) {
+    case "today": {
+      const start = base.startOf("day");
+      const end = base.endOf("day");
+      return { start, end };
+    }
+    case "yesterday": {
+      const start = base.subtract(1, "day").startOf("day");
+      const end = base.subtract(1, "day").endOf("day");
+      return { start, end };
+    }
+    case "last7days": {
+      const start = base.subtract(6, "day").startOf("day");
+      const end = base.endOf("day");
+      return { start, end };
+    }
+    case "last30days": {
+      const start = base.subtract(29, "day").startOf("day");
+      const end = base.endOf("day");
+      return { start, end };
+    }
+    case "thisMonth": {
+      const start = base.startOf("month");
+      const end = base.endOf("month");
+      return { start, end };
+    }
+    case "lastMonth": {
+      const prev = base.subtract(1, "month");
+      const start = prev.startOf("month");
+      const end = prev.endOf("month");
+      return { start, end };
+    }
+    default: {
+      const start = base.startOf("day");
+      const end = base.endOf("day");
+      return { start, end };
+    }
+  }
+}
+function isInRange(value, range) {
+  const v = dayjs(value);
+  const s = dayjs(range.start);
+  const e = dayjs(range.end);
+  if (!v.isValid() || !s.isValid() || !e.isValid()) return false;
+  const { start, end } = createRange(s, e);
+  return v.isSameOrAfter(start) && v.isSameOrBefore(end);
+}
+function useTime() {
+  return {
+    formatTime,
+    humanizeTime,
+    timeDiff,
+    formatToMonthDay,
+    createRange,
+    formatRange,
+    getPresetRange,
+    isInRange
+  };
+}
 export {
+  buildAllMenuTree,
+  buildPageMenuList,
   calcInactivityAction,
   createAppRouter,
   createAuthHttpClient,
   createLogoutToAuth,
   createMenuHelper,
-  createPermissionHelper
+  createPermissionHelper,
+  createRange,
+  findFirstPagePath,
+  formatRange,
+  formatTime,
+  formatToMonthDay,
+  getPresetRange,
+  humanizeTime,
+  isInRange,
+  timeDiff,
+  transformMenuTree,
+  useTime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litianxiang/portal-core",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -14,11 +14,13 @@
   },
   "peerDependencies": {
     "vue": "^3.5.0",
-    "vue-router": "^4.5.0"
+    "vue-router": "^4.5.0",
+    "dayjs": "^1.11.0"
   },
   "devDependencies": {
     "tsup": "^8.3.0",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "dayjs": "^1.11.13"
   },
   "license": "UNLICENSED"
 }