feat: 更新身份证工具类，新增身份证信息接口及相关功能，完善导出项，优化类型安全和错误处理。

Author: cklwblove

docs/api/_meta.json

@@ -1 +1 @@
-["index",{"type":"dir","label":"Functions","name":"functions"}]
+["index",{"type":"dir","label":"Functions","name":"functions"},{"type":"dir","label":"Interfaces","name":"interfaces"}]

docs/api/index.md

@@ -2,6 +2,12 @@
 
 ## Table of contents
 
+### Interfaces
+
+- [GenerateIdCardOptions](./interfaces/GenerateIdCardOptions.md)
+- [IdCardInfo](./interfaces/IdCardInfo.md)
+- [IdCardResult](./interfaces/IdCardResult.md)
+
 ### Functions
 
 - [accAdd](./functions/accAdd.md)
@@ -38,6 +44,7 @@
 - [formatPhone](./functions/formatPhone.md)
 - [formatTimeAgo](./functions/formatTimeAgo.md)
 - [generateGUID](./functions/generateGUID.md)
+- [generateIdCard](./functions/generateIdCard.md)
 - [get](./functions/get.md)
 - [getBrowser](./functions/getBrowser.md)
 - [getCookie](./functions/getCookie.md)
@@ -46,6 +53,9 @@
 - [getDays](./functions/getDays.md)
 - [getDevice](./functions/getDevice.md)
 - [getDiffDay](./functions/getDiffDay.md)
+- [getIdCardAge](./functions/getIdCardAge.md)
+- [getIdCardGender](./functions/getIdCardGender.md)
+- [getIdCardRegion](./functions/getIdCardRegion.md)
 - [getImgBase64](./functions/getImgBase64.md)
 - [getIn](./functions/getIn.md)
 - [getLocationHrefParam](./functions/getLocationHrefParam.md)
@@ -149,6 +159,7 @@
 - [objectFromPairs](./functions/objectFromPairs.md)
 - [objectToPairs](./functions/objectToPairs.md)
 - [only](./functions/only.md)
+- [parseIdCard](./functions/parseIdCard.md)
 - [photoCompress](./functions/photoCompress.md)
 - [preZeroFill](./functions/preZeroFill.md)
 - [prettyBytes](./functions/prettyBytes.md)
@@ -169,3 +180,4 @@
 - [transferHumpUnderline](./functions/transferHumpUnderline.md)
 - [trim](./functions/trim.md)
 - [urlJoin](./functions/urlJoin.md)
+- [validateIdCard](./functions/validateIdCard.md)

generateExports.cjs

@@ -27,7 +27,7 @@ function generateExportStatements(files) {
   return files
     .map(file => {
       const fileName = path.basename(file, '.ts');
-      if (fileName === 'is' || fileName === 'cookie'|| fileName === 'math') {
+      if (fileName === 'is' || fileName === 'cookie'|| fileName === 'math'|| fileName === 'idCard') {
         return `export * from './${fileName}';`;
       }
       return `export { ${fileName} } from './${fileName}';`;

package.json

@@ -67,11 +67,12 @@
     "pre-commit": "npm run type-check && npm test"
   },
   "dependencies": {
-    "decimal.js": "^10.4.1"
+    "decimal.js": "^10.4.1",
+    "idcard": "4.2.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.13.1",
-    "@rspress/plugin-typedoc": "^1.43.9",
+    "@rspress/plugin-typedoc": "^1.45.6",
     "@types/glob": "^9.0.0",
     "@vitest/coverage-v8": "^3.0.0",
     "bumpp": "^10.2.0",
@@ -81,10 +82,11 @@
     "inquirer": "^12.7.0",
     "prettier": "^3.5.2",
     "publint": "^0.3.12",
-    "rspress": "^1.44.0",
+    "rspress": "^1.45.6",
     "rspress-plugin-sitemap": "^1.2.0",
     "simple-git-hooks": "^2.9.0",
-    "typescript": "5.9.2",
+    "typedoc": "0.28.13",
+    "typescript": "5.1.3",
     "vitest": "^3.0.0"
   },
   "repository": {