ziya-utils 1.1.1 → 1.1.3

package/lib/date/index.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileoverview 日期模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**
@@ -25,9 +25,9 @@ function isValidTimestamp(timestamp) {
     }
     // 检查时间戳范围是否合理
     // 时间戳下限：1970年1月1日
-    var minTimestamp = 0;
+    const minTimestamp = 0;
     // 时间戳上限：设置为一个合理的未来日期，例如2100年1月1日
-    var maxTimestamp = 4102444800000; // 2100-01-01的毫秒时间戳
+    const maxTimestamp = 4102444800000; // 2100-01-01的毫秒时间戳
     // 检查时间戳是否为13位（毫秒级）或10位（秒级）
     if (timestamp.toString().length === 13) {
         // 毫秒级时间戳
@@ -45,41 +45,89 @@ function isValidTimestamp(timestamp) {
  * @param timestamp
  * @returns
  */
-var isSecondTimestamp = function (timestamp) {
-    return isValidTimestamp(timestamp) && timestamp.toString().length === 10;
-};
+const isSecondTimestamp = (timestamp) => isValidTimestamp(timestamp) && timestamp.toString().length === 10;
 /**
  * 是不是毫秒级时间戳
  * @param timestamp
  * @returns
  */
-var isMillisecondTimestamp = function (timestamp) {
-    return isValidTimestamp(timestamp) && timestamp.toString().length === 13;
-};
+const isMillisecondTimestamp = (timestamp) => isValidTimestamp(timestamp) && timestamp.toString().length === 13;
 /**
  * 计算传入时间戳和当前时间的时间差
  * @param timestamp 时间戳
  * @returns
  */
-var getElapsedTimeSince = function (timestamp) {
-    var now = Date.now();
+const getElapsedTimeSince = (timestamp) => {
+    const now = Date.now();
     if (!isValidTimestamp(timestamp)) {
         timestamp = now;
     }
-    var diff = Math.max(0, now - (isSecondTimestamp(timestamp) ? timestamp * 1000 : timestamp));
+    const diff = Math.max(0, now - (isSecondTimestamp(timestamp) ? timestamp * 1000 : timestamp));
     // 计算小时
-    var hours = Math.floor(diff / (1000 * 60 * 60));
+    const hours = Math.floor(diff / (1000 * 60 * 60));
     // 计算分钟
-    var minutes = Math.floor((diff % (1000 * 60 * 60)) / (1000 * 60));
+    const minutes = Math.floor((diff % (1000 * 60 * 60)) / (1000 * 60));
     // 计算秒
-    var seconds = Math.floor((diff % (1000 * 60)) / 1000);
+    const seconds = Math.floor((diff % (1000 * 60)) / 1000);
     return {
-        hours: hours,
-        minutes: minutes,
-        seconds: seconds,
+        hours,
+        minutes,
+        seconds,
     };
 };
+/**
+ * 日期格式化
+ * @param format 格式字符串
+ * @param date 可选的日期对象，默认为当前时间
+ * @returns 格式化后的日期字符串
+ */
+function formatDateAdvanced(format, date) {
+    const targetDate = date || new Date();
+    // 类型安全的数字格式化
+    const pad = (num, length = 2) => num.toString().padStart(length, "0");
+    // 获取各个时间组件
+    const components = {
+        year: targetDate.getFullYear(),
+        month: targetDate.getMonth() + 1,
+        day: targetDate.getDate(),
+        hours: targetDate.getHours(),
+        minutes: targetDate.getMinutes(),
+        seconds: targetDate.getSeconds(),
+        milliseconds: targetDate.getMilliseconds()
+    };
+    // 格式化映射表
+    const formatMap = {
+        'YYYY': components.year.toString(),
+        'YY': components.year.toString().slice(-2),
+        'MM': pad(components.month),
+        'M': components.month.toString(),
+        'DD': pad(components.day),
+        'D': components.day.toString(),
+        'HH': pad(components.hours),
+        'H': components.hours.toString(),
+        'mm': pad(components.minutes),
+        'm': components.minutes.toString(),
+        'ss': pad(components.seconds),
+        's': components.seconds.toString(),
+        'SSS': pad(components.milliseconds, 3)
+    };
+    // 按照键的长度排序，避免短键替换长键的问题
+    const sortedKeys = Object.keys(formatMap).sort((a, b) => b.length - a.length);
+    return sortedKeys.reduce((result, key) => {
+        return result.replace(new RegExp(key, 'g'), formatMap[key]);
+    }, format);
+}
+/**
+ * 类型安全的日期格式化函数
+ * @param format 格式字符串或预定义模板
+ * @param date 可选的日期对象
+ * @returns 格式化后的日期字符串
+ */
+function formatDateTypeSafe(format, date) {
+    return formatDateAdvanced(format, date);
+}
 
+exports.formatDateTypeSafe = formatDateTypeSafe;
 exports.getElapsedTimeSince = getElapsedTimeSince;
 exports.isMillisecondTimestamp = isMillisecondTimestamp;
 exports.isSecondTimestamp = isSecondTimestamp;

package/lib/document/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Document模块
+ * @created 2025-04-02
+ * @author glk
+ */
+declare function addStyleStr(styStr?: string): HTMLStyleElement;
+export { addStyleStr };

package/lib/file/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 文件模块
- * @date 2025-04-2
+ * @created 2025-04-2
  * @author glk
  */
 /**

package/lib/file/index.js

@@ -5,7 +5,7 @@ var index = require('../regexp/index.js');
 
 /**
  * @fileoverview 文件模块
- * @date 2025-04-2
+ * @created 2025-04-2
  * @author glk
  */
 /**
@@ -13,12 +13,12 @@ var index = require('../regexp/index.js');
  * @param filePath 文件路径字符串
  * @returns 提取的文件名，如果路径为空则返回空字符串，如果路径中没有分隔符则返回原字符串
  */
-var extractFileNameFromPath = function (filePath) {
+const extractFileNameFromPath = (filePath) => {
     if (!filePath) {
         return "";
     }
     // 同时支持 Unix/Linux/Mac (/) 和 Windows (\) 风格的路径
-    var lastSlashIndex = Math.max(filePath.lastIndexOf("/"), filePath.lastIndexOf("\\"));
+    const lastSlashIndex = Math.max(filePath.lastIndexOf("/"), filePath.lastIndexOf("\\"));
     // 如果找不到分隔符，则整个字符串就是文件名
     if (lastSlashIndex === -1) {
         return filePath;
@@ -32,61 +32,53 @@ var extractFileNameFromPath = function (filePath) {
  * @returns Promise<void>
  * @throws Error 当URL无效或网络请求失败时抛出错误
  */
-var downloadSingleFile = function (url, name) { return tslib_es6.__awaiter(void 0, void 0, void 0, function () {
-    var response, fileName, queryIndex, blob, blobUrl_1, link_1, error_1;
-    return tslib_es6.__generator(this, function (_a) {
-        switch (_a.label) {
-            case 0:
-                // 验证URL
-                if (!url || !index.default.validator.isUrl(url)) {
-                    throw new Error('无效的URL');
-                }
-                _a.label = 1;
-            case 1:
-                _a.trys.push([1, 4, , 5]);
-                return [4 /*yield*/, fetch(url)];
-            case 2:
-                response = _a.sent();
-                // 检查响应状态
-                if (!response.ok) {
-                    throw new Error("\u4E0B\u8F7D\u5931\u8D25: ".concat(response.status, " ").concat(response.statusText));
-                }
-                fileName = name;
-                if (!fileName) {
-                    fileName = extractFileNameFromPath(url);
-                    queryIndex = fileName.indexOf('?');
-                    if (queryIndex !== -1) {
-                        fileName = fileName.substring(0, queryIndex);
-                    }
-                    // 如果仍然没有文件名，使用默认名称
-                    if (!fileName) {
-                        fileName = 'downloaded_file';
-                    }
-                }
-                return [4 /*yield*/, response.blob()];
-            case 3:
-                blob = _a.sent();
-                blobUrl_1 = URL.createObjectURL(blob);
-                link_1 = document.createElement('a');
-                link_1.href = blobUrl_1;
-                link_1.download = fileName;
-                // 执行下载
-                document.body.appendChild(link_1);
-                link_1.click();
-                // 清理
-                setTimeout(function () {
-                    URL.revokeObjectURL(blobUrl_1);
-                    link_1.remove();
-                }, 100); // 添加小延迟以确保下载开始
-                return [3 /*break*/, 5];
-            case 4:
-                error_1 = _a.sent();
-                console.error('文件下载失败:', error_1);
-                throw error_1; // 重新抛出错误以便调用者可以处理
-            case 5: return [2 /*return*/];
+const downloadSingleFile = (url, name) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    // 验证URL
+    if (!url || !index.default.validator.isUrl(url)) {
+        throw new Error('无效的URL');
+    }
+    try {
+        // 获取响应
+        const response = yield fetch(url);
+        // 检查响应状态
+        if (!response.ok) {
+            throw new Error(`下载失败: ${response.status} ${response.statusText}`);
+        }
+        // 获取文件名 - 优先使用提供的名称，否则从URL中提取
+        let fileName = name;
+        if (!fileName) {
+            fileName = extractFileNameFromPath(url);
+            // 处理查询参数
+            const queryIndex = fileName.indexOf('?');
+            if (queryIndex !== -1) {
+                fileName = fileName.substring(0, queryIndex);
+            }
+            // 如果仍然没有文件名，使用默认名称
+            if (!fileName) {
+                fileName = 'downloaded_file';
+            }
         }
-    });
-}); };
+        // 获取blob和内容类型
+        const blob = yield response.blob();
+        // 创建下载链接
+        const blobUrl = URL.createObjectURL(blob); // 注意：直接使用原始blob保留MIME类型
+        const link = document.createElement('a');
+        link.href = blobUrl;
+        link.download = fileName;
+        // 执行下载
+        document.body.appendChild(link);
+        link.click();
+        // 清理
+        setTimeout(() => {
+            URL.revokeObjectURL(blobUrl);
+            link.remove();
+        }, 100); // 添加小延迟以确保下载开始
+    }
+    catch (error) {
+        console.error('文件下载失败:', error);
+        throw error; // 重新抛出错误以便调用者可以处理
+    }
+});
 
 exports.downloadSingleFile = downloadSingleFile;
 exports.extractFileNameFromPath = extractFileNameFromPath;

package/lib/form/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview 表单模块
+ * @created 2025-04-02
+ * @author glk
+ */
+type FormDataValue = string | number | boolean | File | Blob | null | undefined;
+type FormDataInput = string | Record<string, FormDataValue | FormDataValue[] | Record<string, any>>;
+/**
+ * 将数据转换为 FormData 对象
+ * @param data 要转换的数据，可以是查询字符串或对象
+ * @returns FormData 对象
+ */
+declare function createFormData(data: FormDataInput): FormData;
+export { createFormData };
+export type { FormDataInput, FormDataValue };

package/lib/form/index.js

@@ -0,0 +1,53 @@
+'use strict';
+
+/**
+ * @fileoverview 表单模块
+ * @created 2025-04-02
+ * @author glk
+ */
+/**
+ * 将数据转换为 FormData 对象
+ * @param data 要转换的数据，可以是查询字符串或对象
+ * @returns FormData 对象
+ */
+function createFormData(data) {
+    const formData = new FormData();
+    if (typeof data === "string") {
+        // 处理查询字符串
+        const params = new URLSearchParams(data);
+        for (const [key, value] of params) {
+            formData.append(key, value);
+        }
+    }
+    else if (typeof data === "object" && data !== null) {
+        // 处理对象
+        Object.keys(data).forEach((key) => {
+            const value = data[key];
+            if (value !== null && value !== undefined) {
+                if (Array.isArray(value)) {
+                    // 数组：每个元素单独添加
+                    value.forEach((item) => formData.append(key, String(item)));
+                }
+                else if (value instanceof File || value instanceof Blob) {
+                    // 文件或Blob直接添加
+                    formData.append(key, value);
+                }
+                else if (typeof value === "object") {
+                    // 对象直接转字符串
+                    formData.append(key, JSON.stringify(value));
+                }
+                else {
+                    // 其他类型转为字符串
+                    formData.append(key, String(value));
+                }
+            }
+            else {
+                // null 或 undefined 转为空字符串
+                formData.append(key, "");
+            }
+        });
+    }
+    return formData;
+}
+
+exports.createFormData = createFormData;

package/lib/index.d.ts

@@ -3,3 +3,6 @@ export * from "./time";
 export * from "./date";
 export * from "./security";
 export * from "./regexp";
+export * from "./form";
+export * from "./count";
+export * from "./xhr";

package/lib/index.js

@@ -5,16 +5,25 @@ var index$1 = require('./time/index.js');
 var index$2 = require('./date/index.js');
 var index$3 = require('./security/index.js');
 var index$4 = require('./regexp/index.js');
+var index$5 = require('./form/index.js');
+var index$6 = require('./count/index.js');
+var index$7 = require('./xhr/index.js');
 
 
 
 exports.downloadSingleFile = index.downloadSingleFile;
 exports.extractFileNameFromPath = index.extractFileNameFromPath;
 exports.sleep = index$1.sleep;
+exports.formatDateTypeSafe = index$2.formatDateTypeSafe;
 exports.getElapsedTimeSince = index$2.getElapsedTimeSince;
 exports.isMillisecondTimestamp = index$2.isMillisecondTimestamp;
 exports.isSecondTimestamp = index$2.isSecondTimestamp;
 exports.isValidTimestamp = index$2.isValidTimestamp;
+exports.copyToClipboard = index$3.copyToClipboard;
 exports.getUuid = index$3.getUuid;
 exports.RegexPatterns = index$4.RegexPatterns;
 exports.RegexValidator = index$4.RegexValidator;
+exports.createFormData = index$5.createFormData;
+exports.precisionFormat = index$6.precisionFormat;
+exports.XHRInterceptor = index$7.XHRInterceptor;
+exports.xhrInterceptor = index$7.xhrInterceptor;

package/lib/loger/index.d.ts

@@ -0,0 +1,7 @@
+declare const loger: {
+    info: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+};
+export { loger };

package/lib/node_modules/tslib/tslib.es6.js

@@ -16,20 +16,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); }); }
@@ -41,39 +27,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;
 };
 
 exports.__awaiter = __awaiter;
-exports.__extends = __extends;
-exports.__generator = __generator;

package/lib/regexp/index.d.ts

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

package/lib/regexp/index.js

@@ -2,15 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var tslib_es6 = require('../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}$/,
     /** 邮箱地址正则 */
@@ -27,39 +25,31 @@ var RegexPatterns = {
     CHINESE: /^[\u4e00-\u9fa5]+$/
 };
 // 使用 `abstract class` 代替 `interface`，用于静态方法约束
-var IRegexValidatorStatic = /** @class */ (function () {
-    function IRegexValidatorStatic() {
-    }
-    return IRegexValidatorStatic;
-}());
-var RegexValidator = /** @class */ (function (_super) {
-    tslib_es6.__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/lib/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/lib/security/index.js

@@ -1,17 +1,55 @@
 'use strict';
 
+var tslib_es6 = require('../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 tslib_es6.__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;
+        }
+    });
+}
 
+exports.copyToClipboard = copyToClipboard;
 exports.getUuid = getUuid;

package/lib/time/index.d.ts

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

package/lib/time/index.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileoverview 时间模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**
@@ -10,9 +10,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);
     });