halo-fe 1.0.22 → 1.0.24

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

@@ -0,0 +1,73 @@
+import { DragOptions } from "../@types";
+import Utility from "../Utility";
+/**
+ * 事件工具类
+ */
+declare class EventUtility extends Utility {
+    resizeObserver: ResizeObserver;
+    element: Element;
+    resizeHandler: any;
+    /**
+     * 大小改变事件，已防抖
+     */
+    resize: (element: Element, handler: (entries: ResizeObserverEntry[]) => void, debounceMs?: number) => void;
+    scrollElement: Element;
+    scrollHandler: (event: Event) => void;
+    /**
+     * 滚动事件
+     */
+    scroll(element: Element, handler: (event: Event) => void): void;
+    /**
+     * 拖拽起始位置
+     */
+    dragStart: MouseEvent;
+    /**
+     * 拖拽起始数据，每次拖拽时，都会回调到拖拽方法的参数中
+     */
+    dragStartData: any;
+    dragElement: Element;
+    dragMouseDownHandler: (event: MouseEvent) => void;
+    /**
+     * 拖拽事件
+     */
+    drag(element: Element, options: DragOptions): void;
+    observeElement: Element;
+    observer: MutationObserver;
+    /**
+     * 观察DOM变动
+     */
+    observe(element: Element, handler: (mutations: MutationRecord[]) => void): void;
+    mouseDownElement: Element;
+    mouseDownHandler: (event: MouseEvent) => void;
+    mouseUpHandler: (event: MouseEvent) => void;
+    /**
+     * 鼠标按下
+     */
+    mouseDown(element: Element, mouseDown: (event: MouseEvent) => void, mouseUp: (event: MouseEvent) => void): void;
+    lastDebounceTime: number;
+    lastDebounceTimeout: any;
+    /**
+     * 事件防抖: time ms没重复触发才执行指定操作
+     */
+    debounce: (func: (args: any) => void, time: number, args?: any) => void;
+    dispatchElement: HTMLElement;
+    /**
+     * 创建分发事件元素
+     */
+    createDispatch: (id: string, name: string, handler: (e: Event) => void) => void;
+    /**
+     * 分发事件，并传递参数
+     */
+    dispatch(name: string, data: {
+        [key: string]: string;
+    }): void;
+    /**
+     * 事件节流: 指定时间段内只第一次操作被触发
+     */
+    throttle: () => void;
+    /**
+     * 移除大小改变事件
+     */
+    dispose: () => void;
+}
+export default EventUtility;

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

@@ -0,0 +1,74 @@
+import Utility from "../Utility";
+/**
+ * 键盘帮助类
+ */
+declare class KeyboardUtility extends Utility {
+    events: Object;
+    /**
+     * 注册事件
+     */
+    add: (element: any, cb: Function, condition: Function, key: string, prevent: boolean, type: string) => void;
+    /**
+     * 移除事件
+     */
+    remove: (element: any, key: string, type: string) => void;
+    /**
+     * 监听键盘按下事件
+     */
+    keydown: (element: any, cb: Function, condition: Function, key: string, prevent?: boolean) => void;
+    /**
+     * 移除键盘按下事件
+     */
+    removeKeydown: (element: any, key: string) => void;
+    /**
+     * 当触发保存时执行
+     * 想在div上绑定ctrlS事件，需要div处于focus状态，才可以触发已绑定的ctrlS事件
+     * div设置tabindex=-1，才可以手动触发焦点
+     */
+    ctrlS: (element: any, cb: Function) => void;
+    /**
+     * 移除保存事件
+     */
+    removeCtrlS: (element: any) => void;
+    /**
+     * 触发Ctrl回车事件
+     */
+    ctrlEnter: (element: any, cb: Function) => void;
+    /**
+     * 移除Ctrl回车事件
+     */
+    removeCtrlEnter: (element: any) => void;
+    lastKeyTime: number;
+    isKeyLastUp: boolean;
+    /**
+     * 双击事件
+     */
+    doubleKey: (element: any, cb: Function, key: string, prevent?: boolean) => void;
+    /**
+     * 移除双击事件
+     */
+    removeDoubleKey: (element: any, key: string) => void;
+    /**
+     * 监听键盘抬起事件
+     */
+    keyup: (element: any, cb: Function, condition: Function, key: string, prevent?: boolean) => void;
+    /**
+     * 移除键盘抬起事件
+     */
+    removeKeyup: (element: any, key: string) => void;
+    /**
+     * 监控是否按下Ctrl
+     */
+    isCtrl: boolean;
+    ctrl: (document: any) => void;
+    /**
+     * 删除Ctrl事件
+     */
+    removeCtrl: (document: any) => void;
+    timer: number;
+    touchStart: Function;
+    touchEnd(): void;
+    touch: (element: any, cb: Function) => void;
+    removeTouch: (element: any) => void;
+}
+export default KeyboardUtility;

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

