@litianxiang/portal-core 0.1.12 → 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[];
@@ -168,4 +169,53 @@ declare function buildPageMenuList(menuList: CoreMenuItem[]): CoreMenuItem[];
  */
 declare function findFirstPagePath(menuList: CoreMenuItem[]): string | null;
 
-export { type AppRouterOptions, type BreadcrumbItem, type CoreMenuItem, type CreateAuthHttpClientOptions, type InactivityConfig, type InactivityResult, type LogoutToAuthOptions, type MenuHelper, type MenuHelperOptions, type PermissionHelper, type PermissionHelperOptions, type TransformMenuOptions, buildAllMenuTree, buildPageMenuList, calcInactivityAction, createAppRouter, createAuthHttpClient, createLogoutToAuth, createMenuHelper, createPermissionHelper, findFirstPagePath, transformMenuTree };
+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 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("?");
@@ -595,6 +595,104 @@ function findFirstPagePath(menuList) {
   }
   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,
@@ -604,6 +702,15 @@ export {
   createLogoutToAuth,
   createMenuHelper,
   createPermissionHelper,
+  createRange,
   findFirstPagePath,
-  transformMenuTree
+  formatRange,
+  formatTime,
+  formatToMonthDay,
+  getPresetRange,
+  humanizeTime,
+  isInRange,
+  timeDiff,
+  transformMenuTree,
+  useTime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litianxiang/portal-core",
-  "version": "0.1.12",
+  "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"
 }