@stll/stdnum 0.0.1 → 2.0.0

package/dist/mx/curp.js

@@ -1,22 +1,8 @@
 import { clean } from "../_util/clean.js";
-import { err } from "../_util/result.js";
 import { isValidDate } from "../_util/date.js";
+import { randomInt } from "../_util/generate.js";
+import { err } from "../_util/result.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",
@@ -53,6 +39,8 @@ const STATE_CODES = new Set([
 	"ZS",
 	"NE"
 ]);
+const STATE_CODE_LIST = [...STATE_CODES];
+const LETTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 /**
 * Alphabet for CURP check digit computation.
 * Matches python-stdnum: digits 0-9, then A-N,
@@ -60,7 +48,7 @@ const STATE_CODES = new Set([
 */
 const ALPHABET = "0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ";
 const CHAR_MAP = /* @__PURE__ */ new Map();
-for (let i = 0; i < 37; i++) CHAR_MAP.set(ALPHABET[i], 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
@@ -69,7 +57,11 @@ const compact = (value) => clean(value, " -").trim().toUpperCase();
 */
 const calcCheckDigit = (value) => {
 	let sum = 0;
-	for (let i = 0; i < 17; i++) sum += (CHAR_MAP.get(value[i]) ?? 0) * (18 - i);
+	for (let i = 0; i < 17; i++) {
+		const ch = value[i];
+		if (ch === void 0) continue;
+		sum += (CHAR_MAP.get(ch) ?? 0) * (18 - i);
+	}
 	return String((10 - sum % 10) % 10);
 };
 /**
@@ -114,6 +106,19 @@ const parse = (value) => {
 		gender
 	};
 };
+const randomLetter = () => LETTERS.charAt(randomInt(0, 25));
+/** Generate a random valid CURP. */
+const generate = () => {
+	const year = randomInt(1980, 2024);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	const yy = String(year % 100).padStart(2, "0");
+	const gender = Math.random() < .5 ? "H" : "M";
+	const state = STATE_CODE_LIST[randomInt(0, STATE_CODE_LIST.length - 1)] ?? "NE";
+	const centuryChar = year >= 2e3 ? randomLetter() : String(randomInt(0, 9));
+	const body = `${randomLetter()}${randomLetter()}${randomLetter()}${randomLetter()}${yy}${month}${day}${gender}${state}${randomLetter()}${randomLetter()}${randomLetter()}${centuryChar}`;
+	return `${body}${calcCheckDigit(body)}`;
+};
 /**
 * Mexican CURP (personal identification number).
 *
@@ -125,16 +130,19 @@ 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],
 	examples: ["BOXW310820HNERXN09"],
 	compact,
 	format,
+	parse,
 	validate,
+	generate,
 	sourceUrl: "https://en.wikipedia.org/wiki/CURP"
 };
 //#endregion
-export { compact, curp as default, format, parse, validate };
+export { compact, curp as default, format, generate, parse, validate };
 
 //# sourceMappingURL=curp.js.map

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 { 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]);\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 (let i = 0; i < ALPHABET.length; i++) {\n  CHAR_MAP.set(ALPHABET[i]!, 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    sum += (CHAR_MAP.get(value[i]!) ?? 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  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  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\n/**\n * Mexican CURP (personal identification number).\n *\n * Example sourced from python-stdnum test suite.\n */\nconst curp: Validator = {\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  validate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CURP\",\n};\n\nexport default curp;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,cAAc,IAAI,IAAI;CAC1B;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;;;;;;AAOF,MAAM,WAAW;AAEjB,MAAM,2BAAW,IAAI,KAAqB;AAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAiB,IACnC,UAAS,IAAI,SAAS,IAAK,EAAE;AAG/B,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa;;;;;;AAOzC,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,SAAS,IAAI,MAAM,GAAI,IAAI,MAAM,KAAK;AAEhD,QAAO,QAAQ,KAAM,MAAM,MAAO,GAAG;;;;;;AAOvC,MAAM,mBACJ,IACA,gBAEA,eAAe,OAAO,eAAe,MACjC,OAAO,KACP,MAAO;AAEb,MAAM,UACJ;AAEF,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAGH,KAAI,CAAC,QAAQ,KAAK,EAAE,CAClB,QAAO,IACL,kBACA,6BACD;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,GAAG,CAAC;AAGjC,KAAI,CAAC,YADQ,gBAAgB,IAAI,EAAE,IAAK,EACjB,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,sCACD;CAIH,MAAM,QAAQ,EAAE,MAAM,IAAI,GAAG;AAC7B,KAAI,CAAC,YAAY,IAAI,MAAM,CACzB,QAAO,IACL,qBACA,sCACD;CAIH,MAAM,WAAW,eAAe,EAAE;AAClC,KAAI,EAAE,QAAQ,SACZ,QAAO,IACL,oBACA,kCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CAEjC,MAAM,OAAO,gBAAgB,IAAI,EAAE,IAAK;CAGxC,MAAM,SADa,EAAE,QAEJ,MAAM,SAAS;AAEhC,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;;;;;;AAQH,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,uCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,qBAAqB;CAChC;CACA;CACA;CACA,WAAW;CACZ"}
+{"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":";;;;;;AA4BA,MAAM,cAAc,IAAI,IAAI;CAC1B;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;AACD,MAAM,kBAAkB,CAAC,GAAG,WAAW;AACvC,MAAM,UAAU;;;;;;AAOhB,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,IAAI,EAAE,KAAK,EAAE,YAAY;;;;;;AAOxC,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,KAAK,MAAM;EACjB,IAAI,OAAO,KAAA,GAAW;EACtB,QAAQ,SAAS,IAAI,EAAE,KAAK,MAAM,KAAK;CACzC;CACA,OAAO,QAAQ,KAAM,MAAM,MAAO,EAAE;AACtC;;;;;AAMA,MAAM,mBACJ,IACA,gBAEA,eAAe,OAAO,eAAe,MACjC,OAAO,KACP,MAAO;AAEb,MAAM,UACJ;AAEF,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4BACF;CAGF,IAAI,CAAC,QAAQ,KAAK,CAAC,GACjB,OAAO,IACL,kBACA,4BACF;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,EAAE,CAAC;CAKhC,IAAI,CAAC,YADQ,gBAAgB,IAAI,EAAE,GACf,GAAG,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,qCACF;CAIF,MAAM,QAAQ,EAAE,MAAM,IAAI,EAAE;CAC5B,IAAI,CAAC,YAAY,IAAI,KAAK,GACxB,OAAO,IACL,qBACA,qCACF;CAIF,MAAM,WAAW,eAAe,CAAC;CACjC,IAAI,EAAE,QAAQ,UACZ,OAAO,IACL,oBACA,iCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;;;;AAMvD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAIhC,MAAM,OAAO,gBAAgB,IAAI,EAAE,GAAI;CAGvC,MAAM,SADa,EAAE,QAEJ,MAAM,SAAS;CAEhC,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE;EACpC;CACF;AACF;AAEA,MAAM,qBACJ,QAAQ,OAAO,UAAU,GAAG,EAAkB,CAAC;;AAGjD,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,KAAK,OAAO,OAAO,GAAG,EAAE,SAAS,GAAG,GAAG;CAC7C,MAAM,SAAS,KAAK,OAAO,IAAI,KAAM,MAAM;CAC3C,MAAM,QACJ,gBACE,UAAU,GAAG,gBAAgB,SAAS,CAAC,MACpC;CACP,MAAM,cACJ,QAAQ,MAAO,aAAa,IAAI,OAAO,UAAU,GAAG,CAAC,CAAC;CACxD,MAAM,OACJ,GAAG,aAAa,IAAI,aAAa,IAC9B,aAAa,IAAI,aAAa,IAC9B,KAAK,QAAQ,MAAM,SAAS,QAC5B,aAAa,IAAI,aAAa,IAAI,aAAa,IAC/C;CACL,OAAO,GAAG,OAAO,eAAe,IAAI;AACtC;;;;;;AAOA,MAAM,OAA+C;CACnD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,QACA,sCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA,WAAW;AACb"}

package/dist/mx/mod.d.ts

@@ -1,10 +1,11 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import clabe from "./clabe.js";
 import curp from "./curp.js";
 import rfc from "./rfc.js";
 
 //#region src/mx/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { clabe, curp, rfc };
+}
 //#endregion
 export { clabe, curp, mod_d_exports, rfc };
 //# sourceMappingURL=mod.d.ts.map