@@ -0,0 +1,25 @@
+import Utility from "../Utility";
+/**
+ * 鼠标工具类
+ */
+declare class MouseUtility extends Utility {
+    container: HTMLElement;
+    closeTriggers: HTMLElement[];
+    /**
+     * 初始化，并绑定自动关闭上下文菜单事件
+     */
+    constructor(container: HTMLElement, closeTriggers?: any[]);
+    /**
+     * 手动关闭右键上下文菜单
+     */
+    close: () => void;
+    /**
+     * 根据鼠标事件，显示右键上下文弹窗
+     */
+    show: (event: MouseEvent) => void;
+    /**
+     * 资源释放，防止内存泄漏
+     */
+    dispose: () => void;
+}
+export default MouseUtility;

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

@@ -0,0 +1,41 @@
+import Utility from "../Utility";
+/**
+ * 随机数工具类
+ * 带状态，如随机数记录了已经使用过的随机数
+ */
+declare class RandomUtility extends Utility {
+    /**
+     * 随机数总长度
+     */
+    length: number;
+    /**
+     * 当前显示元素之前的数组
+     */
+    history: number[];
+    /**
+     * 即将要显示的数组（未空表示用户还没看过，可随机生成）
+     */
+    future: number[];
+    /**
+     * 当前元素指针，索引值，用于指示当前显示的数在所有数组中的位置
+     */
+    current: number;
+    /**
+     * 是否有上一个数
+     */
+    get hasPrev(): boolean;
+    /**
+     * 是否有下一个数
+     */
+    get hasNext(): boolean;
+    /**
+     * 获取轨迹中的上一个数的索引，箭头函数可能会导致数据更新，但是UI不更新
+     */
+    prev(): number;
+    /**
+     * 获取下一个数
+     * 优先从轨迹获取，轨迹没有则取随机数
+     */
+    next(): number;
+}
+export default RandomUtility;

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

@@ -0,0 +1,16 @@
+import Utility from "../Utility";
+/**
+ * 自动保存工具
+ * 函数式编程，从而可以让方法被多处使用
+ */
+declare class SaveUtility extends Utility {
+    /**
+     * 开启表单监控
+     */
+    open(form: any, store: string, id: string): Promise<void>;
+    /**
+     * 资源释放
+     */
+    dispose(): void;
+}
+export default SaveUtility;

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

@@ -0,0 +1,9 @@
+import EventUtility from "./implement/EventUtility";
+import KeyboardUtility from "./implement/KeyboardUtility";
+import DeltaUtility from "./implement/DeltaUtility";
+import MouseUtility from "./implement/MouseUtility";
+import RandomUtility from "./implement/RandomUtility";
+import SaveUtility from "./implement/SaveUtility";
+import UtilityFactory from "./UtilityFactory";
+export * from "./@types";
+export { EventUtility, KeyboardUtility, DeltaUtility, MouseUtility, RandomUtility, SaveUtility, UtilityFactory };

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, UtilityFactory } 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;
     /**
      * 消息提示请求工厂
      */
