@stll/stdnum 1.0.0 → 2.0.0

package/dist/gb/nino.js.map

@@ -1 +1 @@
-{"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 { clean } from \"#util/clean\";\nimport { randomChar, randomDigits } 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  // 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: 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":";;;;;;;;;;;;;;AAAA,MAAM,mBAAmB;AACzB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;;AAGtB,MAAM,iBAAyB;CAC7B,IAAI;CACJ,IAAI;CACJ,IAAI;AACJ,IAAG;AACD,UAAQ,WAAW,iBAAiB;AACpC,WAAS,WAAW,kBAAkB;AACtC,WAAS,QAAQ;UACV,eAAe,IAAI,OAAO;CACnC,MAAM,SAAS,aAAa,EAAE;CAC9B,MAAM,SAAS,WAAW,cAAc;AACxC,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;CAKH,MAAM,QAAQ,EAAE;CAEhB,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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gb/sedol.d.ts
 declare const calcCheckDigit: (number: string) => string;
@@ -8,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

@@ -4,17 +4,6 @@ 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,
@@ -70,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 { randomChar } 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 (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: 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,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,EAAE;EAC3C,MAAM,KAAK,OAAO;AAClB,MAAI,OAAO,KAAA,EAAW;EACtB,MAAM,MAAM,SAAS,QAAQ,GAAG;AAChC,MAAI,MAAM,EACR,OAAM,IAAI,MAAM,4BAA4B,KAAK;AAEnD,SAAO,SAAS;;AAElB,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;AASL,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;AAExD,MAAM,mBAAmB;AACzB,MAAM,cAAc;;AAGpB,MAAM,iBAAyB;CAC7B,IAAI,UAAU,WAAW,iBAAiB;AAC1C,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,YAAW,WAAW,YAAY;AAEpC,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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gb/utr.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gb/vat.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ 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/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],

package/dist/ge/pin.js.map

@@ -1 +1 @@
-{"version":3,"file":"pin.js","names":[],"sources":["../../src/ge/pin.ts"],"sourcesContent":["/** Generate a random valid Georgian PIN (11-digit). */\nconst generate = (): string => randomDigits(11);\n\n/**\n * PIN (Personal Identification Number, პირადი ნომერი).\n *\n * Georgian personal identification number issued by the\n * Public Service Development Agency. Citizens receive an\n * 11-digit number (also used as TIN); non-citizens and\n * entities receive a 9-digit number. The number is a\n * serial with no embedded semantics and no publicly\n * documented checksum algorithm.\n *\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Georgia-TIN.pdf\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, \" -\").trim();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 9 && v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Georgian PIN must be 9 or 11 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Georgian PIN must contain only digits\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Georgian Personal Identification Number. */\nconst pin: Validator = {\n  name: \"Georgian Personal ID\",\n  localName: \"პირადი ნომერი\",\n  abbreviation: \"PIN\",\n  aliases: [\"პირადი ნომერი\", \"PIN\"] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"GE\",\n  entityType: \"any\",\n  lengths: [9, 11] as const,\n  examples: [\"010043120\", \"01024030303\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl:\n    \"https://www.oecd.org/tax/automatic-exchange/\" +\n    \"crs-implementation-and-assistance/\" +\n    \"tax-identification-numbers/Georgia-TIN.pdf\",\n  generate,\n};\n\nexport default pin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB,aAAa,GAAG;AAsB/C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;AAE3B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,QAAO,IACL,kBACA,sCACD;AAGH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,wCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,iBAAiB,MAAM;CACjC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG,GAAG;CAChB,UAAU,CAAC,aAAa,cAAc;CACtC;CACA;CACA;CACA,WACE;CAGF;CACD"}
+{"version":3,"file":"pin.js","names":[],"sources":["../../src/ge/pin.ts"],"sourcesContent":["/** Generate a random valid Georgian PIN (11-digit). */\nconst generate = (): string => randomDigits(11);\n\n/**\n * PIN (Personal Identification Number, პირადი ნომერი).\n *\n * Georgian personal identification number issued by the\n * Public Service Development Agency. Citizens receive an\n * 11-digit number (also used as TIN); non-citizens and\n * entities receive a 9-digit number. The number is a\n * serial with no embedded semantics and no publicly\n * documented checksum algorithm.\n *\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Georgia-TIN.pdf\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, \" -\").trim();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 9 && v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Georgian PIN must be 9 or 11 digits\",\n    );\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Georgian PIN must contain only digits\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Georgian Personal Identification Number. */\nconst pin: CountryValidator<\"GE\"> = {\n  name: \"Georgian Personal ID\",\n  localName: \"პირადი ნომერი\",\n  abbreviation: \"PIN\",\n  aliases: [\"პირადი ნომერი\", \"PIN\"] as const,\n  candidatePattern: \"\\\\d{11}\",\n  scope: \"country\",\n  country: \"GE\",\n  entityType: \"any\",\n  lengths: [9, 11] as const,\n  examples: [\"010043120\", \"01024030303\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl:\n    \"https://www.oecd.org/tax/automatic-exchange/\" +\n    \"crs-implementation-and-assistance/\" +\n    \"tax-identification-numbers/Georgia-TIN.pdf\",\n  generate,\n};\n\nexport default pin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB,aAAa,EAAE;AAyB9C,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,KAAK;AAE1B,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,IACjC,OAAO,IACL,kBACA,qCACF;CAGF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,uCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,iBAAiB,KAAK;CAChC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG,EAAE;CACf,UAAU,CAAC,aAAa,aAAa;CACrC;CACA;CACA;CACA,WACE;CAGF;AACF"}

package/dist/gh/tin.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gh/tin.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Ghana TIN. */
 declare const generate: () => string;
 /** Ghanaian Tax Identification Number. */
-declare const tin: Validator;
+declare const tin: CountryValidator<"GH">;
 //#endregion
 export { compact, tin as default, format, generate, validate };
 //# sourceMappingURL=tin.d.ts.map

package/dist/gh/tin.js

@@ -2,21 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/gh/tin.ts
-/**
-* TIN (Tax Identification Number, Ghana).
-*
-* 11-character alphanumeric identifier. Structure:
-*   - Position 1: type prefix (P/C/G/Q/V)
-*   - Positions 2-3: always "00"
-*   - Positions 4-10: digits
-*   - Position 11: check digit (0-9 or X)
-*
-* Prefixes: P = individual, C = company,
-* G = government, Q = foreign mission,
-* V = public institution / trust.
-*
-* @see https://gra.gov.gh/
-*/
 const FORMAT_RE = /^[PCGQV]00[0-9]{7}[0-9X]$/;
 const compact = (value) => clean(value, " ").toUpperCase();
 /**
@@ -63,6 +48,7 @@ const tin = {
 	abbreviation: "TIN",
 	aliases: ["TIN", "Tax Identification Number"],
 	candidatePattern: "[A-Z]\\d{9,10}",
+	scope: "country",
 	country: "GH",
 	entityType: "any",
 	compact,

package/dist/gh/tin.js.map

@@ -1 +1 @@
-{"version":3,"file":"tin.js","names":[],"sources":["../../src/gh/tin.ts"],"sourcesContent":["/**\n * TIN (Tax Identification Number, Ghana).\n *\n * 11-character alphanumeric identifier. Structure:\n *   - Position 1: type prefix (P/C/G/Q/V)\n *   - Positions 2-3: always \"00\"\n *   - Positions 4-10: digits\n *   - Position 11: check digit (0-9 or X)\n *\n * Prefixes: P = individual, C = company,\n * G = government, Q = foreign mission,\n * V = public institution / trust.\n *\n * @see https://gra.gov.gh/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst FORMAT_RE = /^[PCGQV]00[0-9]{7}[0-9X]$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" \").toUpperCase();\n\n/**\n * Calculate the expected check digit.\n * Uses positions 1-9 (0-indexed) with weights 1-9,\n * mod 11. Returns \"X\" when the remainder is 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 1; i <= 9; i++) {\n    sum += i * Number(value[i]);\n  }\n  const check = sum % 11;\n  return check === 10 ? \"X\" : String(check);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Ghanaian TIN must be exactly 11 characters\",\n    );\n  }\n  if (!FORMAT_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Ghanaian TIN must match [PCGQV]00 + \" +\n        \"7 digits + check digit\",\n    );\n  }\n  if (v[10] !== calcCheckDigit(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Ghanaian TIN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst TIN_PREFIXES = [\"P\", \"C\", \"G\", \"Q\", \"V\"] as const;\n\n/** Generate a random valid Ghana TIN. */\nconst generate = (): string => {\n  for (;;) {\n    const p = randomPick(TIN_PREFIXES);\n    const d = randomDigits(9);\n    const partial = p + d;\n    const c = partial + calcCheckDigit(partial);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ghanaian Tax Identification Number. */\nconst tin: Validator = {\n  name: \"Ghanaian Tax Identification Number\",\n  localName: \"Tax Identification Number\",\n  abbreviation: \"TIN\",\n  aliases: [\"TIN\", \"Tax Identification Number\"] as const,\n  candidatePattern: \"[A-Z]\\\\d{9,10}\",\n  country: \"GH\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description: \"Ghanaian tax identification number\",\n  sourceUrl: \"https://gra.gov.gh/\",\n  lengths: [11] as const,\n  examples: [\"C0000803561\"] as const,\n  generate,\n};\n\nexport default tin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,YAAY;AAElB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,CAAC,aAAa;;;;;;AAOjC,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,KAAK,GAAG,IACtB,QAAO,IAAI,OAAO,MAAM,GAAG;CAE7B,MAAM,QAAQ,MAAM;AACpB,QAAO,UAAU,KAAK,MAAM,OAAO,MAAM;;AAG3C,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6CACD;AAEH,KAAI,CAAC,UAAU,KAAK,EAAE,CACpB,QAAO,IACL,kBACA,6DAED;AAEH,KAAI,EAAE,QAAQ,eAAe,EAAE,CAC7B,QAAO,IACL,oBACA,oCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;AAExD,MAAM,eAAe;CAAC;CAAK;CAAK;CAAK;CAAK;CAAI;;AAG9C,MAAM,iBAAyB;AAC7B,UAAS;EAGP,MAAM,UAFI,WAAW,aAAa,GACxB,aAAa,EAAE;EAEzB,MAAM,IAAI,UAAU,eAAe,QAAQ;AAC3C,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,4BAA4B;CAC7C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aAAa;CACb,WAAW;CACX,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,cAAc;CACzB;CACD"}
+{"version":3,"file":"tin.js","names":[],"sources":["../../src/gh/tin.ts"],"sourcesContent":["/**\n * TIN (Tax Identification Number, Ghana).\n *\n * 11-character alphanumeric identifier. Structure:\n *   - Position 1: type prefix (P/C/G/Q/V)\n *   - Positions 2-3: always \"00\"\n *   - Positions 4-10: digits\n *   - Position 11: check digit (0-9 or X)\n *\n * Prefixes: P = individual, C = company,\n * G = government, Q = foreign mission,\n * V = public institution / trust.\n *\n * @see https://gra.gov.gh/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst FORMAT_RE = /^[PCGQV]00[0-9]{7}[0-9X]$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" \").toUpperCase();\n\n/**\n * Calculate the expected check digit.\n * Uses positions 1-9 (0-indexed) with weights 1-9,\n * mod 11. Returns \"X\" when the remainder is 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 1; i <= 9; i++) {\n    sum += i * Number(value[i]);\n  }\n  const check = sum % 11;\n  return check === 10 ? \"X\" : String(check);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Ghanaian TIN must be exactly 11 characters\",\n    );\n  }\n  if (!FORMAT_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Ghanaian TIN must match [PCGQV]00 + \" +\n        \"7 digits + check digit\",\n    );\n  }\n  if (v[10] !== calcCheckDigit(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Ghanaian TIN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst TIN_PREFIXES = [\"P\", \"C\", \"G\", \"Q\", \"V\"] as const;\n\n/** Generate a random valid Ghana TIN. */\nconst generate = (): string => {\n  for (;;) {\n    const p = randomPick(TIN_PREFIXES);\n    const d = randomDigits(9);\n    const partial = p + d;\n    const c = partial + calcCheckDigit(partial);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ghanaian Tax Identification Number. */\nconst tin: CountryValidator<\"GH\"> = {\n  name: \"Ghanaian Tax Identification Number\",\n  localName: \"Tax Identification Number\",\n  abbreviation: \"TIN\",\n  aliases: [\"TIN\", \"Tax Identification Number\"] as const,\n  candidatePattern: \"[A-Z]\\\\d{9,10}\",\n  scope: \"country\",\n  country: \"GH\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description: \"Ghanaian tax identification number\",\n  sourceUrl: \"https://gra.gov.gh/\",\n  lengths: [11] as const,\n  examples: [\"C0000803561\"] as const,\n  generate,\n};\n\nexport default tin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAyBA,MAAM,YAAY;AAElB,MAAM,WAAW,UACf,MAAM,OAAO,GAAG,EAAE,YAAY;;;;;;AAOhC,MAAM,kBAAkB,UAA0B;CAChD,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KACtB,OAAO,IAAI,OAAO,MAAM,EAAE;CAE5B,MAAM,QAAQ,MAAM;CACpB,OAAO,UAAU,KAAK,MAAM,OAAO,KAAK;AAC1C;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4CACF;CAEF,IAAI,CAAC,UAAU,KAAK,CAAC,GACnB,OAAO,IACL,kBACA,4DAEF;CAEF,IAAI,EAAE,QAAQ,eAAe,CAAC,GAC5B,OAAO,IACL,oBACA,mCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;AAEvD,MAAM,eAAe;CAAC;CAAK;CAAK;CAAK;CAAK;AAAG;;AAG7C,MAAM,iBAAyB;CAC7B,SAAS;EAGP,MAAM,UAFI,WAAW,YAEL,IADN,aAAa,CACH;EACpB,MAAM,IAAI,UAAU,eAAe,OAAO;EAC1C,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,2BAA2B;CAC5C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aAAa;CACb,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,aAAa;CACxB;AACF"}

package/dist/gr/amka.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gr/amka.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Greek AMKA. */
 declare const generate: () => string;
 /** Greek Social Security Number. */
-declare const amka: Validator;
+declare const amka: CountryValidator<"GR">;
 //#endregion
 export { compact, amka as default, format, generate, validate };
 //# sourceMappingURL=amka.d.ts.map

package/dist/gr/amka.js

@@ -1,19 +1,10 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { isdigits } from "../_util/strings.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/gr/amka.ts
-/**
-* AMKA (Αριθμός Μητρώου Κοινωνικής Ασφάλισης).
-*
-* Greek social security number. 11 digits where the
-* first 6 are DDMMYY, followed by 4-digit serial and
-* a Luhn check digit.
-*
-* @see https://www.amka.gr/
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -56,6 +47,7 @@ const amka = {
 		"AMKA"
 	],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "GR",
 	entityType: "person",
 	sourceUrl: "https://www.amka.gr/",

package/dist/gr/amka.js.map

@@ -1 +1 @@
-{"version":3,"file":"amka.js","names":[],"sources":["../../src/gr/amka.ts"],"sourcesContent":["/**\n * AMKA (Αριθμός Μητρώου Κοινωνικής Ασφάλισης).\n *\n * Greek social security number. 11 digits where the\n * first 6 are DDMMYY, followed by 4-digit serial and\n * a Luhn check digit.\n *\n * @see https://www.amka.gr/\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"AMKA must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"AMKA must contain only digits\",\n    );\n  }\n\n  const dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n\n  // AMKA doesn't encode century explicitly;\n  // validate the date for both 1900s and 2000s\n  const valid1900 = isValidDate(1900 + yy, mm, dd);\n  const valid2000 = isValidDate(2000 + yy, mm, dd);\n  if (!valid1900 && !valid2000) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"AMKA contains an invalid date\",\n    );\n  }\n\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"AMKA Luhn check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Greek AMKA. */\nconst generate = (): string => {\n  for (;;) {\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const serial = randomDigits(4);\n    const payload = dd + mm + yy + serial;\n    const cs = luhnChecksum(payload + \"0\");\n    const c = payload + String((10 - cs) % 10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Greek Social Security Number. */\nconst amka: Validator = {\n  name: \"Greek Social Security Number\",\n  localName: \"Αριθμός Μητρώου Κοινωνικής Ασφάλισης\",\n  abbreviation: \"ΑΜΚΑ\",\n  aliases: [\n    \"ΑΜΚΑ\",\n    \"Αριθμός Μητρώου Κοινωνικής Ασφάλισης\",\n    \"AMKA\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"GR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.amka.gr/\",\n  examples: [\"01013099997\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default amka;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,gCACD;CAGH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAIhC,MAAM,YAAY,YAAY,OAAO,IAAI,IAAI,GAAG;CAChD,MAAM,YAAY,YAAY,MAAO,IAAI,IAAI,GAAG;AAChD,KAAI,CAAC,aAAa,CAAC,UACjB,QAAO,IACL,qBACA,gCACD;AAGH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,uCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACpD,MAAM,KAAK,OAAO,UAAU,IAAI,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;EACrD,MAAM,SAAS,aAAa,EAAE;EAC9B,MAAM,UAAU,KAAK,KAAK,KAAK;EAC/B,MAAM,KAAK,aAAa,UAAU,IAAI;EACtC,MAAM,IAAI,UAAU,QAAQ,KAAK,MAAM,GAAG;AAC1C,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"amka.js","names":[],"sources":["../../src/gr/amka.ts"],"sourcesContent":["/**\n * AMKA (Αριθμός Μητρώου Κοινωνικής Ασφάλισης).\n *\n * Greek social security number. 11 digits where the\n * first 6 are DDMMYY, followed by 4-digit serial and\n * a Luhn check digit.\n *\n * @see https://www.amka.gr/\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 { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"AMKA must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"AMKA must contain only digits\",\n    );\n  }\n\n  const dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n\n  // AMKA doesn't encode century explicitly;\n  // validate the date for both 1900s and 2000s\n  const valid1900 = isValidDate(1900 + yy, mm, dd);\n  const valid2000 = isValidDate(2000 + yy, mm, dd);\n  if (!valid1900 && !valid2000) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"AMKA contains an invalid date\",\n    );\n  }\n\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"AMKA Luhn check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Greek AMKA. */\nconst generate = (): string => {\n  for (;;) {\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const serial = randomDigits(4);\n    const payload = dd + mm + yy + serial;\n    const cs = luhnChecksum(payload + \"0\");\n    const c = payload + String((10 - cs) % 10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Greek Social Security Number. */\nconst amka: CountryValidator<\"GR\"> = {\n  name: \"Greek Social Security Number\",\n  localName: \"Αριθμός Μητρώου Κοινωνικής Ασφάλισης\",\n  abbreviation: \"ΑΜΚΑ\",\n  aliases: [\n    \"ΑΜΚΑ\",\n    \"Αριθμός Μητρώου Κοινωνικής Ασφάλισης\",\n    \"AMKA\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  scope: \"country\",\n  country: \"GR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.amka.gr/\",\n  examples: [\"01013099997\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default amka;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;AAyBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,+BACF;CAGF,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAI/B,MAAM,YAAY,YAAY,OAAO,IAAI,IAAI,EAAE;CAC/C,MAAM,YAAY,YAAY,MAAO,IAAI,IAAI,EAAE;CAC/C,IAAI,CAAC,aAAa,CAAC,WACjB,OAAO,IACL,qBACA,+BACF;CAGF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,sCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACnD,MAAM,KAAK,OAAO,UAAU,IAAI,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;EACpD,MAAM,SAAS,aAAa,CAAC;EAC7B,MAAM,UAAU,KAAK,KAAK,KAAK;EAC/B,MAAM,KAAK,aAAa,UAAU,GAAG;EACrC,MAAM,IAAI,UAAU,QAAQ,KAAK,MAAM,EAAE;EACzC,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;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,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/gr/vat.d.ts

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

package/dist/gr/vat.js

@@ -3,16 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/gr/vat.ts
-/**
-* ΑΦΜ (Greek VAT number).
-*
-* 9 digits. 8-digit numbers are zero-padded.
-* Iterative checksum: cs = 0; for each d[0..7]:
-* cs = cs*2 + d; check = (cs*2) % 11 % 10 == d[8].
-*
-* @see https://www.vatify.eu/greece-vat-number.html
-* @see https://www.aade.gr/
-*/
 const compact = (value) => {
 	let v = clean(value, " -/.");
 	if (v.startsWith("EL") || v.startsWith("el")) v = v.slice(2);
@@ -51,6 +41,7 @@ const vat = {
 		"AFM"
 	],
 	candidatePattern: "EL\\d{9}",
+	scope: "country",
 	country: "GR",
 	entityType: "any",
 	sourceUrl: "https://www.aade.gr/",

package/dist/gr/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/gr/vat.ts"],"sourcesContent":["/**\n * ΑΦΜ (Greek VAT number).\n *\n * 9 digits. 8-digit numbers are zero-padded.\n * Iterative checksum: cs = 0; for each d[0..7]:\n * cs = cs*2 + d; check = (cs*2) % 11 % 10 == d[8].\n *\n * @see https://www.vatify.eu/greece-vat-number.html\n * @see https://www.aade.gr/\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  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"EL\") || v.startsWith(\"el\")) {\n    v = v.slice(2);\n  }\n  if (v.startsWith(\"GR\") || v.startsWith(\"gr\")) {\n    v = v.slice(2);\n  }\n  // Zero-pad 8-digit numbers\n  if (v.length === 8) {\n    v = `0${v}`;\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Greek VAT number must be 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Greek VAT number must contain only digits\",\n    );\n  }\n  let cs = 0;\n  for (let i = 0; i < 8; i++) {\n    cs = cs * 2 + Number(v[i]);\n  }\n  const check = ((cs * 2) % 11) % 10;\n  if (check !== Number(v[8])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Greek VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `EL${compact(value)}`;\n\n/** Generate a random valid Greek VAT number. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  let cs = 0;\n  for (let i = 0; i < 8; i++)\n    cs = cs * 2 + Number(payload[i]);\n  return payload + String(((cs * 2) % 11) % 10);\n};\n\n/** Greek VAT Number. */\nconst vat: Validator = {\n  name: \"Greek VAT Number\",\n  localName: \"Αριθμός Φορολογικού Μητρώου\",\n  abbreviation: \"ΑΦΜ\",\n  aliases: [\n    \"ΑΦΜ\",\n    \"Αριθμός Φορολογικού Μητρώου\",\n    \"AFM\",\n  ] as const,\n  candidatePattern: \"EL\\\\d{9}\",\n  country: \"GR\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.aade.gr/\",\n  examples: [\"094259216\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAGhB,KAAI,EAAE,WAAW,EACf,KAAI,IAAI;AAEV,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,oCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,4CACD;CAEH,IAAI,KAAK;AACT,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,MAAK,KAAK,IAAI,OAAO,EAAE,GAAG;AAG5B,KADgB,KAAK,IAAK,KAAM,OAClB,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,wCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,IAAI,KAAK;AACT,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,MAAK,KAAK,IAAI,OAAO,QAAQ,GAAG;AAClC,QAAO,UAAU,OAAS,KAAK,IAAK,KAAM,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,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/gr/vat.ts"],"sourcesContent":["/**\n * ΑΦΜ (Greek VAT number).\n *\n * 9 digits. 8-digit numbers are zero-padded.\n * Iterative checksum: cs = 0; for each d[0..7]:\n * cs = cs*2 + d; check = (cs*2) % 11 % 10 == d[8].\n *\n * @see https://www.vatify.eu/greece-vat-number.html\n * @see https://www.aade.gr/\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  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"EL\") || v.startsWith(\"el\")) {\n    v = v.slice(2);\n  }\n  if (v.startsWith(\"GR\") || v.startsWith(\"gr\")) {\n    v = v.slice(2);\n  }\n  // Zero-pad 8-digit numbers\n  if (v.length === 8) {\n    v = `0${v}`;\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Greek VAT number must be 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Greek VAT number must contain only digits\",\n    );\n  }\n  let cs = 0;\n  for (let i = 0; i < 8; i++) {\n    cs = cs * 2 + Number(v[i]);\n  }\n  const check = ((cs * 2) % 11) % 10;\n  if (check !== Number(v[8])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Greek VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `EL${compact(value)}`;\n\n/** Generate a random valid Greek VAT number. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  let cs = 0;\n  for (let i = 0; i < 8; i++)\n    cs = cs * 2 + Number(payload[i]);\n  return payload + String(((cs * 2) % 11) % 10);\n};\n\n/** Greek VAT Number. */\nconst vat: CountryValidator<\"GR\"> = {\n  name: \"Greek VAT Number\",\n  localName: \"Αριθμός Φορολογικού Μητρώου\",\n  abbreviation: \"ΑΦΜ\",\n  aliases: [\n    \"ΑΦΜ\",\n    \"Αριθμός Φορολογικού Μητρώου\",\n    \"AFM\",\n  ] as const,\n  candidatePattern: \"EL\\\\d{9}\",\n  scope: \"country\",\n  country: \"GR\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.aade.gr/\",\n  examples: [\"094259216\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAqBA,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAGf,IAAI,EAAE,WAAW,GACf,IAAI,IAAI;CAEV,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,mCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,KAAK;CACT,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,KAAK,KAAK,IAAI,OAAO,EAAE,EAAE;CAG3B,IADgB,KAAK,IAAK,KAAM,OAClB,OAAO,EAAE,EAAE,GACvB,OAAO,IACL,oBACA,uCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAC9B,IAAI,KAAK;CACT,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,KAAK,KAAK,IAAI,OAAO,QAAQ,EAAE;CACjC,OAAO,UAAU,OAAS,KAAK,IAAK,KAAM,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,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/gt/nit.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/gt/nit.d.ts
 /**
@@ -14,7 +14,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid NIT (7 body digits). */
 declare const generate: () => string;
 /** Guatemala tax identification number. */
-declare const nit: Validator;
+declare const nit: CountryValidator<"GT">;
 //#endregion
 export { compact, nit as default, format, generate, validate };
 //# sourceMappingURL=nit.d.ts.map

package/dist/gt/nit.js

@@ -4,18 +4,6 @@ import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/gt/nit.ts
 /**
-* NIT (Número de Identificación Tributaria,
-* Guatemala tax number).
-*
-* 2–12 characters: body digits followed by a check
-* character. The check character is computed via a
-* weighted sum mod 11; remainder 10 maps to 'K'.
-*
-* Ported from python-stdnum gt.nit module.
-*
-* @see https://portal.sat.gob.gt/portal/
-*/
-/**
 * Compact: strip spaces, hyphens, leading zeros,
 * and uppercase.
 */
@@ -68,6 +56,7 @@ const nit = {
 	abbreviation: "NIT",
 	aliases: ["NIT"],
 	candidatePattern: "\\d{7,8}-?\\d",
+	scope: "country",
 	country: "GT",
 	entityType: "any",
 	description: "Tax identifier issued by Guatemala's SAT",