package/dist/mx/rfc.d.ts

@@ -1,16 +1,17 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/mx/rfc.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
+/** Generate a random valid RFC. */
+declare const generate: () => string;
 /**
  * Mexican RFC (tax identification number).
  *
  * Examples sourced from python-stdnum test suite.
  */
-declare const rfc: Validator;
+declare const rfc: CountryValidator<"MX">;
 //#endregion
-export { compact, rfc as default, format, validate };
+export { compact, rfc as default, format, generate, validate };
 //# sourceMappingURL=rfc.d.ts.map

package/dist/mx/rfc.js

@@ -1,28 +1,12 @@
 import { clean } from "../_util/clean.js";
-import { err } from "../_util/result.js";
 import { isValidDate } from "../_util/date.js";
+import { randomInt } from "../_util/generate.js";
+import { err } from "../_util/result.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 (let i = 0; i < 39; i++) CHAR_MAP.set(ALPHABET[i], 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
@@ -38,6 +22,7 @@ const calcCheckDigit = (value) => {
 	let sum = 0;
 	for (let i = 0; i < 12; i++) {
 		const ch = padded[i];
+		if (ch === void 0) continue;
 		const v = CHAR_MAP.get(ch) ?? 0;
 		sum += v * (13 - i);
 	}
@@ -48,6 +33,8 @@ const calcCheckDigit = (value) => {
 };
 const PERSON_RE = /^[A-ZÑ&]{4}\d{6}[A-Z\d]{3}$/;
 const COMPANY_RE = /^[A-ZÑ&]{3}\d{6}[A-Z\d]{3}$/;
+const PREFIX_ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZÑ&";
+const RFC_ALNUM = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 const validate = (value) => {
 	const v = compact(value);
 	if (v.length !== 12 && v.length !== 13) return err("INVALID_LENGTH", "RFC must be 12 or 13 characters");
@@ -66,6 +53,20 @@ const validate = (value) => {
 	};
 };
 const format = (value) => compact(value);
+const randomCharFrom = (chars) => chars.charAt(randomInt(0, chars.length - 1));
+/** Generate a random valid RFC. */
+const generate = () => {
+	const prefixLength = Math.random() < .5 ? 4 : 3;
+	let prefix = "";
+	for (let i = 0; i < prefixLength; i++) prefix += randomCharFrom(PREFIX_ALPHA);
+	const year = randomInt(2e3, 2099);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	let homoclave = "";
+	for (let i = 0; i < 2; i++) homoclave += randomCharFrom(RFC_ALNUM);
+	const body = `${prefix}${String(year % 100).padStart(2, "0")}${month}${day}${homoclave}`;
+	return `${body}${calcCheckDigit(body)}`;
+};
 /**
 * Mexican RFC (tax identification number).
 *
@@ -77,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],
@@ -84,9 +86,10 @@ const rfc = {
 	compact,
 	format,
 	validate,
+	generate,
 	sourceUrl: "https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)"
 };
 //#endregion
-export { compact, rfc as default, format, validate };
+export { compact, rfc as default, format, generate, validate };
 
 //# sourceMappingURL=rfc.js.map

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 { 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 (let i = 0; i < ALPHABET.length; i++) {\n  CHAR_MAP.set(ALPHABET[i]!, 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    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}$/;\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\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  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\",\n};\n\nexport default rfc;\nexport { compact, format, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,WAAW;AAEjB,MAAM,2BAAW,IAAI,KAAqB;AAC1C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAiB,IACnC,UAAS,IAAI,SAAS,IAAK,EAAE;AAG/B,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;EAClB,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;AAEnB,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;;;;;;AAOxD,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,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/mod.d.ts

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

package/dist/my/nric.d.ts

@@ -1,7 +1,6 @@
-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;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -10,8 +9,10 @@ declare const format: (value: string) => string;
  * Returns null if the value is not valid.
  */
 declare const parse: (value: string) => ParsedPersonId | null;
+/** Generate a random valid Malaysian NRIC. */
+declare const generate: () => string;
 /** Malaysian National Registration Identity Card. */
-declare const nric: Validator;
+declare const nric: CountryValidator<"MY", ParsedPersonId>;
 //#endregion
-export { compact, nric as default, format, parse, validate };
+export { compact, nric as default, format, generate, parse, validate };
 //# sourceMappingURL=nric.d.ts.map

package/dist/my/nric.js

@@ -1,22 +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),
@@ -159,6 +147,17 @@ const parse = (value) => {
 		gender
 	};
 };
