nhanh-pure-function 3.0.5 → 3.0.6-beta.1

package/dist/Canvas/index.d.ts

@@ -0,0 +1,58 @@
+import { default as QuickMethod } from './core/quikmethod';
+import { default as LayerGroup } from './LayerGroup';
+import { default as OverlayGroup, OverlayType } from './OverlayGroup';
+import { default as Layer } from './LayerGroup/layer';
+import { default as Point } from './OverlayGroup/point';
+import { default as Text } from './OverlayGroup/text';
+import { default as Line } from './OverlayGroup/line';
+import { default as Polygon } from './OverlayGroup/polygon';
+import { default as Custom } from './OverlayGroup/custom';
+import { default as Arc } from './OverlayGroup/arc';
+import { default as ArcTo } from './OverlayGroup/arcTo';
+export type * from './index.types';
+type ConstructorOption = ConstructorParameters<typeof QuickMethod>[0] & {
+    /** 轴线显示属性 */
+    axisShow?: Parameters<_Canvas["toggleAxis"]>[0];
+};
+/** 你好啊你好的画布工具 */
+export declare class _Canvas extends QuickMethod {
+    /** 图层群组 */
+    static LayerGroup: typeof LayerGroup;
+    /** 图层 */
+    static Layer: typeof Layer;
+    /** 覆盖物群组 */
+    static OverlayGroup: typeof OverlayGroup;
+    /** 文字 */
+    static Text: typeof Text;
+    /** 点位 */
+    static Point: typeof Point;
+    /** 线段 */
+    static Line: typeof Line;
+    /** 多边形 */
+    static Polygon: typeof Polygon;
+    /** 自定义绘制 */
+    static Custom: typeof Custom;
+    /** 圆弧 */
+    static Arc: typeof Arc;
+    /** 圆角 */
+    static ArcTo: typeof ArcTo;
+    constructor(option: ConstructorOption);
+    private initLayerGroups;
+    /** 获取图层群组 集合 */
+    gteLayerGroups(key?: string): LayerGroup | undefined;
+    /** 设置图层群组 */
+    setLayerGroup(layerGroup: LayerGroup): void;
+    /** 移除图层群组 */
+    removeLayerGroup(layerGroup: LayerGroup): void;
+    /** 添加图层 */
+    addLayer(layers: DeepArray<Layer>): void;
+    /** 移除图层 */
+    removeLayer(layers: DeepArray<Layer>): void;
+    /** 添加覆盖物 */
+    addOverlay(overlays: DeepArray<OverlayType>): void;
+    /** 移除覆盖物 */
+    removeOverlay(overlays: DeepArray<OverlayType>): void;
+    /** 销毁 */
+    destroy(): void;
+}
+export default _Canvas;

package/dist/Canvas/index.types.d.ts

@@ -0,0 +1,14 @@
+import { default as LayerGroup } from './LayerGroup';
+import { default as OverlayGroup, OverlayType } from './OverlayGroup';
+import { default as Layer } from './LayerGroup/layer';
+import { default as Point } from './OverlayGroup/point';
+import { default as Text } from './OverlayGroup/text';
+import { default as Line } from './OverlayGroup/line';
+import { default as Polygon } from './OverlayGroup/polygon';
+import { default as Axis } from './core/axis';
+import { default as Custom } from './OverlayGroup/custom';
+import { default as Arc } from './OverlayGroup/arc';
+import { default as ArcTo } from './OverlayGroup/arcTo';
+import { EventHandler } from './public/eventController';
+import { default as Overlay } from './OverlayGroup/public/overlay';
+export type { LayerGroup, OverlayGroup, Layer, OverlayType, Overlay, Point, Text, Line, Polygon, Axis, Custom, Arc, ArcTo, EventHandler, };

package/dist/Canvas/public/basedata.d.ts

