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

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 ADMINnhanh
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 ADMINnhanh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,19 @@
-# nhanh-pure-function
-
-纯函数工具库，提供了一些常用的纯函数工具，帮助您在 JavaScript/TypeScript 项目中更高效地处理数据。
-
-## 安装
-
-您可以通过 npm 安装该库：
-
-```bash
-npm install nhanh-pure-function
-```
-
-## 功能介绍
-
-`nhanh-pure-function` 库旨在提供一系列纯函数，这些函数在处理数据时不会产生副作用，确保函数的输入和输出之间的映射关系是确定的。这使得代码更易于测试、维护和复用。
-
-## 许可证
-
+# nhanh-pure-function
+
+纯函数工具库，提供了一些常用的纯函数工具，帮助您在 JavaScript/TypeScript 项目中更高效地处理数据。
+
+## 安装
+
+您可以通过 npm 安装该库：
+
+```bash
+npm install nhanh-pure-function
+```
+
+## 功能介绍
+
+`nhanh-pure-function` 库旨在提供一系列纯函数，这些函数在处理数据时不会产生副作用，确保函数的输入和输出之间的映射关系是确定的。这使得代码更易于测试、维护和复用。
+
+## 许可证
+
 [MIT](https://opensource.org/licenses/MIT)

package/package.json

@@ -1,45 +1,46 @@
-{
-  "name": "nhanh-pure-function",
-  "version": "3.0.5",
-  "description": "纯函数工具",
-  "main": "./dist/index.cjs.js",
-  "module": "./dist/index.es.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "vite build",
-    "test": "jest --coverage"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.26.9",
-    "@babel/preset-env": "^7.26.9",
-    "@types/jest": "^29.5.14",
-    "babel-jest": "^29.7.0",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "less": "^4.2.2",
-    "ts-jest": "^29.2.5",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.7.3",
-    "vite": "^6.1.0",
-    "vite-plugin-css-injected-by-js": "^3.5.2",
-    "vite-plugin-dts": "^4.5.0",
-    "vite-tsconfig-paths": "^5.1.4"
-  },
-  "keywords": [
-    "pure-function",
-    "format"
-  ],
-  "author": "nhanh",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ADMINnhanh/nhanh-pure-function.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ADMINnhanh/nhanh-pure-function/issues"
-  },
-  "homepage": "https://github.com/ADMINnhanh/nhanh-pure-function#readme"
-}
+{
+  "name": "nhanh-pure-function",
+  "version": "3.0.6-beta.2",
+  "description": "纯函数工具",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.es.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "build:dev": "vite build --mode development",
+    "test": "jest --coverage"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.26.9",
+    "@babel/preset-env": "^7.26.9",
+    "@types/jest": "^29.5.14",
+    "babel-jest": "^29.7.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "less": "^4.2.2",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.1.0",
+    "vite-plugin-css-injected-by-js": "^3.5.2",
+    "vite-plugin-dts": "^4.5.0",
+    "vite-tsconfig-paths": "^5.1.4"
+  },
+  "keywords": [
+    "pure-function",
+    "format"
+  ],
+  "author": "nhanh",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ADMINnhanh/nhanh-pure-function.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ADMINnhanh/nhanh-pure-function/issues"
+  },
+  "homepage": "https://github.com/ADMINnhanh/nhanh-pure-function#readme"
+}

package/dist/Animate/index.d.ts

@@ -1,45 +0,0 @@
-/**
- * 进度
- * @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

@@ -1,10 +0,0 @@
-/**
- * 将不同格式的数据转换为图像 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

@@ -1,77 +0,0 @@
-import { PaperType, 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;
-}
-/**
- * 计算纸张内容可用宽高及边距（考虑设备DPI）
- * 确保：contentWidth + 2*paddingPx = 纸张宽度像素
- * @param type 纸张类型
- * @param padding 边距（毫米）
- * @returns {
- *   contentWidth: number;  // 内容可用宽度(px)
- *   contentHeight: number; // 内容可用高度(px)
- *   paddingPx: number;     // 边距(px) - 单边值
- *   paperWidthPx: number;  // 纸张总宽度(px)
- *   paperHeightPx: number; // 纸张总高度(px)
- * }
- */
-export declare function _Browser_CalculatePrintableArea(type: PaperType, padding: number): {
-    /** 内容宽度（像素） */
-    contentWidth: number;
-    /** 内容高度（像素） */
-    contentHeight: number;
-    /** 边距（像素） */
-    paddingPx: number;
-    /** 纸张宽度（像素） */
-    paperWidthPx: number;
-    /** 纸张高度（像素） */
-    paperHeightPx: number;
-};

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,91 +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]>;