@zl-ui-kit/utils 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vik05
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# @zl-ui-kit/utils
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+ZL UI 通用工具函数库（TypeScript）：数组/对象/DOM/函数、AES 加解密（crypto-js）、文件工具、axios 请求封装（`createRequest`：防重复、qs 序列化、`{cipher}` 响应解密）、微前端 URL 工具、分页/格式化等。
+
+## 快速上手
+
+```ts
+import { createRequest, convertArrayToTree, paginate, aesEncrypt } from '@zl-ui-kit/utils'
+
+const request = createRequest({ baseURL: '/api', onError(code, err) { /* ... */ } })
+```
+
+注入式设计（决策 §12-Q3）：`baseURL`、调试开关、微前端 dev 源映射均由参数注入，**不读取构建环境变量**，Vite/webpack 消费方均可使用。
+
+## 模块说明
+
+- 不迁移（业务/循环依赖，见需求 §5.1）：原 `policy.js`、`list-hook.js`
+- `echarts` 图表工具并入 `@zl-ui-kit/components`（随 JcChart/ZlChart 批次）
+- UKey SDK 以 `vendor/mtoken.js` 原样附带（`@zl-ui-kit/utils/vendor/mtoken.js`，未纳入类型与主入口）
+
+## 本地调试
+
+源码即入口（playground alias 直指 `src/`）；`pnpm build`（tsup 产 `dist/index.mjs` + d.ts）；`pnpm test:unit`（vitest，纯函数用例）。详见 `docs/调试指南.md`。
+
+## 发布
+
+见根目录 `docs/发布流程.md`（publint/attw/脱敏扫描为硬门槛）。

package/dist/index.d.ts

