@allahjs/utils 1.9.0 → 1.11.0

package/dist/core/arrayUtils/index.d.ts

@@ -1,9 +1,23 @@
-import { IOptions2 } from '../../types/data/index.js';
+import { IEnumObj } from '../../form/types.js';
+import { IOptions2, ITreeNode, IOptions } from '../../types/data/index.js';
 
 /**
- * 数组工具函数
+ * 列表变化的数据
  */
-
+interface IListChangeVo {
+    /**
+     * 需要新增的数据
+     */
+    insertList: string[];
+    /**
+     * 需要删除的数据
+     */
+    deleteList: string[];
+    /**
+     * 没有变的数据
+     */
+    noChangeList: string[];
+}
 /**
  * 数组工具对象
  */
@@ -62,6 +76,126 @@ declare const arrayUtils: {
      * @param key 数据的下标
      */
     getListId(s: string, optList: IOptions2[], key: string): any;
+    /**
+     * 根据指定的字段进行去重
+     * @param arr 数组
+     * @param key 去重字段
+     */
+    uniqueBy: (arr: any[], key: string) => any[];
+    /**
+   * 更新数组,若item已存在则将其从数组中删除,若不存在则将其添加到数组
+   * **/
+    updateArray: <T = any>(array: T[], item: T) => void;
+    /**
+     * 将数组中指定元素移除
+     * @param array
+     * @param item 要移除的item
+     * @param id 要对比的属性，缺省则比较地址
+     * @returns {*}
+     */
+    remove: (array: any[], item: any, id: any) => any[] | undefined;
+    /**
+     * 判断两个数组的是否相等
+     * @return boolean true 数组长度相等且对应元素相等
+     * */
+    isEqual: (arr1?: any[], arr2?: any[]) => boolean;
+    /**
+     * clone 数组
+     * @return Array 新的数组
+     * */
+    clone: (from: any[]) => any[];
+    /**
+     *获取两个数组的差集
+     * @param arr1
+     * @param arr2
+     */
+    subSet: (arr1: any[], arr2: any[]) => any[];
+    /**
+     * 获取数组中符合要求的项目
+     * @param itemList 条目数组
+     * @param v 比较值
+     * @param k 比较的字段
+     */
+    getItemByKey: <T = any>(itemList: T[], v: any, k?: string) => T;
+    /**
+     * 树形数据降维
+     */
+    dimTreeReduction: (treeData: ITreeNode[], nodeKeys: string[], nodes: ITreeNode[]) => void;
+    /**
+     * 树形数据降维 - 返回一个完整的数组
+     */
+    dimTreeReduction2: (treeData: ITreeNode[]) => {
+        nodes: ITreeNode[];
+        nodeKeys: string[];
+    };
+    /**
+     * 移除父节点
+     */
+    removePNode: (nodeList: any[]) => any[];
+    /**
+     * 数组转枚举
+     */
+    toEnum: (arr: IOptions<string>[]) => IEnumObj;
+    /**
+     * 把对象里面指定的属性转换成数组
+     * @param obj 原始数据
+     * @param keys 哪些字段要转换
+     */
+    toArrayByKeys: (obj: Record<string, any>, keys: string[]) => void;
+    /**
+     * 把对象里面指定的属性转换成数字数组
+     * @param obj 原始数据
+     * @param keys 哪些字段要转换
+     */
+    toNumArrayByKeys: (obj: Record<string, any>, keys: string[]) => void;
+    /**
+     * 把对象里面指定的属性转换成字符串
+     * @param obj 原始数据
+     * @param keys 哪些字段要转换
+     * @param str 分隔符
+     * @param joinAll 是否前后都加
+     */
+    toStringByKeys: (obj: Record<string, any>, keys: string[], str?: string, joinAll?: boolean) => void;
+    /**
+     * 把对象里面指定的属性转换成字符串 - 这个方法会在前后都补充对应的符号
+     * <p>
+     * ["a", "b"] => ";a;b;c;"
+     * @param obj 原始数据
+     * @param keys 哪些字段要转换
+     */
+    joinAll: (obj: Record<string, any>, keys: string[]) => void;
+    /**
+     * 把对象里面指定的属性转换成字符串
+     * <p>
+     * ["a", "b"] => "a;b;c"
+     * @param obj 原始数据
+     * @param keys 哪些字段要转换
+     */
+    join: (obj: Record<string, any>, keys: string[]) => void;
+    /**
+     * 查找出两个数组中需要删除的，需要更新的，没有变化的
+     */
+    findChangeData: (oldData: string[], newData: string[], key: string) => IListChangeVo;
+    /**
+     * 将字符串或者数组转成数组
+     * @param str 字符串或者数组
+     * @param splitStr 分隔符
+     */
+    toArray: (str: string | string[] | undefined | null, splitStr?: string) => string[] | null;
+    /**
+     * 判断对象里面的数组是否发生了变化
+     * <br />
+     * 一般来说，用在资源关联里面，比如判断下现在新的资源和旧的资源是否有变化，如果没有变化，就不需要重新请求接口
+     */
+    isChangeArray: (oldObj: Record<string, any[]>, newObj: Record<string, any[]>) => boolean;
+    /**
+     * 数组移动位置
+     * @param array 数组
+     * @param from 从哪个位置
+     * @param to 移动到哪个位置
+     */
+    arrayMove<T>(array: T[], from: number, to: number): T[];
 };
 
 export { arrayUtils as default };
