@wener/common 1.0.2 → 1.0.4

package/lib/search/types.d.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/search/types.d.ts"],"sourcesContent":["export type Exprs = Expr[];\nexport type Expr =\n  | CommentExpr\n  | ParenthesesExpr\n  | KeywordCondition\n  | LogicalCondition\n  | NotCondition\n  | CompareCondition;\n\nexport type CommentExpr = {\n  type: 'comment';\n  value: string;\n};\n\nexport type ParenthesesExpr = {\n  type: 'parentheses';\n  value: Expr[];\n};\n\nexport type KeywordCondition = {\n  type: 'keyword';\n  value: string;\n  negative?: boolean;\n  exact?: boolean;\n};\n\nexport type LogicalCondition = {\n  type: 'logical';\n  operator: 'and' | 'or';\n  value: Expr[];\n};\n\nexport type NotCondition = {\n  type: 'not';\n  value: Expr;\n};\n\nexport type CompareCondition = {\n  type: 'compare';\n  field: string;\n  /**\n   * mention value for eq, ne only\n   * range require range value\n   */\n  operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'range' | 'has';\n  negative?: boolean;\n  mention?: boolean;\n  value: Value;\n};\n\nexport type Value = LiteralValue | RangeValue | MentionValue;\n\nexport type LiteralValue = {\n  type?: 'literal';\n  format?: 'date' | 'date-time';\n  value: string | number | null;\n};\n\nexport type MentionValue = {\n  type?: 'literal';\n  format: 'mention';\n  value: string;\n};\n\nexport type RangeValue = {\n  type: 'range';\n  minimum: LiteralValue | undefined;\n  maximum: LiteralValue | undefined;\n  minimumExclusive: boolean;\n  maximumExclusive: boolean;\n};\n"],"names":[],"mappings":"AAgEA,WAME"}
+{"version":3,"sources":["../../src/search/types.d.ts"],"sourcesContent":["export type Exprs = Expr[];\nexport type Expr =\n\t| CommentExpr\n\t| ParenthesesExpr\n\t| KeywordCondition\n\t| LogicalCondition\n\t| NotCondition\n\t| CompareCondition;\n\nexport type CommentExpr = { type: 'comment'; value: string };\n\nexport type ParenthesesExpr = { type: 'parentheses'; value: Expr[] };\n\nexport type KeywordCondition = { type: 'keyword'; value: string; negative?: boolean; exact?: boolean };\n\nexport type LogicalCondition = { type: 'logical'; operator: 'and' | 'or'; value: Expr[] };\n\nexport type NotCondition = { type: 'not'; value: Expr };\n\nexport type CompareCondition = {\n\ttype: 'compare';\n\tfield: string;\n\t/**\n\t * mention value for eq, ne only\n\t * range require range value\n\t */\n\toperator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'range' | 'match';\n\tnegative?: boolean;\n\tmention?: boolean;\n\tvalue: Value;\n};\n\nexport type Value = LiteralValue | RangeValue | MentionValue;\n\nexport type LiteralValue = { type?: 'literal'; format?: 'date' | 'date-time'; value: string | number | null };\n\nexport type MentionValue = { type?: 'literal'; format: 'mention'; value: string };\n\nexport type RangeValue = {\n\ttype: 'range';\n\tminimum: LiteralValue | undefined;\n\tmaximum: LiteralValue | undefined;\n\tminimumExclusive: boolean;\n\tmaximumExclusive: boolean;\n};\n"],"names":[],"mappings":"AAsCA,WAME"}

