halo-fe 1.0.22 → 1.0.24

package/esm/drivers/helpers/implements/StringHelper.d.ts

@@ -0,0 +1,104 @@
+import Helper from "../Helper";
+/**
+ * 字符串帮助类
+ */
+declare class StringHelper extends Helper {
+    type: string;
+    /**
+     * 生成唯一字符串
+     */
+    getUniqueId: (length?: number) => string;
+    /**
+     * 填充字符串到指定长度，使用pad填充
+     */
+    padLeft: (value: string, length: number, pad: string) => any;
+    /**
+     * 填充字符串到指定长度，使用pad填充
+     */
+    padStart: (input: string, length: number, pad: string) => string;
+    /**
+     * 去掉头部字符串
+     */
+    trimStart: (value: string, trim: string) => string;
+    /**
+     * 去掉尾部字符串
+     */
+    trimEnd: (value: string, trim: string) => string;
+    /**
+     * 去掉头尾字符串
+     */
+    trim: (value: string, start: string, end: string) => string;
+    /**
+     * 获取中划线命名法
+     */
+    getDashName: (value: string) => string;
+    /**
+     * 判断字符串是否为空或空串
+     */
+    isNullOrEmpty: (value: string) => boolean;
+    /**
+     * 判断字符串是否为空或空串
+     */
+    isEmpty: (value: string) => value is "";
+    /**
+     * 判断是否符合密码要求
+     */
+    isPassword: (value: string) => boolean;
+    /**
+     * 判断是否是数字类型，这样支持0
+     */
+    isNumber: (value: any) => boolean;
+    /**
+     * 验证是否是邮箱格式
+     */
+    isEmail: (email: string) => boolean;
+    /**
+     * 判断是否是json
+     */
+    isJson: (value: string) => boolean;
+    /**
+     * 判断是否是isJsonp
+     */
+    isJsonp: (value: string) => boolean;
+    /**
+     * 判断是否是html
+     */
+    isHtml: (value: string) => boolean;
+    /**
+     * 是否以字符串开头
+     */
+    startWith: (value: string, startWith: string) => boolean;
+    /**
+     * 忽略大小写包含判断，支持从数组中搜索关键词
+     */
+    containsIgnoreCase: (keywords: string, value: string | string[]) => boolean;
+    /**
+     * 忽略大小写比较
+     */
+    equalsIgnoreCase(value: any, valueCompare: string): boolean;
+    /**
+     * 获取内容类型
+     */
+    getContentType: (value: string) => "html" | "json" | "text";
+    /**
+     * 获取数据值或者空
+     */
+    getNumberOrNull: (value: any) => number;
+    /**
+     * 获取两个字符串之间的字符串
+     */
+    getBetween: (value: string, start: string, end: string) => string;
+    /**
+     * 根据字符串或数组，自动返回数组
+     */
+    getArray(name: string | string[]): string[];
+    /**
+     * 按占位符格式化成字符串
+     */
+    format: (value: string, placeholder: any) => string;
+    /**
+     * 格式化成留指定位数的小数
+     */
+    formatDigits: (value: string, digits: number) => string;
+}
+export default StringHelper;

package/esm/drivers/helpers/implements/TaskHelper.d.ts

@@ -0,0 +1,28 @@
+import Helper from "../Helper";
+/**
+ * 任务执行帮助类
+ */
+declare class TaskHelper extends Helper {
+    type: string;
+    /**
+     * 延时指定ms后执行指定任务
+     */
+    delay: (fun: Function, ms: number) => number;
+    /**
+     * 在执行指定延时后，每隔指定ms执行指定任务
+     */
+    execute: (fun: Function, ms: number, delay: number) => Promise<unknown>;
+    /**
+     * 清空定时器
+     */
+    clearInterval: (id: number) => void;
+    /**
+     * 防抖（指定时间内只触发一次）
+     */
+    debounce: (fun: Function, delay: number) => (e: any) => void;
+    /**
+     * 节流：https://segmentfault.com/a/1190000018428170
+     */
+    throttle: (fun: Function, delay: number) => (e: any) => boolean;
+}
+export default TaskHelper;

package/esm/drivers/helpers/implements/TimeHelper.d.ts

