@stll/stdnum 0.0.1

package/dist/tr/tckimlik.js

@@ -0,0 +1,79 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits, randomInt } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/tr/tckimlik.ts
+/**
+* T.C. Kimlik No.
+* (Türkiye Cumhuriyeti Kimlik Numarası,
+* Turkish personal identification number).
+*
+* 11-digit unique personal ID assigned to every
+* Turkish citizen by MERNİS (Merkezi Nüfus İdaresi
+* Sistemi). The first digit is never zero. The last
+* two digits are check digits.
+*
+* Check digit algorithm:
+*   Let A = sum of digits at odd positions (1,3,5,7,9)
+*   Let B = sum of digits at even positions (2,4,6,8)
+*   d10 = (7 * A - B) mod 10
+*   d11 = (d1 + d2 + ... + d10) mod 10
+*
+* @see https://tckimlik.nvi.gov.tr/
+* @see https://en.wikipedia.org/wiki/Turkish_Identification_Number
+* @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama
+*/
+const compact = (value) => clean(value, " -./");
+/**
+* Calculate the two check digits from the first
+* nine digits of a T.C. Kimlik number.
+*/
+const calcCheckDigits = (number) => {
+	let oddSum = 0;
+	let evenSum = 0;
+	for (let i = 0; i < 9; i++) {
+		const d = Number(number[i]);
+		if (i % 2 === 0) oddSum += d;
+		else evenSum += d;
+	}
+	const d10 = ((7 * oddSum - evenSum) % 10 + 10) % 10;
+	return `${d10}${(oddSum + evenSum + d10) % 10}`;
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 11) return err("INVALID_LENGTH", "T.C. Kimlik number must be 11 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "T.C. Kimlik number must contain only digits");
+	if (v[0] === "0") return err("INVALID_COMPONENT", "T.C. Kimlik number cannot start with 0");
+	if (calcCheckDigits(v) !== v.slice(9)) return err("INVALID_CHECKSUM", "T.C. Kimlik number check digit mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+/** TR IDs are displayed without separators. */
+const format = (value) => compact(value);
+/** Generate a random valid Turkish T.C. Kimlik No. */
+const generate = () => {
+	const payload = String(randomInt(1, 9)) + randomDigits(8);
+	return payload + calcCheckDigits(payload);
+};
+/** Turkish Personal Identification Number. */
+const tckimlik = {
+	name: "Turkish Personal ID",
+	localName: "T.C. Kimlik Numarası",
+	abbreviation: "T.C. Kimlik",
+	aliases: ["TC Kimlik No", "T.C. Kimlik Numarası"],
+	candidatePattern: "[1-9]\\d{10}",
+	country: "TR",
+	entityType: "person",
+	sourceUrl: "https://www.nvi.gov.tr/",
+	examples: ["17291716060"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, tckimlik as default, format, generate, validate };
+
+//# sourceMappingURL=tckimlik.js.map

package/dist/tr/tckimlik.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tckimlik.js","names":[],"sources":["../../src/tr/tckimlik.ts"],"sourcesContent":["/**\n * T.C. Kimlik No.\n * (Türkiye Cumhuriyeti Kimlik Numarası,\n * Turkish personal identification number).\n *\n * 11-digit unique personal ID assigned to every\n * Turkish citizen by MERNİS (Merkezi Nüfus İdaresi\n * Sistemi). The first digit is never zero. The last\n * two digits are check digits.\n *\n * Check digit algorithm:\n *   Let A = sum of digits at odd positions (1,3,5,7,9)\n *   Let B = sum of digits at even positions (2,4,6,8)\n *   d10 = (7 * A - B) mod 10\n *   d11 = (d1 + d2 + ... + d10) mod 10\n *\n * @see https://tckimlik.nvi.gov.tr/\n * @see https://en.wikipedia.org/wiki/Turkish_Identification_Number\n * @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\");\n\n/**\n * Calculate the two check digits from the first\n * nine digits of a T.C. Kimlik number.\n */\nconst calcCheckDigits = (number: string): string => {\n  let oddSum = 0;\n  let evenSum = 0;\n  for (let i = 0; i < 9; i++) {\n    const d = Number(number[i]);\n    if (i % 2 === 0) {\n      oddSum += d;\n    } else {\n      evenSum += d;\n    }\n  }\n  const d10 = (((7 * oddSum - evenSum) % 10) + 10) % 10;\n  const d11 = (oddSum + evenSum + d10) % 10;\n  return `${d10}${d11}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"T.C. Kimlik number must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"T.C. Kimlik number must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"T.C. Kimlik number cannot start with 0\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"T.C. Kimlik number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish T.C. Kimlik No. */\nconst generate = (): string => {\n  const payload = String(randomInt(1, 9)) + randomDigits(8);\n  return payload + calcCheckDigits(payload);\n};\n\n/** Turkish Personal Identification Number. */\nconst tckimlik: Validator = {\n  name: \"Turkish Personal ID\",\n  localName: \"T.C. Kimlik Numarası\",\n  abbreviation: \"T.C. Kimlik\",\n  aliases: [\n    \"TC Kimlik No\",\n    \"T.C. Kimlik Numarası\",\n  ] as const,\n  candidatePattern: \"[1-9]\\\\d{10}\",\n  country: \"TR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.nvi.gov.tr/\",\n  examples: [\"17291716060\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tckimlik;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;;;;;AAMtB,MAAM,mBAAmB,WAA2B;CAClD,IAAI,SAAS;CACb,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,GAAG;AAC3B,MAAI,IAAI,MAAM,EACZ,WAAU;MAEV,YAAW;;CAGf,MAAM,QAAS,IAAI,SAAS,WAAW,KAAM,MAAM;AAEnD,QAAO,GAAG,OADG,SAAS,UAAU,OAAO;;AAIzC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,yCACD;AAEH,KAAI,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CACnC,QAAO,IACL,oBACA,0CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,OAAO,UAAU,GAAG,EAAE,CAAC,GAAG,aAAa,EAAE;AACzD,QAAO,UAAU,gBAAgB,QAAQ;;;AAI3C,MAAM,WAAsB;CAC1B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,gBACA,uBACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}

package/dist/tr/vkn.d.ts

@@ -0,0 +1,15 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/tr/vkn.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+/** TR IDs are displayed without separators. */
+declare const format: (value: string) => string;
+/** Generate a random valid Turkish VKN. */
+declare const generate: () => string;
+/** Turkish Tax Identification Number. */
+declare const vkn: Validator;
+//#endregion
+export { compact, vkn as default, format, generate, validate };
+//# sourceMappingURL=vkn.d.ts.map

package/dist/tr/vkn.js

@@ -0,0 +1,79 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/tr/vkn.ts
+/**
+* VKN (Vergi Kimlik Numarası, Turkish tax
+* identification number).
+*
+* 10-digit tax ID used for businesses in Turkey.
+* The last digit is a check digit.
+*
+* Check digit algorithm:
+*   For each of the first 9 digits (right to left,
+*   position i = 1..9):
+*     c1 = (digit + i) mod 10
+*     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if
+*          that result is 0
+*     sum += c2
+*   check = (10 - sum) mod 10
+*
+* @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama
+* @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn
+* @see https://www.gib.gov.tr/
+*/
+const compact = (value) => clean(value, " -./");
+/**
+* Calculate the check digit for the first 9 digits
+* of a VKN.
+*/
+const calcCheckDigit = (number) => {
+	let s = 0;
+	for (let i = 0; i < 9; i++) {
+		const pos = 9 - i;
+		const c1 = (Number(number[i]) + pos) % 10;
+		if (c1 !== 0) {
+			const c2 = c1 * 2 ** pos % 9 || 9;
+			s += c2;
+		}
+	}
+	return String((10 - s % 10) % 10);
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 10) return err("INVALID_LENGTH", "VKN must be 10 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "VKN must contain only digits");
+	if (calcCheckDigit(v) !== v[9]) return err("INVALID_CHECKSUM", "VKN check digit mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+/** TR IDs are displayed without separators. */
+const format = (value) => compact(value);
+/** Generate a random valid Turkish VKN. */
+const generate = () => {
+	const payload = randomDigits(9);
+	return payload + calcCheckDigit(payload);
+};
+/** Turkish Tax Identification Number. */
+const vkn = {
+	name: "Turkish Tax ID",
+	localName: "Vergi Kimlik Numarası",
+	abbreviation: "VKN",
+	aliases: ["VKN", "Vergi Kimlik Numarası"],
+	candidatePattern: "\\d{10}",
+	country: "TR",
+	entityType: "company",
+	sourceUrl: "https://www.gib.gov.tr/",
+	examples: ["4540536920"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, vkn as default, format, generate, validate };
+
+//# sourceMappingURL=vkn.js.map

package/dist/tr/vkn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vkn.js","names":[],"sources":["../../src/tr/vkn.ts"],"sourcesContent":["/**\n * VKN (Vergi Kimlik Numarası, Turkish tax\n * identification number).\n *\n * 10-digit tax ID used for businesses in Turkey.\n * The last digit is a check digit.\n *\n * Check digit algorithm:\n *   For each of the first 9 digits (right to left,\n *   position i = 1..9):\n *     c1 = (digit + i) mod 10\n *     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if\n *          that result is 0\n *     sum += c2\n *   check = (10 - sum) mod 10\n *\n * @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama\n * @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn\n * @see https://www.gib.gov.tr/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -./\");\n\n/**\n * Calculate the check digit for the first 9 digits\n * of a VKN.\n */\nconst calcCheckDigit = (number: string): string => {\n  let s = 0;\n  for (let i = 0; i < 9; i++) {\n    const pos = 9 - i; // position 1..9 from right\n    const c1 = (Number(number[i]) + pos) % 10;\n    if (c1 !== 0) {\n      const pow = 2 ** pos;\n      const c2 = (c1 * pow) % 9 || 9;\n      s += c2;\n    }\n  }\n  return String((10 - (s % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\"INVALID_LENGTH\", \"VKN must be 10 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"VKN must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"VKN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish VKN. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Turkish Tax Identification Number. */\nconst vkn: Validator = {\n  name: \"Turkish Tax ID\",\n  localName: \"Vergi Kimlik Numarası\",\n  abbreviation: \"VKN\",\n  aliases: [\"VKN\", \"Vergi Kimlik Numarası\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"TR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gib.gov.tr/\",\n  examples: [\"4540536920\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vkn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;;;;;AAMtB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,IAAI;AACR,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,MAAM,IAAI;EAChB,MAAM,MAAM,OAAO,OAAO,GAAG,GAAG,OAAO;AACvC,MAAI,OAAO,GAAG;GAEZ,MAAM,KAAM,KADA,KAAK,MACO,KAAK;AAC7B,QAAK;;;AAGT,QAAO,QAAQ,KAAM,IAAI,MAAO,GAAG;;AAGrC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,wBAAwB;AAEvD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,eAAe,EAAE,KAAK,EAAE,GAC1B,QAAO,IACL,oBACA,2BACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;AAC/B,QAAO,UAAU,eAAe,QAAQ;;;AAI1C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,wBAAwB;CACzC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}

package/dist/tw/mod.d.ts

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import ubn from "./ubn.js";
+
+//#region src/tw/mod.d.ts
+
+//#endregion
+export { mod_d_exports, ubn };
+//# sourceMappingURL=mod.d.ts.map

package/dist/tw/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import ubn from "./ubn.js";
+//#region src/tw/mod.ts
+var tw_exports = /* @__PURE__ */ __exportAll({ ubn: () => ubn });
+//#endregion
+export { tw_exports, ubn };
+
+//# sourceMappingURL=mod.js.map

package/dist/tw/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/tw/mod.ts"],"sourcesContent":["export { default as ubn } from \"./ubn\";\n"],"mappings":""}

package/dist/tw/ubn.d.ts

@@ -0,0 +1,14 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/tw/ubn.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Generate a random valid UBN. */
+declare const generate: () => string;
+/** Taiwanese Unified Business Number. */
+declare const ubn: Validator;
+//#endregion
+export { compact, ubn as default, format, generate, validate };
+//# sourceMappingURL=ubn.d.ts.map

package/dist/tw/ubn.js

@@ -0,0 +1,86 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/tw/ubn.ts
+/**
+* UBN (Unified Business Number, 統一編號).
+*
+* Taiwanese company identifier. 8 digits with a
+* weighted checksum. Weights [1,2,1,2,1,2,4,1];
+* sum the individual digits of each product, total
+* mod 10 must be 0. Special case: when the 7th digit
+* is 7, checksum 9 is also accepted.
+*
+* @see https://zh.wikipedia.org/wiki/統一編號
+*/
+const WEIGHTS = [
+	1,
+	2,
+	1,
+	2,
+	1,
+	2,
+	4,
+	1
+];
+/** Sum the individual digits of a number. */
+const digitSum = (n) => {
+	let sum = 0;
+	while (n > 0) {
+		sum += n % 10;
+		n = Math.floor(n / 10);
+	}
+	return sum;
+};
+const compact = (value) => clean(value, " -");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 8) return err("INVALID_LENGTH", "UBN must be exactly 8 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "UBN must contain only digits");
+	let sum = 0;
+	for (let i = 0; i < 8; i++) sum += digitSum(Number(v[i]) * WEIGHTS[i]);
+	const checksum = sum % 10;
+	if (checksum === 0) return {
+		valid: true,
+		compact: v
+	};
+	if (checksum === 9 && v[6] === "7") return {
+		valid: true,
+		compact: v
+	};
+	return err("INVALID_CHECKSUM", "UBN checksum does not match");
+};
+const format = (value) => compact(value);
+/** Generate a random valid UBN. */
+const generate = () => {
+	for (;;) {
+		const prefix = randomDigits(7);
+		for (let d = 0; d < 10; d++) {
+			const candidate = `${prefix}${d}`;
+			if (validate(candidate).valid) return candidate;
+		}
+	}
+};
+/** Taiwanese Unified Business Number. */
+const ubn = {
+	name: "Unified Business Number",
+	localName: "統一編號",
+	abbreviation: "UBN",
+	aliases: ["統一編號", "UBN"],
+	candidatePattern: "\\d{8}",
+	country: "TW",
+	entityType: "company",
+	description: "8-digit company identifier issued by the Ministry of Economic Affairs",
+	sourceUrl: "https://zh.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E7%B7%A8%E8%99%9F",
+	lengths: [8],
+	examples: ["00501503", "04595257"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, ubn as default, format, generate, validate };
+
+//# sourceMappingURL=ubn.js.map

package/dist/tw/ubn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ubn.js","names":[],"sources":["../../src/tw/ubn.ts"],"sourcesContent":["/**\n * UBN (Unified Business Number, 統一編號).\n *\n * Taiwanese company identifier. 8 digits with a\n * weighted checksum. Weights [1,2,1,2,1,2,4,1];\n * sum the individual digits of each product, total\n * mod 10 must be 0. Special case: when the 7th digit\n * is 7, checksum 9 is also accepted.\n *\n * @see https://zh.wikipedia.org/wiki/統一編號\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [1, 2, 1, 2, 1, 2, 4, 1] as const;\n\n/** Sum the individual digits of a number. */\nconst digitSum = (n: number): number => {\n  let sum = 0;\n  while (n > 0) {\n    sum += n % 10;\n    n = Math.floor(n / 10);\n  }\n  return sum;\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"UBN must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UBN must contain only digits\",\n    );\n  }\n\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += digitSum(Number(v[i]) * WEIGHTS[i]!);\n  }\n\n  const checksum = sum % 10;\n  if (checksum === 0) {\n    return { valid: true, compact: v };\n  }\n\n  // Special case: when the 7th digit is 7 (product\n  // 4*7=28), the checksum may be 9 instead of 0.\n  if (checksum === 9 && v[6] === \"7\") {\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_CHECKSUM\",\n    \"UBN checksum does not match\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid UBN. */\nconst generate = (): string => {\n  for (;;) {\n    const prefix = randomDigits(7);\n    for (let d = 0; d < 10; d++) {\n      const candidate = `${prefix}${d}`;\n      const r = validate(candidate);\n      if (r.valid) return candidate;\n    }\n  }\n};\n\n/** Taiwanese Unified Business Number. */\nconst ubn: Validator = {\n  name: \"Unified Business Number\",\n  localName: \"統一編號\",\n  abbreviation: \"UBN\",\n  aliases: [\"統一編號\", \"UBN\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"TW\",\n  entityType: \"company\",\n  description:\n    \"8-digit company identifier issued by the Ministry of Economic Affairs\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E7%B7%A8%E8%99%9F\",\n  lengths: [8] as const,\n  examples: [\"00501503\", \"04595257\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ubn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;AAGxC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;AACV,QAAO,IAAI,GAAG;AACZ,SAAO,IAAI;AACX,MAAI,KAAK,MAAM,IAAI,GAAG;;AAExB,QAAO;;AAGT,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAGH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,SAAS,OAAO,EAAE,GAAG,GAAG,QAAQ,GAAI;CAG7C,MAAM,WAAW,MAAM;AACvB,KAAI,aAAa,EACf,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAKpC,KAAI,aAAa,KAAK,EAAE,OAAO,IAC7B,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAGpC,QAAO,IACL,oBACA,8BACD;;AAGH,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,SAAS,aAAa,EAAE;AAC9B,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,YAAY,GAAG,SAAS;AAE9B,OADU,SAAS,UAAU,CACvB,MAAO,QAAO;;;;;AAM1B,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,MAAM;CACxB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,YAAY,WAAW;CAClC;CACA;CACA;CACA;CACD"}

package/dist/types.d.ts

@@ -0,0 +1,95 @@
+//#region src/types.d.ts
+/**
+ * ISO 3166-1 alpha-2 country codes for countries
+ * with at least one validator in this package.
+ */
+type CountryCode = "AD" | "AE" | "AI" | "AL" | "AM" | "AR" | "AT" | "AU" | "AZ" | "BA" | "BD" | "BE" | "BG" | "BH" | "BR" | "BY" | "BZ" | "CA" | "CH" | "CL" | "CN" | "CO" | "CR" | "CU" | "CY" | "CZ" | "DE" | "DK" | "DO" | "EC" | "EE" | "EG" | "ES" | "FI" | "FR" | "GB" | "GE" | "GH" | "GR" | "GT" | "HK" | "HR" | "HU" | "ID" | "IE" | "IL" | "IN" | "IQ" | "IR" | "IS" | "IT" | "JP" | "KR" | "KW" | "KZ" | "LI" | "LK" | "LT" | "LU" | "LV" | "MA" | "MC" | "MD" | "ME" | "MK" | "MT" | "MU" | "MX" | "MY" | "NG" | "NI" | "NL" | "NO" | "NZ" | "PA" | "PE" | "PH" | "PK" | "PL" | "PT" | "RO" | "RS" | "RU" | "SE" | "SG" | "SI" | "SK" | "TH" | "TR" | "TW" | "UA" | "US" | "UY" | "VE" | "VN" | "ZA";
+type ErrorCode = "INVALID_FORMAT" | "INVALID_LENGTH" | "INVALID_CHECKSUM" | "INVALID_COMPONENT";
+type StdnumError = {
+  code: ErrorCode;
+  message: string;
+};
+type ValidateResult = {
+  valid: true;
+  compact: string;
+} | {
+  valid: false;
+  error: StdnumError;
+};
+/**
+ * Structured data extracted from a personal ID number.
+ * Returned by `parse()` on validators that encode
+ * birth date and gender.
+ */
+type ParsedPersonId = {
+  birthDate: Date;
+  gender: "male" | "female";
+};
+type Validator = {
+  /** English name. */
+  name: string;
+  /** Name in the local language. */
+  localName: string;
+  /** Common abbreviation (e.g. "IČO"). */
+  abbreviation: string;
+  /** Country this identifier belongs to. */
+  country?: CountryCode;
+  /** What kind of entity this identifies. */
+  entityType: "person" | "company" | "any";
+  /**
+   * Strip separators and normalize to a
+   * canonical compact form.
+   */
+  compact: (value: string) => string;
+  /**
+   * Format the identifier for display
+   * (e.g. add separators, group digits).
+   */
+  format: (value: string) => string;
+  /**
+   * Validate the identifier. Returns the
+   * compact form on success, or an error
+   * with a code and message on failure.
+   */
+  validate: (value: string) => ValidateResult;
+  /** One-liner describing the identifier. */
+  description?: string;
+  /** URL to official authority or spec page. */
+  sourceUrl?: string;
+  /** Valid lengths of the compact form. */
+  lengths?: readonly number[];
+  /**
+   * Known-valid compact values. Useful as test
+   * seeds, form placeholders, API schema examples,
+   * and documentation. Sourced from official
+   * government specs where available.
+   */
+  examples?: readonly string[];
+  /**
+   * Generate a random valid identifier in compact
+   * form. Available on validators with checksum
+   * algorithms. Useful for testing, demos, and
+   * form placeholders. NOT cryptographically secure.
+   */
+  generate?: () => string;
+  /**
+   * All known names, abbreviations, and common
+   * references for this identifier. Superset of
+   * name/localName/abbreviation. Useful for
+   * searching documents, building autocomplete,
+   * or contextual detection.
+   */
+  aliases?: readonly string[];
+  /**
+   * Regex pattern string to find candidates of
+   * this identifier in free text. Should be loose
+   * enough to catch formatted variants (dots,
+   * spaces, hyphens) but specific enough to avoid
+   * excessive noise. Matched candidates should be
+   * passed to validate() for confirmation.
+   */
+  candidatePattern?: string;
+};
+//#endregion
+export { CountryCode, ErrorCode, ParsedPersonId, StdnumError, ValidateResult, Validator };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ua/edrpou.d.ts

@@ -0,0 +1,14 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/ua/edrpou.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Generate a random valid Ukrainian EDRPOU. */
+declare const generate: () => string;
+/** Ukrainian Company Register Number. */
+declare const edrpou: Validator;
+//#endregion
+export { compact, edrpou as default, format, generate, validate };
+//# sourceMappingURL=edrpou.d.ts.map

package/dist/ua/edrpou.js

@@ -0,0 +1,103 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/ua/edrpou.ts
+/**
+* EDRPOU (ЄДРПОУ, Unified State Register of
+* Enterprises and Organizations of Ukraine).
+*
+* 8-digit company identification number with a
+* weighted checksum. Two sets of weights are used
+* depending on whether the first digit is 0-2/6-9 or 3-5.
+*
+* @see https://en.wikipedia.org/wiki/EDRPOU
+* @see https://usr.minjust.gov.ua/
+*/
+const WEIGHTS_A = [
+	1,
+	2,
+	3,
+	4,
+	5,
+	6,
+	7
+];
+const WEIGHTS_B = [
+	7,
+	1,
+	2,
+	3,
+	4,
+	5,
+	6
+];
+const WEIGHTS_A2 = [
+	3,
+	4,
+	5,
+	6,
+	7,
+	8,
+	9
+];
+const WEIGHTS_B2 = [
+	9,
+	3,
+	4,
+	5,
+	6,
+	7,
+	8
+];
+const calcCheck = (value, weights) => {
+	let sum = 0;
+	for (let i = 0; i < 7; i++) sum += Number(value[i]) * weights[i];
+	return sum % 11;
+};
+const compact = (value) => clean(value, " -");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 8) return err("INVALID_LENGTH", "EDRPOU must be exactly 8 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "EDRPOU must contain only digits");
+	const firstDigit = Number(v[0]);
+	const useA = firstDigit < 3 || firstDigit >= 6;
+	const weightsFirst = useA ? WEIGHTS_A : WEIGHTS_B;
+	const weightsSecond = useA ? WEIGHTS_A2 : WEIGHTS_B2;
+	let check = calcCheck(v, weightsFirst);
+	if (check >= 10) check = calcCheck(v, weightsSecond) % 10;
+	if (check !== Number(v[7])) return err("INVALID_CHECKSUM", "EDRPOU check digit mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => compact(value);
+/** Generate a random valid Ukrainian EDRPOU. */
+const generate = () => {
+	for (;;) {
+		const c = randomDigits(8);
+		if (validate(c).valid) return c;
+	}
+};
+/** Ukrainian Company Register Number. */
+const edrpou = {
+	name: "Ukrainian Company Register Number",
+	localName: "ЄДРПОУ",
+	abbreviation: "ЄДРПОУ",
+	aliases: ["ЄДРПОУ", "EDRPOU"],
+	candidatePattern: "\\d{8}",
+	country: "UA",
+	entityType: "company",
+	lengths: [8],
+	sourceUrl: "https://usr.minjust.gov.ua/",
+	examples: ["14360570"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, edrpou as default, format, generate, validate };
+
+//# sourceMappingURL=edrpou.js.map

package/dist/ua/edrpou.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edrpou.js","names":[],"sources":["../../src/ua/edrpou.ts"],"sourcesContent":["/**\n * EDRPOU (ЄДРПОУ, Unified State Register of\n * Enterprises and Organizations of Ukraine).\n *\n * 8-digit company identification number with a\n * weighted checksum. Two sets of weights are used\n * depending on whether the first digit is 0-2/6-9 or 3-5.\n *\n * @see https://en.wikipedia.org/wiki/EDRPOU\n * @see https://usr.minjust.gov.ua/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS_A = [1, 2, 3, 4, 5, 6, 7] as const;\nconst WEIGHTS_B = [7, 1, 2, 3, 4, 5, 6] as const;\nconst WEIGHTS_A2 = [3, 4, 5, 6, 7, 8, 9] as const;\nconst WEIGHTS_B2 = [9, 3, 4, 5, 6, 7, 8] as const;\n\nconst calcCheck = (\n  value: string,\n  weights: readonly number[],\n): number => {\n  let sum = 0;\n  for (let i = 0; i < 7; i++) {\n    sum += Number(value[i]) * weights[i]!;\n  }\n  return sum % 11;\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"EDRPOU must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EDRPOU must contain only digits\",\n    );\n  }\n\n  const firstDigit = Number(v[0]);\n  const useA = firstDigit < 3 || firstDigit >= 6;\n  const weightsFirst = useA ? WEIGHTS_A : WEIGHTS_B;\n  const weightsSecond = useA ? WEIGHTS_A2 : WEIGHTS_B2;\n\n  let check = calcCheck(v, weightsFirst);\n  if (check >= 10) {\n    check = calcCheck(v, weightsSecond) % 10;\n  }\n\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"EDRPOU check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Ukrainian EDRPOU. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ukrainian Company Register Number. */\nconst edrpou: Validator = {\n  name: \"Ukrainian Company Register Number\",\n  localName: \"ЄДРПОУ\",\n  abbreviation: \"ЄДРПОУ\",\n  aliases: [\"ЄДРПОУ\", \"EDRPOU\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"UA\",\n  entityType: \"company\",\n  lengths: [8] as const,\n  sourceUrl: \"https://usr.minjust.gov.ua/\",\n  examples: [\"14360570\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default edrpou;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACvC,MAAM,YAAY;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACvC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AACxC,MAAM,aAAa;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAExC,MAAM,aACJ,OACA,YACW;CACX,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,OAAO,MAAM,GAAG,GAAG,QAAQ;AAEpC,QAAO,MAAM;;AAGf,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;CAGH,MAAM,aAAa,OAAO,EAAE,GAAG;CAC/B,MAAM,OAAO,aAAa,KAAK,cAAc;CAC7C,MAAM,eAAe,OAAO,YAAY;CACxC,MAAM,gBAAgB,OAAO,aAAa;CAE1C,IAAI,QAAQ,UAAU,GAAG,aAAa;AACtC,KAAI,SAAS,GACX,SAAQ,UAAU,GAAG,cAAc,GAAG;AAGxC,KAAI,UAAU,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,8BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,SAAoB;CACxB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,UAAU,SAAS;CAC7B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}

package/dist/ua/mod.d.ts

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import edrpou from "./edrpou.js";
+
+//#region src/ua/mod.d.ts
+
+//#endregion
+export { edrpou, mod_d_exports };
+//# sourceMappingURL=mod.d.ts.map

package/dist/ua/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import edrpou from "./edrpou.js";
+//#region src/ua/mod.ts
+var ua_exports = /* @__PURE__ */ __exportAll({ edrpou: () => edrpou });
+//#endregion
+export { edrpou, ua_exports };
+
+//# sourceMappingURL=mod.js.map

package/dist/ua/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/ua/mod.ts"],"sourcesContent":["export { default as edrpou } from \"./edrpou\";\n"],"mappings":""}

package/dist/us/ein.d.ts

@@ -0,0 +1,13 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/us/ein.d.ts
+/** Generate a random valid U.S. EIN. */
+declare const generate: () => string;
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** U.S. Employer Identification Number. */
+declare const ein: Validator;
+//#endregion
+export { compact, ein as default, format, generate, validate };
+//# sourceMappingURL=ein.d.ts.map