@@ -0,0 +1,64 @@
+import { default as _Canvas } from '..';
+declare abstract class Base<T extends Base<T>> {
+    /** 父级 */
+    parent?: T;
+    /** 名称 */
+    name: string;
+    /** 自定义扩展数据 */
+    extData?: any;
+    /** 主画布 */
+    mainCanvas?: _Canvas;
+    private _isRecalculate;
+    /** 是否需要重新计算坐标 */
+    get isRecalculate(): boolean;
+    set isRecalculate(isRecalculate: boolean);
+    /** 是否是同一个主画布 */
+    equalsMainCanvas(mainCanvas?: _Canvas): boolean;
+    /** 设置主画布 */
+    setMainCanvas(mainCanvas?: _Canvas): void;
+    /** 通知重新加载 */
+    notifyReload?: (needForceExecute?: boolean) => void;
+    /** 设置通知重新加载 */
+    abstract setNotifyReload(notifyReload?: () => void): void;
+}
+declare abstract class Show<T extends Show<T>> extends Base<T> {
+    private _isVisible;
+    /** 是否显示 */
+    get isVisible(): boolean;
+    set isVisible(isVisible: boolean);
+    /** 是否继承父级透明度 */
+    protected inheritOpacity: boolean;
+    private _opacity;
+    /** 透明度 */
+    get opacity(): number | undefined;
+    set opacity(opacity: number | undefined);
+    private _scaleRange?;
+    /** 显示范围 缩放比例 */
+    get scaleRange(): [number, number] | undefined;
+    set scaleRange(scaleRange: [number, number] | undefined);
+    /** 是否需要渲染 */
+    shouldRender(): boolean;
+}
+interface BaseDataOptions {
+    /** 父级 */
+    parent?: BaseData<any>;
+    /** 名称 */
+    name?: string;
+    /** 自定义扩展数据 */
+    extData?: any;
+    /** 主画布 */
+    mainCanvas?: _Canvas;
+    /** 通知重新加载 */
+    notifyReload?: (needForceExecute?: boolean) => void;
+    /** 是否显示 */
+    isVisible?: boolean;
+    /** 透明度 */
+    opacity?: number;
+    /** 显示范围 缩放比例 */
+    scaleRange?: [number, number];
+}
+/** 基础数据 公共 */
+export default abstract class BaseData<T extends BaseData<T>> extends Show<T> {
+    constructor(options: BaseDataOptions);
+}
+export {};

package/dist/Canvas/public/eventController.d.ts