@@ -0,0 +1,68 @@
+import Helper from "../Helper";
+/**
+ * 时间帮助类
+ */
+declare class TimeHelper extends Helper {
+    type: string;
+    /**
+     * 获取相对于1970年1月1日的时间戳(ms)，不同时区结果相同
+     */
+    getTimestamp: (value?: any) => number;
+    /**
+     * 根据字符串获取可对比的时间
+     */
+    getTime: (value?: any) => Date;
+    /**
+     * 格式化时间
+     */
+    format: (value: number, format: string) => string;
+    /**
+     * 获取当前日期时间的字符串
+     */
+    getDateTimeString: () => string;
+    /**
+     * 获取当前时间的字符串
+     */
+    getDateString: () => string;
+    /**
+     * 获取当前时间的字符串
+     */
+    getTimeString: () => string;
+    /**
+     * 对时间值进行时间格式化
+     */
+    formatSecondTime: (value: any) => string;
+    /**
+     * 对时间值进行时间格式化
+     */
+    formatMillisecondTime: (value: string) => string;
+    /**
+     * 格式化成24小时时间格式
+     */
+    formatTime: (value: any) => string;
+    /**
+     * 对时间值进行日期格式化
+     */
+    formatDate: (value: any) => string;
+    /**
+     * 添加天数
+     */
+    addDays: (value: any, days: number) => Date;
+    /**
+     * 添加月份
+     */
+    addMonths: (value: any, months: number) => Date;
+    /**
+     * 添加小时
+     */
+    addHours: (value: any, hours: number) => Date;
+    /**
+     * 判断指定时间是否是周末
+     */
+    isWeekend: (value: any) => boolean;
+    /**
+     * 把中国时间，转换为当地时间
+     */
+    localeTime: (time: any) => Date;
+}
+export default TimeHelper;

package/esm/drivers/helpers/implements/TreeHelper.d.ts

@@ -0,0 +1,56 @@
+import Helper from "../Helper";
+/**
+ * 树帮助类
+ */
+declare class TreeHelper extends Helper {
+    type: string;
+    /**
+     * 从树结构数据中，递归获取指定主键的对象
+     */
+    getById: (id: any, idProp: string, tree: any[], childProp: string) => any;
+    /**
+     * 树节点
+     */
+    getByIds: (ids: any[], idProp: string, tree: any[], childProp: string) => any[];
+    /**
+     * 找出指定层级集合中，指定对象的下一个对象
+     */
+    getNextById: (id: any, idProp: string, tree: any[], childProp: string) => any;
+    /**
+     * 获取兄弟节点
+     */
+    getSiblingsById: (id: any, idProp: string, tree: any[], childProp: string) => any;
+    /**
+     * 获取父节点
+     */
+    getParentById: (id: any, idProp: string, tree: any[], childProp: string) => any;
+    /**
+     * 从树结构数据中，递归获取指定主键的父元素集合
+     */
+    getParentsById: (id: any, idProp: string, tree: any[], childProp: string, hasSelf?: boolean) => any[];
+    /**
+     * 获取当前节点的所有孩子节点的集合
+     */
+    getChildrenById: (id: any, idProp: string, tree: any[], childProp: string, hasSelf?: boolean) => any[];
+    /**
+     * 获取当前节点的所有孩子节点的集合
+     */
+    getChildren: (element: any, childProp: string, hasSelf?: boolean) => any[];
+    /**
+     * 搜索指定文本的树结构
+     */
+    searchTree: (keywords: string, tree: any[], childProp: string, searchProps: any) => any[];
+    /**
+     * 删除指定子元素
+     */
+    removeById: (id: any, idProp: string, tree: any[], childProp: string) => void;
+    /**
+     * 获取树结构扁平化后的节点信息
+     */
+    getFlat: (tree: any[], childProp: string) => any[];
+    /**
+     * 对树结点的数据进行重新映射，映射得到新的Tree数组
+     */
+    map: (tree: any[], prevChildProp: string, childProp: string, fn: Function) => any[];
+}
+export default TreeHelper;

package/esm/drivers/helpers/implements/TypeHelper.d.ts

