@stll/stdnum 1.0.0 → 2.0.0

package/dist/is/vsk.js

@@ -3,13 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/is/vsk.ts
-/**
-* VSK (Virðisaukaskattur, Icelandic VAT number).
-*
-* 5 or 6 digits. Format-only validation, no checksum.
-*
-* @see https://www.rsk.is/
-*/
 /** Generate a random valid Icelandic VSK. */
 const generate = () => {
 	return randomDigits(randomInt(5, 6));
@@ -32,6 +25,7 @@ const vsk = {
 	abbreviation: "VSK",
 	aliases: ["VSK-númer", "virðisaukaskattur"],
 	candidatePattern: "IS\\d{5,6}",
+	scope: "country",
 	country: "IS",
 	entityType: "company",
 	sourceUrl: "https://www.rsk.is/",

package/dist/is/vsk.js.map

@@ -1 +1 @@
-{"version":3,"file":"vsk.js","names":[],"sources":["../../src/is/vsk.ts"],"sourcesContent":["/** Generate a random valid Icelandic VSK. */\nconst generate = (): string => {\n  const len = randomInt(5, 6);\n  return randomDigits(len);\n};\n\n/**\n * VSK (Virðisaukaskattur, Icelandic VAT number).\n *\n * 5 or 6 digits. Format-only validation, no checksum.\n *\n * @see https://www.rsk.is/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 5 && v.length !== 6) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Icelandic VAT must be 5 or 6 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Icelandic VAT must contain only digits\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Icelandic VAT Number. */\nconst vsk: Validator = {\n  name: \"Icelandic VAT Number\",\n  localName: \"Virðisaukaskattur\",\n  abbreviation: \"VSK\",\n  aliases: [\"VSK-númer\", \"virðisaukaskattur\"] as const,\n  candidatePattern: \"IS\\\\d{5,6}\",\n  country: \"IS\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.rsk.is/\",\n  examples: [\"00621\", \"123456\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vsk;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;AACA,MAAM,iBAAyB;AAE7B,QAAO,aADK,UAAU,GAAG,EAAE,CACH;;AAkB1B,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,EACjC,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,yCACD;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,aAAa,oBAAoB;CAC3C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,SAAS,SAAS;CAC7B;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vsk.js","names":[],"sources":["../../src/is/vsk.ts"],"sourcesContent":["/** Generate a random valid Icelandic VSK. */\nconst generate = (): string => {\n  const len = randomInt(5, 6);\n  return randomDigits(len);\n};\n\n/**\n * VSK (Virðisaukaskattur, Icelandic VAT number).\n *\n * 5 or 6 digits. Format-only validation, no checksum.\n *\n * @see https://www.rsk.is/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\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 !== 5 && v.length !== 6) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Icelandic VAT must be 5 or 6 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Icelandic VAT must contain only digits\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Icelandic VAT Number. */\nconst vsk: CountryValidator<\"IS\"> = {\n  name: \"Icelandic VAT Number\",\n  localName: \"Virðisaukaskattur\",\n  abbreviation: \"VSK\",\n  aliases: [\"VSK-númer\", \"virðisaukaskattur\"] as const,\n  candidatePattern: \"IS\\\\d{5,6}\",\n  scope: \"country\",\n  country: \"IS\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.rsk.is/\",\n  examples: [\"00621\", \"123456\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vsk;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB;CAE7B,OAAO,aADK,UAAU,GAAG,CACH,CAAC;AACzB;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,OAAO,IACL,kBACA,qCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,wCACF;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,aAAa,mBAAmB;CAC1C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,SAAS,QAAQ;CAC5B;CACA;CACA;CACA;AACF"}

package/dist/isin.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "./types.js";
+import { GlobalValidator, ValidateResult } from "./types.js";
 
 //#region src/isin.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid ISIN. */
 declare const generate: () => string;
 /** International Securities Identification Number. */
-declare const isin: Validator;
+declare const isin: GlobalValidator;
 //#endregion
 export { compact, isin as default, format, generate, validate };
 //# sourceMappingURL=isin.d.ts.map

package/dist/isin.js

@@ -1,20 +1,9 @@
+import { luhnChecksum } from "./_checksums/luhn.js";
 import { clean } from "./_util/clean.js";
 import { randomInt, randomPick } from "./_util/generate.js";
 import { err } from "./_util/result.js";
-import { luhnChecksum } from "./_checksums/luhn.js";
 import { charValue, isalnum } from "./_util/strings.js";
 //#region src/isin.ts
-/**
-* ISIN (International Securities Identification
-* Number).
-*
-* ISO 6166. 12-character alphanumeric code:
-* [A-Z]{2} (country) + [0-9A-Z]{9} (identifier) +
-* [0-9]{1} (check digit). Validated using the Luhn
-* algorithm on the alpha-numeric expansion.
-*
-* @see https://www.isin.org/
-*/
 const ISIN_RE = /^[A-Z]{2}[0-9A-Z]{9}[0-9]$/;
 const compact = (value) => clean(value, " -").toUpperCase();
 /**
@@ -66,6 +55,7 @@ const generate = () => {
 };
 /** International Securities Identification Number. */
 const isin = {
+	scope: "global",
 	name: "International Securities Identification Number",
 	localName: "International Securities Identification Number",
 	abbreviation: "ISIN",

package/dist/isin.js.map

@@ -1 +1 @@
-{"version":3,"file":"isin.js","names":[],"sources":["../src/isin.ts"],"sourcesContent":["/**\n * ISIN (International Securities Identification\n * Number).\n *\n * ISO 6166. 12-character alphanumeric code:\n * [A-Z]{2} (country) + [0-9A-Z]{9} (identifier) +\n * [0-9]{1} (check digit). Validated using the Luhn\n * algorithm on the alpha-numeric expansion.\n *\n * @see https://www.isin.org/\n */\n\nimport { luhnChecksum } from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomInt, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { charValue, isalnum } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"./types\";\n\nconst ISIN_RE = /^[A-Z]{2}[0-9A-Z]{9}[0-9]$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\n/**\n * Expand each character to its numeric value\n * (A=10..Z=35, digits unchanged) and concatenate.\n */\nconst expand = (value: string): string => {\n  let result = \"\";\n  for (let i = 0; i < value.length; i++) {\n    const ch = value[i];\n    if (ch !== undefined) {\n      result += String(charValue(ch));\n    }\n  }\n  return result;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"ISIN must be exactly 12 characters\",\n    );\n  }\n  if (!isalnum(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ISIN must contain only letters and digits\",\n    );\n  }\n  if (!ISIN_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ISIN must match [A-Z]{2}[0-9A-Z]{9}[0-9]\",\n    );\n  }\n  const expanded = expand(v);\n  if (luhnChecksum(expanded) !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"ISIN check digit is incorrect\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 2)} ${v.slice(2, 6)} ${v.slice(6, 10)} ${v.slice(10)}`;\n};\n\nconst ISIN_COUNTRIES = [\n  \"US\",\n  \"GB\",\n  \"DE\",\n  \"FR\",\n  \"JP\",\n] as const;\n\n/** Generate a random valid ISIN. */\nconst generate = (): string => {\n  for (;;) {\n    const cc = randomPick(ISIN_COUNTRIES);\n    let nsin = \"\";\n    for (let i = 0; i < 9; i++)\n      nsin += String(randomInt(0, 9));\n    const base = cc + nsin;\n    for (let d = 0; d <= 9; d++) {\n      const c = base + String(d);\n      if (validate(c).valid) return c;\n    }\n  }\n};\n\n/** International Securities Identification Number. */\nconst isin: Validator = {\n  name: \"International Securities Identification Number\",\n  localName:\n    \"International Securities Identification Number\",\n  abbreviation: \"ISIN\",\n  aliases: [\n    \"ISIN\",\n    \"International Securities Identification Number\",\n  ] as const,\n  candidatePattern: \"[A-Z]{2}[A-Z0-9]{9}\\\\d\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.isin.org/\",\n  examples: [\"US0378331005\", \"GB0002634946\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default isin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,UAAU;AAEhB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;;;;;AAMlC,MAAM,UAAU,UAA0B;CACxC,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,KAAK,MAAM;AACjB,MAAI,OAAO,KAAA,EACT,WAAU,OAAO,UAAU,GAAG,CAAC;;AAGnC,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,qCACD;AAEH,KAAI,CAAC,QAAQ,EAAE,CACb,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,CAAC,QAAQ,KAAK,EAAE,CAClB,QAAO,IACL,kBACA,2CACD;AAGH,KAAI,aADa,OAAO,EAAE,CACA,KAAK,EAC7B,QAAO,IACL,oBACA,gCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;AAG3E,MAAM,iBAAiB;CACrB;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,KAAK,WAAW,eAAe;EACrC,IAAI,OAAO;AACX,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,SAAQ,OAAO,UAAU,GAAG,EAAE,CAAC;EACjC,MAAM,OAAO,KAAK;AAClB,OAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;GAC3B,MAAM,IAAI,OAAO,OAAO,EAAE;AAC1B,OAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;;AAMpC,MAAM,OAAkB;CACtB,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CACP,QACA,iDACD;CACD,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"isin.js","names":[],"sources":["../src/isin.ts"],"sourcesContent":["/**\n * ISIN (International Securities Identification\n * Number).\n *\n * ISO 6166. 12-character alphanumeric code:\n * [A-Z]{2} (country) + [0-9A-Z]{9} (identifier) +\n * [0-9]{1} (check digit). Validated using the Luhn\n * algorithm on the alpha-numeric expansion.\n *\n * @see https://www.isin.org/\n */\n\nimport type {\n  ValidateResult,\n  GlobalValidator,\n} from \"./types\";\n\nimport { luhnChecksum } from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomInt, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { charValue, isalnum } from \"#util/strings\";\n\nconst ISIN_RE = /^[A-Z]{2}[0-9A-Z]{9}[0-9]$/;\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\n/**\n * Expand each character to its numeric value\n * (A=10..Z=35, digits unchanged) and concatenate.\n */\nconst expand = (value: string): string => {\n  let result = \"\";\n  for (let i = 0; i < value.length; i++) {\n    const ch = value[i];\n    if (ch !== undefined) {\n      result += String(charValue(ch));\n    }\n  }\n  return result;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"ISIN must be exactly 12 characters\",\n    );\n  }\n  if (!isalnum(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ISIN must contain only letters and digits\",\n    );\n  }\n  if (!ISIN_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"ISIN must match [A-Z]{2}[0-9A-Z]{9}[0-9]\",\n    );\n  }\n  const expanded = expand(v);\n  if (luhnChecksum(expanded) !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"ISIN check digit is incorrect\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 2)} ${v.slice(2, 6)} ${v.slice(6, 10)} ${v.slice(10)}`;\n};\n\nconst ISIN_COUNTRIES = [\n  \"US\",\n  \"GB\",\n  \"DE\",\n  \"FR\",\n  \"JP\",\n] as const;\n\n/** Generate a random valid ISIN. */\nconst generate = (): string => {\n  for (;;) {\n    const cc = randomPick(ISIN_COUNTRIES);\n    let nsin = \"\";\n    for (let i = 0; i < 9; i++)\n      nsin += String(randomInt(0, 9));\n    const base = cc + nsin;\n    for (let d = 0; d <= 9; d++) {\n      const c = base + String(d);\n      if (validate(c).valid) return c;\n    }\n  }\n};\n\n/** International Securities Identification Number. */\nconst isin: GlobalValidator = {\n  scope: \"global\",\n  name: \"International Securities Identification Number\",\n  localName:\n    \"International Securities Identification Number\",\n  abbreviation: \"ISIN\",\n  aliases: [\n    \"ISIN\",\n    \"International Securities Identification Number\",\n  ] as const,\n  candidatePattern: \"[A-Z]{2}[A-Z0-9]{9}\\\\d\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.isin.org/\",\n  examples: [\"US0378331005\", \"GB0002634946\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default isin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAuBA,MAAM,UAAU;AAEhB,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,YAAY;;;;;AAMjC,MAAM,UAAU,UAA0B;CACxC,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,KAAK,MAAM;EACjB,IAAI,OAAO,KAAA,GACT,UAAU,OAAO,UAAU,EAAE,CAAC;CAElC;CACA,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,oCACF;CAEF,IAAI,CAAC,QAAQ,CAAC,GACZ,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,CAAC,QAAQ,KAAK,CAAC,GACjB,OAAO,IACL,kBACA,0CACF;CAGF,IAAI,aADa,OAAO,CACA,CAAC,MAAM,GAC7B,OAAO,IACL,oBACA,+BACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AAC1E;AAEA,MAAM,iBAAiB;CACrB;CACA;CACA;CACA;CACA;AACF;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,KAAK,WAAW,cAAc;EACpC,IAAI,OAAO;EACX,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,QAAQ,OAAO,UAAU,GAAG,CAAC,CAAC;EAChC,MAAM,OAAO,KAAK;EAClB,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,KAAK;GAC3B,MAAM,IAAI,OAAO,OAAO,CAAC;GACzB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;EAChC;CACF;AACF;;AAGA,MAAM,OAAwB;CAC5B,OAAO;CACP,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CACP,QACA,gDACF;CACA,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,gBAAgB,cAAc;CACzC;CACA;CACA;CACA;AACF"}

package/dist/it/codicefiscale.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/it/codicefiscale.d.ts
 declare const compact: (value: string) => string;
@@ -13,7 +13,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid 16-character Codice Fiscale. */
 declare const generate: () => string;
 /** Italian Tax Code. */
-declare const codiceFiscale: Validator<ParsedPersonId>;
+declare const codiceFiscale: CountryValidator<"IT", ParsedPersonId>;
 //#endregion
 export { compact, codiceFiscale as default, format, generate, parse, validate };
 //# sourceMappingURL=codicefiscale.d.ts.map

package/dist/it/codicefiscale.js

@@ -4,27 +4,6 @@ import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 import { validate as validate$1 } from "./iva.js";
 //#region src/it/codicefiscale.ts
-/**
-* Codice Fiscale (Italian tax code).
-*
-* 16-character alphanumeric code encoding name,
-* birth date, gender, and birthplace. The last
-* character is a check letter computed using
-* odd/even position value tables.
-*
-* Supports omocodia: when two people share the
-* same code, the tax office replaces digit
-* positions with letters from the set LMNPQRSTUV
-* (L=0, M=1, N=2, P=3, Q=4, R=5, S=6, T=7,
-* U=8, V=9). Only these 10 letters are valid
-* substitutes at digit positions.
-*
-* Also accepts 11-digit numbers (delegates to
-* Partita IVA validation).
-*
-* @see https://www.agenziaentrate.gov.it/
-* @see https://it.wikipedia.org/wiki/Codice_fiscale#Omocodia
-*/
 const ODD = {
 	"0": 1,
 	"1": 0,
@@ -220,6 +199,7 @@ const codiceFiscale = {
 		"fiscal code"
 	],
 	candidatePattern: "[A-Z]{6}\\d{2}[A-Z]\\d{2}[A-Z]\\d{3}[A-Z]",
+	scope: "country",
 	country: "IT",
 	entityType: "person",
 	description: "Personal/company tax code (16-char personal, 11-digit company)",

package/dist/it/codicefiscale.js.map

@@ -1 +1 @@
-{"version":3,"file":"codicefiscale.js","names":["validateIva"],"sources":["../../src/it/codicefiscale.ts"],"sourcesContent":["/**\n * Codice Fiscale (Italian tax code).\n *\n * 16-character alphanumeric code encoding name,\n * birth date, gender, and birthplace. The last\n * character is a check letter computed using\n * odd/even position value tables.\n *\n * Supports omocodia: when two people share the\n * same code, the tax office replaces digit\n * positions with letters from the set LMNPQRSTUV\n * (L=0, M=1, N=2, P=3, Q=4, R=5, S=6, T=7,\n * U=8, V=9). Only these 10 letters are valid\n * substitutes at digit positions.\n *\n * Also accepts 11-digit numbers (delegates to\n * Partita IVA validation).\n *\n * @see https://www.agenziaentrate.gov.it/\n * @see https://it.wikipedia.org/wiki/Codice_fiscale#Omocodia\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 {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\nimport { validate as validateIva } from \"./iva\";\n\n// Values for odd-positioned characters (0-based\n// index 0, 2, 4, ...)\nconst ODD: Record<string, number> = {\n  \"0\": 1,\n  \"1\": 0,\n  \"2\": 5,\n  \"3\": 7,\n  \"4\": 9,\n  \"5\": 13,\n  \"6\": 15,\n  \"7\": 17,\n  \"8\": 19,\n  \"9\": 21,\n  A: 1,\n  B: 0,\n  C: 5,\n  D: 7,\n  E: 9,\n  F: 13,\n  G: 15,\n  H: 17,\n  I: 19,\n  J: 21,\n  K: 2,\n  L: 4,\n  M: 18,\n  N: 20,\n  O: 11,\n  P: 3,\n  Q: 6,\n  R: 8,\n  S: 12,\n  T: 14,\n  U: 16,\n  V: 10,\n  W: 22,\n  X: 25,\n  Y: 24,\n  Z: 23,\n};\n\n// Values for even-positioned characters (0-based\n// index 1, 3, 5, ...)\nconst EVEN: Record<string, number> = {\n  \"0\": 0,\n  \"1\": 1,\n  \"2\": 2,\n  \"3\": 3,\n  \"4\": 4,\n  \"5\": 5,\n  \"6\": 6,\n  \"7\": 7,\n  \"8\": 8,\n  \"9\": 9,\n  A: 0,\n  B: 1,\n  C: 2,\n  D: 3,\n  E: 4,\n  F: 5,\n  G: 6,\n  H: 7,\n  I: 8,\n  J: 9,\n  K: 10,\n  L: 11,\n  M: 12,\n  N: 13,\n  O: 14,\n  P: 15,\n  Q: 16,\n  R: 17,\n  S: 18,\n  T: 19,\n  U: 20,\n  V: 21,\n  W: 22,\n  X: 23,\n  Y: 24,\n  Z: 25,\n};\n\nconst CHECK_LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\n/** Omocodia letter-to-digit mapping. */\nconst OMOCODIA: Record<string, string> = {\n  L: \"0\",\n  M: \"1\",\n  N: \"2\",\n  P: \"3\",\n  Q: \"4\",\n  R: \"5\",\n  S: \"6\",\n  T: \"7\",\n  U: \"8\",\n  V: \"9\",\n};\n\n/** Month letter to 1-based month number. */\nconst MONTH_LETTERS: Record<string, number> = {\n  A: 1,\n  B: 2,\n  C: 3,\n  D: 4,\n  E: 5,\n  H: 6,\n  L: 7,\n  M: 8,\n  P: 9,\n  R: 10,\n  S: 11,\n  T: 12,\n};\n\nconst decodeCfDigit = (ch: string): number => {\n  const mapped = OMOCODIA[ch];\n  if (mapped !== undefined) return Number(mapped);\n  return Number(ch);\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  // 11-digit: delegate to Partita IVA\n  if (v.length === 11 && isdigits(v)) {\n    return validateIva(v);\n  }\n\n  if (v.length !== 16) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Codice Fiscale must be 16 characters\",\n    );\n  }\n  // Structural format: 6 letters + 2 alphanumeric\n  // + 1 letter (month) + 2 alphanumeric + 1 letter\n  // (municipality) + 3 alphanumeric + 1 check letter\n  // The \"alphanumeric\" positions accept omocodia\n  // substitution letters (LMNPQRSTUV for 0-9)\n  if (\n    // Omocodia: digits can be replaced with\n    // LMNPQRSTUV only (not arbitrary letters)\n    !/^[A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]$/.test(\n      v,\n    )\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Codice Fiscale format is invalid\",\n    );\n  }\n\n  // Compute check letter\n  let sum = 0;\n  for (let i = 0; i < 15; i++) {\n    const ch = v[i];\n    if (ch === undefined) continue;\n    if (i % 2 === 0) {\n      // Odd position (1-based) = even index\n      const val = ODD[ch];\n      if (val === undefined) {\n        return err(\n          \"INVALID_FORMAT\",\n          \"Codice Fiscale contains invalid char\",\n        );\n      }\n      sum += val;\n    } else {\n      const val = EVEN[ch];\n      if (val === undefined) {\n        return err(\n          \"INVALID_FORMAT\",\n          \"Codice Fiscale contains invalid char\",\n        );\n      }\n      sum += val;\n    }\n  }\n\n  const expected = CHECK_LETTERS[sum % 26];\n  if (expected !== v[15]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Codice Fiscale check letter mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a Codice Fiscale.\n * Returns null if the value is not valid or is an\n * 11-digit Partita IVA (no personal data embedded).\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  if (v.length !== 16) return null;\n\n  const yy =\n    decodeCfDigit(v.charAt(6)) * 10 +\n    decodeCfDigit(v.charAt(7));\n  const month = MONTH_LETTERS[v.charAt(8)];\n  if (month === undefined) return null;\n  let dd =\n    decodeCfDigit(v.charAt(9)) * 10 +\n    decodeCfDigit(v.charAt(10));\n\n  const gender = dd > 40 ? \"female\" : \"male\";\n  if (dd > 40) dd -= 40;\n\n  const currentYear = new Date().getFullYear();\n  let year = 2000 + yy;\n  if (year > currentYear) year -= 100;\n\n  return {\n    birthDate: new Date(year, month - 1, dd),\n    gender,\n  };\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\nconst MONTH_CODES = Object.keys(MONTH_LETTERS);\n\nconst randomLetter = (): string =>\n  LETTERS.charAt(randomInt(0, LETTERS.length - 1));\n\n/** Generate a random valid 16-character Codice Fiscale. */\nconst generate = (): string => {\n  let body = \"\";\n\n  for (let i = 0; i < 6; i++) {\n    body += randomLetter();\n  }\n\n  body += String(randomInt(0, 99)).padStart(2, \"0\");\n  body +=\n    MONTH_CODES[randomInt(0, MONTH_CODES.length - 1)] ??\n    \"A\";\n\n  const day =\n    randomInt(1, 28) + (randomInt(0, 1) === 0 ? 0 : 40);\n  body += String(day).padStart(2, \"0\");\n  body += randomLetter();\n  body += String(randomInt(0, 999)).padStart(3, \"0\");\n\n  let sum = 0;\n  for (let i = 0; i < body.length; i++) {\n    const ch = body[i];\n    if (ch === undefined) continue;\n    sum += i % 2 === 0 ? (ODD[ch] ?? 0) : (EVEN[ch] ?? 0);\n  }\n\n  return `${body}${CHECK_LETTERS.charAt(sum % 26)}`;\n};\n\n/** Italian Tax Code. */\nconst codiceFiscale: Validator<ParsedPersonId> = {\n  name: \"Italian Tax Code\",\n  localName: \"Codice Fiscale\",\n  abbreviation: \"CF\",\n  aliases: [\n    \"codice fiscale\",\n    \"C.F.\",\n    \"CF\",\n    \"cod. fisc.\",\n    \"fiscal code\",\n  ] as const,\n  candidatePattern:\n    \"[A-Z]{6}\\\\d{2}[A-Z]\\\\d{2}[A-Z]\\\\d{3}[A-Z]\",\n  country: \"IT\",\n  entityType: \"person\",\n  description:\n    \"Personal/company tax code (16-char personal, 11-digit company)\",\n  sourceUrl: \"https://www.agenziaentrate.gov.it/\",\n  lengths: [11, 16] as const,\n  examples: [\"RCCMNL83S18D969H\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default codiceFiscale;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAM,MAA8B;CAClC,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAID,MAAM,OAA+B;CACnC,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,gBAAgB;;AAGtB,MAAM,WAAmC;CACvC,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;;AAGD,MAAM,gBAAwC;CAC5C,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,iBAAiB,OAAuB;CAC5C,MAAM,SAAS,SAAS;AACxB,KAAI,WAAW,KAAA,EAAW,QAAO,OAAO,OAAO;AAC/C,QAAO,OAAO,GAAG;;AAGnB,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAGxB,KAAI,EAAE,WAAW,MAAM,SAAS,EAAE,CAChC,QAAOA,WAAY,EAAE;AAGvB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,uCACD;AAOH,KAGE,CAAC,2FAA2F,KAC1F,EACD,CAED,QAAO,IACL,kBACA,mCACD;CAIH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,KAAK,EAAE;AACb,MAAI,OAAO,KAAA,EAAW;AACtB,MAAI,IAAI,MAAM,GAAG;GAEf,MAAM,MAAM,IAAI;AAChB,OAAI,QAAQ,KAAA,EACV,QAAO,IACL,kBACA,uCACD;AAEH,UAAO;SACF;GACL,MAAM,MAAM,KAAK;AACjB,OAAI,QAAQ,KAAA,EACV,QAAO,IACL,kBACA,uCACD;AAEH,UAAO;;;AAKX,KADiB,cAAc,MAAM,QACpB,EAAE,IACjB,QAAO,IACL,oBACA,uCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;;AAOxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;AACjB,KAAI,EAAE,WAAW,GAAI,QAAO;CAE5B,MAAM,KACJ,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,KAC7B,cAAc,EAAE,OAAO,EAAE,CAAC;CAC5B,MAAM,QAAQ,cAAc,EAAE,OAAO,EAAE;AACvC,KAAI,UAAU,KAAA,EAAW,QAAO;CAChC,IAAI,KACF,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,KAC7B,cAAc,EAAE,OAAO,GAAG,CAAC;CAE7B,MAAM,SAAS,KAAK,KAAK,WAAW;AACpC,KAAI,KAAK,GAAI,OAAM;CAEnB,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;CAC5C,IAAI,OAAO,MAAO;AAClB,KAAI,OAAO,YAAa,SAAQ;AAEhC,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,QAAQ,GAAG,GAAG;EACxC;EACD;;AAGH,MAAM,UAAU;AAChB,MAAM,cAAc,OAAO,KAAK,cAAc;AAE9C,MAAM,qBACJ,QAAQ,OAAO,UAAU,GAAG,GAAmB,CAAC;;AAGlD,MAAM,iBAAyB;CAC7B,IAAI,OAAO;AAEX,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,SAAQ,cAAc;AAGxB,SAAQ,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;AACjD,SACE,YAAY,UAAU,GAAG,YAAY,SAAS,EAAE,KAChD;CAEF,MAAM,MACJ,UAAU,GAAG,GAAG,IAAI,UAAU,GAAG,EAAE,KAAK,IAAI,IAAI;AAClD,SAAQ,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI;AACpC,SAAQ,cAAc;AACtB,SAAQ,OAAO,UAAU,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI;CAElD,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,KAAK,KAAK;AAChB,MAAI,OAAO,KAAA,EAAW;AACtB,SAAO,IAAI,MAAM,IAAK,IAAI,OAAO,IAAM,KAAK,OAAO;;AAGrD,QAAO,GAAG,OAAO,cAAc,OAAO,MAAM,GAAG;;;AAIjD,MAAM,gBAA2C;CAC/C,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACD,kBACE;CACF,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,IAAI,GAAG;CACjB,UAAU,CAAC,mBAAmB;CAC9B;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"codicefiscale.js","names":["validateIva"],"sources":["../../src/it/codicefiscale.ts"],"sourcesContent":["/**\n * Codice Fiscale (Italian tax code).\n *\n * 16-character alphanumeric code encoding name,\n * birth date, gender, and birthplace. The last\n * character is a check letter computed using\n * odd/even position value tables.\n *\n * Supports omocodia: when two people share the\n * same code, the tax office replaces digit\n * positions with letters from the set LMNPQRSTUV\n * (L=0, M=1, N=2, P=3, Q=4, R=5, S=6, T=7,\n * U=8, V=9). Only these 10 letters are valid\n * substitutes at digit positions.\n *\n * Also accepts 11-digit numbers (delegates to\n * Partita IVA validation).\n *\n * @see https://www.agenziaentrate.gov.it/\n * @see https://it.wikipedia.org/wiki/Codice_fiscale#Omocodia\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\nimport { validate as validateIva } from \"./iva\";\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n// Values for odd-positioned characters (0-based\n// index 0, 2, 4, ...)\nconst ODD: Record<string, number> = {\n  \"0\": 1,\n  \"1\": 0,\n  \"2\": 5,\n  \"3\": 7,\n  \"4\": 9,\n  \"5\": 13,\n  \"6\": 15,\n  \"7\": 17,\n  \"8\": 19,\n  \"9\": 21,\n  A: 1,\n  B: 0,\n  C: 5,\n  D: 7,\n  E: 9,\n  F: 13,\n  G: 15,\n  H: 17,\n  I: 19,\n  J: 21,\n  K: 2,\n  L: 4,\n  M: 18,\n  N: 20,\n  O: 11,\n  P: 3,\n  Q: 6,\n  R: 8,\n  S: 12,\n  T: 14,\n  U: 16,\n  V: 10,\n  W: 22,\n  X: 25,\n  Y: 24,\n  Z: 23,\n};\n\n// Values for even-positioned characters (0-based\n// index 1, 3, 5, ...)\nconst EVEN: Record<string, number> = {\n  \"0\": 0,\n  \"1\": 1,\n  \"2\": 2,\n  \"3\": 3,\n  \"4\": 4,\n  \"5\": 5,\n  \"6\": 6,\n  \"7\": 7,\n  \"8\": 8,\n  \"9\": 9,\n  A: 0,\n  B: 1,\n  C: 2,\n  D: 3,\n  E: 4,\n  F: 5,\n  G: 6,\n  H: 7,\n  I: 8,\n  J: 9,\n  K: 10,\n  L: 11,\n  M: 12,\n  N: 13,\n  O: 14,\n  P: 15,\n  Q: 16,\n  R: 17,\n  S: 18,\n  T: 19,\n  U: 20,\n  V: 21,\n  W: 22,\n  X: 23,\n  Y: 24,\n  Z: 25,\n};\n\nconst CHECK_LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\n/** Omocodia letter-to-digit mapping. */\nconst OMOCODIA: Record<string, string> = {\n  L: \"0\",\n  M: \"1\",\n  N: \"2\",\n  P: \"3\",\n  Q: \"4\",\n  R: \"5\",\n  S: \"6\",\n  T: \"7\",\n  U: \"8\",\n  V: \"9\",\n};\n\n/** Month letter to 1-based month number. */\nconst MONTH_LETTERS: Record<string, number> = {\n  A: 1,\n  B: 2,\n  C: 3,\n  D: 4,\n  E: 5,\n  H: 6,\n  L: 7,\n  M: 8,\n  P: 9,\n  R: 10,\n  S: 11,\n  T: 12,\n};\n\nconst decodeCfDigit = (ch: string): number => {\n  const mapped = OMOCODIA[ch];\n  if (mapped !== undefined) return Number(mapped);\n  return Number(ch);\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  // 11-digit: delegate to Partita IVA\n  if (v.length === 11 && isdigits(v)) {\n    return validateIva(v);\n  }\n\n  if (v.length !== 16) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Codice Fiscale must be 16 characters\",\n    );\n  }\n  // Structural format: 6 letters + 2 alphanumeric\n  // + 1 letter (month) + 2 alphanumeric + 1 letter\n  // (municipality) + 3 alphanumeric + 1 check letter\n  // The \"alphanumeric\" positions accept omocodia\n  // substitution letters (LMNPQRSTUV for 0-9)\n  if (\n    // Omocodia: digits can be replaced with\n    // LMNPQRSTUV only (not arbitrary letters)\n    !/^[A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]$/.test(\n      v,\n    )\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Codice Fiscale format is invalid\",\n    );\n  }\n\n  // Compute check letter\n  let sum = 0;\n  for (let i = 0; i < 15; i++) {\n    const ch = v[i];\n    if (ch === undefined) continue;\n    if (i % 2 === 0) {\n      // Odd position (1-based) = even index\n      const val = ODD[ch];\n      if (val === undefined) {\n        return err(\n          \"INVALID_FORMAT\",\n          \"Codice Fiscale contains invalid char\",\n        );\n      }\n      sum += val;\n    } else {\n      const val = EVEN[ch];\n      if (val === undefined) {\n        return err(\n          \"INVALID_FORMAT\",\n          \"Codice Fiscale contains invalid char\",\n        );\n      }\n      sum += val;\n    }\n  }\n\n  const expected = CHECK_LETTERS[sum % 26];\n  if (expected !== v[15]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Codice Fiscale check letter mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a Codice Fiscale.\n * Returns null if the value is not valid or is an\n * 11-digit Partita IVA (no personal data embedded).\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  if (v.length !== 16) return null;\n\n  const yy =\n    decodeCfDigit(v.charAt(6)) * 10 +\n    decodeCfDigit(v.charAt(7));\n  const month = MONTH_LETTERS[v.charAt(8)];\n  if (month === undefined) return null;\n  let dd =\n    decodeCfDigit(v.charAt(9)) * 10 +\n    decodeCfDigit(v.charAt(10));\n\n  const gender = dd > 40 ? \"female\" : \"male\";\n  if (dd > 40) dd -= 40;\n\n  const currentYear = new Date().getFullYear();\n  let year = 2000 + yy;\n  if (year > currentYear) year -= 100;\n\n  return {\n    birthDate: new Date(year, month - 1, dd),\n    gender,\n  };\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\nconst MONTH_CODES = Object.keys(MONTH_LETTERS);\n\nconst randomLetter = (): string =>\n  LETTERS.charAt(randomInt(0, LETTERS.length - 1));\n\n/** Generate a random valid 16-character Codice Fiscale. */\nconst generate = (): string => {\n  let body = \"\";\n\n  for (let i = 0; i < 6; i++) {\n    body += randomLetter();\n  }\n\n  body += String(randomInt(0, 99)).padStart(2, \"0\");\n  body +=\n    MONTH_CODES[randomInt(0, MONTH_CODES.length - 1)] ??\n    \"A\";\n\n  const day =\n    randomInt(1, 28) + (randomInt(0, 1) === 0 ? 0 : 40);\n  body += String(day).padStart(2, \"0\");\n  body += randomLetter();\n  body += String(randomInt(0, 999)).padStart(3, \"0\");\n\n  let sum = 0;\n  for (let i = 0; i < body.length; i++) {\n    const ch = body[i];\n    if (ch === undefined) continue;\n    sum += i % 2 === 0 ? (ODD[ch] ?? 0) : (EVEN[ch] ?? 0);\n  }\n\n  return `${body}${CHECK_LETTERS.charAt(sum % 26)}`;\n};\n\n/** Italian Tax Code. */\nconst codiceFiscale: CountryValidator<\n  \"IT\",\n  ParsedPersonId\n> = {\n  name: \"Italian Tax Code\",\n  localName: \"Codice Fiscale\",\n  abbreviation: \"CF\",\n  aliases: [\n    \"codice fiscale\",\n    \"C.F.\",\n    \"CF\",\n    \"cod. fisc.\",\n    \"fiscal code\",\n  ] as const,\n  candidatePattern:\n    \"[A-Z]{6}\\\\d{2}[A-Z]\\\\d{2}[A-Z]\\\\d{3}[A-Z]\",\n  scope: \"country\",\n  country: \"IT\",\n  entityType: \"person\",\n  description:\n    \"Personal/company tax code (16-char personal, 11-digit company)\",\n  sourceUrl: \"https://www.agenziaentrate.gov.it/\",\n  lengths: [11, 16] as const,\n  examples: [\"RCCMNL83S18D969H\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default codiceFiscale;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/it/iva.d.ts

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

package/dist/it/iva.js

@@ -1,17 +1,9 @@
+import { luhnChecksum, luhnValidate } from "../_checksums/luhn.js";
 import { clean } from "../_util/clean.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";
 //#region src/it/iva.ts
-/**
-* Partita IVA (Italian VAT number).
-*
-* 11 digits: 7-digit company ID + 3-digit
-* province code + Luhn check digit.
-*
-* @see https://www.agenziaentrate.gov.it/
-*/
 const VALID_PROVINCES = new Set([
 	...Array.from({ length: 100 }, (_, i) => String(i + 1).padStart(3, "0")),
 	"120",
@@ -56,6 +48,7 @@ const iva = {
 		"VAT IT"
 	],
 	candidatePattern: "IT\\d{11}",
+	scope: "country",
 	country: "IT",
 	entityType: "company",
 	sourceUrl: "https://www.agenziaentrate.gov.it/",

package/dist/it/iva.js.map

@@ -1 +1 @@
-{"version":3,"file":"iva.js","names":[],"sources":["../../src/it/iva.ts"],"sourcesContent":["/**\n * Partita IVA (Italian VAT number).\n *\n * 11 digits: 7-digit company ID + 3-digit\n * province code + Luhn check digit.\n *\n * @see https://www.agenziaentrate.gov.it/\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst VALID_PROVINCES = new Set([\n  ...Array.from({ length: 100 }, (_, i) =>\n    String(i + 1).padStart(3, \"0\"),\n  ),\n  \"120\",\n  \"121\",\n  \"888\",\n  \"999\",\n]);\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -\");\n  if (v.startsWith(\"IT\") || v.startsWith(\"it\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Partita IVA must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Partita IVA must contain only digits\",\n    );\n  }\n  // First 7 digits cannot all be zero\n  if (/^0{7}/.test(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Partita IVA company ID cannot be all zeros\",\n    );\n  }\n  // Province code validation\n  const province = v.slice(7, 10);\n  if (!VALID_PROVINCES.has(province)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Partita IVA province code is invalid\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Partita IVA fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `IT${compact(value)}`;\n\n/** Generate a random valid Italian Partita IVA. */\nconst generate = (): string => {\n  const company = randomDigits(7);\n  const province = String(randomInt(1, 100)).padStart(\n    3,\n    \"0\",\n  );\n  const payload = company + province;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Italian VAT Number. */\nconst iva: Validator = {\n  name: \"Italian VAT Number\",\n  localName: \"Partita IVA\",\n  abbreviation: \"P.IVA\",\n  aliases: [\n    \"partita IVA\",\n    \"P.IVA\",\n    \"P. IVA\",\n    \"VAT IT\",\n  ] as const,\n  candidatePattern: \"IT\\\\d{11}\",\n  country: \"IT\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.agenziaentrate.gov.it/\",\n  examples: [\"00743110157\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default iva;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,kBAAkB,IAAI,IAAI;CAC9B,GAAG,MAAM,KAAK,EAAE,QAAQ,KAAK,GAAG,GAAG,MACjC,OAAO,IAAI,EAAE,CAAC,SAAS,GAAG,IAAI,CAC/B;CACD;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK;AAC1B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,wCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,uCACD;AAGH,KAAI,QAAQ,KAAK,EAAE,CACjB,QAAO,IACL,qBACA,6CACD;CAGH,MAAM,WAAW,EAAE,MAAM,GAAG,GAAG;AAC/B,KAAI,CAAC,gBAAgB,IAAI,SAAS,CAChC,QAAO,IACL,qBACA,uCACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,+BACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAM7B,MAAM,UALU,aAAa,EAAE,GACd,OAAO,UAAU,GAAG,IAAI,CAAC,CAAC,SACzC,GACA,IACD;CAED,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"iva.js","names":[],"sources":["../../src/it/iva.ts"],"sourcesContent":["/**\n * Partita IVA (Italian VAT number).\n *\n * 11 digits: 7-digit company ID + 3-digit\n * province code + Luhn check digit.\n *\n * @see https://www.agenziaentrate.gov.it/\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, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst VALID_PROVINCES = new Set([\n  ...Array.from({ length: 100 }, (_, i) =>\n    String(i + 1).padStart(3, \"0\"),\n  ),\n  \"120\",\n  \"121\",\n  \"888\",\n  \"999\",\n]);\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -\");\n  if (v.startsWith(\"IT\") || v.startsWith(\"it\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Partita IVA must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Partita IVA must contain only digits\",\n    );\n  }\n  // First 7 digits cannot all be zero\n  if (/^0{7}/.test(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Partita IVA company ID cannot be all zeros\",\n    );\n  }\n  // Province code validation\n  const province = v.slice(7, 10);\n  if (!VALID_PROVINCES.has(province)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Partita IVA province code is invalid\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Partita IVA fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `IT${compact(value)}`;\n\n/** Generate a random valid Italian Partita IVA. */\nconst generate = (): string => {\n  const company = randomDigits(7);\n  const province = String(randomInt(1, 100)).padStart(\n    3,\n    \"0\",\n  );\n  const payload = company + province;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** Italian VAT Number. */\nconst iva: CountryValidator<\"IT\"> = {\n  name: \"Italian VAT Number\",\n  localName: \"Partita IVA\",\n  abbreviation: \"P.IVA\",\n  aliases: [\n    \"partita IVA\",\n    \"P.IVA\",\n    \"P. IVA\",\n    \"VAT IT\",\n  ] as const,\n  candidatePattern: \"IT\\\\d{11}\",\n  scope: \"country\",\n  country: \"IT\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.agenziaentrate.gov.it/\",\n  examples: [\"00743110157\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default iva;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AAuBA,MAAM,kBAAkB,IAAI,IAAI;CAC9B,GAAG,MAAM,KAAK,EAAE,QAAQ,IAAI,IAAI,GAAG,MACjC,OAAO,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG,CAC/B;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,IAAI;CACzB,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,uCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,sCACF;CAGF,IAAI,QAAQ,KAAK,CAAC,GAChB,OAAO,IACL,qBACA,4CACF;CAGF,MAAM,WAAW,EAAE,MAAM,GAAG,EAAE;CAC9B,IAAI,CAAC,gBAAgB,IAAI,QAAQ,GAC/B,OAAO,IACL,qBACA,sCACF;CAEF,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,8BACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAM7B,MAAM,UALU,aAAa,CAKP,IAJL,OAAO,UAAU,GAAG,GAAG,CAAC,EAAE,SACzC,GACA,GAE+B;CACjC,MAAM,KAAK,aAAa,UAAU,GAAG;CACrC,OAAO,UAAU,QAAQ,KAAK,MAAM,EAAE;AACxC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/jp/cn.d.ts

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

package/dist/jp/cn.js

@@ -3,15 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/jp/cn.ts
-/**
-* CN (Corporate Number, 法人番号).
-*
-* Japanese Corporate Number. 13 digits with a
-* check digit based on modulus 9. Assigned by the
-* National Tax Agency.
-*
-* @see https://en.wikipedia.org/wiki/Corporate_Number_(Japan)
-*/
 const compact = (value) => clean(value, " -");
 /**
 * Compute the check digit for a 12-digit payload.
@@ -51,6 +42,7 @@ const cn = {
 	abbreviation: "CN",
 	aliases: ["法人番号", "Corporate Number"],
 	candidatePattern: "\\d{13}",
+	scope: "country",
 	country: "JP",
 	entityType: "company",
 	description: "13-digit corporate identifier assigned by the National Tax Agency",

package/dist/jp/cn.js.map

@@ -1 +1 @@
-{"version":3,"file":"cn.js","names":[],"sources":["../../src/jp/cn.ts"],"sourcesContent":["/**\n * CN (Corporate Number, 法人番号).\n *\n * Japanese Corporate Number. 13 digits with a\n * check digit based on modulus 9. Assigned by the\n * National Tax Agency.\n *\n * @see https://en.wikipedia.org/wiki/Corporate_Number_(Japan)\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Compute the check digit for a 12-digit payload.\n * Weights alternate [1,2,1,2,...] from the\n * rightmost digit of the payload.\n */\nconst checkDigit = (payload: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const digit = Number(payload[11 - i]);\n    const weight = i % 2 === 0 ? 1 : 2;\n    sum += digit * weight;\n  }\n  return 9 - (sum % 9);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Corporate Number must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Corporate Number must contain only digits\",\n    );\n  }\n  const expected = checkDigit(v.slice(1));\n  if (expected !== Number(v[0])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Corporate Number check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Corporate Number. */\nconst generate = (): string => {\n  const payload = randomDigits(12);\n  const check = checkDigit(payload);\n  return `${String(check)}${payload}`;\n};\n\n/** Japanese Corporate Number. */\nconst cn: Validator = {\n  name: \"Japanese Corporate Number\",\n  localName: \"法人番号\",\n  abbreviation: \"CN\",\n  aliases: [\"法人番号\", \"Corporate Number\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"JP\",\n  entityType: \"company\",\n  description:\n    \"13-digit corporate identifier assigned by the National Tax Agency\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Corporate_Number_(Japan)\",\n  lengths: [13] as const,\n  examples: [\"5835678256246\", \"2021001052596\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;;;;;AAOpB,MAAM,cAAc,YAA4B;CAC9C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,QAAQ,OAAO,QAAQ,KAAK,GAAG;EACrC,MAAM,SAAS,IAAI,MAAM,IAAI,IAAI;AACjC,SAAO,QAAQ;;AAEjB,QAAO,IAAK,MAAM;;AAGpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6CACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,4CACD;AAGH,KADiB,WAAW,EAAE,MAAM,EAAE,CAAC,KACtB,OAAO,EAAE,GAAG,CAC3B,QAAO,IACL,oBACA,8CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,GAAG;CAChC,MAAM,QAAQ,WAAW,QAAQ;AACjC,QAAO,GAAG,OAAO,MAAM,GAAG;;;AAI5B,MAAM,KAAgB;CACpB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,mBAAmB;CACrC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,iBAAiB,gBAAgB;CAC5C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cn.js","names":[],"sources":["../../src/jp/cn.ts"],"sourcesContent":["/**\n * CN (Corporate Number, 法人番号).\n *\n * Japanese Corporate Number. 13 digits with a\n * check digit based on modulus 9. Assigned by the\n * National Tax Agency.\n *\n * @see https://en.wikipedia.org/wiki/Corporate_Number_(Japan)\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Compute the check digit for a 12-digit payload.\n * Weights alternate [1,2,1,2,...] from the\n * rightmost digit of the payload.\n */\nconst checkDigit = (payload: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const digit = Number(payload[11 - i]);\n    const weight = i % 2 === 0 ? 1 : 2;\n    sum += digit * weight;\n  }\n  return 9 - (sum % 9);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Corporate Number must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Corporate Number must contain only digits\",\n    );\n  }\n  const expected = checkDigit(v.slice(1));\n  if (expected !== Number(v[0])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Corporate Number check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Corporate Number. */\nconst generate = (): string => {\n  const payload = randomDigits(12);\n  const check = checkDigit(payload);\n  return `${String(check)}${payload}`;\n};\n\n/** Japanese Corporate Number. */\nconst cn: CountryValidator<\"JP\"> = {\n  name: \"Japanese Corporate Number\",\n  localName: \"法人番号\",\n  abbreviation: \"CN\",\n  aliases: [\"法人番号\", \"Corporate Number\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  scope: \"country\",\n  country: \"JP\",\n  entityType: \"company\",\n  description:\n    \"13-digit corporate identifier assigned by the National Tax Agency\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Corporate_Number_(Japan)\",\n  lengths: [13] as const,\n  examples: [\"5835678256246\", \"2021001052596\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AAoBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;;;;;;AAOnB,MAAM,cAAc,YAA4B;CAC9C,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,QAAQ,OAAO,QAAQ,KAAK,EAAE;EACpC,MAAM,SAAS,IAAI,MAAM,IAAI,IAAI;EACjC,OAAO,QAAQ;CACjB;CACA,OAAO,IAAK,MAAM;AACpB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4CACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,2CACF;CAGF,IADiB,WAAW,EAAE,MAAM,CAAC,CAC1B,MAAM,OAAO,EAAE,EAAE,GAC1B,OAAO,IACL,oBACA,6CACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,QAAQ,WAAW,OAAO;CAChC,OAAO,GAAG,OAAO,KAAK,IAAI;AAC5B;;AAGA,MAAM,KAA6B;CACjC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,kBAAkB;CACpC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,iBAAiB,eAAe;CAC3C;CACA;CACA;CACA;AACF"}

package/dist/jp/mynumber.d.ts

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

package/dist/jp/mynumber.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/jp/mynumber.ts
-/**
-* My Number (Individual Number, マイナンバー).
-*
-* Japanese Individual Number. 12 digits with a
-* mod 11 check digit. Assigned to every resident
-* of Japan for tax and social security purposes.
-* Contains no encoded personal information.
-*
-* @see https://en.wikipedia.org/wiki/Individual_Number
-*/
 const compact = (value) => clean(value, " -");
 const WEIGHTS = [
 	6,
@@ -69,6 +59,7 @@ const mynumber = {
 		"個人番号"
 	],
 	candidatePattern: "\\d{4}[\\s-]?\\d{4}[\\s-]?\\d{4}",
+	scope: "country",
 	country: "JP",
 	entityType: "person",
 	description: "12-digit personal identifier for tax and social security",

package/dist/jp/mynumber.js.map

@@ -1 +1 @@
-{"version":3,"file":"mynumber.js","names":[],"sources":["../../src/jp/mynumber.ts"],"sourcesContent":["/**\n * My Number (Individual Number, マイナンバー).\n *\n * Japanese Individual Number. 12 digits with a\n * mod 11 check digit. Assigned to every resident\n * of Japan for tax and social security purposes.\n * Contains no encoded personal information.\n *\n * @see https://en.wikipedia.org/wiki/Individual_Number\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst WEIGHTS = [6, 5, 4, 3, 2, 7, 6, 5, 4, 3, 2];\n\n/**\n * Compute the check digit for an 11-digit payload.\n * remainder <= 1 yields 0; otherwise 11 - remainder.\n */\nconst checkDigit = (payload: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 11; i++) {\n    sum += (WEIGHTS[i] ?? 0) * Number(payload.charAt(i));\n  }\n  const remainder = sum % 11;\n  return remainder <= 1 ? 0 : 11 - remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"My Number must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"My Number must contain only digits\",\n    );\n  }\n  const expected = checkDigit(v.slice(0, 11));\n  if (expected !== Number(v[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"My Number check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 12) {\n    return `${v.slice(0, 4)} ${v.slice(4, 8)} ${v.slice(8)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid My Number. */\nconst generate = (): string => {\n  const payload = randomDigits(11);\n  const check = checkDigit(payload);\n  return `${payload}${String(check)}`;\n};\n\n/** Japanese Individual Number (My Number). */\nconst mynumber: Validator = {\n  name: \"Japanese Individual Number\",\n  localName: \"マイナンバー\",\n  abbreviation: \"My Number\",\n  aliases: [\n    \"My Number\",\n    \"マイナンバー\",\n    \"個人番号\",\n  ] as const,\n  candidatePattern: \"\\\\d{4}[\\\\s-]?\\\\d{4}[\\\\s-]?\\\\d{4}\",\n  country: \"JP\",\n  entityType: \"person\",\n  description:\n    \"12-digit personal identifier for tax\" +\n    \" and social security\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Individual_Number\",\n  lengths: [12] as const,\n  examples: [\"123456789018\", \"000000000019\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default mynumber;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;;;;AAMjD,MAAM,cAAc,YAA4B;CAC9C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,QAAQ,MAAM,KAAK,OAAO,QAAQ,OAAO,EAAE,CAAC;CAEtD,MAAM,YAAY,MAAM;AACxB,QAAO,aAAa,IAAI,IAAI,KAAK;;AAGnC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,qCACD;AAGH,KADiB,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,KAC1B,OAAO,EAAE,IAAI,CAC5B,QAAO,IACL,oBACA,uCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;AAExD,QAAO;;;AAIT,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,GAAG;CAChC,MAAM,QAAQ,WAAW,QAAQ;AACjC,QAAO,GAAG,UAAU,OAAO,MAAM;;;AAInC,MAAM,WAAsB;CAC1B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"mynumber.js","names":[],"sources":["../../src/jp/mynumber.ts"],"sourcesContent":["/**\n * My Number (Individual Number, マイナンバー).\n *\n * Japanese Individual Number. 12 digits with a\n * mod 11 check digit. Assigned to every resident\n * of Japan for tax and social security purposes.\n * Contains no encoded personal information.\n *\n * @see https://en.wikipedia.org/wiki/Individual_Number\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst WEIGHTS = [6, 5, 4, 3, 2, 7, 6, 5, 4, 3, 2];\n\n/**\n * Compute the check digit for an 11-digit payload.\n * remainder <= 1 yields 0; otherwise 11 - remainder.\n */\nconst checkDigit = (payload: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 11; i++) {\n    sum += (WEIGHTS[i] ?? 0) * Number(payload.charAt(i));\n  }\n  const remainder = sum % 11;\n  return remainder <= 1 ? 0 : 11 - remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"My Number must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"My Number must contain only digits\",\n    );\n  }\n  const expected = checkDigit(v.slice(0, 11));\n  if (expected !== Number(v[11])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"My Number check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 12) {\n    return `${v.slice(0, 4)} ${v.slice(4, 8)} ${v.slice(8)}`;\n  }\n  return v;\n};\n\n/** Generate a random valid My Number. */\nconst generate = (): string => {\n  const payload = randomDigits(11);\n  const check = checkDigit(payload);\n  return `${payload}${String(check)}`;\n};\n\n/** Japanese Individual Number (My Number). */\nconst mynumber: CountryValidator<\"JP\"> = {\n  name: \"Japanese Individual Number\",\n  localName: \"マイナンバー\",\n  abbreviation: \"My Number\",\n  aliases: [\n    \"My Number\",\n    \"マイナンバー\",\n    \"個人番号\",\n  ] as const,\n  candidatePattern: \"\\\\d{4}[\\\\s-]?\\\\d{4}[\\\\s-]?\\\\d{4}\",\n  scope: \"country\",\n  country: \"JP\",\n  entityType: \"person\",\n  description:\n    \"12-digit personal identifier for tax\" +\n    \" and social security\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Individual_Number\",\n  lengths: [12] as const,\n  examples: [\"123456789018\", \"000000000019\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default mynumber;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AAqBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;;;;AAMhD,MAAM,cAAc,YAA4B;CAC9C,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,QAAQ,QAAQ,MAAM,KAAK,OAAO,QAAQ,OAAO,CAAC,CAAC;CAErD,MAAM,YAAY,MAAM;CACxB,OAAO,aAAa,IAAI,IAAI,KAAK;AACnC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,qCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,oCACF;CAGF,IADiB,WAAW,EAAE,MAAM,GAAG,EAAE,CAC9B,MAAM,OAAO,EAAE,GAAG,GAC3B,OAAO,IACL,oBACA,sCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;CAEvD,OAAO;AACT;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,QAAQ,WAAW,OAAO;CAChC,OAAO,GAAG,UAAU,OAAO,KAAK;AAClC;;AAGA,MAAM,WAAmC;CACvC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,gBAAgB,cAAc;CACzC;CACA;CACA;CACA;AACF"}

package/dist/kr/brn.d.ts

@@ -1,13 +1,22 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/kr/brn.d.ts
 /** Generate a random valid Korean BRN. */
 declare const generate: () => string;
+/**
+ * BRN (Business Registration Number, 사업자등록번호).
+ *
+ * Korean Business Registration Number. 10 digits
+ * formatted as XXX-XX-XXXXX. Validated by component
+ * checks (tax office, business type, serial).
+ *
+ * @see https://en.wikipedia.org/wiki/Business_registration_number_(South_Korea)
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Korean Business Registration Number. */
-declare const brn: Validator;
+declare const brn: CountryValidator<"KR">;
 //#endregion
 export { compact, brn as default, format, generate, validate };
 //# sourceMappingURL=brn.d.ts.map

package/dist/kr/brn.js

@@ -3,15 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/kr/brn.ts
-/**
-* BRN (Business Registration Number, 사업자등록번호).
-*
-* Korean Business Registration Number. 10 digits
-* formatted as XXX-XX-XXXXX. Validated by component
-* checks (tax office, business type, serial).
-*
-* @see https://en.wikipedia.org/wiki/Business_registration_number_(South_Korea)
-*/
 /** Generate a random valid Korean BRN. */
 const generate = () => {
 	const office = String(randomInt(101, 999));
@@ -50,6 +41,7 @@ const brn = {
 	abbreviation: "BRN",
 	aliases: ["사업자등록번호", "BRN"],
 	candidatePattern: "\\d{3}-?\\d{2}-?\\d{5}",
+	scope: "country",
 	country: "KR",
 	entityType: "company",
 	description: "10-digit business identifier issued by the National Tax Service",

package/dist/kr/brn.js.map

@@ -1 +1 @@
-{"version":3,"file":"brn.js","names":[],"sources":["../../src/kr/brn.ts"],"sourcesContent":["/** Generate a random valid Korean BRN. */\nconst generate = (): string => {\n  const office = String(randomInt(101, 999));\n  let bizType: string;\n  do {\n    bizType = randomDigits(2);\n  } while (bizType === \"00\");\n  let serial: string;\n  do {\n    serial = randomDigits(4);\n  } while (serial === \"0000\");\n  const last = randomDigits(1);\n  return `${office}${bizType}${serial}${last}`;\n};\n\n/**\n * BRN (Business Registration Number, 사업자등록번호).\n *\n * Korean Business Registration Number. 10 digits\n * formatted as XXX-XX-XXXXX. Validated by component\n * checks (tax office, business type, serial).\n *\n * @see https://en.wikipedia.org/wiki/Business_registration_number_(South_Korea)\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\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      \"BRN must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"BRN must contain only digits\",\n    );\n  }\n  // Tax office number must be >= 101\n  if (v.slice(0, 3) < \"101\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"BRN tax office code must be >= 101\",\n    );\n  }\n  // Business type must not be 00\n  if (v.slice(3, 5) === \"00\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"BRN business type must not be 00\",\n    );\n  }\n  // Serial part must not be 0000\n  if (v.slice(5, 9) === \"0000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"BRN serial must not be 0000\",\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, 5)}-${v.slice(5)}`;\n};\n\n/** Korean Business Registration Number. */\nconst brn: Validator = {\n  name: \"Korean Business Registration Number\",\n  localName: \"사업자등록번호\",\n  abbreviation: \"BRN\",\n  aliases: [\"사업자등록번호\", \"BRN\"] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{2}-?\\\\d{5}\",\n  country: \"KR\",\n  entityType: \"company\",\n  description:\n    \"10-digit business identifier issued by the National Tax Service\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Business_registration_number_(South_Korea)\",\n  lengths: [10] as const,\n  examples: [\"1168200131\", \"2208162517\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default brn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,SAAS,OAAO,UAAU,KAAK,IAAI,CAAC;CAC1C,IAAI;AACJ;AACE,YAAU,aAAa,EAAE;QAClB,YAAY;CACrB,IAAI;AACJ;AACE,WAAS,aAAa,EAAE;QACjB,WAAW;CACpB,MAAM,OAAO,aAAa,EAAE;AAC5B,QAAO,GAAG,SAAS,UAAU,SAAS;;AAoBxC,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAGH,KAAI,EAAE,MAAM,GAAG,EAAE,GAAG,MAClB,QAAO,IACL,qBACA,qCACD;AAGH,KAAI,EAAE,MAAM,GAAG,EAAE,KAAK,KACpB,QAAO,IACL,qBACA,mCACD;AAGH,KAAI,EAAE,MAAM,GAAG,EAAE,KAAK,OACpB,QAAO,IACL,qBACA,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,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIxD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,WAAW,MAAM;CAC3B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,cAAc,aAAa;CACtC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"brn.js","names":[],"sources":["../../src/kr/brn.ts"],"sourcesContent":["/** Generate a random valid Korean BRN. */\nconst generate = (): string => {\n  const office = String(randomInt(101, 999));\n  let bizType: string;\n  do {\n    bizType = randomDigits(2);\n  } while (bizType === \"00\");\n  let serial: string;\n  do {\n    serial = randomDigits(4);\n  } while (serial === \"0000\");\n  const last = randomDigits(1);\n  return `${office}${bizType}${serial}${last}`;\n};\n\n/**\n * BRN (Business Registration Number, 사업자등록번호).\n *\n * Korean Business Registration Number. 10 digits\n * formatted as XXX-XX-XXXXX. Validated by component\n * checks (tax office, business type, serial).\n *\n * @see https://en.wikipedia.org/wiki/Business_registration_number_(South_Korea)\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\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 !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"BRN must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"BRN must contain only digits\",\n    );\n  }\n  // Tax office number must be >= 101\n  if (v.slice(0, 3) < \"101\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"BRN tax office code must be >= 101\",\n    );\n  }\n  // Business type must not be 00\n  if (v.slice(3, 5) === \"00\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"BRN business type must not be 00\",\n    );\n  }\n  // Serial part must not be 0000\n  if (v.slice(5, 9) === \"0000\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"BRN serial must not be 0000\",\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, 5)}-${v.slice(5)}`;\n};\n\n/** Korean Business Registration Number. */\nconst brn: CountryValidator<\"KR\"> = {\n  name: \"Korean Business Registration Number\",\n  localName: \"사업자등록번호\",\n  abbreviation: \"BRN\",\n  aliases: [\"사업자등록번호\", \"BRN\"] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{2}-?\\\\d{5}\",\n  scope: \"country\",\n  country: \"KR\",\n  entityType: \"company\",\n  description:\n    \"10-digit business identifier issued by the National Tax Service\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Business_registration_number_(South_Korea)\",\n  lengths: [10] as const,\n  examples: [\"1168200131\", \"2208162517\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default brn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB;CAC7B,MAAM,SAAS,OAAO,UAAU,KAAK,GAAG,CAAC;CACzC,IAAI;CACJ;EACE,UAAU,aAAa,CAAC;QACjB,YAAY;CACrB,IAAI;CACJ;EACE,SAAS,aAAa,CAAC;QAChB,WAAW;CACpB,MAAM,OAAO,aAAa,CAAC;CAC3B,OAAO,GAAG,SAAS,UAAU,SAAS;AACxC;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAGF,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,OAClB,OAAO,IACL,qBACA,oCACF;CAGF,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,MACpB,OAAO,IACL,qBACA,kCACF;CAGF,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,QACpB,OAAO,IACL,qBACA,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,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACvD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,WAAW,KAAK;CAC1B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,cAAc,YAAY;CACrC;CACA;CACA;CACA;AACF"}

package/dist/kr/rrn.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/kr/rrn.d.ts
 declare const compact: (value: string) => string;
@@ -17,7 +17,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid Korean RRN. */
 declare const generate: () => string;
 /** Korean Resident Registration Number. */
-declare const rrn: Validator<ParsedPersonId>;
+declare const rrn: CountryValidator<"KR", ParsedPersonId>;
 //#endregion
 export { compact, rrn as default, format, generate, parse, validate };
 //# sourceMappingURL=rrn.d.ts.map

package/dist/kr/rrn.js

@@ -1,19 +1,9 @@
 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 { isdigits } from "../_util/strings.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/kr/rrn.ts
-/**
-* RRN (Resident Registration Number, 주민등록번호).
-*
-* Korean Resident Registration Number. 13 digits
-* formatted as YYMMDD-GPPCCSD. Encodes date of
-* birth, gender/century, place of birth, community
-* center, serial, and a check digit.
-*
-* @see https://en.wikipedia.org/wiki/Resident_registration_number
-*/
 const compact = (value) => clean(value, " -/");
 const CHECK_WEIGHTS = [
 	2,
@@ -126,6 +116,7 @@ const rrn = {
 		"Resident Registration Number"
 	],
 	candidatePattern: "\\d{6}[\\s-]?\\d{7}",
+	scope: "country",
 	country: "KR",
 	entityType: "person",
 	description: "13-digit personal identifier issued to all residents of South Korea",

package/dist/kr/rrn.js.map

@@ -1 +1 @@
-{"version":3,"file":"rrn.js","names":[],"sources":["../../src/kr/rrn.ts"],"sourcesContent":["/**\n * RRN (Resident Registration Number, 주민등록번호).\n *\n * Korean Resident Registration Number. 13 digits\n * formatted as YYMMDD-GPPCCSD. Encodes date of\n * birth, gender/century, place of birth, community\n * center, serial, and a check digit.\n *\n * @see https://en.wikipedia.org/wiki/Resident_registration_number\n */\n\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 {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -/\");\n\nconst CHECK_WEIGHTS = [2, 3, 4, 5, 6, 7, 8, 9, 2, 3, 4, 5];\n\n/**\n * Compute the check digit for the first 12 digits.\n * Formula: (11 - sum(w_i * d_i) % 11) % 10.\n */\nconst checkDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum +=\n      (CHECK_WEIGHTS[i] ?? 0) * Number(digits.charAt(i));\n  }\n  return (11 - (sum % 11)) % 10;\n};\n\n/** Century prefix derived from the 7th digit. */\nconst CENTURY_BY_GENDER: Record<string, number> = {\n  \"0\": 1800,\n  \"1\": 1900,\n  \"2\": 1900,\n  \"3\": 2000,\n  \"4\": 2000,\n  \"5\": 1900,\n  \"6\": 1900,\n  \"7\": 2000,\n  \"8\": 2000,\n  \"9\": 1800,\n};\n\n/**\n * Resolve birth date components from a compacted RRN.\n * Returns null if the date is invalid.\n */\nconst resolveBirthDate = (\n  v: string,\n): { year: number; month: number; day: number } | null => {\n  const century = CENTURY_BY_GENDER[v.charAt(6)];\n  if (century === undefined) return null;\n\n  const year = century + Number(v.slice(0, 2));\n  const month = Number(v.slice(2, 4));\n  const day = Number(v.slice(4, 6));\n\n  if (!isValidDate(year, month, day)) return null;\n  return { year, month, day };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RRN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RRN must contain only digits\",\n    );\n  }\n  if (resolveBirthDate(v) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN contains an invalid date of birth\",\n    );\n  }\n  const place = Number(v.slice(7, 9));\n  if (place > 96) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN place-of-birth code must be <= 96\",\n    );\n  }\n  if (checkDigit(v.slice(0, 12)) !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RRN check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 13) {\n    return `${v.slice(0, 6)}-${v.slice(6)}`;\n  }\n  return v;\n};\n\n/**\n * Extract birth date and gender from an RRN.\n * Returns null if the value is not valid.\n *\n * Gender digit mapping:\n *   1, 3 = male Korean; 2, 4 = female Korean\n *   5, 7 = male foreigner; 6, 8 = female foreigner\n *   0, 9 = pre-1800 (male/female by convention)\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const bd = resolveBirthDate(v);\n  if (bd === null) return null;\n\n  const genderDigit = v.charAt(6);\n  const isMale = \"13579\".includes(genderDigit);\n\n  return {\n    birthDate: new Date(bd.year, bd.month - 1, bd.day),\n    gender: isMale ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Korean RRN. */\nconst generate = (): string => {\n  const year = randomInt(1900, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const genderDigit =\n    year >= 2000\n      ? String(randomInt(3, 4))\n      : String(randomInt(1, 2));\n  const place = String(randomInt(0, 96)).padStart(2, \"0\");\n  const body = `${yy}${month}${day}${genderDigit}${place}${randomDigits(3)}`;\n  return `${body}${String(checkDigit(body))}`;\n};\n\n/** Korean Resident Registration Number. */\nconst rrn: Validator<ParsedPersonId> = {\n  name: \"Korean Resident Registration Number\",\n  localName: \"주민등록번호\",\n  abbreviation: \"RRN\",\n  aliases: [\n    \"RRN\",\n    \"주민등록번호\",\n    \"Resident Registration Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[\\\\s-]?\\\\d{7}\",\n  country: \"KR\",\n  entityType: \"person\",\n  description:\n    \"13-digit personal identifier issued to all\" +\n    \" residents of South Korea\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"Resident_registration_number\",\n  lengths: [13] as const,\n  examples: [\"9710139019902\", \"9501011000109\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default rrn;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"rrn.js","names":[],"sources":["../../src/kr/rrn.ts"],"sourcesContent":["/**\n * RRN (Resident Registration Number, 주민등록번호).\n *\n * Korean Resident Registration Number. 13 digits\n * formatted as YYMMDD-GPPCCSD. Encodes date of\n * birth, gender/century, place of birth, community\n * center, serial, and a check digit.\n *\n * @see https://en.wikipedia.org/wiki/Resident_registration_number\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { 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 CHECK_WEIGHTS = [2, 3, 4, 5, 6, 7, 8, 9, 2, 3, 4, 5];\n\n/**\n * Compute the check digit for the first 12 digits.\n * Formula: (11 - sum(w_i * d_i) % 11) % 10.\n */\nconst checkDigit = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum +=\n      (CHECK_WEIGHTS[i] ?? 0) * Number(digits.charAt(i));\n  }\n  return (11 - (sum % 11)) % 10;\n};\n\n/** Century prefix derived from the 7th digit. */\nconst CENTURY_BY_GENDER: Record<string, number> = {\n  \"0\": 1800,\n  \"1\": 1900,\n  \"2\": 1900,\n  \"3\": 2000,\n  \"4\": 2000,\n  \"5\": 1900,\n  \"6\": 1900,\n  \"7\": 2000,\n  \"8\": 2000,\n  \"9\": 1800,\n};\n\n/**\n * Resolve birth date components from a compacted RRN.\n * Returns null if the date is invalid.\n */\nconst resolveBirthDate = (\n  v: string,\n): { year: number; month: number; day: number } | null => {\n  const century = CENTURY_BY_GENDER[v.charAt(6)];\n  if (century === undefined) return null;\n\n  const year = century + Number(v.slice(0, 2));\n  const month = Number(v.slice(2, 4));\n  const day = Number(v.slice(4, 6));\n\n  if (!isValidDate(year, month, day)) return null;\n  return { year, month, day };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RRN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RRN must contain only digits\",\n    );\n  }\n  if (resolveBirthDate(v) === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN contains an invalid date of birth\",\n    );\n  }\n  const place = Number(v.slice(7, 9));\n  if (place > 96) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RRN place-of-birth code must be <= 96\",\n    );\n  }\n  if (checkDigit(v.slice(0, 12)) !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RRN check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 13) {\n    return `${v.slice(0, 6)}-${v.slice(6)}`;\n  }\n  return v;\n};\n\n/**\n * Extract birth date and gender from an RRN.\n * Returns null if the value is not valid.\n *\n * Gender digit mapping:\n *   1, 3 = male Korean; 2, 4 = female Korean\n *   5, 7 = male foreigner; 6, 8 = female foreigner\n *   0, 9 = pre-1800 (male/female by convention)\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const bd = resolveBirthDate(v);\n  if (bd === null) return null;\n\n  const genderDigit = v.charAt(6);\n  const isMale = \"13579\".includes(genderDigit);\n\n  return {\n    birthDate: new Date(bd.year, bd.month - 1, bd.day),\n    gender: isMale ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Korean RRN. */\nconst generate = (): string => {\n  const year = randomInt(1900, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const genderDigit =\n    year >= 2000\n      ? String(randomInt(3, 4))\n      : String(randomInt(1, 2));\n  const place = String(randomInt(0, 96)).padStart(2, \"0\");\n  const body = `${yy}${month}${day}${genderDigit}${place}${randomDigits(3)}`;\n  return `${body}${String(checkDigit(body))}`;\n};\n\n/** Korean Resident Registration Number. */\nconst rrn: CountryValidator<\"KR\", ParsedPersonId> = {\n  name: \"Korean Resident Registration Number\",\n  localName: \"주민등록번호\",\n  abbreviation: \"RRN\",\n  aliases: [\n    \"RRN\",\n    \"주민등록번호\",\n    \"Resident Registration Number\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[\\\\s-]?\\\\d{7}\",\n  scope: \"country\",\n  country: \"KR\",\n  entityType: \"person\",\n  description:\n    \"13-digit personal identifier issued to all\" +\n    \" residents of South Korea\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"Resident_registration_number\",\n  lengths: [13] as const,\n  examples: [\"9710139019902\", \"9501011000109\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default rrn;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/kw/civil.d.ts

@@ -1,4 +1,4 @@
-import { ParsedBirthDate, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedBirthDate, ValidateResult } from "../types.js";
 
 //#region src/kw/civil.d.ts
 declare const compact: (value: string) => string;
@@ -13,7 +13,7 @@ declare const parse: (value: string) => ParsedBirthDate | null;
 /** Generate a random valid Kuwait civil number. */
 declare const generate: () => string;
 /** Kuwait Civil Number (الرقم المدني). */
-declare const civil: Validator<ParsedBirthDate>;
+declare const civil: CountryValidator<"KW", ParsedBirthDate>;
 //#endregion
 export { compact, civil as default, format, generate, parse, validate };
 //# sourceMappingURL=civil.d.ts.map