@stll/stdnum 0.0.1 → 1.0.0

package/dist/kr/rrn.js

@@ -1,4 +1,5 @@
 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";
 import { isValidDate } from "../_util/date.js";
@@ -106,6 +107,14 @@ const parse = (value) => {
 		gender: isMale ? "male" : "female"
 	};
 };
+/** Generate a random valid Korean RRN. */
+const generate = () => {
+	const year = randomInt(1900, 2024);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	const body = `${String(year % 100).padStart(2, "0")}${month}${day}${year >= 2e3 ? String(randomInt(3, 4)) : String(randomInt(1, 2))}${String(randomInt(0, 96)).padStart(2, "0")}${randomDigits(3)}`;
+	return `${body}${String(checkDigit(body))}`;
+};
 /** Korean Resident Registration Number. */
 const rrn = {
 	name: "Korean Resident Registration Number",
@@ -125,9 +134,11 @@ const rrn = {
 	examples: ["9710139019902", "9501011000109"],
 	compact,
 	format,
-	validate
+	parse,
+	validate,
+	generate
 };
 //#endregion
-export { compact, rrn as default, format, parse, validate };
+export { compact, rrn as default, format, generate, parse, validate };
 
 //# sourceMappingURL=rrn.js.map

package/dist/kr/rrn.js.map

@@ -1 +1 @@
-{"version":3,"file":"rrn.js","names":[],"sources":["../../src/kr/rrn.ts"],"sourcesContent":["/**\n * RRN (Resident Registration Number, 주민등록번호).\n *\n * Korean Resident Registration Number. 13 digits\n * formatted as YYMMDD-GPPCCSD. Encodes date of\n * birth, gender/century, place of birth, community\n * center, serial, and a check digit.\n *\n * @see https://en.wikipedia.org/wiki/Resident_registration_number\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -/\");\n\nconst CHECK_WEIGHTS = [2, 3, 4, 5, 6, 7, 8, 9, 2, 3, 4, 5];\n\n/**\n * Compute the check digit for the first 12 digits.\n * Formula: (11 - sum(w_i * d_i) % 11) % 10.\n */\nconst checkDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum +=\n      (CHECK_WEIGHTS[i] ?? 0) * Number(digits.charAt(i));\n  }\n  return (11 - (sum % 11)) % 10;\n};\n\n/** Century prefix derived from the 7th digit. */\nconst CENTURY_BY_GENDER: Record<string, number> = {\n  \"0\": 1800,\n  \"1\": 1900,\n  \"2\": 1900,\n  \"3\": 2000,\n  \"4\": 2000,\n  \"5\": 1900,\n  \"6\": 1900,\n  \"7\": 2000,\n  \"8\": 2000,\n  \"9\": 1800,\n};\n\n/**\n * Resolve birth date components from a compacted RRN.\n * Returns null if the date is invalid.\n */\nconst resolveBirthDate = (\n  v: string,\n): { year: number; month: number; day: number } | null => {\n  const century = CENTURY_BY_GENDER[v.charAt(6)];\n  if (century === undefined) return null;\n\n  const year = century + Number(v.slice(0, 2));\n  const month = Number(v.slice(2, 4));\n  const day = Number(v.slice(4, 6));\n\n  if (!isValidDate(year, month, day)) return null;\n  return { year, month, day };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RRN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RRN must contain only digits\",\n    );\n  }\n  if (resolveBirthDate(v) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN contains an invalid date of birth\",\n    );\n  }\n  const place = Number(v.slice(7, 9));\n  if (place > 96) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN place-of-birth code must be <= 96\",\n    );\n  }\n  if (checkDigit(v.slice(0, 12)) !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RRN check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 13) {\n    return `${v.slice(0, 6)}-${v.slice(6)}`;\n  }\n  return v;\n};\n\n/**\n * Extract birth date and gender from an RRN.\n * Returns null if the value is not valid.\n *\n * Gender digit mapping:\n *   1, 3 = male Korean; 2, 4 = female Korean\n *   5, 7 = male foreigner; 6, 8 = female foreigner\n *   0, 9 = pre-1800 (male/female by convention)\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const bd = resolveBirthDate(v);\n  if (bd === null) return null;\n\n  const genderDigit = v.charAt(6);\n  const isMale = \"13579\".includes(genderDigit);\n\n  return {\n    birthDate: new Date(bd.year, bd.month - 1, bd.day),\n    gender: isMale ? \"male\" : \"female\",\n  };\n};\n\n/** Korean Resident Registration Number. */\nconst rrn: Validator = {\n  name: \"Korean Resident Registration Number\",\n  localName: \"주민등록번호\",\n  abbreviation: \"RRN\",\n  aliases: [\n    \"RRN\",\n    \"주민등록번호\",\n    \"Resident Registration Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[\\\\s-]?\\\\d{7}\",\n  country: \"KR\",\n  entityType: \"person\",\n  description:\n    \"13-digit personal identifier issued to all\" +\n    \" residents of South Korea\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"Resident_registration_number\",\n  lengths: [13] as const,\n  examples: [\"9710139019902\", \"9501011000109\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default rrn;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,gBAAgB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;;;;AAM1D,MAAM,cAAc,WAA2B;CAC7C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SACG,cAAc,MAAM,KAAK,OAAO,OAAO,OAAO,EAAE,CAAC;AAEtD,SAAQ,KAAM,MAAM,MAAO;;;AAI7B,MAAM,oBAA4C;CAChD,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACN;;;;;AAMD,MAAM,oBACJ,MACwD;CACxD,MAAM,UAAU,kBAAkB,EAAE,OAAO,EAAE;AAC7C,KAAI,YAAY,KAAA,EAAW,QAAO;CAElC,MAAM,OAAO,UAAU,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAC5C,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CACnC,MAAM,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAEjC,KAAI,CAAC,YAAY,MAAM,OAAO,IAAI,CAAE,QAAO;AAC3C,QAAO;EAAE;EAAM;EAAO;EAAK;;AAG7B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,iBAAiB,EAAE,KAAK,KAC1B,QAAO,IACL,qBACA,wCACD;AAGH,KADc,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,GACvB,GACV,QAAO,IACL,qBACA,wCACD;AAEH,KAAI,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,KAAK,OAAO,EAAE,IAAI,CAC9C,QAAO,IACL,oBACA,iCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAEvC,QAAO;;;;;;;;;;;AAYT,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,iBAAiB,EAAE;AAC9B,KAAI,OAAO,KAAM,QAAO;CAExB,MAAM,cAAc,EAAE,OAAO,EAAE;CAC/B,MAAM,SAAS,QAAQ,SAAS,YAAY;AAE5C,QAAO;EACL,WAAW,IAAI,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,GAAG,IAAI;EAClD,QAAQ,SAAS,SAAS;EAC3B;;;AAIH,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CAEF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,iBAAiB,gBAAgB;CAC5C;CACA;CACA;CACD"}
+{"version":3,"file":"rrn.js","names":[],"sources":["../../src/kr/rrn.ts"],"sourcesContent":["/**\n * RRN (Resident Registration Number, 주민등록번호).\n *\n * Korean Resident Registration Number. 13 digits\n * formatted as YYMMDD-GPPCCSD. Encodes date of\n * birth, gender/century, place of birth, community\n * center, serial, and a check digit.\n *\n * @see https://en.wikipedia.org/wiki/Resident_registration_number\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -/\");\n\nconst CHECK_WEIGHTS = [2, 3, 4, 5, 6, 7, 8, 9, 2, 3, 4, 5];\n\n/**\n * Compute the check digit for the first 12 digits.\n * Formula: (11 - sum(w_i * d_i) % 11) % 10.\n */\nconst checkDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum +=\n      (CHECK_WEIGHTS[i] ?? 0) * Number(digits.charAt(i));\n  }\n  return (11 - (sum % 11)) % 10;\n};\n\n/** Century prefix derived from the 7th digit. */\nconst CENTURY_BY_GENDER: Record<string, number> = {\n  \"0\": 1800,\n  \"1\": 1900,\n  \"2\": 1900,\n  \"3\": 2000,\n  \"4\": 2000,\n  \"5\": 1900,\n  \"6\": 1900,\n  \"7\": 2000,\n  \"8\": 2000,\n  \"9\": 1800,\n};\n\n/**\n * Resolve birth date components from a compacted RRN.\n * Returns null if the date is invalid.\n */\nconst resolveBirthDate = (\n  v: string,\n): { year: number; month: number; day: number } | null => {\n  const century = CENTURY_BY_GENDER[v.charAt(6)];\n  if (century === undefined) return null;\n\n  const year = century + Number(v.slice(0, 2));\n  const month = Number(v.slice(2, 4));\n  const day = Number(v.slice(4, 6));\n\n  if (!isValidDate(year, month, day)) return null;\n  return { year, month, day };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RRN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RRN must contain only digits\",\n    );\n  }\n  if (resolveBirthDate(v) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN contains an invalid date of birth\",\n    );\n  }\n  const place = Number(v.slice(7, 9));\n  if (place > 96) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN place-of-birth code must be <= 96\",\n    );\n  }\n  if (checkDigit(v.slice(0, 12)) !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RRN check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 13) {\n    return `${v.slice(0, 6)}-${v.slice(6)}`;\n  }\n  return v;\n};\n\n/**\n * Extract birth date and gender from an RRN.\n * Returns null if the value is not valid.\n *\n * Gender digit mapping:\n *   1, 3 = male Korean; 2, 4 = female Korean\n *   5, 7 = male foreigner; 6, 8 = female foreigner\n *   0, 9 = pre-1800 (male/female by convention)\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const bd = resolveBirthDate(v);\n  if (bd === null) return null;\n\n  const genderDigit = v.charAt(6);\n  const isMale = \"13579\".includes(genderDigit);\n\n  return {\n    birthDate: new Date(bd.year, bd.month - 1, bd.day),\n    gender: isMale ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Korean RRN. */\nconst generate = (): string => {\n  const year = randomInt(1900, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const genderDigit =\n    year >= 2000\n      ? String(randomInt(3, 4))\n      : String(randomInt(1, 2));\n  const place = String(randomInt(0, 96)).padStart(2, \"0\");\n  const body = `${yy}${month}${day}${genderDigit}${place}${randomDigits(3)}`;\n  return `${body}${String(checkDigit(body))}`;\n};\n\n/** Korean Resident Registration Number. */\nconst rrn: Validator<ParsedPersonId> = {\n  name: \"Korean Resident Registration Number\",\n  localName: \"주민등록번호\",\n  abbreviation: \"RRN\",\n  aliases: [\n    \"RRN\",\n    \"주민등록번호\",\n    \"Resident Registration Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[\\\\s-]?\\\\d{7}\",\n  country: \"KR\",\n  entityType: \"person\",\n  description:\n    \"13-digit personal identifier issued to all\" +\n    \" residents of South Korea\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"Resident_registration_number\",\n  lengths: [13] as const,\n  examples: [\"9710139019902\", \"9501011000109\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default rrn;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/kw/civil.d.ts

@@ -1,7 +1,6 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { ParsedBirthDate, ValidateResult, Validator } from "../types.js";
 
 //#region src/kw/civil.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -10,9 +9,11 @@ declare const format: (value: string) => string;
  * Gender is not encoded in the number.
  * Returns null if the value is not valid.
  */
-declare const parse: (value: string) => Omit<ParsedPersonId, "gender"> | null;
+declare const parse: (value: string) => ParsedBirthDate | null;
+/** Generate a random valid Kuwait civil number. */
+declare const generate: () => string;
 /** Kuwait Civil Number (الرقم المدني). */
-declare const civil: Validator;
+declare const civil: Validator<ParsedBirthDate>;
 //#endregion
-export { compact, civil as default, format, parse, validate };
+export { compact, civil as default, format, generate, parse, validate };
 //# sourceMappingURL=civil.d.ts.map

package/dist/kw/civil.js

@@ -1,4 +1,5 @@
 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";
 import { isValidDate } from "../_util/date.js";
@@ -36,7 +37,7 @@ const centuryMap = {
 const compact = (value) => clean(value, " -");
 const calcCheckDigit = (digits) => {
 	let sum = 0;
-	for (let i = 0; i < 11; i++) sum += Number(digits[i]) * WEIGHTS[i];
+	for (const [i, weight] of WEIGHTS.entries()) sum += Number(digits[i]) * weight;
 	return (11 - sum % 11) % 11;
 };
 const validate = (value) => {
@@ -76,6 +77,18 @@ const parse = (value) => {
 	const year = yearBase + yy;
 	return { birthDate: new Date(year, mm - 1, dd) };
 };
+/** Generate a random valid Kuwait civil number. */
+const generate = () => {
+	for (;;) {
+		const year = randomInt(1950, 2024);
+		const month = String(randomInt(1, 12)).padStart(2, "0");
+		const day = String(randomInt(1, 28)).padStart(2, "0");
+		const body = `${year >= 2e3 ? "3" : "2"}${String(year % 100).padStart(2, "0")}${month}${day}${randomDigits(4)}`;
+		const check = calcCheckDigit(body);
+		if (check > 9) continue;
+		return `${body}${String(check)}`;
+	}
+};
 /** Kuwait Civil Number (الرقم المدني). */
 const civil = {
 	name: "Civil Number",
@@ -91,9 +104,11 @@ const civil = {
 	sourceUrl: "https://kuwaitsexpat.com/kuwait-civil-id-format/",
 	compact,
 	format,
-	validate
+	parse,
+	validate,
+	generate
 };
 //#endregion
-export { compact, civil as default, format, parse, validate };
+export { compact, civil as default, format, generate, parse, validate };
 
 //# sourceMappingURL=civil.js.map

package/dist/kw/civil.js.map

@@ -1 +1 @@
-{"version":3,"file":"civil.js","names":[],"sources":["../../src/kw/civil.ts"],"sourcesContent":["/**\n * Civil Number (الرقم المدني, Kuwait).\n *\n * 12-digit number issued by PACI (Public Authority\n * for Civil Information):\n *   C       = century indicator (2 = 1900s, 3 = 2000s)\n *   YYMMDD  = birth date\n *   SSSS    = serial number\n *   K       = check digit (mod 11 weighted sum)\n *\n * @see https://prakhar.me/articles/kuwait-civil-id-checksum/\n * @see https://kuwaitsexpat.com/kuwait-civil-id-format/\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst WEIGHTS = [2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2] as const;\n\nconst centuryMap: Record<number, number> = {\n  2: 1900,\n  3: 2000,\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst calcCheckDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 11; i++) {\n    // SAFETY: loop bound guarantees valid index\n    sum += Number(digits[i]) * WEIGHTS[i]!;\n  }\n  return (11 - (sum % 11)) % 11;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Kuwait civil number must be 12 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Kuwait civil number must contain only digits\",\n    );\n  }\n\n  const centuryDigit = Number(v[0]);\n  if (centuryDigit !== 2 && centuryDigit !== 3) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Century digit must be 2 or 3\",\n    );\n  }\n\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = yearBase + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Civil number contains an invalid birth date\",\n    );\n  }\n\n  const expected = calcCheckDigit(v.slice(0, 11));\n  if (expected !== Number(v[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Civil number check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 1)} ${v.slice(1, 7)} ${v.slice(7, 11)} ${v.slice(11)}`;\n};\n\n/**\n * Extract birth date from a Kuwait civil number.\n * Gender is not encoded in the number.\n * Returns null if the value is not valid.\n */\nconst parse = (\n  value: string,\n): Omit<ParsedPersonId, \"gender\"> | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const centuryDigit = Number(v[0]);\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = yearBase + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n  };\n};\n\n/** Kuwait Civil Number (الرقم المدني). */\nconst civil: Validator = {\n  name: \"Civil Number\",\n  localName: \"الرقم المدني\",\n  abbreviation: \"Civil ID\",\n  aliases: [\"Civil ID\", \"الرقم المدني\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"KW\",\n  entityType: \"person\",\n  lengths: [12] as const,\n  examples: [\"289011200032\", \"305031512348\"] as const,\n  description:\n    \"12-digit civil identification number issued by PACI\",\n  sourceUrl:\n    \"https://kuwaitsexpat.com/kuwait-civil-id-format/\",\n  compact,\n  format,\n  validate,\n};\n\nexport default civil;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAE;AAElD,MAAM,aAAqC;CACzC,GAAG;CACH,GAAG;CACJ;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IAEtB,QAAO,OAAO,OAAO,GAAG,GAAG,QAAQ;AAErC,SAAQ,KAAM,MAAM,MAAO;;AAG7B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,wCACD;AAGH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+CACD;CAGH,MAAM,eAAe,OAAO,EAAE,GAAG;AACjC,KAAI,iBAAiB,KAAK,iBAAiB,EACzC,QAAO,IACL,qBACA,+BACD;CAGH,MAAM,WAAW,WAAW,iBAAiB;CAC7C,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAGhC,KAAI,CAAC,YAFQ,WAAW,IAED,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,8CACD;AAIH,KADiB,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC,KAC9B,OAAO,EAAE,IAAI,CAC5B,QAAO,IACL,oBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;;;;;AAQ3E,MAAM,SACJ,UAC0C;CAC1C,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CAEjB,MAAM,WAAW,WADI,OAAO,EAAE,GAAG,KACY;CAC7C,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,OAAO,WAAW;AAExB,QAAO,EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG,EACtC;;;AAIH,MAAM,QAAmB;CACvB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,YAAY,eAAe;CACrC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C,aACE;CACF,WACE;CACF;CACA;CACA;CACD"}
+{"version":3,"file":"civil.js","names":[],"sources":["../../src/kw/civil.ts"],"sourcesContent":["/**\n * Civil Number (الرقم المدني, Kuwait).\n *\n * 12-digit number issued by PACI (Public Authority\n * for Civil Information):\n *   C       = century indicator (2 = 1900s, 3 = 2000s)\n *   YYMMDD  = birth date\n *   SSSS    = serial number\n *   K       = check digit (mod 11 weighted sum)\n *\n * @see https://prakhar.me/articles/kuwait-civil-id-checksum/\n * @see https://kuwaitsexpat.com/kuwait-civil-id-format/\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedBirthDate,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst WEIGHTS = [2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2] as const;\n\nconst centuryMap: Record<number, number> = {\n  2: 1900,\n  3: 2000,\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst calcCheckDigit = (digits: string): number => {\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(digits[i]) * weight;\n  }\n  return (11 - (sum % 11)) % 11;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Kuwait civil number must be 12 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Kuwait civil number must contain only digits\",\n    );\n  }\n\n  const centuryDigit = Number(v[0]);\n  if (centuryDigit !== 2 && centuryDigit !== 3) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Century digit must be 2 or 3\",\n    );\n  }\n\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = yearBase + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Civil number contains an invalid birth date\",\n    );\n  }\n\n  const expected = calcCheckDigit(v.slice(0, 11));\n  if (expected !== Number(v[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Civil number check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 1)} ${v.slice(1, 7)} ${v.slice(7, 11)} ${v.slice(11)}`;\n};\n\n/**\n * Extract birth date from a Kuwait civil number.\n * Gender is not encoded in the number.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedBirthDate | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const centuryDigit = Number(v[0]);\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = yearBase + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n  };\n};\n\n/** Generate a random valid Kuwait civil number. */\nconst generate = (): string => {\n  for (;;) {\n    const year = randomInt(1950, 2024);\n    const month = String(randomInt(1, 12)).padStart(2, \"0\");\n    const day = String(randomInt(1, 28)).padStart(2, \"0\");\n    const body =\n      `${year >= 2000 ? \"3\" : \"2\"}` +\n      `${String(year % 100).padStart(2, \"0\")}` +\n      `${month}${day}${randomDigits(4)}`;\n    const check = calcCheckDigit(body);\n    if (check > 9) continue;\n    return `${body}${String(check)}`;\n  }\n};\n\n/** Kuwait Civil Number (الرقم المدني). */\nconst civil: Validator<ParsedBirthDate> = {\n  name: \"Civil Number\",\n  localName: \"الرقم المدني\",\n  abbreviation: \"Civil ID\",\n  aliases: [\"Civil ID\", \"الرقم المدني\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"KW\",\n  entityType: \"person\",\n  lengths: [12] as const,\n  examples: [\"289011200032\", \"305031512348\"] as const,\n  description:\n    \"12-digit civil identification number issued by PACI\",\n  sourceUrl:\n    \"https://kuwaitsexpat.com/kuwait-civil-id-format/\",\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default civil;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/kw/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import civil from "./civil.js";
 
 //#region src/kw/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { civil };
+}
 //#endregion
 export { civil, mod_d_exports };
 //# sourceMappingURL=mod.d.ts.map

package/dist/kz/iin.d.ts

@@ -1,7 +1,6 @@
 import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
 
 //#region src/kz/iin.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -17,7 +16,7 @@ declare const generate: () => string;
  *
  * Examples sourced from identique/idnumbers test suite.
  */
-declare const iin: Validator;
+declare const iin: Validator<ParsedPersonId>;
 //#endregion
 export { compact, iin as default, format, generate, parse, validate };
 //# sourceMappingURL=iin.d.ts.map

package/dist/kz/iin.js

@@ -140,6 +140,7 @@ const iin = {
 	examples: ["880515300120", "950101400012"],
 	compact,
 	format,
+	parse,
 	validate,
 	sourceUrl: "https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Kazakhstan-TIN.pdf",
 	generate

package/dist/kz/iin.js.map

@@ -1 +1 @@
-{"version":3,"file":"iin.js","names":[],"sources":["../../src/kz/iin.ts"],"sourcesContent":["/**\n * IIN (Individual Identification Number,\n * Жеке сәйкестендіру нөмірі / ИИН).\n *\n * Kazakhstan individual identification number. 12 digits:\n *   YYMMDD = birth date\n *   C      = century/gender (1-6)\n *   SSSS   = serial number\n *   K      = check digit (two-pass weighted sum mod 11)\n *\n * Odd century digits = male, even = female.\n * 1-2 = 1800s, 3-4 = 1900s, 5-6 = 2000s.\n *\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Kazakhstan-TIN.pdf\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst WEIGHTS_1 = [\n  1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11,\n] as const;\nconst WEIGHTS_2 = [\n  3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 2,\n] as const;\n\nconst centuryMap: Record<number, number> = {\n  1: 1800,\n  2: 1800,\n  3: 1900,\n  4: 1900,\n  5: 2000,\n  6: 2000,\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Two-pass check digit: weighted sum mod 11 with\n * fallback to second weight set.\n */\nconst calcCheckDigit = (digits: string): number => {\n  let remainder = weightedSum(digits, WEIGHTS_1, 11);\n  if (remainder === 10) {\n    remainder = weightedSum(digits, WEIGHTS_2, 11);\n  }\n  return remainder === 10 ? 0 : remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Kazakhstan IIN must be 12 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Kazakhstan IIN must contain only digits\",\n    );\n  }\n\n  const centuryDigit = Number(v[6]);\n  if (centuryDigit < 1 || centuryDigit > 6) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"IIN century/gender digit must be 1-6\",\n    );\n  }\n\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const year = yearBase + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"IIN contains an invalid birth date\",\n    );\n  }\n\n  const expected = calcCheckDigit(v.slice(0, 11));\n  if (expected !== Number(v[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"IIN check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 6)} ${v.slice(6)}`;\n};\n\n/**\n * Extract birth date and gender from a Kazakhstan IIN.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const centuryDigit = Number(v[6]);\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const year = yearBase + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: centuryDigit % 2 === 1 ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Kazakhstan IIN. */\nconst generate = (): string => {\n  for (;;) {\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const gender = String(randomInt(1, 6));\n    const serial = randomDigits(4);\n    const payload = yy + mm + dd + gender + serial;\n    const check = calcCheckDigit(payload);\n    if (check === null) continue;\n    const c = payload + String(check);\n    if (validate(c).valid) return c;\n  }\n};\n\n/**\n * Kazakhstan Individual Identification Number (IIN).\n *\n * Examples sourced from identique/idnumbers test suite.\n */\nconst iin: Validator = {\n  name: \"Kazakhstan Individual ID\",\n  localName: \"Жеке сәйкестендіру нөмірі\",\n  abbreviation: \"IIN\",\n  aliases: [\n    \"ИИН\",\n    \"IIN\",\n    \"индивидуальный идентификационный номер\",\n  ] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"KZ\",\n  entityType: \"person\",\n  lengths: [12] as const,\n  examples: [\"880515300120\", \"950101400012\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl:\n    \"https://www.oecd.org/tax/automatic-exchange/\" +\n    \"crs-implementation-and-assistance/\" +\n    \"tax-identification-numbers/Kazakhstan-TIN.pdf\",\n  generate,\n};\n\nexport default iin;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"iin.js","names":[],"sources":["../../src/kz/iin.ts"],"sourcesContent":["/**\n * IIN (Individual Identification Number,\n * Жеке сәйкестендіру нөмірі / ИИН).\n *\n * Kazakhstan individual identification number. 12 digits:\n *   YYMMDD = birth date\n *   C      = century/gender (1-6)\n *   SSSS   = serial number\n *   K      = check digit (two-pass weighted sum mod 11)\n *\n * Odd century digits = male, even = female.\n * 1-2 = 1800s, 3-4 = 1900s, 5-6 = 2000s.\n *\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Kazakhstan-TIN.pdf\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst WEIGHTS_1 = [\n  1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11,\n] as const;\nconst WEIGHTS_2 = [\n  3, 4, 5, 6, 7, 8, 9, 10, 11, 1, 2,\n] as const;\n\nconst centuryMap: Record<number, number> = {\n  1: 1800,\n  2: 1800,\n  3: 1900,\n  4: 1900,\n  5: 2000,\n  6: 2000,\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Two-pass check digit: weighted sum mod 11 with\n * fallback to second weight set.\n */\nconst calcCheckDigit = (digits: string): number => {\n  let remainder = weightedSum(digits, WEIGHTS_1, 11);\n  if (remainder === 10) {\n    remainder = weightedSum(digits, WEIGHTS_2, 11);\n  }\n  return remainder === 10 ? 0 : remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Kazakhstan IIN must be 12 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Kazakhstan IIN must contain only digits\",\n    );\n  }\n\n  const centuryDigit = Number(v[6]);\n  if (centuryDigit < 1 || centuryDigit > 6) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"IIN century/gender digit must be 1-6\",\n    );\n  }\n\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const year = yearBase + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"IIN contains an invalid birth date\",\n    );\n  }\n\n  const expected = calcCheckDigit(v.slice(0, 11));\n  if (expected !== Number(v[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"IIN check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 6)} ${v.slice(6)}`;\n};\n\n/**\n * Extract birth date and gender from a Kazakhstan IIN.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const centuryDigit = Number(v[6]);\n  const yearBase = centuryMap[centuryDigit] ?? 1900;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const year = yearBase + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: centuryDigit % 2 === 1 ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Kazakhstan IIN. */\nconst generate = (): string => {\n  for (;;) {\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const gender = String(randomInt(1, 6));\n    const serial = randomDigits(4);\n    const payload = yy + mm + dd + gender + serial;\n    const check = calcCheckDigit(payload);\n    if (check === null) continue;\n    const c = payload + String(check);\n    if (validate(c).valid) return c;\n  }\n};\n\n/**\n * Kazakhstan Individual Identification Number (IIN).\n *\n * Examples sourced from identique/idnumbers test suite.\n */\nconst iin: Validator<ParsedPersonId> = {\n  name: \"Kazakhstan Individual ID\",\n  localName: \"Жеке сәйкестендіру нөмірі\",\n  abbreviation: \"IIN\",\n  aliases: [\n    \"ИИН\",\n    \"IIN\",\n    \"индивидуальный идентификационный номер\",\n  ] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"KZ\",\n  entityType: \"person\",\n  lengths: [12] as const,\n  examples: [\"880515300120\", \"950101400012\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  sourceUrl:\n    \"https://www.oecd.org/tax/automatic-exchange/\" +\n    \"crs-implementation-and-assistance/\" +\n    \"tax-identification-numbers/Kazakhstan-TIN.pdf\",\n  generate,\n};\n\nexport default iin;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}

package/dist/kz/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import iin from "./iin.js";
 
 //#region src/kz/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { iin };
+}
 //#endregion
 export { iin, mod_d_exports };
 //# sourceMappingURL=mod.d.ts.map

package/dist/lei.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "./types.js";
 
 //#region src/lei.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/li/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import peid from "./peid.js";
 
 //#region src/li/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { peid };
+}
 //#endregion
 export { mod_d_exports, peid };
 //# sourceMappingURL=mod.d.ts.map

package/dist/lk/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import nic from "./nic.js";
 
 //#region src/lk/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { nic };
+}
 //#endregion
 export { mod_d_exports, nic };
 //# sourceMappingURL=mod.d.ts.map

package/dist/lk/nic.d.ts

@@ -1,7 +1,6 @@
 import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
 
 //#region src/lk/nic.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -10,8 +9,10 @@ declare const format: (value: string) => string;
  * Returns null if the value is not valid.
  */
 declare const parse: (value: string) => ParsedPersonId | null;
+/** Generate a random valid Sri Lankan NIC. */
+declare const generate: () => string;
 /** Sri Lankan National Identity Card. */
-declare const nic: Validator;
+declare const nic: Validator<ParsedPersonId>;
 //#endregion
-export { compact, nic as default, format, parse, validate };
+export { compact, nic as default, format, generate, parse, validate };
 //# sourceMappingURL=nic.d.ts.map

package/dist/lk/nic.js

@@ -1,4 +1,5 @@
 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";
 import { isValidDate } from "../_util/date.js";
@@ -116,6 +117,15 @@ const parse = (value) => {
 		gender: info.gender
 	};
 };
+/** Generate a random valid Sri Lankan NIC. */
+const generate = () => {
+	const year = randomInt(1950, 2024);
+	const start = new Date(year, 0, 1);
+	const end = new Date(year, 11, 31);
+	const dayOfYear = randomInt(1, Math.round((end.getTime() - start.getTime()) / 864e5) + 1);
+	const body = `${year}${String(dayOfYear + (Math.random() < .5 ? 0 : 500)).padStart(3, "0")}0${randomDigits(3)}`;
+	return `${body}${String(checkDigit(body))}`;
+};
 /** Sri Lankan National Identity Card. */
 const nic = {
 	name: "National Identity Card",
@@ -131,9 +141,11 @@ const nic = {
 	examples: ["197819202757", "862348753V"],
 	compact,
 	format,
-	validate
+	parse,
+	validate,
+	generate
 };
 //#endregion
-export { compact, nic as default, format, parse, validate };
+export { compact, nic as default, format, generate, parse, validate };
 
 //# sourceMappingURL=nic.js.map

package/dist/lk/nic.js.map

@@ -1 +1 @@
-{"version":3,"file":"nic.js","names":[],"sources":["../../src/lk/nic.ts"],"sourcesContent":["/**\n * NIC (National Identity Card, ජාතික හැඳුනුම්පත).\n *\n * Sri Lankan personal identity number. Two formats:\n *   Old (pre-2016): 9 digits + V or X (10 chars)\n *   New (2016+):    12 digits\n *\n * Both encode birth date (day-of-year), gender, a\n * serial number, and a check digit.\n *\n * @see https://en.wikipedia.org/wiki/National_identification_number#Sri_Lanka\n * @see https://drp.gov.lk/Templates/Artical%20-%20English%20new%20number.html\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\n/** Old format: 9 digits + V or X (case-insensitive). */\nconst OLD_RE = /^\\d{9}[VvXx]$/;\n\n/** New format: exactly 12 digits. */\nconst NEW_RE = /^\\d{12}$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\n/**\n * Convert an old-format NIC to the 12-digit new\n * format for uniform validation.\n *\n * Old: YY DDD SSS C V/X  (10 chars)\n * New: 19YY DDD 0SSS C   (12 digits)\n */\nconst toNewFormat = (v: string): string => {\n  const yy = v.slice(0, 2);\n  const ddd = v.slice(2, 5);\n  const sss = v.slice(5, 8);\n  const check = v[8];\n  return `19${yy}${ddd}0${sss}${check}`;\n};\n\n/**\n * Checksum weights for the first 11 digits.\n * Algorithm: weighted sum mod 11, then mod 10\n * if >= 10.\n */\nconst CHECK_WEIGHTS = [\n  8, 4, 3, 2, 7, 6, 5, 7, 4, 3, 2,\n] as const;\n\nconst checkDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 11; i++) {\n    sum +=\n      (CHECK_WEIGHTS[i] ?? 0) * Number(digits.charAt(i));\n  }\n  const d = 11 - (sum % 11);\n  return d > 9 ? d % 10 : d;\n};\n\n/**\n * Resolve birth date and gender from the 12-digit\n * normalised form (YYYY DDD ...).\n *\n * Day-of-year encoding:\n *   Male:   1–366\n *   Female: 501–866 (subtract 500)\n */\nconst resolveBirthInfo = (\n  v: string,\n): {\n  year: number;\n  month: number;\n  day: number;\n  gender: \"male\" | \"female\";\n} | null => {\n  const year = Number(v.slice(0, 4));\n  let days = Number(v.slice(4, 7));\n\n  const gender: \"male\" | \"female\" =\n    days > 500 ? \"female\" : \"male\";\n  if (days > 500) days -= 500;\n\n  if (days < 1 || days > 366) return null;\n\n  // Convert day-of-year to month/day via Date\n  const d = new Date(year, 0, days);\n  const month = d.getMonth() + 1;\n  const dayOfMonth = d.getDate();\n\n  if (!isValidDate(year, month, dayOfMonth)) {\n    return null;\n  }\n\n  // Guard against day 366 in non-leap years\n  if (d.getFullYear() !== year) return null;\n\n  return { year, month, day: dayOfMonth, gender };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  const isOld = OLD_RE.test(v);\n  const isNew = NEW_RE.test(v);\n\n  if (!isOld && !isNew) {\n    if (v.length !== 10 && v.length !== 12) {\n      return err(\n        \"INVALID_LENGTH\",\n        \"NIC must be 10 (old) or 12 (new) characters\",\n      );\n    }\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIC must be 9 digits + V/X (old) or\" +\n        \" 12 digits (new)\",\n    );\n  }\n\n  const normalized = isOld ? toNewFormat(v) : v;\n\n  if (!isdigits(normalized)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIC contains invalid characters\",\n    );\n  }\n\n  if (resolveBirthInfo(normalized) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"NIC contains an invalid date of birth\",\n    );\n  }\n\n  const expected = checkDigit(normalized.slice(0, 11));\n  if (expected !== Number(normalized[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  // Old format: YYDDDSSSXV → no standard separator\n  // New format: YYYYDDDSSSSC → no standard separator\n  return v;\n};\n\n/**\n * Extract birth date and gender from an NIC.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const isOld = OLD_RE.test(v);\n  const normalized = isOld ? toNewFormat(v) : v;\n\n  const info = resolveBirthInfo(normalized);\n  if (info === null) return null;\n\n  return {\n    birthDate: new Date(\n      info.year,\n      info.month - 1,\n      info.day,\n    ),\n    gender: info.gender,\n  };\n};\n\n/** Sri Lankan National Identity Card. */\nconst nic: Validator = {\n  name: \"National Identity Card\",\n  localName: \"ජාතික හැඳුනුම්පත\",\n  abbreviation: \"NIC\",\n  aliases: [\"NIC\", \"ජාතික හැඳුනුම්පත\"] as const,\n  candidatePattern: \"\\\\d{9}[VXvx]|\\\\d{12}\",\n  country: \"LK\",\n  entityType: \"person\",\n  description:\n    \"Sri Lankan personal identity number issued to\" +\n    \" all citizens\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"National_identification_number#Sri_Lanka\",\n  lengths: [10, 12] as const,\n  examples: [\"197819202757\", \"862348753V\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default nic;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BA,MAAM,SAAS;;AAGf,MAAM,SAAS;AAEf,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;;;;;;;;AASlC,MAAM,eAAe,MAAsB;AAKzC,QAAO,KAJI,EAAE,MAAM,GAAG,EAAE,GACZ,EAAE,MAAM,GAAG,EAAE,CAGJ,GAFT,EAAE,MAAM,GAAG,EAAE,GACX,EAAE;;;;;;;AASlB,MAAM,gBAAgB;CACpB;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAC/B;AAED,MAAM,cAAc,WAA2B;CAC7C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SACG,cAAc,MAAM,KAAK,OAAO,OAAO,OAAO,EAAE,CAAC;CAEtD,MAAM,IAAI,KAAM,MAAM;AACtB,QAAO,IAAI,IAAI,IAAI,KAAK;;;;;;;;;;AAW1B,MAAM,oBACJ,MAMU;CACV,MAAM,OAAO,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAClC,IAAI,OAAO,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAEhC,MAAM,SACJ,OAAO,MAAM,WAAW;AAC1B,KAAI,OAAO,IAAK,SAAQ;AAExB,KAAI,OAAO,KAAK,OAAO,IAAK,QAAO;CAGnC,MAAM,IAAI,IAAI,KAAK,MAAM,GAAG,KAAK;CACjC,MAAM,QAAQ,EAAE,UAAU,GAAG;CAC7B,MAAM,aAAa,EAAE,SAAS;AAE9B,KAAI,CAAC,YAAY,MAAM,OAAO,WAAW,CACvC,QAAO;AAIT,KAAI,EAAE,aAAa,KAAK,KAAM,QAAO;AAErC,QAAO;EAAE;EAAM;EAAO,KAAK;EAAY;EAAQ;;AAGjD,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;CACxB,MAAM,QAAQ,OAAO,KAAK,EAAE;CAC5B,MAAM,QAAQ,OAAO,KAAK,EAAE;AAE5B,KAAI,CAAC,SAAS,CAAC,OAAO;AACpB,MAAI,EAAE,WAAW,MAAM,EAAE,WAAW,GAClC,QAAO,IACL,kBACA,8CACD;AAEH,SAAO,IACL,kBACA,sDAED;;CAGH,MAAM,aAAa,QAAQ,YAAY,EAAE,GAAG;AAE5C,KAAI,CAAC,SAAS,WAAW,CACvB,QAAO,IACL,kBACA,kCACD;AAGH,KAAI,iBAAiB,WAAW,KAAK,KACnC,QAAO,IACL,qBACA,wCACD;AAIH,KADiB,WAAW,WAAW,MAAM,GAAG,GAAG,CAAC,KACnC,OAAO,WAAW,IAAI,CACrC,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;AAIxC,QAHU,QAAQ,MAAM;;;;;;AAU1B,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CAIjB,MAAM,OAAO,iBAHC,OAAO,KAAK,EAAE,GACD,YAAY,EAAE,GAAG,EAEH;AACzC,KAAI,SAAS,KAAM,QAAO;AAE1B,QAAO;EACL,WAAW,IAAI,KACb,KAAK,MACL,KAAK,QAAQ,GACb,KAAK,IACN;EACD,QAAQ,KAAK;EACd;;;AAIH,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,mBAAmB;CACpC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CAEF,SAAS,CAAC,IAAI,GAAG;CACjB,UAAU,CAAC,gBAAgB,aAAa;CACxC;CACA;CACA;CACD"}
+{"version":3,"file":"nic.js","names":[],"sources":["../../src/lk/nic.ts"],"sourcesContent":["/**\n * NIC (National Identity Card, ජාතික හැඳුනුම්පත).\n *\n * Sri Lankan personal identity number. Two formats:\n *   Old (pre-2016): 9 digits + V or X (10 chars)\n *   New (2016+):    12 digits\n *\n * Both encode birth date (day-of-year), gender, a\n * serial number, and a check digit.\n *\n * @see https://en.wikipedia.org/wiki/National_identification_number#Sri_Lanka\n * @see https://drp.gov.lk/Templates/Artical%20-%20English%20new%20number.html\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\n/** Old format: 9 digits + V or X (case-insensitive). */\nconst OLD_RE = /^\\d{9}[VvXx]$/;\n\n/** New format: exactly 12 digits. */\nconst NEW_RE = /^\\d{12}$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\n/**\n * Convert an old-format NIC to the 12-digit new\n * format for uniform validation.\n *\n * Old: YY DDD SSS C V/X  (10 chars)\n * New: 19YY DDD 0SSS C   (12 digits)\n */\nconst toNewFormat = (v: string): string => {\n  const yy = v.slice(0, 2);\n  const ddd = v.slice(2, 5);\n  const sss = v.slice(5, 8);\n  const check = v[8];\n  return `19${yy}${ddd}0${sss}${check}`;\n};\n\n/**\n * Checksum weights for the first 11 digits.\n * Algorithm: weighted sum mod 11, then mod 10\n * if >= 10.\n */\nconst CHECK_WEIGHTS = [\n  8, 4, 3, 2, 7, 6, 5, 7, 4, 3, 2,\n] as const;\n\nconst checkDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 11; i++) {\n    sum +=\n      (CHECK_WEIGHTS[i] ?? 0) * Number(digits.charAt(i));\n  }\n  const d = 11 - (sum % 11);\n  return d > 9 ? d % 10 : d;\n};\n\n/**\n * Resolve birth date and gender from the 12-digit\n * normalised form (YYYY DDD ...).\n *\n * Day-of-year encoding:\n *   Male:   1–366\n *   Female: 501–866 (subtract 500)\n */\nconst resolveBirthInfo = (\n  v: string,\n): {\n  year: number;\n  month: number;\n  day: number;\n  gender: \"male\" | \"female\";\n} | null => {\n  const year = Number(v.slice(0, 4));\n  let days = Number(v.slice(4, 7));\n\n  const gender: \"male\" | \"female\" =\n    days > 500 ? \"female\" : \"male\";\n  if (days > 500) days -= 500;\n\n  if (days < 1 || days > 366) return null;\n\n  // Convert day-of-year to month/day via Date\n  const d = new Date(year, 0, days);\n  const month = d.getMonth() + 1;\n  const dayOfMonth = d.getDate();\n\n  if (!isValidDate(year, month, dayOfMonth)) {\n    return null;\n  }\n\n  // Guard against day 366 in non-leap years\n  if (d.getFullYear() !== year) return null;\n\n  return { year, month, day: dayOfMonth, gender };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  const isOld = OLD_RE.test(v);\n  const isNew = NEW_RE.test(v);\n\n  if (!isOld && !isNew) {\n    if (v.length !== 10 && v.length !== 12) {\n      return err(\n        \"INVALID_LENGTH\",\n        \"NIC must be 10 (old) or 12 (new) characters\",\n      );\n    }\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIC must be 9 digits + V/X (old) or\" +\n        \" 12 digits (new)\",\n    );\n  }\n\n  const normalized = isOld ? toNewFormat(v) : v;\n\n  if (!isdigits(normalized)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIC contains invalid characters\",\n    );\n  }\n\n  if (resolveBirthInfo(normalized) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"NIC contains an invalid date of birth\",\n    );\n  }\n\n  const expected = checkDigit(normalized.slice(0, 11));\n  if (expected !== Number(normalized[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  // Old format: YYDDDSSSXV → no standard separator\n  // New format: YYYYDDDSSSSC → no standard separator\n  return v;\n};\n\n/**\n * Extract birth date and gender from an NIC.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const isOld = OLD_RE.test(v);\n  const normalized = isOld ? toNewFormat(v) : v;\n\n  const info = resolveBirthInfo(normalized);\n  if (info === null) return null;\n\n  return {\n    birthDate: new Date(\n      info.year,\n      info.month - 1,\n      info.day,\n    ),\n    gender: info.gender,\n  };\n};\n\n/** Generate a random valid Sri Lankan NIC. */\nconst generate = (): string => {\n  const year = randomInt(1950, 2024);\n  const start = new Date(year, 0, 1);\n  const end = new Date(year, 11, 31);\n  const maxDay =\n    Math.round(\n      (end.getTime() - start.getTime()) / 86_400_000,\n    ) + 1;\n  const dayOfYear = randomInt(1, maxDay);\n  const genderOffset = Math.random() < 0.5 ? 0 : 500;\n  const ddd = String(dayOfYear + genderOffset).padStart(\n    3,\n    \"0\",\n  );\n  const body = `${year}${ddd}0${randomDigits(3)}`;\n  return `${body}${String(checkDigit(body))}`;\n};\n\n/** Sri Lankan National Identity Card. */\nconst nic: Validator<ParsedPersonId> = {\n  name: \"National Identity Card\",\n  localName: \"ජාතික හැඳුනුම්පත\",\n  abbreviation: \"NIC\",\n  aliases: [\"NIC\", \"ජාතික හැඳුනුම්පත\"] as const,\n  candidatePattern: \"\\\\d{9}[VXvx]|\\\\d{12}\",\n  country: \"LK\",\n  entityType: \"person\",\n  description:\n    \"Sri Lankan personal identity number issued to\" +\n    \" all citizens\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"National_identification_number#Sri_Lanka\",\n  lengths: [10, 12] as const,\n  examples: [\"197819202757\", \"862348753V\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default nic;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/lt/asmens.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/lt/asmens.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/lt/mod.d.ts

@@ -1,9 +1,10 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import asmens from "./asmens.js";
 import vat from "./vat.js";
 
 //#region src/lt/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { asmens, vat };
+}
 //#endregion
 export { asmens, mod_d_exports, vat };
 //# sourceMappingURL=mod.d.ts.map

package/dist/lt/vat.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/lt/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/lu/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import vat from "./vat.js";
 
 //#region src/lu/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { vat };
+}
 //#endregion
 export { mod_d_exports, vat };
 //# sourceMappingURL=mod.d.ts.map

package/dist/lu/vat.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/lu/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/luhn.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "./types.js";
 
 //#region src/luhn.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/luhn.js

@@ -38,7 +38,14 @@ const luhn = {
 	name: "Luhn",
 	localName: "Luhn",
 	abbreviation: "Luhn",
+	aliases: [
+		"Luhn",
+		"Luhn algorithm",
+		"mod 10"
+	],
+	candidatePattern: "\\d{2,}",
 	entityType: "any",
+	sourceUrl: "https://en.wikipedia.org/wiki/Luhn_algorithm",
 	examples: ["4111111111111111", "18"],
 	compact,
 	format,

package/dist/luhn.js.map

@@ -1 +1 @@
-{"version":3,"file":"luhn.js","names":[],"sources":["../src/luhn.ts"],"sourcesContent":["/**\n * Generic Luhn checksum validation.\n *\n * Validates any digit string using the Luhn\n * algorithm (ISO/IEC 7812-1). No length\n * restriction. For credit card validation\n * (13-19 digits), use `creditcard` instead.\n */\n\nimport {\n  luhnChecksum,\n  luhnValidate,\n} from \"#checksums/luhn\";\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\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 1) {\n    return err(\"INVALID_LENGTH\", \"Value must not be empty\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Value must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Luhn check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Generate a random Luhn-valid number of the\n * given length (default 16).\n */\nconst generate = (length = 16): string => {\n  const payload = randomDigits(length - 1);\n  const partial = `${payload}0`;\n  const remainder = luhnChecksum(partial);\n  const check = (10 - remainder) % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Generic Luhn Validator. */\nconst luhn: Validator = {\n  name: \"Luhn\",\n  localName: \"Luhn\",\n  abbreviation: \"Luhn\",\n  entityType: \"any\",\n  examples: [\"4111111111111111\", \"18\"] as const,\n  compact,\n  format,\n  validate,\n  generate: () => generate(),\n};\n\nexport default luhn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,EACb,QAAO,IAAI,kBAAkB,0BAA0B;AAEzD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,kCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,YAAY,SAAS,OAAe;CACxC,MAAM,UAAU,aAAa,SAAS,EAAE;CAGxC,MAAM,SAAS,KADG,aADF,GAAG,QAAQ,GACY,IACN;AACjC,QAAO,GAAG,UAAU,OAAO,MAAM;;;AAInC,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,YAAY;CACZ,UAAU,CAAC,oBAAoB,KAAK;CACpC;CACA;CACA;CACA,gBAAgB,UAAU;CAC3B"}
+{"version":3,"file":"luhn.js","names":[],"sources":["../src/luhn.ts"],"sourcesContent":["/**\n * Generic Luhn checksum validation.\n *\n * Validates any digit string using the Luhn\n * algorithm (ISO/IEC 7812-1). No length\n * restriction. For credit card validation\n * (13-19 digits), use `creditcard` instead.\n */\n\nimport {\n  luhnChecksum,\n  luhnValidate,\n} from \"#checksums/luhn\";\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\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 1) {\n    return err(\"INVALID_LENGTH\", \"Value must not be empty\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Value must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Luhn check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Generate a random Luhn-valid number of the\n * given length (default 16).\n */\nconst generate = (length = 16): string => {\n  const payload = randomDigits(length - 1);\n  const partial = `${payload}0`;\n  const remainder = luhnChecksum(partial);\n  const check = (10 - remainder) % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Generic Luhn Validator. */\nconst luhn: Validator = {\n  name: \"Luhn\",\n  localName: \"Luhn\",\n  abbreviation: \"Luhn\",\n  aliases: [\"Luhn\", \"Luhn algorithm\", \"mod 10\"] as const,\n  candidatePattern: \"\\\\d{2,}\",\n  entityType: \"any\",\n  sourceUrl: \"https://en.wikipedia.org/wiki/Luhn_algorithm\",\n  examples: [\"4111111111111111\", \"18\"] as const,\n  compact,\n  format,\n  validate,\n  generate: () => generate(),\n};\n\nexport default luhn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,EACb,QAAO,IAAI,kBAAkB,0BAA0B;AAEzD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,kCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,YAAY,SAAS,OAAe;CACxC,MAAM,UAAU,aAAa,SAAS,EAAE;CAGxC,MAAM,SAAS,KADG,aADF,GAAG,QAAQ,GACY,IACN;AACjC,QAAO,GAAG,UAAU,OAAO,MAAM;;;AAInC,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAkB;EAAS;CAC7C,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,oBAAoB,KAAK;CACpC;CACA;CACA;CACA,gBAAgB,UAAU;CAC3B"}

package/dist/lv/mod.d.ts

@@ -1,8 +1,9 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import vat from "./vat.js";
 
 //#region src/lv/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { vat };
+}
 //#endregion
 export { mod_d_exports, vat };
 //# sourceMappingURL=mod.d.ts.map

package/dist/lv/vat.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/lv/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/lv/vat.js

@@ -7,12 +7,29 @@ import { weightedSum } from "../_checksums/weighted-sum.js";
 /**
 * PVN (Latvian VAT number).
 *
-* 11 digits. Legal entities (first digit > 3):
-* weights [9,1,4,8,3,10,2,5,7,6,1], sum % 11 === 3.
-* Personal (first digit <= 3): 11-digit format only.
+* 11 digits.
 *
-* @see https://www.vatify.eu/latvia-vat-number.html
-* @see https://www.vid.gov.lv/en
+* Individuals:
+* - legacy personal codes: DDMMYY + century digit 0/1/2 + 4 digits
+* - since 1 July 2017: codes start with 3, the second digit is 2-9,
+*   and the remaining digits are random
+*
+* Entities:
+* - tax administration issued: 9XXXXXXXXXX
+* - enterprise register issued: 4XXXXXXXXXX / 5XXXXXXXXXX
+*
+* Canonical sources:
+* - OECD Latvia TIN sheet for the tax-facing formats
+* - PMLP page documenting the post-2017 personal code
+*
+* These are the reasons we accept the new personal
+* code shape (`3` + second digit `2-9`) without the
+* legacy birth-date checksum, and why we reject
+* legacy personal codes with century digits outside
+* 0/1/2.
+*
+* @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Latvia-TIN.pdf
+* @see https://www.pmlp.gov.lv/en/change-personal-identity-number
 */
 const WEIGHTS = [
 	9,
@@ -53,7 +70,9 @@ const validateBirthDate = (v) => {
 	const day = Number(v.slice(0, 2));
 	const month = Number(v.slice(2, 4));
 	const year2 = Number(v.slice(4, 6));
-	const fullYear = 1800 + Number(v[6]) * 100 + year2;
+	const century = Number(v[6]);
+	if (century < 0 || century > 2) return false;
+	const fullYear = 1800 + century * 100 + year2;
 	const date = new Date(fullYear, month - 1, day);
 	return date.getFullYear() === fullYear && date.getMonth() === month - 1 && date.getDate() === day;
 };
@@ -61,10 +80,13 @@ const validate = (value) => {
 	const v = compact(value);
 	if (v.length !== 11) return err("INVALID_LENGTH", "Latvian VAT number must be 11 digits");
 	if (!isdigits(v)) return err("INVALID_FORMAT", "Latvian VAT number must contain only digits");
-	if (Number(v[0]) > 3) {
+	if (v[0] === "3" && v[1] !== void 0 && v[1] >= "2" && v[1] <= "9") return {
+		valid: true,
+		compact: v
+	};
+	const first = v[0];
+	if (first === "4" || first === "5" || first === "9") {
 		if (weightedSum(v, WEIGHTS, 11) !== 3) return err("INVALID_CHECKSUM", "Latvian VAT number check digit mismatch");
-	} else if (v.startsWith("32")) {
-		if (!checkPersonal(v)) return err("INVALID_CHECKSUM", "Latvian personal code check digit mismatch");
 	} else {
 		if (!validateBirthDate(v)) return err("INVALID_COMPONENT", "Latvian personal code has invalid birth date");
 		if (!checkPersonal(v)) return err("INVALID_CHECKSUM", "Latvian personal code check digit mismatch");
@@ -77,8 +99,13 @@ const validate = (value) => {
 const format = (value) => `LV${compact(value)}`;
 /** Generate a random valid Latvian VAT number. */
 const generate = () => {
+	const entityPrefixes = [
+		"4",
+		"5",
+		"9"
+	];
 	for (;;) {
-		const c = String(randomInt(4, 9)) + randomDigits(10);
+		const c = randomInt(0, 1) === 0 ? `3${randomInt(2, 9)}${randomDigits(9)}` : `${entityPrefixes[randomInt(0, entityPrefixes.length - 1)] ?? "4"}${randomDigits(10)}`;
 		if (validate(c).valid) return c;
 	}
 };
@@ -91,8 +118,8 @@ const vat = {
 	candidatePattern: "LV\\d{11}",
 	country: "LV",
 	entityType: "any",
-	sourceUrl: "https://www.vid.gov.lv/en",
-	examples: ["40003521600"],
+	sourceUrl: "https://www.pmlp.gov.lv/en/change-personal-identity-number",
+	examples: ["40003521600", "32999999999"],
 	compact,
 	format,
 	validate,