@@ -0,0 +1,28 @@
+import Helper from "../Helper";
+/**
+ * 类型帮助类
+ */
+declare class TypeHelper extends Helper {
+    type: string;
+    /**
+     * 判断输入类型是否是字符串类型 null -> false
+     */
+    isString: (input: any) => boolean;
+    /**
+     * 判断输入类型是否是Object类型
+     */
+    isObject: (input: any) => boolean;
+    /**
+     * 判断输入类型是否是Array类型
+     */
+    isArray: (input: any) => boolean;
+    /**
+     * 判断输入类型是否是Number类型，null -> false
+     */
+    isNumber: (input: any) => boolean;
+    /**
+     * 判断输入类型是否是isBoolean类型
+     */
+    isBoolean: (input: any) => boolean;
+}
+export default TypeHelper;

package/esm/drivers/helpers/implements/UrlHelper.d.ts

@@ -0,0 +1,90 @@
+import Helper from "../Helper";
+/**
+ * Url帮助类
+ */
+declare class UrlHelper extends Helper {
+    type: string;
+    /**
+     * 获取指定地址路由对象
+     */
+    getToRoute(url: string, withReturnUrl?: boolean): any;
+    /**
+     * 获取要跳转的Url地址信息，自动涵盖后退地址
+     */
+    getToUrl(url: string, withReturnUrl?: boolean): string;
+    /**
+     * 获取菜单参数
+     */
+    getM(url: string): any;
+    /**
+     * 获取后退地址路由
+     */
+    getBackRoute(): any;
+    /**
+     * 获取要后退的地址URL
+     */
+    getBackUrl(): string;
+    /**
+     * 获取指定地址的路由对象，自动合并qs，并解码
+     */
+    getRoute(url: string, queryObj?: object): any;
+    /**
+     * 处理实体，得到url query参数形式
+     * 如：app=Tool&compare[language]=json&compare[sql]=App%3D%27Tool%27+and+[Table]+like+%27Ctl_%25%27+order+by+[Table],+Name
+     */
+    getQuery(value: any): string;
+    /**
+     * 处理键值对的值
+     */
+    private handleQueryValue;
+    /**
+     * 自动根据后面路径，决定是否要合并Url
+     */
+    concatUrl: (url: string, path: string) => string;
+    /**
+     * 合并路径和查询对象（自动编码，并支持覆盖现有参数），得到完整URL地址，并会省略默认值
+     *  ? 对url参数不编码，只对 queryObj 参数编码，防止用户的参数被改成编码形式
+     *  ? 目前，对Url参数对象和目标对象都编码，因为源对象属性是经过解码的
+     */
+    getUrl: (url: string, params?: any) => string;
+    /**
+     * 获取超链接配置对象
+     */
+    getAnchor: (url: string, params?: any) => {
+        href: any;
+        target: any;
+    };
+    /**
+     * 从Url中提取路径
+     */
+    getPath(url: string): string;
+    /**
+     * 获取path中最后一个片段信息
+     */
+    getLastSegment(url: string): string;
+    /**
+     * 获取地址中的查询参数
+     */
+    getQueryParam(url: string, key: string): string;
+    /**
+     * 从Url中提取查询对象
+     */
+    deserialize(url: string): object;
+    /**
+     * 把查询字符串转换成对象（自动解码成源数据）
+     */
+    deserializeQs(qs: string, decode?: boolean): any;
+    /**
+     * 把对象转换成查询字符串，自动编码
+     */
+    serialize(obj: object, encoding?: boolean): string;
+    /**
+     * URL编码
+     */
+    encode(value: string): string;
+    /**
+     * 是否是http或https开头的地址
+     */
+    httpOrHttps(url: string): boolean;
+}
+export default UrlHelper;

package/esm/drivers/helpers/index.d.ts

