nhanh-pure-function 2.0.5 → 3.0.0

package/dist/Animate/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 进度
+ * @param {(schedule)=>void} callback callback( 进度百分比 )
+ * @param {Number} TIME 总时长
+ * @returns {Function} 停止函数
+ */
+export declare function _Animate_Schedule(callback: (schedule: number) => void, TIME?: number): () => boolean;
+/**
+ * 创建指定范围的振荡器，在最小值和最大值之间循环变化
+ * @param initialMin - 振荡器初始最小值
+ * @param initialMax - 振荡器初始最大值
+ * @param initialSteps - 从最小值到最大值所需的动画步数
+ * @param callback - 每帧更新时的回调函数，接收当前振荡值
+ * @param precision - 数值精度（保留小数位数，默认2位）
+ * @returns 振荡器控制对象，包含播放/暂停/参数更新等方法
+ */
+export declare function _Animate_CreateOscillator(initialMin: number, initialMax: number, initialSteps: number, callback: (value: number) => void, precision?: number): {
+    /** 启动/继续动画 */
+    play(target?: number): void;
+    /** 暂停动画 */
+    pause(): void;
+    /** 获取当前值 */
+    getCurrent: () => number;
+    /** 是否正在运行 */
+    isPlaying: () => boolean;
+    /** 更新参数（不中断动画） */
+    updateParams: (newMin: number, newMax: number, newSteps: number) => boolean;
+    /** 获取当前参数 */
+    getParams: () => {
+        min: number;
+        max: number;
+        steps: number;
+        precision: number;
+        stepSize: number;
+    };
+};
+/**
+ * 动画过渡数值变化
+ * @param startValue - 起始值
+ * @param targetValue - 目标值
+ * @param stepCount - 动画步数
+ * @param callback - 每帧回调函数
+ * @param precision - 数值精度（默认2位小数）
+ */
+export declare function _Animate_NumericTransition(startValue: number, targetValue: number, stepCount: number, callback: (currentValue: number) => void, precision?: number): void;

package/dist/Blob/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 将不同格式的数据转换为图像 URL
+ * 此函数支持多种类型的数据输入，包括字符串（Base64/Data URL）、ArrayBuffer、Uint8Array和File，
+ * 并尝试将这些数据转换为指定MIME类型的图像URL
+ *
+ * @param data - 输入数据，可以是字符串（Base64/Data URL）、ArrayBuffer、Uint8Array或File实例
+ * @param mimeType - 期望的图像MIME类型，默认为'image/png'
+ * @returns 成功时返回图像的URL，失败时返回null
+ */
+export declare function _Blob_ConvertDataToImageUrl(data: string | ArrayBuffer | Uint8Array | File, mimeType?: string): string | void | null;

package/dist/Browser/index.d.ts

@@ -0,0 +1,52 @@
+import { WindowTarget } from '../Constant';
+/**
+ * 获取帧率
+ * @param {(fps , frameTime)=>void} callback callback( 帧率 , 每帧时间 )
+ * @param {Number} referenceNode 参考节点数量
+ */
+export declare function _Browser_GetFrameRate(callback: (fps: number, frameTime: number) => void, referenceNode?: number): void;
+/**
+ * 复制到剪贴板
+ * @param {string} text
+ */
+export declare function _Browser_CopyToClipboard(text: string): Promise<void>;
+/**
+ * 管理通过键值对打开的窗口
+ */
+export declare class _Browser_KeyedWindowManager {
+    private static keys;
+    /** 请使用静态方法 */
+    private constructor();
+    /** 添加已有窗口 */
+    static add(key: string, win: Window): void;
+    /**
+     * 根据键打开或聚焦窗口
+     * @param key 窗口的唯一键
+     * @param url 要打开的URL
+     * @param target 窗口的目标
+     * @param windowFeatures 新窗口的特性
+     * @returns 返回已打开或新打开的窗口
+     */
+    static open(key: string, url?: string | URL, target?: WindowTarget, windowFeatures?: string): Window | undefined;
+    /**
+     * 检查指定键的窗口是否打开
+     * @param key 窗口的唯一键
+     * @returns 如果窗口打开则返回true，否则返回false
+     */
+    static isOpen(key: string): boolean;
+    /**
+     * 获取与指定键关联的窗口
+     * @param key 窗口的唯一键
+     * @returns 返回对应的窗口，如果窗口已关闭则返回undefined
+     */
+    static getWindow(key: string): Window | undefined;
+    /**
+     * 关闭与指定键关联的窗口
+     * @param key 窗口的唯一键
+     */
+    static close(key: string): void;
+    /**
+     * 关闭所有打开的窗口并清空Map
+     */
+    static closeAll(): void;
+}

