@stll/stdnum 1.0.0 → 2.0.1

package/dist/cz/dic.js.map

@@ -1 +1 @@
-{"version":3,"file":"dic.js","names":["validateRc"],"sources":["../../src/cz/dic.ts"],"sourcesContent":["/**\n * DIČ (Daňové identifikační číslo).\n *\n * Czech tax identification number / VAT number.\n * Format: \"CZ\" prefix + 8, 9, or 10 digits.\n * - 8 digits: company (same checksum as IČO,\n *   but first digit cannot be 9)\n * - 9 digits starting with 6: special entity\n * - 9-10 digits: individual (birth number)\n *\n * @see https://adisspr.mfcr.cz/dpr/DphReg\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport { validate as validateRc } from \"./rc\";\n\nconst ICO_WEIGHTS = [8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  const v = clean(value, \" -\");\n  if (v.startsWith(\"CZ\") || v.startsWith(\"cz\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst checkLegal = (value: string): boolean => {\n  const sum = weightedSum(\n    value.slice(0, 7),\n    ICO_WEIGHTS,\n    11,\n  );\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return check === Number(value[7]);\n};\n\nconst checkSpecial = (value: string): boolean => {\n  // Skip the leading \"6\"; check digits 1..7\n  const sum = weightedSum(\n    value.slice(1, 8),\n    [8, 7, 6, 5, 4, 3, 2],\n    11,\n  );\n  const check =\n    (((8 - ((((10 - sum) % 11) + 11) % 11)) % 10) + 10) %\n    10;\n  return check === Number(value[8]);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 8 || v.length > 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"DIČ must be 8-10 digits (without CZ prefix)\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"DIČ must contain only digits\",\n    );\n  }\n\n  // 8-digit: legal entity (IČO-like checksum)\n  if (v.length === 8) {\n    if (v[0] === \"9\") {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"8-digit DIČ cannot start with 9\",\n      );\n    }\n    if (!checkLegal(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"DIČ check digit does not match\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 9-digit starting with 6: special entity\n  if (v.length === 9 && v[0] === \"6\") {\n    if (!checkSpecial(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"DIČ special entity check digit mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 9-10 digit: birth number\n  return validateRc(v);\n};\n\nconst format = (value: string): string =>\n  `CZ${compact(value)}`;\n\n/** Generate a random valid 8-digit DIČ. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(6);\n  const sum = weightedSum(payload, ICO_WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return payload + String(check);\n};\n\n/** Czech VAT Number. */\nconst dic: Validator = {\n  name: \"Czech VAT Number\",\n  localName: \"Daňové identifikační číslo\",\n  abbreviation: \"DIČ\",\n  aliases: [\"DIČ\", \"daňové identifikační číslo\"] as const,\n  candidatePattern: \"CZ\\\\d{8,10}\",\n  country: \"CZ\",\n  entityType: \"any\",\n  sourceUrl: \"https://adisspr.mfcr.cz/dpr/DphReg\",\n  examples: [\"25123891\", \"7103192745\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,cAAc;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAEzC,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,KAAK;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,QAAO,EAAE,MAAM,EAAE;AAEnB,QAAO;;AAGT,MAAM,cAAc,UAA2B;CAM7C,MAAM,OAAO,KALD,YACV,MAAM,MAAM,GAAG,EAAE,EACjB,aACA,GACD,IACwB;AAEzB,SADc,QAAQ,IAAI,IAAI,MAAM,QACnB,OAAO,MAAM,GAAG;;AAGnC,MAAM,gBAAgB,UAA2B;AAU/C,UAFK,MAAQ,KAND,YACV,MAAM,MAAM,GAAG,EAAE,EACjB;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAE,EACrB,GACD,IAEwB,KAAM,MAAM,MAAO,KAAM,MAChD,OACe,OAAO,MAAM,GAAG;;AAGnC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,KAAK,EAAE,SAAS,GAC7B,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAIH,KAAI,EAAE,WAAW,GAAG;AAClB,MAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,kCACD;AAEH,MAAI,CAAC,WAAW,EAAE,CAChB,QAAO,IACL,oBACA,iCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,KAAI,EAAE,WAAW,KAAK,EAAE,OAAO,KAAK;AAClC,MAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,0CACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,QAAOA,WAAW,EAAE;;AAGtB,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,EAAE,CAAC,GACb,aAAa,EAAE;CAEvC,MAAM,OAAO,KADD,YAAY,SAAS,aAAa,GAAG,IACxB;CACzB,MAAM,QAAQ,QAAQ,IAAI,IAAI,MAAM;AACpC,QAAO,UAAU,OAAO,MAAM;;;AAIhC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,6BAA6B;CAC9C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY,aAAa;CACpC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"dic.js","names":["validateRc"],"sources":["../../src/cz/dic.ts"],"sourcesContent":["/**\n * DIČ (Daňové identifikační číslo).\n *\n * Czech tax identification number / VAT number.\n * Format: \"CZ\" prefix + 8, 9, or 10 digits.\n * - 8 digits: company (same checksum as IČO,\n *   but first digit cannot be 9)\n * - 9 digits starting with 6: special entity\n * - 9-10 digits: individual (birth number)\n *\n * @see https://adisspr.mfcr.cz/dpr/DphReg\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\nimport { validate as validateRc } from \"./rc\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst ICO_WEIGHTS = [8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  const v = clean(value, \" -\");\n  if (v.startsWith(\"CZ\") || v.startsWith(\"cz\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst checkLegal = (value: string): boolean => {\n  const sum = weightedSum(\n    value.slice(0, 7),\n    ICO_WEIGHTS,\n    11,\n  );\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return check === Number(value[7]);\n};\n\nconst checkSpecial = (value: string): boolean => {\n  // Skip the leading \"6\"; check digits 1..7\n  const sum = weightedSum(\n    value.slice(1, 8),\n    [8, 7, 6, 5, 4, 3, 2],\n    11,\n  );\n  const check =\n    (((8 - ((((10 - sum) % 11) + 11) % 11)) % 10) + 10) %\n    10;\n  return check === Number(value[8]);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 8 || v.length > 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"DIČ must be 8-10 digits (without CZ prefix)\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"DIČ must contain only digits\",\n    );\n  }\n\n  // 8-digit: legal entity (IČO-like checksum)\n  if (v.length === 8) {\n    if (v[0] === \"9\") {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"8-digit DIČ cannot start with 9\",\n      );\n    }\n    if (!checkLegal(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"DIČ check digit does not match\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 9-digit starting with 6: special entity\n  if (v.length === 9 && v[0] === \"6\") {\n    if (!checkSpecial(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"DIČ special entity check digit mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 9-10 digit: birth number\n  return validateRc(v);\n};\n\nconst format = (value: string): string =>\n  `CZ${compact(value)}`;\n\n/** Generate a random valid 8-digit DIČ. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(6);\n  const sum = weightedSum(payload, ICO_WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return payload + String(check);\n};\n\n/** Czech VAT Number. */\nconst dic: CountryValidator<\"CZ\"> = {\n  name: \"Czech VAT Number\",\n  localName: \"Daňové identifikační číslo\",\n  abbreviation: \"DIČ\",\n  aliases: [\"DIČ\", \"daňové identifikační číslo\"] as const,\n  candidatePattern: \"CZ\\\\d{8,10}\",\n  scope: \"country\",\n  country: \"CZ\",\n  entityType: \"any\",\n  sourceUrl: \"https://adisspr.mfcr.cz/dpr/DphReg\",\n  lengths: [8, 9, 10] as const,\n  examples: [\"25123891\", \"7103192745\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;AAyBA,MAAM,cAAc;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAExC,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,IAAI;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,OAAO,EAAE,MAAM,CAAC;CAElB,OAAO;AACT;AAEA,MAAM,cAAc,UAA2B;CAM7C,MAAM,OAAO,KALD,YACV,MAAM,MAAM,GAAG,CAAC,GAChB,aACA,EAEkB,KAAK;CAEzB,QADc,QAAQ,IAAI,IAAI,MAAM,QACnB,OAAO,MAAM,EAAE;AAClC;AAEA,MAAM,gBAAgB,UAA2B;CAU/C,SAFK,MAAQ,KAND,YACV,MAAM,MAAM,GAAG,CAAC,GAChB;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;CAAC,GACpB,EAGkB,KAAK,KAAM,MAAM,MAAO,KAAM,MAChD,OACe,OAAO,MAAM,EAAE;AAClC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,SAAS,KAAK,EAAE,SAAS,IAC7B,OAAO,IACL,kBACA,6CACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAIF,IAAI,EAAE,WAAW,GAAG;EAClB,IAAI,EAAE,OAAO,KACX,OAAO,IACL,qBACA,iCACF;EAEF,IAAI,CAAC,WAAW,CAAC,GACf,OAAO,IACL,oBACA,gCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAGA,IAAI,EAAE,WAAW,KAAK,EAAE,OAAO,KAAK;EAClC,IAAI,CAAC,aAAa,CAAC,GACjB,OAAO,IACL,oBACA,yCACF;EAEF,OAAO;GAAE,OAAO;GAAM,SAAS;EAAE;CACnC;CAGA,OAAOA,WAAW,CAAC;AACrB;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,CAAC,CACf,IAAI,aAAa,CAAC;CAEtC,MAAM,OAAO,KADD,YAAY,SAAS,aAAa,EAC1B,KAAK;CACzB,MAAM,QAAQ,QAAQ,IAAI,IAAI,MAAM;CACpC,OAAO,UAAU,OAAO,KAAK;AAC/B;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,4BAA4B;CAC7C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,SAAS;EAAC;EAAG;EAAG;CAAE;CAClB,UAAU,CAAC,YAAY,YAAY;CACnC;CACA;CACA;CACA;AACF"}

package/dist/cz/ico.d.ts

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

package/dist/cz/ico.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/cz/ico.ts
-/**
-* IČO (Identifikační číslo osoby).
-*
-* Czech company identification number. 8 digits
-* with a weighted checksum. Assigned by the Czech
-* Statistical Office.
-*
-* @see https://www.czso.cz/
-*/
 const WEIGHTS = [
 	8,
 	7,
@@ -53,6 +44,7 @@ const ico = {
 		"identifikační číslo"
 	],
 	candidatePattern: "\\d{8}",
+	scope: "country",
 	country: "CZ",
 	entityType: "company",
 	description: "8-digit company ID assigned by the Czech Statistical Office",

package/dist/cz/ico.js.map

@@ -1 +1 @@
-{"version":3,"file":"ico.js","names":[],"sources":["../../src/cz/ico.ts"],"sourcesContent":["/**\n * IČO (Identifikační číslo osoby).\n *\n * Czech company identification number. 8 digits\n * with a weighted checksum. Assigned by the Czech\n * Statistical Office.\n *\n * @see https://www.czso.cz/\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  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"IČO must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"IČO must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v.slice(0, 7), WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"IČO 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 ICO. */\nconst generate = (): string => {\n  const payload = randomDigits(7);\n  const sum = weightedSum(payload, WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Czech Company Identification Number. */\nconst ico: Validator = {\n  name: \"Czech Company ID\",\n  localName: \"Identifikační číslo osoby\",\n  abbreviation: \"IČO\",\n  aliases: [\"IČO\", \"IČ\", \"identifikační číslo\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"CZ\",\n  entityType: \"company\",\n  description:\n    \"8-digit company ID assigned by the Czech Statistical Office\",\n  sourceUrl: \"https://www.czso.cz/\",\n  lengths: [8] as const,\n  examples: [\"25123891\", \"27074358\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ico;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAErC,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAGH,MAAM,OAAO,KADD,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,SAAS,GAAG,IAC1B;AAEzB,MADc,QAAQ,IAAI,IAAI,MAAM,QACtB,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,iCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAE/B,MAAM,OAAO,KADD,YAAY,SAAS,SAAS,GAAG,IACpB;CACzB,MAAM,QAAQ,QAAQ,IAAI,IAAI,MAAM;AACpC,QAAO,GAAG,UAAU,OAAO,MAAM;;;AAInC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAO;EAAM;EAAsB;CAC7C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,YAAY,WAAW;CAClC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ico.js","names":[],"sources":["../../src/cz/ico.ts"],"sourcesContent":["/**\n * IČO (Identifikační číslo osoby).\n *\n * Czech company identification number. 8 digits\n * with a weighted checksum. Assigned by the Czech\n * Statistical Office.\n *\n * @see https://www.czso.cz/\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  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"IČO must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"IČO must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v.slice(0, 7), WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"IČO 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 ICO. */\nconst generate = (): string => {\n  const payload = randomDigits(7);\n  const sum = weightedSum(payload, WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Czech Company Identification Number. */\nconst ico: CountryValidator<\"CZ\"> = {\n  name: \"Czech Company ID\",\n  localName: \"Identifikační číslo osoby\",\n  abbreviation: \"IČO\",\n  aliases: [\"IČO\", \"IČ\", \"identifikační číslo\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  scope: \"country\",\n  country: \"CZ\",\n  entityType: \"company\",\n  description:\n    \"8-digit company ID assigned by the Czech Statistical Office\",\n  sourceUrl: \"https://www.czso.cz/\",\n  lengths: [8] as const,\n  examples: [\"25123891\", \"27074358\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ico;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;AAqBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAEpC,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,8BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAGF,MAAM,OAAO,KADD,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,EAC5B,KAAK;CAEzB,KADc,QAAQ,IAAI,IAAI,MAAM,QACtB,OAAO,EAAE,EAAE,GACvB,OAAO,IACL,oBACA,gCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAE9B,MAAM,OAAO,KADD,YAAY,SAAS,SAAS,EACtB,KAAK;CACzB,MAAM,QAAQ,QAAQ,IAAI,IAAI,MAAM;CACpC,OAAO,GAAG,UAAU,OAAO,KAAK;AAClC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAO;EAAM;CAAqB;CAC5C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,YAAY,UAAU;CACjC;CACA;CACA;CACA;AACF"}

package/dist/cz/rc.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/cz/rc.d.ts
 declare const compact: (value: string) => string;
@@ -15,7 +15,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
  */
 declare const generate: () => string;
 /** Czech/Slovak Birth Number. */
-declare const rc: Validator<ParsedPersonId>;
+declare const rc: CountryValidator<"CZ", ParsedPersonId>;
 //#endregion
 export { compact, rc as default, format, generate, parse, validate };
 //# sourceMappingURL=rc.d.ts.map

package/dist/cz/rc.js

@@ -1,34 +1,9 @@
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/cz/rc.ts
-/**
-* RČ (Rodné číslo).
-*
-* Czech and Slovak national identifier (birth
-* number). 9 or 10 digits encoding date of birth
-* and gender. 10-digit numbers (post-1954) must
-* be divisible by 11.
-*
-* Women have 50 added to the month. For modern
-* 10-digit numbers, an additional +20 offset may
-* be used when the daily serial range is exhausted
-* (+70 for women).
-*
-* Canonical source:
-* - Czech Ministry of the Interior guidance on rodne
-*   cislo, with the modern overflow-month rules
-*
-* We use this to keep the 9-digit historical form
-* valid while rejecting modern +20/+70 month offsets
-* on 9-digit numbers. Those overflow offsets are a
-* modern rule for 10-digit values.
-*
-* @see https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART
-* @see Law 133/2000 Sb.
-*/
 const compact = (value) => clean(value, " /");
 const decodeMonth = (rawMonth, year, length) => {
 	const candidates = length === 10 && year >= 2004 ? [
@@ -123,6 +98,7 @@ const rc = {
 		"birth number"
 	],
 	candidatePattern: "\\d{6}/\\d{3,4}",
+	scope: "country",
 	country: "CZ",
 	entityType: "person",
 	description: "Czech/Slovak national identifier encoding birth date and gender",

package/dist/cz/rc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rc.js","names":[],"sources":["../../src/cz/rc.ts"],"sourcesContent":["/**\n * RČ (Rodné číslo).\n *\n * Czech and Slovak national identifier (birth\n * number). 9 or 10 digits encoding date of birth\n * and gender. 10-digit numbers (post-1954) must\n * be divisible by 11.\n *\n * Women have 50 added to the month. For modern\n * 10-digit numbers, an additional +20 offset may\n * be used when the daily serial range is exhausted\n * (+70 for women).\n *\n * Canonical source:\n * - Czech Ministry of the Interior guidance on rodne\n *   cislo, with the modern overflow-month rules\n *\n * We use this to keep the 9-digit historical form\n * valid while rejecting modern +20/+70 month offsets\n * on 9-digit numbers. Those overflow offsets are a\n * modern rule for 10-digit values.\n *\n * @see https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART\n * @see Law 133/2000 Sb.\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" /\");\n\nconst decodeMonth = (\n  rawMonth: number,\n  year: number,\n  length: number,\n): number | null => {\n  const candidates =\n    length === 10 && year >= 2004\n      ? [0, 50, 20, 70]\n      : [0, 50];\n  for (const offset of candidates) {\n    const month = rawMonth - offset;\n    if (month >= 1 && month <= 12) {\n      return month;\n    }\n  }\n  return null;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9 && v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Birth number must be 9 or 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Birth number must contain only digits\",\n    );\n  }\n\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  // Resolve full year\n  let year = yy + 1900;\n  if (v.length === 9) {\n    // 9-digit: pre-1954 only\n    if (year >= 1980) year -= 100;\n    if (year > 1953) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"9-digit birth numbers are pre-1954 only\",\n      );\n    }\n  } else {\n    // 10-digit: if year < 1954, it's 2000s\n    if (year < 1954) year += 100;\n  }\n\n  const month = decodeMonth(mm, year, v.length);\n  if (month === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Birth number contains an invalid month\",\n    );\n  }\n\n  if (dd < 1 || dd > 31) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Birth number contains an invalid day\",\n    );\n  }\n\n  // Validate the actual date\n  if (!isValidDate(year, month, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Birth number contains an invalid date\",\n    );\n  }\n\n  // 10-digit: check digit is first 9 digits\n  // mod 11 mod 10\n  if (v.length === 10) {\n    const front = Number(v.slice(0, 9));\n    const check = (front % 11) % 10;\n    if (String(check) !== v[9]) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Birth number is not divisible by 11\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 6)}/${v.slice(6)}`;\n};\n\n/**\n * Extract birth date and gender from a birth number.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  const gender = mm >= 50 ? \"female\" : \"male\";\n  let year = yy + 1900;\n  if (v.length === 10 && year < 1954) year += 100;\n  if (v.length === 9 && year >= 1980) year -= 100;\n\n  const month = decodeMonth(mm, year, v.length);\n  if (month === null) {\n    return null;\n  }\n\n  return {\n    birthDate: new Date(year, month - 1, dd),\n    gender,\n  };\n};\n\n/**\n * Generate a random valid 10-digit birth number.\n * Uses a random date between 1954 and 2024.\n */\nconst generate = (): string => {\n  const year = randomInt(1954, 2024);\n  const month = randomInt(1, 12);\n  const day = randomInt(1, 28);\n  const isFemale = Math.random() < 0.5;\n  const mm = isFemale ? month + 50 : month;\n\n  const yy = String(year % 100).padStart(2, \"0\");\n  const mmStr = String(mm).padStart(2, \"0\");\n  const dd = String(day).padStart(2, \"0\");\n\n  const datePart = `${yy}${mmStr}${dd}`;\n  for (let seq = 0; seq < 1000; seq++) {\n    const seqStr = String(seq).padStart(3, \"0\");\n    const front = `${datePart}${seqStr}`;\n    const num = Number(front);\n    const check = (num % 11) % 10;\n    const result = `${front}${String(check)}`;\n    if (validate(result).valid) {\n      return result;\n    }\n  }\n\n  throw new Error(\"Failed to generate valid birth number\");\n};\n\n/** Czech/Slovak Birth Number. */\nconst rc: Validator<ParsedPersonId> = {\n  name: \"Czech Birth Number\",\n  localName: \"Rodné číslo\",\n  abbreviation: \"RČ\",\n  aliases: [\"rodné číslo\", \"RČ\", \"birth number\"] as const,\n  candidatePattern: \"\\\\d{6}/\\\\d{3,4}\",\n  country: \"CZ\",\n  entityType: \"person\",\n  description:\n    \"Czech/Slovak national identifier encoding birth date and gender\",\n  sourceUrl:\n    \"https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART\",\n  lengths: [9, 10] as const,\n  examples: [\"7103192745\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default rc;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"rc.js","names":[],"sources":["../../src/cz/rc.ts"],"sourcesContent":["/**\n * RČ (Rodné číslo).\n *\n * Czech and Slovak national identifier (birth\n * number). 9 or 10 digits encoding date of birth\n * and gender. 10-digit numbers (post-1954) must\n * be divisible by 11.\n *\n * Women have 50 added to the month. For modern\n * 10-digit numbers, an additional +20 offset may\n * be used when the daily serial range is exhausted\n * (+70 for women).\n *\n * Canonical source:\n * - Czech Ministry of the Interior guidance on rodne\n *   cislo, with the modern overflow-month rules\n *\n * We use this to keep the 9-digit historical form\n * valid while rejecting modern +20/+70 month offsets\n * on 9-digit numbers. Those overflow offsets are a\n * modern rule for 10-digit values.\n *\n * @see https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART\n * @see Law 133/2000 Sb.\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" /\");\n\nconst decodeMonth = (\n  rawMonth: number,\n  year: number,\n  length: number,\n): number | null => {\n  const candidates =\n    length === 10 && year >= 2004\n      ? [0, 50, 20, 70]\n      : [0, 50];\n  for (const offset of candidates) {\n    const month = rawMonth - offset;\n    if (month >= 1 && month <= 12) {\n      return month;\n    }\n  }\n  return null;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9 && v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Birth number must be 9 or 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Birth number must contain only digits\",\n    );\n  }\n\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  // Resolve full year\n  let year = yy + 1900;\n  if (v.length === 9) {\n    // 9-digit: pre-1954 only\n    if (year >= 1980) year -= 100;\n    if (year > 1953) {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"9-digit birth numbers are pre-1954 only\",\n      );\n    }\n  } else {\n    // 10-digit: if year < 1954, it's 2000s\n    if (year < 1954) year += 100;\n  }\n\n  const month = decodeMonth(mm, year, v.length);\n  if (month === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Birth number contains an invalid month\",\n    );\n  }\n\n  if (dd < 1 || dd > 31) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Birth number contains an invalid day\",\n    );\n  }\n\n  // Validate the actual date\n  if (!isValidDate(year, month, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Birth number contains an invalid date\",\n    );\n  }\n\n  // 10-digit: check digit is first 9 digits\n  // mod 11 mod 10\n  if (v.length === 10) {\n    const front = Number(v.slice(0, 9));\n    const check = (front % 11) % 10;\n    if (String(check) !== v[9]) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Birth number is not divisible by 11\",\n      );\n    }\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 6)}/${v.slice(6)}`;\n};\n\n/**\n * Extract birth date and gender from a birth number.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  const gender = mm >= 50 ? \"female\" : \"male\";\n  let year = yy + 1900;\n  if (v.length === 10 && year < 1954) year += 100;\n  if (v.length === 9 && year >= 1980) year -= 100;\n\n  const month = decodeMonth(mm, year, v.length);\n  if (month === null) {\n    return null;\n  }\n\n  return {\n    birthDate: new Date(year, month - 1, dd),\n    gender,\n  };\n};\n\n/**\n * Generate a random valid 10-digit birth number.\n * Uses a random date between 1954 and 2024.\n */\nconst generate = (): string => {\n  const year = randomInt(1954, 2024);\n  const month = randomInt(1, 12);\n  const day = randomInt(1, 28);\n  const isFemale = Math.random() < 0.5;\n  const mm = isFemale ? month + 50 : month;\n\n  const yy = String(year % 100).padStart(2, \"0\");\n  const mmStr = String(mm).padStart(2, \"0\");\n  const dd = String(day).padStart(2, \"0\");\n\n  const datePart = `${yy}${mmStr}${dd}`;\n  for (let seq = 0; seq < 1000; seq++) {\n    const seqStr = String(seq).padStart(3, \"0\");\n    const front = `${datePart}${seqStr}`;\n    const num = Number(front);\n    const check = (num % 11) % 10;\n    const result = `${front}${String(check)}`;\n    if (validate(result).valid) {\n      return result;\n    }\n  }\n\n  throw new Error(\"Failed to generate valid birth number\");\n};\n\n/** Czech/Slovak Birth Number. */\nconst rc: CountryValidator<\"CZ\", ParsedPersonId> = {\n  name: \"Czech Birth Number\",\n  localName: \"Rodné číslo\",\n  abbreviation: \"RČ\",\n  aliases: [\"rodné číslo\", \"RČ\", \"birth number\"] as const,\n  candidatePattern: \"\\\\d{6}/\\\\d{3,4}\",\n  scope: \"country\",\n  country: \"CZ\",\n  entityType: \"person\",\n  description:\n    \"Czech/Slovak national identifier encoding birth date and gender\",\n  sourceUrl:\n    \"https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART\",\n  lengths: [9, 10] as const,\n  examples: [\"7103192745\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default rc;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}

package/dist/de/handelsreg.d.ts

@@ -1,8 +1,25 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/de/handelsreg.d.ts
 /** Generate a random valid Handelsregisternummer. */
 declare const generate: () => string;
+/**
+ * Handelsregisternummer (German Company Register Number).
+ *
+ * German commercial register number assigned by the
+ * local court (Amtsgericht). Format: register type
+ * (HRA, HRB, GnR, PR, VR) + number.
+ *
+ * HRA = Handelsregister Abteilung A (partnerships,
+ * sole proprietors). HRB = Abteilung B (corporations).
+ * GnR = Genossenschaftsregister.
+ * PR = Partnerschaftsregister.
+ * VR = Vereinsregister.
+ *
+ * No check digit; validation is structural only.
+ *
+ * @see https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)
+ */
 /**
  * Strip separators and normalize to canonical form.
  * Accepts "HRB 12345", "HRB12345", "hrb 12345".
@@ -11,7 +28,7 @@ declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** German Company Register Number. */
-declare const handelsreg: Validator;
+declare const handelsreg: CountryValidator<"DE">;
 //#endregion
 export { compact, handelsreg as default, format, generate, validate };
 //# sourceMappingURL=handelsreg.d.ts.map

package/dist/de/handelsreg.js

@@ -2,23 +2,6 @@ import { clean } from "../_util/clean.js";
 import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/de/handelsreg.ts
-/**
-* Handelsregisternummer (German Company Register Number).
-*
-* German commercial register number assigned by the
-* local court (Amtsgericht). Format: register type
-* (HRA, HRB, GnR, PR, VR) + number.
-*
-* HRA = Handelsregister Abteilung A (partnerships,
-* sole proprietors). HRB = Abteilung B (corporations).
-* GnR = Genossenschaftsregister.
-* PR = Partnerschaftsregister.
-* VR = Vereinsregister.
-*
-* No check digit; validation is structural only.
-*
-* @see https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)
-*/
 const GENERATE_TYPES = [
 	"HRA",
 	"HRB",
@@ -71,6 +54,7 @@ const handelsreg = {
 		"HRA"
 	],
 	candidatePattern: "(?:HRA|HRB|GnR|PR|VR)\\s*\\d{1,7}",
+	scope: "country",
 	country: "DE",
 	entityType: "company",
 	sourceUrl: "https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)",

package/dist/de/handelsreg.js.map

@@ -1 +1 @@
-{"version":3,"file":"handelsreg.js","names":[],"sources":["../../src/de/handelsreg.ts"],"sourcesContent":["const GENERATE_TYPES = [\n  \"HRA\",\n  \"HRB\",\n  \"GNR\",\n  \"PR\",\n  \"VR\",\n] as const;\n\n/** Generate a random valid Handelsregisternummer. */\nconst generate = (): string => {\n  const type = randomPick(GENERATE_TYPES);\n  const number = randomDigits(5);\n  return `${type} ${number}`;\n};\n\n/**\n * Handelsregisternummer (German Company Register Number).\n *\n * German commercial register number assigned by the\n * local court (Amtsgericht). Format: register type\n * (HRA, HRB, GnR, PR, VR) + number.\n *\n * HRA = Handelsregister Abteilung A (partnerships,\n * sole proprietors). HRB = Abteilung B (corporations).\n * GnR = Genossenschaftsregister.\n * PR = Partnerschaftsregister.\n * VR = Vereinsregister.\n *\n * No check digit; validation is structural only.\n *\n * @see https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)\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 REGISTER_TYPES = new Set([\n  \"HRA\",\n  \"HRB\",\n  \"GNR\",\n  \"PR\",\n  \"VR\",\n]);\n\n/**\n * Strip separators and normalize to canonical form.\n * Accepts \"HRB 12345\", \"HRB12345\", \"hrb 12345\".\n */\nconst compact = (value: string): string => {\n  const v = clean(value, \" -.\").trim().toUpperCase();\n  const match = v.match(/^(HRA|HRB|GNR|PR|VR)(\\d{1,7})$/);\n  if (!match) return v;\n  return `${match[1]} ${match[2]}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = clean(value, \" -.\").trim().toUpperCase();\n\n  const match = v.match(/^([A-Z]{2,3})(\\d{1,7})$/);\n  if (!match) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Handelsregisternummer must be a register type \" +\n        \"(HRA, HRB, GnR, PR, VR) followed by \" +\n        \"1-7 digits\",\n    );\n  }\n\n  // SAFETY: both capture groups are required, so a\n  // successful match always populates [1] and [2].\n  // eslint-disable-next-line no-non-null-assertion\n  const type = match[1]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const number = match[2]!;\n\n  if (!REGISTER_TYPES.has(type)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `Unrecognised register type \"${type}\"`,\n    );\n  }\n\n  return {\n    valid: true,\n    compact: `${type} ${number}`,\n  };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** German Company Register Number. */\nconst handelsreg: Validator = {\n  name: \"German Company Register Number\",\n  localName: \"Handelsregisternummer\",\n  abbreviation: \"HReg\",\n  aliases: [\n    \"Handelsregisternummer\",\n    \"Handelsregister\",\n    \"HRB\",\n    \"HRA\",\n  ] as const,\n  candidatePattern: \"(?:HRA|HRB|GnR|PR|VR)\\\\s*\\\\d{1,7}\",\n  country: \"DE\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)\",\n  examples: [\"HRB 12345\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default handelsreg;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,MAAM,iBAAiB;CACrB;CACA;CACA;CACA;CACA;CACD;;AAGD,MAAM,iBAAyB;AAG7B,QAAO,GAFM,WAAW,eAAe,CAExB,GADA,aAAa,EAAE;;AA4BhC,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;AAMF,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa;CAClD,MAAM,QAAQ,EAAE,MAAM,iCAAiC;AACvD,KAAI,CAAC,MAAO,QAAO;AACnB,QAAO,GAAG,MAAM,GAAG,GAAG,MAAM;;AAG9B,MAAM,YAAY,UAAkC;CAGlD,MAAM,QAFI,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAElC,MAAM,0BAA0B;AAChD,KAAI,CAAC,MACH,QAAO,IACL,kBACA,+FAGD;CAMH,MAAM,OAAO,MAAM;CAEnB,MAAM,SAAS,MAAM;AAErB,KAAI,CAAC,eAAe,IAAI,KAAK,CAC3B,QAAO,IACL,qBACA,+BAA+B,KAAK,GACrC;AAGH,QAAO;EACL,OAAO;EACP,SAAS,GAAG,KAAK,GAAG;EACrB;;AAGH,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,aAAwB;CAC5B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"handelsreg.js","names":[],"sources":["../../src/de/handelsreg.ts"],"sourcesContent":["const GENERATE_TYPES = [\n  \"HRA\",\n  \"HRB\",\n  \"GNR\",\n  \"PR\",\n  \"VR\",\n] as const;\n\n/** Generate a random valid Handelsregisternummer. */\nconst generate = (): string => {\n  const type = randomPick(GENERATE_TYPES);\n  const number = randomDigits(5);\n  return `${type} ${number}`;\n};\n\n/**\n * Handelsregisternummer (German Company Register Number).\n *\n * German commercial register number assigned by the\n * local court (Amtsgericht). Format: register type\n * (HRA, HRB, GnR, PR, VR) + number.\n *\n * HRA = Handelsregister Abteilung A (partnerships,\n * sole proprietors). HRB = Abteilung B (corporations).\n * GnR = Genossenschaftsregister.\n * PR = Partnerschaftsregister.\n * VR = Vereinsregister.\n *\n * No check digit; validation is structural only.\n *\n * @see https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)\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 REGISTER_TYPES = new Set([\n  \"HRA\",\n  \"HRB\",\n  \"GNR\",\n  \"PR\",\n  \"VR\",\n]);\n\n/**\n * Strip separators and normalize to canonical form.\n * Accepts \"HRB 12345\", \"HRB12345\", \"hrb 12345\".\n */\nconst compact = (value: string): string => {\n  const v = clean(value, \" -.\").trim().toUpperCase();\n  const match = v.match(/^(HRA|HRB|GNR|PR|VR)(\\d{1,7})$/);\n  if (!match) return v;\n  return `${match[1]} ${match[2]}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = clean(value, \" -.\").trim().toUpperCase();\n\n  const match = v.match(/^([A-Z]{2,3})(\\d{1,7})$/);\n  if (!match) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Handelsregisternummer must be a register type \" +\n        \"(HRA, HRB, GnR, PR, VR) followed by \" +\n        \"1-7 digits\",\n    );\n  }\n\n  // SAFETY: both capture groups are required, so a\n  // successful match always populates [1] and [2].\n  // eslint-disable-next-line no-non-null-assertion\n  const type = match[1]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const number = match[2]!;\n\n  if (!REGISTER_TYPES.has(type)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `Unrecognised register type \"${type}\"`,\n    );\n  }\n\n  return {\n    valid: true,\n    compact: `${type} ${number}`,\n  };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** German Company Register Number. */\nconst handelsreg: CountryValidator<\"DE\"> = {\n  name: \"German Company Register Number\",\n  localName: \"Handelsregisternummer\",\n  abbreviation: \"HReg\",\n  aliases: [\n    \"Handelsregisternummer\",\n    \"Handelsregister\",\n    \"HRB\",\n    \"HRA\",\n  ] as const,\n  candidatePattern: \"(?:HRA|HRB|GnR|PR|VR)\\\\s*\\\\d{1,7}\",\n  scope: \"country\",\n  country: \"DE\",\n  entityType: \"company\",\n  sourceUrl:\n    \"https://de.wikipedia.org/wiki/Handelsregister_(Deutschland)\",\n  examples: [\"HRB 12345\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default handelsreg;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;AAAA,MAAM,iBAAiB;CACrB;CACA;CACA;CACA;CACA;AACF;;AAGA,MAAM,iBAAyB;CAG7B,OAAO,GAFM,WAAW,cAEX,EAAE,GADA,aAAa,CACL;AACzB;AA6BA,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;AAMD,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY;CACjD,MAAM,QAAQ,EAAE,MAAM,gCAAgC;CACtD,IAAI,CAAC,OAAO,OAAO;CACnB,OAAO,GAAG,MAAM,GAAG,GAAG,MAAM;AAC9B;AAEA,MAAM,YAAY,UAAkC;CAGlD,MAAM,QAFI,MAAM,OAAO,KAAK,EAAE,KAAK,EAAE,YAEvB,EAAE,MAAM,yBAAyB;CAC/C,IAAI,CAAC,OACH,OAAO,IACL,kBACA,8FAGF;CAMF,MAAM,OAAO,MAAM;CAEnB,MAAM,SAAS,MAAM;CAErB,IAAI,CAAC,eAAe,IAAI,IAAI,GAC1B,OAAO,IACL,qBACA,+BAA+B,KAAK,EACtC;CAGF,OAAO;EACL,OAAO;EACP,SAAS,GAAG,KAAK,GAAG;CACtB;AACF;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,aAAqC;CACzC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/de/idnr.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/de/idnr.d.ts
 declare const compact: (value: string) => string;
@@ -7,7 +7,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid German IdNr. */
 declare const generate: () => string;
 /** German Personal Tax ID. */
-declare const idnr: Validator;
+declare const idnr: CountryValidator<"DE">;
 //#endregion
 export { compact, idnr as default, format, generate, validate };
 //# sourceMappingURL=idnr.d.ts.map

package/dist/de/idnr.js

@@ -1,20 +1,9 @@
+import { mod1110checkDigit, mod1110validate } from "../_checksums/mod1110.js";
 import { clean } from "../_util/clean.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { mod1110checkDigit, mod1110validate } from "../_checksums/mod1110.js";
 //#region src/de/idnr.ts
-/**
-* IdNr (Steuerliche Identifikationsnummer).
-*
-* German personal tax identification number.
-* 11 digits; the last digit is a check digit
-* (ISO 7064 Mod 11,10). Exactly one digit
-* appears twice or three times; the rest are
-* unique. The first digit cannot be 0.
-*
-* @see https://www.bzst.de/DE/Privatpersonen/SteuerlicheIdentifikationsnummer/steuerlicheidentifikationsnummer_node.html
-*/
 const compact = (value) => clean(value, " -/");
 /**
 * Validate digit distribution: in the first 10
@@ -87,6 +76,7 @@ const idnr = {
 		"Steuer-ID"
 	],
 	candidatePattern: "\\d{2}\\s?\\d{3}\\s?\\d{3}\\s?\\d{3}",
+	scope: "country",
 	country: "DE",
 	entityType: "person",
 	sourceUrl: "https://www.bzst.de/DE/Privatpersonen/SteuerlicheIdentifikationsnummer/steuerlicheidentifikationsnummer_node.html",

package/dist/de/idnr.js.map

@@ -1 +1 @@
-{"version":3,"file":"idnr.js","names":[],"sources":["../../src/de/idnr.ts"],"sourcesContent":["/**\n * IdNr (Steuerliche Identifikationsnummer).\n *\n * German personal tax identification number.\n * 11 digits; the last digit is a check digit\n * (ISO 7064 Mod 11,10). Exactly one digit\n * appears twice or three times; the rest are\n * unique. The first digit cannot be 0.\n *\n * @see https://www.bzst.de/DE/Privatpersonen/SteuerlicheIdentifikationsnummer/steuerlicheidentifikationsnummer_node.html\n */\n\nimport {\n  mod1110validate,\n  mod1110checkDigit,\n} from \"#checksums/mod1110\";\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -/\");\n\n/**\n * Validate digit distribution: in the first 10\n * digits, exactly one digit appears 2 or 3\n * times; all others appear exactly once.\n */\nconst validDistribution = (value: string): boolean => {\n  const counts = Array.from<number>({ length: 10 }).fill(0);\n  for (let i = 0; i < 10; i++) {\n    const idx = Number(value.charAt(i));\n    const prev = counts[idx];\n    if (prev !== undefined) counts[idx] = prev + 1;\n  }\n  let doubles = 0;\n  let triples = 0;\n  for (const c of counts) {\n    if (c === 2) doubles++;\n    if (c === 3) triples++;\n    if (c > 3) return false;\n  }\n  // Exactly one digit repeated (2 or 3 times)\n  return (\n    (doubles === 1 && triples === 0) ||\n    (doubles === 0 && triples === 1)\n  );\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"German IdNr must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"German IdNr must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German IdNr cannot start with 0\",\n    );\n  }\n  if (!validDistribution(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German IdNr digit distribution invalid\",\n    );\n  }\n  if (!mod1110validate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"German IdNr 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, 2)} ${v.slice(2, 5)} ${v.slice(5, 8)} ${v.slice(8)}`;\n};\n\n/** Generate a random valid German IdNr. */\nconst generate = (): string => {\n  for (;;) {\n    const repeated = randomInt(0, 9);\n    const times = Math.random() < 0.8 ? 2 : 3;\n    const pool: number[] = [];\n    for (let d = 0; d < 10; d++) {\n      const count = d === repeated ? times : 1;\n      for (let t = 0; t < count; t++) pool.push(d);\n    }\n    while (pool.length < 10) pool.push(randomInt(0, 9));\n    for (let i = pool.length - 1; i > 0; i--) {\n      const j = randomInt(0, i);\n      // SAFETY: i and j are valid indices of `pool`\n      // (i > 0, j ∈ [0, i]).\n      // eslint-disable-next-line no-non-null-assertion\n      [pool[i], pool[j]] = [pool[j]!, pool[i]!];\n    }\n    if (pool[0] === 0) continue;\n    const payload = pool.slice(0, 10).join(\"\");\n    if (!validDistribution(payload)) continue;\n    const check = mod1110checkDigit(payload);\n    const c = payload + String(check);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** German Personal Tax ID. */\nconst idnr: Validator = {\n  name: \"German Tax ID\",\n  localName: \"Steuerliche Identifikationsnummer\",\n  abbreviation: \"IdNr\",\n  aliases: [\n    \"Steuerliche Identifikationsnummer\",\n    \"IdNr\",\n    \"Steuer-ID\",\n  ] as const,\n  candidatePattern: \"\\\\d{2}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\",\n  country: \"DE\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.bzst.de/DE/Privatpersonen/SteuerlicheIdentifikationsnummer/steuerlicheidentifikationsnummer_node.html\",\n  examples: [\"36574261809\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default idnr;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;;AAOrB,MAAM,qBAAqB,UAA2B;CACpD,MAAM,SAAS,MAAM,KAAa,EAAE,QAAQ,IAAI,CAAC,CAAC,KAAK,EAAE;AACzD,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,MAAM,OAAO,MAAM,OAAO,EAAE,CAAC;EACnC,MAAM,OAAO,OAAO;AACpB,MAAI,SAAS,KAAA,EAAW,QAAO,OAAO,OAAO;;CAE/C,IAAI,UAAU;CACd,IAAI,UAAU;AACd,MAAK,MAAM,KAAK,QAAQ;AACtB,MAAI,MAAM,EAAG;AACb,MAAI,MAAM,EAAG;AACb,MAAI,IAAI,EAAG,QAAO;;AAGpB,QACG,YAAY,KAAK,YAAY,KAC7B,YAAY,KAAK,YAAY;;AAIlC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,kCACD;AAEH,KAAI,CAAC,kBAAkB,EAAE,CACvB,QAAO,IACL,qBACA,yCACD;AAEH,KAAI,CAAC,gBAAgB,EAAE,CACrB,QAAO,IACL,oBACA,mCACD;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,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIzE,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,WAAW,UAAU,GAAG,EAAE;EAChC,MAAM,QAAQ,KAAK,QAAQ,GAAG,KAAM,IAAI;EACxC,MAAM,OAAiB,EAAE;AACzB,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,QAAQ,MAAM,WAAW,QAAQ;AACvC,QAAK,IAAI,IAAI,GAAG,IAAI,OAAO,IAAK,MAAK,KAAK,EAAE;;AAE9C,SAAO,KAAK,SAAS,GAAI,MAAK,KAAK,UAAU,GAAG,EAAE,CAAC;AACnD,OAAK,IAAI,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK;GACxC,MAAM,IAAI,UAAU,GAAG,EAAE;AAIzB,IAAC,KAAK,IAAI,KAAK,MAAM,CAAC,KAAK,IAAK,KAAK,GAAI;;AAE3C,MAAI,KAAK,OAAO,EAAG;EACnB,MAAM,UAAU,KAAK,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG;AAC1C,MAAI,CAAC,kBAAkB,QAAQ,CAAE;EACjC,MAAM,QAAQ,kBAAkB,QAAQ;EACxC,MAAM,IAAI,UAAU,OAAO,MAAM;AACjC,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,WACE;CACF,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"idnr.js","names":[],"sources":["../../src/de/idnr.ts"],"sourcesContent":["/**\n * IdNr (Steuerliche Identifikationsnummer).\n *\n * German personal tax identification number.\n * 11 digits; the last digit is a check digit\n * (ISO 7064 Mod 11,10). Exactly one digit\n * appears twice or three times; the rest are\n * unique. The first digit cannot be 0.\n *\n * @see https://www.bzst.de/DE/Privatpersonen/SteuerlicheIdentifikationsnummer/steuerlicheidentifikationsnummer_node.html\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport {\n  mod1110validate,\n  mod1110checkDigit,\n} from \"#checksums/mod1110\";\nimport { clean } from \"#util/clean\";\nimport { randomInt } 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 * Validate digit distribution: in the first 10\n * digits, exactly one digit appears 2 or 3\n * times; all others appear exactly once.\n */\nconst validDistribution = (value: string): boolean => {\n  const counts = Array.from<number>({ length: 10 }).fill(0);\n  for (let i = 0; i < 10; i++) {\n    const idx = Number(value.charAt(i));\n    const prev = counts[idx];\n    if (prev !== undefined) counts[idx] = prev + 1;\n  }\n  let doubles = 0;\n  let triples = 0;\n  for (const c of counts) {\n    if (c === 2) doubles++;\n    if (c === 3) triples++;\n    if (c > 3) return false;\n  }\n  // Exactly one digit repeated (2 or 3 times)\n  return (\n    (doubles === 1 && triples === 0) ||\n    (doubles === 0 && triples === 1)\n  );\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"German IdNr must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"German IdNr must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German IdNr cannot start with 0\",\n    );\n  }\n  if (!validDistribution(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German IdNr digit distribution invalid\",\n    );\n  }\n  if (!mod1110validate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"German IdNr 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, 2)} ${v.slice(2, 5)} ${v.slice(5, 8)} ${v.slice(8)}`;\n};\n\n/** Generate a random valid German IdNr. */\nconst generate = (): string => {\n  for (;;) {\n    const repeated = randomInt(0, 9);\n    const times = Math.random() < 0.8 ? 2 : 3;\n    const pool: number[] = [];\n    for (let d = 0; d < 10; d++) {\n      const count = d === repeated ? times : 1;\n      for (let t = 0; t < count; t++) pool.push(d);\n    }\n    while (pool.length < 10) pool.push(randomInt(0, 9));\n    for (let i = pool.length - 1; i > 0; i--) {\n      const j = randomInt(0, i);\n      // SAFETY: i and j are valid indices of `pool`\n      // (i > 0, j ∈ [0, i]).\n      // eslint-disable-next-line no-non-null-assertion\n      [pool[i], pool[j]] = [pool[j]!, pool[i]!];\n    }\n    if (pool[0] === 0) continue;\n    const payload = pool.slice(0, 10).join(\"\");\n    if (!validDistribution(payload)) continue;\n    const check = mod1110checkDigit(payload);\n    const c = payload + String(check);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** German Personal Tax ID. */\nconst idnr: CountryValidator<\"DE\"> = {\n  name: \"German Tax ID\",\n  localName: \"Steuerliche Identifikationsnummer\",\n  abbreviation: \"IdNr\",\n  aliases: [\n    \"Steuerliche Identifikationsnummer\",\n    \"IdNr\",\n    \"Steuer-ID\",\n  ] as const,\n  candidatePattern: \"\\\\d{2}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\",\n  scope: \"country\",\n  country: \"DE\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.bzst.de/DE/Privatpersonen/SteuerlicheIdentifikationsnummer/steuerlicheidentifikationsnummer_node.html\",\n  examples: [\"36574261809\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default idnr;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AA0BA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;;;;;AAOpB,MAAM,qBAAqB,UAA2B;CACpD,MAAM,SAAS,MAAM,KAAa,EAAE,QAAQ,GAAG,CAAC,EAAE,KAAK,CAAC;CACxD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,MAAM,OAAO,MAAM,OAAO,CAAC,CAAC;EAClC,MAAM,OAAO,OAAO;EACpB,IAAI,SAAS,KAAA,GAAW,OAAO,OAAO,OAAO;CAC/C;CACA,IAAI,UAAU;CACd,IAAI,UAAU;CACd,KAAK,MAAM,KAAK,QAAQ;EACtB,IAAI,MAAM,GAAG;EACb,IAAI,MAAM,GAAG;EACb,IAAI,IAAI,GAAG,OAAO;CACpB;CAEA,OACG,YAAY,KAAK,YAAY,KAC7B,YAAY,KAAK,YAAY;AAElC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,sCACF;CAEF,IAAI,EAAE,OAAO,KACX,OAAO,IACL,qBACA,iCACF;CAEF,IAAI,CAAC,kBAAkB,CAAC,GACtB,OAAO,IACL,qBACA,wCACF;CAEF,IAAI,CAAC,gBAAgB,CAAC,GACpB,OAAO,IACL,oBACA,kCACF;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,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC;AACxE;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,WAAW,UAAU,GAAG,CAAC;EAC/B,MAAM,QAAQ,KAAK,OAAO,IAAI,KAAM,IAAI;EACxC,MAAM,OAAiB,CAAC;EACxB,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,QAAQ,MAAM,WAAW,QAAQ;GACvC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK,KAAK,KAAK,CAAC;EAC7C;EACA,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,GAAG,CAAC,CAAC;EAClD,KAAK,IAAI,IAAI,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK;GACxC,MAAM,IAAI,UAAU,GAAG,CAAC;GAIxB,CAAC,KAAK,IAAI,KAAK,MAAM,CAAC,KAAK,IAAK,KAAK,EAAG;EAC1C;EACA,IAAI,KAAK,OAAO,GAAG;EACnB,MAAM,UAAU,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE;EACzC,IAAI,CAAC,kBAAkB,OAAO,GAAG;EACjC,MAAM,QAAQ,kBAAkB,OAAO;EACvC,MAAM,IAAI,UAAU,OAAO,KAAK;EAChC,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,WACE;CACF,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/de/stnr.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/de/stnr.d.ts
 /**
@@ -6,6 +6,21 @@ import { ValidateResult, Validator } from "../types.js";
  * Uses Berlin regional format (FFBBBUUUUP, 10 digits).
  */
 declare const generate: () => string;
+/**
+ * StNr (Steuernummer).
+ *
+ * German tax number assigned by the local tax office.
+ * Regional format: 10 or 11 digits. Unified federal
+ * format: 13 digits (prefixed with a 2–4 digit BUFA
+ * code). Structure varies by federal state.
+ *
+ * The number encodes: BUFA (Bundesfinanzamtsnummer),
+ * district code, serial number, and check digit. No
+ * algorithmic check digit validation is standardised
+ * across all states; validation is format-only.
+ *
+ * @see https://de.wikipedia.org/wiki/Steuernummer
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 /**
@@ -15,7 +30,7 @@ declare const validate: (value: string) => ValidateResult;
  */
 declare const format: (value: string) => string;
 /** German Tax Number (Steuernummer). */
-declare const stnr: Validator;
+declare const stnr: CountryValidator<"DE">;
 //#endregion
 export { compact, stnr as default, format, generate, validate };
 //# sourceMappingURL=stnr.d.ts.map

package/dist/de/stnr.js

@@ -4,21 +4,6 @@ import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/de/stnr.ts
 /**
-* StNr (Steuernummer).
-*
-* German tax number assigned by the local tax office.
-* Regional format: 10 or 11 digits. Unified federal
-* format: 13 digits (prefixed with a 2–4 digit BUFA
-* code). Structure varies by federal state.
-*
-* The number encodes: BUFA (Bundesfinanzamtsnummer),
-* district code, serial number, and check digit. No
-* algorithmic check digit validation is standardised
-* across all states; validation is format-only.
-*
-* @see https://de.wikipedia.org/wiki/Steuernummer
-*/
-/**
 * Generate a random valid Steuernummer.
 * Uses Berlin regional format (FFBBBUUUUP, 10 digits).
 */
@@ -123,6 +108,7 @@ const stnr = {
 	abbreviation: "StNr",
 	aliases: ["Steuernummer", "St.Nr."],
 	candidatePattern: "\\d{2,4}/\\d{3,4}/\\d{4,5}",
+	scope: "country",
 	country: "DE",
 	entityType: "any",
 	description: "German tax number assigned by the local tax office, varies by federal state",

package/dist/de/stnr.js.map

@@ -1 +1 @@
-{"version":3,"file":"stnr.js","names":[],"sources":["../../src/de/stnr.ts"],"sourcesContent":["/**\n * Generate a random valid Steuernummer.\n * Uses Berlin regional format (FFBBBUUUUP, 10 digits).\n */\nconst generate = (): string => {\n  const ff = randomDigits(2);\n  const bbb = randomDigits(3);\n  const uuuu = randomDigits(4);\n  const p = randomDigits(1);\n  return `${ff}${bbb}${uuuu}${p}`;\n};\n\n/**\n * StNr (Steuernummer).\n *\n * German tax number assigned by the local tax office.\n * Regional format: 10 or 11 digits. Unified federal\n * format: 13 digits (prefixed with a 2–4 digit BUFA\n * code). Structure varies by federal state.\n *\n * The number encodes: BUFA (Bundesfinanzamtsnummer),\n * district code, serial number, and check digit. No\n * algorithmic check digit validation is standardised\n * across all states; validation is format-only.\n *\n * @see https://de.wikipedia.org/wiki/Steuernummer\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Format patterns per federal state.\n * [0] = regional format, [1] = unified (federal) format.\n *\n * Legend: F = finance office, B = district,\n *         U = serial, P = check digit,\n *         leading digits are literal.\n */\nconst STATES = {\n  \"Baden-Württemberg\": [\"FFBBBUUUUP\", \"28FF0BBBUUUUP\"],\n  Bayern: [\"FFFBBBUUUUP\", \"9FFF0BBBUUUUP\"],\n  Berlin: [\"FFBBBUUUUP\", \"11FF0BBBUUUUP\"],\n  Brandenburg: [\"0FFBBBUUUUP\", \"30FF0BBBUUUUP\"],\n  Bremen: [\"FFBBBUUUUP\", \"24FF0BBBUUUUP\"],\n  Hamburg: [\"FFBBBUUUUP\", \"22FF0BBBUUUUP\"],\n  Hessen: [\"0FFBBBUUUUP\", \"26FF0BBBUUUUP\"],\n  \"Mecklenburg-Vorpommern\": [\n    \"0FFBBBUUUUP\",\n    \"40FF0BBBUUUUP\",\n  ],\n  Niedersachsen: [\"FFBBBUUUUP\", \"23FF0BBBUUUUP\"],\n  \"Nordrhein-Westfalen\": [\"FFFBBBBUUUP\", \"5FFF0BBBBUUUP\"],\n  \"Rheinland-Pfalz\": [\"FFBBBUUUUP\", \"27FF0BBBUUUUP\"],\n  Saarland: [\"0FFBBBUUUUP\", \"10FF0BBBUUUUP\"],\n  Sachsen: [\"2FFBBBUUUUP\", \"32FF0BBBUUUUP\"],\n  \"Sachsen-Anhalt\": [\"1FFBBBUUUUP\", \"31FF0BBBUUUUP\"],\n  \"Schleswig-Holstein\": [\"FFBBBUUUUP\", \"21FF0BBBUUUUP\"],\n  Thüringen: [\"1FFBBBUUUUP\", \"41FF0BBBUUUUP\"],\n} as const;\n\ntype StateName = keyof typeof STATES;\n\n/**\n * Convert a format pattern to a regex.\n * Literal digits match themselves; F/B/U match any\n * digit; P (check digit) matches any digit.\n */\nconst patternToRegex = (pattern: string): RegExp => {\n  let re = \"^\";\n  for (const ch of pattern) {\n    if (ch >= \"0\" && ch <= \"9\") {\n      re += ch;\n    } else {\n      re += \"\\\\d\";\n    }\n  }\n  re += \"$\";\n  return new RegExp(re);\n};\n\n/** Pre-compiled regexes for each state + format. */\nconst COMPILED: Array<{\n  state: StateName;\n  regional: RegExp;\n  regionalFmt: string;\n  federal: RegExp;\n  federalFmt: string;\n}> = (\n  Object.entries(STATES) as Array<\n    [StateName, readonly [string, string]]\n  >\n).map(([state, [regionalFmt, federalFmt]]) => ({\n  state,\n  regional: patternToRegex(regionalFmt),\n  regionalFmt,\n  federal: patternToRegex(federalFmt),\n  federalFmt,\n}));\n\nconst compact = (value: string): string =>\n  clean(value, \" -/.\");\n\nconst matchesAnyPattern = (v: string): boolean => {\n  for (const { regional, federal } of COMPILED) {\n    if (regional.test(v) || federal.test(v)) return true;\n  }\n  return false;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"German Steuernummer must contain only digits\",\n    );\n  }\n\n  if (\n    v.length !== 10 &&\n    v.length !== 11 &&\n    v.length !== 13\n  ) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"German Steuernummer must be 10, 11, or 13 digits\",\n    );\n  }\n\n  if (!matchesAnyPattern(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German Steuernummer does not match any \" +\n        \"known state format\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\n/**\n * Format with slashes at segment boundaries.\n * Uses the first matching state pattern to determine\n * segment positions.\n */\nconst format = (value: string): string => {\n  const v = compact(value);\n\n  for (const entry of COMPILED) {\n    const pattern =\n      v.length === 13 ? entry.federal : entry.regional;\n    if (!pattern.test(v)) continue;\n\n    const fmt =\n      v.length === 13\n        ? entry.federalFmt\n        : entry.regionalFmt;\n\n    // Group by consecutive runs of the same letter\n    // category: literal digits, F, B, U, P\n    const segments: string[] = [];\n    let segStart = 0;\n    // SAFETY: fmt is a non-empty literal from COMPILED.\n    // eslint-disable-next-line no-non-null-assertion\n    let prevCat = charCat(fmt[0]!);\n\n    for (let i = 1; i < fmt.length; i++) {\n      // SAFETY: i < fmt.length.\n      // eslint-disable-next-line no-non-null-assertion\n      const cat = charCat(fmt[i]!);\n      if (cat !== prevCat) {\n        segments.push(v.slice(segStart, i));\n        segStart = i;\n        prevCat = cat;\n      }\n    }\n    segments.push(v.slice(segStart));\n\n    return segments.join(\"/\");\n  }\n\n  return v;\n};\n\nconst charCat = (ch: string): string => {\n  if (ch >= \"0\" && ch <= \"9\") return \"L\"; // literal\n  return ch; // F, B, U, P\n};\n\n/** German Tax Number (Steuernummer). */\nconst stnr: Validator = {\n  name: \"German Tax Number\",\n  localName: \"Steuernummer\",\n  abbreviation: \"StNr\",\n  aliases: [\"Steuernummer\", \"St.Nr.\"] as const,\n  candidatePattern: \"\\\\d{2,4}/\\\\d{3,4}/\\\\d{4,5}\",\n  country: \"DE\",\n  entityType: \"any\",\n  description:\n    \"German tax number assigned by the local \" +\n    \"tax office, varies by federal state\",\n  sourceUrl: \"https://de.wikipedia.org/wiki/Steuernummer\",\n  lengths: [10, 11, 13] as const,\n  examples: [\"2181508150\", \"18181508155\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default stnr;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"stnr.js","names":[],"sources":["../../src/de/stnr.ts"],"sourcesContent":["/**\n * Generate a random valid Steuernummer.\n * Uses Berlin regional format (FFBBBUUUUP, 10 digits).\n */\nconst generate = (): string => {\n  const ff = randomDigits(2);\n  const bbb = randomDigits(3);\n  const uuuu = randomDigits(4);\n  const p = randomDigits(1);\n  return `${ff}${bbb}${uuuu}${p}`;\n};\n\n/**\n * StNr (Steuernummer).\n *\n * German tax number assigned by the local tax office.\n * Regional format: 10 or 11 digits. Unified federal\n * format: 13 digits (prefixed with a 2–4 digit BUFA\n * code). Structure varies by federal state.\n *\n * The number encodes: BUFA (Bundesfinanzamtsnummer),\n * district code, serial number, and check digit. No\n * algorithmic check digit validation is standardised\n * across all states; validation is format-only.\n *\n * @see https://de.wikipedia.org/wiki/Steuernummer\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/**\n * Format patterns per federal state.\n * [0] = regional format, [1] = unified (federal) format.\n *\n * Legend: F = finance office, B = district,\n *         U = serial, P = check digit,\n *         leading digits are literal.\n */\nconst STATES = {\n  \"Baden-Württemberg\": [\"FFBBBUUUUP\", \"28FF0BBBUUUUP\"],\n  Bayern: [\"FFFBBBUUUUP\", \"9FFF0BBBUUUUP\"],\n  Berlin: [\"FFBBBUUUUP\", \"11FF0BBBUUUUP\"],\n  Brandenburg: [\"0FFBBBUUUUP\", \"30FF0BBBUUUUP\"],\n  Bremen: [\"FFBBBUUUUP\", \"24FF0BBBUUUUP\"],\n  Hamburg: [\"FFBBBUUUUP\", \"22FF0BBBUUUUP\"],\n  Hessen: [\"0FFBBBUUUUP\", \"26FF0BBBUUUUP\"],\n  \"Mecklenburg-Vorpommern\": [\n    \"0FFBBBUUUUP\",\n    \"40FF0BBBUUUUP\",\n  ],\n  Niedersachsen: [\"FFBBBUUUUP\", \"23FF0BBBUUUUP\"],\n  \"Nordrhein-Westfalen\": [\"FFFBBBBUUUP\", \"5FFF0BBBBUUUP\"],\n  \"Rheinland-Pfalz\": [\"FFBBBUUUUP\", \"27FF0BBBUUUUP\"],\n  Saarland: [\"0FFBBBUUUUP\", \"10FF0BBBUUUUP\"],\n  Sachsen: [\"2FFBBBUUUUP\", \"32FF0BBBUUUUP\"],\n  \"Sachsen-Anhalt\": [\"1FFBBBUUUUP\", \"31FF0BBBUUUUP\"],\n  \"Schleswig-Holstein\": [\"FFBBBUUUUP\", \"21FF0BBBUUUUP\"],\n  Thüringen: [\"1FFBBBUUUUP\", \"41FF0BBBUUUUP\"],\n} as const;\n\ntype StateName = keyof typeof STATES;\n\n/**\n * Convert a format pattern to a regex.\n * Literal digits match themselves; F/B/U match any\n * digit; P (check digit) matches any digit.\n */\nconst patternToRegex = (pattern: string): RegExp => {\n  let re = \"^\";\n  for (const ch of pattern) {\n    if (ch >= \"0\" && ch <= \"9\") {\n      re += ch;\n    } else {\n      re += \"\\\\d\";\n    }\n  }\n  re += \"$\";\n  return new RegExp(re);\n};\n\n/** Pre-compiled regexes for each state + format. */\nconst COMPILED: Array<{\n  state: StateName;\n  regional: RegExp;\n  regionalFmt: string;\n  federal: RegExp;\n  federalFmt: string;\n}> = (\n  Object.entries(STATES) as Array<\n    [StateName, readonly [string, string]]\n  >\n).map(([state, [regionalFmt, federalFmt]]) => ({\n  state,\n  regional: patternToRegex(regionalFmt),\n  regionalFmt,\n  federal: patternToRegex(federalFmt),\n  federalFmt,\n}));\n\nconst compact = (value: string): string =>\n  clean(value, \" -/.\");\n\nconst matchesAnyPattern = (v: string): boolean => {\n  for (const { regional, federal } of COMPILED) {\n    if (regional.test(v) || federal.test(v)) return true;\n  }\n  return false;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"German Steuernummer must contain only digits\",\n    );\n  }\n\n  if (\n    v.length !== 10 &&\n    v.length !== 11 &&\n    v.length !== 13\n  ) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"German Steuernummer must be 10, 11, or 13 digits\",\n    );\n  }\n\n  if (!matchesAnyPattern(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German Steuernummer does not match any \" +\n        \"known state format\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\n/**\n * Format with slashes at segment boundaries.\n * Uses the first matching state pattern to determine\n * segment positions.\n */\nconst format = (value: string): string => {\n  const v = compact(value);\n\n  for (const entry of COMPILED) {\n    const pattern =\n      v.length === 13 ? entry.federal : entry.regional;\n    if (!pattern.test(v)) continue;\n\n    const fmt =\n      v.length === 13\n        ? entry.federalFmt\n        : entry.regionalFmt;\n\n    // Group by consecutive runs of the same letter\n    // category: literal digits, F, B, U, P\n    const segments: string[] = [];\n    let segStart = 0;\n    // SAFETY: fmt is a non-empty literal from COMPILED.\n    // eslint-disable-next-line no-non-null-assertion\n    let prevCat = charCat(fmt[0]!);\n\n    for (let i = 1; i < fmt.length; i++) {\n      // SAFETY: i < fmt.length.\n      // eslint-disable-next-line no-non-null-assertion\n      const cat = charCat(fmt[i]!);\n      if (cat !== prevCat) {\n        segments.push(v.slice(segStart, i));\n        segStart = i;\n        prevCat = cat;\n      }\n    }\n    segments.push(v.slice(segStart));\n\n    return segments.join(\"/\");\n  }\n\n  return v;\n};\n\nconst charCat = (ch: string): string => {\n  if (ch >= \"0\" && ch <= \"9\") return \"L\"; // literal\n  return ch; // F, B, U, P\n};\n\n/** German Tax Number (Steuernummer). */\nconst stnr: CountryValidator<\"DE\"> = {\n  name: \"German Tax Number\",\n  localName: \"Steuernummer\",\n  abbreviation: \"StNr\",\n  aliases: [\"Steuernummer\", \"St.Nr.\"] as const,\n  candidatePattern: \"\\\\d{2,4}/\\\\d{3,4}/\\\\d{4,5}\",\n  scope: \"country\",\n  country: \"DE\",\n  entityType: \"any\",\n  description:\n    \"German tax number assigned by the local \" +\n    \"tax office, varies by federal state\",\n  sourceUrl: \"https://de.wikipedia.org/wiki/Steuernummer\",\n  lengths: [10, 11, 13] as const,\n  examples: [\"2181508150\", \"18181508155\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default stnr;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}

package/dist/de/svnr.d.ts

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

package/dist/de/svnr.js

@@ -1,18 +1,8 @@
 import { clean } from "../_util/clean.js";
+import { isValidDate, resolveTwoDigitYear } from "../_util/date.js";
 import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
-import { isValidDate, resolveTwoDigitYear } from "../_util/date.js";
 //#region src/de/svnr.ts
-/**
-* SVNR (Sozialversicherungsnummer).
-*
-* German social insurance number. 12 characters:
-* area number (2 digits) + date of birth (DDMMYY)
-* + initial letter of birth name (1 letter) +
-* serial number (2 digits) + check digit (1 digit).
-*
-* @see https://de.wikipedia.org/wiki/Sozialversicherungsnummer
-*/
 const letterValue = (ch) => {
 	const code = ch.charCodeAt(0);
 	if (code >= 65 && code <= 90) return code - 64;
@@ -91,6 +81,7 @@ const svnr = {
 		"Versicherungsnummer"
 	],
 	candidatePattern: "\\d{2}\\s?\\d{6}\\s?[A-Z]\\s?\\d{3}",
+	scope: "country",
 	country: "DE",
 	entityType: "person",
 	description: "German social insurance number encoding birth date and name initial",

package/dist/de/svnr.js.map

@@ -1 +1 @@
-{"version":3,"file":"svnr.js","names":[],"sources":["../../src/de/svnr.ts"],"sourcesContent":["/**\n * SVNR (Sozialversicherungsnummer).\n *\n * German social insurance number. 12 characters:\n * area number (2 digits) + date of birth (DDMMYY)\n * + initial letter of birth name (1 letter) +\n * serial number (2 digits) + check digit (1 digit).\n *\n * @see https://de.wikipedia.org/wiki/Sozialversicherungsnummer\n */\n\nimport { clean } from \"#util/clean\";\nimport {\n  isValidDate,\n  resolveTwoDigitYear,\n} from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst letterValue = (ch: string): number => {\n  const code = ch.charCodeAt(0);\n  if (code >= 65 && code <= 90) return code - 64;\n  return -1;\n};\n\nconst WEIGHTS = [\n  2, 1, 2, 5, 7, 1, 2, 1, 2, 1, 2, 1,\n] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -/\").toUpperCase();\n\nconst computeCheck = (v: string): number => {\n  const digits: number[] = [];\n\n  for (let i = 0; i < 8; i++) {\n    digits.push(Number(v[i]));\n  }\n\n  // SAFETY: caller guarantees v.length === 12.\n  // eslint-disable-next-line no-non-null-assertion\n  const lv = letterValue(v[8]!);\n  digits.push(Math.floor(lv / 10));\n  digits.push(lv % 10);\n\n  digits.push(Number(v[9]));\n  digits.push(Number(v[10]));\n\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    // SAFETY: WEIGHTS.length === 12 and we just pushed\n    // 12 entries onto `digits`.\n    // eslint-disable-next-line no-non-null-assertion\n    const product = digits[i]! * weight;\n    if (product >= 10) {\n      sum += Math.floor(product / 10) + (product % 10);\n    } else {\n      sum += product;\n    }\n  }\n\n  return sum % 10;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"German SVNR must be 12 characters\",\n    );\n  }\n\n  if (!/^\\d{8}[A-Z]\\d{3}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"German SVNR must be 8 digits, 1 letter, \" +\n        \"3 digits\",\n    );\n  }\n\n  const dd = Number(v.slice(2, 4));\n  const mm = Number(v.slice(4, 6));\n  const yy = Number(v.slice(6, 8));\n\n  const year = resolveTwoDigitYear(yy);\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German SVNR contains an invalid birth date\",\n    );\n  }\n\n  const expected = computeCheck(v);\n  const actual = Number(v[11]);\n\n  if (expected !== actual) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"German SVNR check digit mismatch\",\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, 8)}` +\n    ` ${v.slice(8, 9)} ${v.slice(9, 11)}` +\n    ` ${v.slice(11)}`\n  );\n};\n\n/** Generate a random valid German SVNR. */\nconst generate = (): string => {\n  for (;;) {\n    const area = String(randomInt(1, 99)).padStart(2, \"0\");\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(40, 99)).padStart(2, \"0\");\n    const letter = String.fromCharCode(\n      65 + randomInt(0, 25),\n    );\n    const serial = String(randomInt(0, 49)).padStart(\n      2,\n      \"0\",\n    );\n    const partial = area + dd + mm + yy + letter + serial;\n    const c = partial + String(computeCheck(partial));\n    if (validate(c).valid) return c;\n  }\n};\n\n/** German Social Insurance Number. */\nconst svnr: Validator = {\n  name: \"German Social Insurance Number\",\n  localName: \"Sozialversicherungsnummer\",\n  abbreviation: \"SVNR\",\n  aliases: [\n    \"Sozialversicherungsnummer\",\n    \"SVNR\",\n    \"Versicherungsnummer\",\n  ] as const,\n  candidatePattern: \"\\\\d{2}\\\\s?\\\\d{6}\\\\s?[A-Z]\\\\s?\\\\d{3}\",\n  country: \"DE\",\n  entityType: \"person\",\n  description:\n    \"German social insurance number encoding \" +\n    \"birth date and name initial\",\n  sourceUrl:\n    \"https://de.wikipedia.org/wiki/\" +\n    \"Sozialversicherungsnummer\",\n  lengths: [12] as const,\n  examples: [\"12010188M011\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default svnr;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"svnr.js","names":[],"sources":["../../src/de/svnr.ts"],"sourcesContent":["/**\n * SVNR (Sozialversicherungsnummer).\n *\n * German social insurance number. 12 characters:\n * area number (2 digits) + date of birth (DDMMYY)\n * + initial letter of birth name (1 letter) +\n * serial number (2 digits) + check digit (1 digit).\n *\n * @see https://de.wikipedia.org/wiki/Sozialversicherungsnummer\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport {\n  isValidDate,\n  resolveTwoDigitYear,\n} from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst letterValue = (ch: string): number => {\n  const code = ch.charCodeAt(0);\n  if (code >= 65 && code <= 90) return code - 64;\n  return -1;\n};\n\nconst WEIGHTS = [\n  2, 1, 2, 5, 7, 1, 2, 1, 2, 1, 2, 1,\n] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -/\").toUpperCase();\n\nconst computeCheck = (v: string): number => {\n  const digits: number[] = [];\n\n  for (let i = 0; i < 8; i++) {\n    digits.push(Number(v[i]));\n  }\n\n  // SAFETY: caller guarantees v.length === 12.\n  // eslint-disable-next-line no-non-null-assertion\n  const lv = letterValue(v[8]!);\n  digits.push(Math.floor(lv / 10));\n  digits.push(lv % 10);\n\n  digits.push(Number(v[9]));\n  digits.push(Number(v[10]));\n\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    // SAFETY: WEIGHTS.length === 12 and we just pushed\n    // 12 entries onto `digits`.\n    // eslint-disable-next-line no-non-null-assertion\n    const product = digits[i]! * weight;\n    if (product >= 10) {\n      sum += Math.floor(product / 10) + (product % 10);\n    } else {\n      sum += product;\n    }\n  }\n\n  return sum % 10;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"German SVNR must be 12 characters\",\n    );\n  }\n\n  if (!/^\\d{8}[A-Z]\\d{3}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"German SVNR must be 8 digits, 1 letter, \" +\n        \"3 digits\",\n    );\n  }\n\n  const dd = Number(v.slice(2, 4));\n  const mm = Number(v.slice(4, 6));\n  const yy = Number(v.slice(6, 8));\n\n  const year = resolveTwoDigitYear(yy);\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"German SVNR contains an invalid birth date\",\n    );\n  }\n\n  const expected = computeCheck(v);\n  const actual = Number(v[11]);\n\n  if (expected !== actual) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"German SVNR check digit mismatch\",\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, 8)}` +\n    ` ${v.slice(8, 9)} ${v.slice(9, 11)}` +\n    ` ${v.slice(11)}`\n  );\n};\n\n/** Generate a random valid German SVNR. */\nconst generate = (): string => {\n  for (;;) {\n    const area = String(randomInt(1, 99)).padStart(2, \"0\");\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(40, 99)).padStart(2, \"0\");\n    const letter = String.fromCharCode(\n      65 + randomInt(0, 25),\n    );\n    const serial = String(randomInt(0, 49)).padStart(\n      2,\n      \"0\",\n    );\n    const partial = area + dd + mm + yy + letter + serial;\n    const c = partial + String(computeCheck(partial));\n    if (validate(c).valid) return c;\n  }\n};\n\n/** German Social Insurance Number. */\nconst svnr: CountryValidator<\"DE\"> = {\n  name: \"German Social Insurance Number\",\n  localName: \"Sozialversicherungsnummer\",\n  abbreviation: \"SVNR\",\n  aliases: [\n    \"Sozialversicherungsnummer\",\n    \"SVNR\",\n    \"Versicherungsnummer\",\n  ] as const,\n  candidatePattern: \"\\\\d{2}\\\\s?\\\\d{6}\\\\s?[A-Z]\\\\s?\\\\d{3}\",\n  scope: \"country\",\n  country: \"DE\",\n  entityType: \"person\",\n  description:\n    \"German social insurance number encoding \" +\n    \"birth date and name initial\",\n  sourceUrl:\n    \"https://de.wikipedia.org/wiki/\" +\n    \"Sozialversicherungsnummer\",\n  lengths: [12] as const,\n  examples: [\"12010188M011\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default svnr;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}

package/dist/de/vat.d.ts

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