package/lib/tools/renderJsonSchemaToMarkdownDoc.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tools/renderJsonSchemaToMarkdownDoc.ts"],"sourcesContent":["import type { TObject, TSchema } from '@sinclair/typebox';\n\nexport function renderJsonSchemaToMarkdownDoc(rootSchema: any) {\n  // markdown\n  const out: string[] = [];\n  const all = new Set();\n  const pending: TSchema[] = [];\n\n  const addObject = (o: TSchema) => {\n    if (all.has(o.$id)) {\n      return;\n    }\n    all.add(o.$id);\n    pending.push(o);\n  };\n\n  const writeObjectProps = (T: TObject, { prefix = '' }: { prefix?: string } = {}) => {\n    if (!T?.properties) {\n      return;\n    }\n    for (const [name, schema] of Object.entries(T.properties)) {\n      let typ = schema.$id || schema.type;\n\n      if (typ === 'array') {\n        typ = `${schema.items.$id || schema.items.type}[]`;\n        if (schema.items.$id) {\n          addObject(schema.items);\n        }\n      } else if (schema.$id) {\n        addObject(schema);\n      }\n      if (!typ) {\n        if ('anyOf' in schema) {\n          typ = 'enum';\n        }\n      }\n\n      out.push(`| ${prefix}${name} | ${typ} | ${schema.title || schema.description || ''} |`);\n\n      if (typ === 'object') {\n        writeObjectProps(schema as TObject, { prefix: `${prefix}${name}.` });\n      } else if (schema.type === 'array') {\n        if (schema.items.type === 'object' && !schema.items.$id) {\n          writeObjectProps(schema.items as TObject, { prefix: `${prefix}${name}[].` });\n        }\n      }\n    }\n  };\n  const writeObject = (T: TObject) => {\n    out.push(`### ${T.title || T.$id}`);\n    out.push(`\n| $id | 名字 |\n| --- | --- |\n| ${T.$id || ''} | ${T.title || ''} | \n    `);\n    if (T.description) {\n      out.push('');\n      out.push(`> ${T.description}`);\n      out.push('');\n    }\n\n    out.push(`| 名字 | 类型 | 说明 |`);\n    out.push(`| --- | --- | --- |`);\n\n    writeObjectProps(T);\n\n    out.push('');\n  };\n\n  writeObject(rootSchema);\n\n  for (const schema of pending) {\n    if (schema.type === 'object') {\n      writeObject(schema as TObject);\n    } else if ('anyOf' in schema) {\n      out.push(`### ${schema.$id || schema.title}`);\n      out.push(`\n| $id | 名字 |\n| --- | --- |\n| ${schema.$id || ''} | ${schema.title || ''} | \n    `);\n\n      out.push(`| 值 |  说明 |`);\n      out.push(`| --- | --- |`);\n      for (const item of schema.anyOf) {\n        out.push(`| ${item.const} | ${item.title || item.description || ''} |`);\n      }\n      out.push('');\n    }\n  }\n\n  return out.join('\\n');\n}\n"],"names":["renderJsonSchemaToMarkdownDoc","rootSchema","out","all","Set","pending","addObject","o","has","$id","add","push","writeObjectProps","T","prefix","properties","name","schema","Object","entries","typ","type","items","title","description","writeObject","item","anyOf","const","join"],"mappings":"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"}
+{"version":3,"sources":["../../src/tools/renderJsonSchemaToMarkdownDoc.ts"],"sourcesContent":["import type { TObject, TSchema } from '@sinclair/typebox';\n\nexport function renderJsonSchemaToMarkdownDoc(rootSchema: any) {\n\t// markdown\n\tconst out: string[] = [];\n\tconst all = new Set();\n\tconst pending: TSchema[] = [];\n\n\tconst addObject = (o: TSchema) => {\n\t\tif (all.has(o.$id)) {\n\t\t\treturn;\n\t\t}\n\t\tall.add(o.$id);\n\t\tpending.push(o);\n\t};\n\n\tconst writeObjectProps = (T: TObject, { prefix = '' }: { prefix?: string } = {}) => {\n\t\tif (!T?.properties) {\n\t\t\treturn;\n\t\t}\n\t\tfor (const [name, schema] of Object.entries(T.properties)) {\n\t\t\tlet typ = schema.$id || schema.type;\n\n\t\t\tif (typ === 'array') {\n\t\t\t\ttyp = `${schema.items.$id || schema.items.type}[]`;\n\t\t\t\tif (schema.items.$id) {\n\t\t\t\t\taddObject(schema.items);\n\t\t\t\t}\n\t\t\t} else if (schema.$id) {\n\t\t\t\taddObject(schema);\n\t\t\t}\n\t\t\tif (!typ) {\n\t\t\t\tif ('anyOf' in schema) {\n\t\t\t\t\ttyp = 'enum';\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tout.push(`| ${prefix}${name} | ${typ} | ${schema.title || schema.description || ''} |`);\n\n\t\t\tif (typ === 'object') {\n\t\t\t\twriteObjectProps(schema as TObject, { prefix: `${prefix}${name}.` });\n\t\t\t} else if (schema.type === 'array') {\n\t\t\t\tif (schema.items.type === 'object' && !schema.items.$id) {\n\t\t\t\t\twriteObjectProps(schema.items as TObject, { prefix: `${prefix}${name}[].` });\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t};\n\tconst writeObject = (T: TObject) => {\n\t\tout.push(`### ${T.title || T.$id}`);\n\t\tout.push(`\n| $id | 名字 |\n| --- | --- |\n| ${T.$id || ''} | ${T.title || ''} | \n    `);\n\t\tif (T.description) {\n\t\t\tout.push('');\n\t\t\tout.push(`> ${T.description}`);\n\t\t\tout.push('');\n\t\t}\n\n\t\tout.push(`| 名字 | 类型 | 说明 |`);\n\t\tout.push(`| --- | --- | --- |`);\n\n\t\twriteObjectProps(T);\n\n\t\tout.push('');\n\t};\n\n\twriteObject(rootSchema);\n\n\tfor (const schema of pending) {\n\t\tif (schema.type === 'object') {\n\t\t\twriteObject(schema as TObject);\n\t\t} else if ('anyOf' in schema) {\n\t\t\tout.push(`### ${schema.$id || schema.title}`);\n\t\t\tout.push(`\n| $id | 名字 |\n| --- | --- |\n| ${schema.$id || ''} | ${schema.title || ''} | \n    `);\n\n\t\t\tout.push(`| 值 |  说明 |`);\n\t\t\tout.push(`| --- | --- |`);\n\t\t\tfor (const item of schema.anyOf) {\n\t\t\t\tout.push(`| ${item.const} | ${item.title || item.description || ''} |`);\n\t\t\t}\n\t\t\tout.push('');\n\t\t}\n\t}\n\n\treturn out.join('\\n');\n}\n"],"names":["renderJsonSchemaToMarkdownDoc","rootSchema","out","all","Set","pending","addObject","o","has","$id","add","push","writeObjectProps","T","prefix","properties","name","schema","Object","entries","typ","type","items","title","description","writeObject","item","anyOf","const","join"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wener/common",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "description": "",
   "author": "",
@@ -10,6 +10,14 @@
       "types": "./src/index.ts",
       "default": "./lib/index.js"
     },
+    "./cn": {
+      "types": "./src/cn/index.ts",
+      "default": "./lib/cn/index.js"
+    },
+    "./data": {
+      "types": "./src/data/index.ts",
+      "default": "./lib/data/index.js"
+    },
     "./jsonschema": {
       "types": "./src/jsonschema/index.ts",
       "default": "./lib/jsonschema/index.js"
@@ -36,12 +44,13 @@
   ],
   "keywords": [],
   "dependencies": {
-    "es-toolkit": "^1.27.0",
-    "ts-pattern": "^5.5.0",
+    "es-toolkit": "^1.32.0",
+    "ts-pattern": "^5.6.2",
+    "zod": "^3.24.2",
     "@wener/utils": "1.1.51"
   },
   "devDependencies": {
-    "@sinclair/typebox": "^0.34.9",
+    "@sinclair/typebox": "^0.34.28",
     "@types/argon2-browser": "^1.18.4",
     "@types/bcrypt": "^5.0.2",
     "@types/bcryptjs": "^2.4.6",
@@ -52,7 +61,7 @@
     "argon2": "^0.41.1",
     "argon2-browser": "^1.18.0",
     "bcrypt": "^5.1.1",
-    "bcryptjs": "^2.4.3"
+    "bcryptjs": "^3.0.2"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/src/cn/DivisionCode.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from 'vitest';
+import { DivisionCode } from './DivisionCode';
+
+describe('DivisionCode', () => {
+	it('should parse', () => {
+		for (const [a, b] of [
+			[
+				'441900003001',
+				{
+					province: '44',
+					city: '19',
+					county: '00',
+					town: '003',
+					village: '001',
+					codes: ['44', '19', '00', '003', '001'],
+				},
+			],
+			[
+				441900003001,
+				{
+					province: '44',
+					city: '19',
+					county: '00',
+					town: '003',
+					village: '001',
+					codes: ['44', '19', '00', '003', '001'],
+				},
+			],
+			[441900, { province: '44', city: '19', county: '00' }],
+			['31', { province: '31' }],
+			['4', undefined],
+			['', undefined],
+			[null, undefined],
+			[undefined, undefined],
+		] as Array<[string, any]>) {
+			let out = DivisionCode.parse(a);
+			expect(out).toMatchObject(b);
+			if (out) {
+				expect(DivisionCode.format(out)).toBe(String(a));
+			}
+		}
+	});
+});

package/src/cn/DivisionCode.ts

@@ -0,0 +1,209 @@
+const DivisionCodeLevels: Array<{ level: number; code: string; length: number; size: number; label: string }> = [
+	{ level: 1, code: 'Province', length: 2, size: 2, label: '省' },
+	{ level: 2, code: 'City', length: 4, size: 2, label: '市' },
+	{ level: 3, code: 'County', length: 6, size: 2, label: '区县' },
+	{ level: 4, code: 'Town', length: 9, size: 3, label: '乡镇' },
+	{ level: 5, code: 'Village', length: 12, size: 3, label: '村' },
+] as const;
+
+// String(Number.MAX_SAFE_INTEGER).length=16
+// 12 is safe int
+
+/**
+ * Codes for the administrative divisions of the People's Republic of China
+ *
+ * @see https://zh.wikipedia.org/wiki/GB/T_2260 中华人民共和国行政区划代码
+ */
+export namespace DivisionCode {
+	enum DivisionCodeLevel {
+		Province = 1,
+		City = 2,
+		County = 3,
+		Town = 4,
+		Village = 5,
+	}
+
+	export const levels = DivisionCodeLevels;
+
+	export const regex = /^(?<province>\d{2})(?<city>\d{2})?(?<county>\d{2})?(?<town>\d{3})?(?<village>\d{3})?$/;
+
+	const root: CodeValue[] = [
+		{ value: '11', label: '北京市' },
+		{ value: '12', label: '天津市' },
+		{ value: '13', label: '河北省' },
+		{ value: '14', label: '山西省' },
+		{ value: '15', label: '内蒙古自治区' },
+		{ value: '21', label: '辽宁省' },
+		{ value: '22', label: '吉林省' },
+		{ value: '23', label: '黑龙江省' },
+		{ value: '31', label: '上海市' },
+		{ value: '32', label: '江苏省' },
+		{ value: '33', label: '浙江省' },
+		{ value: '34', label: '安徽省' },
+		{ value: '35', label: '福建省' },
+		{ value: '36', label: '江西省' },
+		{ value: '37', label: '山东省' },
+		{ value: '41', label: '河南省' },
+		{ value: '42', label: '湖北省' },
+		{ value: '43', label: '湖南省' },
+		{ value: '44', label: '广东省' },
+		{ value: '45', label: '广西壮族自治区' },
+		{ value: '46', label: '海南省' },
+		{ value: '50', label: '重庆市' },
+		{ value: '51', label: '四川省' },
+		{ value: '52', label: '贵州省' },
+		{ value: '53', label: '云南省' },
+		{ value: '54', label: '西藏自治区' },
+		{ value: '61', label: '陕西省' },
+		{ value: '62', label: '甘肃省' },
+		{ value: '63', label: '青海省' },
+		{ value: '64', label: '宁夏回族自治区' },
+		{ value: '65', label: '新疆维吾尔自治区' },
+		{ value: '71', label: '台湾省' },
+		{ value: '81', label: '香港特别行政区' },
+		{ value: '82', label: '澳门特别行政区' },
+		// 9 国外
+	];
+
+	export type ParsedCode = {
+		province: string;
+		city?: string;
+		county?: string;
+		town?: string;
+		village?: string;
+		codes: string[];
+		level: DivisionCodeLevel;
+		labels: string[];
+	};
+
+	export function parse(code: string | undefined | null | number): ParsedCode | undefined {
+		if (!code) return;
+		code = String(code);
+		const match = regex.exec(code);
+		if (!match) return;
+		const { province, city, county, town, village } = match.groups ?? {};
+		if (!province) return;
+
+		let codes = [province, city, county, town, village].filter(Boolean);
+		return { province, city, county, town, village, codes: codes, level: codes.length as DivisionCodeLevel };
+	}
+
+	export function format({
+		province,
+		city,
+		county,
+		town,
+		village,
+	}: {
+		province: string | number;
+		city?: string | number;
+		county?: string | number;
+		town?: string | number;
+		village?: string | number;
+	}): string {
+		const codes: string[] = [];
+		for (let i = 0; i < [province, city, county, town, village].length; i++) {
+			let x = [province, city, county, town, village][i];
+			if (x === undefined || x === null || x === '') {
+				break;
+			}
+			let len = levels[i].size;
+			codes.push(String(x).padStart(len, '0').slice(0, len));
+		}
+		return codes.join('');
+	}
+
+	// export function random(level: DivisionCodeLevel = 'County'): string {
+	//   const l = DivisionCodeLevels.find((v) => v.code === level) || DivisionCodeLevels[2];
+	//   const l1 = randomPick(provinces);
+	//   if (l.level === 1) {
+	//     return String(l1[0]);
+	//   }
+	//   return l1 + String(Math.floor(Math.random() * parseFloat(`1e${l.length - 2}`) - 1));
+	// }
+}
+
+interface DivisionTreeNode {
+	sub: string; // sub code
+	children?: Record<string, DivisionTreeNode>;
+
+	code: string; // full code
+	name?: string; // name of division
+}
+
+// export type DivisionCodeLevel = 'Village' | 'Town' | 'County' | 'City' | 'Province';
+
+// export interface ParsedDivisionCode {
+//   level: DivisionCodeLevel;
+//   code: string;
+//   name?: string;
+//   fullName?: string;
+//   names: string[];
+//   // 村级（村委会、居委会）
+//   // 12 位
+//   village?: CodeName;
+//   // 乡级（乡镇、街道）
+//   // 9 位
+//   town?: CodeName;
+//   // 县级（区县）
+//   // 6 位 - 常用 - 2985 个
+//   county?: CodeName;
+//   // 地级（城市）
+//   // 4 位 - 343 个
+//   city?: CodeName;
+//   // 省级（省份、直辖市、自治区）
+//   // 2 位 - 32 个
+//   province: CodeName;
+//
+//   children?: Array<{ code: string; name?: string }>;
+// }
+
+// export interface CodeName {
+//   code: string;
+//   name: string;
+// }
+
+// export function getSimpleProvinceLabel(value: string) {
+//   if (!value) {
+//     return;
+//   }
+//   let label = value;
+//   if (/[0-9]/.test(label)) {
+//     label = label.slice(0, 2);
+//     label = options.find((v) => v.value === label)?.label || label;
+//   }
+//   return label.replace(/省|市|(回族|维吾尔|壮族)?自治区|特别行政区$/, '');
+// }
+
+export function randomPick<T>(s: T[]) {
+	return s[Math.floor(Math.random() * s.length)];
+}
+
+function lookup(opts: { values: string[]; root: CodeValue[] }): { found: CodeValue[] } {
+	const { values, root } = opts;
+	const found: CodeValue[] = [];
+	let currentLevel = root;
+
+	for (const v of values) {
+		const node = currentLevel.find((n) => n.value === v);
+		if (!node) {
+			break;
+		}
+
+		found.push(node);
+
+		if (node.children) {
+			currentLevel = node.children;
+		} else {
+			break;
+		}
+	}
+
+	return { found };
+}
+
+interface CodeValue {
+	value: string;
+	label: string;
+	children?: Array<CodeValue>;
+}

package/src/cn/Mod11Checksum.ts

@@ -0,0 +1,24 @@
+/**
+ * ISO 7064:1983, MOD 11-2.
+ */
+export class Mod11Checksum {
+	weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2, 1];
+
+	validate(s: string) {
+		return s.at(-1) === this.compute(s.slice(0, s.length - 1));
+	}
+
+	compute(s: string) {
+		const { weights } = this;
+		let sum = 0;
+		for (let i = 0; i < s.length; i++) {
+			sum += parseInt(s[i]) * weights[i];
+		}
+		const num = (12 - (sum % 11)) % 11;
+		if (num < 10) {
+			return num.toString();
+		} else {
+			return 'X';
+		}
+	}
+}

package/src/cn/Mod31Checksum.ts

@@ -0,0 +1,36 @@
+/**
+ * GB/T 17710（采ISO 7064）的模31校验码
+ *
+ * Mod31-3
+ */
+export class Mod31Checksum {
+	weights = [1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10, 30, 28];
+	chars = '0123456789ABCDEFGHJKLMNPQRTUWXY';
+	numbers: Record<string, number> = this.chars.split('').reduce(
+		(acc, cur, i) => {
+			acc[cur] = i;
+			return acc;
+		},
+		{} as Record<string, number>,
+	);
+
+	toChar(n: number) {
+		return this.chars[n];
+	}
+
+	toNumber(c: string) {
+		return this.numbers[c];
+	}
+
+	validate(s: string) {
+		return s.at(-1) === this.compute(s.slice(0, s.length - 1));
+	}
+
+	compute(s: string) {
+		let sum = 0;
+		for (let i = 0; i < s.length; i++) {
+			sum += this.numbers[s[i]] * this.weights[i];
+		}
+		return this.toChar(31 - (sum % 31));
+	}
+}

package/src/cn/ResidentIdentityCardNumber.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+import { ResidentIdentityCardNumber } from './ResidentIdentityCardNumber';
+
+describe('ResidentIdentityCardNumber', () => {
+	it('should parse', () => {
+		for (const a of ['11010519491231002X']) {
+			let out = ResidentIdentityCardNumber.parse(a);
+			expect(ResidentIdentityCardNumber.format(out)).toBe(a);
+			expect(out).toMatchSnapshot();
+		}
+	});
+	it('should format with partial', () => {
+		expect(
+			ResidentIdentityCardNumber.format({ division: '110105', birthDate: new Date('1949-12-31'), sequence: 2 }),
+		).toBe('11010519491231002X');
+	});
+});

package/src/cn/ResidentIdentityCardNumber.ts

@@ -0,0 +1,96 @@
+import { formatDate } from './formatDate';
+import { Mod11Checksum } from './Mod11Checksum';
+
+export namespace ResidentIdentityCardNumber {
+	export const Checksum = new Mod11Checksum();
+
+	/*
+  export const length = 18;
+  export const pattern = /^\d{6}(18|19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[0-9Xx]$/;
+   */
+
+	export function parse(s: string): ParsedResidentIdentityCardNumber {
+		const division = s.slice(0, 6);
+		const birthDate = s.slice(6, 14);
+		const sequence = parseInt(s.slice(14, 17), 10);
+		const checksum = s.slice(17, 18);
+		const valid = Checksum.validate(s);
+		const sex = sequence % 2 === 1 ? 'Male' : 'Female';
+		return {
+			division,
+			birthDate,
+			sequence,
+			checksum,
+			valid,
+			sex,
+			male: sex === 'Male',
+			female: sex === 'Female',
+			age: new Date().getFullYear() - parseInt(birthDate.slice(0, 4), 10),
+		};
+	}
+
+	export function format({
+		division,
+		birthDate,
+		sequence,
+		checksum,
+	}: {
+		division: string;
+		birthDate: string | Date;
+		sequence: number | string;
+		checksum?: string;
+	}) {
+		if (typeof birthDate !== 'string') {
+			birthDate = formatDate(birthDate, 'yyyyMMDD');
+		}
+		if (birthDate.includes('-')) {
+			birthDate = birthDate.replace(/-/g, '');
+		}
+		typeof sequence === 'number' && (sequence = sequence.toString());
+		sequence = sequence.padStart(3, '0');
+		const base = [division, birthDate, sequence].join('');
+		if (base.length !== 17) throw new Error('Invalid params');
+		checksum ||= Checksum.compute(base);
+		return base + checksum;
+	}
+}
+export interface ParsedResidentIdentityCardNumber {
+	/**
+	 * @title 行政区划代码
+	 */
+	division: string;
+	/**
+	 * @title 出生日期
+	 * 格式 yyyyMMDD
+	 */
+	birthDate: string;
+	/**
+	 * @title 顺序码
+	 */
+	sequence: number;
+	/**
+	 * @title 校验位
+	 */
+	checksum: string;
+
+	/**
+	 * @title 是否有效
+	 */
+	valid: boolean;
+	/**
+	 * @title 是否男性
+	 */
+	male: boolean;
+	/**
+	 * @title 是否女性
+	 */
+	female: boolean;
+	/**
+	 * @title 性别
+	 */
+	sex: 'Male' | 'Female';
+	/**
+	 * @title 年龄
+	 */
+	age: number;
+}

package/src/cn/UnifiedSocialCreditCode.test.ts

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest';
+import { UnifiedSocialCreditCode } from './UnifiedSocialCreditCode';
+
+describe('UnifiedSocialCreditCode', () => {
+	it('should parse', () => {
+		for (const a of [
+			//
+			'91330106673959654P',
+			'91330106MA2CFLDG4R',
+		]) {
+			let out = UnifiedSocialCreditCode.parse(a);
+			expect(UnifiedSocialCreditCode.format(out)).toBe(a);
+			expect(out).toMatchSnapshot();
+		}
+	});
+});

package/src/cn/UnifiedSocialCreditCode.ts

@@ -0,0 +1,143 @@
+import { Mod31Checksum } from './Mod31Checksum';
+
+/**
+ * 统一社会信用代码
+ *
+ * - GB 11714-1997 全国组织机构代码编制规则
+ */
+export namespace UnifiedSocialCreditCode {
+	interface CodeValue {
+		label: string;
+		children?: Record<string, CodeValue>;
+	}
+
+	const CodeLabels: Record<string, CodeValue> = {
+		1: {
+			label: '机构编制',
+			children: {
+				1: { label: '机关' },
+				2: { label: '事业单位' },
+				3: { label: '中央编办直接管理机构编制的群众团体' },
+				9: { label: '其他' },
+			},
+		},
+		5: {
+			label: '民政',
+			children: {
+				1: { label: '社会团体' },
+				2: { label: '民办非企业单位' },
+				3: { label: '基金会' },
+				9: { label: '其他' },
+			},
+		},
+		9: {
+			label: '工商',
+			children: {
+				1: { label: '企业' },
+				2: { label: '个体工商户' },
+				3: { label: '农民专业合作社' },
+				9: { label: '其他' },
+			},
+		},
+		Y: { label: '其他', children: { 1: { label: '其他' } } },
+	};
+
+	export const pattern = /^([159][1239]|Y1)[0-9]{6}[0-9A-HJ-NP-RTUWXY]{10}$/; // 无 I O Z S V
+
+	export const Checksum = new Mod31Checksum();
+
+	export function parse(s: string): ParsedUnifiedSocialCreditCode {
+		let bureau = s[0];
+		let subjectType = s[1];
+		let division = s.slice(2, 8); // 第3~8位，共6位，正确
+		let subject = s.slice(8, 17); // 第9~17位，共9位
+		let checksum = s.slice(17, 18); // 第18位，校验码
+
+		const labels: string[] = [];
+		let l1 = CodeLabels[bureau];
+		l1 && labels.push(l1?.label);
+		let l2 = l1?.children?.[subjectType];
+		l2 && labels.push(l2?.label);
+
+		return {
+			bureau,
+			subjectType,
+			division,
+			subject,
+			checksum,
+			codes: [bureau, subjectType, division, subject],
+			labels,
+		};
+	}
+
+	export function format({
+		bureau,
+		subjectType,
+		division,
+		subject,
+		checksum,
+	}: {
+		bureau: string;
+		subjectType: string;
+		division: string;
+		subject: string;
+		checksum?: string;
+	}): string {
+		const base = `${bureau}${subjectType}${division}${subject}`;
+		checksum ||= Checksum.compute(base);
+		return `${base}${checksum}`;
+	}
+
+	export function next(s: string, delta: number = 1) {
+		const sp = s.split('').map((v) => Checksum.numbers[v]);
+		for (let i = sp.length - 1; i >= 0; i--) {
+			if ((delta > 0 && sp[i] < 30) || (delta < 0 && sp[i] > 0)) {
+				sp[i] += delta;
+				break;
+			} else if (delta > 0 && sp[i] === 30) {
+				sp[i] = 0;
+			} else if (delta < 0 && sp[i] === 0) {
+				sp[i] = 30;
+			}
+		}
+		return sp.map((v) => Checksum.chars[v]).join('');
+	}
+}
+
+/**
+ * 解析后的统一社会信用代码信息
+ */
+interface ParsedUnifiedSocialCreditCode {
+	/**
+	 * @title 登记管理部门代码
+	 * 对应统一社会信用代码的第1位字符，用于标识发证机构类别（登记管理部门）。
+	 */
+	bureau: string;
+
+	/**
+	 * @title 机构类别代码
+	 * 对应统一社会信用代码的第2位字符，用于标识被赋码主体的类型（如企业、事业单位、社会组织等）。
+	 */
+	subjectType: string;
+
+	/**
+	 * @title 登记管理机关行政区划代码
+	 * 对应统一社会信用代码的第3至第8位字符，用于标识该主体登记机关所在的行政区划。
+	 */
+	division: string;
+
+	/**
+	 * @title 主体标识码
+	 * 对应统一社会信用代码的第9至第17位字符，用于标识特定的市场主体或法人单位。
+	 */
+	subject: string;
+
+	/**
+	 * @title 校验码
+	 * 对应统一社会信用代码的最后一位字符，用特定算法计算，用于校验代码有效性。
+	 */
+	checksum: string;
+
+	codes: string[];
+	labels: string[];
+}