package/dist/{User → Element}/index.d.ts

@@ -3,7 +3,7 @@ import { DragOption, LocalDragOptions, UiLibrary } from './type';
  * 滚动结束监听器
  * @param {(trigger: "vertical" | "horizontal") => void} callback
  */
-export declare function _ScrollEndListener(callback: (trigger: "vertical" | "horizontal") => void): (payload: Event) => void;
+export declare function _Element_ScrollEndListener(callback: (trigger: "vertical" | "horizontal") => void): (payload: Event) => void;
 /**
  * 点击非指定dom(包含子级dom)时执行 callback
  * @param  querySelector 允许点击的 dom 顶层祖先元素选择器
@@ -13,12 +13,12 @@ export declare function _ScrollEndListener(callback: (trigger: "vertical" | "hor
  * @param  options.uiLibrary 项目使用的 ui库 , 用于排除  ui库 创建的元素 , 避免点击 ui库 创建的元素时意外的执行 callback
  * @param  options.isClickAllowed 是否允许该点击 ( 如果不确定可以返回 undefined )
  */
-export declare function _CloseOnOutsideClick(querySelector: string[], callback: Function, options?: {
+export declare function _Element_CloseOnOutsideClick(querySelector: string[], callback: Function, options?: {
     uiLibrary?: UiLibrary[];
     isClickAllowed?: (event: MouseEvent) => boolean | undefined;
 }): void;
 /** 拖拽dom */
-export declare class _Drag {
+export declare class _Element_Drag {
     #private;
     init(dom: HTMLElement, option?: DragOption): void;
     finish(): void;
@@ -29,7 +29,7 @@ export declare class _Drag {
     mouseup(): void;
 }
 /** 局部拖拽 计算位置距离/百分比 */
-export declare class _LocalDrag {
+export declare class _Element_LocalDrag {
     #private;
     init(parentDom: HTMLElement, options?: LocalDragOptions): void;
     finish(): void;
@@ -48,23 +48,23 @@ export declare class _LocalDrag {
     mouseup(): void;
 }
 /** 进入全屏模式 */
-export declare function _EnterFullscreen(content: HTMLElement): Promise<void>;
+export declare function _Element_EnterFullscreen(content?: HTMLElement): Promise<void>;
 /** 退出全屏模式 */
-export declare function _ExitFullscreen(): Promise<void>;
+export declare function _Element_ExitFullscreen(): Promise<void>;
 /** 判断是否处于全屏模式 */
-export declare function _IsFullscreen(): HTMLElement | undefined;
+export declare function _Element_IsFullscreen(content?: HTMLElement): boolean;
 /**
  * 返回一个用于切换全屏模式的函数
  * @param {HTMLElement} content - 需要进入全屏的元素
  * 该函数通过检查不同浏览器的特定方法来实现全屏切换
  */
-export declare function _Fullscreen(content: HTMLElement): () => void;
+export declare function _Element_Fullscreen(content?: HTMLElement): () => void;
 /**
  * 单位转换 12** -> **px
  * @param {string} width
  * @returns 对应的单位为px的宽
  */
-export declare function _GetOtherSizeInPixels(width: string, target?: HTMLElement): number;
+export declare function _Element_GetOtherSizeInPixels(width: string, target?: HTMLElement): number;
 /**
  * 根据给定的宽高比和目标元素或尺寸，计算画布的尺寸
  * 此函数旨在适应不同场景下，如何根据宽高比约束，计算出适合的画布大小
@@ -73,11 +73,11 @@ export declare function _GetOtherSizeInPixels(width: string, target?: HTMLElemen
  * @param target 目标元素或尺寸，可以是DOM元素、选择器字符串或尺寸数组
  * @returns 返回计算后的画布尺寸，格式为[宽度, 高度]
  */
-export declare function _CalculateCanvasSize(aspectRatio: number, target: Element | string | [number, number]): number[] | undefined;
+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 _LoadImage(src: string, timeout?: number): Promise<[HTMLImageElement, number]>;
+export declare function _Element_LoadImage(src: string, timeout?: number): Promise<[HTMLImageElement, number]>;

package/dist/File/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 读取文件
+ * @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

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

@@ -1,68 +1,39 @@
-import { Point } from './type';
 /**
- * 转为百分比字符串
- * @param value 分子
- * @param totalValue 分母
- * @param decimalPlaces 保留小数位
- * @returns 10.00%
+ * 将经纬度转换为平面坐标
+ * @param lng 经度
+ * @param lat 纬度
+ * @returns 平面坐标 [x, y]（米）
  */
-export declare function _ConvertToPercentage(value: number, totalValue: number, decimalPlaces?: number): string;
+export declare function _Math_LngLatToPlane(lng: number, lat: number): [number, number];
 /**
- * 误差范围
- * @param value 需要判断的数字
- * @param target 目标数字
- * @param errorMargin 正负误差范围
- * @returns 是否在误差内
+ * 将平面坐标转换为经纬度
+ * @param x 平面坐标 X 值（米）
+ * @param y 平面坐标 Y 值（米）
+ * @returns 经纬度 [lng, lat]（度）
  */
-export declare function _IsWithinErrorMargin(value: number, target: number, errorMargin: number): boolean;
+export declare function _Math_PlaneToLngLat(x: number, y: number): [number, number];
 /**
- * 进度
- * @param {(schedule)=>void} callback callback( 进度百分比 )
- * @param {Number} TIME 总时长
- * @returns {Function} 停止函数
+ * 计算点到线段的距离
+ * @param point 点击位置
+ * @param lineStart 线段起点
+ * @param lineEnd 线段终点
+ * @returns 点到线段的距离
  */
-export declare function _Schedule(callback: (schedule: number) => void, TIME?: number): () => boolean;
+export declare function _Math_PointToLineDistance(point: [number, number], lineStart: [number, number], lineEnd: [number, number]): number;
 /**
- * 格式化数字，给数字加上千位分隔符。
- * @param {number} number - 要格式化的数字。
- * @returns {string} - 格式化后的字符串。
+ * 计算圆弧的起点和终点坐标
+ * @param x 圆心X坐标
+ * @param y 圆心Y坐标
+ * @param radius 圆弧半径
+ * @param startAngle 起始角度（弧度制，0表示X轴正方向）
+ * @param endAngle 结束角度（弧度制）
+ * @returns [起点坐标[x,y], 终点坐标[x,y]]
  */
-export declare function _FormatNumber(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 _FormatNumberWithUnit(value: string | number, config?: {
-    join?: boolean;
-    suffix?: string;
-    decimalPlaces?: number;
-}): string | (string | number)[];
-/**
- * 判断点是否在多边形内
- * @param point - 待检测的点，包含 x 和 y 坐标
- * @param polygon - 多边形的点集，数组形式，每个点包含 x 和 y 坐标
- * @returns boolean - 点是否在多边形内
- */
-export declare function _IsPointInPolygon(point: Point, polygon: Point[]): boolean;
-/**
- * 格式化文件大小
- * @param {number} size
- * @returns string
- */
-export declare function _FormatFileSize(size: number): string;
+export declare function _Math_GetArcPoints(x: number, y: number, radius: number, startAngle: number, endAngle: number): [[number, number], [number, number]];
 /** 计算平面直角坐标系中两点的距离 */
-export declare function _CalculateDistance2D(x1: number, y1: number, x2: number, y2: number): number;
+export declare function _Math_CalculateDistance2D(x1: number, y1: number, x2: number, y2: number): number;
 /** 获取两点的中点 */
-export declare function _GetMidpoint(x1: number, y1: number, x2: number, y2: number): {
+export declare function _Math_GetMidpoint(x1: number, y1: number, x2: number, y2: number): {
     x: number;
     y: number;
 };

package/dist/Math/type.d.ts

@@ -1,4 +0,0 @@
-export interface Point {
-    x: number;
-    y: number;
-}