ziya-utils 1.1.2 → 1.1.4

package/README.md

@@ -1,20 +1,42 @@
-### Ziya-Utils
-> 一个 Javascript 常用工具库。
+<p align="center">
+  <a href="https://www.npmjs.com/package/ziya-utils">
+    Ziya-Utils
+  </a>
+</p>
 
-## 安装
+
+<div align="center">
+
+A Javascript common tool library.
+
+[![NPM version][image-1]][1]
+[![NPM downloads][image-2]][2]
+![gzip size](https://img.badgesize.io/https://unpkg.com/ziya-utils/dist/ziya-utils.js?label=gzip%20size&compression=gzip)
+![npm license](https://img.shields.io/npm/l/ziya-utils)
+
+English | [简体中文](README.zh-CN.md)
+
+</div>
+
+## 📦 Install
 
 ```bash
-  $ npm install --save ziya-utils
-  # or
-  $ yarn add ziya-utils
-  # or
-  $ pnpm add ziya-utils
-  # or
-  $ bun add ziya-utils
+$ npm install --save ziya-utils
+# or
+$ yarn add ziya-utils
+# or
+$ pnpm add ziya-utils
+# or
+$ bun add ziya-utils
 ```
 
-## 使用
-```js
-  import { getUuid } from "ziya-utils";
+## 🔨 Usage
+
+```ts
+import { getUuid } from "ziya-utils";
 ```
 
+[1]: https://www.npmjs.com/package/ziya-utils
+[2]: https://npmjs.org/package/ziya-utils
+[image-1]: https://img.shields.io/npm/v/ziya-utils.svg?style=flat
+[image-2]: https://img.shields.io/npm/dw/ziya-utils.svg?style=flat

package/README.zh-CN.md

@@ -0,0 +1,42 @@
+<p align="center">
+  <a href="https://www.npmjs.com/package/ziya-utils">
+    Ziya-Utils
+  </a>
+</p>
+
+
+<div align="center">
+
+一个 Javascript 常用工具库。
+
+[![NPM version][image-1]][1]
+[![NPM downloads][image-2]][2]
+![gzip size](https://img.badgesize.io/https://unpkg.com/ziya-utils/dist/ziya-utils.js?label=gzip%20size&compression=gzip)
+![npm license](https://img.shields.io/npm/l/ziya-utils)
+
+[English](README.md) | 简体中文
+
+</div>
+
+## 📦 安装
+
+```bash
+$ npm install --save ziya-utils
+# or
+$ yarn add ziya-utils
+# or
+$ pnpm add ziya-utils
+# or
+$ bun add ziya-utils
+```
+
+## 🔨 使用
+
+```ts
+import { getUuid } from "ziya-utils";
+```
+
+[1]: https://www.npmjs.com/package/ziya-utils
+[2]: https://npmjs.org/package/ziya-utils
+[image-1]: https://img.shields.io/npm/v/ziya-utils.svg?style=flat
+[image-2]: https://img.shields.io/npm/dw/ziya-utils.svg?style=flat

package/dist/ziya-utils.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).ZiyaUtils={})}(this,function(t){"use strict";var e=function(t,n){return e=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(t,e){t.__proto__=e}||function(t,e){for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n])},e(t,n)};function n(t,e,n,r){return new(n||(n=Promise))(function(o,i){function u(t){try{s(r.next(t))}catch(t){i(t)}}function a(t){try{s(r.throw(t))}catch(t){i(t)}}function s(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n(function(t){t(e)})).then(u,a)}s((r=r.apply(t,e||[])).next())})}function r(t,e){var n,r,o,i,u={label:0,sent:function(){if(1&o[0])throw o[1];return o[1]},trys:[],ops:[]};return i={next:a(0),throw:a(1),return:a(2)},"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function a(a){return function(s){return function(a){if(n)throw new TypeError("Generator is already executing.");for(;i&&(i=0,a[0]&&(u=0)),u;)try{if(n=1,r&&(o=2&a[0]?r.return:a[0]?r.throw||((o=r.return)&&o.call(r),0):r.next)&&!(o=o.call(r,a[1])).done)return o;switch(r=0,o&&(a=[2&a[0],o.value]),a[0]){case 0:case 1:o=a;break;case 4:return u.label++,{value:a[1],done:!1};case 5:u.label++,r=a[1],a=[0];continue;case 7:a=u.ops.pop(),u.trys.pop();continue;default:if(!(o=u.trys,(o=o.length>0&&o[o.length-1])||6!==a[0]&&2!==a[0])){u=0;continue}if(3===a[0]&&(!o||a[1]>o[0]&&a[1]<o[3])){u.label=a[1];break}if(6===a[0]&&u.label<o[1]){u.label=o[1],o=a;break}if(o&&u.label<o[2]){u.label=o[2],u.ops.push(a);break}o[2]&&u.ops.pop(),u.trys.pop();continue}a=e.call(t,u)}catch(t){a=[6,t],r=0}finally{n=o=0}if(5&a[0])throw a[1];return{value:a[0]?a[1]:void 0,done:!0}}([a,s])}}}"function"==typeof SuppressedError&&SuppressedError;var o={PHONE:/^1[3-9]\d{9}$/,EMAIL:/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,ID_CARD:/(^\d{15}$)|(^\d{17}(\d|X|x)$)/,URL:/^(https?:\/\/)?([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/,IPV4:/^(\d{1,3}\.){3}\d{1,3}$/,STRONG_PASSWORD:/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/,CHINESE:/^[\u4e00-\u9fa5]+$/},i=function(t){function n(){return null!==t&&t.apply(this,arguments)||this}return function(t,n){if("function"!=typeof n&&null!==n)throw new TypeError("Class extends value "+String(n)+" is not a constructor or null");function r(){this.constructor=t}e(t,n),t.prototype=null===n?Object.create(n):(r.prototype=n.prototype,new r)}(n,t),n.isPhone=function(t){return o.PHONE.test(t)},n.isEmail=function(t){return o.EMAIL.test(t)},n.isIdCard=function(t){return o.ID_CARD.test(t)},n.isUrl=function(t){return o.URL.test(t)},n.isIpv4=function(t){return o.IPV4.test(t)},n.isStrongPassword=function(t){return o.STRONG_PASSWORD.test(t)},n.isChinese=function(t){return o.CHINESE.test(t)},n}(function(){}),u={patterns:o,validator:i},a=function(t){if(!t)return"";var e=Math.max(t.lastIndexOf("/"),t.lastIndexOf("\\"));return-1===e?t:t.slice(e+1)};function s(t){if("string"==typeof t){if(!/^\d+$/.test(t))return!1;t=Number(t)}if("number"!=typeof t||isNaN(t))return!1;var e=41024448e5;return 13===t.toString().length?t>=0&&t<=e:10===t.toString().length&&(t>=0&&t<=4102444800)}var c=function(t){return s(t)&&10===t.toString().length};t.RegexPatterns=o,t.RegexValidator=i,t.downloadSingleFile=function(t,e){return n(void 0,void 0,void 0,function(){var n,o,i,s,c,f,l;return r(this,function(r){switch(r.label){case 0:if(!t||!u.validator.isUrl(t))throw new Error("无效的URL");r.label=1;case 1:return r.trys.push([1,4,,5]),[4,fetch(t)];case 2:if(!(n=r.sent()).ok)throw new Error("下载失败: ".concat(n.status," ").concat(n.statusText));return(o=e)||(o=a(t),-1!==(i=o.indexOf("?"))&&(o=o.substring(0,i)),o||(o="downloaded_file")),[4,n.blob()];case 3:return s=r.sent(),c=URL.createObjectURL(s),(f=document.createElement("a")).href=c,f.download=o,document.body.appendChild(f),f.click(),setTimeout(function(){URL.revokeObjectURL(c),f.remove()},100),[3,5];case 4:throw l=r.sent(),console.error("文件下载失败:",l),l;case 5:return[2]}})})},t.extractFileNameFromPath=a,t.getElapsedTimeSince=function(t){var e=Date.now();s(t)||(t=e);var n=Math.max(0,e-(c(t)?1e3*t:t));return{hours:Math.floor(n/36e5),minutes:Math.floor(n%36e5/6e4),seconds:Math.floor(n%6e4/1e3)}},t.getUuid=function(){return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,function(t){var e=16*Math.random()|0;return("x"==t?e:3&e|8).toString(16)})},t.isMillisecondTimestamp=function(t){return s(t)&&13===t.toString().length},t.isSecondTimestamp=c,t.isValidTimestamp=s,t.sleep=function(t){return new Promise(function(e){setTimeout(function(){e(!0)},1e3*t)})}});
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).ZiyaUtils={})}(this,function(t){"use strict";function e(t,e,n,o){return new(n||(n=Promise))(function(i,s){function r(t){try{c(o.next(t))}catch(t){s(t)}}function a(t){try{c(o.throw(t))}catch(t){s(t)}}function c(t){var e;t.done?i(t.value):(e=t.value,e instanceof n?e:new n(function(t){t(e)})).then(r,a)}c((o=o.apply(t,e||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;const n={PHONE:/^1[3-9]\d{9}$/,EMAIL:/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,ID_CARD:/(^\d{15}$)|(^\d{17}(\d|X|x)$)/,URL:/^(https?:\/\/)?([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/,IPV4:/^(\d{1,3}\.){3}\d{1,3}$/,STRONG_PASSWORD:/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/,CHINESE:/^[\u4e00-\u9fa5]+$/};class o{}class i extends o{static isPhone(t){return n.PHONE.test(t)}static isEmail(t){return n.EMAIL.test(t)}static isIdCard(t){return n.ID_CARD.test(t)}static isUrl(t){return n.URL.test(t)}static isIpv4(t){return n.IPV4.test(t)}static isStrongPassword(t){return n.STRONG_PASSWORD.test(t)}static isChinese(t){return n.CHINESE.test(t)}}var s={patterns:n,validator:i};const r=t=>{if(!t)return"";const e=Math.max(t.lastIndexOf("/"),t.lastIndexOf("\\"));return-1===e?t:t.slice(e+1)};function a(t){if("string"==typeof t){if(!/^\d+$/.test(t))return!1;t=Number(t)}if("number"!=typeof t||isNaN(t))return!1;const e=41024448e5;return 13===t.toString().length?t>=0&&t<=e:10===t.toString().length&&(t>=0&&t<=4102444800)}const c=t=>a(t)&&10===t.toString().length;class l{constructor(t={}){var e;this.interceptRules=[],this.isActive=!1,this.originalXMLHttpRequest=window.XMLHttpRequest,this.enableLogging=null===(e=t.enableLogging)||void 0===e||e}start(){if(this.isActive)return void this.log("拦截器已经启动");const t=this;window.XMLHttpRequest=function(){const n=new t.originalXMLHttpRequest;let o="";const i=n.open;n.open=function(t,e,n=!0,s,r){return o="string"==typeof e?e:e.toString(),i.call(this,t,e,n,s,r)};const s=n.send;return n.send=function(i){const r=t.findMatchingRule(o);if(!r)return s.call(this,i);const a=n.onreadystatechange;return n.onreadystatechange=function(i){return e(this,void 0,void 0,function*(){if(4===n.readyState&&n.status>=200&&n.status<300)try{const e=JSON.parse(n.responseText),i=yield r.responseCallback(e);Object.defineProperty(n,"responseText",{writable:!0,configurable:!0,value:JSON.stringify(i)}),Object.defineProperty(n,"response",{writable:!0,configurable:!0,value:JSON.stringify(i)}),t.log(`已拦截并修改响应: ${o}`)}catch(e){t.log("拦截器处理失败:",e)}a&&a.call(this,i)})},s.call(this,i)},n},Object.setPrototypeOf(window.XMLHttpRequest,this.originalXMLHttpRequest),window.XMLHttpRequest.prototype=this.originalXMLHttpRequest.prototype,this.isActive=!0,this.log("XHR拦截器已启动")}stop(){this.isActive?(window.XMLHttpRequest=this.originalXMLHttpRequest,this.isActive=!1,this.log("XHR拦截器已停止，已恢复原始XMLHttpRequest")):this.log("拦截器未启动")}setRules(t){this.interceptRules=[...t],this.log("已设置拦截规则:",t.map(t=>t.url))}addRule(t,e){this.interceptRules.push({url:t,responseCallback:e}),this.log(`已添加拦截规则: ${t}`)}removeRule(t){const e=this.interceptRules.length;this.interceptRules=this.interceptRules.filter(e=>e.url!==t);const n=this.interceptRules.length<e;return n?this.log(`已移除拦截规则: ${t}`):this.log(`未找到拦截规则: ${t}`),n}clearRules(){this.interceptRules=[],this.log("已清除所有拦截规则")}getRules(){return[...this.interceptRules]}getStatus(){return{isActive:this.isActive,rulesCount:this.interceptRules.length}}findMatchingRule(t){return this.interceptRules.find(e=>t.includes(e.url))}log(t,...e){this.enableLogging&&console.log(`[XHRInterceptor] ${t}`,...e)}}const u=new l({enableLogging:!0});t.RegexPatterns=n,t.RegexValidator=i,t.XHRInterceptor=l,t.copyToClipboard=function(t){return e(this,void 0,void 0,function*(){try{var e=JSON.stringify(t);if(navigator.clipboard&&(window.isSecureContext||"https:"===location.protocol||"localhost"===location.hostname))return yield navigator.clipboard.writeText(e),!0;var n=document.createElement("textarea");n.value=e,n.style.position="fixed",n.style.left="-9999px",n.style.top="-9999px",document.body.appendChild(n),n.select();var o=document.execCommand("copy");return document.body.removeChild(n),o}catch(t){return console.error("复制失败:",t),!1}})},t.createFormData=function(t){const e=new FormData;if("string"==typeof t){const n=new URLSearchParams(t);for(const[t,o]of n)e.append(t,o)}else"object"==typeof t&&null!==t&&Object.keys(t).forEach(n=>{const o=t[n];null!=o?Array.isArray(o)?o.forEach(t=>e.append(n,String(t))):o instanceof File||o instanceof Blob?e.append(n,o):"object"==typeof o?e.append(n,JSON.stringify(o)):e.append(n,String(o)):e.append(n,"")});return e},t.downloadSingleFile=(t,n)=>e(void 0,void 0,void 0,function*(){if(!t||!s.validator.isUrl(t))throw new Error("无效的URL");try{const e=yield fetch(t);if(!e.ok)throw new Error(`下载失败: ${e.status} ${e.statusText}`);let o=n;if(!o){o=r(t);const e=o.indexOf("?");-1!==e&&(o=o.substring(0,e)),o||(o="downloaded_file")}const i=yield e.blob(),s=URL.createObjectURL(i),a=document.createElement("a");a.href=s,a.download=o,document.body.appendChild(a),a.click(),setTimeout(()=>{URL.revokeObjectURL(s),a.remove()},100)}catch(t){throw console.error("文件下载失败:",t),t}}),t.extractFileNameFromPath=r,t.formatDateTypeSafe=function(t,e){return function(t,e){const n=e||new Date,o=(t,e=2)=>t.toString().padStart(e,"0"),i={year:n.getFullYear(),month:n.getMonth()+1,day:n.getDate(),hours:n.getHours(),minutes:n.getMinutes(),seconds:n.getSeconds(),milliseconds:n.getMilliseconds()},s={YYYY:i.year.toString(),YY:i.year.toString().slice(-2),MM:o(i.month),M:i.month.toString(),DD:o(i.day),D:i.day.toString(),HH:o(i.hours),H:i.hours.toString(),mm:o(i.minutes),m:i.minutes.toString(),ss:o(i.seconds),s:i.seconds.toString(),SSS:o(i.milliseconds,3)};return Object.keys(s).sort((t,e)=>e.length-t.length).reduce((t,e)=>t.replace(new RegExp(e,"g"),s[e]),t)}(t,e)},t.getElapsedTimeSince=t=>{const e=Date.now();a(t)||(t=e);const n=Math.max(0,e-(c(t)?1e3*t:t));return{hours:Math.floor(n/36e5),minutes:Math.floor(n%36e5/6e4),seconds:Math.floor(n%6e4/1e3)}},t.getUuid=function(){return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,function(t){var e=16*Math.random()|0;return("x"==t?e:3&e|8).toString(16)})},t.isMillisecondTimestamp=t=>a(t)&&13===t.toString().length,t.isSecondTimestamp=c,t.isValidTimestamp=a,t.precisionFormat=function(t,e,n=!0,o=!0){var i=t<0&&o?-1:1;const s=Math.pow(10,e);return n?Math.round(t*s*i)/s*i:Math.floor(t*s*i)/s*i},t.sleep=t=>new Promise(e=>{setTimeout(()=>{e(!0)},1e3*t)}),t.xhrInterceptor=u});

package/es/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/es/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/es/count/index.js

@@ -0,0 +1,30 @@
+/**
+ * @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;
+}
+
+export { precisionFormat };

package/es/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, };

package/es/date/index.js

@@ -1,6 +1,6 @@
 /**
  * @fileoverview 日期模块
- * @date 2025-04-02
+ * @created 2025-04-02
  * @author glk
  */
 /**
@@ -23,9 +23,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) {
         // 毫秒级时间戳
@@ -43,39 +43,86 @@ 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);
+}
 
-export { getElapsedTimeSince, isMillisecondTimestamp, isSecondTimestamp, isValidTimestamp };
+export { formatDateTypeSafe, getElapsedTimeSince, isMillisecondTimestamp, isSecondTimestamp, isValidTimestamp };

package/es/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/es/file/index.d.ts

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

package/es/file/index.js

@@ -1,9 +1,9 @@
-import { __awaiter, __generator } from '../node_modules/tslib/tslib.es6.js';
+import { __awaiter } from '../node_modules/tslib/tslib.es6.js';
 import IRegexUtils from '../regexp/index.js';
 
 /**
  * @fileoverview 文件模块
- * @date 2025-04-2
+ * @created 2025-04-2
  * @author glk
  */
 /**
@@ -11,12 +11,12 @@ import IRegexUtils from '../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;
@@ -30,60 +30,52 @@ var extractFileNameFromPath = function (filePath) {
  * @returns Promise<void>
  * @throws Error 当URL无效或网络请求失败时抛出错误
  */
-var downloadSingleFile = function (url, name) { return __awaiter(void 0, void 0, void 0, function () {
-    var response, fileName, queryIndex, blob, blobUrl_1, link_1, error_1;
-    return __generator(this, function (_a) {
-        switch (_a.label) {
-            case 0:
-                // 验证URL
-                if (!url || !IRegexUtils.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) => __awaiter(void 0, void 0, void 0, function* () {
+    // 验证URL
+    if (!url || !IRegexUtils.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; // 重新抛出错误以便调用者可以处理
+    }
+});
 
 export { downloadSingleFile, extractFileNameFromPath };

package/es/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/es/form/index.js

@@ -0,0 +1,51 @@
+/**
+ * @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;
+}
+
+export { createFormData };

package/es/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/es/index.js

@@ -1,5 +1,8 @@
 export { downloadSingleFile, extractFileNameFromPath } from './file/index.js';
 export { sleep } from './time/index.js';
-export { getElapsedTimeSince, isMillisecondTimestamp, isSecondTimestamp, isValidTimestamp } from './date/index.js';
-export { getUuid } from './security/index.js';
+export { formatDateTypeSafe, getElapsedTimeSince, isMillisecondTimestamp, isSecondTimestamp, isValidTimestamp } from './date/index.js';
+export { copyToClipboard, getUuid } from './security/index.js';
 export { RegexPatterns, RegexValidator } from './regexp/index.js';
+export { createFormData } from './form/index.js';
+export { precisionFormat } from './count/index.js';
+export { XHRInterceptor, xhrInterceptor } from './xhr/index.js';

package/es/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 };