@stll/stdnum 1.0.0 → 2.0.1

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 { 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":";;;;;;;;;;;;;;;;AAuBA,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,iBAAyB;CAC7B,MAAM,OAAO,UAAU,MAAM,KAAK;CAClC,MAAM,QAAQ,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;CACvD,MAAM,MAAM,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;CAOrD,MAAM,OAAO,GANF,OAAO,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,GAMzB,QAAQ,MAJ3B,QAAQ,MACJ,OAAO,UAAU,GAAG,EAAE,CAAC,GACvB,OAAO,UAAU,GAAG,EAAE,CAAC,GACf,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI,GACE,aAAa,EAAE;AACxE,QAAO,GAAG,OAAO,OAAO,WAAW,KAAK,CAAC;;;AAI3C,MAAM,MAAiC;CACrC,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;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 type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\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\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: CountryValidator<\"KR\", 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  scope: \"country\",\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,4 +1,4 @@
-import { ParsedBirthDate, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedBirthDate, ValidateResult } from "../types.js";
 
 //#region src/kw/civil.d.ts
 declare const compact: (value: string) => string;
@@ -13,7 +13,7 @@ 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<ParsedBirthDate>;
+declare const civil: CountryValidator<"KW", ParsedBirthDate>;
 //#endregion
 export { compact, civil as default, format, generate, parse, validate };
 //# sourceMappingURL=civil.d.ts.map

package/dist/kw/civil.js

@@ -1,22 +1,9 @@
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.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";
 //#region src/kw/civil.ts
-/**
-* Civil Number (الرقم المدني, Kuwait).
-*
-* 12-digit number issued by PACI (Public Authority
-* for Civil Information):
-*   C       = century indicator (2 = 1900s, 3 = 2000s)
-*   YYMMDD  = birth date
-*   SSSS    = serial number
-*   K       = check digit (mod 11 weighted sum)
-*
-* @see https://prakhar.me/articles/kuwait-civil-id-checksum/
-* @see https://kuwaitsexpat.com/kuwait-civil-id-format/
-*/
 const WEIGHTS = [
 	2,
 	1,
@@ -96,6 +83,7 @@ const civil = {
 	abbreviation: "Civil ID",
 	aliases: ["Civil ID", "الرقم المدني"],
 	candidatePattern: "\\d{12}",
+	scope: "country",
 	country: "KW",
 	entityType: "person",
 	lengths: [12],

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 { 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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"}
+{"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 type {\n  ParsedBirthDate,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\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\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: CountryValidator<\"KW\", ParsedBirthDate> = {\n  name: \"Civil Number\",\n  localName: \"الرقم المدني\",\n  abbreviation: \"Civil ID\",\n  aliases: [\"Civil ID\", \"الرقم المدني\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  scope: \"country\",\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/kz/iin.d.ts

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

package/dist/kz/iin.js

@@ -1,25 +1,10 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/kz/iin.ts
-/**
-* IIN (Individual Identification Number,
-* Жеке сәйкестендіру нөмірі / ИИН).
-*
-* Kazakhstan individual identification number. 12 digits:
-*   YYMMDD = birth date
-*   C      = century/gender (1-6)
-*   SSSS   = serial number
-*   K      = check digit (two-pass weighted sum mod 11)
-*
-* Odd century digits = male, even = female.
-* 1-2 = 1800s, 3-4 = 1900s, 5-6 = 2000s.
-*
-* @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Kazakhstan-TIN.pdf
-*/
 const WEIGHTS_1 = [
 	1,
 	2,
@@ -114,7 +99,6 @@ const generate = () => {
 		const serial = randomDigits(4);
 		const payload = yy + mm + dd + gender + serial;
 		const check = calcCheckDigit(payload);
-		if (check === null) continue;
 		const c = payload + String(check);
 		if (validate(c).valid) return c;
 	}
@@ -134,6 +118,7 @@ const iin = {
 		"индивидуальный идентификационный номер"
 	],
 	candidatePattern: "\\d{12}",
+	scope: "country",
 	country: "KZ",
 	entityType: "person",
 	lengths: [12],

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<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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"}
+{"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 type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\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\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    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: CountryValidator<\"KZ\", 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  scope: \"country\",\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/lei.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "./types.js";
+import { GlobalValidator, ValidateResult } from "./types.js";
 
 //#region src/lei.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid LEI. */
 declare const generate: () => string;
 /** Legal Entity Identifier. */
-declare const lei: Validator;
+declare const lei: GlobalValidator;
 //#endregion
 export { compact, lei as default, format, generate, validate };
 //# sourceMappingURL=lei.d.ts.map

package/dist/lei.js

@@ -1,19 +1,9 @@
+import { mod97 } from "./_checksums/mod97.js";
 import { clean } from "./_util/clean.js";
 import { randomInt } from "./_util/generate.js";
 import { err } from "./_util/result.js";
 import { charValue, isalnum } from "./_util/strings.js";
-import { mod97 } from "./_checksums/mod97.js";
 //#region src/lei.ts
-/**
-* LEI (Legal Entity Identifier).
-*
-* ISO 17442. 20-character alphanumeric code
-* identifying legal entities in financial
-* transactions. Validated using ISO 7064
-* Mod 97-10 (same as IBAN).
-*
-* @see https://www.gleif.org/
-*/
 const compact = (value) => clean(value, " -").toUpperCase();
 const validate = (value) => {
 	const v = compact(value);
@@ -49,6 +39,7 @@ const generate = () => {
 };
 /** Legal Entity Identifier. */
 const lei = {
+	scope: "global",
 	name: "Legal Entity Identifier",
 	localName: "Legal Entity Identifier",
 	abbreviation: "LEI",

package/dist/lei.js.map

@@ -1 +1 @@
-{"version":3,"file":"lei.js","names":[],"sources":["../src/lei.ts"],"sourcesContent":["/**\n * LEI (Legal Entity Identifier).\n *\n * ISO 17442. 20-character alphanumeric code\n * identifying legal entities in financial\n * transactions. Validated using ISO 7064\n * Mod 97-10 (same as IBAN).\n *\n * @see https://www.gleif.org/\n */\n\nimport { mod97 } from \"#checksums/mod97\";\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { charValue, isalnum } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"./types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 20) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"LEI must be exactly 20 characters\",\n    );\n  }\n  if (!isalnum(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"LEI must contain only letters and digits\",\n    );\n  }\n  // Characters 5-18 must be alphanumeric (entity)\n  // Characters 19-20 are check digits (numeric)\n  const checkPart = v.slice(18);\n  if (!/^\\d{2}$/.test(checkPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"LEI check digits must be numeric\",\n    );\n  }\n  // Convert to numeric and validate mod 97\n  let numeric = \"\";\n  for (let i = 0; i < v.length; i++) {\n    const ch = v[i];\n    if (ch !== undefined) {\n      numeric += String(charValue(ch));\n    }\n  }\n  if (mod97(numeric) !== 1) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"LEI check digits are incorrect\",\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, 4)} ${v.slice(4, 8)} ${v.slice(8, 12)} ${v.slice(12, 16)} ${v.slice(16)}`;\n};\n\n/** Generate a random valid LEI. */\nconst generate = (): string => {\n  for (;;) {\n    let base = \"\";\n    for (let i = 0; i < 18; i++)\n      base += String(randomInt(0, 9));\n    for (let cd = 0; cd < 100; cd++) {\n      const c = base + String(cd).padStart(2, \"0\");\n      if (validate(c).valid) return c;\n    }\n  }\n};\n\n/** Legal Entity Identifier. */\nconst lei: Validator = {\n  name: \"Legal Entity Identifier\",\n  localName: \"Legal Entity Identifier\",\n  abbreviation: \"LEI\",\n  aliases: [\"LEI\", \"Legal Entity Identifier\"] as const,\n  candidatePattern: \"[A-Z0-9]{18}\\\\d{2}\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gleif.org/\",\n  examples: [\"5493006MHB84DD0ZWV18\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default lei;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,oCACD;AAEH,KAAI,CAAC,QAAQ,EAAE,CACb,QAAO,IACL,kBACA,2CACD;CAIH,MAAM,YAAY,EAAE,MAAM,GAAG;AAC7B,KAAI,CAAC,UAAU,KAAK,UAAU,CAC5B,QAAO,IACL,kBACA,mCACD;CAGH,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;EACjC,MAAM,KAAK,EAAE;AACb,MAAI,OAAO,KAAA,EACT,YAAW,OAAO,UAAU,GAAG,CAAC;;AAGpC,KAAI,MAAM,QAAQ,KAAK,EACrB,QAAO,IACL,oBACA,iCACD;AAEH,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,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI9F,MAAM,iBAAyB;AAC7B,UAAS;EACP,IAAI,OAAO;AACX,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,OAAO,UAAU,GAAG,EAAE,CAAC;AACjC,OAAK,IAAI,KAAK,GAAG,KAAK,KAAK,MAAM;GAC/B,MAAM,IAAI,OAAO,OAAO,GAAG,CAAC,SAAS,GAAG,IAAI;AAC5C,OAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;;AAMpC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,0BAA0B;CAC3C,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,uBAAuB;CAClC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"lei.js","names":[],"sources":["../src/lei.ts"],"sourcesContent":["/**\n * LEI (Legal Entity Identifier).\n *\n * ISO 17442. 20-character alphanumeric code\n * identifying legal entities in financial\n * transactions. Validated using ISO 7064\n * Mod 97-10 (same as IBAN).\n *\n * @see https://www.gleif.org/\n */\n\nimport type {\n  ValidateResult,\n  GlobalValidator,\n} from \"./types\";\n\nimport { mod97 } from \"#checksums/mod97\";\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { charValue, isalnum } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 20) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"LEI must be exactly 20 characters\",\n    );\n  }\n  if (!isalnum(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"LEI must contain only letters and digits\",\n    );\n  }\n  // Characters 5-18 must be alphanumeric (entity)\n  // Characters 19-20 are check digits (numeric)\n  const checkPart = v.slice(18);\n  if (!/^\\d{2}$/.test(checkPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"LEI check digits must be numeric\",\n    );\n  }\n  // Convert to numeric and validate mod 97\n  let numeric = \"\";\n  for (let i = 0; i < v.length; i++) {\n    const ch = v[i];\n    if (ch !== undefined) {\n      numeric += String(charValue(ch));\n    }\n  }\n  if (mod97(numeric) !== 1) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"LEI check digits are incorrect\",\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, 4)} ${v.slice(4, 8)} ${v.slice(8, 12)} ${v.slice(12, 16)} ${v.slice(16)}`;\n};\n\n/** Generate a random valid LEI. */\nconst generate = (): string => {\n  for (;;) {\n    let base = \"\";\n    for (let i = 0; i < 18; i++)\n      base += String(randomInt(0, 9));\n    for (let cd = 0; cd < 100; cd++) {\n      const c = base + String(cd).padStart(2, \"0\");\n      if (validate(c).valid) return c;\n    }\n  }\n};\n\n/** Legal Entity Identifier. */\nconst lei: GlobalValidator = {\n  scope: \"global\",\n  name: \"Legal Entity Identifier\",\n  localName: \"Legal Entity Identifier\",\n  abbreviation: \"LEI\",\n  aliases: [\"LEI\", \"Legal Entity Identifier\"] as const,\n  candidatePattern: \"[A-Z0-9]{18}\\\\d{2}\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gleif.org/\",\n  examples: [\"5493006MHB84DD0ZWV18\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default lei;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,mCACF;CAEF,IAAI,CAAC,QAAQ,CAAC,GACZ,OAAO,IACL,kBACA,0CACF;CAIF,MAAM,YAAY,EAAE,MAAM,EAAE;CAC5B,IAAI,CAAC,UAAU,KAAK,SAAS,GAC3B,OAAO,IACL,kBACA,kCACF;CAGF,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;EACjC,MAAM,KAAK,EAAE;EACb,IAAI,OAAO,KAAA,GACT,WAAW,OAAO,UAAU,EAAE,CAAC;CAEnC;CACA,IAAI,MAAM,OAAO,MAAM,GACrB,OAAO,IACL,oBACA,gCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AAC7F;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,IAAI,OAAO;EACX,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,QAAQ,OAAO,UAAU,GAAG,CAAC,CAAC;EAChC,KAAK,IAAI,KAAK,GAAG,KAAK,KAAK,MAAM;GAC/B,MAAM,IAAI,OAAO,OAAO,EAAE,EAAE,SAAS,GAAG,GAAG;GAC3C,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;EAChC;CACF;AACF;;AAGA,MAAM,MAAuB;CAC3B,OAAO;CACP,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,yBAAyB;CAC1C,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,sBAAsB;CACjC;CACA;CACA;CACA;AACF"}

package/dist/li/peid.d.ts

@@ -1,13 +1,22 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/li/peid.d.ts
 /** Generate a random valid Liechtenstein PEID. */
 declare const generate: () => string;
+/**
+ * PEID (Personenidentifikationsnummer).
+ *
+ * Liechtenstein tax code for individuals and entities.
+ * Numeric code of 4 to 12 digits, with leading zeros
+ * stripped during compaction.
+ *
+ * @see https://www.oera.li/
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Liechtenstein Person Identification Number. */
-declare const peid: Validator;
+declare const peid: CountryValidator<"LI">;
 //#endregion
 export { compact, peid as default, format, generate, validate };
 //# sourceMappingURL=peid.d.ts.map

package/dist/li/peid.js

@@ -3,15 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/li/peid.ts
-/**
-* PEID (Personenidentifikationsnummer).
-*
-* Liechtenstein tax code for individuals and entities.
-* Numeric code of 4 to 12 digits, with leading zeros
-* stripped during compaction.
-*
-* @see https://www.oera.li/
-*/
 /** Generate a random valid Liechtenstein PEID. */
 const generate = () => {
 	const len = randomInt(4, 12);
@@ -35,6 +26,7 @@ const peid = {
 	abbreviation: "PEID",
 	aliases: ["PEID", "Personenidentifikation"],
 	candidatePattern: "\\d{6}",
+	scope: "country",
 	country: "LI",
 	entityType: "any",
 	lengths: [

package/dist/li/peid.js.map

@@ -1 +1 @@
-{"version":3,"file":"peid.js","names":[],"sources":["../../src/li/peid.ts"],"sourcesContent":["/** Generate a random valid Liechtenstein PEID. */\nconst generate = (): string => {\n  const len = randomInt(4, 12);\n  const first = String(randomInt(1, 9));\n  return first + randomDigits(len - 1);\n};\n\n/**\n * PEID (Personenidentifikationsnummer).\n *\n * Liechtenstein tax code for individuals and entities.\n * Numeric code of 4 to 12 digits, with leading zeros\n * stripped during compaction.\n *\n * @see https://www.oera.li/\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, \" .\").replace(/^0+/, \"\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 4 || v.length > 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Liechtenstein PEID must be 4 to 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Liechtenstein PEID must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Liechtenstein Person Identification Number. */\nconst peid: Validator = {\n  name: \"Liechtenstein Person Identification Number\",\n  localName: \"Personenidentifikationsnummer\",\n  abbreviation: \"PEID\",\n  aliases: [\"PEID\", \"Personenidentifikation\"] as const,\n  candidatePattern: \"\\\\d{6}\",\n  country: \"LI\",\n  entityType: \"any\",\n  lengths: [4, 5, 6, 7, 8, 9, 10, 11, 12] as const,\n  sourceUrl: \"https://www.oera.li/\",\n  examples: [\"1234567\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default peid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,MAAM,UAAU,GAAG,GAAG;AAE5B,QADc,OAAO,UAAU,GAAG,EAAE,CAAC,GACtB,aAAa,MAAM,EAAE;;AAoBtC,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,QAAQ,OAAO,GAAG;AAEvC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,KAAK,EAAE,SAAS,GAC7B,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,yBAAyB;CAC3C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAI;EAAI;EAAG;CACvC,WAAW;CACX,UAAU,CAAC,UAAU;CACrB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"peid.js","names":[],"sources":["../../src/li/peid.ts"],"sourcesContent":["/** Generate a random valid Liechtenstein PEID. */\nconst generate = (): string => {\n  const len = randomInt(4, 12);\n  const first = String(randomInt(1, 9));\n  return first + randomDigits(len - 1);\n};\n\n/**\n * PEID (Personenidentifikationsnummer).\n *\n * Liechtenstein tax code for individuals and entities.\n * Numeric code of 4 to 12 digits, with leading zeros\n * stripped during compaction.\n *\n * @see https://www.oera.li/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" .\").replace(/^0+/, \"\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 4 || v.length > 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Liechtenstein PEID must be 4 to 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Liechtenstein PEID must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Liechtenstein Person Identification Number. */\nconst peid: CountryValidator<\"LI\"> = {\n  name: \"Liechtenstein Person Identification Number\",\n  localName: \"Personenidentifikationsnummer\",\n  abbreviation: \"PEID\",\n  aliases: [\"PEID\", \"Personenidentifikation\"] as const,\n  candidatePattern: \"\\\\d{6}\",\n  scope: \"country\",\n  country: \"LI\",\n  entityType: \"any\",\n  lengths: [4, 5, 6, 7, 8, 9, 10, 11, 12] as const,\n  sourceUrl: \"https://www.oera.li/\",\n  examples: [\"1234567\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default peid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,MAAM,UAAU,GAAG,EAAE;CAE3B,OADc,OAAO,UAAU,GAAG,CAAC,CACxB,IAAI,aAAa,MAAM,CAAC;AACrC;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,QAAQ,OAAO,EAAE;AAEtC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,SAAS,KAAK,EAAE,SAAS,IAC7B,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,6CACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,wBAAwB;CAC1C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAI;EAAI;CAAE;CACtC,WAAW;CACX,UAAU,CAAC,SAAS;CACpB;CACA;CACA;CACA;AACF"}

package/dist/lk/nic.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/lk/nic.d.ts
 declare const compact: (value: string) => string;
@@ -12,7 +12,7 @@ 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<ParsedPersonId>;
+declare const nic: CountryValidator<"LK", ParsedPersonId>;
 //#endregion
 export { compact, nic as default, format, generate, parse, validate };
 //# sourceMappingURL=nic.d.ts.map

package/dist/lk/nic.js

@@ -1,22 +1,9 @@
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.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";
 //#region src/lk/nic.ts
-/**
-* NIC (National Identity Card, ජාතික හැඳුනුම්පත).
-*
-* Sri Lankan personal identity number. Two formats:
-*   Old (pre-2016): 9 digits + V or X (10 chars)
-*   New (2016+):    12 digits
-*
-* Both encode birth date (day-of-year), gender, a
-* serial number, and a check digit.
-*
-* @see https://en.wikipedia.org/wiki/National_identification_number#Sri_Lanka
-* @see https://drp.gov.lk/Templates/Artical%20-%20English%20new%20number.html
-*/
 /** Old format: 9 digits + V or X (case-insensitive). */
 const OLD_RE = /^\d{9}[VvXx]$/;
 /** New format: exactly 12 digits. */
@@ -133,6 +120,7 @@ const nic = {
 	abbreviation: "NIC",
 	aliases: ["NIC", "ජාතික හැඳුනුම්පත"],
 	candidatePattern: "\\d{9}[VXvx]|\\d{12}",
+	scope: "country",
 	country: "LK",
 	entityType: "person",
 	description: "Sri Lankan personal identity number issued to all citizens",

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 { 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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"}
+{"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 type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\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\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: CountryValidator<\"LK\", ParsedPersonId> = {\n  name: \"National Identity Card\",\n  localName: \"ජාතික හැඳුනුම්පත\",\n  abbreviation: \"NIC\",\n  aliases: [\"NIC\", \"ජාතික හැඳුනුම්පත\"] as const,\n  candidatePattern: \"\\\\d{9}[VXvx]|\\\\d{12}\",\n  scope: \"country\",\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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/lt/asmens.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Lithuanian personal code. */
 declare const generate: () => string;
 /** Lithuanian Personal Code. */
-declare const asmens: Validator;
+declare const asmens: CountryValidator<"LT">;
 //#endregion
 export { compact, asmens as default, format, generate, validate };
 //# sourceMappingURL=asmens.d.ts.map

package/dist/lt/asmens.js

@@ -1,8 +1,8 @@
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { isValidDate } from "../_util/date.js";
 import { twoPassCheck } from "../ee/ik.js";
 //#region src/lt/asmens.ts
 /**
@@ -66,6 +66,7 @@ const asmens = {
 	abbreviation: "AK",
 	aliases: ["asmens kodas", "AK"],
 	candidatePattern: "[3-6]\\d{10}",
+	scope: "country",
 	country: "LT",
 	entityType: "person",
 	sourceUrl: "https://www.registrucentras.lt/",

package/dist/lt/asmens.js.map

@@ -1 +1 @@
-{"version":3,"file":"asmens.js","names":[],"sources":["../../src/lt/asmens.ts"],"sourcesContent":["/**\n * Asmens kodas (Personal Code).\n *\n * Lithuanian personal identification number. 11 digits\n * with the same structure as the Estonian Isikukood:\n * gender/century digit, YYMMDD, 3-digit serial, and\n * a two-pass weighted checksum.\n *\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/lithuania-tin.pdf\n * @see https://www.registrucentras.lt/\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport { twoPassCheck } from \"../ee/ik\";\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 !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Asmens kodas must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Asmens kodas must contain only digits\",\n    );\n  }\n\n  const g = Number(v[0]);\n  if (g < 1 || g > 9) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Asmens kodas gender/century digit is invalid\",\n    );\n  }\n\n  // Digit 9 indicates a special case where the birth\n  // date is not encoded; skip date validation.\n  if (g !== 9) {\n    const centuryMap: Record<number, number> = {\n      1: 1800,\n      2: 1800,\n      3: 1900,\n      4: 1900,\n      5: 2000,\n      6: 2000,\n      7: 2100,\n      8: 2100,\n    };\n    const century = centuryMap[g] ?? 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 = century + yy;\n\n    if (!isValidDate(year, mm, dd)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"Asmens kodas contains an invalid date\",\n      );\n    }\n  }\n\n  const check = twoPassCheck(v.slice(0, 10));\n  if (check !== Number(v[10])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Asmens kodas check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Lithuanian personal code. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(3, 6));\n    const yy = String(randomInt(0, 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 s = String(randomInt(0, 999)).padStart(3, \"0\");\n    const payload = g + yy + mm + dd + s;\n    const c = payload + String(twoPassCheck(payload));\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Lithuanian Personal Code. */\nconst asmens: Validator = {\n  name: \"Lithuanian Personal ID\",\n  localName: \"Asmens kodas\",\n  abbreviation: \"AK\",\n  aliases: [\"asmens kodas\", \"AK\"] as const,\n  candidatePattern: \"[3-6]\\\\d{10}\",\n  country: \"LT\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.registrucentras.lt/\",\n  examples: [\"33309240064\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default asmens;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,yCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,wCACD;CAGH,MAAM,IAAI,OAAO,EAAE,GAAG;AACtB,KAAI,IAAI,KAAK,IAAI,EACf,QAAO,IACL,qBACA,+CACD;AAKH,KAAI,MAAM,GAAG;EAWX,MAAM,UAVqC;GACzC,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACJ,CAC0B,MAAM;EACjC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;EAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;EAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAGhC,MAAI,CAAC,YAFQ,UAAU,IAEA,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,wCACD;;AAKL,KADc,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,KAC5B,OAAO,EAAE,IAAI,CACzB,QAAO,IACL,oBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,OAAO,UAAU,GAAG,EAAE,CAAC;EACjC,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,IAAI,OAAO,UAAU,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,UAAU,IAAI,KAAK,KAAK,KAAK;EACnC,MAAM,IAAI,UAAU,OAAO,aAAa,QAAQ,CAAC;AACjD,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,SAAoB;CACxB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,gBAAgB,KAAK;CAC/B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"asmens.js","names":[],"sources":["../../src/lt/asmens.ts"],"sourcesContent":["/**\n * Asmens kodas (Personal Code).\n *\n * Lithuanian personal identification number. 11 digits\n * with the same structure as the Estonian Isikukood:\n * gender/century digit, YYMMDD, 3-digit serial, and\n * a two-pass weighted checksum.\n *\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/lithuania-tin.pdf\n * @see https://www.registrucentras.lt/\n */\n\nimport { twoPassCheck } from \"../ee/ik\";\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Asmens kodas must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Asmens kodas must contain only digits\",\n    );\n  }\n\n  const g = Number(v[0]);\n  if (g < 1 || g > 9) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Asmens kodas gender/century digit is invalid\",\n    );\n  }\n\n  // Digit 9 indicates a special case where the birth\n  // date is not encoded; skip date validation.\n  if (g !== 9) {\n    const centuryMap: Record<number, number> = {\n      1: 1800,\n      2: 1800,\n      3: 1900,\n      4: 1900,\n      5: 2000,\n      6: 2000,\n      7: 2100,\n      8: 2100,\n    };\n    const century = centuryMap[g] ?? 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 = century + yy;\n\n    if (!isValidDate(year, mm, dd)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"Asmens kodas contains an invalid date\",\n      );\n    }\n  }\n\n  const check = twoPassCheck(v.slice(0, 10));\n  if (check !== Number(v[10])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Asmens kodas check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Lithuanian personal code. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(3, 6));\n    const yy = String(randomInt(0, 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 s = String(randomInt(0, 999)).padStart(3, \"0\");\n    const payload = g + yy + mm + dd + s;\n    const c = payload + String(twoPassCheck(payload));\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Lithuanian Personal Code. */\nconst asmens: CountryValidator<\"LT\"> = {\n  name: \"Lithuanian Personal ID\",\n  localName: \"Asmens kodas\",\n  abbreviation: \"AK\",\n  aliases: [\"asmens kodas\", \"AK\"] as const,\n  candidatePattern: \"[3-6]\\\\d{10}\",\n  scope: \"country\",\n  country: \"LT\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.registrucentras.lt/\",\n  examples: [\"33309240064\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default asmens;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,wCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,uCACF;CAGF,MAAM,IAAI,OAAO,EAAE,EAAE;CACrB,IAAI,IAAI,KAAK,IAAI,GACf,OAAO,IACL,qBACA,8CACF;CAKF,IAAI,MAAM,GAAG;EAWX,MAAM,UAAU;GATd,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;EAEoB,EAAE,MAAM;EACjC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;EAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;EAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;EAG/B,IAAI,CAAC,YAFQ,UAAU,IAEA,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,uCACF;CAEJ;CAGA,IADc,aAAa,EAAE,MAAM,GAAG,EAAE,CAChC,MAAM,OAAO,EAAE,GAAG,GACxB,OAAO,IACL,oBACA,yCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,OAAO,UAAU,GAAG,CAAC,CAAC;EAChC,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,IAAI,OAAO,UAAU,GAAG,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,UAAU,IAAI,KAAK,KAAK,KAAK;EACnC,MAAM,IAAI,UAAU,OAAO,aAAa,OAAO,CAAC;EAChD,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,SAAiC;CACrC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,gBAAgB,IAAI;CAC9B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/lt/vat.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/lt/vat.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Lithuanian VAT number. */
 declare const generate: () => string;
 /** Lithuanian VAT Number. */
-declare const vat: Validator;
+declare const vat: CountryValidator<"LT">;
 //#endregion
 export { compact, vat as default, format, generate, validate };
 //# sourceMappingURL=vat.d.ts.map

package/dist/lt/vat.js

@@ -3,16 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/lt/vat.ts
-/**
-* PVM kodas (Lithuanian VAT number).
-*
-* 9 or 12 digits. 9-digit: d[7] must be 1.
-* 12-digit: d[10] must be 1. Weighted checksum
-* with fallback weights.
-*
-* @see https://www.vatify.eu/lithuania-vat-number.html
-* @see https://www.vmi.lt/
-*/
 const compact = (value) => {
 	let v = clean(value, " -/.");
 	if (v.startsWith("LT") || v.startsWith("lt")) v = v.slice(2);
@@ -57,9 +47,11 @@ const vat = {
 	abbreviation: "PVM kodas",
 	aliases: ["PVM mokėtojo kodas", "PVM"],
 	candidatePattern: "LT\\d{9,12}",
+	scope: "country",
 	country: "LT",
 	entityType: "any",
 	sourceUrl: "https://www.vmi.lt/",
+	lengths: [9, 12],
 	examples: ["119511515", "100001919017"],
 	compact,
 	format,