@stll/stdnum 1.0.0 → 2.0.1

package/dist/cn/ric.js.map

@@ -1 +1 @@
-{"version":3,"file":"ric.js","names":[],"sources":["../../src/cn/ric.ts"],"sourcesContent":["/**\n * RIC (Resident Identity Card number, 居民身份证号码).\n *\n * Chinese national identifier. 18 characters:\n * 6 (area code) + 8 (YYYYMMDD birth) + 3 (sequence,\n * odd = male) + 1 (check, 0-9 or X).\n *\n * Also accepts the legacy 15-digit format (no check\n * digit, 2-digit year).\n *\n * @see https://en.wikipedia.org/wiki/Resident_Identity_Card\n */\n\nimport {\n  mod112checkChar,\n  mod112validate,\n} from \"#checksums/mod112\";\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 type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 15 && v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RIC must be 15 or 18 characters\",\n    );\n  }\n\n  if (v.length === 15) {\n    if (!isdigits(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"15-digit RIC must contain only digits\",\n      );\n    }\n    // Validate date: digits 6-11 are YYMMDD\n    const year = 1900 + Number(v.slice(6, 8));\n    const month = Number(v.slice(8, 10));\n    const day = Number(v.slice(10, 12));\n    if (!isValidDate(year, month, day)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"RIC contains an invalid birth date\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 18-character format\n  if (!isdigits(v.slice(0, 17))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC must contain only digits (plus check char)\",\n    );\n  }\n  // SAFETY: 18-character branch guarantees v[17] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  const lastChar = v[17]!;\n  if (!isdigits(lastChar) && lastChar !== \"X\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC check character must be 0-9 or X\",\n    );\n  }\n\n  // Validate date: digits 6-13 are YYYYMMDD\n  const year = Number(v.slice(6, 10));\n  const month = Number(v.slice(10, 12));\n  const day = Number(v.slice(12, 14));\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RIC contains an invalid birth date\",\n    );\n  }\n\n  if (!mod112validate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RIC check character does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an RIC number.\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\n  let year: number;\n  let month: number;\n  let day: number;\n  let seq: number;\n\n  if (v.length === 15) {\n    year = 1900 + Number(v.slice(6, 8));\n    month = Number(v.slice(8, 10));\n    day = Number(v.slice(10, 12));\n    seq = Number(v.slice(12, 15));\n  } else {\n    year = Number(v.slice(6, 10));\n    month = Number(v.slice(10, 12));\n    day = Number(v.slice(12, 14));\n    seq = Number(v.slice(14, 17));\n  }\n\n  const gender = seq % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, month - 1, day),\n    gender,\n  };\n};\n\n/** Generate a random valid 18-digit RIC. */\nconst generate = (): string => {\n  // Use a simple area code prefix\n  const area = String(randomInt(110000, 659999));\n  const year = randomInt(1950, 2005);\n  const month = randomInt(1, 12);\n  const day = randomInt(1, 28);\n  const seqNum = randomInt(1, 999);\n  const seq = String(seqNum).padStart(3, \"0\");\n\n  const yStr = String(year);\n  const mStr = String(month).padStart(2, \"0\");\n  const dStr = String(day).padStart(2, \"0\");\n\n  const payload = `${area}${yStr}${mStr}${dStr}${seq}`;\n  const check = mod112checkChar(payload);\n  return `${payload}${check}`;\n};\n\n/** Chinese Resident Identity Card number. */\nconst ric: Validator<ParsedPersonId> = {\n  name: \"Chinese Resident Identity Card\",\n  localName: \"居民身份证号码\",\n  abbreviation: \"RIC\",\n  aliases: [\"身份证\", \"居民身份证号码\", \"RIC\"] as const,\n  candidatePattern: \"\\\\d{17}[\\\\dX]\",\n  country: \"CN\",\n  entityType: \"person\",\n  description:\n    \"18-character national ID encoding area, birth date, gender, and check digit\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Resident_Identity_Card\",\n  lengths: [15, 18] as const,\n  examples: [\n    \"11010519491231002X\",\n    \"440524188001010014\",\n  ] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default ric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"ric.js","names":[],"sources":["../../src/cn/ric.ts"],"sourcesContent":["/**\n * RIC (Resident Identity Card number, 居民身份证号码).\n *\n * Chinese national identifier. 18 characters:\n * 6 (area code) + 8 (YYYYMMDD birth) + 3 (sequence,\n * odd = male) + 1 (check, 0-9 or X).\n *\n * Also accepts the legacy 15-digit format (no check\n * digit, 2-digit year).\n *\n * @see https://en.wikipedia.org/wiki/Resident_Identity_Card\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  mod112checkChar,\n  mod112validate,\n} from \"#checksums/mod112\";\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, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 15 && v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RIC must be 15 or 18 characters\",\n    );\n  }\n\n  if (v.length === 15) {\n    if (!isdigits(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"15-digit RIC must contain only digits\",\n      );\n    }\n    // Validate date: digits 6-11 are YYMMDD\n    const year = 1900 + Number(v.slice(6, 8));\n    const month = Number(v.slice(8, 10));\n    const day = Number(v.slice(10, 12));\n    if (!isValidDate(year, month, day)) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"RIC contains an invalid birth date\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 18-character format\n  if (!isdigits(v.slice(0, 17))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC must contain only digits (plus check char)\",\n    );\n  }\n  // SAFETY: 18-character branch guarantees v[17] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  const lastChar = v[17]!;\n  if (!isdigits(lastChar) && lastChar !== \"X\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RIC check character must be 0-9 or X\",\n    );\n  }\n\n  // Validate date: digits 6-13 are YYYYMMDD\n  const year = Number(v.slice(6, 10));\n  const month = Number(v.slice(10, 12));\n  const day = Number(v.slice(12, 14));\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RIC contains an invalid birth date\",\n    );\n  }\n\n  if (!mod112validate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RIC check character does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an RIC number.\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\n  let year: number;\n  let month: number;\n  let day: number;\n  let seq: number;\n\n  if (v.length === 15) {\n    year = 1900 + Number(v.slice(6, 8));\n    month = Number(v.slice(8, 10));\n    day = Number(v.slice(10, 12));\n    seq = Number(v.slice(12, 15));\n  } else {\n    year = Number(v.slice(6, 10));\n    month = Number(v.slice(10, 12));\n    day = Number(v.slice(12, 14));\n    seq = Number(v.slice(14, 17));\n  }\n\n  const gender = seq % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, month - 1, day),\n    gender,\n  };\n};\n\n/** Generate a random valid 18-digit RIC. */\nconst generate = (): string => {\n  // Use a simple area code prefix\n  const area = String(randomInt(110000, 659999));\n  const year = randomInt(1950, 2005);\n  const month = randomInt(1, 12);\n  const day = randomInt(1, 28);\n  const seqNum = randomInt(1, 999);\n  const seq = String(seqNum).padStart(3, \"0\");\n\n  const yStr = String(year);\n  const mStr = String(month).padStart(2, \"0\");\n  const dStr = String(day).padStart(2, \"0\");\n\n  const payload = `${area}${yStr}${mStr}${dStr}${seq}`;\n  const check = mod112checkChar(payload);\n  return `${payload}${check}`;\n};\n\n/** Chinese Resident Identity Card number. */\nconst ric: CountryValidator<\"CN\", ParsedPersonId> = {\n  name: \"Chinese Resident Identity Card\",\n  localName: \"居民身份证号码\",\n  abbreviation: \"RIC\",\n  aliases: [\"身份证\", \"居民身份证号码\", \"RIC\"] as const,\n  candidatePattern: \"\\\\d{17}[\\\\dX]\",\n  scope: \"country\",\n  country: \"CN\",\n  entityType: \"person\",\n  description:\n    \"18-character national ID encoding area, birth date, gender, and check digit\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Resident_Identity_Card\",\n  lengths: [15, 18] as const,\n  examples: [\n    \"11010519491231002X\",\n    \"440524188001010014\",\n  ] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default ric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/cn/uscc.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/cn/uscc.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid USCC. */
 declare const generate: () => string;
 /** Chinese Unified Social Credit Code. */
-declare const uscc: Validator;
+declare const uscc: CountryValidator<"CN">;
 //#endregion
 export { compact, uscc as default, format, generate, validate };
 //# sourceMappingURL=uscc.d.ts.map

package/dist/cn/uscc.js

@@ -3,16 +3,6 @@ import { randomChar, randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/cn/uscc.ts
-/**
-* USCC (Unified Social Credit Code, 统一社会信用代码).
-*
-* 18 alphanumeric characters (excluding I, O, Z, S, V):
-* 1 (registering authority) + 1 (entity type) +
-* 6 (region code, digits only) + 9 (organisation code) +
-* 1 (mod 31 check character).
-*
-* @see https://zh.wikipedia.org/wiki/统一社会信用代码
-*/
 const ALPHABET = "0123456789ABCDEFGHJKLMNPQRTUWXY";
 const WEIGHTS = [
 	1,
@@ -72,6 +62,7 @@ const uscc = {
 	abbreviation: "USCC",
 	aliases: ["统一社会信用代码", "USCC"],
 	candidatePattern: "[0-9A-HJ-NP-RTUW-Y]{2}\\d{6}[0-9A-HJ-NP-RTUW-Y]{10}",
+	scope: "country",
 	country: "CN",
 	entityType: "company",
 	description: "18-character tax/registration code for Chinese entities",

package/dist/cn/uscc.js.map

@@ -1 +1 @@
-{"version":3,"file":"uscc.js","names":[],"sources":["../../src/cn/uscc.ts"],"sourcesContent":["/**\n * USCC (Unified Social Credit Code, 统一社会信用代码).\n *\n * 18 alphanumeric characters (excluding I, O, Z, S, V):\n * 1 (registering authority) + 1 (entity type) +\n * 6 (region code, digits only) + 9 (organisation code) +\n * 1 (mod 31 check character).\n *\n * @see https://zh.wikipedia.org/wiki/统一社会信用代码\n */\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomChar,\n  randomDigits,\n  randomInt,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst ALPHABET = \"0123456789ABCDEFGHJKLMNPQRTUWXY\";\n\nconst WEIGHTS = [\n  1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10,\n  30, 28,\n] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst calcCheckChar = (value: string): string => {\n  let total = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    total += ALPHABET.indexOf(ch) * weight;\n  }\n  // SAFETY: (31 - total % 31) % 31 is in 0..30 and\n  // ALPHABET has 31 characters.\n  // eslint-disable-next-line no-non-null-assertion\n  return ALPHABET[(31 - (total % 31)) % 31]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"USCC must be 18 characters\",\n    );\n  }\n\n  for (const ch of v) {\n    if (!ALPHABET.includes(ch)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"USCC contains invalid character\",\n      );\n    }\n  }\n\n  if (!isdigits(v.slice(2, 8))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"USCC region code (positions 3-8) must be digits\",\n    );\n  }\n\n  if (v[17] !== calcCheckChar(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"USCC check character 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 USCC. */\nconst generate = (): string => {\n  // SAFETY: indices 1..9 are within ALPHABET (31 chars).\n  // eslint-disable-next-line no-non-null-assertion\n  const reg = ALPHABET[randomInt(1, 9)]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const etype = ALPHABET[randomInt(1, 9)]!;\n  const region = randomDigits(6);\n  let org = \"\";\n  for (let i = 0; i < 9; i++) {\n    org += randomChar(ALPHABET);\n  }\n  const payload = reg + etype + region + org;\n  return payload + calcCheckChar(payload);\n};\n\n/** Chinese Unified Social Credit Code. */\nconst uscc: Validator = {\n  name: \"Unified Social Credit Code\",\n  localName: \"统一社会信用代码\",\n  abbreviation: \"USCC\",\n  aliases: [\"统一社会信用代码\", \"USCC\"] as const,\n  candidatePattern:\n    \"[0-9A-HJ-NP-RTUW-Y]{2}\\\\d{6}[0-9A-HJ-NP-RTUW-Y]{10}\",\n  country: \"CN\",\n  entityType: \"company\",\n  description:\n    \"18-character tax/registration code for Chinese entities\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/统一社会信用代码\",\n  lengths: [18] as const,\n  examples: [\"91110000600037341L\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default uscc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAsBA,MAAM,WAAW;AAEjB,MAAM,UAAU;CACd;CAAG;CAAG;CAAG;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAI;CACpD;CAAI;CACL;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,iBAAiB,UAA0B;CAC/C,IAAI,QAAQ;AACZ,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,EAAE;EAC3C,MAAM,KAAK,MAAM;AACjB,MAAI,OAAO,KAAA,EAAW;AACtB,WAAS,SAAS,QAAQ,GAAG,GAAG;;AAKlC,QAAO,UAAU,KAAM,QAAQ,MAAO;;AAGxC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAGH,MAAK,MAAM,MAAM,EACf,KAAI,CAAC,SAAS,SAAS,GAAG,CACxB,QAAO,IACL,kBACA,kCACD;AAIL,KAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,kDACD;AAGH,KAAI,EAAE,QAAQ,cAAc,EAAE,CAC5B,QAAO,IACL,oBACA,sCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAG7B,MAAM,MAAM,SAAS,UAAU,GAAG,EAAE;CAEpC,MAAM,QAAQ,SAAS,UAAU,GAAG,EAAE;CACtC,MAAM,SAAS,aAAa,EAAE;CAC9B,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,WAAW,SAAS;CAE7B,MAAM,UAAU,MAAM,QAAQ,SAAS;AACvC,QAAO,UAAU,cAAc,QAAQ;;;AAIzC,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,YAAY,OAAO;CAC7B,kBACE;CACF,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,qBAAqB;CAChC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"uscc.js","names":[],"sources":["../../src/cn/uscc.ts"],"sourcesContent":["/**\n * USCC (Unified Social Credit Code, 统一社会信用代码).\n *\n * 18 alphanumeric characters (excluding I, O, Z, S, V):\n * 1 (registering authority) + 1 (entity type) +\n * 6 (region code, digits only) + 9 (organisation code) +\n * 1 (mod 31 check character).\n *\n * @see https://zh.wikipedia.org/wiki/统一社会信用代码\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport {\n  randomChar,\n  randomDigits,\n  randomInt,\n} from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst ALPHABET = \"0123456789ABCDEFGHJKLMNPQRTUWXY\";\n\nconst WEIGHTS = [\n  1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10,\n  30, 28,\n] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst calcCheckChar = (value: string): string => {\n  let total = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    total += ALPHABET.indexOf(ch) * weight;\n  }\n  // SAFETY: (31 - total % 31) % 31 is in 0..30 and\n  // ALPHABET has 31 characters.\n  // eslint-disable-next-line no-non-null-assertion\n  return ALPHABET[(31 - (total % 31)) % 31]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"USCC must be 18 characters\",\n    );\n  }\n\n  for (const ch of v) {\n    if (!ALPHABET.includes(ch)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"USCC contains invalid character\",\n      );\n    }\n  }\n\n  if (!isdigits(v.slice(2, 8))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"USCC region code (positions 3-8) must be digits\",\n    );\n  }\n\n  if (v[17] !== calcCheckChar(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"USCC check character 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 USCC. */\nconst generate = (): string => {\n  // SAFETY: indices 1..9 are within ALPHABET (31 chars).\n  // eslint-disable-next-line no-non-null-assertion\n  const reg = ALPHABET[randomInt(1, 9)]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const etype = ALPHABET[randomInt(1, 9)]!;\n  const region = randomDigits(6);\n  let org = \"\";\n  for (let i = 0; i < 9; i++) {\n    org += randomChar(ALPHABET);\n  }\n  const payload = reg + etype + region + org;\n  return payload + calcCheckChar(payload);\n};\n\n/** Chinese Unified Social Credit Code. */\nconst uscc: CountryValidator<\"CN\"> = {\n  name: \"Unified Social Credit Code\",\n  localName: \"统一社会信用代码\",\n  abbreviation: \"USCC\",\n  aliases: [\"统一社会信用代码\", \"USCC\"] as const,\n  candidatePattern:\n    \"[0-9A-HJ-NP-RTUW-Y]{2}\\\\d{6}[0-9A-HJ-NP-RTUW-Y]{10}\",\n  scope: \"country\",\n  country: \"CN\",\n  entityType: \"company\",\n  description:\n    \"18-character tax/registration code for Chinese entities\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/统一社会信用代码\",\n  lengths: [18] as const,\n  examples: [\"91110000600037341L\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default uscc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAyBA,MAAM,WAAW;AAEjB,MAAM,UAAU;CACd;CAAG;CAAG;CAAG;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAG;CAAI;CACpD;CAAI;AACN;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,iBAAiB,UAA0B;CAC/C,IAAI,QAAQ;CACZ,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GAAG;EAC3C,MAAM,KAAK,MAAM;EACjB,IAAI,OAAO,KAAA,GAAW;EACtB,SAAS,SAAS,QAAQ,EAAE,IAAI;CAClC;CAIA,OAAO,UAAU,KAAM,QAAQ,MAAO;AACxC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4BACF;CAGF,KAAK,MAAM,MAAM,GACf,IAAI,CAAC,SAAS,SAAS,EAAE,GACvB,OAAO,IACL,kBACA,iCACF;CAIJ,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GACzB,OAAO,IACL,kBACA,iDACF;CAGF,IAAI,EAAE,QAAQ,cAAc,CAAC,GAC3B,OAAO,IACL,oBACA,qCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAG7B,MAAM,MAAM,SAAS,UAAU,GAAG,CAAC;CAEnC,MAAM,QAAQ,SAAS,UAAU,GAAG,CAAC;CACrC,MAAM,SAAS,aAAa,CAAC;CAC7B,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,OAAO,WAAW,QAAQ;CAE5B,MAAM,UAAU,MAAM,QAAQ,SAAS;CACvC,OAAO,UAAU,cAAc,OAAO;AACxC;;AAGA,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,YAAY,MAAM;CAC5B,kBACE;CACF,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,oBAAoB;CAC/B;CACA;CACA;CACA;AACF"}

package/dist/co/nit.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/co/nit.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid NIT (10 digits). */
 declare const generate: () => string;
 /** Colombian tax identification number. */
-declare const nit: Validator;
+declare const nit: CountryValidator<"CO">;
 //#endregion
 export { compact, nit as default, format, generate, validate };
 //# sourceMappingURL=nit.d.ts.map

package/dist/co/nit.js

@@ -3,17 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/co/nit.ts
-/**
-* NIT (Número de Identificación Tributaria).
-*
-* Colombian tax identification number, also known as
-* RUT (Registro Unico Tributario). The last digit is
-* a check digit computed via a weighted sum mod 11
-* with weights [3,7,13,17,19,23,29,37,41,43,47,53,
-* 59,67,71] applied right-to-left.
-*
-* @see https://es.wikipedia.org/wiki/Número_de_identificación_tributaria
-*/
 const WEIGHTS = [
 	3,
 	7,
@@ -59,7 +48,7 @@ const validate = (value) => {
 	const v = compact(value);
 	if (v.length < 8 || v.length > 16) return err("INVALID_LENGTH", "NIT must be between 8 and 16 digits");
 	if (!isdigits(v)) return err("INVALID_FORMAT", "NIT must contain only digits");
-	if (calcCheckDigit(v.slice(0, -1)) !== Number(v[v.length - 1])) return err("INVALID_CHECKSUM", "NIT check digit does not match");
+	if (calcCheckDigit(v.slice(0, -1)) !== Number(v.at(-1))) return err("INVALID_CHECKSUM", "NIT check digit does not match");
 	return {
 		valid: true,
 		compact: v
@@ -85,6 +74,7 @@ const nit = {
 	abbreviation: "NIT",
 	aliases: ["NIT", "Número de Identificación Tributaria"],
 	candidatePattern: "\\d{9,10}-?\\d",
+	scope: "country",
 	country: "CO",
 	entityType: "any",
 	description: "Tax identifier issued by the DIAN",

package/dist/co/nit.js.map

@@ -1 +1 @@
-{"version":3,"file":"nit.js","names":[],"sources":["../../src/co/nit.ts"],"sourcesContent":["/**\n * NIT (Número de Identificación Tributaria).\n *\n * Colombian tax identification number, also known as\n * RUT (Registro Unico Tributario). The last digit is\n * a check digit computed via a weighted sum mod 11\n * with weights [3,7,13,17,19,23,29,37,41,43,47,53,\n * 59,67,71] applied right-to-left.\n *\n * @see https://es.wikipedia.org/wiki/Número_de_identificación_tributaria\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [\n  3, 7, 13, 17, 19, 23, 29, 37, 41, 43, 47, 53, 59, 67, 71,\n] as const;\n\n/** Lookup table: remainder -> check digit. */\nconst CHECK_DIGITS = [0, 1, 9, 8, 7, 6, 5, 4, 3, 2, 1];\n\nconst compact = (value: string): string =>\n  clean(value, \" -.,\");\n\nconst calcCheckDigit = (body: string): number => {\n  let sum = 0;\n  const len = body.length;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    if (i >= len) break;\n    sum += Number(body[len - 1 - i]) * weight;\n  }\n  // SAFETY: sum % 11 is in 0..10 and CHECK_DIGITS has\n  // 11 entries.\n  // eslint-disable-next-line no-non-null-assertion\n  return CHECK_DIGITS[sum % 11]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 8 || v.length > 16) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIT must be between 8 and 16 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIT must contain only digits\",\n    );\n  }\n\n  const body = v.slice(0, -1);\n  const check = calcCheckDigit(body);\n  if (check !== Number(v[v.length - 1])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIT 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  const body = v.slice(0, -1);\n  const checkChar = v.slice(-1);\n  const groups: string[] = [];\n  for (let i = body.length; i > 0; i -= 3) {\n    groups.unshift(body.slice(Math.max(0, i - 3), i));\n  }\n  return `${groups.join(\".\")}-${checkChar}`;\n};\n\n/** Generate a random valid NIT (10 digits). */\nconst generate = (): string => {\n  const body = randomDigits(9);\n  const check = calcCheckDigit(body);\n  return `${body}${check}`;\n};\n\n/** Colombian tax identification number. */\nconst nit: Validator = {\n  name: \"Número de Identificación Tributaria\",\n  localName: \"Número de Identificación Tributaria\",\n  abbreviation: \"NIT\",\n  aliases: [\n    \"NIT\",\n    \"Número de Identificación Tributaria\",\n  ] as const,\n  candidatePattern: \"\\\\d{9,10}-?\\\\d\",\n  country: \"CO\",\n  entityType: \"any\",\n  description: \"Tax identifier issued by the DIAN\",\n  sourceUrl:\n    \"https://es.wikipedia.org/wiki/N%C3%BAmero_de_identificaci%C3%B3n_tributaria\",\n  lengths: [8, 9, 10, 11, 12, 13, 14, 15, 16] as const,\n  examples: [\"2131234321\", \"8001234565\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nit;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,UAAU;CACd;CAAG;CAAG;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CACvD;;AAGD,MAAM,eAAe;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAEtD,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;AAEtB,MAAM,kBAAkB,SAAyB;CAC/C,IAAI,MAAM;CACV,MAAM,MAAM,KAAK;AACjB,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,EAAE;AAC3C,MAAI,KAAK,IAAK;AACd,SAAO,OAAO,KAAK,MAAM,IAAI,GAAG,GAAG;;AAKrC,QAAO,aAAa,MAAM;;AAG5B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,KAAK,EAAE,SAAS,GAC7B,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAKH,KADc,eADD,EAAE,MAAM,GAAG,GAAG,CACO,KACpB,OAAO,EAAE,EAAE,SAAS,GAAG,CACnC,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;CACxB,MAAM,OAAO,EAAE,MAAM,GAAG,GAAG;CAC3B,MAAM,YAAY,EAAE,MAAM,GAAG;CAC7B,MAAM,SAAmB,EAAE;AAC3B,MAAK,IAAI,IAAI,KAAK,QAAQ,IAAI,GAAG,KAAK,EACpC,QAAO,QAAQ,KAAK,MAAM,KAAK,IAAI,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC;AAEnD,QAAO,GAAG,OAAO,KAAK,IAAI,CAAC,GAAG;;;AAIhC,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,EAAE;AAE5B,QAAO,GAAG,OADI,eAAe,KAAK;;;AAKpC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,sCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aAAa;CACb,WACE;CACF,SAAS;EAAC;EAAG;EAAG;EAAI;EAAI;EAAI;EAAI;EAAI;EAAI;EAAG;CAC3C,UAAU,CAAC,cAAc,aAAa;CACtC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nit.js","names":[],"sources":["../../src/co/nit.ts"],"sourcesContent":["/**\n * NIT (Número de Identificación Tributaria).\n *\n * Colombian tax identification number, also known as\n * RUT (Registro Unico Tributario). The last digit is\n * a check digit computed via a weighted sum mod 11\n * with weights [3,7,13,17,19,23,29,37,41,43,47,53,\n * 59,67,71] applied right-to-left.\n *\n * @see https://es.wikipedia.org/wiki/Número_de_identificación_tributaria\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [\n  3, 7, 13, 17, 19, 23, 29, 37, 41, 43, 47, 53, 59, 67, 71,\n] as const;\n\n/** Lookup table: remainder -> check digit. */\nconst CHECK_DIGITS = [0, 1, 9, 8, 7, 6, 5, 4, 3, 2, 1];\n\nconst compact = (value: string): string =>\n  clean(value, \" -.,\");\n\nconst calcCheckDigit = (body: string): number => {\n  let sum = 0;\n  const len = body.length;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    if (i >= len) break;\n    sum += Number(body[len - 1 - i]) * weight;\n  }\n  // SAFETY: sum % 11 is in 0..10 and CHECK_DIGITS has\n  // 11 entries.\n  // eslint-disable-next-line no-non-null-assertion\n  return CHECK_DIGITS[sum % 11]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 8 || v.length > 16) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIT must be between 8 and 16 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIT must contain only digits\",\n    );\n  }\n\n  const body = v.slice(0, -1);\n  const check = calcCheckDigit(body);\n  if (check !== Number(v.at(-1))) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIT 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  const body = v.slice(0, -1);\n  const checkChar = v.slice(-1);\n  const groups: string[] = [];\n  for (let i = body.length; i > 0; i -= 3) {\n    groups.unshift(body.slice(Math.max(0, i - 3), i));\n  }\n  return `${groups.join(\".\")}-${checkChar}`;\n};\n\n/** Generate a random valid NIT (10 digits). */\nconst generate = (): string => {\n  const body = randomDigits(9);\n  const check = calcCheckDigit(body);\n  return `${body}${check}`;\n};\n\n/** Colombian tax identification number. */\nconst nit: CountryValidator<\"CO\"> = {\n  name: \"Número de Identificación Tributaria\",\n  localName: \"Número de Identificación Tributaria\",\n  abbreviation: \"NIT\",\n  aliases: [\n    \"NIT\",\n    \"Número de Identificación Tributaria\",\n  ] as const,\n  candidatePattern: \"\\\\d{9,10}-?\\\\d\",\n  scope: \"country\",\n  country: \"CO\",\n  entityType: \"any\",\n  description: \"Tax identifier issued by the DIAN\",\n  sourceUrl:\n    \"https://es.wikipedia.org/wiki/N%C3%BAmero_de_identificaci%C3%B3n_tributaria\",\n  lengths: [8, 9, 10, 11, 12, 13, 14, 15, 16] as const,\n  examples: [\"2131234321\", \"8001234565\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nit;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AAsBA,MAAM,UAAU;CACd;CAAG;CAAG;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AACxD;;AAGA,MAAM,eAAe;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAErD,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,kBAAkB,SAAyB;CAC/C,IAAI,MAAM;CACV,MAAM,MAAM,KAAK;CACjB,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GAAG;EAC3C,IAAI,KAAK,KAAK;EACd,OAAO,OAAO,KAAK,MAAM,IAAI,EAAE,IAAI;CACrC;CAIA,OAAO,aAAa,MAAM;AAC5B;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,SAAS,KAAK,EAAE,SAAS,IAC7B,OAAO,IACL,kBACA,qCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAKF,IADc,eADD,EAAE,MAAM,GAAG,EACQ,CACxB,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,GAC3B,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE;CAC1B,MAAM,YAAY,EAAE,MAAM,EAAE;CAC5B,MAAM,SAAmB,CAAC;CAC1B,KAAK,IAAI,IAAI,KAAK,QAAQ,IAAI,GAAG,KAAK,GACpC,OAAO,QAAQ,KAAK,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;CAElD,OAAO,GAAG,OAAO,KAAK,GAAG,EAAE,GAAG;AAChC;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,CAAC;CAE3B,OAAO,GAAG,OADI,eAAe,IACR;AACvB;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,qCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aAAa;CACb,WACE;CACF,SAAS;EAAC;EAAG;EAAG;EAAI;EAAI;EAAI;EAAI;EAAI;EAAI;CAAE;CAC1C,UAAU,CAAC,cAAc,YAAY;CACrC;CACA;CACA;CACA;AACF"}

package/dist/cr/cpf.d.ts

@@ -1,8 +1,24 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/cr/cpf.d.ts
 /** Generate a random valid Costa Rican CPF. */
 declare const generate: () => string;
+/**
+ * CPF (Cédula de Persona Física, Costa Rican
+ * physical person ID number).
+ *
+ * 10 digits: 0P-TTTT-AAAA where:
+ *   - 0 = fixed leading zero
+ *   - P = province digit
+ *   - TTTT = volume (tomo), zero-padded
+ *   - AAAA = entry (asiento), zero-padded
+ *
+ * No check digit; validation is by format only.
+ *
+ * Ported from python-stdnum cr.cpf module.
+ *
+ * @see https://www.tse.go.cr/
+ */
 /**
  * Compact: strip spaces, pad hyphen-separated parts
  * (2-4-4), join, and prepend '0' if 9 digits.
@@ -15,7 +31,7 @@ declare const format: (value: string) => string;
  *
  * Examples sourced from python-stdnum test suite.
  */
-declare const cpf: Validator;
+declare const cpf: CountryValidator<"CR">;
 //#endregion
 export { compact, cpf as default, format, generate, validate };
 //# sourceMappingURL=cpf.d.ts.map

package/dist/cr/cpf.js

@@ -2,22 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/cr/cpf.ts
-/**
-* CPF (Cédula de Persona Física, Costa Rican
-* physical person ID number).
-*
-* 10 digits: 0P-TTTT-AAAA where:
-*   - 0 = fixed leading zero
-*   - P = province digit
-*   - TTTT = volume (tomo), zero-padded
-*   - AAAA = entry (asiento), zero-padded
-*
-* No check digit; validation is by format only.
-*
-* Ported from python-stdnum cr.cpf module.
-*
-* @see https://www.tse.go.cr/
-*/
 /** Generate a random valid Costa Rican CPF. */
 const generate = () => {
 	return `0${String(randomInt(1, 9))}${randomDigits(4)}${randomDigits(4)}`;
@@ -64,6 +48,7 @@ const cpf = {
 	abbreviation: "CPF",
 	aliases: ["CPF", "cédula de persona física"],
 	candidatePattern: "\\d{9,12}",
+	scope: "country",
 	country: "CR",
 	entityType: "person",
 	lengths: [10],

package/dist/cr/cpf.js.map

@@ -1 +1 @@
-{"version":3,"file":"cpf.js","names":[],"sources":["../../src/cr/cpf.ts"],"sourcesContent":["/** Generate a random valid Costa Rican CPF. */\nconst generate = (): string => {\n  const province = String(randomInt(1, 9));\n  const volume = randomDigits(4);\n  const entry = randomDigits(4);\n  return `0${province}${volume}${entry}`;\n};\n\n/**\n * CPF (Cédula de Persona Física, Costa Rican\n * physical person ID number).\n *\n * 10 digits: 0P-TTTT-AAAA where:\n *   - 0 = fixed leading zero\n *   - P = province digit\n *   - TTTT = volume (tomo), zero-padded\n *   - AAAA = entry (asiento), zero-padded\n *\n * No check digit; validation is by format only.\n *\n * Ported from python-stdnum cr.cpf module.\n *\n * @see https://www.tse.go.cr/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Compact: strip spaces, pad hyphen-separated parts\n * (2-4-4), join, and prepend '0' if 9 digits.\n */\nconst compact = (value: string): string => {\n  let number = clean(value, \" \").trim().toUpperCase();\n\n  const parts = number.split(\"-\");\n  if (parts.length === 3) {\n    const [raw0, raw1, raw2] = parts;\n    const p0 = (raw0 ?? \"\").padStart(2, \"0\");\n    const p1 = (raw1 ?? \"\").padStart(4, \"0\");\n    const p2 = (raw2 ?? \"\").padStart(4, \"0\");\n    number = p0 + p1 + p2;\n  } else {\n    number = number.replaceAll(\"-\", \"\");\n  }\n\n  if (number.length === 9) {\n    number = \"0\" + number;\n  }\n\n  return number;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Costa Rican CPF must be 10 digits\",\n    );\n  }\n\n  if (!/^\\d{10}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Costa Rican CPF must contain only digits\",\n    );\n  }\n\n  if (v[0] !== \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Costa Rican CPF must start with 0\",\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, 2)}-${v.slice(2, 6)}-${v.slice(6, 10)}`;\n};\n\n/**\n * Costa Rican physical person ID number (CPF).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst cpf: Validator = {\n  name: \"Costa Rican Physical Person ID\",\n  localName: \"Cédula de Persona Física\",\n  abbreviation: \"CPF\",\n  aliases: [\"CPF\", \"cédula de persona física\"] as const,\n  candidatePattern: \"\\\\d{9,12}\",\n  country: \"CR\",\n  entityType: \"person\",\n  lengths: [10] as const,\n  examples: [\"0304550175\", \"0109130259\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.tse.go.cr/\",\n  generate,\n};\n\nexport default cpf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;AAI7B,QAAO,IAHU,OAAO,UAAU,GAAG,EAAE,CAAC,GACzB,aAAa,EAAE,GAChB,aAAa,EAAE;;;;;;AA+B/B,MAAM,WAAW,UAA0B;CACzC,IAAI,SAAS,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa;CAEnD,MAAM,QAAQ,OAAO,MAAM,IAAI;AAC/B,KAAI,MAAM,WAAW,GAAG;EACtB,MAAM,CAAC,MAAM,MAAM,QAAQ;EAC3B,MAAM,MAAM,QAAQ,IAAI,SAAS,GAAG,IAAI;EACxC,MAAM,MAAM,QAAQ,IAAI,SAAS,GAAG,IAAI;EACxC,MAAM,MAAM,QAAQ,IAAI,SAAS,GAAG,IAAI;AACxC,WAAS,KAAK,KAAK;OAEnB,UAAS,OAAO,WAAW,KAAK,GAAG;AAGrC,KAAI,OAAO,WAAW,EACpB,UAAS,MAAM;AAGjB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,oCACD;AAGH,KAAI,CAAC,WAAW,KAAK,EAAE,CACrB,QAAO,IACL,kBACA,2CACD;AAGH,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,oCACD;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;;;;;;;AAQ5D,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,2BAA2B;CAC5C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,cAAc,aAAa;CACtC;CACA;CACA;CACA,WAAW;CACX;CACD"}
+{"version":3,"file":"cpf.js","names":[],"sources":["../../src/cr/cpf.ts"],"sourcesContent":["/** Generate a random valid Costa Rican CPF. */\nconst generate = (): string => {\n  const province = String(randomInt(1, 9));\n  const volume = randomDigits(4);\n  const entry = randomDigits(4);\n  return `0${province}${volume}${entry}`;\n};\n\n/**\n * CPF (Cédula de Persona Física, Costa Rican\n * physical person ID number).\n *\n * 10 digits: 0P-TTTT-AAAA where:\n *   - 0 = fixed leading zero\n *   - P = province digit\n *   - TTTT = volume (tomo), zero-padded\n *   - AAAA = entry (asiento), zero-padded\n *\n * No check digit; validation is by format only.\n *\n * Ported from python-stdnum cr.cpf module.\n *\n * @see https://www.tse.go.cr/\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\";\n\n/**\n * Compact: strip spaces, pad hyphen-separated parts\n * (2-4-4), join, and prepend '0' if 9 digits.\n */\nconst compact = (value: string): string => {\n  let number = clean(value, \" \").trim().toUpperCase();\n\n  const parts = number.split(\"-\");\n  if (parts.length === 3) {\n    const [raw0, raw1, raw2] = parts;\n    const p0 = (raw0 ?? \"\").padStart(2, \"0\");\n    const p1 = (raw1 ?? \"\").padStart(4, \"0\");\n    const p2 = (raw2 ?? \"\").padStart(4, \"0\");\n    number = p0 + p1 + p2;\n  } else {\n    number = number.replaceAll(\"-\", \"\");\n  }\n\n  if (number.length === 9) {\n    number = \"0\" + number;\n  }\n\n  return number;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Costa Rican CPF must be 10 digits\",\n    );\n  }\n\n  if (!/^\\d{10}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Costa Rican CPF must contain only digits\",\n    );\n  }\n\n  if (v[0] !== \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Costa Rican CPF must start with 0\",\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, 2)}-${v.slice(2, 6)}-${v.slice(6, 10)}`;\n};\n\n/**\n * Costa Rican physical person ID number (CPF).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst cpf: CountryValidator<\"CR\"> = {\n  name: \"Costa Rican Physical Person ID\",\n  localName: \"Cédula de Persona Física\",\n  abbreviation: \"CPF\",\n  aliases: [\"CPF\", \"cédula de persona física\"] as const,\n  candidatePattern: \"\\\\d{9,12}\",\n  scope: \"country\",\n  country: \"CR\",\n  entityType: \"person\",\n  lengths: [10] as const,\n  examples: [\"0304550175\", \"0109130259\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.tse.go.cr/\",\n  generate,\n};\n\nexport default cpf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AACA,MAAM,iBAAyB;CAI7B,OAAO,IAHU,OAAO,UAAU,GAAG,CAAC,CAGpB,IAFH,aAAa,CAED,IADb,aAAa,CACQ;AACrC;;;;;AAgCA,MAAM,WAAW,UAA0B;CACzC,IAAI,SAAS,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,YAAY;CAElD,MAAM,QAAQ,OAAO,MAAM,GAAG;CAC9B,IAAI,MAAM,WAAW,GAAG;EACtB,MAAM,CAAC,MAAM,MAAM,QAAQ;EAC3B,MAAM,MAAM,QAAQ,IAAI,SAAS,GAAG,GAAG;EACvC,MAAM,MAAM,QAAQ,IAAI,SAAS,GAAG,GAAG;EACvC,MAAM,MAAM,QAAQ,IAAI,SAAS,GAAG,GAAG;EACvC,SAAS,KAAK,KAAK;CACrB,OACE,SAAS,OAAO,WAAW,KAAK,EAAE;CAGpC,IAAI,OAAO,WAAW,GACpB,SAAS,MAAM;CAGjB,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,mCACF;CAGF,IAAI,CAAC,WAAW,KAAK,CAAC,GACpB,OAAO,IACL,kBACA,0CACF;CAGF,IAAI,EAAE,OAAO,KACX,OAAO,IACL,qBACA,mCACF;CAGF,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;AAC3D;;;;;;AAOA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,0BAA0B;CAC3C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc,YAAY;CACrC;CACA;CACA;CACA,WAAW;CACX;AACF"}

package/dist/creditcard.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "./types.js";
+import { GlobalValidator, ValidateResult } from "./types.js";
 
 //#region src/creditcard.d.ts
 /**
@@ -18,7 +18,7 @@ declare const format: (value: string) => string;
  */
 declare const detectNetwork: (value: string) => CardNetwork | null;
 /** Credit Card Number (Luhn). */
-declare const creditCard: Validator;
+declare const creditCard: GlobalValidator;
 //#endregion
 export { type CardNetwork, compact, creditCard as default, detectNetwork, format, validate };
 //# sourceMappingURL=creditcard.d.ts.map

package/dist/creditcard.js

@@ -1,19 +1,9 @@
+import { luhnChecksum, luhnValidate } from "./_checksums/luhn.js";
 import { clean } from "./_util/clean.js";
 import { randomDigits, randomInt } from "./_util/generate.js";
 import { err } from "./_util/result.js";
-import { luhnChecksum, luhnValidate } from "./_checksums/luhn.js";
 import { isdigits } from "./_util/strings.js";
 //#region src/creditcard.ts
-/**
-* Credit card number validation (Luhn algorithm).
-*
-* Validates card numbers using the Luhn checksum
-* (ISO/IEC 7812-1). Supports Visa, Mastercard,
-* Amex, Discover, and other networks (13-19
-* digits).
-*
-* @see https://www.iso.org/standard/70484.html
-*/
 const compact = (value) => clean(value, " -.");
 const validate = (value) => {
 	const v = compact(value);
@@ -32,7 +22,7 @@ const format = (value) => {
 	for (let i = 0; i < v.length; i += 4) groups.push(v.slice(i, i + 4));
 	return groups.join(" ");
 };
-const MAESTRO_PREFIXES = [
+const MAESTRO_PREFIXES = new Set([
 	5018,
 	5020,
 	5038,
@@ -42,7 +32,7 @@ const MAESTRO_PREFIXES = [
 	6761,
 	6762,
 	6763
-];
+]);
 /**
 * Detect the card network from the BIN/IIN prefix.
 *
@@ -63,7 +53,7 @@ const detectNetwork = (value) => {
 	if (d3 >= 300 && d3 <= 305) return "diners";
 	if (d4 >= 3528 && d4 <= 3589) return "jcb";
 	if (v[0] === "4") return "visa";
-	if (MAESTRO_PREFIXES.includes(d4)) return "maestro";
+	if (MAESTRO_PREFIXES.has(d4)) return "maestro";
 	if (d2 >= 51 && d2 <= 55) return "mastercard";
 	if (d4 >= 2221 && d4 <= 2720) return "mastercard";
 	if (d4 === 6011) return "discover";
@@ -97,6 +87,7 @@ const generate = () => {
 };
 /** Credit Card Number (Luhn). */
 const creditCard = {
+	scope: "global",
 	name: "Credit Card Number",
 	localName: "Credit Card Number",
 	abbreviation: "CC",

package/dist/creditcard.js.map

@@ -1 +1 @@
-{"version":3,"file":"creditcard.js","names":[],"sources":["../src/creditcard.ts"],"sourcesContent":["/**\n * Credit card number validation (Luhn algorithm).\n *\n * Validates card numbers using the Luhn checksum\n * (ISO/IEC 7812-1). Supports Visa, Mastercard,\n * Amex, Discover, and other networks (13-19\n * digits).\n *\n * @see https://www.iso.org/standard/70484.html\n */\n\nimport {\n  luhnChecksum,\n  luhnValidate,\n} from \"#checksums/luhn\";\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\n/**\n * Card network identifiers returned by\n * {@link detectNetwork}.\n */\ntype CardNetwork =\n  | \"visa\"\n  | \"mastercard\"\n  | \"amex\"\n  | \"discover\"\n  | \"diners\"\n  | \"jcb\"\n  | \"unionpay\"\n  | \"maestro\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 13 || v.length > 19) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Credit card number must be 13-19 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Credit card number must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Credit card number fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  // Amex: 4-6-5 grouping\n  if (v.length === 15 && v[0] === \"3\") {\n    return `${v.slice(0, 4)} ${v.slice(4, 10)} ${v.slice(10)}`;\n  }\n  // Standard: groups of 4\n  const groups: string[] = [];\n  for (let i = 0; i < v.length; i += 4) {\n    groups.push(v.slice(i, i + 4));\n  }\n  return groups.join(\" \");\n};\n\nconst MAESTRO_PREFIXES: readonly number[] = [\n  5018, 5020, 5038, 5893, 6304, 6759, 6761, 6762, 6763,\n];\n\n/**\n * Detect the card network from the BIN/IIN prefix.\n *\n * Accepts both formatted (\"4111 1111 1111 1111\")\n * and compact (\"4111111111111111\") inputs.\n * Returns null for unrecognized prefixes.\n */\nconst detectNetwork = (\n  value: string,\n): CardNetwork | null => {\n  const v = compact(value);\n  if (v.length === 0) return null;\n  if (!isdigits(v)) return null;\n\n  const d2 = Number(v.slice(0, 2));\n  const d3 = Number(v.slice(0, 3));\n  const d4 = Number(v.slice(0, 4));\n  const d6 = Number(v.slice(0, 6));\n\n  // Amex: 34, 37\n  if (d2 === 34 || d2 === 37) return \"amex\";\n\n  // Diners Club: 300-305, 36, 38\n  if (d2 === 36 || d2 === 38) return \"diners\";\n  if (d3 >= 300 && d3 <= 305) return \"diners\";\n\n  // JCB: 3528-3589\n  if (d4 >= 3528 && d4 <= 3589) return \"jcb\";\n\n  // Visa: starts with 4\n  if (v[0] === \"4\") return \"visa\";\n\n  // Maestro (check before Mastercard; some share\n  // the 50xx prefix space)\n  if (MAESTRO_PREFIXES.includes(d4)) return \"maestro\";\n\n  // Mastercard: 51-55 or 2221-2720\n  if (d2 >= 51 && d2 <= 55) return \"mastercard\";\n  if (d4 >= 2221 && d4 <= 2720) return \"mastercard\";\n\n  // Discover: 6011, 622126-622925, 644-649, 65\n  if (d4 === 6011) return \"discover\";\n  if (d6 >= 622126 && d6 <= 622925) return \"discover\";\n  if (d3 >= 644 && d3 <= 649) return \"discover\";\n  if (d2 === 65) return \"discover\";\n\n  // UnionPay: starts with 62 (excluding Discover\n  // ranges already matched above)\n  if (d2 === 62) return \"unionpay\";\n\n  return null;\n};\n\n/**\n * Visa/Mastercard IIN prefixes. Each entry is\n * [prefix, totalLength].\n */\nconst CARD_PREFIXES = [\n  [\"4\", 16], // Visa\n  [\"51\", 16], // Mastercard\n  [\"52\", 16], // Mastercard\n  [\"53\", 16], // Mastercard\n  [\"54\", 16], // Mastercard\n  [\"55\", 16], // Mastercard\n] as const;\n\n/**\n * Generate a random valid Visa or Mastercard\n * number (16 digits, Luhn-valid).\n */\nconst generate = (): string => {\n  const idx = randomInt(0, CARD_PREFIXES.length - 1);\n  const [prefix, length] = CARD_PREFIXES[\n    idx\n  ] as (typeof CARD_PREFIXES)[number];\n  const remaining = length - prefix.length - 1;\n  const payload = `${prefix}${randomDigits(remaining)}`;\n  const partial = `${payload}0`;\n  const remainder = luhnChecksum(partial);\n  const check = (10 - remainder) % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Credit Card Number (Luhn). */\nconst creditCard: Validator = {\n  name: \"Credit Card Number\",\n  localName: \"Credit Card Number\",\n  abbreviation: \"CC\",\n  aliases: [\n    \"credit card\",\n    \"card number\",\n    \"kreditní karta\",\n    \"Kreditkarte\",\n  ] as const,\n  candidatePattern: \"(?:\\\\d[\\\\s-]?){13,19}\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.iso.org/standard/70484.html\",\n  examples: [\n    \"4111111111111111\",\n    \"5500000000000004\",\n  ] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default creditCard;\nexport { compact, detectNetwork, format, validate };\nexport type { CardNetwork };\n"],"mappings":";;;;;;;;;;;;;;;;AAoCA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,MAAM,EAAE,SAAS,GAC9B,QAAO,IACL,kBACA,0CACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,sCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,MAAM,EAAE,OAAO,IAC9B,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;CAG1D,MAAM,SAAmB,EAAE;AAC3B,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,EACjC,QAAO,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;AAEhC,QAAO,OAAO,KAAK,IAAI;;AAGzB,MAAM,mBAAsC;CAC1C;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CACjD;;;;;;;;AASD,MAAM,iBACJ,UACuB;CACvB,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EAAG,QAAO;AAC3B,KAAI,CAAC,SAAS,EAAE,CAAE,QAAO;CAEzB,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,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAGhC,KAAI,OAAO,MAAM,OAAO,GAAI,QAAO;AAGnC,KAAI,OAAO,MAAM,OAAO,GAAI,QAAO;AACnC,KAAI,MAAM,OAAO,MAAM,IAAK,QAAO;AAGnC,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AAGrC,KAAI,EAAE,OAAO,IAAK,QAAO;AAIzB,KAAI,iBAAiB,SAAS,GAAG,CAAE,QAAO;AAG1C,KAAI,MAAM,MAAM,MAAM,GAAI,QAAO;AACjC,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AAGrC,KAAI,OAAO,KAAM,QAAO;AACxB,KAAI,MAAM,UAAU,MAAM,OAAQ,QAAO;AACzC,KAAI,MAAM,OAAO,MAAM,IAAK,QAAO;AACnC,KAAI,OAAO,GAAI,QAAO;AAItB,KAAI,OAAO,GAAI,QAAO;AAEtB,QAAO;;;;;;AAOT,MAAM,gBAAgB;CACpB,CAAC,KAAK,GAAG;CACT,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACX;;;;;AAMD,MAAM,iBAAyB;CAE7B,MAAM,CAAC,QAAQ,UAAU,cADb,UAAU,GAAG,cAAc,SAAS,EAAE;CAKlD,MAAM,UAAU,GAAG,SAAS,aADV,SAAS,OAAO,SAAS,EACQ;CAGnD,MAAM,SAAS,KADG,aADF,GAAG,QAAQ,GACY,IACN;AACjC,QAAO,GAAG,UAAU,OAAO,MAAM;;;AAInC,MAAM,aAAwB;CAC5B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CACR,oBACA,mBACD;CACD;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"creditcard.js","names":[],"sources":["../src/creditcard.ts"],"sourcesContent":["/**\n * Credit card number validation (Luhn algorithm).\n *\n * Validates card numbers using the Luhn checksum\n * (ISO/IEC 7812-1). Supports Visa, Mastercard,\n * Amex, Discover, and other networks (13-19\n * digits).\n *\n * @see https://www.iso.org/standard/70484.html\n */\n\nimport type {\n  ValidateResult,\n  GlobalValidator,\n} from \"./types\";\n\nimport {\n  luhnChecksum,\n  luhnValidate,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/**\n * Card network identifiers returned by\n * {@link detectNetwork}.\n */\ntype CardNetwork =\n  | \"visa\"\n  | \"mastercard\"\n  | \"amex\"\n  | \"discover\"\n  | \"diners\"\n  | \"jcb\"\n  | \"unionpay\"\n  | \"maestro\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 13 || v.length > 19) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Credit card number must be 13-19 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Credit card number must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Credit card number fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  // Amex: 4-6-5 grouping\n  if (v.length === 15 && v[0] === \"3\") {\n    return `${v.slice(0, 4)} ${v.slice(4, 10)} ${v.slice(10)}`;\n  }\n  // Standard: groups of 4\n  const groups: string[] = [];\n  for (let i = 0; i < v.length; i += 4) {\n    groups.push(v.slice(i, i + 4));\n  }\n  return groups.join(\" \");\n};\n\nconst MAESTRO_PREFIXES = new Set([\n  5018, 5020, 5038, 5893, 6304, 6759, 6761, 6762, 6763,\n]);\n\n/**\n * Detect the card network from the BIN/IIN prefix.\n *\n * Accepts both formatted (\"4111 1111 1111 1111\")\n * and compact (\"4111111111111111\") inputs.\n * Returns null for unrecognized prefixes.\n */\nconst detectNetwork = (\n  value: string,\n): CardNetwork | null => {\n  const v = compact(value);\n  if (v.length === 0) return null;\n  if (!isdigits(v)) return null;\n\n  const d2 = Number(v.slice(0, 2));\n  const d3 = Number(v.slice(0, 3));\n  const d4 = Number(v.slice(0, 4));\n  const d6 = Number(v.slice(0, 6));\n\n  // Amex: 34, 37\n  if (d2 === 34 || d2 === 37) return \"amex\";\n\n  // Diners Club: 300-305, 36, 38\n  if (d2 === 36 || d2 === 38) return \"diners\";\n  if (d3 >= 300 && d3 <= 305) return \"diners\";\n\n  // JCB: 3528-3589\n  if (d4 >= 3528 && d4 <= 3589) return \"jcb\";\n\n  // Visa: starts with 4\n  if (v[0] === \"4\") return \"visa\";\n\n  // Maestro (check before Mastercard; some share\n  // the 50xx prefix space)\n  if (MAESTRO_PREFIXES.has(d4)) return \"maestro\";\n\n  // Mastercard: 51-55 or 2221-2720\n  if (d2 >= 51 && d2 <= 55) return \"mastercard\";\n  if (d4 >= 2221 && d4 <= 2720) return \"mastercard\";\n\n  // Discover: 6011, 622126-622925, 644-649, 65\n  if (d4 === 6011) return \"discover\";\n  if (d6 >= 622126 && d6 <= 622925) return \"discover\";\n  if (d3 >= 644 && d3 <= 649) return \"discover\";\n  if (d2 === 65) return \"discover\";\n\n  // UnionPay: starts with 62 (excluding Discover\n  // ranges already matched above)\n  if (d2 === 62) return \"unionpay\";\n\n  return null;\n};\n\n/**\n * Visa/Mastercard IIN prefixes. Each entry is\n * [prefix, totalLength].\n */\nconst CARD_PREFIXES = [\n  [\"4\", 16], // Visa\n  [\"51\", 16], // Mastercard\n  [\"52\", 16], // Mastercard\n  [\"53\", 16], // Mastercard\n  [\"54\", 16], // Mastercard\n  [\"55\", 16], // Mastercard\n] as const;\n\n/**\n * Generate a random valid Visa or Mastercard\n * number (16 digits, Luhn-valid).\n */\nconst generate = (): string => {\n  const idx = randomInt(0, CARD_PREFIXES.length - 1);\n  const [prefix, length] = CARD_PREFIXES[\n    idx\n  ] as (typeof CARD_PREFIXES)[number];\n  const remaining = length - prefix.length - 1;\n  const payload = `${prefix}${randomDigits(remaining)}`;\n  const partial = `${payload}0`;\n  const remainder = luhnChecksum(partial);\n  const check = (10 - remainder) % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Credit Card Number (Luhn). */\nconst creditCard: GlobalValidator = {\n  scope: \"global\",\n  name: \"Credit Card Number\",\n  localName: \"Credit Card Number\",\n  abbreviation: \"CC\",\n  aliases: [\n    \"credit card\",\n    \"card number\",\n    \"kreditní karta\",\n    \"Kreditkarte\",\n  ] as const,\n  candidatePattern: \"(?:\\\\d[\\\\s-]?){13,19}\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.iso.org/standard/70484.html\",\n  examples: [\n    \"4111111111111111\",\n    \"5500000000000004\",\n  ] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default creditCard;\nexport { compact, detectNetwork, format, validate };\nexport type { CardNetwork };\n"],"mappings":";;;;;;AAuCA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,SAAS,MAAM,EAAE,SAAS,IAC9B,OAAO,IACL,kBACA,yCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,6CACF;CAEF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,qCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,MAAM,EAAE,OAAO,KAC9B,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;CAGzD,MAAM,SAAmB,CAAC;CAC1B,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,GACjC,OAAO,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAE/B,OAAO,OAAO,KAAK,GAAG;AACxB;AAEA,MAAM,mBAAmB,IAAI,IAAI;CAC/B;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;AAClD,CAAC;;;;;;;;AASD,MAAM,iBACJ,UACuB;CACvB,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GAAG,OAAO;CAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO;CAEzB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAG/B,IAAI,OAAO,MAAM,OAAO,IAAI,OAAO;CAGnC,IAAI,OAAO,MAAM,OAAO,IAAI,OAAO;CACnC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;CAGnC,IAAI,MAAM,QAAQ,MAAM,MAAM,OAAO;CAGrC,IAAI,EAAE,OAAO,KAAK,OAAO;CAIzB,IAAI,iBAAiB,IAAI,EAAE,GAAG,OAAO;CAGrC,IAAI,MAAM,MAAM,MAAM,IAAI,OAAO;CACjC,IAAI,MAAM,QAAQ,MAAM,MAAM,OAAO;CAGrC,IAAI,OAAO,MAAM,OAAO;CACxB,IAAI,MAAM,UAAU,MAAM,QAAQ,OAAO;CACzC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;CACnC,IAAI,OAAO,IAAI,OAAO;CAItB,IAAI,OAAO,IAAI,OAAO;CAEtB,OAAO;AACT;;;;;AAMA,MAAM,gBAAgB;CACpB,CAAC,KAAK,EAAE;CACR,CAAC,MAAM,EAAE;CACT,CAAC,MAAM,EAAE;CACT,CAAC,MAAM,EAAE;CACT,CAAC,MAAM,EAAE;CACT,CAAC,MAAM,EAAE;AACX;;;;;AAMA,MAAM,iBAAyB;CAE7B,MAAM,CAAC,QAAQ,UAAU,cADb,UAAU,GAAG,cAAc,SAAS,CAE5C;CAGJ,MAAM,UAAU,GAAG,SAAS,aADV,SAAS,OAAO,SAAS,CACO;CAGlD,MAAM,SAAS,KADG,aAAa,GADZ,QAAQ,EAEC,KAAK;CACjC,OAAO,GAAG,UAAU,OAAO,KAAK;AAClC;;AAGA,MAAM,aAA8B;CAClC,OAAO;CACP,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;CACF;CACA,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CACR,oBACA,kBACF;CACA;CACA;CACA;CACA;AACF"}

package/dist/cu/ni.d.ts

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

package/dist/cu/ni.js

@@ -1,24 +1,8 @@
 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 { isValidDate } from "../_util/date.js";
 //#region src/cu/ni.ts
-/**
-* NI (Número de Identidad, Cuban identity card number).
-*
-* 11 digits encoding birth date, century, sequence, and
-* gender. Structure: YYMMDDXNNNN where:
-*   - YYMMDD = birth date
-*   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)
-*   - NNNN = sequence (digit at position 9 encodes gender:
-*     even=male, odd=female)
-*
-* No check digit; validation is by date and format only.
-*
-* Ported from python-stdnum cu.ni module.
-*
-* @see https://www.ecured.cu/Carnet_de_Identidad
-*/
 const compact = (value) => clean(value, " -").trim();
 /**
 * Derive the full birth year from the two-digit year
@@ -83,6 +67,7 @@ const ni = {
 		"carnet de identidad"
 	],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "CU",
 	entityType: "person",
 	lengths: [11],

package/dist/cu/ni.js.map

@@ -1 +1 @@
-{"version":3,"file":"ni.js","names":[],"sources":["../../src/cu/ni.ts"],"sourcesContent":["/**\n * NI (Número de Identidad, Cuban identity card number).\n *\n * 11 digits encoding birth date, century, sequence, and\n * gender. Structure: YYMMDDXNNNN where:\n *   - YYMMDD = birth date\n *   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)\n *   - NNNN = sequence (digit at position 9 encodes gender:\n *     even=male, odd=female)\n *\n * No check digit; validation is by date and format only.\n *\n * Ported from python-stdnum cu.ni module.\n *\n * @see https://www.ecured.cu/Carnet_de_Identidad\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Derive the full birth year from the two-digit year\n * and the century indicator at position 6.\n */\nconst centuryOffset = (digit: string): number => {\n  if (digit === \"9\") return 1800;\n  if (digit >= \"0\" && digit <= \"5\") return 1900;\n  return 2000;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cuban NI must be 11 digits\",\n    );\n  }\n\n  if (!/^\\d{11}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cuban NI must contain only digits\",\n    );\n  }\n\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  // SAFETY: regex check above guarantees v.length === 11.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = centuryOffset(v[6]!) + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cuban NI contains an invalid birth date\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a Cuban NI.\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 yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  // SAFETY: regex check above guarantees v.length === 11.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = centuryOffset(v[6]!) + yy;\n\n  const genderDigit = Number(v[9]);\n  const gender: \"male\" | \"female\" =\n    genderDigit % 2 === 0 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/** Generate a random valid Cuban NI. */\nconst generate = (): string => {\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 yy = String(year % 100).padStart(2, \"0\");\n  const century =\n    year >= 2000\n      ? String(randomInt(6, 8))\n      : String(randomInt(0, 5));\n  return `${yy}${month}${day}${century}${randomDigits(4)}`;\n};\n\n/**\n * Cuban identity card number (NI).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst ni: Validator<ParsedPersonId> = {\n  name: \"Cuban Identity Card Number\",\n  localName: \"Número de Identidad\",\n  abbreviation: \"NI\",\n  aliases: [\n    \"NI\",\n    \"número de identidad\",\n    \"carnet de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"CU\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"91021027775\", \"72062506561\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n  sourceUrl: \"https://www.ecured.cu/Carnet_de_Identidad\",\n};\n\nexport default ni;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;;;;;AAM3B,MAAM,iBAAiB,UAA0B;AAC/C,KAAI,UAAU,IAAK,QAAO;AAC1B,KAAI,SAAS,OAAO,SAAS,IAAK,QAAO;AACzC,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAGH,KAAI,CAAC,WAAW,KAAK,EAAE,CACrB,QAAO,IACL,kBACA,oCACD;CAGH,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;AAKhC,KAAI,CAAC,YAFQ,cAAc,EAAE,GAAI,GAAG,IAEb,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,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;CAGhC,MAAM,OAAO,cAAc,EAAE,GAAI,GAAG;CAGpC,MAAM,SADc,OAAO,EAAE,GAAG,GAEhB,MAAM,IAAI,SAAS;AAEnC,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;;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;AAMrD,QAAO,GALI,OAAO,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,GAK/B,QAAQ,MAHrB,QAAQ,MACJ,OAAO,UAAU,GAAG,EAAE,CAAC,GACvB,OAAO,UAAU,GAAG,EAAE,CAAC,GACU,aAAa,EAAE;;;;;;;AAQxD,MAAM,KAAgC;CACpC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe,cAAc;CACxC;CACA;CACA;CACA;CACA;CACA,WAAW;CACZ"}
+{"version":3,"file":"ni.js","names":[],"sources":["../../src/cu/ni.ts"],"sourcesContent":["/**\n * NI (Número de Identidad, Cuban identity card number).\n *\n * 11 digits encoding birth date, century, sequence, and\n * gender. Structure: YYMMDDXNNNN where:\n *   - YYMMDD = birth date\n *   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)\n *   - NNNN = sequence (digit at position 9 encodes gender:\n *     even=male, odd=female)\n *\n * No check digit; validation is by date and format only.\n *\n * Ported from python-stdnum cu.ni module.\n *\n * @see https://www.ecured.cu/Carnet_de_Identidad\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\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Derive the full birth year from the two-digit year\n * and the century indicator at position 6.\n */\nconst centuryOffset = (digit: string): number => {\n  if (digit === \"9\") return 1800;\n  if (digit >= \"0\" && digit <= \"5\") return 1900;\n  return 2000;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cuban NI must be 11 digits\",\n    );\n  }\n\n  if (!/^\\d{11}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cuban NI must contain only digits\",\n    );\n  }\n\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  // SAFETY: regex check above guarantees v.length === 11.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = centuryOffset(v[6]!) + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cuban NI contains an invalid birth date\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a Cuban NI.\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 yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  // SAFETY: regex check above guarantees v.length === 11.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = centuryOffset(v[6]!) + yy;\n\n  const genderDigit = Number(v[9]);\n  const gender: \"male\" | \"female\" =\n    genderDigit % 2 === 0 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/** Generate a random valid Cuban NI. */\nconst generate = (): string => {\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 yy = String(year % 100).padStart(2, \"0\");\n  const century =\n    year >= 2000\n      ? String(randomInt(6, 8))\n      : String(randomInt(0, 5));\n  return `${yy}${month}${day}${century}${randomDigits(4)}`;\n};\n\n/**\n * Cuban identity card number (NI).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst ni: CountryValidator<\"CU\", ParsedPersonId> = {\n  name: \"Cuban Identity Card Number\",\n  localName: \"Número de Identidad\",\n  abbreviation: \"NI\",\n  aliases: [\n    \"NI\",\n    \"número de identidad\",\n    \"carnet de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  scope: \"country\",\n  country: \"CU\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"91021027775\", \"72062506561\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n  sourceUrl: \"https://www.ecured.cu/Carnet_de_Identidad\",\n};\n\nexport default ni;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,KAAK;;;;;AAM1B,MAAM,iBAAiB,UAA0B;CAC/C,IAAI,UAAU,KAAK,OAAO;CAC1B,IAAI,SAAS,OAAO,SAAS,KAAK,OAAO;CACzC,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4BACF;CAGF,IAAI,CAAC,WAAW,KAAK,CAAC,GACpB,OAAO,IACL,kBACA,mCACF;CAGF,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAK/B,IAAI,CAAC,YAFQ,cAAc,EAAE,EAAG,IAAI,IAEb,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,yCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;;;;AAMvD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAG/B,MAAM,OAAO,cAAc,EAAE,EAAG,IAAI;CAGpC,MAAM,SADc,OAAO,EAAE,EAEjB,IAAI,MAAM,IAAI,SAAS;CAEnC,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE;EACpC;CACF;AACF;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,UAAU,MAAM,IAAI;CACjC,MAAM,QAAQ,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;CACtD,MAAM,MAAM,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;CAMpD,OAAO,GALI,OAAO,OAAO,GAAG,EAAE,SAAS,GAAG,GAK/B,IAAI,QAAQ,MAHrB,QAAQ,MACJ,OAAO,UAAU,GAAG,CAAC,CAAC,IACtB,OAAO,UAAU,GAAG,CAAC,CAAC,IACW,aAAa,CAAC;AACvD;;;;;;AAOA,MAAM,KAA6C;CACjD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,eAAe,aAAa;CACvC;CACA;CACA;CACA;CACA;CACA,WAAW;AACb"}

package/dist/cy/vat.d.ts

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

package/dist/cy/vat.js

@@ -3,14 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/cy/vat.ts
-/**
-* ΦΠΑ (Cypriot VAT number).
-*
-* 8 digits + 1 check letter. Cannot start with "12".
-*
-* @see https://www.vatify.eu/cyprus-vat-number.html
-* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf
-*/
 const ODD_MAP = {
 	0: 1,
 	1: 0,
@@ -73,6 +65,7 @@ const vat = {
 	abbreviation: "ΦΠΑ",
 	aliases: ["ΦΠΑ", "VAT CY"],
 	candidatePattern: "CY\\d{8}[A-Z]",
+	scope: "country",
 	country: "CY",
 	entityType: "company",
 	sourceUrl: "https://www.mof.gov.cy/",

package/dist/cy/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/cy/vat.ts"],"sourcesContent":["/**\n * ΦΠΑ (Cypriot VAT number).\n *\n * 8 digits + 1 check letter. Cannot start with \"12\".\n *\n * @see https://www.vatify.eu/cyprus-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst ODD_MAP: Record<number, number> = {\n  0: 1,\n  1: 0,\n  2: 5,\n  3: 7,\n  4: 9,\n  5: 13,\n  6: 15,\n  7: 17,\n  8: 19,\n  9: 21,\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"CY\") || v.startsWith(\"cy\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cypriot VAT number must be 8 digits + 1 letter\",\n    );\n  }\n  const digits = v.slice(0, 8);\n  const checkLetter = v[8];\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must start with 8 digits\",\n    );\n  }\n  if (\n    checkLetter === undefined ||\n    !LETTERS.includes(checkLetter)\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must end with a letter\",\n    );\n  }\n  if (v.startsWith(\"12\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cypriot VAT number cannot start with 12\",\n    );\n  }\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 8; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd position (1-indexed: 1,3,5,7)\n      odd += ODD_MAP[d] ?? 0;\n    } else {\n      // Even position (1-indexed: 2,4,6,8)\n      even += d;\n    }\n  }\n  const expected = LETTERS.charAt((odd + even) % 26);\n  if (checkLetter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Cypriot VAT number check letter mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `CY${compact(value)}`;\n\n/** Generate a random valid Cypriot VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const digits = randomDigits(8);\n    if (digits.startsWith(\"12\")) continue;\n    let odd = 0;\n    let even = 0;\n    for (let i = 0; i < 8; i++) {\n      const d = Number(digits.charAt(i));\n      if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;\n      else even += d;\n    }\n    return digits + LETTERS.charAt((odd + even) % 26);\n  }\n};\n\n/** Cypriot VAT Number. */\nconst vat: Validator = {\n  name: \"Cypriot VAT Number\",\n  localName: \"Αριθμός Εγγραφής Φ.Π.Α.\",\n  abbreviation: \"ΦΠΑ\",\n  aliases: [\"ΦΠΑ\", \"VAT CY\"] as const,\n  candidatePattern: \"CY\\\\d{8}[A-Z]\",\n  country: \"CY\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.mof.gov.cy/\",\n  examples: [\"10259033P\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,UAAkC;CACtC,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,UAAU;AAEhB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,iDACD;CAEH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,cAAc,EAAE;AACtB,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,8CACD;AAEH,KACE,gBAAgB,KAAA,KAChB,CAAC,QAAQ,SAAS,YAAY,CAE9B,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,EAAE,WAAW,KAAK,CACpB,QAAO,IACL,qBACA,0CACD;CAEH,IAAI,MAAM;CACV,IAAI,OAAO;AACX,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,MAAI,IAAI,MAAM,EAEZ,QAAO,QAAQ,MAAM;MAGrB,SAAQ;;AAIZ,KAAI,gBADa,QAAQ,QAAQ,MAAM,QAAQ,GAAG,CAEhD,QAAO,IACL,oBACA,2CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,SAAS,aAAa,EAAE;AAC9B,MAAI,OAAO,WAAW,KAAK,CAAE;EAC7B,IAAI,MAAM;EACV,IAAI,OAAO;AACX,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;GAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,OAAI,IAAI,MAAM,EAAG,QAAO,QAAQ,MAAM;OACjC,SAAQ;;AAEf,SAAO,SAAS,QAAQ,QAAQ,MAAM,QAAQ,GAAG;;;;AAKrD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,SAAS;CAC1B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/cy/vat.ts"],"sourcesContent":["/**\n * ΦΠΑ (Cypriot VAT number).\n *\n * 8 digits + 1 check letter. Cannot start with \"12\".\n *\n * @see https://www.vatify.eu/cyprus-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst ODD_MAP: Record<number, number> = {\n  0: 1,\n  1: 0,\n  2: 5,\n  3: 7,\n  4: 9,\n  5: 13,\n  6: 15,\n  7: 17,\n  8: 19,\n  9: 21,\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"CY\") || v.startsWith(\"cy\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cypriot VAT number must be 8 digits + 1 letter\",\n    );\n  }\n  const digits = v.slice(0, 8);\n  const checkLetter = v[8];\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must start with 8 digits\",\n    );\n  }\n  if (\n    checkLetter === undefined ||\n    !LETTERS.includes(checkLetter)\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must end with a letter\",\n    );\n  }\n  if (v.startsWith(\"12\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cypriot VAT number cannot start with 12\",\n    );\n  }\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 8; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd position (1-indexed: 1,3,5,7)\n      odd += ODD_MAP[d] ?? 0;\n    } else {\n      // Even position (1-indexed: 2,4,6,8)\n      even += d;\n    }\n  }\n  const expected = LETTERS.charAt((odd + even) % 26);\n  if (checkLetter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Cypriot VAT number check letter mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `CY${compact(value)}`;\n\n/** Generate a random valid Cypriot VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const digits = randomDigits(8);\n    if (digits.startsWith(\"12\")) continue;\n    let odd = 0;\n    let even = 0;\n    for (let i = 0; i < 8; i++) {\n      const d = Number(digits.charAt(i));\n      if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;\n      else even += d;\n    }\n    return digits + LETTERS.charAt((odd + even) % 26);\n  }\n};\n\n/** Cypriot VAT Number. */\nconst vat: CountryValidator<\"CY\"> = {\n  name: \"Cypriot VAT Number\",\n  localName: \"Αριθμός Εγγραφής Φ.Π.Α.\",\n  abbreviation: \"ΦΠΑ\",\n  aliases: [\"ΦΠΑ\", \"VAT CY\"] as const,\n  candidatePattern: \"CY\\\\d{8}[A-Z]\",\n  scope: \"country\",\n  country: \"CY\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.mof.gov.cy/\",\n  examples: [\"10259033P\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAmBA,MAAM,UAAkC;CACtC,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;AAEA,MAAM,UAAU;AAEhB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EAAE,YAAY;AACvB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,gDACF;CAEF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,MAAM,cAAc,EAAE;CACtB,IAAI,CAAC,SAAS,MAAM,GAClB,OAAO,IACL,kBACA,6CACF;CAEF,IACE,gBAAgB,KAAA,KAChB,CAAC,QAAQ,SAAS,WAAW,GAE7B,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,EAAE,WAAW,IAAI,GACnB,OAAO,IACL,qBACA,yCACF;CAEF,IAAI,MAAM;CACV,IAAI,OAAO;CACX,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC;EACjC,IAAI,IAAI,MAAM,GAEZ,OAAO,QAAQ,MAAM;OAGrB,QAAQ;CAEZ;CAEA,IAAI,gBADa,QAAQ,QAAQ,MAAM,QAAQ,EACpB,GACzB,OAAO,IACL,oBACA,0CACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,SAAS,aAAa,CAAC;EAC7B,IAAI,OAAO,WAAW,IAAI,GAAG;EAC7B,IAAI,MAAM;EACV,IAAI,OAAO;EACX,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;GAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC;GACjC,IAAI,IAAI,MAAM,GAAG,OAAO,QAAQ,MAAM;QACjC,QAAQ;EACf;EACA,OAAO,SAAS,QAAQ,QAAQ,MAAM,QAAQ,EAAE;CAClD;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,QAAQ;CACzB,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/cz/dic.d.ts

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

package/dist/cz/dic.js

@@ -1,22 +1,10 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 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 { weightedSum } from "../_checksums/weighted-sum.js";
 import { validate as validate$1 } from "./rc.js";
 //#region src/cz/dic.ts
-/**
-* DIČ (Daňové identifikační číslo).
-*
-* Czech tax identification number / VAT number.
-* Format: "CZ" prefix + 8, 9, or 10 digits.
-* - 8 digits: company (same checksum as IČO,
-*   but first digit cannot be 9)
-* - 9 digits starting with 6: special entity
-* - 9-10 digits: individual (birth number)
-*
-* @see https://adisspr.mfcr.cz/dpr/DphReg
-*/
 const ICO_WEIGHTS = [
 	8,
 	7,
@@ -82,9 +70,15 @@ const dic = {
 	abbreviation: "DIČ",
 	aliases: ["DIČ", "daňové identifikační číslo"],
 	candidatePattern: "CZ\\d{8,10}",
+	scope: "country",
 	country: "CZ",
 	entityType: "any",
 	sourceUrl: "https://adisspr.mfcr.cz/dpr/DphReg",
+	lengths: [
+		8,
+		9,
+		10
+	],
 	examples: ["25123891", "7103192745"],
 	compact,
 	format,