@@ -65,15 +75,13 @@ declare class Factories {
      */
     static get template(): TemplateFactory;
     /**
-     * 服务工厂
+     * 工具类工厂
      */
-    static get svc(): SvcFactory;
+    static get utility(): UtilityFactory;
     /**
-     * 工厂缓存
+     * 服务工厂
      */
-    static mappings: {
-        [key: string]: any;
-    };
+    static get svc(): SvcFactory;
     /**
      * 并缓存工厂实例
      */

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/Helps.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 Helps {
+    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 Helps;

package/esm/factorying/IFactory.d.ts

@@ -11,17 +11,25 @@ interface IFactory<T> {
      * 开启工厂
      */
     open(): void;
-    /**
-     * 创建指定类型的实例
-     */
-    create(type: string): Promise<T>;
     /**
      * 根据主键创建驱动，并返回加载后的驱动信息
      */
     createById(id: number, driverRef?: Ref<any>): Promise<T>;
+    /**
+     * 从缓存中获取指定类型的驱动，不存在则创建，用于Helper类等简单类型
+     */
+    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>;
 }
 export default IFactory;

package/esm/factorying/Utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 工具类集合
+ */
+declare class Utils {
+    static get utility(): import("../drivers").UtilityFactory;
+    static affix(ele: Element, parent: Element): import("../drivers/utilities/implement/AffixUtility").default;
+    static delta(): import("../drivers").DeltaUtility;
+    static event(): import("../drivers").EventUtility;
+    static keyboard(): import("../drivers").KeyboardUtility;
+    static mouse(container: HTMLElement, closeTriggers?: any[]): import("../drivers").MouseUtility;
+    static random(): import("../drivers").RandomUtility;
+    static save(): import("../drivers").SaveUtility;
+}
+export default Utils;

package/esm/factorying/index.d.ts

@@ -1,6 +1,8 @@
 import Factories from "./Factories";
+import Factory from "./Factory";
 import { ICdn, IEncoder, IHasher, II18n, IHttp, IMessenger, ITemplate } from "../drivers";
 import { CreateFeOptions } from "../@types";
+import Helps from "./Helps";
 /**
  * 默认base64编码
  */
@@ -37,4 +39,4 @@ declare let initDriver: (options: CreateFeOptions) => Promise<void>;
  * 提取可导出的翻译方法，当i18n实例变化后，导出的方案会跟着变化？
  */
 declare let t: typeof i18n.t, t_exists: typeof i18n.t_exists, t_sys: typeof i18n.t_sys, t_enum: typeof i18n.t_enum, t_field: typeof i18n.t_field, t_field_choose_placeholder: typeof i18n.t_field_choose_placeholder, t_field_placeholder: typeof i18n.t_field_placeholder, t_table: typeof i18n.t_table, t_module: typeof i18n.t_module, t_menu: typeof i18n.t_menu;
-export { base64, cdn, http, i18n, md5, template, messenger, initDriver, Factories, t, t_exists, t_sys, t_enum, t_field, t_field_choose_placeholder, t_field_placeholder, t_table, t_module, t_menu };
+export { base64, cdn, http, i18n, md5, template, messenger, initDriver, Factories, Factory, Helps, t, t_exists, t_sys, t_enum, t_field, t_field_choose_placeholder, t_field_placeholder, t_table, t_module, t_menu };

package/esm/helpers/DictionaryHelper.d.ts

@@ -28,5 +28,11 @@ declare class DictionaryHelper {
         key: string;
         value: any[];
     }[];
+    /**
+     * 判断字典是否包含值
+     */
+    static containsValue(dic: {
+        [key: string]: any;
+    }, value: any): boolean;
 }
 export default DictionaryHelper;

package/esm/helpers/MathHelper.d.ts

@@ -38,10 +38,6 @@ declare class MathHelper {
      * 获取百分比
      */
     static getPercentage: (handled: number, total: number) => number;
-    /**
-     * 获取进度文本
-     */
-    static getProgressText: (handled: number, total: number) => string;
     /**
      * 获取百分比，保留2位小数
      */

package/esm/main.d.ts

@@ -4,11 +4,10 @@ export * from "./@types";
 export * from "./coms";
 export * from "./drivers";
 export * from "./factorying";
-export * from "./helpers";
 export * from "./plugins";
 export * from "./repos";
 export * from "./svcs";
-export * from "./utilities";
+export * from "./drivers/utilities";
 /**
  * 初始化前端基础框架
  */

package/esm/svcs/implement/DriverSvc.d.ts

@@ -34,5 +34,13 @@ declare class DriverSvc extends Svc {
      * 加载环境选项
      */
     loadEnvs(reload?: boolean): Promise<void>;
+    /**
+     * 加载驱动选项
+     */
+    loadDrivers(app: string, env: string, kind: string): Promise<any[]>;
+    /**
+     * 加载数据库架构
+     */
+    loadSchema(id: number, schema: string): Promise<any[]>;
 }
 export default DriverSvc;

package/esm/svcs/implement/SettingSvc.d.ts

@@ -65,6 +65,6 @@ declare class SettingSvc {
     /**
      * 加载设置
      */
-    load(): Promise<any>;
+    load: () => Promise<any>;
 }
 export default SettingSvc;

package/esm/svcs/implement/UserSvc.d.ts

@@ -27,14 +27,14 @@ declare class UserSvc {
      * 获取本地缓存中的用户信息；好处：即使手动更改storage数据，也可以里面获取到
      */
     getSso(): Promise<SsoUser>;
-    /**
-     * 登录后，获取用户信息
-     */
-    loadInfo(): Promise<any>;
     /**
      * 未登录，获取匿名登录信息
      */
     getAnonymous(): Promise<void>;
+    /**
+     * 登录后，获取用户信息
+     */
+    loadInfo(): Promise<any>;
     /**
      * 根据路径获取路由
      */
@@ -43,6 +43,10 @@ declare class UserSvc {
      * 加载服务端路由
      */
     loadMenus(): Promise<any[]>;
+    /**
+     * 加载用户选项
+     */
+    loadUsers(form: any): Promise<any>;
     /**
      * 退出登录
      */

package/esm/svcs/index.d.ts

@@ -52,6 +52,8 @@ declare let driverSvc: {
     envs: any[];
     loadApps: (reload?: boolean) => Promise<void>;
     loadEnvs: (reload?: boolean) => Promise<void>;
+    loadDrivers: (app: string, env: string, kind: string) => Promise<any[]>;
+    loadSchema: (id: number, schema: string) => Promise<any[]>;
 };
 declare let envSvc: EnvSvc;
 declare let logSvc: LogSvc;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "halo-fe",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "Halo front end sdk",
   "scripts": {
     "halo-fe:tsc": "vue-tsc",
@@ -29,27 +29,27 @@
     "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
-    "vue": "3.4.37"
+    "vue": "3.5.0"
   },
   "dependencies": {
     "clone": "2.1.2",
     "file-saver": "2.0.5",
-    "liquidjs": "10.16.1",
+    "liquidjs": "10.16.7",
     "moment": "2.30.1",
-    "monaco-editor": "0.50.0",
     "underscore": "1.13.7",
     "underscore.string": "3.3.6"
   },
   "devDependencies": {
-    "@types/node": "22.3.0",
-    "@vitejs/plugin-vue": "5.1.2",
+    "@types/node": "22.5.3",
+    "@vitejs/plugin-vue": "5.1.3",
     "@vitejs/plugin-vue-jsx": "4.0.1",
     "crypto-js": "4.2.0",
     "echarts": "5.5.1",
+    "monaco-editor": "0.51.0",
     "quill": "2.0.2",
-    "sass": "1.77.8",
-    "vite": "5.4.1",
-    "vue-tsc": "2.0.29",
+    "sass": "1.78.0",
+    "vite": "5.4.3",
+    "vue-tsc": "2.1.4",
     "xlsx-js-style": "1.2.0"
   }
 }