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

package/dist/Constant.d.ts

@@ -1,256 +0,0 @@
-export declare const EXTENSION_TO_MIME: {
-    ".mp3": string;
-    ".mp4": string;
-    ".m4a": string;
-    ".aac": string;
-    ".ogg": string;
-    ".wav": string;
-    ".flac": string;
-    ".opus": string;
-    ".webm": string;
-    ".avi": string;
-    ".mov": string;
-    ".wmv": string;
-    ".png": string;
-    ".jpg": string;
-    ".jpeg": string;
-    ".gif": string;
-    ".bmp": string;
-    ".tiff": string;
-    ".ico": string;
-    ".svg": string;
-    ".webp": string;
-    ".heif": string;
-    ".heic": string;
-    ".json": string;
-    ".xml": string;
-    ".html": string;
-    ".htm": string;
-    ".css": string;
-    ".js": string;
-    ".ts": string;
-    ".csv": string;
-    ".tsv": string;
-    ".txt": string;
-    ".md": string;
-    ".rtf": string;
-    ".pdf": string;
-    ".zip": string;
-    ".rar": string;
-    ".tar": string;
-    ".gz": string;
-    ".7z": string;
-    ".exe": string;
-    ".apk": string;
-    ".doc": string;
-    ".docx": string;
-    ".xls": string;
-    ".xlsx": string;
-    ".ppt": string;
-    ".pptx": string;
-    ".odt": string;
-    ".ods": string;
-    ".odp": string;
-    ".jsonld": string;
-    ".yaml": string;
-    ".yml": string;
-    ".woff": string;
-    ".woff2": string;
-    ".ttf": string;
-    ".otf": string;
-    ".eot": string;
-    ".map": string;
-};
-/** 文件扩展名对应的MIME类型 */
-export declare const FILE_EXTENSIONS: {
-    image: string[];
-    ppt: string[];
-    word: string[];
-    excel: string[];
-    pdf: string[];
-    text: string[];
-    audio: string[];
-    video: string[];
-    archive: string[];
-    code: string[];
-    font: string[];
-    database: string[];
-    markup: string[];
-    configuration: string[];
-    logs: string[];
-    script: string[];
-};
-/** 文件扩展名 */
-export type FileType = keyof typeof FILE_EXTENSIONS;
-/** 单位标签 */
-export declare const UNIT_LABELS: readonly ["", "万", "亿", "兆", "京", "垓", "秭", "穰", "沟", "涧", "正", "载", "极"];
-/** 浏览器窗口目标 */
-export declare const WINDOW_TARGET: readonly ["_self", "_blank", "_parent", "_top"];
-/** 浏览器窗口目标类型 */
-export type WindowTarget = (typeof WINDOW_TARGET)[number];
-/** 纸张尺寸 */
-export declare const PAPER_SIZE_DEFINITIONS: {
-    readonly Letter: {
-        readonly width: 215.9;
-        readonly height: 279.4;
-    };
-    readonly Legal: {
-        readonly width: 215.9;
-        readonly height: 355.6;
-    };
-    readonly Tabloid: {
-        readonly width: 279.4;
-        readonly height: 431.8;
-    };
-    readonly Ledger: {
-        readonly width: 431.8;
-        readonly height: 279.4;
-    };
-    readonly Executive: {
-        readonly width: 184.2;
-        readonly height: 266.7;
-    };
-    readonly Folio: {
-        readonly width: 215.9;
-        readonly height: 330.2;
-    };
-    readonly Quarto: {
-        readonly width: 215;
-        readonly height: 275;
-    };
-    readonly "Government-Letter": {
-        readonly width: 203.2;
-        readonly height: 266.7;
-    };
-    readonly A0: {
-        readonly width: 841;
-        readonly height: 1189;
-    };
-    readonly A1: {
-        readonly width: 594;
-        readonly height: 841;
-    };
-    readonly A2: {
-        readonly width: 420;
-        readonly height: 594;
-    };
-    readonly A3: {
-        readonly width: 297;
-        readonly height: 420;
-    };
-    readonly A4: {
-        readonly width: 210;
-        readonly height: 297;
-    };
-    readonly A5: {
-        readonly width: 148;
-        readonly height: 210;
-    };
-    readonly A6: {
-        readonly width: 105;
-        readonly height: 148;
-    };
-    readonly A7: {
-        readonly width: 74;
-        readonly height: 105;
-    };
-    readonly A8: {
-        readonly width: 52;
-        readonly height: 74;
-    };
-    readonly A9: {
-        readonly width: 37;
-        readonly height: 52;
-    };
-    readonly A10: {
-        readonly width: 26;
-        readonly height: 37;
-    };
-    readonly B0: {
-        readonly width: 1000;
-        readonly height: 1414;
-    };
-    readonly B1: {
-        readonly width: 707;
-        readonly height: 1000;
-    };
-    readonly B2: {
-        readonly width: 500;
-        readonly height: 707;
-    };
-    readonly B3: {
-        readonly width: 353;
-        readonly height: 500;
-    };
-    readonly B4: {
-        readonly width: 250;
-        readonly height: 353;
-    };
-    readonly B5: {
-        readonly width: 176;
-        readonly height: 250;
-    };
-    readonly B6: {
-        readonly width: 125;
-        readonly height: 176;
-    };
-    readonly B7: {
-        readonly width: 88;
-        readonly height: 125;
-    };
-    readonly B8: {
-        readonly width: 62;
-        readonly height: 88;
-    };
-    readonly B9: {
-        readonly width: 44;
-        readonly height: 62;
-    };
-    readonly B10: {
-        readonly width: 31;
-        readonly height: 44;
-    };
-    readonly C0: {
-        readonly width: 917;
-        readonly height: 1297;
-    };
-    readonly C1: {
-        readonly width: 648;
-        readonly height: 917;
-    };
-    readonly C2: {
-        readonly width: 458;
-        readonly height: 648;
-    };
-    readonly C3: {
-        readonly width: 324;
-        readonly height: 458;
-    };
-    readonly C4: {
-        readonly width: 229;
-        readonly height: 324;
-    };
-    readonly C5: {
-        readonly width: 162;
-        readonly height: 229;
-    };
-    readonly C6: {
-        readonly width: 114;
-        readonly height: 162;
-    };
-    readonly C7: {
-        readonly width: 81;
-        readonly height: 114;
-    };
-    readonly C8: {
-        readonly width: 57;
-        readonly height: 81;
-    };
-};
-/** 纸张尺寸 */
-export type PaperType = keyof typeof PAPER_SIZE_DEFINITIONS;
-/** 纸张尺寸列表 */
-export declare const PAPER_SIZE_OPTIONS: {
-    value: string;
-    label: string;
-}[];

