halo-fe 1.0.21 → 1.0.23

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/https/implements/HaloHttp.d.ts

@@ -36,10 +36,7 @@ declare class HaloHttp extends Http {
      * 单点登录配置
      */
     signer: ISigner;
-    /**
-     * 开启
-     */
-    open(conn: string): Promise<void>;
+    open: (conn: string) => Promise<void>;
     /**
      * 发送请求
      */

package/esm/drivers/https/implements/MkHttp.d.ts

@@ -26,7 +26,7 @@ declare class MkHttp extends Http {
     /**
      * 危险操作，会暴露敏感信息
      */
-    open(conn: string): Promise<void>;
+    open: (conn: string) => Promise<void>;
     /**
      * 危险操作，会暴露敏感信息
      */

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

@@ -1,10 +1,17 @@
 import II18n from "./II18n";
+/**
+ * 多语言翻译基类
+ */
 declare abstract class I18n implements II18n {
     type: string;
     lang: string;
     messages: {
         [key: string]: any;
     };
+    /**
+     * 已加载的语言集合
+     */
+    loaded: string[];
     open(conn?: string): Promise<void>;
     t: (key: string, params?: any) => string;
     abstract translate(key: string, params: any): string;
@@ -29,10 +36,7 @@ declare abstract class I18n implements II18n {
     addMessages: (messages: {
         [key: string]: string;
     }) => void;
-    abstract loadI18n(lang: string): Promise<void>;
-    /**
-     * 切换语言，自动加载菜单
-     */
-    switchI18n: (lang: string) => Promise<void>;
+    abstract load(lang: string): Promise<void>;
+    switch: (lang: string) => Promise<void>;
 }
 export default I18n;

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;
     /**
      * 添加自定义多语言包
      */
@@ -75,6 +75,10 @@ interface II18n extends IDriver, IOpen {
     /**
      * 加载指定语言包，需http请求器先加载完毕
      */
-    loadI18n(lang?: string): Promise<void>;
+    load(lang: string): Promise<void>;
+    /**
+     * 切换语言，自动加载菜单
+     */
+    switch(lang: string): Promise<void>;
 }
 export default II18n;

package/esm/drivers/i18ns/implements/DefaultI18n.d.ts

@@ -8,6 +8,6 @@ declare class DefaultI18n extends I18n {
     open(conn?: string): Promise<void>;
     translate: (key: string, params?: any) => string;
     t_exists: (key: string) => boolean;
-    loadI18n: (lang: string) => Promise<void>;
+    load: (lang: string) => Promise<void>;
 }
 export default DefaultI18n;

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";

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/providers/implements/StorageHelper.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 存储帮助类
+ */
+declare class StorageHelper {
+    /**
+     * 获取本地存储
+     */
+    static get: (key: string, value?: any) => any;
+    /**
+     * 设置本地存储
+     */
+    static set: (key: string, value: string) => void;
+    /**
+     * 获取本地存储
+     */
+    static getObject: (key: string) => any;
+    /**
+     * 设置本地存储
+     */
+    static setObject: (key: string, value: any) => void;
+    /**
+     * 移除存储数据
+     */
+    static remove: (key: string) => void;
+    /**
+     * 以5M为基准，获取剩余可用容量(KB)
+     */
+    static getLeftStorage: () => number;
+    /**
+     * 判断指定值是否能够存储到storage中
+     */
+    static canStorage: (value: object) => boolean;
+}
+export default StorageHelper;

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/factorying/Factories.d.ts

@@ -1,9 +1,15 @@
-import { BuilderFactory, CdnFactory, EncoderFactory, ExcelFactory, ExplainerFactory, FeatureFactory, HasherFactory, I18nFactory, HttpFactory, MessengerFactory, ProviderFactory, SignerFactory, SsoFactory, TaskFactory, TemplateFactory } from "../drivers";
+import { BuilderFactory, CdnFactory, EncoderFactory, ExcelFactory, ExplainerFactory, FeatureFactory, HasherFactory, HelperFactory, I18nFactory, HttpFactory, MessengerFactory, ProviderFactory, SignerFactory, SsoFactory, TaskFactory, TemplateFactory } from "../drivers";
 import { SvcFactory } from "../svcs";
 /**
  * 驱动工厂类
  */
 declare class Factories {
+    /**
+     * 工厂缓存
+     */
+    static mappings: {
+        [key: string]: any;
+    };
     /**
      * Builder工厂
      */
@@ -40,6 +46,10 @@ declare class Factories {
      * 多语言工厂
      */
     static get i18n(): I18nFactory;
+    /**
+     * 帮助类工厂
+     */
+    static get helper(): HelperFactory;
     /**
      * 消息提示请求工厂
      */
@@ -68,12 +78,6 @@ declare class Factories {
      * 服务工厂
      */
     static get svc(): SvcFactory;
-    /**
-     * 工厂缓存
-     */
-    static mappings: {
-        [key: string]: any;
-    };
     /**
      * 并缓存工厂实例
      */

package/esm/factorying/Factory.d.ts

@@ -26,18 +26,23 @@ declare abstract class Factory<T extends IDriver> implements IFactory<T> {
      * 开启
      */
     open(): void;
-    /**
-     * 创建指定类型驱动
-     */
-    create(type: string): Promise<T>;
     /**
      * 根据主键创建驱动，并返回加载后的驱动信息
      */
     createById(id: number, driverRef?: Ref<any>): Promise<T>;
+    createIfAbsent(type: string): T;
     /**
      * 从缓存中获取指定名称的驱动，不存在则创建并执行初始化
      */
-    createIfAbsent(name: string, type?: string, open?: (entity: T) => Promise<void>): Promise<T>;
+    createIfAbsentAsync(type?: string, open?: (entity: T) => Promise<void>): Promise<T>;
+    /**
+     * 创建指定类型驱动
+     */
+    create(type: string): T;
+    /**
+     * 异步创建指定类型驱动
+     */
+    createAsync(type: string): Promise<T>;
     /**
      * 加载驱动明细
      */

package/esm/factorying/Helpers.d.ts

@@ -0,0 +1,29 @@
+import { ArrayHelper, ComponentHelper, DomHelper, DictionaryHelper, EventHelper, FileHelper, HtmlHelper, ImageHelper, MathHelper, MountHelper, ObjectHelper, MicroHelper, StringHelper, TaskHelper, TypeHelper, TimeHelper, TreeHelper, ScrollHelper, JsonHelper, BrowserHelper, UrlHelper, SignHelper } from "../drivers/helpers";
+/**
+ * 帮助类工厂
+ */
+declare class Helpers {
+    static get array(): ArrayHelper;
+    static get browser(): BrowserHelper;
+    static get component(): ComponentHelper;
+    static get dom(): DomHelper;
+    static get dictionary(): DictionaryHelper;
+    static get event(): EventHelper;
+    static get file(): FileHelper;
+    static get html(): HtmlHelper;
+    static get image(): ImageHelper;
+    static get json(): JsonHelper;
+    static get math(): MathHelper;
+    static get mount(): MountHelper;
+    static get object(): ObjectHelper;
+    static get micro(): MicroHelper;
+    static get scroll(): ScrollHelper;
+    static get string(): StringHelper;
+    static get task(): TaskHelper;
+    static get type(): TypeHelper;
+    static get time(): TimeHelper;
+    static get tree(): TreeHelper;
+    static get url(): UrlHelper;
+    static get sign(): SignHelper;
+}
+export default Helpers;