@peng_kai/kit 0.1.4 → 0.1.6

package/request/type.d.ts

@@ -1,92 +1,92 @@
-declare namespace Api {
-  type Request = ((reqData: any, options?: Options) => Promise<any>) & {
-    id: string
-    setDefaultConfig: (config: Partial<import('axios').AxiosRequestConfig>) => Request
-  };
-  // type RequestPagination = (reqData: Partial<PageParam>, options?: Options) => Promise<PaginationData<any>>;
-  interface PageParam {
-    page: number
-    page_size: number
-  }
-  interface PageInfo {
-    has_more: boolean
-    page: number
-    page_size: number
-    total: number
-  }
-  interface PageData<T = any> {
-    list: T[] | null
-    pagination: PaginationInfo
-    [k in string]: any
-  }
-  interface Result<T = any | PageData<any>> {
-    code: number
-    msg: string
-    data: T
-  }
-  type GetParam<A extends Request> = A extends (reqData: infer R) => any ? R : any;
-  type GetData<A extends Request> = ReturnType<A> extends Promise<infer D> ? D : any;
-  type GetDataItem<A extends Request> = NonNullable<GetData<A>> extends { list: infer L }
-    ? NonNullable<L> extends Array<infer I>
-      ? I
-      : any
-    : any;
-  type GetDataField<R> = R extends { data: infer D } ? (D extends { list: any, pagination: any } ? D : D) : any;
-
-  /**
-   * 将api返回的分页数据转换成前端使用的分页数据格式，将分页数据格式统一
-   *
-   * ```
-   * {
-   *   code: number,
-   *   msg: string,
-   *   data: {
-   *     list: [],
-   *     pagination: {},
-   *     ...
-   *   }
-   * }
-   * ```
-   */
-  type TransformPageResult<R> = R extends { pagination: infer P, data: infer D }
-    ? D extends Record<string, any>
-      ? D extends { list: any }
-      ? {
-          [Rk in Exclude<keyof R, 'data' | 'pagination'>]: R[Rk];
-        } & {
-          data: D & { pagination: P }
-        }
-        : {
-          [Rk in Exclude<keyof R, 'data' | 'pagination'>]: R[Rk];
-        } & {
-          data: {
-            list: D
-            pagination: P
-          }
-        }
-      : R
-    : R;
-}
-
-// 测试用例 ----------------------------
-// type DDD1 = Api.TransformPageResult<{
-//   code: number
-//   msg: string
-//   data: {
-//     name: string
-//   }[]
-//   pagination: {
-//     page: number
-//   }
-// }>
-// type DDD2 = Api.TransformPageResult<{
-//   code: number
-//   msg: string
-//   data: {
-//     list: { name: string }[]
-//     total: {}
-//   }
-//   pagination: {
-//     page: number
-//   }
-// }>
+declare namespace Api {
+  type Request = ((reqData: any, options?: Options) => Promise<any>) & {
+    id: string
+    setDefaultConfig: (config: Partial<import('axios').AxiosRequestConfig>) => Request
+  };
+  // type RequestPagination = (reqData: Partial<PageParam>, options?: Options) => Promise<PaginationData<any>>;
+  interface PageParam {
+    page: number
+    page_size: number
+  }
+  interface PageInfo {
+    has_more: boolean
+    page: number
+    page_size: number
+    total: number
+  }
+  interface PageData<T = any> {
+    list: T[] | null
+    pagination: PaginationInfo
+    [k in string]: any
+  }
+  interface Result<T = any | PageData<any>> {
+    code: number
+    msg: string
+    data: T
+  }
+  type GetParam<A extends Request> = A extends (reqData: infer R) => any ? R : any;
+  type GetData<A extends Request> = ReturnType<A> extends Promise<infer D> ? D : any;
+  type GetDataItem<A extends Request> = NonNullable<GetData<A>> extends { list: infer L }
+    ? NonNullable<L> extends Array<infer I>
+      ? I
+      : any
+    : any;
+  type GetDataField<R> = R extends { data: infer D } ? (D extends { list: any, pagination: any } ? D : D) : any;
+
+  /**
+   * 将api返回的分页数据转换成前端使用的分页数据格式，将分页数据格式统一
+   *
+   * ```
+   * {
+   *   code: number,
+   *   msg: string,
+   *   data: {
+   *     list: [],
+   *     pagination: {},
+   *     ...
+   *   }
+   * }
+   * ```
+   */
+  type TransformPageResult<R> = R extends { pagination: infer P, data: infer D }
+    ? D extends Record<string, any>
+      ? D extends { list: any }
+      ? {
+          [Rk in Exclude<keyof R, 'data' | 'pagination'>]: R[Rk];
+        } & {
+          data: D & { pagination: P }
+        }
+        : {
+          [Rk in Exclude<keyof R, 'data' | 'pagination'>]: R[Rk];
+        } & {
+          data: {
+            list: D
+            pagination: P
+          }
+        }
+      : R
+    : R;
+}
+
+// 测试用例 ----------------------------
+// type DDD1 = Api.TransformPageResult<{
+//   code: number
+//   msg: string
+//   data: {
+//     name: string
+//   }[]
+//   pagination: {
+//     page: number
+//   }
+// }>
+// type DDD2 = Api.TransformPageResult<{
+//   code: number
+//   msg: string
+//   data: {
+//     list: { name: string }[]
+//     total: {}
+//   }
+//   pagination: {
+//     page: number
+//   }
+// }>

