@ivujs/i-utils 2.0.0 → 2.1.1

package/dist/es/constants/regexp.mjs

@@ -1,25 +1,48 @@
 /**
- * 正则
+ * 正则表达式相关常量配置（全局只读）
+ *
+ * CH: 中文汉字
+ * EN: 英文字母
+ * LOWER_CASE: 小写字母
+ * UPPER_CASE: 大写字母
+ * CH_NAME: 中文姓名（2-16位）
+ * EN_NAME: 英文姓名（1-20位）
+ * NUMBER: 数字（包含正数和负数）
+ * INTEGER: 整数（包含：0，正整数和负整数）
+ * DECIMAL: 小数（包含正小数和负小数）
+ * INT_OR_FLOAT: 正整数或者保留两位小数
+ * MOBILE: 手机号码（支持+86）
+ * PHONE: 固定电话号码（比如：0755-1111111）
+ * EMAIL: 邮箱
+ * ID_CARD: 一代15位或二代18位身份证
+ * ID_CARD15: 仅校验一代15位身份证
+ * ID_CARD18: 仅校验二代18位身份证
+ * BANK_CARD: 银行卡号
+ * POST_CODE: 邮政编码
+ * URL: url地址（可获取主机地址、主机名、端口号、协议、查询参数、hash等信息）
+ * IP: ip地址
+ * IP6: IPv6地址
+ * EXTERNAL: 外链（http、https、mail、tel电话）
  */
 const REGEXP = {
     // 中文汉字
     CH: /^[\u4E00-\u9FA5]+$/,
-    // 英文字母
-    EN: /^[a-zA-Z]$/,
+    // 英文字母,1个以上
+    EN: /^[a-zA-Z]+$/,
     // 小写字母
     LOWER_CASE: /^[a-z]+$/,
     // 大写字母
     UPPER_CASE: /^[A-Z]+$/,
-    // 中文姓名，2-16位
+    // 中文姓名，2-16位（支持少数民族姓名间隔符「·」）
     CH_NAME: /^[\u4e00-\u9fa5·]{2,16}$/,
-    // 英文姓名，0-20位
-    EN_NAME: /(^[a-zA-Z][a-zA-Z\s]{0,20}[a-zA-Z]$)/,
+    // 英文姓名，1-20位
+    EN_NAME: /^[a-zA-Z\s]{1,20}$/,
     // 数字，包含正数和负数
     NUMBER: /^([-+])?\d+(\.\d+)?$/,
     // 整数，包含：0，正整数和负整数
     INTEGER: /^(0|[1-9][0-9]*|-[1-9][0-9]*)$/,
     // 小数，包含正小数和负小数
-    DECIMAL: /^\d+\.\d+$/,
+    DECIMAL: /^([-+])?\d+\.\d+$/,
     // 正整数或者保留两位小数
     INT_OR_FLOAT: /(^[1-9][0-9]*$)|(^[1-9][0-9]*\.[0-9]{1,2}$)|(^0\.[0-9]{1,2}$)|(^0$)/,
     // 手机号码，支持+86
@@ -28,7 +51,7 @@ const REGEXP = {
     PHONE: /^(?:(?:\d{3}-)?\d{8}|^(?:\d{4}-)?\d{7,8})(?:-\d+)?$/,
     // 邮箱
     EMAIL: /^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$/,
-    // 一代15位和二代18位身份证
+    // 一代15位或二代18位身份证
     ID_CARD: /(^\d{8}(0\d|10|11|12)([0-2]\d|30|31)\d{3}$)|(^\d{6}(18|19|20)\d{2}(0[1-9]|10|11|12)([0-2]\d|30|31)\d{3}(\d|X|x)$)/,
     // 仅校验一代15位身份证
     ID_CARD15: /(^\d{8}(0\d|10|11|12)([0-2]\d|30|31)\d{3}$)/,
@@ -43,9 +66,9 @@ const REGEXP = {
     // ip地址
     IP: /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
     // IPv6地址
-    IP6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+    IP6: /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|::([0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}|[0-9a-fA-F]{1,4}::([0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4})$/i,
     // 是外链，http，https，mail，tel电话
-    EXTERNAL: /^(http?:|https?:|mailto:|tel:)/,
+    EXTERNAL: /^(http:|https:|ftp:|ftps:|mailto:|tel:)/i,
 };
 
 export { REGEXP };

package/dist/es/constants/sort.d.ts

@@ -1,5 +1,13 @@
-export namespace SORT {
-    let DESC: number;
-    let ASC: number;
-    let RANDOM: number;
-}
+/**
+ * 排序相关常量配置（全局只读）
+ *
+ * DESC: 降序
+ *  - 取值：0
+ *
+ * ASC: 升序
+ *  - 取值：1
+ *
+ * RANDOM: 随机排序
+ *  - 取值：2
+ */
+export declare const SORT: Record<string, number>;

package/dist/es/constants/sort.mjs

@@ -1,5 +1,14 @@
 /**
- * 排序
+ * 排序相关常量配置（全局只读）
+ *
+ * DESC: 降序
+ *  - 取值：0
+ *
+ * ASC: 升序
+ *  - 取值：1
+ *
+ * RANDOM: 随机排序
+ *  - 取值：2
  */
 const SORT = {
     // 降序

package/dist/es/cookie/index.d.ts

@@ -1,29 +1,29 @@
 /**
  * 浏览器是否支持 Cookie
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
-export function isSupportCookie(): boolean;
+export declare function isSupportCookie(): boolean;
 /**
  * 通过name获取cookie
- * @param {String} name 参数name
- * @returns {String} 返回获取的值
+ * @param {string} name 参数name
+ * @returns {string} 返回获取的值
  */
-export function getCookie(name: string): string;
+export declare function getCookie(name: string): string;
 /**
  * 通过name设置cookie
  * 注：timestamp参数不填，则默认为session级别，浏览器关闭即cookie过期
- * @param {String} name 参数name
- * @param {String} value 设置的value
- * @param {Number} timestamp 过期的时间戳值，默认为一天，设置一天过期则为：24*60*60*1000
+ * @param {string} name 参数name
+ * @param {string} value 设置的value
+ * @param {number} timestamp 过期的时间戳值，默认为一天，设置一天过期则为：24*60*60*1000
  */
-export function setCookie(name: string, value: string, timestamp?: number): void;
+export declare function setCookie(name: string, value: string, timestamp?: number): void;
 /**
  * 通过name删除cookie
- * @param {String} name 参数name
+ * @param {string} name 参数name
  */
-export function removeCookie(name: string): void;
+export declare function removeCookie(name: string): void;
 /**
  * 清空当前站点域名的cookie
- * @param {String} domain 域名地址，默认是当前站点域名
+ * @param {string} domain 域名地址，默认是当前站点域名
  */
-export function clearCookie(domain?: string): void;
+export declare function clearCookie(domain?: string): void;

package/dist/es/cookie/index.mjs

@@ -1,8 +1,11 @@
 import { isEmpty } from '../validate/index.mjs';
 
+/**
+ * @module 浏览器Cookie
+ */
 /**
  * 浏览器是否支持 Cookie
- * @returns {Boolean} 返回true和false
+ * @returns {boolean} 返回true和false
  */
 function isSupportCookie() {
     return window.navigator.cookieEnabled;
@@ -10,16 +13,16 @@ function isSupportCookie() {
 /* cookie存储 */
 /**
  * 通过name获取cookie
- * @param {String} name 参数name
- * @returns {String} 返回获取的值
+ * @param {string} name 参数name
+ * @returns {string} 返回获取的值
  */
 function getCookie(name) {
     if (typeof document == "undefined")
         return "";
     // cookie中每个分号后面是有个空格的，需要替换掉
-    let arr = document.cookie ? document.cookie.replace(/\s/g, "").split(";") : [];
-    for (let i in arr) {
-        let tempArr = arr[i].split("=");
+    const arr = document.cookie ? document.cookie.replace(/\s/g, "").split(";") : [];
+    for (const i in arr) {
+        const tempArr = arr[i].split("=");
         if (tempArr[0] === name) {
             return decodeURIComponent(tempArr[1]);
         }
@@ -29,9 +32,9 @@ function getCookie(name) {
 /**
  * 通过name设置cookie
  * 注：timestamp参数不填，则默认为session级别，浏览器关闭即cookie过期
- * @param {String} name 参数name
- * @param {String} value 设置的value
- * @param {Number} timestamp 过期的时间戳值，默认为一天，设置一天过期则为：24*60*60*1000
+ * @param {string} name 参数name
+ * @param {string} value 设置的value
+ * @param {number} timestamp 过期的时间戳值，默认为一天，设置一天过期则为：24*60*60*1000
  */
 function setCookie(name, value, timestamp = 24 * 60 * 60 * 1000) {
     if (typeof document == "undefined")
@@ -40,7 +43,7 @@ function setCookie(name, value, timestamp = 24 * 60 * 60 * 1000) {
 }
 /**
  * 通过name删除cookie
- * @param {String} name 参数name
+ * @param {string} name 参数name
  */
 function removeCookie(name) {
     if (isEmpty(name))
@@ -49,11 +52,11 @@ function removeCookie(name) {
 }
 /**
  * 清空当前站点域名的cookie
- * @param {String} domain 域名地址，默认是当前站点域名
+ * @param {string} domain 域名地址，默认是当前站点域名
  */
 function clearCookie(domain = document.domain) {
-    let names = document.cookie.match(/[^ =;]+(?==)/g);
-    if (names) {
+    const names = document.cookie.match(/[^ =;]+(?==)/g) || [];
+    if (names && names.length > 0) {
         for (let i = names.length; i--;) {
             document.cookie =
                 names[i] + "=0;path=/;" + domain ? "domain=" + domain + ";" : "" + "expires=" + new Date(0).toUTCString();

package/dist/es/crypto/base64/base64.d.ts

@@ -1,5 +1,8 @@
-export function utf8Encode(str: any): any;
-export function utf8Decode(base64Str: any): any;
-export function encode(str: any, asciiOnly: any): any;
-export function decode(base64Str: any, asciiOnly: any): any;
-export function decodeAsBytes(base64Str: any): number[];
+export function fromUint8Array(uint8Array: Uint8Array, urlSafe?: boolean): string;
+export function toUint8Array(base64Str: string, urlSafe?: boolean): Uint8Array;
+export function fromHex(hexStr: string, urlSafe?: boolean): string;
+export function toHex(base64Str: string, urlSafe?: boolean): string;
+export function encode(data: string | number[] | Uint8Array | ArrayBuffer, urlSafe?: boolean): string;
+export function decode(base64Str: string): string;
+export function encodeURI(data: string | number[] | Uint8Array | ArrayBuffer): string;
+export function decodeURI(base64Str: string): string;