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

package/dist/Element/type.d.ts

@@ -0,0 +1,33 @@
+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

@@ -0,0 +1,29 @@
+/**
+ * 读取文件
+ * @param src 文件地址
+ * @returns 文件的字符串内容
+ */
+export declare function _File_Read(src: string): Promise<string>;
+/**
+ * 下载文件并支持进度监控、超时控制和主动中止
+ *
+ * @param {string} href - 文件的 URL 路径或下载地址，需确保跨域权限或同源
+ * @param {string} [fileName] - 可选，指定导出的文件名（不含扩展名时会自动从 href 提取）
+ * @param {Function} [onProgress] - 可选，下载进度回调函数
+ * @param {number} [onProgress.progress] - 进度百分比（0-100）
+ * @param {number} [timeout=30000] - 可选，超时时间（毫秒），默认 30 秒
+ * @returns {Object} 返回包含两个属性的对象：
+ *   - promise: Promise 对象，成功时 resolve 下载的 Blob 数据，失败时 reject 错误信息
+ *   - abort: 中止下载的函数，调用后会触发 abort 错误
+ */
+export declare function _File_Download(href: string, fileName?: string, onProgress?: (progress: number) => void, timeout?: number): {
+    promise: Promise<Blob>;
+    abort: () => false | void;
+};
+/**
+ * 创建文件并下载
+ * @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

@@ -0,0 +1,75 @@
+/**
+ * 首字母大写
+ * @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

@@ -0,0 +1,56 @@
+/**
+ * 将经纬度转换为平面坐标
+ * @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];
+/**
+ * 角度制数学工具代理
+ * 对于三角函数：自动将输入的角度转换为弧度
+ * 对于其他方法：直接调用原生Math方法
+ */
+export declare const _Math_Degree: Math;

package/dist/Utility/index.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 寻找空闲时机执行传入方法
+ * @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

@@ -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

