ziya-utils 1.1.1 → 1.1.3

package/es/node_modules/tslib/tslib.es6.js

@@ -14,20 +14,6 @@ PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
 /* global Reflect, Promise, SuppressedError, Symbol */
 
-var extendStatics = function(d, b) {
-    extendStatics = Object.setPrototypeOf ||
-        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-        function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-    return extendStatics(d, b);
-};
-
-function __extends(d, b) {
-    if (typeof b !== "function" && b !== null)
-        throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-    extendStatics(d, b);
-    function __() { this.constructor = d; }
-    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-}
 
 function __awaiter(thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -39,37 +25,9 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
-function __generator(thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-}
-
 typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-export { __awaiter, __extends, __generator };
+export { __awaiter };

package/es/regexp/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 正则模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**

package/es/regexp/index.js

@@ -1,12 +1,10 @@
-import { __extends } from '../node_modules/tslib/tslib.es6.js';
-
 /**
  * @fileoverview 正则模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 // 正则表达式常量
-var RegexPatterns = {
+const RegexPatterns = {
     /** 手机号码正则 */
     PHONE: /^1[3-9]\d{9}$/,
     /** 邮箱地址正则 */
@@ -23,39 +21,31 @@ var RegexPatterns = {
     CHINESE: /^[\u4e00-\u9fa5]+$/
 };
 // 使用 `abstract class` 代替 `interface`，用于静态方法约束
-var IRegexValidatorStatic = /** @class */ (function () {
-    function IRegexValidatorStatic() {
-    }
-    return IRegexValidatorStatic;
-}());
-var RegexValidator = /** @class */ (function (_super) {
-    __extends(RegexValidator, _super);
-    function RegexValidator() {
-        return _super !== null && _super.apply(this, arguments) || this;
-    }
-    RegexValidator.isPhone = function (phone) {
+class IRegexValidatorStatic {
+}
+class RegexValidator extends IRegexValidatorStatic {
+    static isPhone(phone) {
         return RegexPatterns.PHONE.test(phone);
-    };
-    RegexValidator.isEmail = function (email) {
+    }
+    static isEmail(email) {
         return RegexPatterns.EMAIL.test(email);
-    };
-    RegexValidator.isIdCard = function (idCard) {
+    }
+    static isIdCard(idCard) {
         return RegexPatterns.ID_CARD.test(idCard);
-    };
-    RegexValidator.isUrl = function (url) {
+    }
+    static isUrl(url) {
         return RegexPatterns.URL.test(url);
-    };
-    RegexValidator.isIpv4 = function (ip) {
+    }
+    static isIpv4(ip) {
         return RegexPatterns.IPV4.test(ip);
-    };
-    RegexValidator.isStrongPassword = function (password) {
+    }
+    static isStrongPassword(password) {
         return RegexPatterns.STRONG_PASSWORD.test(password);
-    };
-    RegexValidator.isChinese = function (text) {
+    }
+    static isChinese(text) {
         return RegexPatterns.CHINESE.test(text);
-    };
-    return RegexValidator;
-}(IRegexValidatorStatic));
+    }
+}
 // 默认导出
 var IRegexUtils = {
     patterns: RegexPatterns,

package/es/security/index.d.ts

@@ -1,9 +1,17 @@
 /**
- * 通用安全工具
+ * @fileoverview 安全工具模块
+ * @created 2025-04-2
+ * @author glk
  */
 /**
  * 生成通用唯一识别码（UUID）
  * @returns
  */
-declare const getUuid: () => string;
-export { getUuid, };
+declare function getUuid(): string;
+/**
+ * 复制内容到剪贴板
+ * @param data 要复制的数据
+ * @returns 返回是否成功
+ */
+declare function copyToClipboard(data: unknown): Promise<boolean>;
+export { getUuid, copyToClipboard };

package/es/security/index.js

@@ -1,15 +1,52 @@
+import { __awaiter } from '../node_modules/tslib/tslib.es6.js';
+
 /**
- * 通用安全工具
+ * @fileoverview 安全工具模块
+ * @created 2025-04-2
+ * @author glk
  */
 /**
  * 生成通用唯一识别码（UUID）
  * @returns
  */
-var getUuid = function () {
+function getUuid() {
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
         var r = (Math.random() * 16) | 0, v = c == 'x' ? r : (r & 0x3) | 0x8;
         return v.toString(16);
     });
-};
+}
+/**
+ * 复制内容到剪贴板
+ * @param data 要复制的数据
+ * @returns 返回是否成功
+ */
+function copyToClipboard(data) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // 转换为JSON字符串
+            var jsonString = JSON.stringify(data);
+            // 优先方案
+            if (navigator.clipboard && (window.isSecureContext || location.protocol === 'https:' || location.hostname === 'localhost')) {
+                yield navigator.clipboard.writeText(jsonString);
+                return true;
+            }
+            // 降级方案
+            var textArea = document.createElement('textarea');
+            textArea.value = jsonString;
+            textArea.style.position = 'fixed';
+            textArea.style.left = '-9999px';
+            textArea.style.top = '-9999px';
+            document.body.appendChild(textArea);
+            textArea.select();
+            var successful = document.execCommand('copy');
+            document.body.removeChild(textArea);
+            return successful;
+        }
+        catch (error) {
+            console.error('复制失败:', error);
+            return false;
+        }
+    });
+}
 