package/stylelint.config.cjs

@@ -1,7 +1,7 @@
-module.exports = {
-  // root: true,
-  extends: ['@peng_kai/lint/vue/stylelint_v2'],
-  rules: {
-    'custom-property-pattern': '(antd-([a-z][a-zA-Z0-9]+)*)|(([a-z][a-z0-9]*)(-[a-z0-9]+)*)',
-  },
-};
+module.exports = {
+  // root: true,
+  extends: ['@peng_kai/lint/vue/stylelint_v2'],
+  rules: {
+    'custom-property-pattern': '(antd-([a-z][a-zA-Z0-9]+)*)|(([a-z][a-z0-9]*)(-[a-z0-9]+)*)',
+  },
+};

package/tsconfig.json

@@ -1,50 +1,50 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "jsx": "preserve",
-    "jsxFactory": "h",
-    "jsxFragmentFactory": "Fragment",
-    "lib": [
-      "ESNext",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "useDefineForClassFields": true,
-    "module": "ESNext",
-
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "allowImportingTsExtensions": true,
-
-    /* Linting */
-    "strict": true,
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitAny": false,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noEmit": true,
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "isolatedModules": true,
-    "skipLibCheck": true
-  },
-  "include": [
-    "admin/**/*.ts",
-    "admin/**/*.d.ts",
-    "admin/**/*.tsx",
-    "admin/**/*.vue",
-    "antd/**/*.ts",
-    "antd/**/*.d.ts",
-    "antd/**/*.tsx",
-    "antd/**/*.vue",
-    "request/**/*.ts",
-    "request/**/*.d.ts",
-    "utils/**/*.ts",
-    "utils/**/*.d.ts",
-    "vue/**/*.ts",
-    "vue/**/*.d.ts",
-    "vue/**/*.tsx",
-    "vue/**/*.vue"
-  ]
-}
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "jsx": "preserve",
+    "jsxFactory": "h",
+    "jsxFragmentFactory": "Fragment",
+    "lib": [
+      "ESNext",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+
+    /* Linting */
+    "strict": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitAny": false,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noEmit": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "admin/**/*.ts",
+    "admin/**/*.d.ts",
+    "admin/**/*.tsx",
+    "admin/**/*.vue",
+    "antd/**/*.ts",
+    "antd/**/*.d.ts",
+    "antd/**/*.tsx",
+    "antd/**/*.vue",
+    "request/**/*.ts",
+    "request/**/*.d.ts",
+    "utils/**/*.ts",
+    "utils/**/*.d.ts",
+    "vue/**/*.ts",
+    "vue/**/*.d.ts",
+    "vue/**/*.tsx",
+    "vue/**/*.vue"
+  ]
+}

package/utils/date.ts

@@ -0,0 +1,44 @@
+import dayjs from 'dayjs';
+import relativeTime from 'dayjs/plugin/relativeTime';
+import 'dayjs/locale/zh';
+import 'dayjs/locale/en';
+
+export { default as dayjs } from 'dayjs';
+
+dayjs.locale('zh');
+dayjs.extend(relativeTime);
+
+/**
+ * 返回给定日期的一天的开始时间。
+ * @param day - 要获取一天的开始时间的日期。
+ * @returns 一天的开始时间作为Unix时间戳，如果输入无效则返回 undefined。
+ */
+export function startOfDay(day: dayjs.ConfigType) {
+  const _day = dayjs(day);
+  return _day.isValid() ? _day.startOf('day').valueOf() : undefined;
+}
+
+/**
+ * 计算给定日期的当天结束时间。
+ * @param day - 要计算当天结束时间的日期。
+ * @returns 表示当天结束时间的时间戳值，如果输入无效则返回 undefined。
+ */
+export function endOfDay(day: dayjs.ConfigType) {
+  const _day = dayjs(day);
+  return _day.isValid() ? _day.endOf('day').valueOf() : undefined;
+}
+
+/**
+ * 将秒数转换为时长格式化时间
+ * @param seconds 秒数
+ * @returns 时长格式化时间
+ */
+export function secondsToDuration(seconds: number) {
+  const units = [['天', 24 * 60 * 60], ['时', 60 * 60], ['分', 60], ['秒', 1]] as const;
+
+  return units.reduce((duration, [label, durationValue]) => {
+    const value = Math.floor(seconds / durationValue);
+    seconds %= durationValue;
+    return value > 0 ? duration += `${value + label}` : duration;
+  }, '');
+}