+export type { IListChangeVo };

package/dist/core/constants/asyncTaskScheduleVo.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 异步任务进度信息
+ */
+interface IAsyncTaskScheduleVo<T = any> {
+    /**
+     * 是否是拆分任务
+     */
+    splitTask: boolean;
+    /**
+     * 拆分任务数量是否是合并任务
+     */
+    splitTaskCount: number;
+    /**
+     * 当前执行的拆分任务
+     */
+    currentSplitTask: number;
+    /**
+     * 总页数
+     */
+    pages: number;
+    /**
+     * 总数量
+     */
+    count: number;
+    redisKey: string;
+    /**
+     * 每页数据量
+     */
+    pageSize: number;
+    /**
+     * 当前是第几个
+     */
+    current: number;
+    /**
+     * 更新数量
+     */
+    updateNum: number;
+    /**
+     * 当前是第几页
+     */
+    currentPage: number;
+    /**
+     * 当前数据的总数
+     */
+    currentSize: number;
+    /**
+     * 状态；1 新任务，2旧任务
+     */
+    type: number;
+    typeText: string;
+    /**
+     * 状态；0 未创建，1 正在载入数据，2 正在处理，3 已结束 4 异常
+     */
+    status: 0 | 1 | 2 | 3 | 4;
+    statusText: string;
+    /**
+     * 异常信息
+     */
+    errorMessage: string;
+    /**
+     *文件id
+     */
+    dbFileId: string;
+    /**
+     * 错误总数
+     */
+    errorTotal: number;
+    /**
+     *用户id
+     */
+    userId: string;
+    /**
+     * 异步任务类型
+     */
+    timeConsuming: number;
+    /**
+     * 预计耗时多少秒
+     */
+    expectTime: number;
+    /**
+     * 额外数据
+     */
+    extraData?: T;
+    /**
+     * 超时时间
+     */
+    timeOut: number;
+    /**
+     * 进度，0-100
+     */
+    progress: number;
+    /**
+     * 异步任务
+     */
+    asyncTask: boolean;
+}
+
+export type { IAsyncTaskScheduleVo };