@@ -0,0 +1,222 @@
+import { AxiosRequestConfig, AxiosResponse, AxiosInstance } from 'axios';
+export { saveAs as fileSave } from 'file-saver';
+
+/**
+ * 数组工具
+ */
+interface ConvertArrayToTreeOptions {
+    /** 主键字段名，默认 'id' */
+    id?: string;
+    /** 父级字段名，默认 'pid' */
+    pid?: string;
+    /** 子级字段名，默认 'children' */
+    children?: string;
+}
+/**
+ * 扁平数组转树结构（基于 id/pid 关联，支持乱序输入）
+ */
+declare function convertArrayToTree<T extends Record<string, any>>(list: T[], options?: ConvertArrayToTreeOptions): T[];
+/**
+ * 保证返回数组：非数组值包装为单元素数组
+ */
+declare function ensureArray<T>(val: T | T[]): T[];
+
+/**
+ * AES 加解密工具（crypto-js，CBC/PKCS7）
+ * 密钥由使用方传入或使用默认值
+ */
+declare const DEFAULT_AES_KEY = "d9e6b141f8c26d74";
+declare const DEFAULT_AES_IV_KEY = "7b51fd7053196308";
+declare const DATABASE_AES_KEY = "b6fa92796c6431c5";
+declare const DATABASE_AES_IV_KEY = "7b51fd7053196308";
+declare function aesEncrypt(password: string, aesKey?: string, aesIvKey?: string): string;
+declare function aesDecrypt(encrypted: string, aesKey?: string, aesIvKey?: string): string;
+
+/**
+ * DOM 工具
+ */
+interface RelativeRect {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    width: number;
+    height: number;
+}
+/**
+ * 计算元素相对于指定参照元素的矩形位置
+ */
+declare function getRelativeRect(target: HTMLElement, relative: HTMLElement): RelativeRect;
+/**
+ * 读取元素样式（含计算样式回退）
+ * @param prop 样式属性名（小驼峰或 float）
+ */
+declare function getStyle(element: HTMLElement | null, prop: string): string | null;
+
+/**
+ * 文件工具（下载/预览类型判断/大小格式化）
+ * 注入式改造（需求 §12-Q3）：文件前缀由调用方传入，不再读取构建环境变量
+ */
+
+/**
+ * 拼接文件服务前缀路径
+ * @param path 文件路径（带不带开头 / 均可）
+ * @param prefix 文件服务前缀，默认 '/_file'（原实现取自环境变量，现由使用方注入）
+ */
+declare function joinFilePrefix(path: string, prefix?: string): string;
+/**
+ * 通过创建临时 <a> 标签触发浏览器下载
+ */
+declare function downloadFileByUrl(url: string, prefix?: string): void;
+type FilePreviewType = 'image' | 'pdf' | 'word' | 'ppt' | 'excel';
+/**
+ * 根据扩展名判断文件预览类型
+ */
+declare function fileUrlPreviewType(path: string): FilePreviewType;
+interface FormatFilesizeOptions {
+    /** 小数位数，默认 2 */
+    precision?: number;
+    /** 单位列表 */
+    units?: string[];
+}
+/**
+ * 格式化文件大小（B/KB/MB/GB）
+ */
+declare function formatFilesize(size: number, options?: FormatFilesizeOptions): string;
+
+/**
+ * 函数工具
+ */
+/**
+ * 防抖：延迟 delay 毫秒后执行，期间重复触发会重置计时
+ */
+declare function debounce<Args extends any[]>(callback: (...args: Args) => void, delay?: number): (...args: Args) => void;
+/**
+ * 深度遍历树结构数组
+ */
+declare function traverseTree<T extends Record<string, any>>(tree: T[], callback: (item: T) => void, fieldNames?: {
+    children?: string;
+}): void;
+/**
+ * 创建带 resolve/reject 句柄的 Promise（Promise.withResolvers 的兼容实现）
+ */
+declare function withResolvers<T = unknown>(): {
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+    promise: Promise<T>;
+};
+
+/**
+ * 类型判断工具
+ */
+declare function isObject(val: unknown): val is Record<string, any>;
+declare function isPlainObject(val: unknown): val is Record<string, any>;
+declare function isArray(val: unknown): val is any[];
+declare function isFunction(val: unknown): val is (...args: any[]) => any;
+declare function isPromise(val: unknown): val is Promise<unknown>;
+declare function isBoolean(val: unknown): val is boolean;
+declare function isNumber(val: unknown): val is number;
+declare function isDefined<T>(val: T | undefined): val is T;
+
+/**
+ * 微前端 URL 工具（micro-app 约定）
+ * 注入式改造（需求 §12-Q3）：开发态源地址映射由调用方传入，不再读取构建环境变量
+ */
+interface FormatMicroUrlOptions {
+    /** 是否处于开发环境（替换微应用源为本机 dev server） */
+    dev?: boolean;
+    /** 微应用标识 → 开发态源地址映射，如 { dsc: 'http://localhost:5204' } */
+    origins?: Record<string, string>;
+}
+interface FormatMicroUrlResult {
+    /** 从 URL 第一段路径提取的微应用标识 */
+    micro: string;
+    URL: URL;
+    url: string;
+    fullpath: string;
+}
+/**
+ * 格式化微前端 URL 地址
+ */
+declare function formatMicroUrl(url: string, options?: FormatMicroUrlOptions | boolean): FormatMicroUrlResult;
+
+/**
+ * 对象工具
+ */
+declare function shallowCopy<T>(obj: T): T;
+declare function hasOwn(obj: object, key: string): boolean;
+declare function deepCopy<T>(obj: T): T;
+
+/**
+ * axios 请求封装工厂
+ * 注入式改造（需求 §12-Q3）：baseURL/调试开关均由 options 注入，不读取构建环境变量，兼容任意构建链消费方
+ */
+
+/** 业务响应为 AES 加密数据时的密文前缀标识 */
+declare const CRYPTO_CIPHER_CODE = "{cipher}{1}";
+/** 扩展的请求配置 */
+interface RequestOptions extends AxiosRequestConfig {
+    /** 业务成功码（默认 200，可按后端契约覆盖） */
+    successCode?: number;
+    /** 是否启用 `{cipher}` AES 密文响应解密（默认 true，可关闭） */
+    enableCipher?: boolean;
+    /** 重复请求时是否直接抛错（默认 true），为 false 时仅回调 onRepeat */
+    throwOnRepeat?: boolean;
+    /** 重复请求回调 */
+    onRepeat?: (config: AxiosRequestConfig) => void;
+    /** 业务错误/网络错误统一回调 */
+    onError?: (code: number, source: AxiosResponse | Error, extra?: string) => void;
+    /** 响应数据统一回调（解密后、业务码判断前） */
+    onResponse?: (data: any, res: AxiosResponse) => void;
+    /** 是否打印解密日志（原实现绑定构建环境变量，现由使用方注入） */
+    logDecrypt?: boolean;
+}
+/** 业务错误对象：code 为业务码（200 成功；95xx 网络/HTTP 错误码） */
+declare class RequestError extends Error {
+    name: string;
+    code: number;
+    extra?: string;
+    constructor(code: number, message?: string, extra?: string);
+}
+declare module 'axios' {
+    interface AxiosRequestConfig {
+        /** 跳过重复请求检测 */
+        ignoreRepeat?: boolean;
+    }
+}
+/**
+ * 创建请求实例：防重复请求、qs 序列化、{cipher} 响应 AES 解密、业务码统一处理
+ */
+declare function createRequest(options?: RequestOptions): AxiosInstance;
+/**
+ * 为已有请求实例追加统一拦截（供子应用/宿主扩展）
+ */
+declare function setupRequest(request: AxiosInstance, onRequest?: (config: AxiosRequestConfig) => void, onError?: (error: unknown) => void): void;
+
+/**
+ * ============================================================
+ * @zl-ui-kit/utils 入口
+ * 通用工具函数库（详见 README.md）
+ * 不迁移说明（需求文档 §5.1）：policy.js / list-hook.js 为业务代码不迁移；
+ * mToken UKey SDK 以 vendor 形式保留（@zl-ui-kit/utils/vendor/mtoken.js），暂不纳入类型与主入口
+ * ============================================================
+ */
+
+/** 生成 UUID v4 */
+declare function generateUUID(): string;
+/** 生成 [min, max] 区间随机整数 */
+declare function getRandomInt(min: number, max: number): number;
+/** 静态分页结果 */
+interface PaginateResult<T> {
+    rows: T[];
+    pageNum: number;
+    total: number;
+}
+/** 静态分页（对内存数组按页截取） */
+declare function paginate<T>(data: T[], pageSize: number, pageNum: number): PaginateResult<T>;
+/** 千分位格式化数字（保留小数） */
+declare function formatNumber(number: number | string): string;
+/** 计算表格行序号（当前页第 rowIndex 行的全局序号，从 1 开始） */
+declare function getIndex(rowIndex: number, pageNum: number, pageSize: number): number;
+
+export { CRYPTO_CIPHER_CODE, type ConvertArrayToTreeOptions, DATABASE_AES_IV_KEY, DATABASE_AES_KEY, DEFAULT_AES_IV_KEY, DEFAULT_AES_KEY, type FilePreviewType, type FormatFilesizeOptions, type FormatMicroUrlOptions, type FormatMicroUrlResult, type PaginateResult, type RelativeRect, RequestError, type RequestOptions, aesDecrypt, aesEncrypt, convertArrayToTree, createRequest, debounce, deepCopy, downloadFileByUrl, ensureArray, fileUrlPreviewType, formatFilesize, formatMicroUrl, formatNumber, generateUUID, getIndex, getRandomInt, getRelativeRect, getStyle, hasOwn, isArray, isBoolean, isDefined, isFunction, isNumber, isObject, isPlainObject, isPromise, joinFilePrefix, paginate, createRequest as request, setupRequest, shallowCopy, traverseTree, withResolvers };

