@stll/stdnum 0.0.1 → 2.0.0

package/dist/fr/siret.js

@@ -1,19 +1,9 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/fr/siret.ts
-/**
-* SIRET (Système d'Identification du Répertoire
-* des Établissements).
-*
-* French establishment identification number.
-* 14 digits: SIREN (9) + NIC (5). Validated
-* with Luhn, with a special case for La Poste.
-*
-* @see https://www.insee.fr/fr/information/2549588
-*/
 const compact = (value) => clean(value, " -.");
 /**
 * La Poste SIRET uses digit sum % 5 instead of
@@ -58,6 +48,7 @@ const siret = {
 	abbreviation: "SIRET",
 	aliases: ["SIRET", "numéro SIRET"],
 	candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}\\s?\\d{5}",
+	scope: "country",
 	country: "FR",
 	entityType: "company",
 	sourceUrl: "https://www.insee.fr/fr/information/2549588",

package/dist/fr/siret.js.map

@@ -1 +1 @@
-{"version":3,"file":"siret.js","names":[],"sources":["../../src/fr/siret.ts"],"sourcesContent":["/**\n * SIRET (Système d'Identification du Répertoire\n * des Établissements).\n *\n * French establishment identification number.\n * 14 digits: SIREN (9) + NIC (5). Validated\n * with Luhn, with a special case for La Poste.\n *\n * @see https://www.insee.fr/fr/information/2549588\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\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\n/**\n * La Poste SIRET uses digit sum % 5 instead of\n * Luhn, EXCEPT the head office (35600000000048)\n * which uses standard Luhn.\n */\nconst isLaPoste = (v: string): boolean =>\n  v.startsWith(\"356000000\") && v !== \"35600000000048\";\n\nconst digitSum = (v: string): number => {\n  let sum = 0;\n  for (let i = 0; i < v.length; i++) {\n    sum += Number(v[i]);\n  }\n  return sum;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIRET must be exactly 14 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIRET must contain only digits\",\n    );\n  }\n\n  // Validate SIREN part (first 9 digits)\n  const siren = v.slice(0, 9);\n  if (!luhnValidate(siren) && !isLaPoste(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIRET SIREN part fails Luhn check\",\n    );\n  }\n\n  // La Poste: digit sum mod 5\n  if (isLaPoste(v)) {\n    if (digitSum(v) % 5 !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET La Poste digit sum check failed\",\n      );\n    }\n  } else {\n    // Standard: full 14-digit Luhn\n    if (!luhnValidate(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET fails Luhn check\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;\n};\n\n/** Generate a random valid French SIRET. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const sc = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - sc) % 10);\n  const nic = randomDigits(4);\n  const payload = siren + nic;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Establishment Identification Number. */\nconst siret: Validator = {\n  name: \"French Establishment ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Établissements\",\n  abbreviation: \"SIRET\",\n  aliases: [\"SIRET\", \"numéro SIRET\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{5}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"73282932000074\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siret;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;;AAOrB,MAAM,aAAa,MACjB,EAAE,WAAW,YAAY,IAAI,MAAM;AAErC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,IAC5B,QAAO,OAAO,EAAE,GAAG;AAErB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAKH,KAAI,CAAC,aADS,EAAE,MAAM,GAAG,EAAE,CACH,IAAI,CAAC,UAAU,EAAE,CACvC,QAAO,IACL,oBACA,oCACD;AAIH,KAAI,UAAU,EAAE;MACV,SAAS,EAAE,GAAG,MAAM,EACtB,QAAO,IACL,oBACA,wCACD;YAIC,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,yBACD;AAIL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIzE,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,EAAE;CAC1B,MAAM,KAAK,aAAa,KAAK,IAAI;CAGjC,MAAM,UAFQ,KAAK,QAAQ,KAAK,MAAM,GAAG,GAC7B,aAAa,EAAE;CAE3B,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,QAAmB;CACvB,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,SAAS,eAAe;CAClC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,iBAAiB;CAC5B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"siret.js","names":[],"sources":["../../src/fr/siret.ts"],"sourcesContent":["/**\n * SIRET (Système d'Identification du Répertoire\n * des Établissements).\n *\n * French establishment identification number.\n * 14 digits: SIREN (9) + NIC (5). Validated\n * with Luhn, with a special case for La Poste.\n *\n * @see https://www.insee.fr/fr/information/2549588\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\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\n/**\n * La Poste SIRET uses digit sum % 5 instead of\n * Luhn, EXCEPT the head office (35600000000048)\n * which uses standard Luhn.\n */\nconst isLaPoste = (v: string): boolean =>\n  v.startsWith(\"356000000\") && v !== \"35600000000048\";\n\nconst digitSum = (v: string): number => {\n  let sum = 0;\n  for (let i = 0; i < v.length; i++) {\n    sum += Number(v[i]);\n  }\n  return sum;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIRET must be exactly 14 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIRET must contain only digits\",\n    );\n  }\n\n  // Validate SIREN part (first 9 digits)\n  const siren = v.slice(0, 9);\n  if (!luhnValidate(siren) && !isLaPoste(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIRET SIREN part fails Luhn check\",\n    );\n  }\n\n  // La Poste: digit sum mod 5\n  if (isLaPoste(v)) {\n    if (digitSum(v) % 5 !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET La Poste digit sum check failed\",\n      );\n    }\n  } else {\n    // Standard: full 14-digit Luhn\n    if (!luhnValidate(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET fails Luhn check\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;\n};\n\n/** Generate a random valid French SIRET. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const sc = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - sc) % 10);\n  const nic = randomDigits(4);\n  const payload = siren + nic;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Establishment Identification Number. */\nconst siret: CountryValidator<\"FR\"> = {\n  name: \"French Establishment ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Établissements\",\n  abbreviation: \"SIRET\",\n  aliases: [\"SIRET\", \"numéro SIRET\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{5}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"73282932000074\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siret;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAyBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;;;;;AAOpB,MAAM,aAAa,MACjB,EAAE,WAAW,WAAW,KAAK,MAAM;AAErC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAC5B,OAAO,OAAO,EAAE,EAAE;CAEpB,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,iCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,gCACF;CAKF,IAAI,CAAC,aADS,EAAE,MAAM,GAAG,CACH,CAAC,KAAK,CAAC,UAAU,CAAC,GACtC,OAAO,IACL,oBACA,mCACF;CAIF,IAAI,UAAU,CAAC;MACT,SAAS,CAAC,IAAI,MAAM,GACtB,OAAO,IACL,oBACA,uCACF;CAAA,OAIF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,wBACF;CAIJ,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACxE;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,CAAC;CACzB,MAAM,KAAK,aAAa,KAAK,GAAG;CAGhC,MAAM,UAFQ,KAAK,QAAQ,KAAK,MAAM,EAAE,IAC5B,aAAa,CACC;CAC1B,MAAM,KAAK,aAAa,UAAU,GAAG;CACrC,OAAO,UAAU,QAAQ,KAAK,MAAM,EAAE;AACxC;;AAGA,MAAM,QAAgC;CACpC,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,SAAS,cAAc;CACjC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,gBAAgB;CAC3B;CACA;CACA;CACA;AACF"}

package/dist/fr/tva.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/fr/tva.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid French TVA. */
 declare const generate: () => string;
 /** French VAT Number. */
-declare const tva: Validator;
+declare const tva: CountryValidator<"FR">;
 //#endregion
 export { compact, tva as default, format, generate, validate };
 //# sourceMappingURL=tva.d.ts.map

package/dist/fr/tva.js

@@ -1,20 +1,9 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/fr/tva.ts
-/**
-* n° TVA (Numéro de TVA intracommunautaire).
-*
-* French VAT number. 11 characters: 2-char
-* check prefix + 9-digit SIREN. The prefix
-* can be numeric (old style) or alphanumeric
-* (new style, letters from a restricted
-* alphabet excluding I and O).
-*
-* @see https://www.economie.gouv.fr/
-*/
 const ALPHABET = "0123456789ABCDEFGHJKLMNPQRSTUVWXYZ";
 const compact = (value) => {
 	let v = clean(value, " -.");
@@ -65,6 +54,7 @@ const tva = {
 		"FR VAT"
 	],
 	candidatePattern: "FR[A-Z0-9]{2}\\d{9}",
+	scope: "country",
 	country: "FR",
 	entityType: "company",
 	sourceUrl: "https://www.economie.gouv.fr/",

package/dist/fr/tva.js.map

@@ -1 +1 @@
-{"version":3,"file":"tva.js","names":[],"sources":["../../src/fr/tva.ts"],"sourcesContent":["/**\n * n° TVA (Numéro de TVA intracommunautaire).\n *\n * French VAT number. 11 characters: 2-char\n * check prefix + 9-digit SIREN. The prefix\n * can be numeric (old style) or alphanumeric\n * (new style, letters from a restricted\n * alphabet excluding I and O).\n *\n * @see https://www.economie.gouv.fr/\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\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 ALPHABET = \"0123456789ABCDEFGHJKLMNPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\");\n  if (v.startsWith(\"FR\") || v.startsWith(\"fr\")) {\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 !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French TVA must be 11 characters\",\n    );\n  }\n\n  const prefix = v.slice(0, 2);\n  const siren = v.slice(2);\n\n  if (!isdigits(siren)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA SIREN part must be digits\",\n    );\n  }\n\n  // Validate prefix characters are in alphabet\n  const p0 = prefix[0] ?? \"\";\n  const p1 = prefix[1] ?? \"\";\n  if (\n    ALPHABET.indexOf(p0) < 0 ||\n    ALPHABET.indexOf(p1) < 0\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA prefix contains invalid chars\",\n    );\n  }\n\n  // SIREN validation (skip Monaco: starts with 000)\n  if (!siren.startsWith(\"000\") && !luhnValidate(siren)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French TVA SIREN part fails Luhn check\",\n    );\n  }\n\n  const c0 = ALPHABET.indexOf(p0);\n  const c1 = ALPHABET.indexOf(p1);\n\n  if (c0 < 10 && c1 < 10) {\n    // Old-style: both digits numeric\n    const check = Number(prefix);\n    const expected = Number(siren + \"12\") % 97;\n    if (check !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  } else {\n    // New-style: at least one letter\n    let cvalue: number;\n    if (c0 < 10) {\n      cvalue = c0 * 24 + c1 - 10;\n    } else {\n      cvalue = c0 * 34 + c1 - 100;\n    }\n    const sirenNum = Number(siren);\n    if (\n      (sirenNum + 1 + Math.floor(cvalue / 11)) % 11 !==\n      cvalue % 11\n    ) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FR${compact(value)}`;\n\n/** Generate a random valid French TVA. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const cs = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - cs) % 10);\n  const prefix = String(\n    (12 + 3 * (Number(siren) % 97)) % 97,\n  ).padStart(2, \"0\");\n  return prefix + siren;\n};\n\n/** French VAT Number. */\nconst tva: Validator = {\n  name: \"French VAT Number\",\n  localName: \"Numéro de TVA intracommunautaire\",\n  abbreviation: \"TVA\",\n  aliases: [\n    \"numéro de TVA\",\n    \"TVA intracommunautaire\",\n    \"FR VAT\",\n  ] as const,\n  candidatePattern: \"FR[A-Z0-9]{2}\\\\d{9}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.economie.gouv.fr/\",\n  examples: [\"40303265045\", \"K7399859412\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tva;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,MAAM,WAAW;AAEjB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;AAC3B,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,GACf,QAAO,IACL,kBACA,mCACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,QAAQ,EAAE,MAAM,EAAE;AAExB,KAAI,CAAC,SAAS,MAAM,CAClB,QAAO,IACL,kBACA,uCACD;CAIH,MAAM,KAAK,OAAO,MAAM;CACxB,MAAM,KAAK,OAAO,MAAM;AACxB,KACE,SAAS,QAAQ,GAAG,GAAG,KACvB,SAAS,QAAQ,GAAG,GAAG,EAEvB,QAAO,IACL,kBACA,2CACD;AAIH,KAAI,CAAC,MAAM,WAAW,MAAM,IAAI,CAAC,aAAa,MAAM,CAClD,QAAO,IACL,oBACA,yCACD;CAGH,MAAM,KAAK,SAAS,QAAQ,GAAG;CAC/B,MAAM,KAAK,SAAS,QAAQ,GAAG;AAE/B,KAAI,KAAK,MAAM,KAAK;MAEJ,OAAO,OAAO,KACX,OAAO,QAAQ,KAAK,GAAG,GAEtC,QAAO,IACL,oBACA,mCACD;QAEE;EAEL,IAAI;AACJ,MAAI,KAAK,GACP,UAAS,KAAK,KAAK,KAAK;MAExB,UAAS,KAAK,KAAK,KAAK;AAG1B,OADiB,OAAO,MAAM,GAEhB,IAAI,KAAK,MAAM,SAAS,GAAG,IAAI,OAC3C,SAAS,GAET,QAAO,IACL,oBACA,mCACD;;AAIL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,EAAE;CAC1B,MAAM,KAAK,aAAa,KAAK,IAAI;CACjC,MAAM,QAAQ,KAAK,QAAQ,KAAK,MAAM,GAAG;AAIzC,QAHe,QACZ,KAAK,KAAK,OAAO,MAAM,GAAG,OAAO,GACnC,CAAC,SAAS,GAAG,IAAI,GACF;;;AAIlB,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,eAAe,cAAc;CACxC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"tva.js","names":[],"sources":["../../src/fr/tva.ts"],"sourcesContent":["/**\n * n° TVA (Numéro de TVA intracommunautaire).\n *\n * French VAT number. 11 characters: 2-char\n * check prefix + 9-digit SIREN. The prefix\n * can be numeric (old style) or alphanumeric\n * (new style, letters from a restricted\n * alphabet excluding I and O).\n *\n * @see https://www.economie.gouv.fr/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst ALPHABET = \"0123456789ABCDEFGHJKLMNPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\");\n  if (v.startsWith(\"FR\") || v.startsWith(\"fr\")) {\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 !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French TVA must be 11 characters\",\n    );\n  }\n\n  const prefix = v.slice(0, 2);\n  const siren = v.slice(2);\n\n  if (!isdigits(siren)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA SIREN part must be digits\",\n    );\n  }\n\n  // Validate prefix characters are in alphabet\n  const p0 = prefix[0] ?? \"\";\n  const p1 = prefix[1] ?? \"\";\n  if (\n    ALPHABET.indexOf(p0) < 0 ||\n    ALPHABET.indexOf(p1) < 0\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French TVA prefix contains invalid chars\",\n    );\n  }\n\n  // SIREN validation (skip Monaco: starts with 000)\n  if (!siren.startsWith(\"000\") && !luhnValidate(siren)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French TVA SIREN part fails Luhn check\",\n    );\n  }\n\n  const c0 = ALPHABET.indexOf(p0);\n  const c1 = ALPHABET.indexOf(p1);\n\n  if (c0 < 10 && c1 < 10) {\n    // Old-style: both digits numeric\n    const check = Number(prefix);\n    const expected = Number(siren + \"12\") % 97;\n    if (check !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  } else {\n    // New-style: at least one letter\n    let cvalue: number;\n    if (c0 < 10) {\n      cvalue = c0 * 24 + c1 - 10;\n    } else {\n      cvalue = c0 * 34 + c1 - 100;\n    }\n    const sirenNum = Number(siren);\n    if (\n      (sirenNum + 1 + Math.floor(cvalue / 11)) % 11 !==\n      cvalue % 11\n    ) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"French TVA check digits mismatch\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FR${compact(value)}`;\n\n/** Generate a random valid French TVA. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const cs = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - cs) % 10);\n  const prefix = String(\n    (12 + 3 * (Number(siren) % 97)) % 97,\n  ).padStart(2, \"0\");\n  return prefix + siren;\n};\n\n/** French VAT Number. */\nconst tva: CountryValidator<\"FR\"> = {\n  name: \"French VAT Number\",\n  localName: \"Numéro de TVA intracommunautaire\",\n  abbreviation: \"TVA\",\n  aliases: [\n    \"numéro de TVA\",\n    \"TVA intracommunautaire\",\n    \"FR VAT\",\n  ] as const,\n  candidatePattern: \"FR[A-Z0-9]{2}\\\\d{9}\",\n  scope: \"country\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.economie.gouv.fr/\",\n  examples: [\"40303265045\", \"K7399859412\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tva;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AA0BA,MAAM,WAAW;AAEjB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK;CAC1B,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,IACf,OAAO,IACL,kBACA,kCACF;CAGF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,MAAM,QAAQ,EAAE,MAAM,CAAC;CAEvB,IAAI,CAAC,SAAS,KAAK,GACjB,OAAO,IACL,kBACA,sCACF;CAIF,MAAM,KAAK,OAAO,MAAM;CACxB,MAAM,KAAK,OAAO,MAAM;CACxB,IACE,SAAS,QAAQ,EAAE,IAAI,KACvB,SAAS,QAAQ,EAAE,IAAI,GAEvB,OAAO,IACL,kBACA,0CACF;CAIF,IAAI,CAAC,MAAM,WAAW,KAAK,KAAK,CAAC,aAAa,KAAK,GACjD,OAAO,IACL,oBACA,wCACF;CAGF,MAAM,KAAK,SAAS,QAAQ,EAAE;CAC9B,MAAM,KAAK,SAAS,QAAQ,EAAE;CAE9B,IAAI,KAAK,MAAM,KAAK;MAEJ,OAAO,MAEb,MADS,OAAO,QAAQ,IAAI,IAAI,IAEtC,OAAO,IACL,oBACA,kCACF;CAAA,OAEG;EAEL,IAAI;EACJ,IAAI,KAAK,IACP,SAAS,KAAK,KAAK,KAAK;OAExB,SAAS,KAAK,KAAK,KAAK;EAG1B,KADiB,OAAO,KAEd,IAAI,IAAI,KAAK,MAAM,SAAS,EAAE,KAAK,OAC3C,SAAS,IAET,OAAO,IACL,oBACA,kCACF;CAEJ;CAEA,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,CAAC;CACzB,MAAM,KAAK,aAAa,KAAK,GAAG;CAChC,MAAM,QAAQ,KAAK,QAAQ,KAAK,MAAM,EAAE;CAIxC,OAHe,QACZ,KAAK,KAAK,OAAO,KAAK,IAAI,OAAO,EACpC,EAAE,SAAS,GAAG,GACF,IAAI;AAClB;;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,eAAe,aAAa;CACvC;CACA;CACA;CACA;AACF"}

package/dist/gb/mod.d.ts

@@ -1,11 +1,12 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import nino from "./nino.js";
 import sedol from "./sedol.js";
 import utr from "./utr.js";
 import vat from "./vat.js";
 
 //#region src/gb/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { nino, sedol, utr, vat };
+}
 //#endregion
 export { mod_d_exports, nino, sedol, utr, vat };
 //# sourceMappingURL=mod.d.ts.map

package/dist/gb/nino.d.ts

@@ -1,13 +1,23 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gb/nino.d.ts
 /** Generate a random valid UK NINO. */
 declare const generate: () => string;
+/**
+ * NINO (National Insurance Number).
+ *
+ * UK National Insurance Number. Format: 2 letters
+ * + 6 digits + 1 suffix letter (A, B, C, or D).
+ * Validated by format and prefix rules only; there
+ * is no checksum.
+ *
+ * @see https://www.gov.uk/hmrc-internal-manuals/national-insurance-manual/nim39110
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** UK National Insurance Number. */
-declare const nino: Validator;
+declare const nino: CountryValidator<"GB">;
 //#endregion
 export { compact, nino as default, format, generate, validate };
 //# sourceMappingURL=nino.d.ts.map

package/dist/gb/nino.js

@@ -1,32 +1,22 @@
 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";
 //#region src/gb/nino.ts
-/**
-* NINO (National Insurance Number).
-*
-* UK National Insurance Number. Format: 2 letters
-* + 6 digits + 1 suffix letter (A, B, C, or D).
-* Validated by format and prefix rules only; there
-* is no checksum.
-*
-* @see https://www.gov.uk/hmrc-internal-manuals/national-insurance-manual/nim39110
-*/
+const NINO_VALID_FIRST = "ABCEGHJKLMNOPRSTWXYZ";
+const NINO_VALID_SECOND = "ABCEGHJKLMNPRSTWXYZ";
+const NINO_SUFFIXES = "ABCD";
 /** Generate a random valid UK NINO. */
 const generate = () => {
-	const validFirst = "ABCEGHJKLMNOPRSTWXYZ";
-	const validSecond = "ABCEGHJKLMNPRSTWXYZ";
-	const suffixes = "ABCD";
 	let first;
 	let second;
 	let prefix;
 	do {
-		first = validFirst[randomInt(0, 19)];
-		second = validSecond[randomInt(0, 18)];
+		first = randomChar(NINO_VALID_FIRST);
+		second = randomChar(NINO_VALID_SECOND);
 		prefix = first + second;
 	} while (INVALID_PREFIX.has(prefix));
 	const digits = randomDigits(6);
-	const suffix = suffixes[randomInt(0, 3)];
+	const suffix = randomChar(NINO_SUFFIXES);
 	return `${prefix}${digits}${suffix}`;
 };
 const INVALID_FIRST = new Set([
@@ -86,6 +76,7 @@ const nino = {
 		"NI number"
 	],
 	candidatePattern: "[A-Z]{2}\\d{6}[A-Z]",
+	scope: "country",
 	country: "GB",
 	entityType: "person",
 	description: "UK National Insurance Number for tax and benefits",

package/dist/gb/nino.js.map

@@ -1 +1 @@
-{"version":3,"file":"nino.js","names":[],"sources":["../../src/gb/nino.ts"],"sourcesContent":["/** Generate a random valid UK NINO. */\nconst generate = (): string => {\n  const validFirst = \"ABCEGHJKLMNOPRSTWXYZ\";\n  const validSecond = \"ABCEGHJKLMNPRSTWXYZ\";\n  const suffixes = \"ABCD\";\n  let first: string;\n  let second: string;\n  let prefix: string;\n  do {\n    first =\n      validFirst[randomInt(0, validFirst.length - 1)]!;\n    second =\n      validSecond[randomInt(0, validSecond.length - 1)]!;\n    prefix = first + second;\n  } while (INVALID_PREFIX.has(prefix));\n  const digits = randomDigits(6);\n  const suffix =\n    suffixes[randomInt(0, suffixes.length - 1)]!;\n  return `${prefix}${digits}${suffix}`;\n};\n\n/**\n * NINO (National Insurance Number).\n *\n * UK National Insurance Number. Format: 2 letters\n * + 6 digits + 1 suffix letter (A, B, C, or D).\n * Validated by format and prefix rules only; there\n * is no checksum.\n *\n * @see https://www.gov.uk/hmrc-internal-manuals/national-insurance-manual/nim39110\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst INVALID_FIRST = new Set([\n  \"D\",\n  \"F\",\n  \"I\",\n  \"Q\",\n  \"U\",\n  \"V\",\n]);\n\nconst INVALID_SECOND = new Set([\n  \"D\",\n  \"F\",\n  \"I\",\n  \"O\",\n  \"Q\",\n  \"U\",\n  \"V\",\n]);\n\nconst INVALID_PREFIX = new Set([\n  \"BG\",\n  \"GB\",\n  \"NK\",\n  \"KN\",\n  \"TN\",\n  \"NT\",\n  \"ZZ\",\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      \"UK NINO must be 9 characters\",\n    );\n  }\n\n  if (!/^[A-Z]{2}\\d{6}[A-D]$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK NINO must be 2 letters, 6 digits, \" +\n        \"then A/B/C/D\",\n    );\n  }\n\n  const first = v[0]!;\n  const second = v[1]!;\n  const prefix = v.slice(0, 2);\n\n  if (INVALID_FIRST.has(first)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `UK NINO first letter cannot be ${first}`,\n    );\n  }\n\n  if (INVALID_SECOND.has(second)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `UK NINO second letter cannot be ${second}`,\n    );\n  }\n\n  if (INVALID_PREFIX.has(prefix)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `UK NINO prefix ${prefix} is not allowed`,\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, 2)} ${v.slice(2, 4)}` +\n    ` ${v.slice(4, 6)} ${v.slice(6, 8)}` +\n    ` ${v.slice(8)}`\n  );\n};\n\n/** UK National Insurance Number. */\nconst nino: Validator = {\n  name: \"UK National Insurance Number\",\n  localName: \"National Insurance Number\",\n  abbreviation: \"NINO\",\n  aliases: [\n    \"National Insurance number\",\n    \"NINO\",\n    \"NI number\",\n  ] as const,\n  candidatePattern: \"[A-Z]{2}\\\\d{6}[A-Z]\",\n  country: \"GB\",\n  entityType: \"person\",\n  description:\n    \"UK National Insurance Number for tax \" +\n    \"and benefits\",\n  sourceUrl:\n    \"https://www.gov.uk/hmrc-internal-manuals/\" +\n    \"national-insurance-manual/nim39110\",\n  lengths: [9] as const,\n  examples: [\"AB123456C\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nino;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,aAAa;CACnB,MAAM,cAAc;CACpB,MAAM,WAAW;CACjB,IAAI;CACJ,IAAI;CACJ,IAAI;AACJ,IAAG;AACD,UACE,WAAW,UAAU,GAAG,GAAsB;AAChD,WACE,YAAY,UAAU,GAAG,GAAuB;AAClD,WAAS,QAAQ;UACV,eAAe,IAAI,OAAO;CACnC,MAAM,SAAS,aAAa,EAAE;CAC9B,MAAM,SACJ,SAAS,UAAU,GAAG,EAAoB;AAC5C,QAAO,GAAG,SAAS,SAAS;;AAoB9B,MAAM,gBAAgB,IAAI,IAAI;CAC5B;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,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,+BACD;AAGH,KAAI,CAAC,uBAAuB,KAAK,EAAE,CACjC,QAAO,IACL,kBACA,oDAED;CAGH,MAAM,QAAQ,EAAE;CAChB,MAAM,SAAS,EAAE;CACjB,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAE5B,KAAI,cAAc,IAAI,MAAM,CAC1B,QAAO,IACL,qBACA,kCAAkC,QACnC;AAGH,KAAI,eAAe,IAAI,OAAO,CAC5B,QAAO,IACL,qBACA,mCAAmC,SACpC;AAGH,KAAI,eAAe,IAAI,OAAO,CAC5B,QAAO,IACL,qBACA,kBAAkB,OAAO,iBAC1B;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QACE,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAA,GAC7B,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAA,GAC9B,EAAE,MAAM,EAAE;;;AAKlB,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CAEF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nino.js","names":[],"sources":["../../src/gb/nino.ts"],"sourcesContent":["const NINO_VALID_FIRST = \"ABCEGHJKLMNOPRSTWXYZ\";\nconst NINO_VALID_SECOND = \"ABCEGHJKLMNPRSTWXYZ\";\nconst NINO_SUFFIXES = \"ABCD\";\n\n/** Generate a random valid UK NINO. */\nconst generate = (): string => {\n  let first: string;\n  let second: string;\n  let prefix: string;\n  do {\n    first = randomChar(NINO_VALID_FIRST);\n    second = randomChar(NINO_VALID_SECOND);\n    prefix = first + second;\n  } while (INVALID_PREFIX.has(prefix));\n  const digits = randomDigits(6);\n  const suffix = randomChar(NINO_SUFFIXES);\n  return `${prefix}${digits}${suffix}`;\n};\n\n/**\n * NINO (National Insurance Number).\n *\n * UK National Insurance Number. Format: 2 letters\n * + 6 digits + 1 suffix letter (A, B, C, or D).\n * Validated by format and prefix rules only; there\n * is no checksum.\n *\n * @see https://www.gov.uk/hmrc-internal-manuals/national-insurance-manual/nim39110\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomChar, randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst INVALID_FIRST = new Set([\n  \"D\",\n  \"F\",\n  \"I\",\n  \"Q\",\n  \"U\",\n  \"V\",\n]);\n\nconst INVALID_SECOND = new Set([\n  \"D\",\n  \"F\",\n  \"I\",\n  \"O\",\n  \"Q\",\n  \"U\",\n  \"V\",\n]);\n\nconst INVALID_PREFIX = new Set([\n  \"BG\",\n  \"GB\",\n  \"NK\",\n  \"KN\",\n  \"TN\",\n  \"NT\",\n  \"ZZ\",\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      \"UK NINO must be 9 characters\",\n    );\n  }\n\n  if (!/^[A-Z]{2}\\d{6}[A-D]$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK NINO must be 2 letters, 6 digits, \" +\n        \"then A/B/C/D\",\n    );\n  }\n\n  // SAFETY: regex above guarantees v.length === 9.\n  // eslint-disable-next-line no-non-null-assertion\n  const first = v[0]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const second = v[1]!;\n  const prefix = v.slice(0, 2);\n\n  if (INVALID_FIRST.has(first)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `UK NINO first letter cannot be ${first}`,\n    );\n  }\n\n  if (INVALID_SECOND.has(second)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `UK NINO second letter cannot be ${second}`,\n    );\n  }\n\n  if (INVALID_PREFIX.has(prefix)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `UK NINO prefix ${prefix} is not allowed`,\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, 2)} ${v.slice(2, 4)}` +\n    ` ${v.slice(4, 6)} ${v.slice(6, 8)}` +\n    ` ${v.slice(8)}`\n  );\n};\n\n/** UK National Insurance Number. */\nconst nino: CountryValidator<\"GB\"> = {\n  name: \"UK National Insurance Number\",\n  localName: \"National Insurance Number\",\n  abbreviation: \"NINO\",\n  aliases: [\n    \"National Insurance number\",\n    \"NINO\",\n    \"NI number\",\n  ] as const,\n  candidatePattern: \"[A-Z]{2}\\\\d{6}[A-Z]\",\n  scope: \"country\",\n  country: \"GB\",\n  entityType: \"person\",\n  description:\n    \"UK National Insurance Number for tax \" +\n    \"and benefits\",\n  sourceUrl:\n    \"https://www.gov.uk/hmrc-internal-manuals/\" +\n    \"national-insurance-manual/nim39110\",\n  lengths: [9] as const,\n  examples: [\"AB123456C\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nino;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAAA,MAAM,mBAAmB;AACzB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;;AAGtB,MAAM,iBAAyB;CAC7B,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,GAAG;EACD,QAAQ,WAAW,gBAAgB;EACnC,SAAS,WAAW,iBAAiB;EACrC,SAAS,QAAQ;CACnB,SAAS,eAAe,IAAI,MAAM;CAClC,MAAM,SAAS,aAAa,CAAC;CAC7B,MAAM,SAAS,WAAW,aAAa;CACvC,OAAO,GAAG,SAAS,SAAS;AAC9B;AAsBA,MAAM,gBAAgB,IAAI,IAAI;CAC5B;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,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,8BACF;CAGF,IAAI,CAAC,uBAAuB,KAAK,CAAC,GAChC,OAAO,IACL,kBACA,mDAEF;CAKF,MAAM,QAAQ,EAAE;CAEhB,MAAM,SAAS,EAAE;CACjB,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAE3B,IAAI,cAAc,IAAI,KAAK,GACzB,OAAO,IACL,qBACA,kCAAkC,OACpC;CAGF,IAAI,eAAe,IAAI,MAAM,GAC3B,OAAO,IACL,qBACA,mCAAmC,QACrC;CAGF,IAAI,eAAe,IAAI,MAAM,GAC3B,OAAO,IACL,qBACA,kBAAkB,OAAO,gBAC3B;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OACE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAA,GAC5B,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAA,GAC7B,EAAE,MAAM,CAAC;AAEjB;;AAGA,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CAEF,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/gb/sedol.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gb/sedol.d.ts
-
 declare const calcCheckDigit: (number: string) => string;
 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 SEDOL. */
 declare const generate: () => string;
 /** Stock Exchange Daily Official List number. */
-declare const sedol: Validator;
+declare const sedol: CountryValidator<"GB">;
 //#endregion
 export { calcCheckDigit, compact, sedol as default, format, generate, validate };
 //# sourceMappingURL=sedol.d.ts.map

package/dist/gb/sedol.js

@@ -1,20 +1,9 @@
 import { clean } from "../_util/clean.js";
-import { randomInt } from "../_util/generate.js";
+import { randomChar } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/gb/sedol.ts
 /**
-* SEDOL (Stock Exchange Daily Official List number).
-*
-* 7-character security identifier used in the UK and
-* Ireland, assigned by the London Stock Exchange.
-* Consists of 6 alphanumeric characters (vowels
-* excluded) followed by a weighted mod-10 check
-* digit.
-*
-* @see https://en.wikipedia.org/wiki/SEDOL
-*/
-/**
 * Allowed characters in a SEDOL: digits and
 * consonants only (vowels are never used).
 * Spaces occupy vowel positions (A=10, E=14,
@@ -33,11 +22,12 @@ const WEIGHTS = [
 const calcCheckDigit = (number) => {
 	if (number.length !== 6) throw new Error("calcCheckDigit requires a 6-character SEDOL prefix");
 	let sum = 0;
-	for (let i = 0; i < 6; i++) {
+	for (const [i, weight] of WEIGHTS.entries()) {
 		const ch = number[i];
+		if (ch === void 0) continue;
 		const val = ALPHABET.indexOf(ch);
 		if (val < 0) throw new Error(`Invalid SEDOL character: ${ch}`);
-		sum += WEIGHTS[i] * val;
+		sum += weight * val;
 	}
 	return String((10 - sum % 10) % 10);
 };
@@ -54,12 +44,12 @@ const validate = (value) => {
 	};
 };
 const format = (value) => compact(value);
+const SEDOL_CONSONANTS = "BCDFGHJKLMNPQRSTVWXYZ";
+const SEDOL_CHARS = "0123456789BCDFGHJKLMNPQRSTVWXYZ";
 /** Generate a random valid SEDOL. */
 const generate = () => {
-	const consonants = "BCDFGHJKLMNPQRSTVWXYZ";
-	const chars = "0123456789BCDFGHJKLMNPQRSTVWXYZ";
-	let payload = consonants[randomInt(0, 20)];
-	for (let i = 1; i < 6; i++) payload += chars[randomInt(0, 30)];
+	let payload = randomChar(SEDOL_CONSONANTS);
+	for (let i = 1; i < 6; i++) payload += randomChar(SEDOL_CHARS);
 	return payload + calcCheckDigit(payload);
 };
 /** Stock Exchange Daily Official List number. */
@@ -69,6 +59,7 @@ const sedol = {
 	abbreviation: "SEDOL",
 	aliases: ["SEDOL", "Stock Exchange Daily Official List"],
 	candidatePattern: "[B-DF-HJ-NP-TV-Z0-9]{6}\\d",
+	scope: "country",
 	country: "GB",
 	entityType: "any",
 	sourceUrl: "https://en.wikipedia.org/wiki/SEDOL",

package/dist/gb/sedol.js.map

@@ -1 +1 @@
-{"version":3,"file":"sedol.js","names":[],"sources":["../../src/gb/sedol.ts"],"sourcesContent":["/**\n * SEDOL (Stock Exchange Daily Official List number).\n *\n * 7-character security identifier used in the UK and\n * Ireland, assigned by the London Stock Exchange.\n * Consists of 6 alphanumeric characters (vowels\n * excluded) followed by a weighted mod-10 check\n * digit.\n *\n * @see https://en.wikipedia.org/wiki/SEDOL\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Allowed characters in a SEDOL: digits and\n * consonants only (vowels are never used).\n * Spaces occupy vowel positions (A=10, E=14,\n * I=18, O=24, U=30) so that indexOf returns\n * the correct SEDOL weight for each consonant.\n */\nconst ALPHABET = \"0123456789 BCD FGH JKLMN PQRST VWXYZ\";\n\nconst WEIGHTS = [1, 3, 1, 7, 3, 9] as const;\n\nconst calcCheckDigit = (number: string): string => {\n  if (number.length !== 6) {\n    throw new Error(\n      \"calcCheckDigit requires a 6-character \" +\n        \"SEDOL prefix\",\n    );\n  }\n  let sum = 0;\n  for (let i = 0; i < 6; i++) {\n    const ch = number[i]!;\n    const val = ALPHABET.indexOf(ch);\n    if (val < 0) {\n      throw new Error(`Invalid SEDOL character: ${ch}`);\n    }\n    // SAFETY: weights length matches loop bound\n    sum += WEIGHTS[i]! * val;\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" \").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 7) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SEDOL must be exactly 7 characters\",\n    );\n  }\n\n  for (const ch of v) {\n    if (!ALPHABET.includes(ch)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"SEDOL contains invalid character: \" +\n          \"vowels are not allowed\",\n      );\n    }\n  }\n\n  // Old-style SEDOLs are fully numeric; new-style\n  // SEDOLs start with a letter. A number that starts\n  // with a digit but contains letters is invalid.\n  if (isdigits(v[0]!) && !isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Numeric-prefix SEDOL must be fully \" +\n        \"numeric (old-style)\",\n    );\n  }\n\n  if (calcCheckDigit(v.slice(0, 6)) !== v[6]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SEDOL check digit 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 SEDOL. */\nconst generate = (): string => {\n  const consonants = \"BCDFGHJKLMNPQRSTVWXYZ\";\n  const chars = \"0123456789BCDFGHJKLMNPQRSTVWXYZ\";\n  const first =\n    consonants[randomInt(0, consonants.length - 1)]!;\n  let payload = first;\n  for (let i = 1; i < 6; i++)\n    payload += chars[randomInt(0, chars.length - 1)]!;\n  return payload + calcCheckDigit(payload);\n};\n\n/** Stock Exchange Daily Official List number. */\nconst sedol: Validator = {\n  name: \"Stock Exchange Daily Official List number\",\n  localName: \"Stock Exchange Daily Official List number\",\n  abbreviation: \"SEDOL\",\n  aliases: [\n    \"SEDOL\",\n    \"Stock Exchange Daily Official List\",\n  ] as const,\n  candidatePattern: \"[B-DF-HJ-NP-TV-Z0-9]{6}\\\\d\",\n  country: \"GB\",\n  entityType: \"any\",\n  sourceUrl: \"https://en.wikipedia.org/wiki/SEDOL\",\n  lengths: [7] as const,\n  examples: [\"B15KXQ8\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default sedol;\nexport {\n  calcCheckDigit,\n  compact,\n  format,\n  validate,\n  generate,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,WAAW;AAEjB,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAElC,MAAM,kBAAkB,WAA2B;AACjD,KAAI,OAAO,WAAW,EACpB,OAAM,IAAI,MACR,qDAED;CAEH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,KAAK,OAAO;EAClB,MAAM,MAAM,SAAS,QAAQ,GAAG;AAChC,MAAI,MAAM,EACR,OAAM,IAAI,MAAM,4BAA4B,KAAK;AAGnD,SAAO,QAAQ,KAAM;;AAEvB,QAAO,QAAQ,KAAM,MAAM,MAAO,GAAG;;AAGvC,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,CAAC,aAAa;AAEjC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,qCACD;AAGH,MAAK,MAAM,MAAM,EACf,KAAI,CAAC,SAAS,SAAS,GAAG,CACxB,QAAO,IACL,kBACA,2DAED;AAOL,KAAI,SAAS,EAAE,GAAI,IAAI,CAAC,SAAS,EAAE,CACjC,QAAO,IACL,kBACA,yDAED;AAGH,KAAI,eAAe,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,GACtC,QAAO,IACL,oBACA,6BACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,aAAa;CACnB,MAAM,QAAQ;CAGd,IAAI,UADF,WAAW,UAAU,GAAG,GAAsB;AAEhD,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,YAAW,MAAM,UAAU,GAAG,GAAiB;AACjD,QAAO,UAAU,eAAe,QAAQ;;;AAI1C,MAAM,QAAmB;CACvB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,SACA,qCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,UAAU;CACrB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"sedol.js","names":[],"sources":["../../src/gb/sedol.ts"],"sourcesContent":["/**\n * SEDOL (Stock Exchange Daily Official List number).\n *\n * 7-character security identifier used in the UK and\n * Ireland, assigned by the London Stock Exchange.\n * Consists of 6 alphanumeric characters (vowels\n * excluded) followed by a weighted mod-10 check\n * digit.\n *\n * @see https://en.wikipedia.org/wiki/SEDOL\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomChar } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/**\n * Allowed characters in a SEDOL: digits and\n * consonants only (vowels are never used).\n * Spaces occupy vowel positions (A=10, E=14,\n * I=18, O=24, U=30) so that indexOf returns\n * the correct SEDOL weight for each consonant.\n */\nconst ALPHABET = \"0123456789 BCD FGH JKLMN PQRST VWXYZ\";\n\nconst WEIGHTS = [1, 3, 1, 7, 3, 9] as const;\n\nconst calcCheckDigit = (number: string): string => {\n  if (number.length !== 6) {\n    throw new Error(\n      \"calcCheckDigit requires a 6-character \" +\n        \"SEDOL prefix\",\n    );\n  }\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    const ch = number[i];\n    if (ch === undefined) continue;\n    const val = ALPHABET.indexOf(ch);\n    if (val < 0) {\n      throw new Error(`Invalid SEDOL character: ${ch}`);\n    }\n    sum += weight * val;\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" \").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 7) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SEDOL must be exactly 7 characters\",\n    );\n  }\n\n  for (const ch of v) {\n    if (!ALPHABET.includes(ch)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"SEDOL contains invalid character: \" +\n          \"vowels are not allowed\",\n      );\n    }\n  }\n\n  // Old-style SEDOLs are fully numeric; new-style\n  // SEDOLs start with a letter. A number that starts\n  // with a digit but contains letters is invalid.\n  // SAFETY: v.length === 7 here.\n  // eslint-disable-next-line no-non-null-assertion\n  if (isdigits(v[0]!) && !isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Numeric-prefix SEDOL must be fully \" +\n        \"numeric (old-style)\",\n    );\n  }\n\n  if (calcCheckDigit(v.slice(0, 6)) !== v[6]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SEDOL check digit mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst SEDOL_CONSONANTS = \"BCDFGHJKLMNPQRSTVWXYZ\";\nconst SEDOL_CHARS = \"0123456789BCDFGHJKLMNPQRSTVWXYZ\";\n\n/** Generate a random valid SEDOL. */\nconst generate = (): string => {\n  let payload = randomChar(SEDOL_CONSONANTS);\n  for (let i = 1; i < 6; i++) {\n    payload += randomChar(SEDOL_CHARS);\n  }\n  return payload + calcCheckDigit(payload);\n};\n\n/** Stock Exchange Daily Official List number. */\nconst sedol: CountryValidator<\"GB\"> = {\n  name: \"Stock Exchange Daily Official List number\",\n  localName: \"Stock Exchange Daily Official List number\",\n  abbreviation: \"SEDOL\",\n  aliases: [\n    \"SEDOL\",\n    \"Stock Exchange Daily Official List\",\n  ] as const,\n  candidatePattern: \"[B-DF-HJ-NP-TV-Z0-9]{6}\\\\d\",\n  scope: \"country\",\n  country: \"GB\",\n  entityType: \"any\",\n  sourceUrl: \"https://en.wikipedia.org/wiki/SEDOL\",\n  lengths: [7] as const,\n  examples: [\"B15KXQ8\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default sedol;\nexport {\n  calcCheckDigit,\n  compact,\n  format,\n  validate,\n  generate,\n};\n"],"mappings":";;;;;;;;;;;;AA6BA,MAAM,WAAW;AAEjB,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAEjC,MAAM,kBAAkB,WAA2B;CACjD,IAAI,OAAO,WAAW,GACpB,MAAM,IAAI,MACR,oDAEF;CAEF,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GAAG;EAC3C,MAAM,KAAK,OAAO;EAClB,IAAI,OAAO,KAAA,GAAW;EACtB,MAAM,MAAM,SAAS,QAAQ,EAAE;EAC/B,IAAI,MAAM,GACR,MAAM,IAAI,MAAM,4BAA4B,IAAI;EAElD,OAAO,SAAS;CAClB;CACA,OAAO,QAAQ,KAAM,MAAM,MAAO,EAAE;AACtC;AAEA,MAAM,WAAW,UACf,MAAM,OAAO,GAAG,EAAE,YAAY;AAEhC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,oCACF;CAGF,KAAK,MAAM,MAAM,GACf,IAAI,CAAC,SAAS,SAAS,EAAE,GACvB,OAAO,IACL,kBACA,0DAEF;CASJ,IAAI,SAAS,EAAE,EAAG,KAAK,CAAC,SAAS,CAAC,GAChC,OAAO,IACL,kBACA,wDAEF;CAGF,IAAI,eAAe,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,IACtC,OAAO,IACL,oBACA,4BACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;AAEvD,MAAM,mBAAmB;AACzB,MAAM,cAAc;;AAGpB,MAAM,iBAAyB;CAC7B,IAAI,UAAU,WAAW,gBAAgB;CACzC,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,WAAW,WAAW,WAAW;CAEnC,OAAO,UAAU,eAAe,OAAO;AACzC;;AAGA,MAAM,QAAgC;CACpC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,SACA,oCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,SAAS;CACpB;CACA;CACA;CACA;AACF"}

package/dist/gb/utr.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gb/utr.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid UK UTR. */
 declare const generate: () => string;
 /** UK Unique Taxpayer Reference. */
-declare const utr: Validator;
+declare const utr: CountryValidator<"GB">;
 //#endregion
 export { compact, utr as default, format, generate, validate };
 //# sourceMappingURL=utr.d.ts.map

package/dist/gb/utr.js

@@ -1,18 +1,9 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 //#region src/gb/utr.ts
-/**
-* UTR (Unique Taxpayer Reference).
-*
-* UK 10-digit tax reference number. The first
-* digit is a check digit computed using a
-* weighted sum with lookup table.
-*
-* @see https://www.gov.uk/find-utr-number
-*/
 const WEIGHTS = [
 	6,
 	7,
@@ -54,6 +45,7 @@ const utr = {
 	abbreviation: "UTR",
 	aliases: ["Unique Taxpayer Reference", "UTR"],
 	candidatePattern: "\\d{10}",
+	scope: "country",
 	country: "GB",
 	entityType: "any",
 	sourceUrl: "https://www.gov.uk/find-utr-number",

package/dist/gb/utr.js.map

@@ -1 +1 @@
-{"version":3,"file":"utr.js","names":[],"sources":["../../src/gb/utr.ts"],"sourcesContent":["/**\n * UTR (Unique Taxpayer Reference).\n *\n * UK 10-digit tax reference number. The first\n * digit is a check digit computed using a\n * weighted sum with lookup table.\n *\n * @see https://www.gov.uk/find-utr-number\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [6, 7, 8, 9, 10, 5, 4, 3, 2] as const;\nconst CHECK_LOOKUP = \"21987654321\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"UK UTR must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK UTR must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v.slice(1), WEIGHTS, 11);\n  const expected = CHECK_LOOKUP[sum];\n  if (expected !== v[0]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"UK UTR check digit mismatch\",\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, 5)} ${v.slice(5)}`;\n};\n\n/** Generate a random valid UK UTR. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** UK Unique Taxpayer Reference. */\nconst utr: Validator = {\n  name: \"UK Unique Taxpayer Reference\",\n  localName: \"Unique Taxpayer Reference\",\n  abbreviation: \"UTR\",\n  aliases: [\"Unique Taxpayer Reference\", \"UTR\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"GB\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.gov.uk/find-utr-number\",\n  examples: [\"1955839661\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default utr;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAE;AAC5C,MAAM,eAAe;AAErB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;AAIH,KADiB,aADL,YAAY,EAAE,MAAM,EAAE,EAAE,SAAS,GAAG,MAE/B,EAAE,GACjB,QAAO,IACL,oBACA,8BACD;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,EAAE;;;AAIvC,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,6BAA6B,MAAM;CAC7C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"utr.js","names":[],"sources":["../../src/gb/utr.ts"],"sourcesContent":["/**\n * UTR (Unique Taxpayer Reference).\n *\n * UK 10-digit tax reference number. The first\n * digit is a check digit computed using a\n * weighted sum with lookup table.\n *\n * @see https://www.gov.uk/find-utr-number\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [6, 7, 8, 9, 10, 5, 4, 3, 2] as const;\nconst CHECK_LOOKUP = \"21987654321\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"UK UTR must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK UTR must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v.slice(1), WEIGHTS, 11);\n  const expected = CHECK_LOOKUP[sum];\n  if (expected !== v[0]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"UK UTR check digit mismatch\",\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, 5)} ${v.slice(5)}`;\n};\n\n/** Generate a random valid UK UTR. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** UK Unique Taxpayer Reference. */\nconst utr: CountryValidator<\"GB\"> = {\n  name: \"UK Unique Taxpayer Reference\",\n  localName: \"Unique Taxpayer Reference\",\n  abbreviation: \"UTR\",\n  aliases: [\"Unique Taxpayer Reference\", \"UTR\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  scope: \"country\",\n  country: \"GB\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.gov.uk/find-utr-number\",\n  examples: [\"1955839661\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default utr;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAqBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;AAAC;AAC3C,MAAM,eAAe;AAErB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,iCACF;CAIF,IADiB,aADL,YAAY,EAAE,MAAM,CAAC,GAAG,SAAS,EACb,OACf,EAAE,IACjB,OAAO,IACL,oBACA,6BACF;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,CAAC;AACtC;;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,6BAA6B,KAAK;CAC5C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/gb/vat.d.ts

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

package/dist/gb/vat.js

@@ -1,19 +1,9 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 //#region src/gb/vat.ts
-/**
-* VAT (Value Added Tax registration number).
-*
-* UK VAT number. Multiple formats: 9 or 12
-* digit standard, GD+3 (government), HA+3
-* (health authority). Standard numbers use a
-* weighted checksum mod 97.
-*
-* @see https://www.gov.uk/vat-registration
-*/
 const WEIGHTS = [
 	8,
 	7,
@@ -87,6 +77,7 @@ const vat = {
 	abbreviation: "VAT",
 	aliases: ["VAT registration number", "VAT number"],
 	candidatePattern: "GB\\d{9,12}",
+	scope: "country",
 	country: "GB",
 	entityType: "company",
 	sourceUrl: "https://www.gov.uk/vat-registration",

package/dist/gb/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/gb/vat.ts"],"sourcesContent":["/**\n * VAT (Value Added Tax registration number).\n *\n * UK VAT number. Multiple formats: 9 or 12\n * digit standard, GD+3 (government), HA+3\n * (health authority). Standard numbers use a\n * weighted checksum mod 97.\n *\n * @see https://www.gov.uk/vat-registration\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\");\n  if (v.startsWith(\"GB\") || v.startsWith(\"gb\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validateStandard = (v: string): ValidateResult => {\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK VAT must contain only digits\",\n    );\n  }\n  // Weighted sum of first 7 digits\n  const sum = weightedSum(v.slice(0, 7), WEIGHTS, 97);\n  // Check digits are digits 8-9\n  const checkPart = Number(v.slice(7, 9));\n  const total = (sum + checkPart) % 97;\n\n  const prefix = Number(v.slice(0, 3));\n  if (prefix >= 100) {\n    // Numbers >= 100 000 000: remainder must be\n    // 0, 42, or 55\n    if (total !== 0 && total !== 42 && total !== 55) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"UK VAT check digits mismatch\",\n      );\n    }\n  } else {\n    if (total !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"UK VAT check digits mismatch\",\n      );\n    }\n  }\n  return { valid: true, compact: v };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  // Government departments: GD + 3 digits (< 500)\n  if (v.startsWith(\"GD\")) {\n    const num = v.slice(2);\n    if (num.length !== 3 || !isdigits(num)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"UK VAT GD number must be GD + 3 digits\",\n      );\n    }\n    if (Number(num) >= 500) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"UK VAT GD number must be < 500\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // Health authorities: HA + 3 digits (>= 500)\n  if (v.startsWith(\"HA\")) {\n    const num = v.slice(2);\n    if (num.length !== 3 || !isdigits(num)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"UK VAT HA number must be HA + 3 digits\",\n      );\n    }\n    if (Number(num) < 500) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"UK VAT HA number must be >= 500\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // Standard: 9 or 12 digits\n  if (v.length !== 9 && v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"UK VAT must be 9 or 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK VAT must contain only digits\",\n    );\n  }\n  const result = validateStandard(v.slice(0, 9));\n  if (!result.valid) return result;\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.startsWith(\"GD\") || v.startsWith(\"HA\")) {\n    return `GB${v}`;\n  }\n  return `GB ${v.slice(0, 3)} ${v.slice(3, 7)} ${v.slice(7)}`;\n};\n\n/** Generate a random valid UK VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(9);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** UK VAT Registration Number. */\nconst vat: Validator = {\n  name: \"UK VAT Number\",\n  localName: \"VAT Registration Number\",\n  abbreviation: \"VAT\",\n  aliases: [\n    \"VAT registration number\",\n    \"VAT number\",\n  ] as const,\n  candidatePattern: \"GB\\\\d{9,12}\",\n  country: \"GB\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gov.uk/vat-registration\",\n  examples: [\"980780684\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAErC,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;AAC3B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,oBAAoB,MAA8B;AACtD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;CAMH,MAAM,SAHM,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,SAAS,GAAG,GAEjC,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,IACL;AAGlC,KADe,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,IACtB;MAGR,UAAU,KAAK,UAAU,MAAM,UAAU,GAC3C,QAAO,IACL,oBACA,+BACD;YAGC,UAAU,EACZ,QAAO,IACL,oBACA,+BACD;AAGL,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAGxB,KAAI,EAAE,WAAW,KAAK,EAAE;EACtB,MAAM,MAAM,EAAE,MAAM,EAAE;AACtB,MAAI,IAAI,WAAW,KAAK,CAAC,SAAS,IAAI,CACpC,QAAO,IACL,kBACA,yCACD;AAEH,MAAI,OAAO,IAAI,IAAI,IACjB,QAAO,IACL,qBACA,iCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,KAAI,EAAE,WAAW,KAAK,EAAE;EACtB,MAAM,MAAM,EAAE,MAAM,EAAE;AACtB,MAAI,IAAI,WAAW,KAAK,CAAC,SAAS,IAAI,CACpC,QAAO,IACL,kBACA,yCACD;AAEH,MAAI,OAAO,IAAI,GAAG,IAChB,QAAO,IACL,qBACA,kCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;CAEH,MAAM,SAAS,iBAAiB,EAAE,MAAM,GAAG,EAAE,CAAC;AAC9C,KAAI,CAAC,OAAO,MAAO,QAAO;AAC1B,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,QAAO,KAAK;AAEd,QAAO,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAI3D,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,2BACA,aACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/gb/vat.ts"],"sourcesContent":["/**\n * VAT (Value Added Tax registration number).\n *\n * UK VAT number. Multiple formats: 9 or 12\n * digit standard, GD+3 (government), HA+3\n * (health authority). Standard numbers use a\n * weighted checksum mod 97.\n *\n * @see https://www.gov.uk/vat-registration\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -.\");\n  if (v.startsWith(\"GB\") || v.startsWith(\"gb\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validateStandard = (v: string): ValidateResult => {\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK VAT must contain only digits\",\n    );\n  }\n  // Weighted sum of first 7 digits\n  const sum = weightedSum(v.slice(0, 7), WEIGHTS, 97);\n  // Check digits are digits 8-9\n  const checkPart = Number(v.slice(7, 9));\n  const total = (sum + checkPart) % 97;\n\n  const prefix = Number(v.slice(0, 3));\n  if (prefix >= 100) {\n    // Numbers >= 100 000 000: remainder must be\n    // 0, 42, or 55\n    if (total !== 0 && total !== 42 && total !== 55) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"UK VAT check digits mismatch\",\n      );\n    }\n  } else {\n    if (total !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"UK VAT check digits mismatch\",\n      );\n    }\n  }\n  return { valid: true, compact: v };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  // Government departments: GD + 3 digits (< 500)\n  if (v.startsWith(\"GD\")) {\n    const num = v.slice(2);\n    if (num.length !== 3 || !isdigits(num)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"UK VAT GD number must be GD + 3 digits\",\n      );\n    }\n    if (Number(num) >= 500) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"UK VAT GD number must be < 500\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // Health authorities: HA + 3 digits (>= 500)\n  if (v.startsWith(\"HA\")) {\n    const num = v.slice(2);\n    if (num.length !== 3 || !isdigits(num)) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"UK VAT HA number must be HA + 3 digits\",\n      );\n    }\n    if (Number(num) < 500) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"UK VAT HA number must be >= 500\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // Standard: 9 or 12 digits\n  if (v.length !== 9 && v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"UK VAT must be 9 or 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UK VAT must contain only digits\",\n    );\n  }\n  const result = validateStandard(v.slice(0, 9));\n  if (!result.valid) return result;\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.startsWith(\"GD\") || v.startsWith(\"HA\")) {\n    return `GB${v}`;\n  }\n  return `GB ${v.slice(0, 3)} ${v.slice(3, 7)} ${v.slice(7)}`;\n};\n\n/** Generate a random valid UK VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(9);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** UK VAT Registration Number. */\nconst vat: CountryValidator<\"GB\"> = {\n  name: \"UK VAT Number\",\n  localName: \"VAT Registration Number\",\n  abbreviation: \"VAT\",\n  aliases: [\n    \"VAT registration number\",\n    \"VAT number\",\n  ] as const,\n  candidatePattern: \"GB\\\\d{9,12}\",\n  scope: \"country\",\n  country: \"GB\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gov.uk/vat-registration\",\n  examples: [\"980780684\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAsBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAEpC,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK;CAC1B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EAAE,YAAY;AACvB;AAEA,MAAM,oBAAoB,MAA8B;CACtD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,iCACF;CAMF,MAAM,SAHM,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,EAG/B,IADC,OAAO,EAAE,MAAM,GAAG,CAAC,CACR,KAAK;CAGlC,IADe,OAAO,EAAE,MAAM,GAAG,CAAC,CACzB,KAAK;MAGR,UAAU,KAAK,UAAU,MAAM,UAAU,IAC3C,OAAO,IACL,oBACA,8BACF;CAAA,OAGF,IAAI,UAAU,GACZ,OAAO,IACL,oBACA,8BACF;CAGJ,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAGvB,IAAI,EAAE,WAAW,IAAI,GAAG;EACtB,MAAM,MAAM,EAAE,MAAM,CAAC;EACrB,IAAI,IAAI,WAAW,KAAK,CAAC,SAAS,GAAG,GACnC,OAAO,IACL,kBACA,wCACF;EAEF,IAAI,OAAO,GAAG,KAAK,KACjB,OAAO,IACL,qBACA,gCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAGA,IAAI,EAAE,WAAW,IAAI,GAAG;EACtB,MAAM,MAAM,EAAE,MAAM,CAAC;EACrB,IAAI,IAAI,WAAW,KAAK,CAAC,SAAS,GAAG,GACnC,OAAO,IACL,kBACA,wCACF;EAEF,IAAI,OAAO,GAAG,IAAI,KAChB,OAAO,IACL,qBACA,iCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAGA,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,IACjC,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,iCACF;CAEF,MAAM,SAAS,iBAAiB,EAAE,MAAM,GAAG,CAAC,CAAC;CAC7C,IAAI,CAAC,OAAO,OAAO,OAAO;CAC1B,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,OAAO,KAAK;CAEd,OAAO,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AAC1D;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,CAAC;EACxB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,2BACA,YACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/ge/mod.d.ts

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

package/dist/ge/pin.d.ts

@@ -1,13 +1,25 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ge/pin.d.ts
 /** Generate a random valid Georgian PIN (11-digit). */
 declare const generate: () => string;
+/**
+ * PIN (Personal Identification Number, პირადი ნომერი).
+ *
+ * Georgian personal identification number issued by the
+ * Public Service Development Agency. Citizens receive an
+ * 11-digit number (also used as TIN); non-citizens and
+ * entities receive a 9-digit number. The number is a
+ * serial with no embedded semantics and no publicly
+ * documented checksum algorithm.
+ *
+ * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Georgia-TIN.pdf
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Georgian Personal Identification Number. */
-declare const pin: Validator;
+declare const pin: CountryValidator<"GE">;
 //#endregion
 export { compact, pin as default, format, generate, validate };
 //# sourceMappingURL=pin.d.ts.map

package/dist/ge/pin.js

@@ -3,18 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ge/pin.ts
-/**
-* PIN (Personal Identification Number, პირადი ნომერი).
-*
-* Georgian personal identification number issued by the
-* Public Service Development Agency. Citizens receive an
-* 11-digit number (also used as TIN); non-citizens and
-* entities receive a 9-digit number. The number is a
-* serial with no embedded semantics and no publicly
-* documented checksum algorithm.
-*
-* @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Georgia-TIN.pdf
-*/
 /** Generate a random valid Georgian PIN (11-digit). */
 const generate = () => randomDigits(11);
 const compact = (value) => clean(value, " -").trim();
@@ -35,6 +23,7 @@ const pin = {
 	abbreviation: "PIN",
 	aliases: ["პირადი ნომერი", "PIN"],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "GE",
 	entityType: "any",
 	lengths: [9, 11],