@@ -0,0 +1,125 @@
+import { FileType } from '../Constant';
+import { DataType, Point } from './type';
+/**
+ * 检查单个一维数组参数是否合法（元素为有限数字）
+ * @param arr - 待检查的数组
+ * @param minLength - 数组最小长度 (默认2)
+ * @returns 参数合法返回 true，否则返回 false
+ */
+export declare function _Valid_IsNumberArray(arr: unknown, minLength?: number): boolean;
+/**
+ * 检查二维数组结构是否合法（每个元素都是有效的一维数组）
+ * @param arr - 待检查的二维数组
+ * @param minLength - 外层数组最小长度 (默认1)
+ * @param innerMinLength - 内层数组最小长度 (默认2)
+ * @returns 所有元素都合法返回 true，否则返回 false
+ */
+export declare function _Valid_Is2DNumberArray(arr: unknown, minLength?: number, innerMinLength?: number): boolean;
+/**
+ * 误差范围
+ * @param value 需要判断的数字
+ * @param target 目标数字
+ * @param errorMargin 正负误差范围
+ * @returns 是否在误差内
+ */
+export declare function _Valid_IsInMargin(value: number, target: number, errorMargin: number): boolean;
+/**
+ * 判断点是否在多边形内
+ * @param point - 待检测的点，包含 x 和 y 坐标
+ * @param polygon - 多边形的点集，数组形式，每个点包含 x 和 y 坐标
+ * @returns boolean - 点是否在多边形内
+ */
+export declare function _Valid_IsPointInPolygon(point: Point, polygon: Point[]): boolean;
+/**
+ * 判断无限延伸的直线是否与矩形区域相交
+ * @param rectCorner1 矩形对角顶点1 [x, y]
+ * @param rectCorner2 矩形对角顶点2 [x, y]
+ * @param linePointA 直线上一点A [x, y]
+ * @param linePointB 直线上一点B [x, y]
+ * @returns 直线是否与矩形相交
+ */
+export declare function _Valid_DoesInfiniteLineIntersectRectangle(rectCorner1: [number, number], rectCorner2: [number, number], linePointA: [number, number], linePointB: [number, number]): boolean;
+/**
+ * 数据类型
+ * @param {any} value
+ * @returns string
+ */
+export declare function _Valid_DataType(value: any): DataType;
+/**
+ * 判断给定URL是否指向一个安全上下文
+ *
+ * 安全上下文是指通过一系列安全协议访问的资源，这些协议提供了数据的加密传输和身份验证
+ * 本函数通过检查URL的协议前缀来判断是否属于安全上下文
+ *
+ * @param {string} url - 待检查的URL字符串
+ * @returns {boolean} - 如果URL指向安全上下文，则返回true；否则返回false
+ */
+export declare function _Valid_IsSecureContext(url: string): boolean;
+/**
+ * 使用 XMLHttpRequest 检查指定 URL 的连接状态
+ *
+ * 此函数通过发送一个 HEAD 请求来检查给定 URL 是否可访问 HEAD 请求仅请求文档头部信息，
+ * 而不是整个页面，因此比 GET 或 POST 请求更快此方法常用于检查 URL 是否有效，以及服务器的响应时间等
+ *
+ * @param {string} url - 需要检查连接的 URL 地址
+ * @returns {Promise} - 返回一个 Promise 对象，该对象在连接成功时解析，在连接失败时拒绝
+ */
+export declare function _Valid_CheckConnectionWithXHR(url: string): Promise<unknown>;
+/**
+ * 文件类型检查器类
+ * 用于检查文件URL的类型
+ */
+export declare class _Valid_FileTypeChecker {
+    private static cachedEntries;
+    constructor();
+    /**
+     * 检查给定URL的文件类型
+     * @param {string} url - 文件的URL
+     * @param {string} [type] - 可选参数，指定要检查的文件类型
+     * @returns {string} - 如果URL与指定类型或任何已知类型匹配，则返回文件类型，否则返回"unknown"
+     */
+    static check(url: string): FileType | "unknown";
+    static check(url: string, type: FileType): boolean;
+    /**
+     * 静态方法，用于解析地址信息
+     * 该方法接受一个URL字符串，将其解析为一个包含地址详情的对象数组
+     * 主要用于批量处理以逗号分隔的URL列表，为每个URL生成相应的名称和类型
+     *
+     * @param {string} url - 以逗号分隔的URL字符串，每个URL代表一个资源的位置
+     * @returns {Array} - 包含每个URL及其相关信息（名称和类型）的对象数组
+     */
+    static parseAddresses(url: string): {
+        url: string;
+        name: string;
+        type: "audio" | "code" | "script" | "video" | "text" | "image" | "ppt" | "word" | "excel" | "pdf" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
+    }[];
+    /**
+     * 检查 MIME 类型是否与指定的模式匹配
+     * @param {string} type - 要检查的 MIME 类型（如 "image/png"）
+     * @param {string} [accept] - 可接受的 MIME 类型模式（如 "image/*, text/plain"）
+     * @returns {boolean} - 如果类型匹配，则返回 true，否则返回 false
+     */
+    static matchesMimeType(type: string, accept?: string): boolean;
+    /**
+     * 类型标准化函数
+     * 该函数旨在将文件类型或MIME类型字符串转换为标准格式
+     * 主要处理三种情况：带扩展名的字符串、简写格式的类型以及已标准格式的类型
+     *
+     * @param {string} type - 文件类型或MIME类型字符串
+     * @returns {string} 标准化的MIME类型字符串，如果无法识别则返回原始输入
+     */
+    static _normalizeType(type: string): string;
+    /**
+     * 检查URL是否具有任何指定的文件扩展名
+     * @param {string} url - 文件的URL
+     * @param {string[]} validExtensions - 有效文件扩展名的数组
+     * @returns {boolean} - 如果URL具有任何指定的文件扩展名，则返回true，否则返回false
+     */
+    static _checkExtension(url: string, validExtensions: string[]): boolean;
+    /**
+     * 检测文件URL的类型
+     * @param {string} url - 文件的URL
+     * @returns {string} - 如果URL与任何已知类型匹配，则返回文件类型，否则返回"unknown"
+     */
+    static _detectFileType(url: string): "audio" | "code" | "script" | "video" | "text" | "image" | "ppt" | "word" | "excel" | "pdf" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
+}

package/dist/Valid/type.d.ts

@@ -0,0 +1,6 @@
+export interface Point {
+    x: number;
+    y: number;
+}
+/** 定义所有可能的数据类型字符串 */
+export type DataType = "null" | "undefined" | "boolean" | "number" | "string" | "symbol" | "bigint" | "function" | "array" | "object" | "date" | "regexp" | "map" | "set" | "error" | "promise" | "weakmap" | "weakset" | "file" | "arraybuffer" | "dataview" | "int8array" | "uint8array" | "uint8clampedarray" | "int16array" | "uint16array" | "int32array" | "uint32array" | "float32array" | "float64array" | "bigint64array" | "biguint64array";