@@ -0,0 +1,24 @@
+import HelperFactory from "./HelperFactory";
+import ArrayHelper from "./implements/ArrayHelper";
+import ComponentHelper from './implements/ComponentHelper';
+import DomHelper from "./implements/DomHelper";
+import DictionaryHelper from "./implements/DictionaryHelper";
+import EventHelper from "./implements/EventHelper";
+import FileHelper from "./implements/FileHelper";
+import HtmlHelper from "./implements/HtmlHelper";
+import ImageHelper from "./implements/ImageHelper";
+import MathHelper from "./implements/MathHelper";
+import MicroHelper from "./implements/MicroHelper";
+import MountHelper from "./implements/MountHelper";
+import ObjectHelper from "./implements/ObjectHelper";
+import StringHelper from "./implements/StringHelper";
+import TaskHelper from "./implements/TaskHelper";
+import TypeHelper from "./implements/TypeHelper";
+import TimeHelper from "./implements/TimeHelper";
+import TreeHelper from "./implements/TreeHelper";
+import ScrollHelper from "./implements/ScrollHelper";
+import JsonHelper from "./implements/JsonHelper";
+import BrowserHelper from "./implements/BrowserHelper";
+import UrlHelper from "./implements/UrlHelper";
+import SignHelper from "./implements/SignHelper";
+export { HelperFactory, ArrayHelper, ComponentHelper, DomHelper, DictionaryHelper, EventHelper, FileHelper, HtmlHelper, ImageHelper, MathHelper, MountHelper, ObjectHelper, MicroHelper, StringHelper, TaskHelper, TypeHelper, TimeHelper, TreeHelper, ScrollHelper, JsonHelper, BrowserHelper, UrlHelper, SignHelper };

package/esm/drivers/https/HttpFactory.d.ts

@@ -18,6 +18,6 @@ declare class HttpFactory extends Factory<IHttp> {
      * 获取本地请求实例
      * 获取完毕后，下游第一行代码就要配置消息服务
      */
-    getHalo(): Promise<IHttp>;
+    get halo(): IHttp;
 }
 export default HttpFactory;

package/esm/drivers/i18ns/II18n.d.ts

@@ -65,7 +65,7 @@ interface II18n extends IDriver, IOpen {
     /**
      * 设置标题
      */
-    setTitle(title: string, env: string): void;
+    setTitle(title: string, env?: string): void;
     /**
      * 添加自定义多语言包
      */

package/esm/drivers/index.d.ts

@@ -7,6 +7,7 @@ export * from "./excels";
 export * from "./explainers";
 export * from "./features";
 export * from "./hashers";
+export * from "./helpers";
 export * from "./https";
 export * from "./i18ns";
 export * from "./messengers";
@@ -15,5 +16,6 @@ export * from "./signers";
 export * from "./ssos";
 export * from "./tasks";
 export * from "./templates";
+export * from "./utilities";
 export * from "./videos";
 export * from "./voices";

package/esm/drivers/providers/ProviderFactory.d.ts

@@ -8,7 +8,7 @@ declare class ProviderFactory extends Factory<IProvider> {
     /**
      * 获取指定类型的提供程序
      */
-    create(type: string, conn?: string): Promise<IProvider>;
+    createAsync(type: string, conn?: string): Promise<IProvider>;
     private _default;
     /**
      * 获取并开启默认驱动程序

package/esm/drivers/signers/SignerFactory.d.ts

@@ -8,6 +8,6 @@ declare class SignerFactory extends Factory<ISigner> {
     /**
      * 获取指定签名实例
      */
-    create(type: string, conn?: string): Promise<ISigner>;
+    createAsync(type: string, conn?: string): Promise<ISigner>;
 }
 export default SignerFactory;

package/esm/drivers/signers/implements/DefaultSigner.d.ts

@@ -9,7 +9,7 @@ declare class DefaultSigner extends Signer {
         app_id: string;
     }): Promise<void>;
     callback(token: string): void;
-    getSign(userId: string, url: string, body: string, timestamp: number, secret: string): Promise<string>;
+    getSign: (userId: string, url: string, body: string, timestamp: number, secret: string) => Promise<string>;
     loginUrl(callback: string): string;
     dispose(): void;
 }

package/esm/drivers/ssos/SsoFactory.d.ts

@@ -11,6 +11,6 @@ declare class SsoFactory extends Factory<ISso> {
     /**
      * 获取指定SSO实例
      */
-    create(type: string, conn?: string): Promise<ISso>;
+    createAsync(type: string, conn?: string): Promise<ISso>;
 }
 export default SsoFactory;

package/esm/drivers/utilities/@types/DragEvent.d.ts

@@ -0,0 +1,11 @@
+import Position from "./Position";
+/**
+ * 自定义拖拽事件
+ */
+declare class DragEvent extends Position {
+    /**
+     * 吸附的方向
+     */
+    affix?: string;
+}
+export default DragEvent;

package/esm/drivers/utilities/@types/DragOptions.d.ts