package/dist/Element/index.d.ts

@@ -1,108 +0,0 @@
-import { DragOption, LocalDragOptions, UiLibrary } from './type';
-/**
- * 滚动结束监听器
- * @param {(trigger: "vertical" | "horizontal") => void} callback
- */
-export declare function _Element_ScrollEndListener(callback: (trigger: "vertical" | "horizontal") => void): (payload: Event) => void;
-/**
- * 点击非指定dom(包含子级dom)时执行 callback
- * @param  querySelector 允许点击的 dom 顶层祖先元素选择器
- * @param  callback 满足条件时执行的回调
- *
- * @param  options 其他配置
- * @param  options.uiLibrary 项目使用的 ui库 , 用于排除  ui库 创建的元素 , 避免点击 ui库 创建的元素时意外的执行 callback
- * @param  options.isClickAllowed 是否允许该点击 ( 如果不确定可以返回 undefined )
- */
-export declare function _Element_CloseOnOutsideClick(querySelector: string[], callback: Function, options?: {
-    uiLibrary?: UiLibrary[];
-    isClickAllowed?: (event: MouseEvent) => boolean | undefined;
-}): void;
-/** 拖拽dom */
-export declare class _Element_Drag {
-    #private;
-    init(dom: HTMLElement, option?: DragOption): void;
-    finish(): void;
-    bindOrUnbindEvent(type: "bind" | "unbind"): void;
-    alterLocation(): void;
-    mousedown(event: Event): void;
-    mousemove(event: Event): void;
-    mouseup(): void;
-}
-/** 局部拖拽 计算位置距离/百分比 */
-export declare class _Element_LocalDrag {
-    #private;
-    init(parentDom: HTMLElement, options?: LocalDragOptions): void;
-    finish(): void;
-    bindOrUnbindEvent(type: "bind" | "unbind"): void;
-    updateValue(): {
-        top: number;
-        left: number;
-        percentage: {
-            top: number;
-            left: number;
-        };
-    };
-    alterLocation(): void;
-    mousedown(event: Event): void;
-    mousemove(event: Event): void;
-    mouseup(): void;
-}
-/** 进入全屏模式 */
-export declare function _Element_EnterFullscreen(element?: HTMLElement | string): Promise<void>;
-/** 退出全屏模式 */
-export declare function _Element_ExitFullscreen(): Promise<void>;
-/** 判断是否处于全屏模式 */
-export declare function _Element_IsFullscreen(element?: HTMLElement | string): boolean;
-/**
- * 返回一个用于切换全屏模式的函数
- * @param {HTMLElement} content - 需要进入全屏的元素
- * 该函数通过检查不同浏览器的特定方法来实现全屏切换
- */
-export declare function _Element_Fullscreen(element?: HTMLElement | string): () => void;
-/**
- * 元素全屏状态观察器
- * 监听元素的全屏状态变化，并通过回调函数通知状态改变
- * @param notify - 全屏状态变化回调函数，接收一个布尔值参数表示当前是否为全屏状态
- * @param selectors - 要观察的元素或元素选择器，默认为document.documentElement
- * @returns 返回一个清理函数，调用后可移除所有事件监听器
- */
-export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): () => void;
-/**
- * 单位转换 12** -> **px
- * @param {string} width
- * @returns 对应的单位为px的宽
- */
-export declare function _Element_GetOtherSizeInPixels(width: string, target?: HTMLElement): number;
-/**
- * 根据给定的宽高比和目标元素或尺寸，计算画布的尺寸
- * 此函数旨在适应不同场景下，如何根据宽高比约束，计算出适合的画布大小
- *
- * @param aspectRatio 宽高比，表示期望的画布宽度与高度的比例
- * @param target 目标元素或尺寸，可以是DOM元素、选择器字符串或尺寸数组
- * @returns 返回计算后的画布尺寸，格式为[宽度, 高度]
- */
-export declare function _Element_CalculateCanvasSize(aspectRatio: number, target: Element | string | [number, number]): number[] | undefined;
-/**
- * 异步加载图片，并返回图片对象及其宽高比
- * @param src 图片的URL地址
- * @param timeout 超时时间，单位为毫秒，默认为5000ms
- * @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/Element/type.d.ts

@@ -1,33 +0,0 @@
-export type UiLibrary = "naiveUI" | "ElementPlus" | "Element";
-export type EventFunctionMap = Partial<Record<"mousedown" | "mousemove" | "mouseup" | "click" | "touchstart" | "touchmove" | "touchend" | "touchcancel", (event: Event) => void>>;
-/** 拖拽配置 */
-export type DragOption = {
-    /** 拖拽范围限制 */
-    limit?: {
-        max: {
-            top: number;
-            left: number;
-        };
-        min: {
-            top: number;
-            left: number;
-        };
-    };
-    /** 指定的拖拽元素 */
-    dragDom?: HTMLElement;
-};
-/** 更新后的位置信息 */
-export type UpdateValue = {
-    top: number;
-    left: number;
-    percentage?: {
-        top: number;
-        left: number;
-    };
-};
-/** 局部拖拽配置 */
-export type LocalDragOptions = {
-    limit?: DragOption["limit"];
-    update_move?: (value: UpdateValue) => void | undefined;
-    update_up?: (value: UpdateValue) => void | undefined;
-};