package/dist/index.js

@@ -0,0 +1,432 @@
+// src/array.ts
+function convertArrayToTree(list, options = {}) {
+  var _a, _b;
+  const { id = "id", pid = "pid", children = "children" } = options;
+  const map = {};
+  const parentChain = {};
+  for (const item of list) {
+    map[_a = item[pid]] ?? (map[_a] = { [children]: [] });
+    parentChain[_b = item[pid]] ?? (parentChain[_b] = []);
+    map[item[pid]].children.push(item);
+    parentChain[item[id]] = [];
+    parentChain[item[pid]].push(item[id]);
+    if (map[item[id]]) {
+      const existedChildren = map[item[id]].children;
+      Object.assign(map[item[id]], item, { children: existedChildren });
+    } else {
+      ;
+      item.children ?? (item.children = []);
+      map[item[id]] = item;
+    }
+  }
+  let index = 0;
+  while (true) {
+    const item = Object.entries(parentChain)[index];
+    index += 1;
+    if (!item)
+      break;
+    const childrenIds = item[1].slice();
+    for (const child of childrenIds) {
+      childrenIds.push(...parentChain[child] ?? []);
+    }
+    childrenIds.forEach((child) => {
+      delete parentChain[child];
+    });
+  }
+  return Object.keys(parentChain).flatMap((id2) => map[id2].children);
+}
+function ensureArray(val) {
+  return Array.isArray(val) ? val : [val];
+}
+
+// src/crypto.ts
+import CryptoJS from "crypto-js";
+var DEFAULT_AES_KEY = "d9e6b141f8c26d74";
+var DEFAULT_AES_IV_KEY = "7b51fd7053196308";
+var DATABASE_AES_KEY = "b6fa92796c6431c5";
+var DATABASE_AES_IV_KEY = "7b51fd7053196308";
+function aesEncrypt(password, aesKey = DEFAULT_AES_KEY, aesIvKey = DEFAULT_AES_IV_KEY) {
+  const ivs = CryptoJS.enc.Utf8.parse(aesIvKey);
+  const encrypted = CryptoJS.AES.encrypt(
+    password,
+    CryptoJS.enc.Utf8.parse(aesKey),
+    {
+      iv: ivs,
+      padding: CryptoJS.pad.Pkcs7,
+      mode: CryptoJS.mode.CBC
+    }
+  );
+  return encrypted.toString();
+}
+function aesDecrypt(encrypted, aesKey = DEFAULT_AES_KEY, aesIvKey = DEFAULT_AES_IV_KEY) {
+  const ivs = CryptoJS.enc.Utf8.parse(aesIvKey);
+  const decrypted = CryptoJS.AES.decrypt(
+    encrypted,
+    CryptoJS.enc.Utf8.parse(aesKey),
+    {
+      iv: ivs,
+      padding: CryptoJS.pad.Pkcs7,
+      mode: CryptoJS.mode.CBC
+    }
+  );
+  return decrypted.toString(CryptoJS.enc.Utf8);
+}
+
+// src/dom.ts
+function getRelativeRect(target2, relative) {
+  const targetRect = target2.getBoundingClientRect();
+  const relativeRect = relative.getBoundingClientRect();
+  return {
+    top: targetRect.top - relativeRect.top,
+    bottom: relativeRect.bottom - targetRect.bottom,
+    left: targetRect.left - relativeRect.left,
+    right: relativeRect.right - targetRect.right,
+    width: targetRect.width,
+    height: targetRect.height
+  };
+}
+function getStyle(element, prop) {
+  if (!element || !prop)
+    return null;
+  let styleName = prop;
+  if (prop === "float") {
+    styleName = "cssFloat";
+  }
+  try {
+    if (document.defaultView) {
+      const computed = document.defaultView.getComputedStyle(element, "");
+      return element.style[styleName] || computed ? computed[styleName] : "";
+    }
+  } catch {
+    return element.style[styleName];
+  }
+  return null;
+}
+
+// src/file.ts
+import { saveAs } from "file-saver";
+function joinFilePrefix(path, prefix = "/_file") {
+  return `${prefix}${(path || "").indexOf("/") === 0 ? path : `/${path}`}`;
+}
+function downloadFileByUrl(url, prefix) {
+  if (!url) {
+    return;
+  }
+  const link = document.createElement("a");
+  link.href = joinFilePrefix(url, prefix);
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+}
+function fileUrlPreviewType(path) {
+  const arr = (path || "").split(".");
+  const type = arr[arr.length - 1] ?? "";
+  if (["jpg", "png", "gif", "svg"].includes(type)) {
+    return "image";
+  }
+  if (type === "pdf") {
+    return "pdf";
+  }
+  if (["docx", "doc", "dotx", "docm", "dotm"].includes(type)) {
+    return "word";
+  }
+  if (["ppt", "pptx", "pps", "ppsx", "ppa", "ppam", "pot", "potx"].includes(type)) {
+    return "ppt";
+  }
+  if (["xls", "xlsx", "xlsm", "xlsb", "csv", "et", "ods"].includes(type)) {
+    return "excel";
+  }
+  return "word";
+}
+function formatFilesize(size, options = {}) {
+  const { precision = 2, units = ["B", "KB", "MB", "GB"] } = options;
+  const index = Math.max(0, Math.min(units.length - 1, Math.floor(Math.log(size) / Math.log(1024))));
+  return `${(size / 1024 ** index).toFixed(precision)}${units[index]}`;
+}
+
+// src/is.ts
+var ops = Object.prototype.toString;
+function isObject(val) {
+  return val !== null && typeof val === "object";
+}
+function isPlainObject(val) {
+  return ops.call(val) === "[object Object]";
+}
+function isArray(val) {
+  return Array.isArray(val);
+}
+function isFunction(val) {
+  return typeof val === "function";
+}
+function isPromise(val) {
+  return ops.call(val) === "[object Promise]";
+}
+function isBoolean(val) {
+  return typeof val === "boolean";
+}
+function isNumber(val) {
+  return typeof val === "number";
+}
+function isDefined(val) {
+  return typeof val !== "undefined";
+}
+
+// src/function.ts
+var target = typeof window === "undefined" ? globalThis : window;
+function debounce(callback, delay = 300) {
+  let timer;
+  return (...args) => {
+    if (timer) {
+      target.clearTimeout(timer);
+    }
+    timer = target.setTimeout(() => {
+      timer = void 0;
+      callback(...args);
+    }, delay);
+  };
+}
+function traverseTree(tree, callback, fieldNames = {}) {
+  const { children = "children" } = fieldNames;
+  for (let i = 0; i < tree.length; i++) {
+    const item = tree[i];
+    callback(item);
+    if (isArray(item[children])) {
+      traverseTree(item[children], callback, fieldNames);
+    }
+  }
+}
+function withResolvers() {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return { resolve, reject, promise };
+}
+
+// src/micro.ts
+function formatMicroUrl(url, options = {}) {
+  const { dev = false, origins = {} } = typeof options === "boolean" ? { dev: options } : options;
+  let _url = new URL(url, window.location.origin);
+  const micro = _url.pathname.split("/")[1] ?? "";
+  if (dev && origins[micro]) {
+    _url = new URL(_url.pathname + _url.search, origins[micro]);
+  }
+  return {
+    micro,
+    URL: _url,
+    url: _url.href,
+    fullpath: _url.pathname + _url.search
+  };
+}
+
+// src/object.ts
+function shallowCopy(obj) {
+  if (isObject(obj)) {
+    return Object.assign(isArray(obj) ? [] : {}, obj);
+  }
+  return obj;
+}
+function hasOwn(obj, key) {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+function deepCopy(obj) {
+  if (isObject(obj)) {
+    const newObj = isArray(obj) ? [] : {};
+    for (const key in obj) {
+      if (hasOwn(obj, key)) {
+        newObj[key] = deepCopy(obj[key]);
+      }
+    }
+    return newObj;
+  }
+  return obj;
+}
+
+// src/request.ts
+import axios, { isCancel } from "axios";
+import qs from "qs";
+var CRYPTO_CIPHER_CODE = "{cipher}{1}";
+var RequestError = class extends Error {
+  constructor(code, message, extra) {
+    super(message);
+    this.name = "RequestError";
+    this.code = code;
+    this.extra = extra;
+  }
+};
+var requestMap = /* @__PURE__ */ new Set();
+function generateRequestKey(config) {
+  return `${config.url}:${config.method}:${JSON.stringify(config.params)}:${JSON.stringify(config.data)}`;
+}
+function createRequest(options = {}) {
+  const {
+    successCode = 200,
+    enableCipher = true,
+    throwOnRepeat = true,
+    onRepeat,
+    onError,
+    onResponse,
+    logDecrypt = false,
+    ...axiosOptions
+  } = options;
+  const request = axios.create({
+    paramsSerializer: {
+      serialize: (params) => {
+        return qs.stringify(params);
+      }
+    },
+    ...axiosOptions
+  });
+  request.interceptors.request.use((config) => {
+    if (!config.ignoreRepeat) {
+      const key = generateRequestKey(config);
+      if (requestMap.has(key)) {
+        onRepeat?.(config);
+        if (throwOnRepeat) {
+          throw new RequestError(-1, "\u8BF7\u6C42\u5DF2\u53D1\u51FA\uFF0C\u8BF7\u52FF\u91CD\u590D\u8BF7\u6C42");
+        }
+      } else {
+        requestMap.add(key);
+        setTimeout(() => requestMap.delete(key), 200);
+      }
+    }
+    return config;
+  });
+  request.interceptors.response.use((res) => {
+    const key = generateRequestKey(res.config);
+    requestMap.delete(key);
+    let data = res.data;
+    if (res.request.responseType === "blob" || res.request.responseType === "arraybuffer" || res.headers?.["content-type"] === "text/csv") {
+      return res.data;
+    } else if (enableCipher && typeof data === "string" && data?.startsWith?.(CRYPTO_CIPHER_CODE)) {
+      try {
+        const dataStr = aesDecrypt(data.slice(CRYPTO_CIPHER_CODE.length));
+        data = JSON.parse(dataStr);
+        if (logDecrypt) {
+          console.log("decrypt data: ", res.config.url, "\n", dataStr);
+        }
+      } catch {
+      }
+    }
+    onResponse?.(data, res);
+    const code = Number(data?.code);
+    if (code === successCode) {
+      return data;
+    }
+    onError?.(code, res);
+    return Promise.reject(new RequestError(code, data?.msg));
+  }, (error) => {
+    if (isCancel(error)) {
+      return Promise.resolve();
+    }
+    let code = 9e3;
+    let errorExtraInfo;
+    const message = error.message ?? "";
+    if (message.includes("Network Error")) {
+      code = 9501;
+    } else if (message.includes("timeout")) {
+      code = 9502;
+    } else if (message.includes("Request failed with status code")) {
+      code = 9503;
+      errorExtraInfo = message.slice(message.length - 3);
+    }
+    onError?.(code, error, errorExtraInfo);
+    return Promise.reject(new RequestError(code, message, errorExtraInfo));
+  });
+  return request;
+}
+function setupRequest(request, onRequest, onError) {
+  request.interceptors.request.use((config) => {
+    onRequest?.(config);
+    return config;
+  });
+  request.interceptors.response.use(void 0, (error) => {
+    onError?.(error);
+    return Promise.reject(error);
+  });
+}
+var request_default = createRequest;
+
+// src/index.ts
+function generateUUID() {
+  return ([1e7].toString() + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, (c) => (Number(c) ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> Number(c) / 4).toString(16));
+}
+function getRandomInt(min, max) {
+  min = Math.ceil(min);
+  max = Math.floor(max);
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function paginate(data, pageSize, pageNum) {
+  const total = data.length;
+  if (pageNum < 1 || pageNum > total) {
+    return {
+      rows: [],
+      pageNum: 0,
+      total: 0
+    };
+  }
+  const start = (pageNum - 1) * pageSize;
+  const end = start + pageSize;
+  return {
+    rows: data.slice(start, end),
+    pageNum,
+    total
+  };
+}
+function formatNumber(number) {
+  const numStr = (number || 0).toString();
+  const [integerPart, decimalPart] = numStr.split(".");
+  const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  if (decimalPart) {
+    return `${formattedInteger}.${decimalPart}`;
+  }
+  return formattedInteger;
+}
+function getIndex(rowIndex, pageNum, pageSize) {
+  return (pageNum - 1) * pageSize + rowIndex + 1;
+}
+export {
+  CRYPTO_CIPHER_CODE,
+  DATABASE_AES_IV_KEY,
+  DATABASE_AES_KEY,
+  DEFAULT_AES_IV_KEY,
+  DEFAULT_AES_KEY,
+  RequestError,
+  aesDecrypt,
+  aesEncrypt,
+  convertArrayToTree,
+  createRequest,
+  debounce,
+  deepCopy,
+  downloadFileByUrl,
+  ensureArray,
+  saveAs as fileSave,
+  fileUrlPreviewType,
+  formatFilesize,
+  formatMicroUrl,
+  formatNumber,
+  generateUUID,
+  getIndex,
+  getRandomInt,
+  getRelativeRect,
+  getStyle,
+  hasOwn,
+  isArray,
+  isBoolean,
+  isDefined,
+  isFunction,
+  isNumber,
+  isObject,
+  isPlainObject,
+  isPromise,
+  joinFilePrefix,
+  paginate,
+  request_default as request,
+  setupRequest,
+  shallowCopy,
+  traverseTree,
+  withResolvers
+};
+//# sourceMappingURL=index.js.map