@@ -0,0 +1,111 @@
+import { default as EventControllerBasedata } from './eventControllerBasedata';
+declare class _CanvasEvent<T = undefined> {
+    readonly data: T;
+    private propagationStopped;
+    constructor(data: T);
+    stopPropagation(): void;
+    get canPropagate(): boolean;
+}
+type State = {
+    state: boolean;
+    oldState: boolean;
+};
+type EventMap = {
+    wheel: number;
+    down: State;
+    contextmenu: State;
+    click: State;
+    doubleClick: State;
+    hover: State;
+    dragg: {
+        offsetX: number;
+        offsetY: number;
+    };
+};
+export type EventHandler<T extends keyof EventMap> = (event: _CanvasEvent<EventMap[T]>, mouseEvent?: MouseEvent) => void;
+export default abstract class EventController extends EventControllerBasedata<EventController> {
+    /** 事件管理器 */
+    private readonly listeners;
+    /** 添加事件监听器 */
+    addEventListener<T extends keyof EventMap>(type: T, handler: EventHandler<T>): void;
+    /** 移除事件监听器 */
+    removeEventListener<T extends keyof EventMap>(type: T, handler: EventHandler<T>): void;
+    /** 共享事件状态集合 控制器 */
+    private sharedControllers;
+    /** 注册指定类型的共享事件状态集合 */
+    registerControllers(type: keyof EventMap, controllers: EventController[]): void;
+    /** 检查指定类型下是否存在特定控制器 */
+    hasController(type: keyof EventMap, controller: EventController): boolean | undefined;
+    private trigger;
+    private updateStates;
+    private _eventDate;
+    private _clearEventDate;
+    private checkEventDate;
+    private _isHover;
+    /** 是否触发悬停 */
+    get isHover(): boolean;
+    /**
+     * 接收悬停状态变更通知（由外部事件处理器判断后调用）
+     * @param state - 当前悬停状态（true:进入元素 / false:离开元素）
+     * @param [event] - 可选的关联鼠标事件对象
+     */
+    notifyHover: (state: boolean, event?: MouseEvent) => false | void;
+    private _isDown;
+    /** 是否触发按下 */
+    get isDown(): boolean;
+    /**
+     * 接收鼠标按下状态变更通知（由外部事件处理器判断后调用）
+     * @param state - 当前按下状态（true:按下开始 / false:按下结束）
+     * @param [event] - 可选的关联鼠标事件对象
+     */
+    notifyDown: (state: boolean, event?: MouseEvent) => false | void;
+    private _isContextmenu;
+    /** 是否触发右击 */
+    get isContextmenu(): boolean;
+    /**
+     * 接收右键菜单触发通知（由外部事件处理器判断后调用）
+     * @param state - 右键触发状态（true: 右键开始 / false: 右键结束）
+     * @param [event] - 可选的关联鼠标事件对象
+     */
+    notifyContextmenu: (state: boolean, event?: MouseEvent) => false | void;
+    private _isClick;
+    /** 是否触发点击 */
+    get isClick(): boolean;
+    /** 点击时间 */
+    private clickTimestamp;
+    /** 双击判定，两次点击之间的间隔（毫秒） */
+    doubleClickInterval: number;
+    /**
+     * 接收单击动作通知（由外部事件处理器判断点击动作后调用）
+     * @param state - 点击状态（true: 单击开始 / false: 单击结束）
+     * @param [event] - 可选的关联鼠标事件对象
+     */
+    notifyClick: (state: boolean, event?: MouseEvent) => void;
+    private _isDblClick;
+    /** 是否触发双击 */
+    get isDblClick(): boolean;
+    /**
+     * 接收双击动作通知（由外部事件处理器判断双击动作后调用）
+     * @param state - 双击状态（true: 双击开始 / false: 双击结束）
+     * @param [event] - 可选的关联鼠标事件对象
+     */
+    notifyDoubleClick: (state: boolean, event?: MouseEvent) => false | void;
+    /**
+     * 接收拖拽位置更新通知（由外部事件处理器判断拖拽动作后调用）
+     * @param position - 当前拖拽位置坐标
+     * @param position.offsetX - 相对于元素X轴的偏移量
+     * @param position.offsetY - 相对于元素Y轴的偏移量
+     * @param [event] - 可选的关联鼠标事件对象
+     */
+    notifyDragg: (position: {
+        offsetX: number;
+        offsetY: number;
+    }, event?: MouseEvent) => false | void;
+    /**
+     * 接收滚轮滚动通知（由外部事件处理器判断滚轮动作后调用）
+     * @param step - 滚轮滚动步长（正数：向上滚动 / 负数：向下滚动）
+     * @param [event] - 可选的关联滚轮事件对象
+     */
+    notifyWheel: (step: number, event?: WheelEvent) => false | void;
+}
+export {};

package/dist/Canvas/public/eventControllerBasedata.d.ts