package/dist/File/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * 读取文件
- * @param src 文件地址
- * @returns 文件的字符串内容
- */
-export declare function _File_Read(src: string): Promise<string>;
-/**
- * 下载文件
- * @param {string} href - 文件路径
- * @param {string} [fileName] - 导出文件名
- */
-export declare function _File_Download(href: string, fileName?: string): Promise<unknown>;
-/**
- * 创建文件并下载
- * @param {BlobPart[]} content 文件内容
- * @param {string} fileName 文件名称
- * @param {BlobPropertyBag} options Blob 配置
- */
-export declare function _File_CreateAndDownload(content: BlobPart[], fileName: string, options?: BlobPropertyBag): void;

package/dist/Format/index.d.ts

@@ -1,75 +0,0 @@
-/**
- * 首字母大写
- * @param str
- * @returns string
- */
-export declare function _Format_CapitalizeFirstLetter(string: string): string;
-/**
- * 转为百分比字符串
- * @param value 分子
- * @param totalValue 分母
- * @param decimalPlaces 保留小数位
- * @returns 10.00%
- */
-export declare function _Format_Percentage(value: number, totalValue: number, decimalPlaces?: number): string;
-/**
- * 格式化数字，给数字加上千位分隔符。
- * @param {number} number - 要格式化的数字。
- * @returns {string} - 格式化后的字符串。
- */
-export declare function _Format_NumberWithCommas(number: number): string;
-/**
- * 将纯数字转换为带单位的数字格式
- *
- * @param value - 要转换的数字或字符串形式的数字
- * @param config - 配置对象
- * @param config.join - 是否将数字和单位拼接成一个字符串，默认为 `false`
- * @param config.suffix - 单位后缀，默认为 `万`
- * @param config.decimalPlaces - 保留的小数位数，默认为 `2`
- *
- * @returns 返回转换后的结果：
- * - 如果 `config.join` 为 `true`，返回拼接后的字符串，如 "12.34万"
- * - 如果 `config.join` 为 `false`，返回一个数组，如 [ 12.34, '万' ]
- */
-export declare function _Format_NumberWithUnit(value: string | number, config?: {
-    join?: boolean;
-    suffix?: string;
-    decimalPlaces?: number;
-}): string | (string | number)[];
-/**
- * 格式化文件大小
- * @param {number} size
- * @returns string
- */
-export declare function _Format_FileSize(size: number): string;
-/**
- * 时间戳转换字符串
- * @param {Number | Date} time 时间戳或Date对象
- * @param {String} template 完整模板 -->  YYYY MM DD hh mm ss ms
- * @param {Boolean} pad 补0
- */
-export declare function _Format_Timestamp(time: number | Date, template?: string, pad?: boolean): string;
-/**
- * 从给定的href中提取名称部分
- * 该函数旨在处理URL字符串，并返回URL路径的最后一部分，去除查询参数
- *
- * @param {string} href - 待处理的URL字符串
- * @param {string} [defaultName="file"] - 默认的文件名，当无法提取时使用
- * @returns {string} URL路径的最后一部分，不包括查询参数
- */
-export declare function _Format_HrefName(href: string, defaultName?: string): string;
-/**
- * 驼峰命名
- * @param {字符串} str
- * @param {是否删除分割字符} isRemoveDelimiter
- * @returns 'wq1wqw-qw2qw' -> 'wq1Wqw-Qw2Qw' / 'wqWqwQwQw'
- */
-export declare function _Format_CamelCase(str: string, isRemoveDelimiter?: boolean): string;
-/**
- * 排除子串
- * @param inputString 需裁剪字符串
- * @param substringToDelete 被裁减字符串
- * @param delimiter 分隔符
- * @returns 裁减后的字符串
- */
-export declare function _Format_ExcludeSubstring(inputString: string, substringToDelete: string, delimiter?: string): string;

