@stll/stdnum 0.0.1 → 2.0.0

package/dist/cl/rut.js.map

@@ -1 +1 @@
-{"version":3,"file":"rut.js","names":[],"sources":["../../src/cl/rut.ts"],"sourcesContent":["/**\n * RUT (Rol Único Tributario).\n *\n * Chilean tax identification number assigned by the SII\n * (Servicio de Impuestos Internos). The number consists\n * of 7 or 8 digits followed by a check digit (0-9 or K),\n * computed using a modulo 11 algorithm with weights\n * [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * Format: XX.XXX.XXX-C (7-8 digits + check digit).\n *\n * @see https://www.sii.cl/\n * @see https://en.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst RUT_RE = /^\\d{7,8}[\\dK]$/;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\").trim().toUpperCase();\n  if (v.startsWith(\"CL\")) v = v.slice(2);\n  return v;\n};\n\n/**\n * Compute the RUT check digit using mod 11 with\n * weights [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * remainder = 11 - (weighted sum % 11)\n * 11 -> \"0\", 10 -> \"K\", else the digit as string.\n */\nconst calcCheckDigit = (body: string): string => {\n  const weights = [2, 3, 4, 5, 6, 7];\n  let sum = 0;\n  for (let i = body.length - 1, w = 0; i >= 0; i--, w++) {\n    sum += Number(body[i]) * weights[w % 6]!;\n  }\n  const remainder = 11 - (sum % 11);\n  if (remainder === 11) return \"0\";\n  if (remainder === 10) return \"K\";\n  return String(remainder);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RUT must be 8 or 9 characters\",\n    );\n  }\n\n  if (!RUT_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUT must contain only digits and optionally K\",\n    );\n  }\n\n  const body = v.slice(0, -1);\n  const expected = calcCheckDigit(body);\n  if (v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUT 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 check = v.at(-1);\n  const body = v.slice(0, -1);\n  return (\n    `${body.slice(0, -6)}.${body.slice(-6, -3)}` +\n    `.${body.slice(-3)}-${check}`\n  );\n};\n\n/** Generate a random valid Chilean RUT. */\nconst generate = (): string => {\n  const body = randomDigits(8);\n  return body + calcCheckDigit(body);\n};\n\n/**\n * Chilean RUT (tax identification number).\n *\n * Examples sourced from python-stdnum test suite\n * (cl.rut module).\n */\nconst rut: Validator = {\n  name: \"Chilean Tax ID\",\n  localName: \"Rol Único Tributario\",\n  abbreviation: \"RUT\",\n  aliases: [\"RUT\", \"Rol Único Tributario\"] as const,\n  candidatePattern: \"\\\\d{1,2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?[\\\\dkK]\",\n  country: \"CL\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.sii.cl/\",\n  lengths: [8, 9] as const,\n  examples: [\"760864285\", \"125319092\"] as const,\n  generate,\n};\n\nexport default rut;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,SAAS;AAEf,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa;AAChD,KAAI,EAAE,WAAW,KAAK,CAAE,KAAI,EAAE,MAAM,EAAE;AACtC,QAAO;;;;;;;;;AAUT,MAAM,kBAAkB,SAAyB;CAC/C,MAAM,UAAU;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAE;CAClC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,IAChD,QAAO,OAAO,KAAK,GAAG,GAAG,QAAQ,IAAI;CAEvC,MAAM,YAAY,KAAM,MAAM;AAC9B,KAAI,cAAc,GAAI,QAAO;AAC7B,KAAI,cAAc,GAAI,QAAO;AAC7B,QAAO,OAAO,UAAU;;AAG1B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,EACjC,QAAO,IACL,kBACA,gCACD;AAGH,KAAI,CAAC,OAAO,KAAK,EAAE,CACjB,QAAO,IACL,kBACA,gDACD;CAIH,MAAM,WAAW,eADJ,EAAE,MAAM,GAAG,GAAG,CACU;AACrC,KAAI,EAAE,GAAG,GAAG,KAAK,SACf,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;CACxB,MAAM,QAAQ,EAAE,GAAG,GAAG;CACtB,MAAM,OAAO,EAAE,MAAM,GAAG,GAAG;AAC3B,QACE,GAAG,KAAK,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAA,GACtC,KAAK,MAAM,GAAG,CAAC,GAAG;;;AAK1B,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,EAAE;AAC5B,QAAO,OAAO,eAAe,KAAK;;;;;;;;AASpC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,uBAAuB;CACxC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,WAAW;CACX,SAAS,CAAC,GAAG,EAAE;CACf,UAAU,CAAC,aAAa,YAAY;CACpC;CACD"}
+{"version":3,"file":"rut.js","names":[],"sources":["../../src/cl/rut.ts"],"sourcesContent":["/**\n * RUT (Rol Único Tributario).\n *\n * Chilean tax identification number assigned by the SII\n * (Servicio de Impuestos Internos). The number consists\n * of 7 or 8 digits followed by a check digit (0-9 or K),\n * computed using a modulo 11 algorithm with weights\n * [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * Format: XX.XXX.XXX-C (7-8 digits + check digit).\n *\n * @see https://www.sii.cl/\n * @see https://en.wikipedia.org/wiki/Rol_%C3%9Anico_Tributario\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\";\n\nconst RUT_RE = /^\\d{7,8}[\\dK]$/;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\").trim().toUpperCase();\n  if (v.startsWith(\"CL\")) v = v.slice(2);\n  return v;\n};\n\n/**\n * Compute the RUT check digit using mod 11 with\n * weights [2, 3, 4, 5, 6, 7] cycling right-to-left.\n *\n * remainder = 11 - (weighted sum % 11)\n * 11 -> \"0\", 10 -> \"K\", else the digit as string.\n */\nconst calcCheckDigit = (body: string): string => {\n  const weights = [2, 3, 4, 5, 6, 7] as const;\n  let sum = 0;\n  for (let i = body.length - 1, w = 0; i >= 0; i--, w++) {\n    // SAFETY: w % weights.length is a valid index.\n    // eslint-disable-next-line no-non-null-assertion\n    sum += Number(body[i]) * weights[w % weights.length]!;\n  }\n  const remainder = 11 - (sum % 11);\n  if (remainder === 11) return \"0\";\n  if (remainder === 10) return \"K\";\n  return String(remainder);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RUT must be 8 or 9 characters\",\n    );\n  }\n\n  if (!RUT_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUT must contain only digits and optionally K\",\n    );\n  }\n\n  const body = v.slice(0, -1);\n  const expected = calcCheckDigit(body);\n  if (v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUT 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 check = v.at(-1);\n  const body = v.slice(0, -1);\n  return (\n    `${body.slice(0, -6)}.${body.slice(-6, -3)}` +\n    `.${body.slice(-3)}-${check}`\n  );\n};\n\n/** Generate a random valid Chilean RUT. */\nconst generate = (): string => {\n  const body = randomDigits(8);\n  return body + calcCheckDigit(body);\n};\n\n/**\n * Chilean RUT (tax identification number).\n *\n * Examples sourced from python-stdnum test suite\n * (cl.rut module).\n */\nconst rut: CountryValidator<\"CL\"> = {\n  name: \"Chilean Tax ID\",\n  localName: \"Rol Único Tributario\",\n  abbreviation: \"RUT\",\n  aliases: [\"RUT\", \"Rol Único Tributario\"] as const,\n  candidatePattern: \"\\\\d{1,2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?[\\\\dkK]\",\n  scope: \"country\",\n  country: \"CL\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.sii.cl/\",\n  lengths: [8, 9] as const,\n  examples: [\"760864285\", \"125319092\"] as const,\n  generate,\n};\n\nexport default rut;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAwBA,MAAM,SAAS;AAEf,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY;CAC/C,IAAI,EAAE,WAAW,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC;CACrC,OAAO;AACT;;;;;;;;AASA,MAAM,kBAAkB,SAAyB;CAC/C,MAAM,UAAU;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;CAAC;CACjC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,KAGhD,OAAO,OAAO,KAAK,EAAE,IAAI,QAAQ,IAAI,QAAQ;CAE/C,MAAM,YAAY,KAAM,MAAM;CAC9B,IAAI,cAAc,IAAI,OAAO;CAC7B,IAAI,cAAc,IAAI,OAAO;CAC7B,OAAO,OAAO,SAAS;AACzB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,OAAO,IACL,kBACA,+BACF;CAGF,IAAI,CAAC,OAAO,KAAK,CAAC,GAChB,OAAO,IACL,kBACA,+CACF;CAIF,MAAM,WAAW,eADJ,EAAE,MAAM,GAAG,EACW,CAAC;CACpC,IAAI,EAAE,GAAG,EAAE,MAAM,UACf,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,MAAM,QAAQ,EAAE,GAAG,EAAE;CACrB,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE;CAC1B,OACE,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,GAAG,KAAK,MAAM,IAAI,EAAE,EAAA,GACrC,KAAK,MAAM,EAAE,EAAE,GAAG;AAE1B;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,aAAa,CAAC;CAC3B,OAAO,OAAO,eAAe,IAAI;AACnC;;;;;;;AAQA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,sBAAsB;CACvC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,WAAW;CACX,SAAS,CAAC,GAAG,CAAC;CACd,UAAU,CAAC,aAAa,WAAW;CACnC;AACF"}

package/dist/cn/mod.d.ts

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

package/dist/cn/ric.d.ts

@@ -1,7 +1,6 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/cn/ric.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -13,7 +12,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid 18-digit RIC. */
 declare const generate: () => string;
 /** Chinese Resident Identity Card number. */
-declare const ric: Validator;
+declare const ric: CountryValidator<"CN", ParsedPersonId>;
 //#endregion
 export { compact, ric as default, format, generate, parse, validate };
 //# sourceMappingURL=ric.d.ts.map

package/dist/cn/ric.js

@@ -1,22 +1,10 @@
+import { mod112checkChar, mod112validate } from "../_checksums/mod112.js";
 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 { mod112checkChar, mod112validate } from "../_checksums/mod112.js";
 //#region src/cn/ric.ts
-/**
-* RIC (Resident Identity Card number, 居民身份证号码).
-*
-* Chinese national identifier. 18 characters:
-* 6 (area code) + 8 (YYYYMMDD birth) + 3 (sequence,
-* odd = male) + 1 (check, 0-9 or X).
-*
-* Also accepts the legacy 15-digit format (no check
-* digit, 2-digit year).
-*
-* @see https://en.wikipedia.org/wiki/Resident_Identity_Card
-*/
 const compact = (value) => clean(value, " -").toUpperCase();
 const validate = (value) => {
 	const v = compact(value);
@@ -91,6 +79,7 @@ const ric = {
 		"RIC"
 	],
 	candidatePattern: "\\d{17}[\\dX]",
+	scope: "country",
 	country: "CN",
 	entityType: "person",
 	description: "18-character national ID encoding area, birth date, gender, and check digit",
@@ -99,6 +88,7 @@ const ric = {
 	examples: ["11010519491231002X", "440524188001010014"],
 	compact,
 	format,
+	parse,
 	validate,
 	generate
 };

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  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 = {\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  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,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/cn/uscc.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 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

@@ -1,18 +1,8 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+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,
@@ -36,16 +26,17 @@ const WEIGHTS = [
 const compact = (value) => clean(value, " -").toUpperCase();
 const calcCheckChar = (value) => {
 	let total = 0;
-	for (let i = 0; i < 17; i++) {
-		const idx = ALPHABET.indexOf(value[i]);
-		total += idx * WEIGHTS[i];
+	for (const [i, weight] of WEIGHTS.entries()) {
+		const ch = value[i];
+		if (ch === void 0) continue;
+		total += ALPHABET.indexOf(ch) * weight;
 	}
 	return ALPHABET[(31 - total % 31) % 31];
 };
 const validate = (value) => {
 	const v = compact(value);
 	if (v.length !== 18) return err("INVALID_LENGTH", "USCC must be 18 characters");
-	for (let i = 0; i < 18; i++) if (!ALPHABET.includes(v[i])) return err("INVALID_FORMAT", "USCC contains invalid character");
+	for (const ch of v) if (!ALPHABET.includes(ch)) return err("INVALID_FORMAT", "USCC contains invalid character");
 	if (!isdigits(v.slice(2, 8))) return err("INVALID_FORMAT", "USCC region code (positions 3-8) must be digits");
 	if (v[17] !== calcCheckChar(v)) return err("INVALID_CHECKSUM", "USCC check character does not match");
 	return {
@@ -60,7 +51,7 @@ const generate = () => {
 	const etype = ALPHABET[randomInt(1, 9)];
 	const region = randomDigits(6);
 	let org = "";
-	for (let i = 0; i < 9; i++) org += ALPHABET[randomInt(0, 30)];
+	for (let i = 0; i < 9; i++) org += randomChar(ALPHABET);
 	const payload = reg + etype + region + org;
 	return payload + calcCheckChar(payload);
 };
@@ -71,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 { randomDigits, randomInt } 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 (let i = 0; i < 17; i++) {\n    const idx = ALPHABET.indexOf(value[i]!);\n    total += idx * WEIGHTS[i]!;\n  }\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 (let i = 0; i < 18; i++) {\n    if (!ALPHABET.includes(v[i]!)) {\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  const reg = ALPHABET[randomInt(1, 9)]!;\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 += ALPHABET[randomInt(0, ALPHABET.length - 1)]!;\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":";;;;;;;;;;;;;;;AAkBA,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,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,MAAM,SAAS,QAAQ,MAAM,GAAI;AACvC,WAAS,MAAM,QAAQ;;AAEzB,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,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,KAAI,CAAC,SAAS,SAAS,EAAE,GAAI,CAC3B,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;CAC7B,MAAM,MAAM,SAAS,UAAU,GAAG,EAAE;CACpC,MAAM,QAAQ,SAAS,UAAU,GAAG,EAAE;CACtC,MAAM,SAAS,aAAa,EAAE;CAC9B,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,SAAS,UAAU,GAAG,GAAoB;CACnD,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/mod.d.ts

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

package/dist/co/nit.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/co/nit.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 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,
@@ -49,14 +38,17 @@ const compact = (value) => clean(value, " -.,");
 const calcCheckDigit = (body) => {
 	let sum = 0;
 	const len = body.length;
-	for (let i = 0; i < len; i++) sum += Number(body[len - 1 - i]) * WEIGHTS[i];
+	for (const [i, weight] of WEIGHTS.entries()) {
+		if (i >= len) break;
+		sum += Number(body[len - 1 - i]) * weight;
+	}
 	return CHECK_DIGITS[sum % 11];
 };
 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
@@ -82,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 (let i = 0; i < len; i++) {\n    sum += Number(body[len - 1 - i]) * WEIGHTS[i]!;\n  }\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,IAAI,IAAI,GAAG,IAAI,KAAK,IACvB,QAAO,OAAO,KAAK,MAAM,IAAI,GAAG,GAAG,QAAQ;AAE7C,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)}`;
@@ -30,9 +14,10 @@ const compact = (value) => {
 	let number = clean(value, " ").trim().toUpperCase();
 	const parts = number.split("-");
 	if (parts.length === 3) {
-		const p0 = parts[0].padStart(2, "0");
-		const p1 = parts[1].padStart(4, "0");
-		const p2 = parts[2].padStart(4, "0");
+		const [raw0, raw1, raw2] = parts;
+		const p0 = (raw0 ?? "").padStart(2, "0");
+		const p1 = (raw1 ?? "").padStart(4, "0");
+		const p2 = (raw2 ?? "").padStart(4, "0");
 		number = p0 + p1 + p2;
 	} else number = number.replaceAll("-", "");
 	if (number.length === 9) number = "0" + number;
@@ -63,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 p0 = parts[0]!.padStart(2, \"0\");\n    const p1 = parts[1]!.padStart(4, \"0\");\n    const p2 = parts[2]!.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,KAAK,MAAM,GAAI,SAAS,GAAG,IAAI;EACrC,MAAM,KAAK,MAAM,GAAI,SAAS,GAAG,IAAI;EACrC,MAAM,KAAK,MAAM,GAAI,SAAS,GAAG,IAAI;AACrC,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/cr/mod.d.ts

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

package/dist/creditcard.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "./types.js";
+import { GlobalValidator, ValidateResult } from "./types.js";
 
 //#region src/creditcard.d.ts
-
 /**
  * Card network identifiers returned by
  * {@link detectNetwork}.
@@ -19,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/mod.d.ts

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