@ivujs/i-utils 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Gao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# 前端模块化 JavaScript 工具库
+
+[![npm version](https://img.shields.io/npm/v/xe-utils.svg?style=flat-square)](https://github.com/qq575792372/i-utils)
+[![npm license](https://img.shields.io/github/license/mashape/apistatus.svg)](LICENSE)
+
+🔥 **i-utils** 🔥 是一个 前端模块化 **JavaScript** 工具库，目前共有 **362** ⚡️ 个 Api
+方法，支持`esm模块`和`umd浏览器环境`使用
+，工具库包含了开发中经常用到的一些模块方法集合，如`字符串`，`数组`，`浏览器缓存`，`浏览器Cookie`，`浏览器剪切板`，`Dom处理`，
+`日期工具`，`加密解密`，`数学计算`，`文件处理`，`正则校验`，`身份证信息`,`微信小程序工具`
+等等。
+
+### 📦 安装
+
+#### 1. 使用 npm 安装
+
+```bash
+# npm
+npm i @ivujs/i-utils --save
+
+# pnpm
+pnpm i @ivujs/i-utils --save
+
+# yarn
+yarn add @ivujs/i-utils --save
+```
+
+### 🎨 使用
+
+#### 1. es 模块化引入方式
+
+```javascript
+// 按需引入
+import { loadedTest } from "@ivujs/i-utils";
+
+loadedTest();
+
+// 全部引入
+import * as iUtils from "@ivujs/i-utils";
+
+iUtils.loadedTest();
+```
+
+#### 2. umd 浏览器环境引入方式
+
+```javascript
+<!-- 将工具库下面 dist/lib/index.full.umd.js 文件拷贝出来引入 -->
+<script src="dist/lib/index.full.umd.js"></script>;
+<!-- 这里使用的实际是全局的 window.iUtils 对象 -->
+<script>
+  iUtils.loadedTest();
+</script>;
+```
+
+#### 3. require 服务端环境引入方式
+
+```javascript
+// 全部引入
+const iUtils = require("@ivujs/i-utils");
+iUtils.loadedTest();
+
+// 按需引入
+const { loadedTest } = require("@ivujs/i-utils");
+loadedTest();
+```
+
+### 🔨 构建
+
+工具库源码架构使用 `pnpm` 做为包管理工具，打包后生成esm和umd可以用的包。
+
+```bash
+# 构建包
+pnpm build
+```
+
+### ✅ 发布
+
+```bash
+pnpm publish
+```
+
+### 📝API 文档
+
+[常量集合 Constant](https://github.com/qq575792372/i-utils/blob/main/doc/constants.md)
+
+[字符串](https://github.com/qq575792372/i-utils/blob/main/doc/string.md)  
+[数字](https://github.com/qq575792372/i-utils/blob/main/doc/number.md)     
+[数组](https://github.com/qq575792372/i-utils/blob/main/doc/array.md)    
+[对象](https://github.com/qq575792372/i-utils/blob/main/doc/object.md)    
+[函数](https://github.com/qq575792372/i-utils/blob/main/doc/function.md)    
+[日期](https://github.com/qq575792372/i-utils/blob/main/doc/date.md)   
+[数学](https://github.com/qq575792372/i-utils/blob/main/doc/math.md)  
+[正则](https://github.com/qq575792372/i-utils/blob/main/doc/regexp.md)  
+[随机数](https://github.com/qq575792372/i-utils/blob/main/doc/random.md)
+
+[文件](https://github.com/qq575792372/i-utils/blob/main/doc/file.md)  
+[颜色](https://github.com/qq575792372/i-utils/blob/main/doc/color.md)  
+[校验](https://github.com/qq575792372/i-utils/blob/main/doc/validate.md)  
+[键盘](https://github.com/qq575792372/i-utils/blob/main/doc/keycode.md)
+
+[生成id](https://github.com/qq575792372/i-utils/blob/main/doc/id.md)  
+[加解密算法](https://github.com/qq575792372/i-utils/blob/main/doc/crypto.md)  
+[脱敏](https://github.com/qq575792372/i-utils/blob/main/doc/desensitized.md)  
+[身份证号码](https://github.com/qq575792372/i-utils/blob/main/doc/ID-card.md)  
+[分页](https://github.com/qq575792372/i-utils/blob/main/pagination/net.md)
+
+[浏览器 Url](https://github.com/qq575792372/i-utils/blob/main/doc/browser-url.md)  
+[浏览器 Cookie](https://github.com/qq575792372/i-utils/blob/main/doc/browser-storage.md)    
+[浏览器 Storage](https://github.com/qq575792372/i-utils/blob/main/doc/browser-cookie.md)   
+[浏览器 Dom](https://github.com/qq575792372/i-utils/blob/main/doc/browser-dom.md)  
+[浏览器 Device](https://github.com/qq575792372/i-utils/blob/main/doc/browser-device.md)  
+[浏览器 Clipboard](https://github.com/qq575792372/i-utils/blob/main/doc/browser-clipboard.md)
+
+[微信小程序工具](https://github.com/qq575792372/i-utils/blob/main/doc/weapp.md)
+
+### 🔖Git 提交规范
+
+#### 😝 主要
+
+`fix`: 修复 bug  
+`add`: 增加功能  
+`del`: 删除功能  
+`update`: 更新功能
+
+#### 😉 次要
+
+`docs`: 文档更新  
+`merge`: 合并分支  
+`style`: 颜色、字体大小等变动（不影响代码运行）  
+`build`: 构造工具或相关依赖变更  
+`refactor`: 代码重构  
+`revert`: 撤销，版本回退
+
+#### 😳 一般
+
+`test`: 添加或修改测试  
+`perf`: 提高性能的改动  
+`chore`: 构建过程或辅助工具的变更  
+`ci`: CI 配置，脚本文件等改动
+
+```bash
+# <type>后面英文冒号，并且后跟一个空格
+git commit -m <type>(<scope>): <description>
+
+# 举个栗子
+git commit -m 'fix: 修复了xxx问题'
+git commit -m 'fix(string): 修复了string工具类的xxx问题'
+git commit -m 'docs: 更新了字符串模块文档'
+```
+

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

@@ -0,0 +1,122 @@
+'use strict';
+
+var index = require('../validate/index.cjs');
+var index$1 = require('../date/index.cjs');
+
+/**
+ * 根据身份证号码获取信息
+ * @description 能获取到 籍贯，出生日期，年龄，性别
+ * @param {String} idCard 身份证号码，支持一代15位和二代18位
+ * @returns {Object} 返回身份证信息对象
+ */
+function getInfoByIDCard(idCard) {
+  if (index.isNull(idCard)) return;
+  return {
+    // 省份
+    province: getProvinceByIDCard(idCard),
+    // 生日
+    birthday: getBirthdayByIDCard(idCard),
+    // 年龄
+    age: getAgeByIDCard(idCard),
+    // 性别
+    sex: getSexByIDCard(idCard),
+  };
+}
+
+/**
+ * 根据身份证号码获得生日
+ * @param {String} idCard 身份证号码，支持一代15位和二代18位
+ * @returns {String} 返回生日
+ */
+function getBirthdayByIDCard(idCard) {
+  if (index.isNull(idCard)) return;
+  // 15位身份证
+  if (idCard.length === 15) {
+    return "19" + idCard.substring(6, 8) + "-" + idCard.substring(8, 10) + "-" + idCard.substring(10, 12);
+  }
+  // 18位身份证
+  if (idCard.length === 18) {
+    return idCard.substring(6, 10) + "-" + idCard.substring(10, 12) + "-" + idCard.substring(12, 14);
+  }
+}
+
+/**
+ * 根据身份证号码获得年龄
+ * @param {String} idCard 身份证号码，支持一代15位和二代18位
+ * @returns {Number} 返回年龄
+ */
+function getAgeByIDCard(idCard) {
+  if (index.isNull(idCard)) return;
+  let birthday = getBirthdayByIDCard(idCard);
+  return index$1.getAge(index$1.parseDate(birthday));
+}
+
+/**
+ * 根据身份证号码获得性别
+ * @param {String} idCard 身份证号码，支持一代15位和二代18位
+ * @returns {String} 返回性别
+ */
+function getSexByIDCard(idCard) {
+  if (index.isNull(idCard)) return;
+  // 15位身份证
+  if (idCard.length === 15) {
+    return Number(idCard.substring(14)) % 2 === 0 ? "女" : "男";
+  }
+  // 18位身份证
+  if (idCard.length === 18) {
+    return Number(idCard.substring(16, 17)) % 2 === 0 ? "女" : "男";
+  }
+}
+
+/**
+ * 根据身份证号码获得省份
+ * @param {String} idCard 身份证号码，支持一代15位和二代18位
+ * @returns {String} 返回省份
+ */
+function getProvinceByIDCard(idCard) {
+  if (index.isNull(idCard)) return;
+  const 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: "国外",
+  };
+  return province[idCard.substring(0, 2)];
+}
+
+exports.getAgeByIDCard = getAgeByIDCard;
+exports.getBirthdayByIDCard = getBirthdayByIDCard;
+exports.getInfoByIDCard = getInfoByIDCard;
+exports.getProvinceByIDCard = getProvinceByIDCard;
+exports.getSexByIDCard = getSexByIDCard;