package/dist/Math/index.d.ts

@@ -1,50 +0,0 @@
-/**
- * 将经纬度转换为平面坐标
- * @param lng 经度
- * @param lat 纬度
- * @returns 平面坐标 [x, y]（米）
- */
-export declare function _Math_LngLatToPlane(lng: number, lat: number): [number, number];
-/**
- * 将平面坐标转换为经纬度
- * @param x 平面坐标 X 值（米）
- * @param y 平面坐标 Y 值（米）
- * @returns 经纬度 [lng, lat]（度）
- */
-export declare function _Math_PlaneToLngLat(x: number, y: number): [number, number];
-/**
- * 计算点到线段的距离
- * @param point 点击位置
- * @param lineStart 线段起点
- * @param lineEnd 线段终点
- * @returns 点到线段的距离
- */
-export declare function _Math_PointToLineDistance(point: [number, number], lineStart: [number, number], lineEnd: [number, number]): number;
-/**
- * 计算圆弧的起点和终点坐标
- * @param x 圆心X坐标
- * @param y 圆心Y坐标
- * @param radius 圆弧半径
- * @param startAngle 起始角度（弧度制，0表示X轴正方向）
- * @param endAngle 结束角度（弧度制）
- * @param axisX X轴方向（1=正方向向右，-1=正方向向左）
- * @param axisY Y轴方向（1=正方向向上，-1=正方向向下）
- * @returns [起点坐标[x,y], 终点坐标[x,y]]
- */
-export declare function _Math_GetArcPoints(x: number, y: number, radius: number, startAngle: number, endAngle: number, axisX?: number, axisY?: number): [[number, number], [number, number]];
-/** 计算平面直角坐标系中两点的距离 */
-export declare function _Math_CalculateDistance2D(x1: number, y1: number, x2: number, y2: number): number;
-/** 获取两点的中点 */
-export declare function _Math_GetMidpoint(x1: number, y1: number, x2: number, y2: number): {
-    x: number;
-    y: number;
-};
-/**
- * 计算从起点沿方向向量延伸后与画布边界的交点
- * @param startPoint 线段起点坐标 [x, y]
- * @param direction 方向向量 [dx, dy]
- * @param canvasWidth 画布宽度
- * @param canvasHeight 画布高度
- * @returns 与边界的交点坐标
- */
-export declare function _Math_GetBoundaryIntersection(startPoint: [number, number], direction: [number, number], canvasWidth: number, canvasHeight: number): [number, number];

