@stll/stdnum 1.0.0 → 2.0.0

package/dist/mu/brn.js

@@ -2,27 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/mu/brn.ts
-/**
-* BRN (Business Registration Number, Mauritius).
-*
-* Issued by the Corporate and Business Registration
-* Department (CBRD). Used to identify entities and
-* individuals carrying out business activities.
-*
-* Entity BRN: 1 letter prefix + 8 digits (9 chars).
-*   - Letter indicates entity type (e.g. C = company,
-*     F = foreign company).
-*   - Digits 2-3 encode the registration year
-*     (e.g. 07 = 2007).
-*   - Digits 4-9 are a sequential number.
-*
-* Individual BRN: 8 digits, first digit 0-3.
-*
-* No public check digit algorithm is documented.
-*
-* @see https://companies.govmu.org/
-* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/mauritius-tin.pdf
-*/
 /** Generate a random valid Mauritius BRN (entity). */
 const generate = () => {
 	return `${String.fromCodePoint(65 + randomInt(0, 25))}${randomDigits(8)}`;
@@ -51,6 +30,7 @@ const brn = {
 	abbreviation: "BRN",
 	aliases: ["BRN", "Business Registration Number"],
 	candidatePattern: "[A-Z]\\d{8}",
+	scope: "country",
 	country: "MU",
 	entityType: "any",
 	compact,

package/dist/mu/brn.js.map

@@ -1 +1 @@
-{"version":3,"file":"brn.js","names":[],"sources":["../../src/mu/brn.ts"],"sourcesContent":["/** Generate a random valid Mauritius BRN (entity). */\nconst generate = (): string => {\n  const letter = String.fromCodePoint(\n    65 + randomInt(0, 25),\n  );\n  const digits = randomDigits(8);\n  return `${letter}${digits}`;\n};\n\n/**\n * BRN (Business Registration Number, Mauritius).\n *\n * Issued by the Corporate and Business Registration\n * Department (CBRD). Used to identify entities and\n * individuals carrying out business activities.\n *\n * Entity BRN: 1 letter prefix + 8 digits (9 chars).\n *   - Letter indicates entity type (e.g. C = company,\n *     F = foreign company).\n *   - Digits 2-3 encode the registration year\n *     (e.g. 07 = 2007).\n *   - Digits 4-9 are a sequential number.\n *\n * Individual BRN: 8 digits, first digit 0-3.\n *\n * No public check digit algorithm is documented.\n *\n * @see https://companies.govmu.org/\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/mauritius-tin.pdf\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/** Entity BRN: letter + 8 digits. */\nconst ENTITY_RE = /^[A-Z]\\d{8}$/;\n\n/** Individual BRN: 8 digits, starts with 0-3. */\nconst INDIVIDUAL_RE = /^[0-3]\\d{7}$/;\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 !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Mauritius BRN must be 8 or 9 characters\",\n    );\n  }\n\n  if (v.length === 9) {\n    if (!ENTITY_RE.test(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Mauritius entity BRN must be \" +\n          \"1 letter followed by 8 digits\",\n      );\n    }\n  } else {\n    if (!INDIVIDUAL_RE.test(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Mauritius individual BRN must be \" +\n          \"8 digits starting with 0-3\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Mauritius Business Registration Number. */\nconst brn: Validator = {\n  name: \"Mauritius Business Registration Number\",\n  localName: \"Business Registration Number\",\n  abbreviation: \"BRN\",\n  aliases: [\"BRN\", \"Business Registration Number\"] as const,\n  candidatePattern: \"[A-Z]\\\\d{8}\",\n  country: \"MU\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description:\n    \"Mauritius business registration number \" +\n    \"issued by the CBRD\",\n  sourceUrl: \"https://companies.govmu.org/\",\n  lengths: [8, 9] as const,\n  examples: [\"C07015330\", \"C16135302\"] as const,\n  generate,\n};\n\nexport default brn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;AAK7B,QAAO,GAJQ,OAAO,cACpB,KAAK,UAAU,GAAG,GAAG,CACtB,GACc,aAAa,EAAE;;;AAiChC,MAAM,YAAY;;AAGlB,MAAM,gBAAgB;AAEtB,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,aAAa;AAEnC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,EACjC,QAAO,IACL,kBACA,0CACD;AAGH,KAAI,EAAE,WAAW;MACX,CAAC,UAAU,KAAK,EAAE,CACpB,QAAO,IACL,kBACA,6DAED;YAGC,CAAC,cAAc,KAAK,EAAE,CACxB,QAAO,IACL,kBACA,8DAED;AAIL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,+BAA+B;CAChD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aACE;CAEF,WAAW;CACX,SAAS,CAAC,GAAG,EAAE;CACf,UAAU,CAAC,aAAa,YAAY;CACpC;CACD"}
+{"version":3,"file":"brn.js","names":[],"sources":["../../src/mu/brn.ts"],"sourcesContent":["/** Generate a random valid Mauritius BRN (entity). */\nconst generate = (): string => {\n  const letter = String.fromCodePoint(\n    65 + randomInt(0, 25),\n  );\n  const digits = randomDigits(8);\n  return `${letter}${digits}`;\n};\n\n/**\n * BRN (Business Registration Number, Mauritius).\n *\n * Issued by the Corporate and Business Registration\n * Department (CBRD). Used to identify entities and\n * individuals carrying out business activities.\n *\n * Entity BRN: 1 letter prefix + 8 digits (9 chars).\n *   - Letter indicates entity type (e.g. C = company,\n *     F = foreign company).\n *   - Digits 2-3 encode the registration year\n *     (e.g. 07 = 2007).\n *   - Digits 4-9 are a sequential number.\n *\n * Individual BRN: 8 digits, first digit 0-3.\n *\n * No public check digit algorithm is documented.\n *\n * @see https://companies.govmu.org/\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/mauritius-tin.pdf\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/** Entity BRN: letter + 8 digits. */\nconst ENTITY_RE = /^[A-Z]\\d{8}$/;\n\n/** Individual BRN: 8 digits, starts with 0-3. */\nconst INDIVIDUAL_RE = /^[0-3]\\d{7}$/;\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 !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Mauritius BRN must be 8 or 9 characters\",\n    );\n  }\n\n  if (v.length === 9) {\n    if (!ENTITY_RE.test(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Mauritius entity BRN must be \" +\n          \"1 letter followed by 8 digits\",\n      );\n    }\n  } else {\n    if (!INDIVIDUAL_RE.test(v)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Mauritius individual BRN must be \" +\n          \"8 digits starting with 0-3\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Mauritius Business Registration Number. */\nconst brn: CountryValidator<\"MU\"> = {\n  name: \"Mauritius Business Registration Number\",\n  localName: \"Business Registration Number\",\n  abbreviation: \"BRN\",\n  aliases: [\"BRN\", \"Business Registration Number\"] as const,\n  candidatePattern: \"[A-Z]\\\\d{8}\",\n  scope: \"country\",\n  country: \"MU\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description:\n    \"Mauritius business registration number \" +\n    \"issued by the CBRD\",\n  sourceUrl: \"https://companies.govmu.org/\",\n  lengths: [8, 9] as const,\n  examples: [\"C07015330\", \"C16135302\"] as const,\n  generate,\n};\n\nexport default brn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AACA,MAAM,iBAAyB;CAK7B,OAAO,GAJQ,OAAO,cACpB,KAAK,UAAU,GAAG,EAAE,CAGP,IADA,aAAa,CACJ;AAC1B;;AAkCA,MAAM,YAAY;;AAGlB,MAAM,gBAAgB;AAEtB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,EAAE,YAAY;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,OAAO,IACL,kBACA,yCACF;CAGF,IAAI,EAAE,WAAW;MACX,CAAC,UAAU,KAAK,CAAC,GACnB,OAAO,IACL,kBACA,4DAEF;CAAA,OAGF,IAAI,CAAC,cAAc,KAAK,CAAC,GACvB,OAAO,IACL,kBACA,6DAEF;CAIJ,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,8BAA8B;CAC/C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aACE;CAEF,WAAW;CACX,SAAS,CAAC,GAAG,CAAC;CACd,UAAU,CAAC,aAAa,WAAW;CACnC;AACF"}

package/dist/mx/clabe.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/mx/clabe.d.ts
 declare const compact: (value: string) => string;
@@ -11,7 +11,7 @@ declare const generate: () => string;
  *
  * Example sourced from Wikipedia CLABE article.
  */
-declare const clabe: Validator;
+declare const clabe: CountryValidator<"MX">;
 //#endregion
 export { compact, clabe as default, format, generate, validate };
 //# sourceMappingURL=clabe.d.ts.map

package/dist/mx/clabe.js

@@ -3,20 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/mx/clabe.ts
-/**
-* CLABE (Clave Bancaria Estandarizada).
-*
-* Mexican standardized bank account number used for
-* interbank electronic fund transfers. 18 digits:
-* 3 (bank code) + 3 (branch) + 11 (account number)
-* + 1 (check digit).
-*
-* The check digit is computed using a weighted sum with
-* repeating weights [3, 7, 1] modulo 10:
-* check = (10 - sum % 10) % 10.
-*
-* @see https://en.wikipedia.org/wiki/CLABE
-*/
 const WEIGHTS = [
 	3,
 	7,
@@ -71,6 +57,7 @@ const clabe = {
 	abbreviation: "CLABE",
 	aliases: ["CLABE", "Clave Bancaria Estandarizada"],
 	candidatePattern: "\\d{18}",
+	scope: "country",
 	country: "MX",
 	entityType: "any",
 	lengths: [18],

package/dist/mx/clabe.js.map

@@ -1 +1 @@
-{"version":3,"file":"clabe.js","names":[],"sources":["../../src/mx/clabe.ts"],"sourcesContent":["/**\n * CLABE (Clave Bancaria Estandarizada).\n *\n * Mexican standardized bank account number used for\n * interbank electronic fund transfers. 18 digits:\n * 3 (bank code) + 3 (branch) + 11 (account number)\n * + 1 (check digit).\n *\n * The check digit is computed using a weighted sum with\n * repeating weights [3, 7, 1] modulo 10:\n * check = (10 - sum % 10) % 10.\n *\n * @see https://en.wikipedia.org/wiki/CLABE\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 = [3, 7, 1] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Compute the CLABE check digit.\n *\n * For each of the first 17 digits, multiply by the\n * corresponding weight [3, 7, 1, 3, 7, 1, ...], take\n * the result mod 10, sum all remainders, then\n * check = (10 - sum % 10) % 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    const digit = Number(value[i]);\n    // SAFETY: modulo guarantees valid index\n    // eslint-disable-next-line no-non-null-assertion\n    const weight = WEIGHTS[i % WEIGHTS.length]!;\n    sum += (digit * weight) % 10;\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\"INVALID_LENGTH\", \"CLABE must be 18 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CLABE must contain only digits\",\n    );\n  }\n\n  // Verify check digit (last digit).\n  const expected = calcCheckDigit(v);\n  if (v[17] !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CLABE check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 17)} ${v.slice(17)}`;\n};\n\n/** Generate a random valid Mexican CLABE. */\nconst generate = (): string => {\n  const payload = randomDigits(17);\n  return payload + calcCheckDigit(payload);\n};\n\n/**\n * Mexican CLABE (standardized bank account number).\n *\n * Example sourced from Wikipedia CLABE article.\n */\nconst clabe: Validator = {\n  name: \"Mexican Bank Account\",\n  localName: \"Clave Bancaria Estandarizada\",\n  abbreviation: \"CLABE\",\n  aliases: [\n    \"CLABE\",\n    \"Clave Bancaria Estandarizada\",\n  ] as const,\n  candidatePattern: \"\\\\d{18}\",\n  country: \"MX\",\n  entityType: \"any\",\n  lengths: [18] as const,\n  examples: [\"032180000118359719\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CLABE\",\n  generate,\n};\n\nexport default clabe;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAE;AAEzB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;;;;;;;;;AAU3B,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,QAAQ,OAAO,MAAM,GAAG;EAG9B,MAAM,SAAS,QAAQ,IAAI,QAAQ;AACnC,SAAQ,QAAQ,SAAU;;AAE5B,QAAO,QAAQ,KAAM,MAAM,MAAO,GAAG;;AAGvC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,0BAA0B;AAGzD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;CAIH,MAAM,WAAW,eAAe,EAAE;AAClC,KAAI,EAAE,QAAQ,SACZ,QAAO,IACL,oBACA,mCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI3E,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,GAAG;AAChC,QAAO,UAAU,eAAe,QAAQ;;;;;;;AAQ1C,MAAM,QAAmB;CACvB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,SACA,+BACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,qBAAqB;CAChC;CACA;CACA;CACA,WAAW;CACX;CACD"}
+{"version":3,"file":"clabe.js","names":[],"sources":["../../src/mx/clabe.ts"],"sourcesContent":["/**\n * CLABE (Clave Bancaria Estandarizada).\n *\n * Mexican standardized bank account number used for\n * interbank electronic fund transfers. 18 digits:\n * 3 (bank code) + 3 (branch) + 11 (account number)\n * + 1 (check digit).\n *\n * The check digit is computed using a weighted sum with\n * repeating weights [3, 7, 1] modulo 10:\n * check = (10 - sum % 10) % 10.\n *\n * @see https://en.wikipedia.org/wiki/CLABE\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 = [3, 7, 1] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Compute the CLABE check digit.\n *\n * For each of the first 17 digits, multiply by the\n * corresponding weight [3, 7, 1, 3, 7, 1, ...], take\n * the result mod 10, sum all remainders, then\n * check = (10 - sum % 10) % 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    const digit = Number(value[i]);\n    // SAFETY: modulo guarantees valid index\n    // eslint-disable-next-line no-non-null-assertion\n    const weight = WEIGHTS[i % WEIGHTS.length]!;\n    sum += (digit * weight) % 10;\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\"INVALID_LENGTH\", \"CLABE must be 18 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CLABE must contain only digits\",\n    );\n  }\n\n  // Verify check digit (last digit).\n  const expected = calcCheckDigit(v);\n  if (v[17] !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CLABE check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 17)} ${v.slice(17)}`;\n};\n\n/** Generate a random valid Mexican CLABE. */\nconst generate = (): string => {\n  const payload = randomDigits(17);\n  return payload + calcCheckDigit(payload);\n};\n\n/**\n * Mexican CLABE (standardized bank account number).\n *\n * Example sourced from Wikipedia CLABE article.\n */\nconst clabe: CountryValidator<\"MX\"> = {\n  name: \"Mexican Bank Account\",\n  localName: \"Clave Bancaria Estandarizada\",\n  abbreviation: \"CLABE\",\n  aliases: [\n    \"CLABE\",\n    \"Clave Bancaria Estandarizada\",\n  ] as const,\n  candidatePattern: \"\\\\d{18}\",\n  scope: \"country\",\n  country: \"MX\",\n  entityType: \"any\",\n  lengths: [18] as const,\n  examples: [\"032180000118359719\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CLABE\",\n  generate,\n};\n\nexport default clabe;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAyBA,MAAM,UAAU;CAAC;CAAG;CAAG;AAAC;AAExB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,KAAK;;;;;;;;;AAU1B,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,QAAQ,OAAO,MAAM,EAAE;EAG7B,MAAM,SAAS,QAAQ,IAAI,QAAQ;EACnC,OAAQ,QAAQ,SAAU;CAC5B;CACA,OAAO,QAAQ,KAAM,MAAM,MAAO,EAAE;AACtC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IAAI,kBAAkB,yBAAyB;CAGxD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,gCACF;CAIF,MAAM,WAAW,eAAe,CAAC;CACjC,IAAI,EAAE,QAAQ,UACZ,OAAO,IACL,oBACA,kCACF;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,EAAE,GAAG,EAAE,MAAM,EAAE;AAC1E;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,OAAO,UAAU,eAAe,OAAO;AACzC;;;;;;AAOA,MAAM,QAAgC;CACpC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,SACA,8BACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,oBAAoB;CAC/B;CACA;CACA;CACA,WAAW;CACX;AACF"}

package/dist/mx/curp.d.ts

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

package/dist/mx/curp.js

@@ -1,23 +1,8 @@
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/mx/curp.ts
-/**
-* CURP (Clave Única de Registro de Población).
-*
-* Mexican personal identification number. 18 characters:
-* 4 letters (name encoding) + 6 digits (YYMMDD birth
-* date) + 1 letter (gender: H=male, M=female) + 2
-* letters (state code) + 3 consonants (name
-* disambiguation) + 1 digit (century discriminator) +
-* 1 check digit.
-*
-* The check digit is computed as a weighted sum mod 10
-* using an alphabet mapping (0-9, A-N, &, O-Z).
-*
-* @see https://en.wikipedia.org/wiki/CURP
-*/
 /** Valid Mexican state codes (2-letter). */
 const STATE_CODES = new Set([
 	"AS",
@@ -63,7 +48,7 @@ const LETTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 */
 const ALPHABET = "0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ";
 const CHAR_MAP = /* @__PURE__ */ new Map();
-for (const [i, ch] of [...ALPHABET].entries()) CHAR_MAP.set(ch, i);
+for (const [i, ch] of ALPHABET.split("").entries()) CHAR_MAP.set(ch, i);
 const compact = (value) => clean(value, " -").trim().toUpperCase();
 /**
 * Compute the CURP check digit. Sum each of the first
@@ -145,6 +130,7 @@ const curp = {
 	abbreviation: "CURP",
 	aliases: ["CURP", "Clave Única de Registro de Población"],
 	candidatePattern: "[A-Z]{4}\\d{6}[HM][A-Z]{5}[A-Z\\d]\\d",
+	scope: "country",
 	country: "MX",
 	entityType: "person",
 	lengths: [18],

package/dist/mx/curp.js.map

@@ -1 +1 @@
-{"version":3,"file":"curp.js","names":[],"sources":["../../src/mx/curp.ts"],"sourcesContent":["/**\n * CURP (Clave Única de Registro de Población).\n *\n * Mexican personal identification number. 18 characters:\n * 4 letters (name encoding) + 6 digits (YYMMDD birth\n * date) + 1 letter (gender: H=male, M=female) + 2\n * letters (state code) + 3 consonants (name\n * disambiguation) + 1 digit (century discriminator) +\n * 1 check digit.\n *\n * The check digit is computed as a weighted sum mod 10\n * using an alphabet mapping (0-9, A-N, &, O-Z).\n *\n * @see https://en.wikipedia.org/wiki/CURP\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\n/** Valid Mexican state codes (2-letter). */\nconst STATE_CODES = new Set([\n  \"AS\",\n  \"BC\",\n  \"BS\",\n  \"CC\",\n  \"CL\",\n  \"CM\",\n  \"CS\",\n  \"CH\",\n  \"DF\",\n  \"DG\",\n  \"GT\",\n  \"GR\",\n  \"HG\",\n  \"JC\",\n  \"MC\",\n  \"MN\",\n  \"MS\",\n  \"NT\",\n  \"NL\",\n  \"OC\",\n  \"PL\",\n  \"QT\",\n  \"QR\",\n  \"SP\",\n  \"SL\",\n  \"SR\",\n  \"TC\",\n  \"TS\",\n  \"TL\",\n  \"VZ\",\n  \"YN\",\n  \"ZS\",\n  \"NE\", // Born abroad\n]);\nconst STATE_CODE_LIST = [...STATE_CODES];\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\n/**\n * Alphabet for CURP check digit computation.\n * Matches python-stdnum: digits 0-9, then A-N,\n * ampersand, O-Z.\n */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (const [i, ch] of [...ALPHABET].entries()) {\n  CHAR_MAP.set(ch, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim().toUpperCase();\n\n/**\n * Compute the CURP check digit. Sum each of the first\n * 17 characters multiplied by weight (18 - position),\n * then check = (10 - sum % 10) % 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    sum += (CHAR_MAP.get(ch) ?? 0) * (18 - i);\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\n/**\n * Resolve full year from 2-digit year and century\n * discriminator: 0-9 = 1900s, letter = 2000s.\n */\nconst resolveCurpYear = (\n  yy: number,\n  centuryChar: string,\n): number =>\n  centuryChar >= \"0\" && centuryChar <= \"9\"\n    ? 1900 + yy\n    : 2000 + yy;\n\nconst CURP_RE =\n  /^[A-Z]{4}\\d{6}[HM][A-Z]{2}[A-Z]{3}[0-9A-Z]\\d$/;\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"CURP must be 18 characters\",\n    );\n  }\n\n  if (!CURP_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CURP has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD at positions 4-9).\n  const yy = Number(v.slice(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  // SAFETY: regex validation ensures v.length === 18.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = resolveCurpYear(yy, v[16]!);\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid birth date\",\n    );\n  }\n\n  // Validate state code at positions 11-12.\n  const state = v.slice(11, 13);\n  if (!STATE_CODES.has(state)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid state code\",\n    );\n  }\n\n  // Verify check digit (last character).\n  const expected = calcCheckDigit(v);\n  if (v[17] !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CURP check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a CURP.\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(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  // SAFETY: regex validation ensures v.length === 18.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = resolveCurpYear(yy, v[16]!);\n\n  const genderChar = v[10];\n  const gender: \"male\" | \"female\" =\n    genderChar === \"H\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\nconst randomLetter = (): string =>\n  LETTERS.charAt(randomInt(0, LETTERS.length - 1));\n\n/** Generate a random valid CURP. */\nconst generate = (): string => {\n  const year = randomInt(1980, 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 gender = Math.random() < 0.5 ? \"H\" : \"M\";\n  const state =\n    STATE_CODE_LIST[\n      randomInt(0, STATE_CODE_LIST.length - 1)\n    ] ?? \"NE\";\n  const centuryChar =\n    year >= 2000 ? randomLetter() : String(randomInt(0, 9));\n  const body =\n    `${randomLetter()}${randomLetter()}` +\n    `${randomLetter()}${randomLetter()}` +\n    `${yy}${month}${day}${gender}${state}` +\n    `${randomLetter()}${randomLetter()}${randomLetter()}` +\n    `${centuryChar}`;\n  return `${body}${calcCheckDigit(body)}`;\n};\n\n/**\n * Mexican CURP (personal identification number).\n *\n * Example sourced from python-stdnum test suite.\n */\nconst curp: Validator<ParsedPersonId> = {\n  name: \"Mexican Personal ID\",\n  localName: \"Clave Única de Registro de Población\",\n  abbreviation: \"CURP\",\n  aliases: [\n    \"CURP\",\n    \"Clave Única de Registro de Población\",\n  ] as const,\n  candidatePattern: \"[A-Z]{4}\\\\d{6}[HM][A-Z]{5}[A-Z\\\\d]\\\\d\",\n  country: \"MX\",\n  entityType: \"person\",\n  lengths: [18] as const,\n  examples: [\"BOXW310820HNERXN09\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CURP\",\n};\n\nexport default curp;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"curp.js","names":[],"sources":["../../src/mx/curp.ts"],"sourcesContent":["/**\n * CURP (Clave Única de Registro de Población).\n *\n * Mexican personal identification number. 18 characters:\n * 4 letters (name encoding) + 6 digits (YYMMDD birth\n * date) + 1 letter (gender: H=male, M=female) + 2\n * letters (state code) + 3 consonants (name\n * disambiguation) + 1 digit (century discriminator) +\n * 1 check digit.\n *\n * The check digit is computed as a weighted sum mod 10\n * using an alphabet mapping (0-9, A-N, &, O-Z).\n *\n * @see https://en.wikipedia.org/wiki/CURP\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 { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\n/** Valid Mexican state codes (2-letter). */\nconst STATE_CODES = new Set([\n  \"AS\",\n  \"BC\",\n  \"BS\",\n  \"CC\",\n  \"CL\",\n  \"CM\",\n  \"CS\",\n  \"CH\",\n  \"DF\",\n  \"DG\",\n  \"GT\",\n  \"GR\",\n  \"HG\",\n  \"JC\",\n  \"MC\",\n  \"MN\",\n  \"MS\",\n  \"NT\",\n  \"NL\",\n  \"OC\",\n  \"PL\",\n  \"QT\",\n  \"QR\",\n  \"SP\",\n  \"SL\",\n  \"SR\",\n  \"TC\",\n  \"TS\",\n  \"TL\",\n  \"VZ\",\n  \"YN\",\n  \"ZS\",\n  \"NE\", // Born abroad\n]);\nconst STATE_CODE_LIST = [...STATE_CODES];\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\n/**\n * Alphabet for CURP check digit computation.\n * Matches python-stdnum: digits 0-9, then A-N,\n * ampersand, O-Z.\n */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (const [i, ch] of ALPHABET.split(\"\").entries()) {\n  CHAR_MAP.set(ch, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim().toUpperCase();\n\n/**\n * Compute the CURP check digit. Sum each of the first\n * 17 characters multiplied by weight (18 - position),\n * then check = (10 - sum % 10) % 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    sum += (CHAR_MAP.get(ch) ?? 0) * (18 - i);\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\n/**\n * Resolve full year from 2-digit year and century\n * discriminator: 0-9 = 1900s, letter = 2000s.\n */\nconst resolveCurpYear = (\n  yy: number,\n  centuryChar: string,\n): number =>\n  centuryChar >= \"0\" && centuryChar <= \"9\"\n    ? 1900 + yy\n    : 2000 + yy;\n\nconst CURP_RE =\n  /^[A-Z]{4}\\d{6}[HM][A-Z]{2}[A-Z]{3}[0-9A-Z]\\d$/;\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"CURP must be 18 characters\",\n    );\n  }\n\n  if (!CURP_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CURP has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD at positions 4-9).\n  const yy = Number(v.slice(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  // SAFETY: regex validation ensures v.length === 18.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = resolveCurpYear(yy, v[16]!);\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid birth date\",\n    );\n  }\n\n  // Validate state code at positions 11-12.\n  const state = v.slice(11, 13);\n  if (!STATE_CODES.has(state)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid state code\",\n    );\n  }\n\n  // Verify check digit (last character).\n  const expected = calcCheckDigit(v);\n  if (v[17] !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CURP check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a CURP.\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(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  // SAFETY: regex validation ensures v.length === 18.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = resolveCurpYear(yy, v[16]!);\n\n  const genderChar = v[10];\n  const gender: \"male\" | \"female\" =\n    genderChar === \"H\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\nconst randomLetter = (): string =>\n  LETTERS.charAt(randomInt(0, LETTERS.length - 1));\n\n/** Generate a random valid CURP. */\nconst generate = (): string => {\n  const year = randomInt(1980, 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 gender = Math.random() < 0.5 ? \"H\" : \"M\";\n  const state =\n    STATE_CODE_LIST[\n      randomInt(0, STATE_CODE_LIST.length - 1)\n    ] ?? \"NE\";\n  const centuryChar =\n    year >= 2000 ? randomLetter() : String(randomInt(0, 9));\n  const body =\n    `${randomLetter()}${randomLetter()}` +\n    `${randomLetter()}${randomLetter()}` +\n    `${yy}${month}${day}${gender}${state}` +\n    `${randomLetter()}${randomLetter()}${randomLetter()}` +\n    `${centuryChar}`;\n  return `${body}${calcCheckDigit(body)}`;\n};\n\n/**\n * Mexican CURP (personal identification number).\n *\n * Example sourced from python-stdnum test suite.\n */\nconst curp: CountryValidator<\"MX\", ParsedPersonId> = {\n  name: \"Mexican Personal ID\",\n  localName: \"Clave Única de Registro de Población\",\n  abbreviation: \"CURP\",\n  aliases: [\n    \"CURP\",\n    \"Clave Única de Registro de Población\",\n  ] as const,\n  candidatePattern: \"[A-Z]{4}\\\\d{6}[HM][A-Z]{5}[A-Z\\\\d]\\\\d\",\n  scope: \"country\",\n  country: \"MX\",\n  entityType: \"person\",\n  lengths: [18] as const,\n  examples: [\"BOXW310820HNERXN09\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CURP\",\n};\n\nexport default curp;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/mx/rfc.d.ts

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

package/dist/mx/rfc.js

@@ -1,29 +1,12 @@
 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 { isValidDate } from "../_util/date.js";
 //#region src/mx/rfc.ts
-/**
-* RFC (Registro Federal de Contribuyentes).
-*
-* Mexican tax identification number issued by the SAT
-* (Servicio de Administración Tributaria). The number is
-* 13 characters for individuals (4 letters + 6 digits
-* YYMMDD + 3 alphanumeric) or 12 characters for
-* companies (3 letters + 6 digits YYMMDD + 3
-* alphanumeric). The last character is a check digit
-* computed with a mod 11 algorithm over a specific
-* alphabet mapping.
-*
-* Format: AAAA######XXX (persons, 13 chars)
-*         AAA######XXX  (companies, 12 chars)
-*
-* @see https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)
-*/
 /** Alphabet for RFC check digit computation. */
 const ALPHABET = "0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ";
 const CHAR_MAP = /* @__PURE__ */ new Map();
-for (const [i, ch] of [...ALPHABET].entries()) CHAR_MAP.set(ch, i);
+for (const [i, ch] of ALPHABET.split("").entries()) CHAR_MAP.set(ch, i);
 const compact = (value) => clean(value, " -.").trim().toUpperCase();
 /**
 * Compute the RFC check digit using mod 11 with
@@ -95,6 +78,7 @@ const rfc = {
 	abbreviation: "RFC",
 	aliases: ["RFC", "Registro Federal de Contribuyentes"],
 	candidatePattern: "[A-ZÑ&]{3,4}\\d{6}[A-Z\\d]{3}",
+	scope: "country",
 	country: "MX",
 	entityType: "any",
 	lengths: [12, 13],

package/dist/mx/rfc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rfc.js","names":[],"sources":["../../src/mx/rfc.ts"],"sourcesContent":["/**\n * RFC (Registro Federal de Contribuyentes).\n *\n * Mexican tax identification number issued by the SAT\n * (Servicio de Administración Tributaria). The number is\n * 13 characters for individuals (4 letters + 6 digits\n * YYMMDD + 3 alphanumeric) or 12 characters for\n * companies (3 letters + 6 digits YYMMDD + 3\n * alphanumeric). The last character is a check digit\n * computed with a mod 11 algorithm over a specific\n * alphabet mapping.\n *\n * Format: AAAA######XXX (persons, 13 chars)\n *         AAA######XXX  (companies, 12 chars)\n *\n * @see https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/** Alphabet for RFC check digit computation. */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (const [i, ch] of [...ALPHABET].entries()) {\n  CHAR_MAP.set(ch, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim().toUpperCase();\n\n/**\n * Compute the RFC check digit using mod 11 with\n * the SAT alphabet mapping.\n *\n * Each character is mapped to its position in the\n * ALPHABET, then multiplied by a weight that starts\n * at (len + 1) and decreases by 1. The check digit\n * is (11 - sum % 11) % 11, mapped to 0-9 or \"A\".\n */\nconst calcCheckDigit = (value: string): string => {\n  // Pad 12-char company RFCs with a leading space\n  // to align weights with the 13-char algorithm.\n  const padded = value.length === 11 ? ` ${value}` : value;\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const ch = padded[i];\n    if (ch === undefined) continue;\n    const v = CHAR_MAP.get(ch) ?? 0;\n    sum += v * (13 - i);\n  }\n  const remainder = sum % 11;\n  if (remainder === 0) return \"0\";\n  const digit = 11 - remainder;\n  return digit === 10 ? \"A\" : String(digit);\n};\n\nconst PERSON_RE = /^[A-ZÑ&]{4}\\d{6}[A-Z\\d]{3}$/;\nconst COMPANY_RE = /^[A-ZÑ&]{3}\\d{6}[A-Z\\d]{3}$/;\nconst PREFIX_ALPHA = \"ABCDEFGHIJKLMNOPQRSTUVWXYZÑ&\";\nconst RFC_ALNUM = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12 && v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RFC must be 12 or 13 characters\",\n    );\n  }\n\n  const isPerson = v.length === 13;\n  const re = isPerson ? PERSON_RE : COMPANY_RE;\n  if (!re.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RFC has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD).\n  const dateOffset = isPerson ? 4 : 3;\n  const yy = Number(v.slice(dateOffset, dateOffset + 2));\n  const mm = Number(\n    v.slice(dateOffset + 2, dateOffset + 4),\n  );\n  const dd = Number(\n    v.slice(dateOffset + 4, dateOffset + 6),\n  );\n\n  // RFC dates use 2-digit years; use 2000 century for\n  // date validation (any valid calendar date is accepted).\n  const year = 2000 + yy;\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RFC contains an invalid date\",\n    );\n  }\n\n  // Verify check digit (last character).\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      \"RFC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst randomCharFrom = (chars: string): string =>\n  chars.charAt(randomInt(0, chars.length - 1));\n\n/** Generate a random valid RFC. */\nconst generate = (): string => {\n  const isPerson = Math.random() < 0.5;\n  const prefixLength = isPerson ? 4 : 3;\n  let prefix = \"\";\n  for (let i = 0; i < prefixLength; i++) {\n    prefix += randomCharFrom(PREFIX_ALPHA);\n  }\n\n  const year = randomInt(2000, 2099);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  let homoclave = \"\";\n  for (let i = 0; i < 2; i++) {\n    homoclave += randomCharFrom(RFC_ALNUM);\n  }\n\n  const body =\n    `${prefix}${String(year % 100).padStart(2, \"0\")}` +\n    `${month}${day}${homoclave}`;\n  return `${body}${calcCheckDigit(body)}`;\n};\n\n/**\n * Mexican RFC (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rfc: Validator = {\n  name: \"Mexican Tax ID\",\n  localName: \"Registro Federal de Contribuyentes\",\n  abbreviation: \"RFC\",\n  aliases: [\n    \"RFC\",\n    \"Registro Federal de Contribuyentes\",\n  ] as const,\n  candidatePattern: \"[A-ZÑ&]{3,4}\\\\d{6}[A-Z\\\\d]{3}\",\n  country: \"MX\",\n  entityType: \"any\",\n  lengths: [12, 13] as const,\n  examples: [\"GODE561231GR8\", \"MAB9307148T4\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\",\n};\n\nexport default rfc;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,WAAW;AAEjB,MAAM,2BAAW,IAAI,KAAqB;AAC1C,KAAK,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC,SAAS,CAC3C,UAAS,IAAI,IAAI,EAAE;AAGrB,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa;;;;;;;;;;AAW1C,MAAM,kBAAkB,UAA0B;CAGhD,MAAM,SAAS,MAAM,WAAW,KAAK,IAAI,UAAU;CACnD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,KAAK,OAAO;AAClB,MAAI,OAAO,KAAA,EAAW;EACtB,MAAM,IAAI,SAAS,IAAI,GAAG,IAAI;AAC9B,SAAO,KAAK,KAAK;;CAEnB,MAAM,YAAY,MAAM;AACxB,KAAI,cAAc,EAAG,QAAO;CAC5B,MAAM,QAAQ,KAAK;AACnB,QAAO,UAAU,KAAK,MAAM,OAAO,MAAM;;AAG3C,MAAM,YAAY;AAClB,MAAM,aAAa;AACnB,MAAM,eAAe;AACrB,MAAM,YAAY;AAElB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,MAAM,EAAE,WAAW,GAClC,QAAO,IACL,kBACA,kCACD;CAGH,MAAM,WAAW,EAAE,WAAW;AAE9B,KAAI,EADO,WAAW,YAAY,YAC1B,KAAK,EAAE,CACb,QAAO,IACL,kBACA,4BACD;CAIH,MAAM,aAAa,WAAW,IAAI;CAClC,MAAM,KAAK,OAAO,EAAE,MAAM,YAAY,aAAa,EAAE,CAAC;CACtD,MAAM,KAAK,OACT,EAAE,MAAM,aAAa,GAAG,aAAa,EAAE,CACxC;CACD,MAAM,KAAK,OACT,EAAE,MAAM,aAAa,GAAG,aAAa,EAAE,CACxC;AAKD,KAAI,CAAC,YADQ,MAAO,IACG,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,+BACD;CAKH,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,QAAQ,MAAM;AAExD,MAAM,kBAAkB,UACtB,MAAM,OAAO,UAAU,GAAG,MAAM,SAAS,EAAE,CAAC;;AAG9C,MAAM,iBAAyB;CAE7B,MAAM,eADW,KAAK,QAAQ,GAAG,KACD,IAAI;CACpC,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,cAAc,IAChC,WAAU,eAAe,aAAa;CAGxC,MAAM,OAAO,UAAU,KAAM,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;CACrD,IAAI,YAAY;AAChB,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,cAAa,eAAe,UAAU;CAGxC,MAAM,OACJ,GAAG,SAAS,OAAO,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,GAC5C,QAAQ,MAAM;AACnB,QAAO,GAAG,OAAO,eAAe,KAAK;;;;;;;AAQvC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,qCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,IAAI,GAAG;CACjB,UAAU,CAAC,iBAAiB,eAAe;CAC3C;CACA;CACA;CACA;CACA,WACE;CACH"}
+{"version":3,"file":"rfc.js","names":[],"sources":["../../src/mx/rfc.ts"],"sourcesContent":["/**\n * RFC (Registro Federal de Contribuyentes).\n *\n * Mexican tax identification number issued by the SAT\n * (Servicio de Administración Tributaria). The number is\n * 13 characters for individuals (4 letters + 6 digits\n * YYMMDD + 3 alphanumeric) or 12 characters for\n * companies (3 letters + 6 digits YYMMDD + 3\n * alphanumeric). The last character is a check digit\n * computed with a mod 11 algorithm over a specific\n * alphabet mapping.\n *\n * Format: AAAA######XXX (persons, 13 chars)\n *         AAA######XXX  (companies, 12 chars)\n *\n * @see https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\n/** Alphabet for RFC check digit computation. */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (const [i, ch] of ALPHABET.split(\"\").entries()) {\n  CHAR_MAP.set(ch, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim().toUpperCase();\n\n/**\n * Compute the RFC check digit using mod 11 with\n * the SAT alphabet mapping.\n *\n * Each character is mapped to its position in the\n * ALPHABET, then multiplied by a weight that starts\n * at (len + 1) and decreases by 1. The check digit\n * is (11 - sum % 11) % 11, mapped to 0-9 or \"A\".\n */\nconst calcCheckDigit = (value: string): string => {\n  // Pad 12-char company RFCs with a leading space\n  // to align weights with the 13-char algorithm.\n  const padded = value.length === 11 ? ` ${value}` : value;\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const ch = padded[i];\n    if (ch === undefined) continue;\n    const v = CHAR_MAP.get(ch) ?? 0;\n    sum += v * (13 - i);\n  }\n  const remainder = sum % 11;\n  if (remainder === 0) return \"0\";\n  const digit = 11 - remainder;\n  return digit === 10 ? \"A\" : String(digit);\n};\n\nconst PERSON_RE = /^[A-ZÑ&]{4}\\d{6}[A-Z\\d]{3}$/;\nconst COMPANY_RE = /^[A-ZÑ&]{3}\\d{6}[A-Z\\d]{3}$/;\nconst PREFIX_ALPHA = \"ABCDEFGHIJKLMNOPQRSTUVWXYZÑ&\";\nconst RFC_ALNUM = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12 && v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RFC must be 12 or 13 characters\",\n    );\n  }\n\n  const isPerson = v.length === 13;\n  const re = isPerson ? PERSON_RE : COMPANY_RE;\n  if (!re.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RFC has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD).\n  const dateOffset = isPerson ? 4 : 3;\n  const yy = Number(v.slice(dateOffset, dateOffset + 2));\n  const mm = Number(\n    v.slice(dateOffset + 2, dateOffset + 4),\n  );\n  const dd = Number(\n    v.slice(dateOffset + 4, dateOffset + 6),\n  );\n\n  // RFC dates use 2-digit years; use 2000 century for\n  // date validation (any valid calendar date is accepted).\n  const year = 2000 + yy;\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RFC contains an invalid date\",\n    );\n  }\n\n  // Verify check digit (last character).\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      \"RFC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst randomCharFrom = (chars: string): string =>\n  chars.charAt(randomInt(0, chars.length - 1));\n\n/** Generate a random valid RFC. */\nconst generate = (): string => {\n  const isPerson = Math.random() < 0.5;\n  const prefixLength = isPerson ? 4 : 3;\n  let prefix = \"\";\n  for (let i = 0; i < prefixLength; i++) {\n    prefix += randomCharFrom(PREFIX_ALPHA);\n  }\n\n  const year = randomInt(2000, 2099);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  let homoclave = \"\";\n  for (let i = 0; i < 2; i++) {\n    homoclave += randomCharFrom(RFC_ALNUM);\n  }\n\n  const body =\n    `${prefix}${String(year % 100).padStart(2, \"0\")}` +\n    `${month}${day}${homoclave}`;\n  return `${body}${calcCheckDigit(body)}`;\n};\n\n/**\n * Mexican RFC (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rfc: CountryValidator<\"MX\"> = {\n  name: \"Mexican Tax ID\",\n  localName: \"Registro Federal de Contribuyentes\",\n  abbreviation: \"RFC\",\n  aliases: [\n    \"RFC\",\n    \"Registro Federal de Contribuyentes\",\n  ] as const,\n  candidatePattern: \"[A-ZÑ&]{3,4}\\\\d{6}[A-Z\\\\d]{3}\",\n  scope: \"country\",\n  country: \"MX\",\n  entityType: \"any\",\n  lengths: [12, 13] as const,\n  examples: [\"GODE561231GR8\", \"MAB9307148T4\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\",\n};\n\nexport default rfc;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;AA6BA,MAAM,WAAW;AAEjB,MAAM,2BAAW,IAAI,IAAoB;AACzC,KAAK,MAAM,CAAC,GAAG,OAAO,SAAS,MAAM,EAAE,EAAE,QAAQ,GAC/C,SAAS,IAAI,IAAI,CAAC;AAGpB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY;;;;;;;;;;AAWzC,MAAM,kBAAkB,UAA0B;CAGhD,MAAM,SAAS,MAAM,WAAW,KAAK,IAAI,UAAU;CACnD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,KAAK,OAAO;EAClB,IAAI,OAAO,KAAA,GAAW;EACtB,MAAM,IAAI,SAAS,IAAI,EAAE,KAAK;EAC9B,OAAO,KAAK,KAAK;CACnB;CACA,MAAM,YAAY,MAAM;CACxB,IAAI,cAAc,GAAG,OAAO;CAC5B,MAAM,QAAQ,KAAK;CACnB,OAAO,UAAU,KAAK,MAAM,OAAO,KAAK;AAC1C;AAEA,MAAM,YAAY;AAClB,MAAM,aAAa;AACnB,MAAM,eAAe;AACrB,MAAM,YAAY;AAElB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,MAAM,EAAE,WAAW,IAClC,OAAO,IACL,kBACA,iCACF;CAGF,MAAM,WAAW,EAAE,WAAW;CAE9B,IAAI,EADO,WAAW,YAAY,YAC1B,KAAK,CAAC,GACZ,OAAO,IACL,kBACA,2BACF;CAIF,MAAM,aAAa,WAAW,IAAI;CAClC,MAAM,KAAK,OAAO,EAAE,MAAM,YAAY,aAAa,CAAC,CAAC;CACrD,MAAM,KAAK,OACT,EAAE,MAAM,aAAa,GAAG,aAAa,CAAC,CACxC;CACA,MAAM,KAAK,OACT,EAAE,MAAM,aAAa,GAAG,aAAa,CAAC,CACxC;CAKA,IAAI,CAAC,YADQ,MAAO,IACG,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,8BACF;CAKF,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,QAAQ,KAAK;AAEvD,MAAM,kBAAkB,UACtB,MAAM,OAAO,UAAU,GAAG,MAAM,SAAS,CAAC,CAAC;;AAG7C,MAAM,iBAAyB;CAE7B,MAAM,eADW,KAAK,OAAO,IAAI,KACD,IAAI;CACpC,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,cAAc,KAChC,UAAU,eAAe,YAAY;CAGvC,MAAM,OAAO,UAAU,KAAM,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;CACpD,IAAI,YAAY;CAChB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,aAAa,eAAe,SAAS;CAGvC,MAAM,OACJ,GAAG,SAAS,OAAO,OAAO,GAAG,EAAE,SAAS,GAAG,GAAG,IAC3C,QAAQ,MAAM;CACnB,OAAO,GAAG,OAAO,eAAe,IAAI;AACtC;;;;;;AAOA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,oCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,IAAI,EAAE;CAChB,UAAU,CAAC,iBAAiB,cAAc;CAC1C;CACA;CACA;CACA;CACA,WACE;AACJ"}

package/dist/my/nric.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/my/nric.d.ts
 declare const compact: (value: string) => string;
@@ -12,7 +12,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid Malaysian NRIC. */
 declare const generate: () => string;
 /** Malaysian National Registration Identity Card. */
-declare const nric: Validator<ParsedPersonId>;
+declare const nric: CountryValidator<"MY", ParsedPersonId>;
 //#endregion
 export { compact, nric as default, format, generate, parse, validate };
 //# sourceMappingURL=nric.d.ts.map

package/dist/my/nric.js

@@ -1,23 +1,10 @@
 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";
 //#region src/my/nric.ts
 /**
-* NRIC (Malaysian National Registration Identity
-* Card Number, Nombor Kad Pengenalan).
-*
-* 12 digits: YYMMDD (birth date) + PB (place of
-* birth, 2 digits) + SSS (serial) + G (gender:
-* odd = male, even = female).
-*
-* No checksum; validation is structural (valid date
-* and valid place-of-birth code).
-*
-* @see https://en.wikipedia.org/wiki/Malaysian_identity_card
-*/
-/**
 * Valid place-of-birth codes (2-digit).
 * Codes 01-16 are states, 21-59 are pre-2000
 * state codes, 60-68 born outside (ASEAN),
@@ -182,6 +169,7 @@ const nric = {
 		"kad pengenalan"
 	],
 	candidatePattern: "\\d{6}-?\\d{2}-?\\d{4}",
+	scope: "country",
 	country: "MY",
 	entityType: "person",
 	description: "12-digit identity card number encoding birth date, place of birth, and gender",

package/dist/my/nric.js.map

@@ -1 +1 @@
-{"version":3,"file":"nric.js","names":[],"sources":["../../src/my/nric.ts"],"sourcesContent":["/**\n * NRIC (Malaysian National Registration Identity\n * Card Number, Nombor Kad Pengenalan).\n *\n * 12 digits: YYMMDD (birth date) + PB (place of\n * birth, 2 digits) + SSS (serial) + G (gender:\n * odd = male, even = female).\n *\n * No checksum; validation is structural (valid date\n * and valid place-of-birth code).\n *\n * @see https://en.wikipedia.org/wiki/Malaysian_identity_card\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\n/**\n * Valid place-of-birth codes (2-digit).\n * Codes 01-16 are states, 21-59 are pre-2000\n * state codes, 60-68 born outside (ASEAN),\n * 71-72/74-79 foreign nationals, 82-93 regions,\n * 98-99 legacy.\n */\nconst VALID_PB_CODES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"07\",\n  \"08\",\n  \"09\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"28\",\n  \"29\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"49\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"78\",\n  \"79\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"89\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"98\",\n  \"99\",\n]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Resolve the birth year from a 2-digit year.\n * Years after the reference year are assumed to be\n * in the previous century. Accepts an explicit\n * reference year to avoid multiple clock reads.\n */\nconst resolveYear = (\n  yy: number,\n  referenceYear: number,\n): number => {\n  const century = Math.floor(referenceYear / 100);\n  const year = century * 100 + yy;\n  return year > referenceYear ? year - 100 : year;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NRIC must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NRIC must contain only digits\",\n    );\n  }\n\n  // Validate birth date (YYMMDD)\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\n  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"NRIC contains an invalid birth date\",\n    );\n  }\n\n  // Validate place-of-birth code\n  const pb = v.slice(6, 8);\n  if (!VALID_PB_CODES.has(pb)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Invalid place-of-birth code: \" + pb,\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return (\n    v.slice(0, 6) + \"-\" + v.slice(6, 8) + \"-\" + v.slice(8)\n  );\n};\n\n/**\n * Extract birth date and gender from an NRIC.\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  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  // Last digit: odd = male, even = female\n  const lastDigit = Number(v[11]);\n  const gender = lastDigit % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\nconst PB_CODES = [...VALID_PB_CODES];\n\n/** Generate a random valid Malaysian NRIC. */\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 pb =\n    PB_CODES[randomInt(0, PB_CODES.length - 1)] ?? \"01\";\n  const serial = String(randomInt(0, 999)).padStart(3, \"0\");\n  const isMale = Math.random() < 0.5;\n  const lastDigit = isMale\n    ? String(randomInt(0, 4) * 2 + 1)\n    : String(randomInt(0, 4) * 2);\n\n  return (\n    `${String(year % 100).padStart(2, \"0\")}` +\n    `${month}${day}${pb}${serial}${lastDigit}`\n  );\n};\n\n/** Malaysian National Registration Identity Card. */\nconst nric: Validator<ParsedPersonId> = {\n  name: \"Malaysian National Registration Identity Card Number\",\n  localName: \"Nombor Kad Pengenalan\",\n  abbreviation: \"NRIC\",\n  aliases: [\"NRIC\", \"MyKad\", \"kad pengenalan\"] as const,\n  candidatePattern: \"\\\\d{6}-?\\\\d{2}-?\\\\d{4}\",\n  country: \"MY\",\n  entityType: \"person\",\n  description:\n    \"12-digit identity card number encoding birth date, place of birth, and gender\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Malaysian_identity_card\",\n  lengths: [12] as const,\n  examples: [\"770305021234\", \"880715141234\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default nric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;;;;;;AAQpB,MAAM,eACJ,IACA,kBACW;CAEX,MAAM,OADU,KAAK,MAAM,gBAAgB,IAAI,GACxB,MAAM;AAC7B,QAAO,OAAO,gBAAgB,OAAO,MAAM;;AAG7C,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,gCACD;CAIH,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,YAAY,qBADb,IAAI,MAAM,EAAC,aAAa,CACH,EAEV,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,sCACD;CAIH,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACxB,KAAI,CAAC,eAAe,IAAI,GAAG,CACzB,QAAO,IACL,qBACA,kCAAkC,GACnC;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QACE,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE;;;;;;AAQ1D,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;CAEhC,MAAM,OAAO,YAAY,qBADb,IAAI,MAAM,EAAC,aAAa,CACH;CAIjC,MAAM,SADY,OAAO,EAAE,IAAI,GACJ,MAAM,IAAI,SAAS;AAE9C,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;AAGH,MAAM,WAAW,CAAC,GAAG,eAAe;;AAGpC,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;CACrD,MAAM,KACJ,SAAS,UAAU,GAAG,SAAS,SAAS,EAAE,KAAK;CACjD,MAAM,SAAS,OAAO,UAAU,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI;CAEzD,MAAM,YADS,KAAK,QAAQ,GAAG,KAE3B,OAAO,UAAU,GAAG,EAAE,GAAG,IAAI,EAAE,GAC/B,OAAO,UAAU,GAAG,EAAE,GAAG,EAAE;AAE/B,QACE,GAAG,OAAO,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,GACnC,QAAQ,MAAM,KAAK,SAAS;;;AAKnC,MAAM,OAAkC;CACtC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAS;EAAiB;CAC5C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nric.js","names":[],"sources":["../../src/my/nric.ts"],"sourcesContent":["/**\n * NRIC (Malaysian National Registration Identity\n * Card Number, Nombor Kad Pengenalan).\n *\n * 12 digits: YYMMDD (birth date) + PB (place of\n * birth, 2 digits) + SSS (serial) + G (gender:\n * odd = male, even = female).\n *\n * No checksum; validation is structural (valid date\n * and valid place-of-birth code).\n *\n * @see https://en.wikipedia.org/wiki/Malaysian_identity_card\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 { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/**\n * Valid place-of-birth codes (2-digit).\n * Codes 01-16 are states, 21-59 are pre-2000\n * state codes, 60-68 born outside (ASEAN),\n * 71-72/74-79 foreign nationals, 82-93 regions,\n * 98-99 legacy.\n */\nconst VALID_PB_CODES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"07\",\n  \"08\",\n  \"09\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"28\",\n  \"29\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"49\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"78\",\n  \"79\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"89\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"98\",\n  \"99\",\n]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Resolve the birth year from a 2-digit year.\n * Years after the reference year are assumed to be\n * in the previous century. Accepts an explicit\n * reference year to avoid multiple clock reads.\n */\nconst resolveYear = (\n  yy: number,\n  referenceYear: number,\n): number => {\n  const century = Math.floor(referenceYear / 100);\n  const year = century * 100 + yy;\n  return year > referenceYear ? year - 100 : year;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NRIC must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NRIC must contain only digits\",\n    );\n  }\n\n  // Validate birth date (YYMMDD)\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\n  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"NRIC contains an invalid birth date\",\n    );\n  }\n\n  // Validate place-of-birth code\n  const pb = v.slice(6, 8);\n  if (!VALID_PB_CODES.has(pb)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Invalid place-of-birth code: \" + pb,\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return (\n    v.slice(0, 6) + \"-\" + v.slice(6, 8) + \"-\" + v.slice(8)\n  );\n};\n\n/**\n * Extract birth date and gender from an NRIC.\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  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  // Last digit: odd = male, even = female\n  const lastDigit = Number(v[11]);\n  const gender = lastDigit % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\nconst PB_CODES = [...VALID_PB_CODES];\n\n/** Generate a random valid Malaysian NRIC. */\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 pb =\n    PB_CODES[randomInt(0, PB_CODES.length - 1)] ?? \"01\";\n  const serial = String(randomInt(0, 999)).padStart(3, \"0\");\n  const isMale = Math.random() < 0.5;\n  const lastDigit = isMale\n    ? String(randomInt(0, 4) * 2 + 1)\n    : String(randomInt(0, 4) * 2);\n\n  return (\n    `${String(year % 100).padStart(2, \"0\")}` +\n    `${month}${day}${pb}${serial}${lastDigit}`\n  );\n};\n\n/** Malaysian National Registration Identity Card. */\nconst nric: CountryValidator<\"MY\", ParsedPersonId> = {\n  name: \"Malaysian National Registration Identity Card Number\",\n  localName: \"Nombor Kad Pengenalan\",\n  abbreviation: \"NRIC\",\n  aliases: [\"NRIC\", \"MyKad\", \"kad pengenalan\"] as const,\n  candidatePattern: \"\\\\d{6}-?\\\\d{2}-?\\\\d{4}\",\n  scope: \"country\",\n  country: \"MY\",\n  entityType: \"person\",\n  description:\n    \"12-digit identity card number encoding birth date, place of birth, and gender\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Malaysian_identity_card\",\n  lengths: [12] as const,\n  examples: [\"770305021234\", \"880715141234\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default nric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;;;;;;;;AAiCA,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;;;;;;;AAQnB,MAAM,eACJ,IACA,kBACW;CAEX,MAAM,OADU,KAAK,MAAM,gBAAgB,GACxB,IAAI,MAAM;CAC7B,OAAO,OAAO,gBAAgB,OAAO,MAAM;AAC7C;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,+BACF;CAIF,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,YAAY,qBADb,IAAI,KAAK,GAAE,YACQ,CAEX,GAAG,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,qCACF;CAIF,MAAM,KAAK,EAAE,MAAM,GAAG,CAAC;CACvB,IAAI,CAAC,eAAe,IAAI,EAAE,GACxB,OAAO,IACL,qBACA,kCAAkC,EACpC;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OACE,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,MAAM,CAAC;AAEzD;;;;;AAMA,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;CAE/B,MAAM,OAAO,YAAY,qBADb,IAAI,KAAK,GAAE,YACQ,CAAC;CAIhC,MAAM,SADY,OAAO,EAAE,GACJ,IAAI,MAAM,IAAI,SAAS;CAE9C,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE;EACpC;CACF;AACF;AAEA,MAAM,WAAW,CAAC,GAAG,cAAc;;AAGnC,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;CACpD,MAAM,KACJ,SAAS,UAAU,GAAG,SAAS,SAAS,CAAC,MAAM;CACjD,MAAM,SAAS,OAAO,UAAU,GAAG,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG;CAExD,MAAM,YADS,KAAK,OAAO,IAAI,KAE3B,OAAO,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,IAC9B,OAAO,UAAU,GAAG,CAAC,IAAI,CAAC;CAE9B,OACE,GAAG,OAAO,OAAO,GAAG,EAAE,SAAS,GAAG,GAAG,IAClC,QAAQ,MAAM,KAAK,SAAS;AAEnC;;AAGA,MAAM,OAA+C;CACnD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAS;CAAgB;CAC3C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,gBAAgB,cAAc;CACzC;CACA;CACA;CACA;CACA;AACF"}

package/dist/ng/nin.d.ts

@@ -1,13 +1,24 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ng/nin.d.ts
 /** Generate a random valid Nigerian NIN. */
 declare const generate: () => string;
+/**
+ * NIN (National Identification Number, Nigeria).
+ *
+ * 11-digit number randomly assigned by NIMC (National
+ * Identity Management Commission). No checksum; the
+ * digits are non-intelligible and carry no embedded
+ * meaning. Once assigned, a NIN is permanent and
+ * cannot be reassigned.
+ *
+ * @see https://nimc.gov.ng/about-nin/
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Nigerian National Identification Number. */
-declare const nin: Validator;
+declare const nin: CountryValidator<"NG">;
 //#endregion
 export { compact, nin as default, format, generate, validate };
 //# sourceMappingURL=nin.d.ts.map

package/dist/ng/nin.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/ng/nin.ts
-/**
-* NIN (National Identification Number, Nigeria).
-*
-* 11-digit number randomly assigned by NIMC (National
-* Identity Management Commission). No checksum; the
-* digits are non-intelligible and carry no embedded
-* meaning. Once assigned, a NIN is permanent and
-* cannot be reassigned.
-*
-* @see https://nimc.gov.ng/about-nin/
-*/
 /** Generate a random valid Nigerian NIN. */
 const generate = () => randomDigits(11);
 const compact = (value) => clean(value, " -");
@@ -37,6 +26,7 @@ const nin = {
 	abbreviation: "NIN",
 	aliases: ["NIN", "National Identification Number"],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "NG",
 	entityType: "person",
 	lengths: [11],

package/dist/ng/nin.js.map

@@ -1 +1 @@
-{"version":3,"file":"nin.js","names":[],"sources":["../../src/ng/nin.ts"],"sourcesContent":["/** Generate a random valid Nigerian NIN. */\nconst generate = (): string => randomDigits(11);\n\n/**\n * NIN (National Identification Number, Nigeria).\n *\n * 11-digit number randomly assigned by NIMC (National\n * Identity Management Commission). No checksum; the\n * digits are non-intelligible and carry no embedded\n * meaning. Once assigned, a NIN is permanent and\n * cannot be reassigned.\n *\n * @see https://nimc.gov.ng/about-nin/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Nigerian NIN must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nigerian NIN must contain only digits\",\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, 3)} ${v.slice(3, 7)} ${v.slice(7)}`;\n};\n\n/** Nigerian National Identification Number. */\nconst nin: Validator = {\n  name: \"National Identification Number\",\n  localName: \"National Identification Number\",\n  abbreviation: \"NIN\",\n  aliases: [\n    \"NIN\",\n    \"National Identification Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"NG\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"13478900989\", \"70123456789\"] as const,\n  description:\n    \"11-digit national identity number issued by NIMC\",\n  sourceUrl: \"https://nimc.gov.ng/about-nin/\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB,aAAa,GAAG;AAqB/C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,wCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,iCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe,cAAc;CACxC,aACE;CACF,WAAW;CACX;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nin.js","names":[],"sources":["../../src/ng/nin.ts"],"sourcesContent":["/** Generate a random valid Nigerian NIN. */\nconst generate = (): string => randomDigits(11);\n\n/**\n * NIN (National Identification Number, Nigeria).\n *\n * 11-digit number randomly assigned by NIMC (National\n * Identity Management Commission). No checksum; the\n * digits are non-intelligible and carry no embedded\n * meaning. Once assigned, a NIN is permanent and\n * cannot be reassigned.\n *\n * @see https://nimc.gov.ng/about-nin/\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 compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Nigerian NIN must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nigerian NIN must contain only digits\",\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, 3)} ${v.slice(3, 7)} ${v.slice(7)}`;\n};\n\n/** Nigerian National Identification Number. */\nconst nin: CountryValidator<\"NG\"> = {\n  name: \"National Identification Number\",\n  localName: \"National Identification Number\",\n  abbreviation: \"NIN\",\n  aliases: [\n    \"NIN\",\n    \"National Identification Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  scope: \"country\",\n  country: \"NG\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"13478900989\", \"70123456789\"] as const,\n  description:\n    \"11-digit national identity number issued by NIMC\",\n  sourceUrl: \"https://nimc.gov.ng/about-nin/\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB,aAAa,EAAE;AAwB9C,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,uCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACvD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,gCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,eAAe,aAAa;CACvC,aACE;CACF,WAAW;CACX;CACA;CACA;CACA;AACF"}

package/dist/ni/ruc.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ni/ruc.d.ts
 /**
@@ -16,7 +16,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Nicaraguan RUC (legal entity). */
 declare const generate: () => string;
 /** Nicaragua tax identification number. */
-declare const ruc: Validator;
+declare const ruc: CountryValidator<"NI">;
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 //# sourceMappingURL=ruc.d.ts.map

package/dist/ni/ruc.js

@@ -4,29 +4,6 @@ import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ni/ruc.ts
 /**
-* RUC (Registro Único de Contribuyente, Nicaragua
-* tax number).
-*
-* For natural persons the RUC is the cédula de
-* identidad: 14 characters structured as
-* MMM-DDMMYY-NNNNL where:
-*   - MMM  = municipality code (001–999)
-*   - DDMMYY = birth date
-*   - NNNN = sequential number
-*   - L = check letter (mod 23, ISO 7064)
-*
-* For legal entities (Personas Jurídicas) the RUC
-* starts with "J" followed by 13 digits. No public
-* check-digit algorithm is documented for the "J"
-* format, so validation is format-only.
-*
-* The check letter for natural persons uses modulo 23
-* with a 23-letter alphabet that excludes I, O, and Z
-* to avoid confusion with digits.
-*
-* @see https://www.dgi.gob.ni/
-*/
-/**
 * Check letter alphabet (mod 23). Excludes I, O, Z
 * to prevent transcription errors.
 */
@@ -96,6 +73,7 @@ const ruc = {
 	abbreviation: "RUC",
 	aliases: ["RUC"],
 	candidatePattern: "[JKME]\\d{13}",
+	scope: "country",
 	country: "NI",
 	entityType: "any",
 	description: "Tax identifier issued by Nicaragua's DGI",

package/dist/ni/ruc.js.map

@@ -1 +1 @@
-{"version":3,"file":"ruc.js","names":[],"sources":["../../src/ni/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyente, Nicaragua\n * tax number).\n *\n * For natural persons the RUC is the cédula de\n * identidad: 14 characters structured as\n * MMM-DDMMYY-NNNNL where:\n *   - MMM  = municipality code (001–999)\n *   - DDMMYY = birth date\n *   - NNNN = sequential number\n *   - L = check letter (mod 23, ISO 7064)\n *\n * For legal entities (Personas Jurídicas) the RUC\n * starts with \"J\" followed by 13 digits. No public\n * check-digit algorithm is documented for the \"J\"\n * format, so validation is format-only.\n *\n * The check letter for natural persons uses modulo 23\n * with a 23-letter alphabet that excludes I, O, and Z\n * to avoid confusion with digits.\n *\n * @see https://www.dgi.gob.ni/\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\n/**\n * Check letter alphabet (mod 23). Excludes I, O, Z\n * to prevent transcription errors.\n */\nconst CHECK_ALPHABET = \"ABCDEFGHJKLMNPQRSTUVWXY\";\n\n/**\n * Compact: strip spaces, hyphens, and uppercase.\n */\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim().toUpperCase();\n\n/**\n * Validate a birth date encoded as DDMMYY.\n * Returns true if the date components are plausible.\n */\nconst isValidDate = (ddmmyy: string): boolean => {\n  const day = Number(ddmmyy.slice(0, 2));\n  const month = Number(ddmmyy.slice(2, 4));\n\n  if (month < 1 || month > 12) return false;\n  if (day < 1 || day > 31) return false;\n\n  return true;\n};\n\n/**\n * Calculate the check letter for a 13-digit body\n * using modulo 23.\n */\nconst calcCheckLetter = (body: string): string => {\n  let n = 0n;\n  for (const ch of body) {\n    n = n * 10n + BigInt(ch);\n  }\n  const idx = Number(n % 23n);\n  // SAFETY: idx is always 0–22 (mod 23), and\n  // CHECK_ALPHABET has exactly 23 characters.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  return CHECK_ALPHABET[idx]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Nicaragua RUC must be 14 characters\",\n    );\n  }\n\n  // Legal entity: starts with J + 13 digits\n  if (v[0] === \"J\") {\n    if (!isdigits(v.slice(1))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Nicaragua legal entity RUC must be \" +\n          \"J followed by 13 digits\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // Natural person: 13 digits + 1 letter\n  const body = v.slice(0, 13);\n  // SAFETY: length is validated as exactly 14 above.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  const check = v[13]!;\n\n  if (!isdigits(body)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nicaragua RUC body must contain only digits\",\n    );\n  }\n\n  if (!CHECK_ALPHABET.includes(check)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nicaragua RUC check letter is invalid\",\n    );\n  }\n\n  // Validate date portion (positions 3–8: DDMMYY)\n  const datePart = body.slice(3, 9);\n  if (!isValidDate(datePart)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Nicaragua RUC contains an invalid \" + \"birth date\",\n    );\n  }\n\n  // Verify check letter\n  const expected = calcCheckLetter(body);\n  if (check !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Nicaragua RUC check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\n/**\n * Format: insert hyphens as MMM-DDMMYY-NNNNL\n * for natural persons. Legal entities are returned\n * in compact form (JNNNNNNNNNNNNN); no documented\n * segmentation exists for the J-prefix format.\n */\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v[0] === \"J\") {\n    return `J-${v.slice(1)}`;\n  }\n  return (\n    `${v.slice(0, 3)}-${v.slice(3, 9)}` + `-${v.slice(9)}`\n  );\n};\n\n/** Generate a random valid Nicaraguan RUC (legal entity). */\nconst generate = (): string => \"J\" + randomDigits(13);\n\n/** Nicaragua tax identification number. */\nconst ruc: Validator = {\n  name: \"Tax Identification Number\",\n  localName: \"Registro Único de Contribuyente\",\n  abbreviation: \"RUC\",\n  aliases: [\"RUC\"] as const,\n  candidatePattern: \"[JKME]\\\\d{13}\",\n  country: \"NI\",\n  entityType: \"any\",\n  description: \"Tax identifier issued by Nicaragua's DGI\",\n  sourceUrl: \"https://www.dgi.gob.ni/\",\n  lengths: [14] as const,\n  examples: [\"6071904680001F\", \"2811505850012D\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAM,iBAAiB;;;;AAKvB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa;;;;;AAMzC,MAAM,eAAe,WAA4B;CAC/C,MAAM,MAAM,OAAO,OAAO,MAAM,GAAG,EAAE,CAAC;CACtC,MAAM,QAAQ,OAAO,OAAO,MAAM,GAAG,EAAE,CAAC;AAExC,KAAI,QAAQ,KAAK,QAAQ,GAAI,QAAO;AACpC,KAAI,MAAM,KAAK,MAAM,GAAI,QAAO;AAEhC,QAAO;;;;;;AAOT,MAAM,mBAAmB,SAAyB;CAChD,IAAI,IAAI;AACR,MAAK,MAAM,MAAM,KACf,KAAI,IAAI,MAAM,OAAO,GAAG;AAM1B,QAAO,eAJK,OAAO,IAAI,IAAI;;AAO7B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,sCACD;AAIH,KAAI,EAAE,OAAO,KAAK;AAChB,MAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CACvB,QAAO,IACL,kBACA,6DAED;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;CAIpC,MAAM,OAAO,EAAE,MAAM,GAAG,GAAG;CAG3B,MAAM,QAAQ,EAAE;AAEhB,KAAI,CAAC,SAAS,KAAK,CACjB,QAAO,IACL,kBACA,8CACD;AAGH,KAAI,CAAC,eAAe,SAAS,MAAM,CACjC,QAAO,IACL,kBACA,wCACD;AAKH,KAAI,CAAC,YADY,KAAK,MAAM,GAAG,EAAE,CACP,CACxB,QAAO,IACL,qBACA,+CACD;AAKH,KAAI,UADa,gBAAgB,KAAK,CAEpC,QAAO,IACL,oBACA,4CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;;;;;;AASpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,OAAO,IACX,QAAO,KAAK,EAAE,MAAM,EAAE;AAExB,QACE,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAA,GAAS,EAAE,MAAM,EAAE;;;AAKxD,MAAM,iBAAyB,MAAM,aAAa,GAAG;;AAGrD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,MAAM;CAChB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aAAa;CACb,WAAW;CACX,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,kBAAkB,iBAAiB;CAC9C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ruc.js","names":[],"sources":["../../src/ni/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyente, Nicaragua\n * tax number).\n *\n * For natural persons the RUC is the cédula de\n * identidad: 14 characters structured as\n * MMM-DDMMYY-NNNNL where:\n *   - MMM  = municipality code (001–999)\n *   - DDMMYY = birth date\n *   - NNNN = sequential number\n *   - L = check letter (mod 23, ISO 7064)\n *\n * For legal entities (Personas Jurídicas) the RUC\n * starts with \"J\" followed by 13 digits. No public\n * check-digit algorithm is documented for the \"J\"\n * format, so validation is format-only.\n *\n * The check letter for natural persons uses modulo 23\n * with a 23-letter alphabet that excludes I, O, and Z\n * to avoid confusion with digits.\n *\n * @see https://www.dgi.gob.ni/\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\n/**\n * Check letter alphabet (mod 23). Excludes I, O, Z\n * to prevent transcription errors.\n */\nconst CHECK_ALPHABET = \"ABCDEFGHJKLMNPQRSTUVWXY\";\n\n/**\n * Compact: strip spaces, hyphens, and uppercase.\n */\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim().toUpperCase();\n\n/**\n * Validate a birth date encoded as DDMMYY.\n * Returns true if the date components are plausible.\n */\nconst isValidDate = (ddmmyy: string): boolean => {\n  const day = Number(ddmmyy.slice(0, 2));\n  const month = Number(ddmmyy.slice(2, 4));\n\n  if (month < 1 || month > 12) return false;\n  if (day < 1 || day > 31) return false;\n\n  return true;\n};\n\n/**\n * Calculate the check letter for a 13-digit body\n * using modulo 23.\n */\nconst calcCheckLetter = (body: string): string => {\n  let n = 0n;\n  for (const ch of body) {\n    n = n * 10n + BigInt(ch);\n  }\n  const idx = Number(n % 23n);\n  // SAFETY: idx is always 0–22 (mod 23), and\n  // CHECK_ALPHABET has exactly 23 characters.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  return CHECK_ALPHABET[idx]!;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Nicaragua RUC must be 14 characters\",\n    );\n  }\n\n  // Legal entity: starts with J + 13 digits\n  if (v[0] === \"J\") {\n    if (!isdigits(v.slice(1))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Nicaragua legal entity RUC must be \" +\n          \"J followed by 13 digits\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // Natural person: 13 digits + 1 letter\n  const body = v.slice(0, 13);\n  // SAFETY: length is validated as exactly 14 above.\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n  const check = v[13]!;\n\n  if (!isdigits(body)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nicaragua RUC body must contain only digits\",\n    );\n  }\n\n  if (!CHECK_ALPHABET.includes(check)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Nicaragua RUC check letter is invalid\",\n    );\n  }\n\n  // Validate date portion (positions 3–8: DDMMYY)\n  const datePart = body.slice(3, 9);\n  if (!isValidDate(datePart)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Nicaragua RUC contains an invalid \" + \"birth date\",\n    );\n  }\n\n  // Verify check letter\n  const expected = calcCheckLetter(body);\n  if (check !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Nicaragua RUC check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\n/**\n * Format: insert hyphens as MMM-DDMMYY-NNNNL\n * for natural persons. Legal entities are returned\n * in compact form (JNNNNNNNNNNNNN); no documented\n * segmentation exists for the J-prefix format.\n */\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v[0] === \"J\") {\n    return `J-${v.slice(1)}`;\n  }\n  return (\n    `${v.slice(0, 3)}-${v.slice(3, 9)}` + `-${v.slice(9)}`\n  );\n};\n\n/** Generate a random valid Nicaraguan RUC (legal entity). */\nconst generate = (): string => \"J\" + randomDigits(13);\n\n/** Nicaragua tax identification number. */\nconst ruc: CountryValidator<\"NI\"> = {\n  name: \"Tax Identification Number\",\n  localName: \"Registro Único de Contribuyente\",\n  abbreviation: \"RUC\",\n  aliases: [\"RUC\"] as const,\n  candidatePattern: \"[JKME]\\\\d{13}\",\n  scope: \"country\",\n  country: \"NI\",\n  entityType: \"any\",\n  description: \"Tax identifier issued by Nicaragua's DGI\",\n  sourceUrl: \"https://www.dgi.gob.ni/\",\n  lengths: [14] as const,\n  examples: [\"6071904680001F\", \"2811505850012D\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;AAsCA,MAAM,iBAAiB;;;;AAKvB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,KAAK,EAAE,YAAY;;;;;AAMxC,MAAM,eAAe,WAA4B;CAC/C,MAAM,MAAM,OAAO,OAAO,MAAM,GAAG,CAAC,CAAC;CACrC,MAAM,QAAQ,OAAO,OAAO,MAAM,GAAG,CAAC,CAAC;CAEvC,IAAI,QAAQ,KAAK,QAAQ,IAAI,OAAO;CACpC,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO;CAEhC,OAAO;AACT;;;;;AAMA,MAAM,mBAAmB,SAAyB;CAChD,IAAI,IAAI;CACR,KAAK,MAAM,MAAM,MACf,IAAI,IAAI,MAAM,OAAO,EAAE;CAMzB,OAAO,eAJK,OAAO,IAAI,GAIC;AAC1B;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,qCACF;CAIF,IAAI,EAAE,OAAO,KAAK;EAChB,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GACtB,OAAO,IACL,kBACA,4DAEF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAGA,MAAM,OAAO,EAAE,MAAM,GAAG,EAAE;CAG1B,MAAM,QAAQ,EAAE;CAEhB,IAAI,CAAC,SAAS,IAAI,GAChB,OAAO,IACL,kBACA,6CACF;CAGF,IAAI,CAAC,eAAe,SAAS,KAAK,GAChC,OAAO,IACL,kBACA,uCACF;CAKF,IAAI,CAAC,YADY,KAAK,MAAM,GAAG,CACP,CAAC,GACvB,OAAO,IACL,qBACA,8CACF;CAKF,IAAI,UADa,gBAAgB,IACZ,GACnB,OAAO,IACL,oBACA,2CACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;;;;;;AAQA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,OAAO,KACX,OAAO,KAAK,EAAE,MAAM,CAAC;CAEvB,OACE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAA,GAAU,EAAE,MAAM,CAAC;AAEvD;;AAGA,MAAM,iBAAyB,MAAM,aAAa,EAAE;;AAGpD,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,KAAK;CACf,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aAAa;CACb,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,kBAAkB,gBAAgB;CAC7C;CACA;CACA;CACA;AACF"}