+const PB_CODES = [...VALID_PB_CODES];
+/** Generate a random valid Malaysian NRIC. */
+const generate = () => {
+	const year = randomInt(1950, 2024);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	const pb = PB_CODES[randomInt(0, PB_CODES.length - 1)] ?? "01";
+	const serial = String(randomInt(0, 999)).padStart(3, "0");
+	const lastDigit = Math.random() < .5 ? String(randomInt(0, 4) * 2 + 1) : String(randomInt(0, 4) * 2);
+	return `${String(year % 100).padStart(2, "0")}${month}${day}${pb}${serial}${lastDigit}`;
+};
 /** Malaysian National Registration Identity Card. */
 const nric = {
 	name: "Malaysian National Registration Identity Card Number",
@@ -170,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",
@@ -178,9 +178,11 @@ const nric = {
 	examples: ["770305021234", "880715141234"],
 	compact,
 	format,
-	validate
+	parse,
+	validate,
+	generate
 };
 //#endregion
-export { compact, nric as default, format, parse, validate };
+export { compact, nric as default, format, generate, parse, validate };
 
 //# sourceMappingURL=nric.js.map

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 { 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\n/** Malaysian National Registration Identity Card. */\nconst nric: Validator = {\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  validate,\n};\n\nexport default nric;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,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;;;AAIH,MAAM,OAAkB;CACtB,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;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/mod.d.ts

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

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/mod.d.ts

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

package/dist/ni/ruc.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ni/ruc.d.ts
-
 /**
  * Compact: strip spaces, hyphens, and uppercase.
  */
@@ -17,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",