package/dist/Utility/index.d.ts

@@ -1,90 +0,0 @@
-/**
- * 寻找空闲时机执行传入方法
- * @param callback  需执行的方法
- */
-export declare function _Utility_ExecuteWhenIdle(callback: Function): void;
-/**
- * 等待条件满足
- * @param conditionChecker 条件检查器
- * @param timeoutMillis 超时毫秒数
- * @returns Promise<unknown>
- */
-export declare function _Utility_WaitForCondition(conditionChecker: () => boolean, timeoutMillis: number): Promise<"完成" | "超时">;
-/**
- * 合并对象  注意: 本函数会直接操作 A
- * @param {Object | Array} A
- * @param {Object | Array} B
- * @returns (A & B) | A | B | undefined
- */
-export declare function _Utility_MergeObjects<T, T1>(A: T, B: T1, visitedObjects?: [any, any][], outTime?: number): (T & T1) | T | T1 | undefined;
-/**
- * 生成一个UUID（通用唯一标识符）字符串
- * 可以选择性地在UUID前面添加前缀
- *
- * @param {string} prefix - 可选参数，要添加到UUID前面的前缀
- * @returns {string} 一个带有可选前缀的UUID字符串
- */
-export declare function _Utility_GenerateUUID(prefix?: string): string;
-/**
- * 防抖
- * @param {Function} fn
- * @param {number} delay
- * @returns {Function}
- */
-export declare function _Utility_Debounce<T extends (...args: any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
-/**
- * 节流
- * @param {Function} fn
- * @param {number} delay
- * @returns {Function}
- */
-export declare function _Utility_Throttle<T extends (...args: any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
-/**
- * 根据路径从对象中获取目标值
- * @param rootObject - 根对象
- * @param path - 访问路径，支持点号和数组索引语法（如 "a1.b2[0].c3"）
- * @returns 目标值，如果路径无效则返回根对象
- */
-export declare function _Utility_GetTargetByPath(rootObject: any, path: string): any;
-/**
- * 根据路径设置对象中的目标值
- * @param rootObject - 根对象
- * @param path - 访问路径，支持点号和数组索引语法（如 "a1.b2[0].c3"）
- * @param value - 要设置的值
- * @param skipIfExists - 如果为true，当目标位置已有值时跳过设置
- * @returns 设置后的根对象
- */
-export declare function _Utility_SetTargetByPath(rootObject: any, path: string, value: any, skipIfExists?: boolean): any;
-/**
- * 旋转列表函数
- *
- * 该函数接受一个列表作为参数，并返回一个二维数组，其中每个内部数组都是原列表的一种旋转形式
- * 旋转列表的原理是将原列表分割成两部分，并将这两部分重新组合，形成一个新的列表
- *
- * @param list T[] - 需要旋转的列表，列表元素类型为泛型T
- * @returns T[][] - 返回一个二维数组，每个内部数组代表原列表的一种旋转形式
- */
-export declare function _Utility_RotateList<T>(list: T[]): T[][];
-/**
- * 克隆给定值的函数
- * 该函数尝试使用window.structuredClone方法进行深克隆，如果失败则使用自定义方法
- * @param {any} val - 需要克隆的值
- * @returns {any} - 克隆后的值
- */
-export declare function _Utility_Clone<T>(val: T): T;
-/**
- * 函数装饰器，用于测量并记录另一个函数的执行时间
- * @param func 要测量执行时间的函数
- * @param level 耗时与颜色对应的数组，用于在控制台中着色显示
- * @param maxHistory 保留的最大历史记录数，默认为30
- */
-export declare function _Utility_TimeConsumption(func: Function, level: [number, string][], maxHistory?: number): void | ((...args: any[]) => any);
-/**
- * 暂停执行指定毫秒数的操作
- * 此函数通过 busy-wait（忙等待）的方式实现，它会持续执行一些无用的操作以消耗时间
- * 这种方法虽然简单，但会占用CPU资源，因此不推荐在实际应用中使用
- *
- * @param ms 暂停的毫秒数
- * @returns 实际暂停的毫秒数
- */
-export declare function _Utility_Sleep(ms: number): number;

package/dist/Utility/type.d.ts

@@ -1,10 +0,0 @@
-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[];