package/utils/index.ts

@@ -18,9 +18,7 @@ export const ENV = {
  * @param dur 时长
  */
 export function sleep(dur: number) {
-  return new Promise((resolve) => {
-    setTimeout(resolve, dur);
-  });
+  return new Promise(resolve => setTimeout(resolve, dur));
 }
 
 /**
@@ -34,11 +32,6 @@ export function isSSR() {
   return typeof window === 'undefined';
 }
 
-export function fixed() {
-
-  // return (12).toFixed
-}
-
 /**
  * 字符串脱敏，省略中间字符串
  * @param str 字符串
@@ -59,6 +52,15 @@ export function desensitize(str: string | undefined | null, startChars = 4, endC
   return truncatedStr;
 }
 
+/**
+ * 生成指定长度的随机字符串
+ * @param length 要生成的随机字符串的长度
+ */
+export function randomString(length: number) {
+  const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+  return Array.from({ length }, () => characters[Math.floor(Math.random() * characters.length)]).join('');
+}
+
 /**
  * 对应链的浏览器地址
  * @param chain 链名
@@ -121,6 +123,10 @@ export function removeUrlSearchParam(key: string) {
   window.history.replaceState({}, '', url);
 }
 
+/**
+ * 创建一个带有自身键的代理对象
+ * @returns 带有自身键的代理对象
+ */
 export function createSelfKeyProxy<T extends object>() {
   return new Proxy({} as T, {
     get(_, p) {

package/utils/number.ts

@@ -0,0 +1,49 @@
+import { calc } from 'a-calc';
+
+export { default as bn } from 'bignumber.js';
+export { calc } from 'a-calc';
+
+/**
+ * 常用的数值格式化规则
+ *
+ * 命名规则：
+ * - d-decimal: 保留的小数位
+ * - p-pad: 当小数位不够填充指定的小数位时，是否填充0
+ * - r-round: 舍入规则。可选规则: R5四舍五入、R6四舍六入、R1向上取整、R0向下取整
+ * - t-thousand: 是否使用千位符
+ * - n-number: 返回数字类型
+ */
+export const numFmt = {
+  /** 保留18位小数，千位符 */
+  t: (num: any, err: any = null) => calc('a | <=18 ,', { a: String(num), _error: err }) as string | null,
+  /** 舍去小数，四舍五入，千位符 */
+  d0r5t: (num: any, err: any = null) => calc('a | =0 ~5 ,', { a: String(num), _error: err }) as string | null,
+  /** 舍去小数，向下取整，千位符 */
+  d0r0t: (num: any, err: any = null) => calc('a | =0 ~- ,', { a: String(num), _error: err }) as string | null,
+  /** 保留2位小数，四舍五入，千位符 */
+  d2r5t: (num: any, err: any = null) => calc('a | <=2 ~5 ,', { a: String(num), _error: err }) as string | null,
+  /** 保留2位小数，向下取整，千位符 */
+  d2r0t: (num: any, err: any = null) => calc('a | <=2 ~- ,', { a: String(num), _error: err }) as string | null,
+  /** 保留6位小数，四舍五入，千位符 */
+  d6r5t: (num: any, err: any = null) => calc('a | <=6 ~5 ,', { a: String(num), _error: err }) as string | null,
+  /** 保留6位小数，向下取整，千位符 */
+  d6r0t: (num: any, err: any = null) => calc('a | <=6 ~- ,', { a: String(num), _error: err }) as string | null,
+  /** 保留8位小数，四舍五入，千位符 */
+  d8r5t: (num: any, err: any = null) => calc('a | <=8 ~5 ,', { a: String(num), _error: err }) as string | null,
+  /** 保留8位小数，向下取整，千位符 */
+  d8r0t: (num: any, err: any = null) => calc('a | <=8 ~- ,', { a: String(num), _error: err }) as string | null,
+};
+
+/**
+ * 将给定的金额转换为格式化的字符串表示
+ * @param amount - 要转换的金额。
+ * @param decimal - 格式化字符串中包含的小数位数。默认为 0。
+ * @returns 金额的格式化字符串表示。
+ */
+export function toAmount(amount: any, decimal: string | number = 0) {
+  const res = calc('a / 10 ** d', { a: String(amount), d: Number(decimal), _error: null });
+  const fmt = (fmt: keyof typeof numFmt) => (numFmt[fmt] ?? numFmt.t)(res);
+  fmt.toString = () => numFmt.t(res);
+
+  return fmt;
+}

package/vue/components/infinite-query/index.ts

@@ -1 +1 @@
-export { default as InfiniteQuery } from './src/InfiniteQuery.vue';
+export { default as InfiniteQuery } from './src/InfiniteQuery.vue';