package/dist/core/constants/comm.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+/**
+ * 权限枚举
+ */
+exports.EPermissionEnum = void 0;
+(function (EPermissionEnum) {
+    /**
+     * 公有
+     */
+    EPermissionEnum[EPermissionEnum["PUBLIC"] = 0] = "PUBLIC";
+    /**
+     * 私有
+     */
+    EPermissionEnum[EPermissionEnum["PRIVATE"] = 1] = "PRIVATE";
+    /**
+     * 登录后可以查看
+     */
+    EPermissionEnum[EPermissionEnum["LOGIN"] = 2] = "LOGIN";
+    /**
+     * 本部门可见/部门内可见
+     */
+    EPermissionEnum[EPermissionEnum["DEPT"] = 3] = "DEPT";
+})(exports.EPermissionEnum || (exports.EPermissionEnum = {}));
+//# sourceMappingURL=comm.cjs.map

package/dist/core/constants/comm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comm.cjs","sources":["../../../src/core/constants/comm.ts"],"sourcesContent":[null],"names":["EPermissionEnum"],"mappings":";;AAyCA;;AAEG;AACSA;AAAZ,CAAA,UAAY,eAAe,EAAA;AACzB;;AAEG;AACH,IAAA,eAAA,CAAA,eAAA,CAAA,QAAA,CAAA,GAAA,CAAA,CAAA,GAAA,QAAU;AACV;;AAEG;AACH,IAAA,eAAA,CAAA,eAAA,CAAA,SAAA,CAAA,GAAA,CAAA,CAAA,GAAA,SAAW;AACX;;AAEG;AACH,IAAA,eAAA,CAAA,eAAA,CAAA,OAAA,CAAA,GAAA,CAAA,CAAA,GAAA,OAAS;AACT;;AAEG;AACH,IAAA,eAAA,CAAA,eAAA,CAAA,MAAA,CAAA,GAAA,CAAA,CAAA,GAAA,MAAQ;AACV,CAAC,EAjBWA,uBAAe,KAAfA,uBAAe,GAAA,EAAA,CAAA,CAAA;;"}

package/dist/core/constants/comm.d.ts