@@ -0,0 +1,62 @@
+import { default as BaseData } from './basedata';
+type EventControllerOptions<T extends EventControllerBasedata<T>> = ConstructorParameters<typeof BaseData<EventControllerBasedata<T>>>[0] & {
+    /** 是否可以触发交互事件 */
+    isInteractive?: boolean;
+    /** 是否可以触发悬停事件 */
+    isHoverable?: boolean;
+    /** 是否可以触发按下事件 */
+    isDownable?: boolean;
+    /** 是否可以触发右击事件 */
+    isContextmenuable?: boolean;
+    /** 是否可以触发点击事件 */
+    isClickable?: boolean;
+    /** 是否可以触发双击事件 */
+    isDoubleClickable?: boolean;
+    /** 是否可以触发拖动事件 */
+    isDraggable?: boolean;
+    /** 是否可以触发滚轮滚动事件 */
+    isWheelable?: boolean;
+};
+export default abstract class EventControllerBasedata<T extends EventControllerBasedata<T>> extends BaseData<T> {
+    private _isInteractive;
+    /** 是否可以触发交互事件 */
+    get isInteractive(): boolean;
+    set isInteractive(value: boolean);
+    private _isHoverable;
+    /** 是否可以触发悬停事件 */
+    get isHoverable(): boolean;
+    set isHoverable(value: boolean);
+    private _isDownable;
+    /** 是否可以触发按下事件 */
+    get isDownable(): boolean;
+    set isDownable(value: boolean);
+    private _isContextmenuable;
+    /** 是否可以触发右击事件 */
+    get isContextmenuable(): boolean;
+    set isContextmenuable(value: boolean);
+    private _isClickable;
+    /** 是否可以触发点击事件 */
+    get isClickable(): boolean;
+    set isClickable(value: boolean);
+    private _isDoubleClickable;
+    /** 是否可以触发双击事件 */
+    get isDoubleClickable(): boolean;
+    set isDoubleClickable(value: boolean);
+    private _isDraggable;
+    /** 是否可以触发拖动事件 */
+    get isDraggable(): boolean;
+    set isDraggable(value: boolean);
+    private _isWheelable;
+    /** 是否可以触发滚轮滚动事件 */
+    get isWheelable(): boolean;
+    set isWheelable(value: boolean);
+    /**
+     * 通用属性获取方法
+     * @param parentProp 父级属性名
+     * @param ownValue 当前实例的属性值
+     * @param checkInteractive 是否检查交互状态（isInteractive 属性专用）
+     */
+    private getPropValue;
+    constructor(options: EventControllerOptions<T>);
+}
+export {};

package/dist/Canvas/public/tools.d.ts

@@ -0,0 +1,6 @@
+export declare class _Number {
+    static add(a: number, b: number): number;
+    static sub(a: number, b: number): number;
+    static mul(a: number, b: number): number;
+    static div(a: number, b: number): number;
+}

package/dist/Element/index.d.ts

