@stll/stdnum 0.0.1 → 2.0.0

package/dist/eg/tn.js

@@ -3,15 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/eg/tn.ts
-/**
-* TN (Tax Registration Number, الرقم الضريبي).
-*
-* Egyptian tax number. 9 digits, no checksum.
-* Displayed as XXX-XXX-XXX. Accepts both
-* Arabic-Indic and Extended Arabic-Indic digits.
-*
-* @see https://www.eta.gov.eg/
-*/
 /** Generate a random valid Egyptian TN. */
 const generate = () => randomDigits(9);
 /**
@@ -64,6 +55,7 @@ const tn = {
 	abbreviation: "TN",
 	aliases: ["الرقم الضريبي", "tax number"],
 	candidatePattern: "\\d{9}",
+	scope: "country",
 	country: "EG",
 	entityType: "any",
 	compact,

package/dist/eg/tn.js.map

@@ -1 +1 @@
-{"version":3,"file":"tn.js","names":[],"sources":["../../src/eg/tn.ts"],"sourcesContent":["/** Generate a random valid Egyptian TN. */\nconst generate = (): string => randomDigits(9);\n\n/**\n * TN (Tax Registration Number, الرقم الضريبي).\n *\n * Egyptian tax number. 9 digits, no checksum.\n * Displayed as XXX-XXX-XXX. Accepts both\n * Arabic-Indic and Extended Arabic-Indic digits.\n *\n * @see https://www.eta.gov.eg/\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 * Arabic-Indic and Extended Arabic-Indic digit map.\n * Converts Arabic numeral characters to ASCII digits.\n */\nconst ARABIC_DIGITS: Record<string, string> = {\n  \"\\u0660\": \"0\", // ٠\n  \"\\u0661\": \"1\", // ١\n  \"\\u0662\": \"2\", // ٢\n  \"\\u0663\": \"3\", // ٣\n  \"\\u0664\": \"4\", // ٤\n  \"\\u0665\": \"5\", // ٥\n  \"\\u0666\": \"6\", // ٦\n  \"\\u0667\": \"7\", // ٧\n  \"\\u0668\": \"8\", // ٨\n  \"\\u0669\": \"9\", // ٩\n  \"\\u06F0\": \"0\", // ۰\n  \"\\u06F1\": \"1\", // ۱\n  \"\\u06F2\": \"2\", // ۲\n  \"\\u06F3\": \"3\", // ۳\n  \"\\u06F4\": \"4\", // ۴\n  \"\\u06F5\": \"5\", // ۵\n  \"\\u06F6\": \"6\", // ۶\n  \"\\u06F7\": \"7\", // ۷\n  \"\\u06F8\": \"8\", // ۸\n  \"\\u06F9\": \"9\", // ۹\n};\n\nconst ARABIC_REGEX = new RegExp(\n  `[${Object.keys(ARABIC_DIGITS).join(\"\")}]`,\n  \"g\",\n);\n\nconst compact = (value: string): string => {\n  const cleaned = clean(value, \" -/\");\n  return cleaned.replace(\n    ARABIC_REGEX,\n    (ch) => ARABIC_DIGITS[ch] ?? ch,\n  );\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Egyptian TN must be exactly 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Egyptian TN 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, 6)}-${v.slice(6)}`;\n};\n\n/** Egyptian Tax Registration Number. */\nconst tn: Validator = {\n  name: \"Egyptian Tax Registration Number\",\n  localName: \"الرقم الضريبي\",\n  abbreviation: \"TN\",\n  aliases: [\"الرقم الضريبي\", \"tax number\"] as const,\n  candidatePattern: \"\\\\d{9}\",\n  country: \"EG\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description: \"Egyptian tax identification number\",\n  sourceUrl: \"https://www.eta.gov.eg/\",\n  lengths: [9] as const,\n  examples: [\"100531385\", \"331105268\"] as const,\n  generate,\n};\n\nexport default tn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AACA,MAAM,iBAAyB,aAAa,EAAE;;;;;AAuB9C,MAAM,gBAAwC;CAC5C,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACX;AAED,MAAM,eAAe,IAAI,OACvB,IAAI,OAAO,KAAK,cAAc,CAAC,KAAK,GAAG,CAAC,IACxC,IACD;AAED,MAAM,WAAW,UAA0B;AAEzC,QADgB,MAAM,OAAO,MAAM,CACpB,QACb,eACC,OAAO,cAAc,OAAO,GAC9B;;AAGH,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,uCACD;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,KAAgB;CACpB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,iBAAiB,aAAa;CACxC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aAAa;CACb,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa,YAAY;CACpC;CACD"}
+{"version":3,"file":"tn.js","names":[],"sources":["../../src/eg/tn.ts"],"sourcesContent":["/** Generate a random valid Egyptian TN. */\nconst generate = (): string => randomDigits(9);\n\n/**\n * TN (Tax Registration Number, الرقم الضريبي).\n *\n * Egyptian tax number. 9 digits, no checksum.\n * Displayed as XXX-XXX-XXX. Accepts both\n * Arabic-Indic and Extended Arabic-Indic digits.\n *\n * @see https://www.eta.gov.eg/\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 * Arabic-Indic and Extended Arabic-Indic digit map.\n * Converts Arabic numeral characters to ASCII digits.\n */\nconst ARABIC_DIGITS: Record<string, string> = {\n  \"\\u0660\": \"0\", // ٠\n  \"\\u0661\": \"1\", // ١\n  \"\\u0662\": \"2\", // ٢\n  \"\\u0663\": \"3\", // ٣\n  \"\\u0664\": \"4\", // ٤\n  \"\\u0665\": \"5\", // ٥\n  \"\\u0666\": \"6\", // ٦\n  \"\\u0667\": \"7\", // ٧\n  \"\\u0668\": \"8\", // ٨\n  \"\\u0669\": \"9\", // ٩\n  \"\\u06F0\": \"0\", // ۰\n  \"\\u06F1\": \"1\", // ۱\n  \"\\u06F2\": \"2\", // ۲\n  \"\\u06F3\": \"3\", // ۳\n  \"\\u06F4\": \"4\", // ۴\n  \"\\u06F5\": \"5\", // ۵\n  \"\\u06F6\": \"6\", // ۶\n  \"\\u06F7\": \"7\", // ۷\n  \"\\u06F8\": \"8\", // ۸\n  \"\\u06F9\": \"9\", // ۹\n};\n\nconst ARABIC_REGEX = new RegExp(\n  `[${Object.keys(ARABIC_DIGITS).join(\"\")}]`,\n  \"g\",\n);\n\nconst compact = (value: string): string => {\n  const cleaned = clean(value, \" -/\");\n  return cleaned.replace(\n    ARABIC_REGEX,\n    (ch) => ARABIC_DIGITS[ch] ?? ch,\n  );\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Egyptian TN must be exactly 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Egyptian TN 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, 6)}-${v.slice(6)}`;\n};\n\n/** Egyptian Tax Registration Number. */\nconst tn: CountryValidator<\"EG\"> = {\n  name: \"Egyptian Tax Registration Number\",\n  localName: \"الرقم الضريبي\",\n  abbreviation: \"TN\",\n  aliases: [\"الرقم الضريبي\", \"tax number\"] as const,\n  candidatePattern: \"\\\\d{9}\",\n  scope: \"country\",\n  country: \"EG\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description: \"Egyptian tax identification number\",\n  sourceUrl: \"https://www.eta.gov.eg/\",\n  lengths: [9] as const,\n  examples: [\"100531385\", \"331105268\"] as const,\n  generate,\n};\n\nexport default tn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB,aAAa,CAAC;;;;;AA0B7C,MAAM,gBAAwC;CAC5C,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;CACV,KAAU;AACZ;AAEA,MAAM,eAAe,IAAI,OACvB,IAAI,OAAO,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,IACxC,GACF;AAEA,MAAM,WAAW,UAA0B;CAEzC,OADgB,MAAM,OAAO,KAChB,EAAE,QACb,eACC,OAAO,cAAc,OAAO,EAC/B;AACF;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,sCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,sCACF;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,KAA6B;CACjC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,iBAAiB,YAAY;CACvC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aAAa;CACb,WAAW;CACX,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,aAAa,WAAW;CACnC;AACF"}

package/dist/es/cif.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/es/cif.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid Spanish CIF. */
 declare const generate: () => string;
 /** Spanish Company Tax ID (CIF). */
-declare const cif: Validator;
+declare const cif: CountryValidator<"ES">;
 //#endregion
 export { compact, cif as default, format, generate, validate };
 //# sourceMappingURL=cif.d.ts.map

package/dist/es/cif.js

@@ -1,19 +1,9 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomChar, randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 import { cifChecksum } from "./vat.js";
 //#region src/es/cif.ts
-/**
-* CIF (Código de Identificación Fiscal).
-*
-* Spanish company tax identification number.
-* Letter prefix (ABCDEFGHJNPQRSUVW) + 7 digits +
-* check digit or letter. Delegates to the CIF
-* branch of es/vat validation.
-*
-* @see https://www.agenciatributaria.es/
-*/
 const CIF_PREFIXES = "ABCDEFGHJNPQRSUVW";
 const CIF_LETTERS = "JABCDEFGHI";
 const compact = (value) => {
@@ -38,7 +28,7 @@ const validate = (value) => {
 const format = (value) => compact(value);
 /** Generate a random valid Spanish CIF. */
 const generate = () => {
-	const letter = CIF_PREFIXES[randomInt(0, 16)];
+	const letter = randomChar(CIF_PREFIXES);
 	const payload = randomDigits(7);
 	const check = cifChecksum(payload);
 	if ("KPQS".includes(letter)) return letter + payload + CIF_LETTERS.charAt(check);
@@ -51,6 +41,7 @@ const cif = {
 	abbreviation: "CIF",
 	aliases: ["CIF", "código de identificación fiscal"],
 	candidatePattern: "[A-HJNP-SUVW]\\d{7}[\\dA-J]",
+	scope: "country",
 	country: "ES",
 	entityType: "company",
 	sourceUrl: "https://www.agenciatributaria.es/",

package/dist/es/cif.js.map

@@ -1 +1 @@
-{"version":3,"file":"cif.js","names":[],"sources":["../../src/es/cif.ts"],"sourcesContent":["/**\n * CIF (Código de Identificación Fiscal).\n *\n * Spanish company tax identification number.\n * Letter prefix (ABCDEFGHJNPQRSUVW) + 7 digits +\n * check digit or letter. Delegates to the CIF\n * branch of es/vat validation.\n *\n * @see https://www.agenciatributaria.es/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport { cifChecksum } from \"./vat\";\n\nconst CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\nconst CIF_LETTERS = \"JABCDEFGHI\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"ES\") || v.startsWith(\"es\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Spanish CIF must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  if (!CIF_PREFIXES.includes(first)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must start with a valid prefix letter\",\n    );\n  }\n\n  if (!isdigits(v.slice(1, 8))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must have 7 digits after prefix\",\n    );\n  }\n\n  const last = v.charAt(8);\n  const check = cifChecksum(v.slice(1, 8));\n\n  if (\n    last !== String(check) &&\n    last !== CIF_LETTERS.charAt(check)\n  ) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Spanish CIF check digit/letter mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish CIF. */\nconst generate = (): string => {\n  const letter =\n    CIF_PREFIXES[randomInt(0, CIF_PREFIXES.length - 1)]!;\n  const payload = randomDigits(7);\n  const check = cifChecksum(payload);\n  if (\"KPQS\".includes(letter))\n    return letter + payload + CIF_LETTERS.charAt(check);\n  return letter + payload + String(check);\n};\n\n/** Spanish Company Tax ID (CIF). */\nconst cif: Validator = {\n  name: \"Spanish Company Tax ID\",\n  localName: \"Código de Identificación Fiscal\",\n  abbreviation: \"CIF\",\n  aliases: [\n    \"CIF\",\n    \"código de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"[A-HJNP-SUVW]\\\\d{7}[\\\\dA-J]\",\n  country: \"ES\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"A13585625\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,eAAe;AACrB,MAAM,cAAc;AAEpB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,mCACD;CAGH,MAAM,QAAQ,EAAE,OAAO,EAAE;AACzB,KAAI,CAAC,aAAa,SAAS,MAAM,CAC/B,QAAO,IACL,kBACA,oDACD;AAGH,KAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,8CACD;CAGH,MAAM,OAAO,EAAE,OAAO,EAAE;CACxB,MAAM,QAAQ,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAExC,KACE,SAAS,OAAO,MAAM,IACtB,SAAS,YAAY,OAAO,MAAM,CAElC,QAAO,IACL,oBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,SACJ,aAAa,UAAU,GAAG,GAAwB;CACpD,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,QAAQ,YAAY,QAAQ;AAClC,KAAI,OAAO,SAAS,OAAO,CACzB,QAAO,SAAS,UAAU,YAAY,OAAO,MAAM;AACrD,QAAO,SAAS,UAAU,OAAO,MAAM;;;AAIzC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,kCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cif.js","names":[],"sources":["../../src/es/cif.ts"],"sourcesContent":["/**\n * CIF (Código de Identificación Fiscal).\n *\n * Spanish company tax identification number.\n * Letter prefix (ABCDEFGHJNPQRSUVW) + 7 digits +\n * check digit or letter. Delegates to the CIF\n * branch of es/vat validation.\n *\n * @see https://www.agenciatributaria.es/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\nimport { cifChecksum } from \"./vat\";\n\nimport { clean } from \"#util/clean\";\nimport { randomChar, randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\nconst CIF_LETTERS = \"JABCDEFGHI\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"ES\") || v.startsWith(\"es\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Spanish CIF must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  if (!CIF_PREFIXES.includes(first)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must start with a valid prefix letter\",\n    );\n  }\n\n  if (!isdigits(v.slice(1, 8))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must have 7 digits after prefix\",\n    );\n  }\n\n  const last = v.charAt(8);\n  const check = cifChecksum(v.slice(1, 8));\n\n  if (\n    last !== String(check) &&\n    last !== CIF_LETTERS.charAt(check)\n  ) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Spanish CIF check digit/letter mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish CIF. */\nconst generate = (): string => {\n  const letter = randomChar(CIF_PREFIXES);\n  const payload = randomDigits(7);\n  const check = cifChecksum(payload);\n  if (\"KPQS\".includes(letter))\n    return letter + payload + CIF_LETTERS.charAt(check);\n  return letter + payload + String(check);\n};\n\n/** Spanish Company Tax ID (CIF). */\nconst cif: CountryValidator<\"ES\"> = {\n  name: \"Spanish Company Tax ID\",\n  localName: \"Código de Identificación Fiscal\",\n  abbreviation: \"CIF\",\n  aliases: [\n    \"CIF\",\n    \"código de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"[A-HJNP-SUVW]\\\\d{7}[\\\\dA-J]\",\n  scope: \"country\",\n  country: \"ES\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"A13585625\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAsBA,MAAM,eAAe;AACrB,MAAM,cAAc;AAEpB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EAAE,YAAY;AACvB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,kCACF;CAGF,MAAM,QAAQ,EAAE,OAAO,CAAC;CACxB,IAAI,CAAC,aAAa,SAAS,KAAK,GAC9B,OAAO,IACL,kBACA,mDACF;CAGF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GACzB,OAAO,IACL,kBACA,6CACF;CAGF,MAAM,OAAO,EAAE,OAAO,CAAC;CACvB,MAAM,QAAQ,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC;CAEvC,IACE,SAAS,OAAO,KAAK,KACrB,SAAS,YAAY,OAAO,KAAK,GAEjC,OAAO,IACL,oBACA,yCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,SAAS,WAAW,YAAY;CACtC,MAAM,UAAU,aAAa,CAAC;CAC9B,MAAM,QAAQ,YAAY,OAAO;CACjC,IAAI,OAAO,SAAS,MAAM,GACxB,OAAO,SAAS,UAAU,YAAY,OAAO,KAAK;CACpD,OAAO,SAAS,UAAU,OAAO,KAAK;AACxC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,iCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/es/dni.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/es/dni.d.ts
-
 declare const CHECK_LETTERS = "TRWAGMYFPDXBNJZSQVHLCKE";
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
@@ -9,7 +8,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Spanish DNI. */
 declare const generate: () => string;
 /** Spanish National Identity Document. */
-declare const dni: Validator;
+declare const dni: CountryValidator<"ES">;
 //#endregion
 export { CHECK_LETTERS, compact, dni as default, format, generate, validate };
 //# sourceMappingURL=dni.d.ts.map

package/dist/es/dni.js

@@ -3,15 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/es/dni.ts
-/**
-* DNI (Documento Nacional de Identidad).
-*
-* Spanish national identity document number.
-* 8 digits followed by a check letter determined
-* by the remainder of dividing the number by 23.
-*
-* @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/
-*/
 const CHECK_LETTERS = "TRWAGMYFPDXBNJZSQVHLCKE";
 const compact = (value) => clean(value, " -").toUpperCase();
 const validate = (value) => {
@@ -43,6 +34,7 @@ const dni = {
 		"documento nacional de identidad"
 	],
 	candidatePattern: "\\d{1,2}\\.?\\d{3}\\.?\\d{3}-?[A-Z]",
+	scope: "country",
 	country: "ES",
 	entityType: "person",
 	sourceUrl: "https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/",

package/dist/es/dni.js.map

@@ -1 +1 @@
-{"version":3,"file":"dni.js","names":[],"sources":["../../src/es/dni.ts"],"sourcesContent":["/**\n * DNI (Documento Nacional de Identidad).\n *\n * Spanish national identity document number.\n * 8 digits followed by a check letter determined\n * by the remainder of dividing the number by 23.\n *\n * @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/\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 CHECK_LETTERS = \"TRWAGMYFPDXBNJZSQVHLCKE\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"DNI must be 8 digits and 1 letter\",\n    );\n  }\n\n  const digits = v.slice(0, 8);\n  const letter = v[8];\n\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"DNI must start with 8 digits\",\n    );\n  }\n\n  const expected = CHECK_LETTERS[Number(digits) % 23];\n  if (letter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"DNI check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish DNI. */\nconst generate = (): string => {\n  const num = randomDigits(8);\n  return num + CHECK_LETTERS[Number(num) % 23];\n};\n\n/** Spanish National Identity Document. */\nconst dni: Validator = {\n  name: \"Spanish National ID\",\n  localName: \"Documento Nacional de Identidad\",\n  abbreviation: \"DNI\",\n  aliases: [\n    \"D.N.I.\",\n    \"DNI\",\n    \"documento nacional de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{1,2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?[A-Z]\",\n  country: \"ES\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/\",\n  examples: [\"54362315K\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dni;\nexport {\n  CHECK_LETTERS,\n  compact,\n  format,\n  validate,\n  generate,\n};\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,gBAAgB;AAEtB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,oCACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,SAAS,EAAE;AAEjB,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,+BACD;AAIH,KAAI,WAAA,0BAD2B,OAAO,OAAO,GAAG,IAE9C,QAAO,IACL,oBACA,kCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,MAAM,aAAa,EAAE;AAC3B,QAAO,MAAM,cAAc,OAAO,IAAI,GAAG;;;AAI3C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"dni.js","names":[],"sources":["../../src/es/dni.ts"],"sourcesContent":["/**\n * DNI (Documento Nacional de Identidad).\n *\n * Spanish national identity document number.\n * 8 digits followed by a check letter determined\n * by the remainder of dividing the number by 23.\n *\n * @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/\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 CHECK_LETTERS = \"TRWAGMYFPDXBNJZSQVHLCKE\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"DNI must be 8 digits and 1 letter\",\n    );\n  }\n\n  const digits = v.slice(0, 8);\n  const letter = v[8];\n\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"DNI must start with 8 digits\",\n    );\n  }\n\n  const expected = CHECK_LETTERS[Number(digits) % 23];\n  if (letter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"DNI check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish DNI. */\nconst generate = (): string => {\n  const num = randomDigits(8);\n  return num + CHECK_LETTERS[Number(num) % 23];\n};\n\n/** Spanish National Identity Document. */\nconst dni: CountryValidator<\"ES\"> = {\n  name: \"Spanish National ID\",\n  localName: \"Documento Nacional de Identidad\",\n  abbreviation: \"DNI\",\n  aliases: [\n    \"D.N.I.\",\n    \"DNI\",\n    \"documento nacional de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{1,2}\\\\.?\\\\d{3}\\\\.?\\\\d{3}-?[A-Z]\",\n  scope: \"country\",\n  country: \"ES\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/\",\n  examples: [\"54362315K\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dni;\nexport {\n  CHECK_LETTERS,\n  compact,\n  format,\n  validate,\n  generate,\n};\n"],"mappings":";;;;;AAoBA,MAAM,gBAAgB;AAEtB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,mCACF;CAGF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,MAAM,SAAS,EAAE;CAEjB,IAAI,CAAC,SAAS,MAAM,GAClB,OAAO,IACL,kBACA,8BACF;CAIF,IAAI,WAAA,0BAD2B,OAAO,MAAM,IAAI,KAE9C,OAAO,IACL,oBACA,iCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,MAAM,aAAa,CAAC;CAC1B,OAAO,MAAM,cAAc,OAAO,GAAG,IAAI;AAC3C;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/es/mod.d.ts

@@ -1,4 +1,3 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import cif from "./cif.js";
 import dni from "./dni.js";
 import nie from "./nie.js";
@@ -6,7 +5,9 @@ import nss from "./nss.js";
 import vat from "./vat.js";
 
 //#region src/es/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { cif, dni, nie, nss, vat };
+}
 //#endregion
 export { cif, dni, mod_d_exports, nie, nss, vat };
 //# sourceMappingURL=mod.d.ts.map

package/dist/es/nie.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/es/nie.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid Spanish NIE. */
 declare const generate: () => string;
 /** Spanish Foreigner Identification Number. */
-declare const nie: Validator;
+declare const nie: CountryValidator<"ES">;
 //#endregion
 export { compact, nie as default, format, generate, validate };
 //# sourceMappingURL=nie.d.ts.map

package/dist/es/nie.js

@@ -1,18 +1,9 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 import { CHECK_LETTERS } from "./dni.js";
 //#region src/es/nie.ts
-/**
-* NIE (Número de Identidad de Extranjero).
-*
-* Spanish foreigner identification number. Starts
-* with X, Y, or Z, followed by 7 digits and a check
-* letter computed using the DNI algorithm.
-*
-* @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/
-*/
 const PREFIX_MAP = {
 	X: "0",
 	Y: "1",
@@ -35,21 +26,21 @@ const validate = (value) => {
 	};
 };
 const format = (value) => compact(value);
+const NIE_PREFIXES = [
+	"X",
+	"Y",
+	"Z"
+];
+const NIE_PREFIX_VALUES = {
+	X: 0,
+	Y: 1,
+	Z: 2
+};
 /** Generate a random valid Spanish NIE. */
 const generate = () => {
-	const prefixes = [
-		"X",
-		"Y",
-		"Z"
-	];
-	const vals = {
-		X: 0,
-		Y: 1,
-		Z: 2
-	};
-	const prefix = prefixes[randomInt(0, 2)];
+	const prefix = randomPick(NIE_PREFIXES);
 	const digits = randomDigits(7);
-	const num = vals[prefix] * 1e7 + Number(digits);
+	const num = NIE_PREFIX_VALUES[prefix] * 1e7 + Number(digits);
 	return prefix + digits + CHECK_LETTERS.charAt(num % 23);
 };
 /** Spanish Foreigner Identification Number. */
@@ -63,6 +54,7 @@ const nie = {
 		"número de identidad de extranjero"
 	],
 	candidatePattern: "[XYZ]-?\\d{7}-?[A-Z]",
+	scope: "country",
 	country: "ES",
 	entityType: "person",
 	sourceUrl: "https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/",

package/dist/es/nie.js.map

@@ -1 +1 @@
-{"version":3,"file":"nie.js","names":[],"sources":["../../src/es/nie.ts"],"sourcesContent":["/**\n * NIE (Número de Identidad de Extranjero).\n *\n * Spanish foreigner identification number. Starts\n * with X, Y, or Z, followed by 7 digits and a check\n * letter computed using the DNI algorithm.\n *\n * @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport { CHECK_LETTERS } from \"./dni\";\n\nconst PREFIX_MAP: Record<string, string> = {\n  X: \"0\",\n  Y: \"1\",\n  Z: \"2\",\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIE must be 9 characters\",\n    );\n  }\n\n  const prefix = v.charAt(0);\n  const replacement = PREFIX_MAP[prefix];\n  if (replacement === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must start with X, Y, or Z\",\n    );\n  }\n\n  const digits = v.slice(1, 8);\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must have 7 digits after prefix\",\n    );\n  }\n\n  const letter = v.charAt(8);\n  const num = Number(replacement + digits);\n  const expected = CHECK_LETTERS.charAt(num % 23);\n  if (letter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIE check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish NIE. */\nconst generate = (): string => {\n  const prefixes = [\"X\", \"Y\", \"Z\"] as const;\n  const vals: Record<string, number> = { X: 0, Y: 1, Z: 2 };\n  const prefix = prefixes[randomInt(0, 2)]!;\n  const digits = randomDigits(7);\n  const num = vals[prefix]! * 10000000 + Number(digits);\n  return prefix + digits + CHECK_LETTERS.charAt(num % 23);\n};\n\n/** Spanish Foreigner Identification Number. */\nconst nie: Validator = {\n  name: \"Spanish Foreigner ID\",\n  localName: \"Número de Identidad de Extranjero\",\n  abbreviation: \"NIE\",\n  aliases: [\n    \"N.I.E.\",\n    \"NIE\",\n    \"número de identidad de extranjero\",\n  ] as const,\n  candidatePattern: \"[XYZ]-?\\\\d{7}-?[A-Z]\",\n  country: \"ES\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\",\n  examples: [\"X5253868R\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nie;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,aAAqC;CACzC,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,2BACD;CAIH,MAAM,cAAc,WADL,EAAE,OAAO,EAAE;AAE1B,KAAI,gBAAgB,KAAA,EAClB,QAAO,IACL,kBACA,iCACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,sCACD;CAGH,MAAM,SAAS,EAAE,OAAO,EAAE;CAC1B,MAAM,MAAM,OAAO,cAAc,OAAO;AAExC,KAAI,WAAA,0BAD2B,OAAO,MAAM,GAAG,CAE7C,QAAO,IACL,oBACA,kCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,WAAW;EAAC;EAAK;EAAK;EAAI;CAChC,MAAM,OAA+B;EAAE,GAAG;EAAG,GAAG;EAAG,GAAG;EAAG;CACzD,MAAM,SAAS,SAAS,UAAU,GAAG,EAAE;CACvC,MAAM,SAAS,aAAa,EAAE;CAC9B,MAAM,MAAM,KAAK,UAAW,MAAW,OAAO,OAAO;AACrD,QAAO,SAAS,SAAS,cAAc,OAAO,MAAM,GAAG;;;AAIzD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nie.js","names":[],"sources":["../../src/es/nie.ts"],"sourcesContent":["/**\n * NIE (Número de Identidad de Extranjero).\n *\n * Spanish foreigner identification number. Starts\n * with X, Y, or Z, followed by 7 digits and a check\n * letter computed using the DNI algorithm.\n *\n * @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\nimport { CHECK_LETTERS } from \"./dni\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst PREFIX_MAP: Record<string, string> = {\n  X: \"0\",\n  Y: \"1\",\n  Z: \"2\",\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIE must be 9 characters\",\n    );\n  }\n\n  const prefix = v.charAt(0);\n  const replacement = PREFIX_MAP[prefix];\n  if (replacement === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must start with X, Y, or Z\",\n    );\n  }\n\n  const digits = v.slice(1, 8);\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must have 7 digits after prefix\",\n    );\n  }\n\n  const letter = v.charAt(8);\n  const num = Number(replacement + digits);\n  const expected = CHECK_LETTERS.charAt(num % 23);\n  if (letter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIE check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst NIE_PREFIXES = [\"X\", \"Y\", \"Z\"] as const;\nconst NIE_PREFIX_VALUES: Record<\n  (typeof NIE_PREFIXES)[number],\n  number\n> = { X: 0, Y: 1, Z: 2 };\n\n/** Generate a random valid Spanish NIE. */\nconst generate = (): string => {\n  const prefix = randomPick(NIE_PREFIXES);\n  const digits = randomDigits(7);\n  const num =\n    NIE_PREFIX_VALUES[prefix] * 10000000 + Number(digits);\n  return prefix + digits + CHECK_LETTERS.charAt(num % 23);\n};\n\n/** Spanish Foreigner Identification Number. */\nconst nie: CountryValidator<\"ES\"> = {\n  name: \"Spanish Foreigner ID\",\n  localName: \"Número de Identidad de Extranjero\",\n  abbreviation: \"NIE\",\n  aliases: [\n    \"N.I.E.\",\n    \"NIE\",\n    \"número de identidad de extranjero\",\n  ] as const,\n  candidatePattern: \"[XYZ]-?\\\\d{7}-?[A-Z]\",\n  scope: \"country\",\n  country: \"ES\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\",\n  examples: [\"X5253868R\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nie;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAqBA,MAAM,aAAqC;CACzC,GAAG;CACH,GAAG;CACH,GAAG;AACL;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,0BACF;CAIF,MAAM,cAAc,WADL,EAAE,OAAO,CACY;CACpC,IAAI,gBAAgB,KAAA,GAClB,OAAO,IACL,kBACA,gCACF;CAGF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,IAAI,CAAC,SAAS,MAAM,GAClB,OAAO,IACL,kBACA,qCACF;CAGF,MAAM,SAAS,EAAE,OAAO,CAAC;CACzB,MAAM,MAAM,OAAO,cAAc,MAAM;CAEvC,IAAI,WAAA,0BAD2B,OAAO,MAAM,EACtB,GACpB,OAAO,IACL,oBACA,iCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;AAEvD,MAAM,eAAe;CAAC;CAAK;CAAK;AAAG;AACnC,MAAM,oBAGF;CAAE,GAAG;CAAG,GAAG;CAAG,GAAG;AAAE;;AAGvB,MAAM,iBAAyB;CAC7B,MAAM,SAAS,WAAW,YAAY;CACtC,MAAM,SAAS,aAAa,CAAC;CAC7B,MAAM,MACJ,kBAAkB,UAAU,MAAW,OAAO,MAAM;CACtD,OAAO,SAAS,SAAS,cAAc,OAAO,MAAM,EAAE;AACxD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/es/nss.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/es/nss.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid Spanish NSS. */
 declare const generate: () => string;
 /** Spanish Social Security Number. */
-declare const nss: Validator;
+declare const nss: CountryValidator<"ES">;
 //#endregion
 export { compact, nss as default, format, generate, validate };
 //# sourceMappingURL=nss.d.ts.map

package/dist/es/nss.js

@@ -3,22 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/es/nss.ts
-/**
-* NSS (Número de la Seguridad Social).
-*
-* Spanish Social Security Number. 12 digits:
-* 2-digit province code (01–52) + 8-digit affiliate
-* number + 2-digit check digits.
-*
-* Check digits are computed as:
-*   if affiliate < 10_000_000:
-*     (affiliate + province × 10_000_000) mod 97
-*   else:
-*     parseInt(province + affiliate) mod 97
-*
-* @see https://www.seg-social.es/
-* @see https://intervia.com/doc/validar-numeros-de-la-seguridad-social/
-*/
 const compact = (value) => clean(value, " -/.");
 const validate = (value) => {
 	const v = compact(value);
@@ -55,6 +39,7 @@ const nss = {
 	abbreviation: "NSS",
 	aliases: ["NSS", "número de seguridad social"],
 	candidatePattern: "\\d{12}",
+	scope: "country",
 	country: "ES",
 	entityType: "person",
 	description: "Spanish Social Security affiliation number with mod-97 check digits",

package/dist/es/nss.js.map

@@ -1 +1 @@
-{"version":3,"file":"nss.js","names":[],"sources":["../../src/es/nss.ts"],"sourcesContent":["/**\n * NSS (Número de la Seguridad Social).\n *\n * Spanish Social Security Number. 12 digits:\n * 2-digit province code (01–52) + 8-digit affiliate\n * number + 2-digit check digits.\n *\n * Check digits are computed as:\n *   if affiliate < 10_000_000:\n *     (affiliate + province × 10_000_000) mod 97\n *   else:\n *     parseInt(province + affiliate) mod 97\n *\n * @see https://www.seg-social.es/\n * @see https://intervia.com/doc/validar-numeros-de-la-seguridad-social/\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 !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Spanish NSS must be 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish NSS must contain only digits\",\n    );\n  }\n\n  const province = Number(v.slice(0, 2));\n  if (province < 1 || province > 52) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Spanish NSS province code must be 01–52\",\n    );\n  }\n\n  const affiliate = Number(v.slice(2, 10));\n  const check = Number(v.slice(10, 12));\n\n  let base: number;\n  if (affiliate < 10_000_000) {\n    base = affiliate + province * 10_000_000;\n  } else {\n    // Concatenate province and affiliate as a number\n    base = Number(`${province}${v.slice(2, 10)}`);\n  }\n\n  const expected = base % 97;\n\n  if (expected !== check) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Spanish NSS check digits do 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, 2)}/${v.slice(2, 10)}/${v.slice(10)}`;\n};\n\n/** Generate a random valid Spanish NSS. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(12);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Spanish Social Security Number. */\nconst nss: Validator = {\n  name: \"Spanish Social Security Number\",\n  localName: \"Número de la Seguridad Social\",\n  abbreviation: \"NSS\",\n  aliases: [\"NSS\", \"número de seguridad social\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  country: \"ES\",\n  entityType: \"person\",\n  description:\n    \"Spanish Social Security affiliation number \" +\n    \"with mod-97 check digits\",\n  sourceUrl: \"https://www.seg-social.es/\",\n  lengths: [12] as const,\n  examples: [\"281234567840\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nss;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;AAEtB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,uCACD;CAGH,MAAM,WAAW,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AACtC,KAAI,WAAW,KAAK,WAAW,GAC7B,QAAO,IACL,qBACA,0CACD;CAGH,MAAM,YAAY,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CACxC,MAAM,QAAQ,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC;CAErC,IAAI;AACJ,KAAI,YAAY,IACd,QAAO,YAAY,WAAW;KAG9B,QAAO,OAAO,GAAG,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG;AAK/C,KAFiB,OAAO,OAEP,MACf,QAAO,IACL,oBACA,wCACD;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,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI1D,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,GAAG;AAC1B,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,6BAA6B;CAC9C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WAAW;CACX,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe;CAC1B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nss.js","names":[],"sources":["../../src/es/nss.ts"],"sourcesContent":["/**\n * NSS (Número de la Seguridad Social).\n *\n * Spanish Social Security Number. 12 digits:\n * 2-digit province code (01–52) + 8-digit affiliate\n * number + 2-digit check digits.\n *\n * Check digits are computed as:\n *   if affiliate < 10_000_000:\n *     (affiliate + province × 10_000_000) mod 97\n *   else:\n *     parseInt(province + affiliate) mod 97\n *\n * @see https://www.seg-social.es/\n * @see https://intervia.com/doc/validar-numeros-de-la-seguridad-social/\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 !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Spanish NSS must be 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish NSS must contain only digits\",\n    );\n  }\n\n  const province = Number(v.slice(0, 2));\n  if (province < 1 || province > 52) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Spanish NSS province code must be 01–52\",\n    );\n  }\n\n  const affiliate = Number(v.slice(2, 10));\n  const check = Number(v.slice(10, 12));\n\n  let base: number;\n  if (affiliate < 10_000_000) {\n    base = affiliate + province * 10_000_000;\n  } else {\n    // Concatenate province and affiliate as a number\n    base = Number(`${province}${v.slice(2, 10)}`);\n  }\n\n  const expected = base % 97;\n\n  if (expected !== check) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Spanish NSS check digits do 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, 2)}/${v.slice(2, 10)}/${v.slice(10)}`;\n};\n\n/** Generate a random valid Spanish NSS. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(12);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Spanish Social Security Number. */\nconst nss: CountryValidator<\"ES\"> = {\n  name: \"Spanish Social Security Number\",\n  localName: \"Número de la Seguridad Social\",\n  abbreviation: \"NSS\",\n  aliases: [\"NSS\", \"número de seguridad social\"] as const,\n  candidatePattern: \"\\\\d{12}\",\n  scope: \"country\",\n  country: \"ES\",\n  entityType: \"person\",\n  description:\n    \"Spanish Social Security affiliation number \" +\n    \"with mod-97 check digits\",\n  sourceUrl: \"https://www.seg-social.es/\",\n  lengths: [12] as const,\n  examples: [\"281234567840\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nss;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AA2BA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,sCACF;CAGF,MAAM,WAAW,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CACrC,IAAI,WAAW,KAAK,WAAW,IAC7B,OAAO,IACL,qBACA,yCACF;CAGF,MAAM,YAAY,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CACvC,MAAM,QAAQ,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;CAEpC,IAAI;CACJ,IAAI,YAAY,KACd,OAAO,YAAY,WAAW;MAG9B,OAAO,OAAO,GAAG,WAAW,EAAE,MAAM,GAAG,EAAE,GAAG;CAK9C,IAFiB,OAAO,OAEP,OACf,OAAO,IACL,oBACA,uCACF;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,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AACzD;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,EAAE;EACzB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,4BAA4B;CAC7C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;AACF"}

package/dist/es/vat.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/es/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const cifChecksum: (digits: string) => number;
 declare const validate: (value: string) => ValidateResult;
@@ -9,7 +8,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Spanish VAT (DNI form). */
 declare const generate: () => string;
 /** Spanish VAT Number. */
-declare const vat: Validator;
+declare const vat: CountryValidator<"ES">;
 //#endregion
 export { cifChecksum, compact, vat as default, format, generate, validate };
 //# sourceMappingURL=vat.d.ts.map

package/dist/es/vat.js

@@ -3,15 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/es/vat.ts
-/**
-* NIF/CIF (Spanish VAT number).
-*
-* 9 characters with 4 subtypes: DNI, NIE, CIF,
-* and K/L/M personal numbers.
-*
-* @see https://www.vatify.eu/spain-vat-number.html
-* @see https://www.agenciatributaria.es/
-*/
 const DNI_LETTERS = "TRWAGMYFPDXBNJZSQVHLCKE";
 const CIF_LETTERS = "JABCDEFGHI";
 const compact = (value) => {
@@ -44,7 +35,10 @@ const validate = (value) => {
 		};
 	}
 	if (first === "X" || first === "Y" || first === "Z") {
-		const digits = (first === "X" ? "0" : first === "Y" ? "1" : "2") + v.slice(1, 8);
+		let prefix = "2";
+		if (first === "X") prefix = "0";
+		else if (first === "Y") prefix = "1";
+		const digits = prefix + v.slice(1, 8);
 		if (!isdigits(digits) || !isdigits(v.slice(1, 8))) return err("INVALID_FORMAT", "Spanish NIE must have 7 digits after prefix");
 		if (last !== DNI_LETTERS.charAt(Number.parseInt(digits, 10) % 23)) return err("INVALID_CHECKSUM", "Spanish NIE check letter mismatch");
 		return {
@@ -89,6 +83,7 @@ const vat = {
 		"número de identificación fiscal"
 	],
 	candidatePattern: "ES[A-Z]\\d{7}[A-Z\\d]",
+	scope: "country",
 	country: "ES",
 	entityType: "any",
 	sourceUrl: "https://www.agenciatributaria.es/",

package/dist/es/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/es/vat.ts"],"sourcesContent":["/**\n * NIF/CIF (Spanish VAT number).\n *\n * 9 characters with 4 subtypes: DNI, NIE, CIF,\n * and K/L/M personal numbers.\n *\n * @see https://www.vatify.eu/spain-vat-number.html\n * @see https://www.agenciatributaria.es/\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 DNI_LETTERS = \"TRWAGMYFPDXBNJZSQVHLCKE\";\nconst CIF_LETTERS = \"JABCDEFGHI\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"ES\") || v.startsWith(\"es\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst cifChecksum = (digits: string): number => {\n  let even = 0;\n  let odd = 0;\n  for (let i = 0; i < 7; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd positions (1-indexed): double and sum digits\n      const doubled = d * 2;\n      odd += Math.floor(doubled / 10) + (doubled % 10);\n    } else {\n      even += d;\n    }\n  }\n  return (10 - ((even + odd) % 10)) % 10;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Spanish VAT number must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  const last = v.charAt(8);\n\n  // DNI: 8 digits + letter\n  if (isdigits(v.slice(0, 8))) {\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(v.slice(0, 8), 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish DNI check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // NIE: X/Y/Z + 7 digits + letter\n  if (first === \"X\" || first === \"Y\" || first === \"Z\") {\n    const prefix =\n      first === \"X\" ? \"0\" : first === \"Y\" ? \"1\" : \"2\";\n    const digits = prefix + v.slice(1, 8);\n    if (!isdigits(digits) || !isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish NIE must have 7 digits after prefix\",\n      );\n    }\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(digits, 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish NIE check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // K, L, M: personal number, letter + 7 digits +\n  // check letter\n  if (first === \"K\" || first === \"L\" || first === \"M\") {\n    if (!isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish K/L/M number must have 7 digits\",\n      );\n    }\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(v.slice(1, 8), 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish K/L/M check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // CIF: letter + 7 digits + check digit/letter\n  const CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\n  if (CIF_PREFIXES.includes(first)) {\n    if (!isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish CIF must have 7 digits after prefix\",\n      );\n    }\n    const check = cifChecksum(v.slice(1, 8));\n    // Accept either numeric or alphabetic check digit\n    // for all CIF prefixes (sources conflict on which\n    // prefixes require which type)\n    if (\n      last !== String(check) &&\n      last !== CIF_LETTERS.charAt(check)\n    ) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish CIF check digit/letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_FORMAT\",\n    \"Spanish VAT number has invalid format\",\n  );\n};\n\nconst format = (value: string): string =>\n  `ES${compact(value)}`;\n\n/** Generate a random valid Spanish VAT (DNI form). */\nconst generate = (): string => {\n  const letters = \"TRWAGMYFPDXBNJZSQVHLCKE\";\n  const num = randomDigits(8);\n  return num + letters.charAt(Number(num) % 23);\n};\n\n/** Spanish VAT Number. */\nconst vat: Validator = {\n  name: \"Spanish VAT Number\",\n  localName: \"Número de Identificación Fiscal\",\n  abbreviation: \"NIF\",\n  aliases: [\n    \"NIF\",\n    \"CIF\",\n    \"número de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"ES[A-Z]\\\\d{7}[A-Z\\\\d]\",\n  country: \"ES\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"12345678Z\", \"A78304516\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { cifChecksum, compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,cAAc;AACpB,MAAM,cAAc;AAEpB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,eAAe,WAA2B;CAC9C,IAAI,OAAO;CACX,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,MAAI,IAAI,MAAM,GAAG;GAEf,MAAM,UAAU,IAAI;AACpB,UAAO,KAAK,MAAM,UAAU,GAAG,GAAI,UAAU;QAE7C,SAAQ;;AAGZ,SAAQ,MAAO,OAAO,OAAO,MAAO;;AAGtC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,0CACD;CAGH,MAAM,QAAQ,EAAE,OAAO,EAAE;CACzB,MAAM,OAAO,EAAE,OAAO,EAAE;AAGxB,KAAI,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,EAAE;AAI3B,MAAI,SAHa,YAAY,OAC3B,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,GAAG,GACtC,CAEC,QAAO,IACL,oBACA,oCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,KAAI,UAAU,OAAO,UAAU,OAAO,UAAU,KAAK;EAGnD,MAAM,UADJ,UAAU,MAAM,MAAM,UAAU,MAAM,MAAM,OACtB,EAAE,MAAM,GAAG,EAAE;AACrC,MAAI,CAAC,SAAS,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC/C,QAAO,IACL,kBACA,8CACD;AAKH,MAAI,SAHa,YAAY,OAC3B,OAAO,SAAS,QAAQ,GAAG,GAAG,GAC/B,CAEC,QAAO,IACL,oBACA,oCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAKpC,KAAI,UAAU,OAAO,UAAU,OAAO,UAAU,KAAK;AACnD,MAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,0CACD;AAKH,MAAI,SAHa,YAAY,OAC3B,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,GAAG,GACtC,CAEC,QAAO,IACL,oBACA,sCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAKpC,KADqB,oBACJ,SAAS,MAAM,EAAE;AAChC,MAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,8CACD;EAEH,MAAM,QAAQ,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAIxC,MACE,SAAS,OAAO,MAAM,IACtB,SAAS,YAAY,OAAO,MAAM,CAElC,QAAO,IACL,oBACA,0CACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAGpC,QAAO,IACL,kBACA,wCACD;;AAGH,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAC7B,MAAM,UAAU;CAChB,MAAM,MAAM,aAAa,EAAE;AAC3B,QAAO,MAAM,QAAQ,OAAO,OAAO,IAAI,GAAG,GAAG;;;AAI/C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa,YAAY;CACpC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/es/vat.ts"],"sourcesContent":["/**\n * NIF/CIF (Spanish VAT number).\n *\n * 9 characters with 4 subtypes: DNI, NIE, CIF,\n * and K/L/M personal numbers.\n *\n * @see https://www.vatify.eu/spain-vat-number.html\n * @see https://www.agenciatributaria.es/\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 DNI_LETTERS = \"TRWAGMYFPDXBNJZSQVHLCKE\";\nconst CIF_LETTERS = \"JABCDEFGHI\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"ES\") || v.startsWith(\"es\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst cifChecksum = (digits: string): number => {\n  let even = 0;\n  let odd = 0;\n  for (let i = 0; i < 7; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd positions (1-indexed): double and sum digits\n      const doubled = d * 2;\n      odd += Math.floor(doubled / 10) + (doubled % 10);\n    } else {\n      even += d;\n    }\n  }\n  return (10 - ((even + odd) % 10)) % 10;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Spanish VAT number must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  const last = v.charAt(8);\n\n  // DNI: 8 digits + letter\n  if (isdigits(v.slice(0, 8))) {\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(v.slice(0, 8), 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish DNI check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // NIE: X/Y/Z + 7 digits + letter\n  if (first === \"X\" || first === \"Y\" || first === \"Z\") {\n    let prefix = \"2\";\n    if (first === \"X\") {\n      prefix = \"0\";\n    } else if (first === \"Y\") {\n      prefix = \"1\";\n    }\n    const digits = prefix + v.slice(1, 8);\n    if (!isdigits(digits) || !isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish NIE must have 7 digits after prefix\",\n      );\n    }\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(digits, 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish NIE check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // K, L, M: personal number, letter + 7 digits +\n  // check letter\n  if (first === \"K\" || first === \"L\" || first === \"M\") {\n    if (!isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish K/L/M number must have 7 digits\",\n      );\n    }\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(v.slice(1, 8), 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish K/L/M check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // CIF: letter + 7 digits + check digit/letter\n  const CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\n  if (CIF_PREFIXES.includes(first)) {\n    if (!isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish CIF must have 7 digits after prefix\",\n      );\n    }\n    const check = cifChecksum(v.slice(1, 8));\n    // Accept either numeric or alphabetic check digit\n    // for all CIF prefixes (sources conflict on which\n    // prefixes require which type)\n    if (\n      last !== String(check) &&\n      last !== CIF_LETTERS.charAt(check)\n    ) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish CIF check digit/letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_FORMAT\",\n    \"Spanish VAT number has invalid format\",\n  );\n};\n\nconst format = (value: string): string =>\n  `ES${compact(value)}`;\n\n/** Generate a random valid Spanish VAT (DNI form). */\nconst generate = (): string => {\n  const letters = \"TRWAGMYFPDXBNJZSQVHLCKE\";\n  const num = randomDigits(8);\n  return num + letters.charAt(Number(num) % 23);\n};\n\n/** Spanish VAT Number. */\nconst vat: CountryValidator<\"ES\"> = {\n  name: \"Spanish VAT Number\",\n  localName: \"Número de Identificación Fiscal\",\n  abbreviation: \"NIF\",\n  aliases: [\n    \"NIF\",\n    \"CIF\",\n    \"número de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"ES[A-Z]\\\\d{7}[A-Z\\\\d]\",\n  scope: \"country\",\n  country: \"ES\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"12345678Z\", \"A78304516\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { cifChecksum, compact, format, validate, generate };\n"],"mappings":";;;;;AAoBA,MAAM,cAAc;AACpB,MAAM,cAAc;AAEpB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EAAE,YAAY;AACvB;AAEA,MAAM,eAAe,WAA2B;CAC9C,IAAI,OAAO;CACX,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC;EACjC,IAAI,IAAI,MAAM,GAAG;GAEf,MAAM,UAAU,IAAI;GACpB,OAAO,KAAK,MAAM,UAAU,EAAE,IAAK,UAAU;EAC/C,OACE,QAAQ;CAEZ;CACA,QAAQ,MAAO,OAAO,OAAO,MAAO;AACtC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,yCACF;CAGF,MAAM,QAAQ,EAAE,OAAO,CAAC;CACxB,MAAM,OAAO,EAAE,OAAO,CAAC;CAGvB,IAAI,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG;EAI3B,IAAI,SAHa,YAAY,OAC3B,OAAO,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,EAEnB,GAClB,OAAO,IACL,oBACA,mCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAGA,IAAI,UAAU,OAAO,UAAU,OAAO,UAAU,KAAK;EACnD,IAAI,SAAS;EACb,IAAI,UAAU,KACZ,SAAS;OACJ,IAAI,UAAU,KACnB,SAAS;EAEX,MAAM,SAAS,SAAS,EAAE,MAAM,GAAG,CAAC;EACpC,IAAI,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GAC9C,OAAO,IACL,kBACA,6CACF;EAKF,IAAI,SAHa,YAAY,OAC3B,OAAO,SAAS,QAAQ,EAAE,IAAI,EAEZ,GAClB,OAAO,IACL,oBACA,mCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAIA,IAAI,UAAU,OAAO,UAAU,OAAO,UAAU,KAAK;EACnD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GACzB,OAAO,IACL,kBACA,yCACF;EAKF,IAAI,SAHa,YAAY,OAC3B,OAAO,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,EAEnB,GAClB,OAAO,IACL,oBACA,qCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAIA,IAAI,oBAAa,SAAS,KAAK,GAAG;EAChC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GACzB,OAAO,IACL,kBACA,6CACF;EAEF,MAAM,QAAQ,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC;EAIvC,IACE,SAAS,OAAO,KAAK,KACrB,SAAS,YAAY,OAAO,KAAK,GAEjC,OAAO,IACL,oBACA,yCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAEA,OAAO,IACL,kBACA,uCACF;AACF;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,MAAM,UAAU;CAChB,MAAM,MAAM,aAAa,CAAC;CAC1B,OAAO,MAAM,QAAQ,OAAO,OAAO,GAAG,IAAI,EAAE;AAC9C;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa,WAAW;CACnC;CACA;CACA;CACA;AACF"}

package/dist/eu/mod.d.ts

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

package/dist/eu/vat.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { GlobalValidator, ValidateResult } from "../types.js";
 
 //#region src/eu/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 /**
@@ -13,8 +12,10 @@ declare const validate: (value: string) => ValidateResult;
  * prefixing if used here.
  */
 declare const format: (value: string) => string;
+/** Generate a random EU VAT number from a member validator. */
+declare const generate: () => string;
 /** European Union VAT Number. */
-declare const euVat: Validator;
+declare const euVat: GlobalValidator;
 //#endregion
-export { compact, euVat as default, format, validate };
+export { compact, euVat as default, format, generate, validate };
 //# sourceMappingURL=vat.d.ts.map

package/dist/eu/vat.js

@@ -1,4 +1,5 @@
 import { clean } from "../_util/clean.js";
+import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import uid from "../at/uid.js";
 import vat from "../be/vat.js";
@@ -125,8 +126,48 @@ const format = (value) => {
 	if (validator === void 0) return value;
 	return `${parts.cc}${validator.compact(parts.rest)}`;
 };
+const GENERATORS = [
+	["AT", uid],
+	["BE", vat],
+	["BG", vat$1],
+	["CY", vat$2],
+	["CZ", dic],
+	["DE", vat$3],
+	["DK", vat$4],
+	["EE", vat$5],
+	["ES", vat$6],
+	["FI", vat$7],
+	["FR", tva],
+	["GR", vat$9],
+	["HR", vat$10],
+	["HU", vat$11],
+	["IE", vat$12],
+	["IT", iva],
+	["LT", vat$13],
+	["LU", vat$14],
+	["LV", vat$15],
+	["MT", vat$16],
+	["NL", vat$17],
+	["PL", nip],
+	["PT", vat$18],
+	["RO", vat$19],
+	["SE", vat$20],
+	["SI", vat$21],
+	["SK", dic$1]
+];
+/** Generate a random EU VAT number from a member validator. */
+const generate = () => {
+	for (;;) {
+		const candidate = GENERATORS[randomInt(0, GENERATORS.length - 1)];
+		if (!candidate) continue;
+		const [prefix, validator] = candidate;
+		if (validator.generate === void 0) continue;
+		return `${prefix}${validator.generate()}`;
+	}
+};
 /** European Union VAT Number. */
 const euVat = {
+	scope: "global",
 	name: "EU VAT Number",
 	localName: "EU VAT Number",
 	abbreviation: "EU VAT",
@@ -137,9 +178,10 @@ const euVat = {
 	examples: ["ATU13585627", "DE136695976"],
 	compact,
 	format,
-	validate
+	validate,
+	generate
 };
 //#endregion
-export { compact, euVat as default, format, validate };
+export { compact, euVat as default, format, generate, validate };
 
 //# sourceMappingURL=vat.js.map