@@ -0,0 +1,309 @@
+/**
+ * 路由的定义
+ */
+interface IRoute {
+    /**
+     * 地址
+     */
+    path: string;
+    /**
+     * 对应组件地址，相对路径
+     */
+    component?: string;
+    /**
+     * 子路由
+     */
+    routes?: IRoute[];
+    Routes?: string[];
+    redirect?: string;
+    /**
+     * 名称
+     */
+    name?: string;
+    /**
+     * 展示的图标
+     */
+    icon?: string;
+    /**
+     * 路由权限
+     */
+    authority?: string[];
+    /**
+     * 是否隐藏子目录
+     */
+    hideChildrenInMenu?: boolean;
+}
+declare type SingleValueType = (string | number)[];
+declare type ValueType = SingleValueType | SingleValueType[];
+type UploadFileStatus = 'error' | 'success' | 'done' | 'uploading' | 'removed' | 'waiting';
+/**
+ * 权限枚举
+ */
+declare enum EPermissionEnum {
+    /**
+     * 公有
+     */
+    PUBLIC = 0,
+    /**
+     * 私有
+     */
+    PRIVATE = 1,
+    /**
+     * 登录后可以查看
+     */
+    LOGIN = 2,
+    /**
+     * 本部门可见/部门内可见
+     */
+    DEPT = 3
+}
+interface UploadFile<T = any> {
+    uid: string;
+    size?: number;
+    name: string;
+    fileName?: string;
+    lastModified?: number;
+    lastModifiedDate?: Date;
+    url?: string;
+    status?: UploadFileStatus;
+    percent?: number;
+    thumbUrl?: string;
+    crossOrigin?: any;
+    originFileObj?: any;
+    response?: T;
+    error?: any;
+    linkProps?: any;
+    type?: string;
+    xhr?: T;
+    preview?: string;
+}
+/**
+ * 文件上传的基本对象
+ */
+interface IFileObjVoBase extends UploadFile {
+    /**
+     * 文件id
+     */
+    fileId: string;
+    /**
+     * 文件大小
+     */
+    fileSize: number;
+    /**
+     * 是否是旧的文件
+     */
+    oldFile: boolean;
+    /**
+     * 文件的id，这个是后端生成的，不是文件的uid
+     */
+    dbFileId: string;
+    /**
+     * 业务场景 -新）
+     */
+    busiScene?: string;
+    cosKey: string;
+    /**
+     * 带水印的key
+     */
+    cosWaterKey: string;
+    /**
+     * 文件的预览图访问地址
+     */
+    previewUrl: string;
+    /**
+     * 文件的桶 - cycm会用到
+     */
+    bucket: string;
+    /**
+     * 文件的权限 - 0 公开，1 私有，2 登录后可以查看
+     */
+    permission?: EPermissionEnum;
+    /**
+     * 后缀
+     */
+    suffix?: string;
+    /**
+     * 文件关联的id - cycm会用到
+     */
+    relId?: string;
+    /**
+     * md5
+     */
+    md5?: string;
+    /**
+     * 创建时间
+     */
+    creTime?: string;
+    /**
+     * 给ReactNative用的
+     */
+    uri?: string;
+    /**
+     * 文件时长
+     */
+    videoDuration?: number;
+    /**
+     * 文件的formdata格式
+     */
+    formData?: FormData;
+}
+/**
+ * 高德地图中国城市数据
+ */
+interface IAMapCountryTree {
+    /**
+     * 地区码
+     */
+    adcode: string;
+    /**
+     * 层级
+     */
+    level: string;
+    /**
+     * 中心点
+     */
+    center: number[];
+    /**
+     * 中文
+     */
+    name: string;
+    /**
+     * 父级地区码
+     */
+    pcode: string;
+    idealzoom: number;
+    /**
+     * 父级地区码
+     */
+    acroutes: number[];
+    bbox: number[];
+    children?: IAMapCountryTree[];
+}
+/**
+ * 通用的标准资源项
+ */
+interface ICommonAssistItem<T = any> {
+    /**
+     * =======基础数据部分========
+     */
+    /**
+     * 资源主键
+     */
+    value?: string;
+    /**
+     * 全局唯一id
+     */
+    unionId?: string;
+    /**
+     * 资源主键
+     */
+    id?: string;
+    /**
+     * 资源名称
+     */
+    label?: string;
+    /**
+     * 是否系统关联
+     */
+    sysRel?: boolean;
+    /**
+     * 状态
+     */
+    statusText?: string;
+    /**
+     * 状态
+     */
+    status?: number | string;
+    /**
+     * 是否有效
+     */
+    valid?: boolean;
+    /**
+     * 资源类型
+     */
+    sourceType?: string;
+    sourceTypeText?: string;
+    /**
+     * 其他的一些属性
+     */
+    other?: T;
+    /**
+     * 是否是新数据
+     */
+    isNew?: boolean;
+    /**
+     * 数据的操作 0 删除，1 新增，null 无变化
+     */
+    actionType?: 0 | 1 | null | undefined;
+    /**
+     * 关联关系
+     */
+    relationship?: string;
+    /**
+     * 关联关系的中文
+     */
+    relationshipText?: string;
+    /**
+     * 关联依据
+     */
+    relationshipBasic?: string;
+    /**
+     * 关联来源
+     */
+    relationshipSource?: string;
+    /**
+     * ===========下面的是组件可能会用到的属性=========
+     */
+    /**
+     * 详情数据(目前是由行业表述使用)
+     */
+    infoReq?: any;
+    /**
+     * 关联的类型 1，主动关联，2，被动关联
+     */
+    relType?: 1 | 2;
+    key?: string;
+    /**
+     * 关联的资源id
+     */
+    sourceId?: string;
+}
+interface FileUpload2Fun {
+    /**
+     * 开始上传
+     * @param relId 关联的id
+     * @param config 额外的配置
+     */
+    startUpload: (relId?: string, config?: {
+        tipsStart?: boolean;
+        tipsEnd?: boolean;
+    }) => Promise<IFileObjVoBase[]>;
+}
+interface MutableRefObject<T> {
+    current: T;
+}
+/**
+ * 文件上传组件上传的钩子，因为这个文件上传是在Service包中使用的，然后会导致在Vue的项目找不到React报错
+ */
+type IUploadRef = MutableRefObject<FileUpload2Fun | undefined>;
+/**
+ * StringKeys<T>
+ * ----------------
+ * 从对象类型 T 中挑选出值类型为 string 或 string | undefined 的键
+ *
+ * 例子：
+ *   type ICloudAccount = {
+ *     accessKey?: string;
+ *     balance?: number;
+ *     secretKey?: string;
+ *   }
+ *
+ *   type Keys = StringKeys<ICloudAccount>
+ *   // 结果: "accessKey" | "secretKey"
+ */
+type StringKeys<T> = {
+    [K in keyof T]: T[K] extends string | undefined ? K : never;
+}[keyof T];
+
+export { EPermissionEnum };
+export type { FileUpload2Fun, IAMapCountryTree, ICommonAssistItem, IFileObjVoBase, IRoute, IUploadRef, SingleValueType, StringKeys, UploadFile, UploadFileStatus, ValueType };