@@ -89,3 +89,20 @@ export declare function _Element_CalculateCanvasSize(aspectRatio: number, target
  * @returns 一个Promise对象，包含加载的图片对象及其宽高比
  */
 export declare function _Element_LoadImage(src: string, timeout?: number): Promise<[HTMLImageElement, number]>;
+/**
+ * 检查指定dom内所有图片的加载状态并返回结果
+ * @param id - 图片ID
+ * @returns - 图片加载状态信息
+ */
+export declare function _Element_CheckImagesLoaded(id: string): Promise<{
+    /** 是否全部加载完成 */
+    allLoaded: boolean;
+    /** 成功加载的图片数量 */
+    loaded: number;
+    /** 加载失败的图片数量 */
+    failed: number;
+    /** 总图片数量 */
+    total: number;
+    /** 加载失败的图片列表 */
+    errors: HTMLImageElement[];
+}>;

package/dist/Utility/index.d.ts

@@ -40,37 +40,21 @@ export declare function _Utility_Debounce<T extends (...args: any[]) => void>(fn
  */
 export declare function _Utility_Throttle<T extends (...args: any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
 /**
- * 根据路径初始化目标对象
- * 如果路径中某个属性不存在，则会创建该属性及其所有父属性
- * 最终返回路径的最后一个属性对应的值或undefined（如果路径不存在）
- *
- * @param {Object} model - 要初始化的模型对象
- * @param {string} path - 属性路径，使用英文句点分隔
- * @param {any} initValue - 初始值
- * @returns {any} 路径的最后一个属性对应的值或 initValue
- */
-export declare function _Utility_InitTargetByPath(model: any, path: string, initValue?: any): any;
-/**
- * 根据路径获取目标对象
- * 该函数用于在给定的模型中，通过路径字符串来获取深层嵌套的目标对象如果路径中的某一部分不存在，则会创建一个新的对象（除非已经是路径的最后一部分）
- *
- * @param {Object} model - 包含要查询的数据的模型对象
- * @param {string} path - 用点分隔的路径字符串，表示要访问的对象属性路径
- * @returns {Object|undefined} - 返回目标对象，如果路径不存在则返回undefined
+ * 根据路径从对象中获取目标值
+ * @param rootObject - 根对象
+ * @param path - 访问路径，支持点号和数组索引语法（如 "a1.b2[0].c3"）
+ * @returns 目标值，如果路径无效则返回根对象
  */
-export declare function _Utility_GetTargetByPath(model: any, path: string): any;
+export declare function _Utility_GetTargetByPath(rootObject: any, path: string): any;
 /**
- * 根据路径更新目标值
- *
- * 该函数通过一个点分隔的路径来更新一个对象中的嵌套属性值
- * 它使用了reduce方法来遍历路径数组，并在路径的终点设置新的值
- *
- * @param {Object} model - 包含要更新数据的模型对象
- * @param {string} path - 点分隔的字符串路径，指示如何到达目标属性
- * @param {*} value - 要设置的新值
- * @returns {*} - 返回更新后的模型对象中的值
+ * 根据路径设置对象中的目标值
+ * @param rootObject - 根对象
+ * @param path - 访问路径，支持点号和数组索引语法（如 "a1.b2[0].c3"）
+ * @param value - 要设置的值
+ * @param skipIfExists - 如果为true，当目标位置已有值时跳过设置
+ * @returns 设置后的根对象
  */
-export declare function _Utility_SetTargetByPath(model: any, path: string, value: any): any;
+export declare function _Utility_SetTargetByPath(rootObject: any, path: string, value: any, skipIfExists?: boolean): any;
 /**
  * 旋转列表函数
  *

package/dist/Utility/type.d.ts

@@ -0,0 +1,10 @@
+export declare const PATH_SEGMENT_REGEX: RegExp;
+export declare const ARRAY_PATH_REGEX: RegExp;
+export declare const ARRAY_PART_REGEX: RegExp;
+export declare const INDEX_EXTRACT_REGEX: RegExp;
+/**
+ * 解析路径字符串为路径段数组
+ * @param path - 需要解析的路径字符串
+ * @returns 路径段数组，如果路径为空则返回空数组
+ */
+export declare function _parsePathSegments(path: string): string[];

package/dist/Valid/index.d.ts

@@ -1,11 +1,5 @@
 import { FileType } from '../Constant';
 import { DataType, Point } from './type';
-/**
- * 是正常对象吗
- * @param {} value
- * @returns boolean
- */
-export declare function _Valid_IsObject(value: any): boolean;
 /**
  * 检查单个一维数组参数是否合法（元素为有限数字）
  * @param arr - 待检查的数组
@@ -97,7 +91,7 @@ export declare class _Valid_FileTypeChecker {
     static parseAddresses(url: string): {
         url: string;
         name: string;
-        type: "audio" | "code" | "script" | "video" | "image" | "ppt" | "word" | "excel" | "pdf" | "text" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
+        type: "audio" | "code" | "script" | "video" | "text" | "image" | "ppt" | "word" | "excel" | "pdf" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
     }[];
     /**
      * 检查 MIME 类型是否与指定的模式匹配
@@ -127,5 +121,5 @@ export declare class _Valid_FileTypeChecker {
      * @param {string} url - 文件的URL
      * @returns {string} - 如果URL与任何已知类型匹配，则返回文件类型，否则返回"unknown"
      */
-    static _detectFileType(url: string): "audio" | "code" | "script" | "video" | "image" | "ppt" | "word" | "excel" | "pdf" | "text" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
+    static _detectFileType(url: string): "audio" | "code" | "script" | "video" | "text" | "image" | "ppt" | "word" | "excel" | "pdf" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
 }