@ivujs/i-utils 2.1.0 → 2.1.2

package/dist/cjs/ID-card/index.cjs

@@ -64,7 +64,7 @@ function getAgeByIDCard(idCard) {
  */
 function getSexByIDCard(idCard$1) {
     if (index.isNull(idCard$1))
-        return undefined;
+        return;
     // 15位身份证
     if (idCard$1.length === 15) {
         return Number(idCard$1.substring(14)) % 2 === 0 ? idCard.ID_CARD.SEX.WOMAN : idCard.ID_CARD.SEX.MAN;

package/dist/cjs/color/index.cjs

@@ -186,7 +186,7 @@ function getDrawRgba() {
 /**
  * 颜色值转换
  * @param {number} num 转换的值
- * @returns
+ * @returns {string} 返回计算
  */
 function _hex(num) {
     if (num > 255) {

package/dist/cjs/constants/date.cjs

@@ -1,7 +1,61 @@
 'use strict';
 
 /**
- * 日期
+ * 日期相关的多语言常量配置（全局只读）
+ *
+ * AM_PM: 上午/下午多语言配置
+ *  - zh: { AM: "上午", PM: "下午" }
+ *  - en: { AM: "AM", PM: "PM" }
+ *
+ * WEEK: 星期多语言配置
+ *  - zh.FULL: ["星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"]
+ *  - zh.SHORT: ["周日", "周一", "周二", "周三", "周四", "周五", "周六"]
+ *  - zh.MINI: ["日", "一", "二", "三", "四", "五", "六"]
+ *  - en.FULL: ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]
+ *  - en.SHORT: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
+ *  - en.MINI: ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"]
+ *
+ * MONTH: 月份多语言配置
+ *  - zh.FULL: ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"]
+ *  - zh.SHORT: ["一", "二", "三", "四", "五", "六", "七", "八", "九", "十", "十一", "十二"]
+ *  - en.FULL: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"]
+ *  - en.SHORT: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
+ *
+ * QUARTER: 季度多语言配置
+ *  - zh.FULL: ["第一季度", "第二季度", "第三季度", "第四季度"]
+ *  - zh.SHORT: ["一季度", "二季度", "三季度", "四季度"]
+ *  - zh.MINI: ["一", "二", "三", "四"]
+ *  - en.FULL: ["quarter 1st", "quarter 2nd", "quarter 3rd", "quarter 4th"]
+ *  - en.SHORT: ["Q1th", "Q2nd", "Q3rd", "Q4th"]
+ *  - en.MINI: ["Q1", "Q2", "Q3", "Q4"]
+ *
+ * OVER_TIME: 剩余时间单位多语言配置
+ *  - zh: { YEAR: "年", MONTH: "月", DATE: "日", HOUR: "时", MINUTE: "分", SECOND: "秒", MILLISECOND: "毫秒", DAY: "天", QUARTER: "季度" }
+ *  - en: { YEAR: "year", MONTH: "month", DATE: "date", HOUR: "hour", MINUTE: "minute", SECOND: "second", MILLISECOND: "millisecond", DAY: "day", QUARTER: "quarter" }
+ *
+ * PASS_TIME: 过去时间描述多语言配置
+ *  - zh: { YEAR: "年前", MONTH: "个月前", DAY: "天前", BEFORE_YESTERDAY: "前天", YESTERDAY: "昨天", TODAY: "今天", HOUR: "小时前", MINUTE: "分钟前", JUST: "刚刚" }
+ *  - en: { YEAR: " year ago", MONTH: " month ago", DAY: " day ago", BEFORE_YESTERDAY: "before yesterday", YESTERDAY: " yesterday", TODAY: " today", HOUR: " hour ago", MINUTE: " minute ago", JUST: " just" }
+ *
+ * HOLIDAY: 节假日多语言配置
+ *  - zh: ["元旦", "春节", "清明节", "劳动节", "端午节", "中秋节", "国庆节"]
+ *  - en: ["New Year‘s Day", "Spring Festival", "Tomb Sweeping Day", "Labor Day", "Dragon Boat Festival", "Mid-Autumn Day", "National Day"]
+ *
+ * ZODIAC: 星座多语言配置
+ *  - zh: ["摩羯座", "水瓶座", "双鱼座", "白羊座", "金牛座", "双子座", "巨蟹座", "狮子座", "处女座", "天秤座", "天蝎座", "射手座"]
+ *  - en: ["Capricorn", "Aquarius", "Pisces", "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo", "Libra", "Scorpio", "Sagittarius"]
+ *
+ * CHINESE_ZODIAC: 生肖多语言配置
+ *  - zh: ["鼠", "牛", "虎", "兔", "龙", "蛇", "马", "羊", "猴", "鸡", "狗", "猪"]
+ *  - en: ["Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig"]
+ *
+ * HEAVENLY_STEMS: 天干多语言配置
+ *  - zh: ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"]
+ *  - en: ["Jia", "Yi", "Bing", "Ding", "Wu", "Ji", "Geng", "Xin", "Ren", "Gui"]
+ *
+ * EARTHLY_BRANCHES: 地支多语言配置
+ *  - zh: ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"]
+ *  - en: ["Zi", "Chou", "Yin", "Mao", "Chen", "Si", "Wu", "Wei", "Shen", "You", "Xu", "Hai"]
  */
 const DATE = {
     // 上午和下午

package/dist/cjs/constants/id-card.cjs

@@ -1,7 +1,48 @@
 'use strict';
 
 /**
- * 身份证号
+ * 身份证号相关常量配置（全局只读）
+ *
+ * PROVINCE: 身份证号前两位对应的省份/地区编码映射
+ *  - 11: 北京
+ *  - 12: 天津
+ *  - 13: 河北
+ *  - 14: 山西
+ *  - 15: 内蒙古
+ *  - 21: 辽宁
+ *  - 22: 吉林
+ *  - 23: 黑龙江
+ *  - 31: 上海
+ *  - 32: 江苏
+ *  - 33: 浙江
+ *  - 34: 安徽
+ *  - 35: 福建
+ *  - 36: 江西
+ *  - 37: 山东
+ *  - 41: 河南
+ *  - 42: 湖北
+ *  - 43: 湖南
+ *  - 44: 广东
+ *  - 45: 广西
+ *  - 46: 海南
+ *  - 50: 重庆
+ *  - 51: 四川
+ *  - 52: 贵州
+ *  - 53: 云南
+ *  - 54: 西藏
+ *  - 61: 陕西
+ *  - 62: 甘肃
+ *  - 63: 青海
+ *  - 64: 宁夏
+ *  - 65: 新疆
+ *  - 71: 台湾
+ *  - 81: 香港
+ *  - 82: 澳门
+ *  - 91: 国外
+ *
+ * SEX: 身份证号解析的性别映射
+ *  - MAN: 男
+ *  - WOMAN: 女
  */
 const ID_CARD = {
     // 身份证号对应的省

package/dist/cjs/constants/keycode.cjs

@@ -1,7 +1,122 @@
 'use strict';
 
-/*
- * 键盘码
+/**
+ * 键盘码相关常量配置（全局只读）
+ *
+ * 字符键：
+ *  - 8: Backspace
+ *  - 9: Tab
+ *  - 13: Enter
+ *  - 16: Shift
+ *  - 17: Ctrl
+ *  - 18: Alt
+ *  - 19: Pause
+ *  - 20: Caps Lock
+ *  - 27: Escape
+ *  - 32: Space
+ *  - 33: Page Up
+ *  - 34: Page Down
+ *  - 35: End
+ *  - 36: Home
+ *  - 37: Left
+ *  - 38: Up
+ *  - 39: Right
+ *  - 40: Down
+ *  - 42: Print Screen
+ *  - 45: Insert
+ *  - 46: Delete
+ *
+ * 数字键：
+ *  - 48: 0
+ *  - 49: 1
+ *  - 50: 2
+ *  - 51: 3
+ *  - 52: 4
+ *  - 53: 5
+ *  - 54: 6
+ *  - 55: 7
+ *  - 56: 8
+ *  - 57: 9
+ *
+ * 字母键：
+ *  - 65: A
+ *  - 66: B
+ *  - 67: C
+ *  - 68: D
+ *  - 69: E
+ *  - 70: F
+ *  - 71: G
+ *  - 72: H
+ *  - 73: I
+ *  - 74: J
+ *  - 75: K
+ *  - 76: L
+ *  - 77: M
+ *  - 78: N
+ *  - 79: O
+ *  - 80: P
+ *  - 81: Q
+ *  - 82: R
+ *  - 83: S
+ *  - 84: T
+ *  - 85: U
+ *  - 86: V
+ *  - 87: W
+ *  - 88: X
+ *  - 89: Y
+ *  - 90: Z
+ *
+ * window 相关键：
+ *  - 91: Windows
+ *  - 93: Right Click
+ *
+ * 数字小键盘（Numpad）：
+ *  - 96: Numpad 0
+ *  - 97: Numpad 1
+ *  - 98: Numpad 2
+ *  - 99: Numpad 3
+ *  - 100: Numpad 4
+ *  - 101: Numpad 5
+ *  - 102: Numpad 6
+ *  - 103: Numpad 7
+ *  - 104: Numpad 8
+ *  - 105: Numpad 9
+ *  - 106: Numpad *
+ *  - 107: Numpad +
+ *  - 109: Numpad -
+ *  - 110: Numpad .
+ *  - 111: Numpad /
+ *
+ * F功能键：
+ *  - 112: F1
+ *  - 113: F2
+ *  - 114: F3
+ *  - 115: F4
+ *  - 116: F5
+ *  - 117: F6
+ *  - 118: F7
+ *  - 119: F8
+ *  - 120: F9
+ *  - 121: F10
+ *  - 122: F11
+ *  - 123: F12
+ *
+ * 特殊符号/功能键：
+ *  - 144: Num Lock
+ *  - 145: Scroll Lock
+ *  - 182: My Computer
+ *  - 183: My Calculator
+ *  - 186: ;
+ *  - 187: =
+ *  - 188: ,
+ *  - 189: -
+ *  - 190: .
+ *  - 191: /
+ *  - 192: `
+ *  - 219: [
+ *  - 220: \
+ *  - 221: ]
+ *  - 222: '
  */
 const KEYCODE = {
     // 字符键

package/dist/cjs/constants/lang.cjs

@@ -1,7 +1,13 @@
 'use strict';
 
 /**
- * 语言
+ * 语言相关常量配置（全局只读）
+ *
+ * ZH: 中文
+ *  - zh
+ *
+ * EN: 英文
+ *  - en
  */
 const LANG = {
     // 中文

package/dist/cjs/constants/math.cjs

@@ -1,7 +1,15 @@
 'use strict';
 
 /**
- * 数学
+ * 数学计算相关常量配置（全局只读）
+ *
+ * ROUND: 正常四舍五入
+ *  - 取值：0
+ *  - 示例：1.354保留两位是1.35；1.355保留两位是1.36
+ *
+ * ROUND_FLOOR: 向下舍出
+ *  - 取值：1
+ *  - 示例：1.354保留两位是1.35；1.355保留两位是1.35
  */
 const MATH = {
     // 正常四舍五入，如：1.354保留两位是1.35；1.355保留两位是1.36；

package/dist/cjs/constants/regexp.cjs

@@ -1,27 +1,50 @@
 'use strict';
 
 /**
- * 正则
+ * 正则表达式相关常量配置（全局只读）
+ *
+ * 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
@@ -30,7 +53,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}$)/,
@@ -45,9 +68,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,
 };
 
 exports.REGEXP = REGEXP;

package/dist/cjs/constants/sort.cjs

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