package/dist/core/constants/defaultData.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+/**
+ * 默认的表格数据
+ */
+const defaultTableData = {
+    current: 0,
+    pages: 0,
+    records: [],
+    list: [],
+    size: 0,
+    total: 0
+};
+
+exports.defaultTableData = defaultTableData;
+//# sourceMappingURL=defaultData.cjs.map

package/dist/core/constants/defaultData.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultData.cjs","sources":["../../../src/core/constants/defaultData.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;AAEG;AACI,MAAM,gBAAgB,GAAoB;AAC/C,IAAA,OAAO,EAAE,CAAC;AACV,IAAA,KAAK,EAAE,CAAC;AACR,IAAA,OAAO,EAAE,EAAE;AACX,IAAA,IAAI,EAAE,EAAE;AACR,IAAA,IAAI,EAAE,CAAC;AACP,IAAA,KAAK,EAAE;;;;;"}

package/dist/core/constants/defaultData.d.ts

@@ -0,0 +1,8 @@
+import { ITablePage } from '../pageUtils/index.js';
+
+/**
+ * 默认的表格数据
+ */
+declare const defaultTableData: ITablePage<any>;
+
+export { defaultTableData };

package/dist/core/constants/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+var comm = require('./comm.cjs');
+var defaultData = require('./defaultData.cjs');
+var systemEnum = require('./systemEnum.cjs');
+
+
+
+Object.defineProperty(exports, "EPermissionEnum", {
+	enumerable: true,
+	get: function () { return comm.EPermissionEnum; }
+});
+exports.defaultTableData = defaultData.defaultTableData;
+Object.defineProperty(exports, "AppRunModeEnum", {
+	enumerable: true,
+	get: function () { return systemEnum.AppRunModeEnum; }
+});
+Object.defineProperty(exports, "StorageKeyEnum", {
+	enumerable: true,
+	get: function () { return systemEnum.StorageKeyEnum; }
+});
+//# sourceMappingURL=index.cjs.map

package/dist/core/constants/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}

package/dist/core/constants/index.d.ts

@@ -0,0 +1,4 @@
+export { IAsyncTaskScheduleVo } from './asyncTaskScheduleVo.js';
+export { EPermissionEnum, FileUpload2Fun, IAMapCountryTree, ICommonAssistItem, IFileObjVoBase, IRoute, IUploadRef, SingleValueType, StringKeys, UploadFile, UploadFileStatus, ValueType } from './comm.js';
+export { defaultTableData } from './defaultData.js';
+export { AppRunModeEnum, StorageKeyEnum } from './systemEnum.js';

package/dist/core/constants/systemEnum.d.ts

@@ -12,5 +12,11 @@ declare enum AppRunModeEnum {
      */
     advanced = "advanced"
 }
+declare enum StorageKeyEnum {
+    /**
+     * 应用运行的模式
+     */
+    APP_RUN_MODE = "APP_RUN_MODE"
+}
 
-export { AppRunModeEnum };
+export { AppRunModeEnum, StorageKeyEnum };