-export { getUuid };
+export { copyToClipboard, getUuid };

package/es/time/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 时间模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**

package/es/time/index.js

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 时间模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**
@@ -8,9 +8,9 @@
  * @param time - 休眠时间（s）
  * @returns
  */
-var sleep = function (time) {
-    return new Promise(function (resolve) {
-        setTimeout(function () {
+const sleep = (time) => {
+    return new Promise((resolve) => {
+        setTimeout(() => {
             resolve(true);
         }, time * 1000);
     });

package/es/xhr/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview XMLHttpRequest模块
+ * @created 2025-04-02
+ * @author glk
+ */
+/**
+ * 拦截规则
+ */
+interface InterceptRule {
+    url: string;
+    responseCallback: (data: any) => any | Promise<any>;
+}
+/**
+ * 拦截器配置
+ */
+interface XHRInterceptorConfig {
+    enableLogging?: boolean;
+}
+/**
+ * XHR 拦截器类
+ */
+declare class XHRInterceptor {
+    private originalXMLHttpRequest;
+    private interceptRules;
+    private isActive;
+    private enableLogging;
+    constructor(config?: XHRInterceptorConfig);
+    /**
+     * 启动拦截器
+     */
+    start(): void;
+    /**
+     * 停止拦截器并恢复原始XMLHttpRequest
+     */
+    stop(): void;
+    /**
+     * 设置拦截规则（会覆盖现有规则）
+     */
+    setRules(rules: InterceptRule[]): void;
+    /**
+     * 添加单个拦截规则
+     */
+    addRule(url: string, responseCallback: InterceptRule["responseCallback"]): void;
+    /**
+     * 移除指定URL的拦截规则
+     */
+    removeRule(url: string): boolean;
+    /**
+     * 清除所有拦截规则
+     */
+    clearRules(): void;
+    /**
+     * 获取当前拦截规则
+     */
+    getRules(): InterceptRule[];
+    /**
+     * 获取拦截器状态
+     */
+    getStatus(): {
+        isActive: boolean;
+        rulesCount: number;
+    };
+    /**
+     * 检查URL是否匹配拦截规则
+     */
+    private findMatchingRule;
+    /**
+     * 日志输出
+     */
+    private log;
+}
+declare const xhrInterceptor: XHRInterceptor;
+export type { InterceptRule, XHRInterceptorConfig };
+export { XHRInterceptor, xhrInterceptor };

package/es/xhr/index.js

@@ -0,0 +1,172 @@
+import { __awaiter } from '../node_modules/tslib/tslib.es6.js';
+
+/**
+ * @fileoverview XMLHttpRequest模块
+ * @created 2025-04-02
+ * @author glk
+ */
+/**
+ * XHR 拦截器类
+ */
+class XHRInterceptor {
+    constructor(config = {}) {
+        var _a;
+        this.interceptRules = [];
+        this.isActive = false;
+        this.originalXMLHttpRequest = window.XMLHttpRequest;
+        this.enableLogging = (_a = config.enableLogging) !== null && _a !== void 0 ? _a : true;
+    }
+    /**
+     * 启动拦截器
+     */
+    start() {
+        if (this.isActive) {
+            this.log("拦截器已经启动");
+            return;
+        }
+        const self = this;
+        // 重写 XMLHttpRequest
+        window.XMLHttpRequest = function () {
+            const xhr = new self.originalXMLHttpRequest();
+            let requestUrl = "";
+            // 保存原始的 open 方法
+            const originalOpen = xhr.open;
+            xhr.open = function (method, url, async = true, user, password) {
+                requestUrl = typeof url === "string" ? url : url.toString();
+                return originalOpen.call(this, method, url, async, user, password);
+            };
+            // 保存原始的 send 方法
+            const originalSend = xhr.send;
+            xhr.send = function (body) {
+                // 查找匹配的拦截规则
+                const matchingRule = self.findMatchingRule(requestUrl);
+                if (!matchingRule) {
+                    // 没有匹配的规则，直接执行原始请求
+                    return originalSend.call(this, body);
+                }
+                // 保存原始的 onreadystatechange
+                const originalOnReadyStateChange = xhr.onreadystatechange;
+                xhr.onreadystatechange = function (event) {
+                    return __awaiter(this, void 0, void 0, function* () {
+                        if (xhr.readyState === 4 && xhr.status >= 200 && xhr.status < 300) {
+                            try {
+                                // 解析原始响应
+                                const originalData = JSON.parse(xhr.responseText);
+                                // 使用回调函数处理响应数据
+                                const modifiedData = yield matchingRule.responseCallback(originalData);
+                                // 重写响应属性
+                                Object.defineProperty(xhr, "responseText", {
+                                    writable: true,
+                                    configurable: true,
+                                    value: JSON.stringify(modifiedData),
+                                });
+                                Object.defineProperty(xhr, "response", {
+                                    writable: true,
+                                    configurable: true,
+                                    value: JSON.stringify(modifiedData),
+                                });
+                                self.log(`已拦截并修改响应: ${requestUrl}`);
+                            }
+                            catch (error) {
+                                self.log("拦截器处理失败:", error);
+                                // 出错时保持原始响应
+                            }
+                        }
+                        // 调用原始的 onreadystatechange
+                        if (originalOnReadyStateChange) {
+                            originalOnReadyStateChange.call(this, event);
+                        }
+                    });
+                };
+                return originalSend.call(this, body);
+            };
+            return xhr;
+        };
+        // 继承原始 XMLHttpRequest 的静态属性和原型
+        Object.setPrototypeOf(window.XMLHttpRequest, this.originalXMLHttpRequest);
+        window.XMLHttpRequest.prototype = this.originalXMLHttpRequest.prototype;
+        this.isActive = true;
+        this.log("XHR拦截器已启动");
+    }
+    /**
+     * 停止拦截器并恢复原始XMLHttpRequest
+     */
+    stop() {
+        if (!this.isActive) {
+            this.log("拦截器未启动");
+            return;
+        }
+        window.XMLHttpRequest = this.originalXMLHttpRequest;
+        this.isActive = false;
+        this.log("XHR拦截器已停止，已恢复原始XMLHttpRequest");
+    }
+    /**
+     * 设置拦截规则（会覆盖现有规则）
+     */
+    setRules(rules) {
+        this.interceptRules = [...rules];
+        this.log("已设置拦截规则:", rules.map((r) => r.url));
+    }
+    /**
+     * 添加单个拦截规则
+     */
+    addRule(url, responseCallback) {
+        this.interceptRules.push({ url, responseCallback });
+        this.log(`已添加拦截规则: ${url}`);
+    }
+    /**
+     * 移除指定URL的拦截规则
+     */
+    removeRule(url) {
+        const initialLength = this.interceptRules.length;
+        this.interceptRules = this.interceptRules.filter((rule) => rule.url !== url);
+        const removed = this.interceptRules.length < initialLength;
+        if (removed) {
+            this.log(`已移除拦截规则: ${url}`);
+        }
+        else {
+            this.log(`未找到拦截规则: ${url}`);
+        }
+        return removed;
+    }
+    /**
+     * 清除所有拦截规则
+     */
+    clearRules() {
+        this.interceptRules = [];
+        this.log("已清除所有拦截规则");
+    }
+    /**
+     * 获取当前拦截规则
+     */
+    getRules() {
+        return [...this.interceptRules];
+    }
+    /**
+     * 获取拦截器状态
+     */
+    getStatus() {
+        return {
+            isActive: this.isActive,
+            rulesCount: this.interceptRules.length,
+        };
+    }
+    /**
+     * 检查URL是否匹配拦截规则
+     */
+    findMatchingRule(url) {
+        return this.interceptRules.find((rule) => url.includes(rule.url));
+    }
+    /**
+     * 日志输出
+     */
+    log(message, ...args) {
+        if (this.enableLogging) {
+            console.log(`[XHRInterceptor] ${message}`, ...args);
+        }
+    }
+}
+// 创建单例实例
+const xhrInterceptor = new XHRInterceptor({ enableLogging: true });
+
+export { XHRInterceptor, xhrInterceptor };

package/lib/async/index.d.ts

@@ -0,0 +1,20 @@
+type CheckFunction<T = any> = () => T | null | undefined | false;
+type InitFunction<T = any, R = any> = (checkResult: T) => R | Promise<R>;
+interface AsyncTaskOptions {
+    /** 检查间隔时间（秒），默认 1 秒 */
+    duration?: number;
+    /** 最大等待时间（秒），超时后会 reject */
+    timeout?: number;
+    /** 是否立即执行一次检查，默认 false */
+    immediate?: boolean;
+}
+/**
+ * 创建异步任务，定时检查条件直到满足后执行初始化函数
+ * @param checkFun 检查函数，返回 true 值时表示条件满足
+ * @param initFun 初始化函数，在条件满足后执行
+ * @param options 配置选项
+ * @returns Promise，resolve 初始化函数的返回值
+ */
+declare function createAsyncTask<T, R>(checkFun?: CheckFunction<T>, initFun?: InitFunction<T, R>, options?: AsyncTaskOptions): Promise<R>;
+export { createAsyncTask };
+export type { CheckFunction, InitFunction, AsyncTaskOptions };

package/lib/count/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview 数值模块
+ * @created 2025-04-2
+ * @author glk
+ */
+/**
+ * 数值的精度控制
+ * @param num 源数值，可以为负
+ * @param count 保留几位有效数字
+ * @param round 是否四舍五入
+ * @param consistent 是否保持一致性
+ * @example
+ *  formatDecimals(0.15, 1, false, false) // 0.1
+ *  formatDecimals(0.15, 1, false, true) // 0.1
+ *  formatDecimals(0.15, 1, true, false) // 0.2
+ *  formatDecimals(0.15, 1, true, true) // 0.2
+ *
+ *  formatDecimals(-0.15, 1, false, true) // -0.1
+ *  formatDecimals(-0.15, 1, false, false) // -0.2
+ *  formatDecimals(-0.15, 1, true, true) // -0.2
+ *  formatDecimals(-0.15, 1, true, false) // -0.1
+ * @returns
+ */
+declare function precisionFormat(num: number, count: number, round?: boolean, consistent?: boolean): number;
+export { precisionFormat };

package/lib/count/index.js

@@ -0,0 +1,32 @@
+'use strict';
+
+/**
+ * @fileoverview 数值模块
+ * @created 2025-04-2
+ * @author glk
+ */
+/**
+ * 数值的精度控制
+ * @param num 源数值，可以为负
+ * @param count 保留几位有效数字
+ * @param round 是否四舍五入
+ * @param consistent 是否保持一致性
+ * @example
+ *  formatDecimals(0.15, 1, false, false) // 0.1
+ *  formatDecimals(0.15, 1, false, true) // 0.1
+ *  formatDecimals(0.15, 1, true, false) // 0.2
+ *  formatDecimals(0.15, 1, true, true) // 0.2
+ *
+ *  formatDecimals(-0.15, 1, false, true) // -0.1
+ *  formatDecimals(-0.15, 1, false, false) // -0.2
+ *  formatDecimals(-0.15, 1, true, true) // -0.2
+ *  formatDecimals(-0.15, 1, true, false) // -0.1
+ * @returns
+ */
+function precisionFormat(num, count, round = true, consistent = true) {
+    var sign = num < 0 ? (consistent ? -1 : 1) : 1;
+    const val = Math.pow(10, count);
+    return round ? (Math.round(num * val * sign) / val) * sign : (Math.floor(num * val * sign) / val) * sign;
+}
+
+exports.precisionFormat = precisionFormat;

package/lib/date/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 日期模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**
@@ -31,4 +31,12 @@ declare const getElapsedTimeSince: (timestamp: number) => {
     minutes: number;
     seconds: number;
 };
-export { isValidTimestamp, isSecondTimestamp, isMillisecondTimestamp, getElapsedTimeSince, };
+type DateFormatTemplate = 'YYYY-MM-DD' | 'YYYY/MM/DD' | 'DD/MM/YYYY' | 'MM/DD/YYYY' | 'YYYY-MM-DD HH:mm:ss' | 'HH:mm:ss' | 'HH:mm' | string;
+/**
+ * 类型安全的日期格式化函数
+ * @param format 格式字符串或预定义模板
+ * @param date 可选的日期对象
+ * @returns 格式化后的日期字符串
+ */
+declare function formatDateTypeSafe(format: DateFormatTemplate, date?: Date): string;
+export { isValidTimestamp, isSecondTimestamp, isMillisecondTimestamp, getElapsedTimeSince, formatDateTypeSafe, };