@@ -0,0 +1,28 @@
+import Rect from "./Rect";
+import DragEvent from "./DragEvent";
+/**
+ * 拖拽选项
+ */
+interface DragOptions {
+    /**
+     * 拖拽初始化
+     */
+    init: (event: MouseEvent) => any;
+    /**
+     * 拖拽事件
+     */
+    handler: (dragEvent: DragEvent, start: MouseEvent, data: any, first: boolean, event: MouseEvent) => void;
+    /**
+     * 拖拽结束事件
+     */
+    end?: (event: MouseEvent) => void;
+    /**
+     * 可拖拽范围
+     */
+    range?: Rect;
+    /**
+     * 吸附检测的距离，设置吸附位置必须设置拖拽范围（依赖宽度等信息）
+     */
+    affix?: number;
+}
+export default DragOptions;

package/esm/drivers/utilities/@types/Position.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 位置
+ */
+declare class Position {
+    /**
+     * 距窗口左边的距离
+     */
+    x: number;
+    /**
+     * 距窗口顶部的距离
+     */
+    y: number;
+    constructor(x?: number, y?: number);
+}
+export default Position;

package/esm/drivers/utilities/@types/Rect.d.ts

@@ -0,0 +1,10 @@
+import Position from "./Position";
+/**
+ * 区域类
+ */
+declare class Rect extends Position {
+    width: number;
+    height: number;
+    constructor(x: number, y: number, width: number, height: number);
+}
+export default Rect;

package/esm/drivers/utilities/@types/index.d.ts

@@ -0,0 +1,5 @@
+import DragOptions from "./DragOptions";
+import DragEvent from "./DragEvent";
+import Position from "./Position";
+import Rect from "./Rect";
+export { type DragOptions, DragEvent, Position, Rect };

package/esm/drivers/utilities/IUtility.d.ts

@@ -0,0 +1,4 @@
+import { IDriver } from "../@types";
+interface IUtility extends IDriver {
+}
+export default IUtility;

package/esm/drivers/utilities/Utility.d.ts

@@ -0,0 +1,5 @@
+import IUtility from "./IUtility";
+declare abstract class Utility implements IUtility {
+    type: string;
+}
+export default Utility;

package/esm/drivers/utilities/UtilityFactory.d.ts

@@ -0,0 +1,43 @@
+import { Factory } from "../../factorying";
+import IUtility from "./IUtility";
+import AffixUtility from "./implement/AffixUtility";
+import DeltaUtility from "./implement/DeltaUtility";
+import EventUtility from "./implement/EventUtility";
+import KeyboardUtility from "./implement/KeyboardUtility";
+import RandomUtility from "./implement/RandomUtility";
+import SaveUtility from "./implement/SaveUtility";
+import MouseUtility from "./implement/MouseUtility";
+/**
+ * 工具类工厂
+ */
+declare class UtilityFactory extends Factory<IUtility> {
+    /**
+     * 创建固定工具
+     */
+    affix(ele: Element, parent: Element): AffixUtility;
+    /**
+     * 创建对比工具
+     */
+    delta(): DeltaUtility;
+    /**
+     * 创建固定工具
+     */
+    event(): EventUtility;
+    /**
+     * 键盘工具
+     */
+    keyboard(): KeyboardUtility;
+    /**
+     * 鼠标工具
+     */
+    mouse(container: HTMLElement, closeTriggers?: any[]): MouseUtility;
+    /**
+     * 随机工具
+     */
+    random(): RandomUtility;
+    /**
+     * 随机工具
+     */
+    save(): SaveUtility;
+}
+export default UtilityFactory;

package/esm/drivers/utilities/implement/AffixUtility.d.ts

@@ -0,0 +1,11 @@
+import Utility from "../Utility";
+/**
+ * 固定元素位置
+ */
+declare class AffixUtility extends Utility {
+    /**
+     * 初始化
+     */
+    constructor(ele: Element, parent: Element);
+}
+export default AffixUtility;

package/esm/drivers/utilities/implement/DeltaUtility.d.ts

@@ -0,0 +1,11 @@
+import Utility from "../Utility";
+/**
+ * 列表数据变动对比
+ */
+declare class DeltaUtility extends Utility {
+    /**
+     * 对比数据变动
+     */
+    delta<T>(oldEntities: T[], newEntities: T[], keys: string[], props: []): void;
+}
+export default DeltaUtility;