@stll/stdnum 0.0.1 → 2.0.0

package/dist/sk/dic.js.map

@@ -1 +1 @@
-{"version":3,"file":"dic.js","names":["validateRc"],"sources":["../../src/sk/dic.ts"],"sourcesContent":["/**\n * IČ DPH (Identifikačné číslo pre daň z\n * pridanej hodnoty).\n *\n * Slovak VAT number. Format: \"SK\" + 10 digits.\n * The 10-digit number must be divisible by 11.\n * First digit is 1-9.\n *\n * @see https://www.financnasprava.sk/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport { validate as validateRc } from \"../cz/rc\";\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string => {\n  const v = clean(value, \" -\");\n  if (v.startsWith(\"SK\") || v.startsWith(\"sk\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Slovak VAT number must be 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Slovak VAT number must contain only digits\",\n    );\n  }\n  // A valid birth number is also accepted as DPH\n  if (validateRc(v).valid) {\n    return { valid: true, compact: v };\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Slovak VAT number cannot start with 0\",\n    );\n  }\n  // Third digit must be 2, 3, 4, 7, 8, or 9\n  const d3 = Number(v[2]);\n  if (\n    d3 !== 2 &&\n    d3 !== 3 &&\n    d3 !== 4 &&\n    d3 !== 7 &&\n    d3 !== 8 &&\n    d3 !== 9\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Slovak VAT number has invalid third digit\",\n    );\n  }\n  if (Number(v) % 11 !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Slovak VAT number is not divisible by 11\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `SK${compact(value)}`;\n\n/** Generate a random valid Slovak DIČ. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Slovak VAT Number. */\nconst dic: Validator = {\n  name: \"Slovak VAT Number\",\n  localName:\n    \"Identifikačné číslo pre daň z pridanej hodnoty\",\n  abbreviation: \"IČ DPH\",\n  aliases: [\"DIČ\", \"daňové identifikačné číslo\"] as const,\n  candidatePattern: \"SK\\\\d{10}\",\n  country: \"SK\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.financnasprava.sk/\",\n  examples: [\"2021853504\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,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,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,6CACD;AAGH,KAAIA,WAAW,EAAE,CAAC,MAChB,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAEpC,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,wCACD;CAGH,MAAM,KAAK,OAAO,EAAE,GAAG;AACvB,KACE,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,EAEP,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,OAAO,EAAE,GAAG,OAAO,EACrB,QAAO,IACL,oBACA,2CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,GAAG;AAC1B,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,OAAO,6BAA6B;CAC9C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"dic.js","names":["validateRc"],"sources":["../../src/sk/dic.ts"],"sourcesContent":["/**\n * IČ DPH (Identifikačné číslo pre daň z\n * pridanej hodnoty).\n *\n * Slovak VAT number. Format: \"SK\" + 10 digits.\n * The 10-digit number must be divisible by 11.\n * First digit is 1-9.\n *\n * @see https://www.financnasprava.sk/\n */\n\nimport { validate as validateRc } from \"../cz/rc\";\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  const v = clean(value, \" -\");\n  if (v.startsWith(\"SK\") || v.startsWith(\"sk\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Slovak VAT number must be 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Slovak VAT number must contain only digits\",\n    );\n  }\n  // A valid birth number is also accepted as DPH\n  if (validateRc(v).valid) {\n    return { valid: true, compact: v };\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Slovak VAT number cannot start with 0\",\n    );\n  }\n  // Third digit must be 2, 3, 4, 7, 8, or 9\n  const d3 = Number(v[2]);\n  if (\n    d3 !== 2 &&\n    d3 !== 3 &&\n    d3 !== 4 &&\n    d3 !== 7 &&\n    d3 !== 8 &&\n    d3 !== 9\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Slovak VAT number has invalid third digit\",\n    );\n  }\n  if (Number(v) % 11 !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Slovak VAT number is not divisible by 11\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `SK${compact(value)}`;\n\n/** Generate a random valid Slovak DIČ. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(10);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Slovak VAT Number. */\nconst dic: CountryValidator<\"SK\"> = {\n  name: \"Slovak VAT Number\",\n  localName:\n    \"Identifikačné číslo pre daň z pridanej hodnoty\",\n  abbreviation: \"IČ DPH\",\n  aliases: [\"DIČ\", \"daňové identifikačné číslo\"] as const,\n  candidatePattern: \"SK\\\\d{10}\",\n  scope: \"country\",\n  country: \"SK\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.financnasprava.sk/\",\n  examples: [\"2021853504\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,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,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,4CACF;CAGF,IAAIA,WAAW,CAAC,EAAE,OAChB,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;CAEnC,IAAI,EAAE,OAAO,KACX,OAAO,IACL,qBACA,uCACF;CAGF,MAAM,KAAK,OAAO,EAAE,EAAE;CACtB,IACE,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,GAEP,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,OAAO,CAAC,IAAI,OAAO,GACrB,OAAO,IACL,oBACA,0CACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;;AAGpB,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,EAAE;EACzB,IAAI,SAAS,CAAC,EAAE,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,OAAO,4BAA4B;CAC7C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/sk/ico.d.ts

@@ -1,10 +1,9 @@
-import { Validator } from "../types.js";
+import { CountryValidator } from "../types.js";
 import { compact, format, generate, validate } from "../cz/ico.js";
 
 //#region src/sk/ico.d.ts
-
 /** Slovak Company Identification Number. */
-declare const ico: Validator;
+declare const ico: CountryValidator<"SK">;
 //#endregion
 export { compact, ico as default, format, generate, validate };
 //# sourceMappingURL=ico.d.ts.map

package/dist/sk/ico.js

@@ -15,6 +15,7 @@ const ico = {
 	abbreviation: "IČO",
 	aliases: ["IČO", "identifikačné číslo organizácie"],
 	candidatePattern: "\\d{8}",
+	scope: "country",
 	country: "SK",
 	entityType: "company",
 	sourceUrl: "https://www.statistics.sk/",

package/dist/sk/ico.js.map

@@ -1 +1 @@
-{"version":3,"file":"ico.js","names":[],"sources":["../../src/sk/ico.ts"],"sourcesContent":["/**\n * IČO (Identifikačné číslo organizácie).\n *\n * Slovak company identification number. Same\n * 8-digit weighted checksum as the Czech IČO.\n *\n * @see https://www.statistics.sk/\n */\n\nimport {\n  compact,\n  format,\n  generate,\n  validate,\n} from \"../cz/ico\";\nimport type { Validator } from \"../types\";\n\n/** Slovak Company Identification Number. */\nconst ico: Validator = {\n  name: \"Slovak Company ID\",\n  localName: \"Identifikačné číslo organizácie\",\n  abbreviation: \"IČO\",\n  aliases: [\n    \"IČO\",\n    \"identifikačné číslo organizácie\",\n  ] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"SK\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.statistics.sk/\",\n  examples: [\"25123891\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ico;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;AAkBA,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,kCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ico.js","names":[],"sources":["../../src/sk/ico.ts"],"sourcesContent":["/**\n * IČO (Identifikačné číslo organizácie).\n *\n * Slovak company identification number. Same\n * 8-digit weighted checksum as the Czech IČO.\n *\n * @see https://www.statistics.sk/\n */\n\nimport {\n  compact,\n  format,\n  generate,\n  validate,\n} from \"../cz/ico\";\nimport type { CountryValidator } from \"../types\";\n\n/** Slovak Company Identification Number. */\nconst ico: CountryValidator<\"SK\"> = {\n  name: \"Slovak Company ID\",\n  localName: \"Identifikačné číslo organizácie\",\n  abbreviation: \"IČO\",\n  aliases: [\n    \"IČO\",\n    \"identifikačné číslo organizácie\",\n  ] as const,\n  candidatePattern: \"\\\\d{8}\",\n  scope: \"country\",\n  country: \"SK\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.statistics.sk/\",\n  examples: [\"25123891\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ico;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;AAkBA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,iCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,UAAU;CACrB;CACA;CACA;CACA;AACF"}

package/dist/sk/mod.d.ts

@@ -1,10 +1,11 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import dic from "./dic.js";
 import ico from "./ico.js";
 import rc from "./rc.js";
 
 //#region src/sk/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { dic, ico, rc };
+}
 //#endregion
 export { dic, ico, mod_d_exports, rc };
 //# sourceMappingURL=mod.d.ts.map

package/dist/sk/rc.d.ts

@@ -1,10 +1,9 @@
-import { Validator } from "../types.js";
-import { compact, format, parse, validate } from "../cz/rc.js";
+import { CountryValidator, ParsedPersonId } from "../types.js";
+import { compact, format, generate, parse, validate } from "../cz/rc.js";
 
 //#region src/sk/rc.d.ts
-
 /** Slovak Birth Number. */
-declare const rc: Validator;
+declare const rc: CountryValidator<"SK", ParsedPersonId>;
 //#endregion
-export { compact, rc as default, format, parse, validate };
+export { compact, rc as default, format, generate, parse, validate };
 //# sourceMappingURL=rc.d.ts.map

package/dist/sk/rc.js

@@ -1,4 +1,4 @@
-import { compact, format, parse, validate } from "../cz/rc.js";
+import { compact, format, generate, parse, validate } from "../cz/rc.js";
 //#region src/sk/rc.ts
 /**
 * RČ (Rodné číslo).
@@ -16,15 +16,19 @@ const rc = {
 	abbreviation: "RČ",
 	aliases: ["rodné číslo", "RČ"],
 	candidatePattern: "\\d{6}/\\d{3,4}",
+	scope: "country",
 	country: "SK",
 	entityType: "person",
 	sourceUrl: "https://www.minv.sk/",
+	lengths: [9, 10],
 	examples: ["7103192745"],
 	compact,
 	format,
+	generate,
+	parse,
 	validate
 };
 //#endregion
-export { compact, rc as default, format, parse, validate };
+export { compact, rc as default, format, generate, parse, validate };
 
 //# sourceMappingURL=rc.js.map

package/dist/sk/rc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rc.js","names":[],"sources":["../../src/sk/rc.ts"],"sourcesContent":["/**\n * RČ (Rodné číslo).\n *\n * Slovak birth number. Identical algorithm to\n * the Czech birth number.\n *\n * @see https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART\n * @see https://www.minv.sk/\n */\n\nimport { compact, format, parse, validate } from \"../cz/rc\";\nimport type { Validator } from \"../types\";\n\n/** Slovak Birth Number. */\nconst rc: Validator = {\n  name: \"Slovak Birth Number\",\n  localName: \"Rodné číslo\",\n  abbreviation: \"RČ\",\n  aliases: [\"rodné číslo\", \"RČ\"] as const,\n  candidatePattern: \"\\\\d{6}/\\\\d{3,4}\",\n  country: \"SK\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.minv.sk/\",\n  examples: [\"7103192745\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default rc;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;AAcA,MAAM,KAAgB;CACpB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,eAAe,KAAK;CAC9B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACD"}
+{"version":3,"file":"rc.js","names":[],"sources":["../../src/sk/rc.ts"],"sourcesContent":["/**\n * RČ (Rodné číslo).\n *\n * Slovak birth number. Identical algorithm to\n * the Czech birth number.\n *\n * @see https://www.mvcr.cz/mvcren/docDetail.aspx?docid=21975362&doctype=ART\n * @see https://www.minv.sk/\n */\n\nimport {\n  compact,\n  format,\n  generate,\n  parse,\n  validate,\n} from \"../cz/rc\";\nimport type {\n  ParsedPersonId,\n  CountryValidator,\n} from \"../types\";\n\n/** Slovak Birth Number. */\nconst rc: CountryValidator<\"SK\", ParsedPersonId> = {\n  name: \"Slovak Birth Number\",\n  localName: \"Rodné číslo\",\n  abbreviation: \"RČ\",\n  aliases: [\"rodné číslo\", \"RČ\"] as const,\n  candidatePattern: \"\\\\d{6}/\\\\d{3,4}\",\n  scope: \"country\",\n  country: \"SK\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.minv.sk/\",\n  lengths: [9, 10] as const,\n  examples: [\"7103192745\"] as const,\n  compact,\n  format,\n  generate,\n  parse,\n  validate,\n};\n\nexport default rc;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;;;;;;;AAuBA,MAAM,KAA6C;CACjD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,eAAe,IAAI;CAC7B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,SAAS,CAAC,GAAG,EAAE;CACf,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACA;AACF"}

package/dist/th/mod.d.ts

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

package/dist/th/tin.d.ts

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

package/dist/th/tin.js

@@ -3,17 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/th/tin.ts
-/**
-* TIN (Thai Tax Identification Number,
-* เลขประจำตัวผู้เสียภาษี).
-*
-* 13 digits. Individual TINs have first digit 1-8;
-* company TINs (MOA) start with 0. Both use a
-* weighted mod-11 check digit.
-*
-* @see https://www.rd.go.th/
-* @see https://en.wikipedia.org/wiki/Thai_identity_card
-*/
 const compact = (value) => clean(value, " -");
 const validate = (value) => {
 	const v = compact(value);
@@ -46,6 +35,7 @@ const tin = {
 	abbreviation: "TIN",
 	aliases: ["เลขประจำตัวผู้เสียภาษี", "TIN"],
 	candidatePattern: "\\d{13}",
+	scope: "country",
 	country: "TH",
 	entityType: "any",
 	description: "13-digit tax identifier for individuals and companies",

package/dist/th/tin.js.map

@@ -1 +1 @@
-{"version":3,"file":"tin.js","names":[],"sources":["../../src/th/tin.ts"],"sourcesContent":["/**\n * TIN (Thai Tax Identification Number,\n * เลขประจำตัวผู้เสียภาษี).\n *\n * 13 digits. Individual TINs have first digit 1-8;\n * company TINs (MOA) start with 0. Both use a\n * weighted mod-11 check digit.\n *\n * @see https://www.rd.go.th/\n * @see https://en.wikipedia.org/wiki/Thai_identity_card\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 !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"TIN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"TIN must contain only digits\",\n    );\n  }\n\n  // First digit: 1-8 for individuals, 0 for companies\n  const first = Number(v[0]);\n  if (first > 8) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"TIN first digit must be 0-8\",\n    );\n  }\n\n  // Mod-11 check digit (position 13)\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += Number(v[i]) * (13 - i);\n  }\n  const check = (11 - (sum % 11)) % 10;\n  if (check !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"TIN check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return (\n    `${v[0]} ${v.slice(1, 5)} ` +\n    `${v.slice(5, 10)} ${v.slice(10, 12)} ${v[12]}`\n  );\n};\n\n/** Generate a random valid Thai TIN. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(11);\n  let sum = 0;\n  for (let i = 0; i < 12; i++)\n    sum += (13 - i) * Number(payload[i]);\n  return payload + String((11 - (sum % 11)) % 10);\n};\n\n/** Thai Tax Identification Number. */\nconst tin: Validator = {\n  name: \"Thai Tax Identification Number\",\n  localName: \"เลขประจำตัวผู้เสียภาษี\",\n  abbreviation: \"TIN\",\n  aliases: [\"เลขประจำตัวผู้เสียภาษี\", \"TIN\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"TH\",\n  entityType: \"any\",\n  description:\n    \"13-digit tax identifier for individuals and companies\",\n  sourceUrl: \"https://www.rd.go.th/\",\n  lengths: [13] as const,\n  examples: [\"1101700230708\", \"3100600445015\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,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;AAKH,KADc,OAAO,EAAE,GAAG,GACd,EACV,QAAO,IACL,qBACA,8BACD;CAIH,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,QAAO,OAAO,EAAE,GAAG,IAAI,KAAK;AAG9B,MADe,KAAM,MAAM,MAAO,OACpB,OAAO,EAAE,IAAI,CACzB,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QACE,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GACtB,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;;;AAK9C,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,EAAE,CAAC,GACb,aAAa,GAAG;CACxC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,SAAQ,KAAK,KAAK,OAAO,QAAQ,GAAG;AACtC,QAAO,UAAU,QAAQ,KAAM,MAAM,MAAO,GAAG;;;AAIjD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,0BAA0B,MAAM;CAC1C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,iBAAiB,gBAAgB;CAC5C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"tin.js","names":[],"sources":["../../src/th/tin.ts"],"sourcesContent":["/**\n * TIN (Thai Tax Identification Number,\n * เลขประจำตัวผู้เสียภาษี).\n *\n * 13 digits. Individual TINs have first digit 1-8;\n * company TINs (MOA) start with 0. Both use a\n * weighted mod-11 check digit.\n *\n * @see https://www.rd.go.th/\n * @see https://en.wikipedia.org/wiki/Thai_identity_card\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 !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"TIN must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"TIN must contain only digits\",\n    );\n  }\n\n  // First digit: 1-8 for individuals, 0 for companies\n  const first = Number(v[0]);\n  if (first > 8) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"TIN first digit must be 0-8\",\n    );\n  }\n\n  // Mod-11 check digit (position 13)\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    sum += Number(v[i]) * (13 - i);\n  }\n  const check = (11 - (sum % 11)) % 10;\n  if (check !== Number(v[12])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"TIN check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return (\n    `${v[0]} ${v.slice(1, 5)} ` +\n    `${v.slice(5, 10)} ${v.slice(10, 12)} ${v[12]}`\n  );\n};\n\n/** Generate a random valid Thai TIN. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(11);\n  let sum = 0;\n  for (let i = 0; i < 12; i++)\n    sum += (13 - i) * Number(payload[i]);\n  return payload + String((11 - (sum % 11)) % 10);\n};\n\n/** Thai Tax Identification Number. */\nconst tin: CountryValidator<\"TH\"> = {\n  name: \"Thai Tax Identification Number\",\n  localName: \"เลขประจำตัวผู้เสียภาษี\",\n  abbreviation: \"TIN\",\n  aliases: [\"เลขประจำตัวผู้เสียภาษี\", \"TIN\"] as const,\n  candidatePattern: \"\\\\d{13}\",\n  scope: \"country\",\n  country: \"TH\",\n  entityType: \"any\",\n  description:\n    \"13-digit tax identifier for individuals and companies\",\n  sourceUrl: \"https://www.rd.go.th/\",\n  lengths: [13] as const,\n  examples: [\"1101700230708\", \"3100600445015\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tin;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;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;CAKF,IADc,OAAO,EAAE,EACf,IAAI,GACV,OAAO,IACL,qBACA,6BACF;CAIF,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,OAAO,OAAO,EAAE,EAAE,KAAK,KAAK;CAG9B,KADe,KAAM,MAAM,MAAO,OACpB,OAAO,EAAE,GAAG,GACxB,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OACE,GAAG,EAAE,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GACtB,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,GAAG,EAAE;AAE9C;;AAGA,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,CAAC,CACf,IAAI,aAAa,EAAE;CACvC,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KACtB,QAAQ,KAAK,KAAK,OAAO,QAAQ,EAAE;CACrC,OAAO,UAAU,QAAQ,KAAM,MAAM,MAAO,EAAE;AAChD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,0BAA0B,KAAK;CACzC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,iBAAiB,eAAe;CAC3C;CACA;CACA;CACA;AACF"}

package/dist/tr/mod.d.ts

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

package/dist/tr/tckimlik.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/tr/tckimlik.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 /** TR IDs are displayed without separators. */
@@ -9,7 +8,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Turkish T.C. Kimlik No. */
 declare const generate: () => string;
 /** Turkish Personal Identification Number. */
-declare const tckimlik: Validator;
+declare const tckimlik: CountryValidator<"TR">;
 //#endregion
 export { compact, tckimlik as default, format, generate, validate };
 //# sourceMappingURL=tckimlik.d.ts.map

package/dist/tr/tckimlik.js

@@ -3,26 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/tr/tckimlik.ts
-/**
-* T.C. Kimlik No.
-* (Türkiye Cumhuriyeti Kimlik Numarası,
-* Turkish personal identification number).
-*
-* 11-digit unique personal ID assigned to every
-* Turkish citizen by MERNİS (Merkezi Nüfus İdaresi
-* Sistemi). The first digit is never zero. The last
-* two digits are check digits.
-*
-* Check digit algorithm:
-*   Let A = sum of digits at odd positions (1,3,5,7,9)
-*   Let B = sum of digits at even positions (2,4,6,8)
-*   d10 = (7 * A - B) mod 10
-*   d11 = (d1 + d2 + ... + d10) mod 10
-*
-* @see https://tckimlik.nvi.gov.tr/
-* @see https://en.wikipedia.org/wiki/Turkish_Identification_Number
-* @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama
-*/
 const compact = (value) => clean(value, " -./");
 /**
 * Calculate the two check digits from the first
@@ -64,6 +44,7 @@ const tckimlik = {
 	abbreviation: "T.C. Kimlik",
 	aliases: ["TC Kimlik No", "T.C. Kimlik Numarası"],
 	candidatePattern: "[1-9]\\d{10}",
+	scope: "country",
 	country: "TR",
 	entityType: "person",
 	sourceUrl: "https://www.nvi.gov.tr/",

package/dist/tr/tckimlik.js.map

@@ -1 +1 @@
-{"version":3,"file":"tckimlik.js","names":[],"sources":["../../src/tr/tckimlik.ts"],"sourcesContent":["/**\n * T.C. Kimlik No.\n * (Türkiye Cumhuriyeti Kimlik Numarası,\n * Turkish personal identification number).\n *\n * 11-digit unique personal ID assigned to every\n * Turkish citizen by MERNİS (Merkezi Nüfus İdaresi\n * Sistemi). The first digit is never zero. The last\n * two digits are check digits.\n *\n * Check digit algorithm:\n *   Let A = sum of digits at odd positions (1,3,5,7,9)\n *   Let B = sum of digits at even positions (2,4,6,8)\n *   d10 = (7 * A - B) mod 10\n *   d11 = (d1 + d2 + ... + d10) mod 10\n *\n * @see https://tckimlik.nvi.gov.tr/\n * @see https://en.wikipedia.org/wiki/Turkish_Identification_Number\n * @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama\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\n/**\n * Calculate the two check digits from the first\n * nine digits of a T.C. Kimlik number.\n */\nconst calcCheckDigits = (number: string): string => {\n  let oddSum = 0;\n  let evenSum = 0;\n  for (let i = 0; i < 9; i++) {\n    const d = Number(number[i]);\n    if (i % 2 === 0) {\n      oddSum += d;\n    } else {\n      evenSum += d;\n    }\n  }\n  const d10 = (((7 * oddSum - evenSum) % 10) + 10) % 10;\n  const d11 = (oddSum + evenSum + d10) % 10;\n  return `${d10}${d11}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"T.C. Kimlik number must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"T.C. Kimlik number must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"T.C. Kimlik number cannot start with 0\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"T.C. Kimlik number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish T.C. Kimlik No. */\nconst generate = (): string => {\n  const payload = String(randomInt(1, 9)) + randomDigits(8);\n  return payload + calcCheckDigits(payload);\n};\n\n/** Turkish Personal Identification Number. */\nconst tckimlik: Validator = {\n  name: \"Turkish Personal ID\",\n  localName: \"T.C. Kimlik Numarası\",\n  abbreviation: \"T.C. Kimlik\",\n  aliases: [\n    \"TC Kimlik No\",\n    \"T.C. Kimlik Numarası\",\n  ] as const,\n  candidatePattern: \"[1-9]\\\\d{10}\",\n  country: \"TR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.nvi.gov.tr/\",\n  examples: [\"17291716060\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tckimlik;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;;;;;AAMtB,MAAM,mBAAmB,WAA2B;CAClD,IAAI,SAAS;CACb,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,GAAG;AAC3B,MAAI,IAAI,MAAM,EACZ,WAAU;MAEV,YAAW;;CAGf,MAAM,QAAS,IAAI,SAAS,WAAW,KAAM,MAAM;AAEnD,QAAO,GAAG,OADG,SAAS,UAAU,OAAO;;AAIzC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,yCACD;AAEH,KAAI,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CACnC,QAAO,IACL,oBACA,0CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,OAAO,UAAU,GAAG,EAAE,CAAC,GAAG,aAAa,EAAE;AACzD,QAAO,UAAU,gBAAgB,QAAQ;;;AAI3C,MAAM,WAAsB;CAC1B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,gBACA,uBACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,cAAc;CACzB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"tckimlik.js","names":[],"sources":["../../src/tr/tckimlik.ts"],"sourcesContent":["/**\n * T.C. Kimlik No.\n * (Türkiye Cumhuriyeti Kimlik Numarası,\n * Turkish personal identification number).\n *\n * 11-digit unique personal ID assigned to every\n * Turkish citizen by MERNİS (Merkezi Nüfus İdaresi\n * Sistemi). The first digit is never zero. The last\n * two digits are check digits.\n *\n * Check digit algorithm:\n *   Let A = sum of digits at odd positions (1,3,5,7,9)\n *   Let B = sum of digits at even positions (2,4,6,8)\n *   d10 = (7 * A - B) mod 10\n *   d11 = (d1 + d2 + ... + d10) mod 10\n *\n * @see https://tckimlik.nvi.gov.tr/\n * @see https://en.wikipedia.org/wiki/Turkish_Identification_Number\n * @see https://www.turkiye.gov.tr/nvi-tckn-dogrulama\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\n/**\n * Calculate the two check digits from the first\n * nine digits of a T.C. Kimlik number.\n */\nconst calcCheckDigits = (number: string): string => {\n  let oddSum = 0;\n  let evenSum = 0;\n  for (let i = 0; i < 9; i++) {\n    const d = Number(number[i]);\n    if (i % 2 === 0) {\n      oddSum += d;\n    } else {\n      evenSum += d;\n    }\n  }\n  const d10 = (((7 * oddSum - evenSum) % 10) + 10) % 10;\n  const d11 = (oddSum + evenSum + d10) % 10;\n  return `${d10}${d11}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"T.C. Kimlik number must be 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"T.C. Kimlik number must contain only digits\",\n    );\n  }\n  if (v[0] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"T.C. Kimlik number cannot start with 0\",\n    );\n  }\n  if (calcCheckDigits(v) !== v.slice(9)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"T.C. Kimlik number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish T.C. Kimlik No. */\nconst generate = (): string => {\n  const payload = String(randomInt(1, 9)) + randomDigits(8);\n  return payload + calcCheckDigits(payload);\n};\n\n/** Turkish Personal Identification Number. */\nconst tckimlik: CountryValidator<\"TR\"> = {\n  name: \"Turkish Personal ID\",\n  localName: \"T.C. Kimlik Numarası\",\n  abbreviation: \"T.C. Kimlik\",\n  aliases: [\n    \"TC Kimlik No\",\n    \"T.C. Kimlik Numarası\",\n  ] as const,\n  candidatePattern: \"[1-9]\\\\d{10}\",\n  scope: \"country\",\n  country: \"TR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.nvi.gov.tr/\",\n  examples: [\"17291716060\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default tckimlik;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AA+BA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;AAMrB,MAAM,mBAAmB,WAA2B;CAClD,IAAI,SAAS;CACb,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,EAAE;EAC1B,IAAI,IAAI,MAAM,GACZ,UAAU;OAEV,WAAW;CAEf;CACA,MAAM,QAAS,IAAI,SAAS,WAAW,KAAM,MAAM;CAEnD,OAAO,GAAG,OADG,SAAS,UAAU,OAAO;AAEzC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,sCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,6CACF;CAEF,IAAI,EAAE,OAAO,KACX,OAAO,IACL,qBACA,wCACF;CAEF,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,IACL,oBACA,yCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;AAGA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,OAAO,UAAU,GAAG,CAAC,CAAC,IAAI,aAAa,CAAC;CACxD,OAAO,UAAU,gBAAgB,OAAO;AAC1C;;AAGA,MAAM,WAAmC;CACvC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,gBACA,sBACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;AACF"}

package/dist/tr/vkn.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/tr/vkn.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 /** TR IDs are displayed without separators. */
@@ -9,7 +8,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Turkish VKN. */
 declare const generate: () => string;
 /** Turkish Tax Identification Number. */
-declare const vkn: Validator;
+declare const vkn: CountryValidator<"TR">;
 //#endregion
 export { compact, vkn as default, format, generate, validate };
 //# sourceMappingURL=vkn.d.ts.map

package/dist/tr/vkn.js

@@ -3,26 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/tr/vkn.ts
-/**
-* VKN (Vergi Kimlik Numarası, Turkish tax
-* identification number).
-*
-* 10-digit tax ID used for businesses in Turkey.
-* The last digit is a check digit.
-*
-* Check digit algorithm:
-*   For each of the first 9 digits (right to left,
-*   position i = 1..9):
-*     c1 = (digit + i) mod 10
-*     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if
-*          that result is 0
-*     sum += c2
-*   check = (10 - sum) mod 10
-*
-* @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama
-* @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn
-* @see https://www.gib.gov.tr/
-*/
 const compact = (value) => clean(value, " -./");
 /**
 * Calculate the check digit for the first 9 digits
@@ -64,6 +44,7 @@ const vkn = {
 	abbreviation: "VKN",
 	aliases: ["VKN", "Vergi Kimlik Numarası"],
 	candidatePattern: "\\d{10}",
+	scope: "country",
 	country: "TR",
 	entityType: "company",
 	sourceUrl: "https://www.gib.gov.tr/",

package/dist/tr/vkn.js.map

@@ -1 +1 @@
-{"version":3,"file":"vkn.js","names":[],"sources":["../../src/tr/vkn.ts"],"sourcesContent":["/**\n * VKN (Vergi Kimlik Numarası, Turkish tax\n * identification number).\n *\n * 10-digit tax ID used for businesses in Turkey.\n * The last digit is a check digit.\n *\n * Check digit algorithm:\n *   For each of the first 9 digits (right to left,\n *   position i = 1..9):\n *     c1 = (digit + i) mod 10\n *     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if\n *          that result is 0\n *     sum += c2\n *   check = (10 - sum) mod 10\n *\n * @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama\n * @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn\n * @see https://www.gib.gov.tr/\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 * Calculate the check digit for the first 9 digits\n * of a VKN.\n */\nconst calcCheckDigit = (number: string): string => {\n  let s = 0;\n  for (let i = 0; i < 9; i++) {\n    const pos = 9 - i; // position 1..9 from right\n    const c1 = (Number(number[i]) + pos) % 10;\n    if (c1 !== 0) {\n      const pow = 2 ** pos;\n      const c2 = (c1 * pow) % 9 || 9;\n      s += c2;\n    }\n  }\n  return String((10 - (s % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\"INVALID_LENGTH\", \"VKN must be 10 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"VKN must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"VKN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish VKN. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Turkish Tax Identification Number. */\nconst vkn: Validator = {\n  name: \"Turkish Tax ID\",\n  localName: \"Vergi Kimlik Numarası\",\n  abbreviation: \"VKN\",\n  aliases: [\"VKN\", \"Vergi Kimlik Numarası\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  country: \"TR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gib.gov.tr/\",\n  examples: [\"4540536920\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vkn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;;;;;AAMtB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,IAAI;AACR,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,MAAM,IAAI;EAChB,MAAM,MAAM,OAAO,OAAO,GAAG,GAAG,OAAO;AACvC,MAAI,OAAO,GAAG;GAEZ,MAAM,KAAM,KADA,KAAK,MACO,KAAK;AAC7B,QAAK;;;AAGT,QAAO,QAAQ,KAAM,IAAI,MAAO,GAAG;;AAGrC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,wBAAwB;AAEvD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAEH,KAAI,eAAe,EAAE,KAAK,EAAE,GAC1B,QAAO,IACL,oBACA,2BACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;;AAIpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;AAC/B,QAAO,UAAU,eAAe,QAAQ;;;AAI1C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,wBAAwB;CACzC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vkn.js","names":[],"sources":["../../src/tr/vkn.ts"],"sourcesContent":["/**\n * VKN (Vergi Kimlik Numarası, Turkish tax\n * identification number).\n *\n * 10-digit tax ID used for businesses in Turkey.\n * The last digit is a check digit.\n *\n * Check digit algorithm:\n *   For each of the first 9 digits (right to left,\n *   position i = 1..9):\n *     c1 = (digit + i) mod 10\n *     c2 = if c1 != 0: (c1 * 2^i) mod 9, or 9 if\n *          that result is 0\n *     sum += c2\n *   check = (10 - sum) mod 10\n *\n * @see https://www.turkiye.gov.tr/gib-intvrg-vergi-kimlik-numarasi-dogrulama\n * @see https://arthurdejong.org/python-stdnum/doc/1.17/stdnum.tr.vkn\n * @see https://www.gib.gov.tr/\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 * Calculate the check digit for the first 9 digits\n * of a VKN.\n */\nconst calcCheckDigit = (number: string): string => {\n  let s = 0;\n  for (let i = 0; i < 9; i++) {\n    const pos = 9 - i; // position 1..9 from right\n    const c1 = (Number(number[i]) + pos) % 10;\n    if (c1 !== 0) {\n      const pow = 2 ** pos;\n      const c2 = (c1 * pow) % 9 || 9;\n      s += c2;\n    }\n  }\n  return String((10 - (s % 10)) % 10);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\"INVALID_LENGTH\", \"VKN must be 10 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"VKN must contain only digits\",\n    );\n  }\n  if (calcCheckDigit(v) !== v[9]) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"VKN check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\n/** TR IDs are displayed without separators. */\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Turkish VKN. */\nconst generate = (): string => {\n  const payload = randomDigits(9);\n  return payload + calcCheckDigit(payload);\n};\n\n/** Turkish Tax Identification Number. */\nconst vkn: CountryValidator<\"TR\"> = {\n  name: \"Turkish Tax ID\",\n  localName: \"Vergi Kimlik Numarası\",\n  abbreviation: \"VKN\",\n  aliases: [\"VKN\", \"Vergi Kimlik Numarası\"] as const,\n  candidatePattern: \"\\\\d{10}\",\n  scope: \"country\",\n  country: \"TR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.gib.gov.tr/\",\n  examples: [\"4540536920\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vkn;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AA+BA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;AAMrB,MAAM,kBAAkB,WAA2B;CACjD,IAAI,IAAI;CACR,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,MAAM,IAAI;EAChB,MAAM,MAAM,OAAO,OAAO,EAAE,IAAI,OAAO;EACvC,IAAI,OAAO,GAAG;GAEZ,MAAM,KAAM,KADA,KAAK,MACO,KAAK;GAC7B,KAAK;EACP;CACF;CACA,OAAO,QAAQ,KAAM,IAAI,MAAO,EAAE;AACpC;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IAAI,kBAAkB,uBAAuB;CAEtD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAEF,IAAI,eAAe,CAAC,MAAM,EAAE,IAC1B,OAAO,IACL,oBACA,0BACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;;AAGA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,CAAC;CAC9B,OAAO,UAAU,eAAe,OAAO;AACzC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,uBAAuB;CACxC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/tw/mod.d.ts

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

package/dist/tw/ubn.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/tw/ubn.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid UBN. */
 declare const generate: () => string;
 /** Taiwanese Unified Business Number. */
-declare const ubn: Validator;
+declare const ubn: CountryValidator<"TW">;
 //#endregion
 export { compact, ubn as default, format, generate, validate };
 //# sourceMappingURL=ubn.d.ts.map

package/dist/tw/ubn.js

@@ -3,17 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/tw/ubn.ts
-/**
-* UBN (Unified Business Number, 統一編號).
-*
-* Taiwanese company identifier. 8 digits with a
-* weighted checksum. Weights [1,2,1,2,1,2,4,1];
-* sum the individual digits of each product, total
-* mod 10 must be 0. Special case: when the 7th digit
-* is 7, checksum 9 is also accepted.
-*
-* @see https://zh.wikipedia.org/wiki/統一編號
-*/
 const WEIGHTS = [
 	1,
 	2,
@@ -39,7 +28,7 @@ const validate = (value) => {
 	if (v.length !== 8) return err("INVALID_LENGTH", "UBN must be exactly 8 digits");
 	if (!isdigits(v)) return err("INVALID_FORMAT", "UBN must contain only digits");
 	let sum = 0;
-	for (let i = 0; i < 8; i++) sum += digitSum(Number(v[i]) * WEIGHTS[i]);
+	for (const [i, weight] of WEIGHTS.entries()) sum += digitSum(Number(v[i]) * weight);
 	const checksum = sum % 10;
 	if (checksum === 0) return {
 		valid: true,
@@ -69,6 +58,7 @@ const ubn = {
 	abbreviation: "UBN",
 	aliases: ["統一編號", "UBN"],
 	candidatePattern: "\\d{8}",
+	scope: "country",
 	country: "TW",
 	entityType: "company",
 	description: "8-digit company identifier issued by the Ministry of Economic Affairs",

package/dist/tw/ubn.js.map

@@ -1 +1 @@
-{"version":3,"file":"ubn.js","names":[],"sources":["../../src/tw/ubn.ts"],"sourcesContent":["/**\n * UBN (Unified Business Number, 統一編號).\n *\n * Taiwanese company identifier. 8 digits with a\n * weighted checksum. Weights [1,2,1,2,1,2,4,1];\n * sum the individual digits of each product, total\n * mod 10 must be 0. Special case: when the 7th digit\n * is 7, checksum 9 is also accepted.\n *\n * @see https://zh.wikipedia.org/wiki/統一編號\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 WEIGHTS = [1, 2, 1, 2, 1, 2, 4, 1] as const;\n\n/** Sum the individual digits of a number. */\nconst digitSum = (n: number): number => {\n  let sum = 0;\n  while (n > 0) {\n    sum += n % 10;\n    n = Math.floor(n / 10);\n  }\n  return sum;\n};\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      \"UBN must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UBN must contain only digits\",\n    );\n  }\n\n  let sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += digitSum(Number(v[i]) * WEIGHTS[i]!);\n  }\n\n  const checksum = sum % 10;\n  if (checksum === 0) {\n    return { valid: true, compact: v };\n  }\n\n  // Special case: when the 7th digit is 7 (product\n  // 4*7=28), the checksum may be 9 instead of 0.\n  if (checksum === 9 && v[6] === \"7\") {\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_CHECKSUM\",\n    \"UBN checksum does not match\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid UBN. */\nconst generate = (): string => {\n  for (;;) {\n    const prefix = randomDigits(7);\n    for (let d = 0; d < 10; d++) {\n      const candidate = `${prefix}${d}`;\n      const r = validate(candidate);\n      if (r.valid) return candidate;\n    }\n  }\n};\n\n/** Taiwanese Unified Business Number. */\nconst ubn: Validator = {\n  name: \"Unified Business Number\",\n  localName: \"統一編號\",\n  abbreviation: \"UBN\",\n  aliases: [\"統一編號\", \"UBN\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"TW\",\n  entityType: \"company\",\n  description:\n    \"8-digit company identifier issued by the Ministry of Economic Affairs\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E7%B7%A8%E8%99%9F\",\n  lengths: [8] as const,\n  examples: [\"00501503\", \"04595257\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ubn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;AAGxC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;AACV,QAAO,IAAI,GAAG;AACZ,SAAO,IAAI;AACX,MAAI,KAAK,MAAM,IAAI,GAAG;;AAExB,QAAO;;AAGT,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,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,SAAS,OAAO,EAAE,GAAG,GAAG,QAAQ,GAAI;CAG7C,MAAM,WAAW,MAAM;AACvB,KAAI,aAAa,EACf,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAKpC,KAAI,aAAa,KAAK,EAAE,OAAO,IAC7B,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;AAGpC,QAAO,IACL,oBACA,8BACD;;AAGH,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,SAAS,aAAa,EAAE;AAC9B,OAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,YAAY,GAAG,SAAS;AAE9B,OADU,SAAS,UAAU,CACvB,MAAO,QAAO;;;;;AAM1B,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,MAAM;CACxB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,YAAY,WAAW;CAClC;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"ubn.js","names":[],"sources":["../../src/tw/ubn.ts"],"sourcesContent":["/**\n * UBN (Unified Business Number, 統一編號).\n *\n * Taiwanese company identifier. 8 digits with a\n * weighted checksum. Weights [1,2,1,2,1,2,4,1];\n * sum the individual digits of each product, total\n * mod 10 must be 0. Special case: when the 7th digit\n * is 7, checksum 9 is also accepted.\n *\n * @see https://zh.wikipedia.org/wiki/統一編號\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 WEIGHTS = [1, 2, 1, 2, 1, 2, 4, 1] as const;\n\n/** Sum the individual digits of a number. */\nconst digitSum = (n: number): number => {\n  let sum = 0;\n  while (n > 0) {\n    sum += n % 10;\n    n = Math.floor(n / 10);\n  }\n  return sum;\n};\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      \"UBN must be exactly 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"UBN must contain only digits\",\n    );\n  }\n\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += digitSum(Number(v[i]) * weight);\n  }\n\n  const checksum = sum % 10;\n  if (checksum === 0) {\n    return { valid: true, compact: v };\n  }\n\n  // Special case: when the 7th digit is 7 (product\n  // 4*7=28), the checksum may be 9 instead of 0.\n  if (checksum === 9 && v[6] === \"7\") {\n    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_CHECKSUM\",\n    \"UBN checksum does not match\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid UBN. */\nconst generate = (): string => {\n  for (;;) {\n    const prefix = randomDigits(7);\n    for (let d = 0; d < 10; d++) {\n      const candidate = `${prefix}${d}`;\n      const r = validate(candidate);\n      if (r.valid) return candidate;\n    }\n  }\n};\n\n/** Taiwanese Unified Business Number. */\nconst ubn: CountryValidator<\"TW\"> = {\n  name: \"Unified Business Number\",\n  localName: \"統一編號\",\n  abbreviation: \"UBN\",\n  aliases: [\"統一編號\", \"UBN\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  scope: \"country\",\n  country: \"TW\",\n  entityType: \"company\",\n  description:\n    \"8-digit company identifier issued by the Ministry of Economic Affairs\",\n  sourceUrl:\n    \"https://zh.wikipedia.org/wiki/%E7%B5%B1%E4%B8%80%E7%B7%A8%E8%99%9F\",\n  lengths: [8] as const,\n  examples: [\"00501503\", \"04595257\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ubn;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;AAsBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;AAGvC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;CACV,OAAO,IAAI,GAAG;EACZ,OAAO,IAAI;EACX,IAAI,KAAK,MAAM,IAAI,EAAE;CACvB;CACA,OAAO;AACT;AAEA,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,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GACxC,OAAO,SAAS,OAAO,EAAE,EAAE,IAAI,MAAM;CAGvC,MAAM,WAAW,MAAM;CACvB,IAAI,aAAa,GACf,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;CAKnC,IAAI,aAAa,KAAK,EAAE,OAAO,KAC7B,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;CAGnC,OAAO,IACL,oBACA,6BACF;AACF;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,SAAS,aAAa,CAAC;EAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,YAAY,GAAG,SAAS;GAE9B,IADU,SAAS,SACf,EAAE,OAAO,OAAO;EACtB;CACF;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,KAAK;CACvB,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,CAAC;CACX,UAAU,CAAC,YAAY,UAAU;CACjC;CACA;CACA;CACA;AACF"}

package/dist/types.d.ts

@@ -17,24 +17,39 @@ type ValidateResult = {
   error: StdnumError;
 };
 /**
- * Structured data extracted from a personal ID number.
- * Returned by `parse()` on validators that encode
- * birth date and gender.
+ * Structured data extracted from an identifier that
+ * encodes a birth date.
  */
-type ParsedPersonId = {
+type ParsedBirthDate = {
   birthDate: Date;
+};
+/**
+ * Structured data extracted from a personal ID number
+ * that also encodes gender.
+ */
+type ParsedPersonId = ParsedBirthDate & {
   gender: "male" | "female";
 };
-type Validator = {
-  /** English name. */
-  name: string;
-  /** Name in the local language. */
-  localName: string;
-  /** Common abbreviation (e.g. "IČO"). */
-  abbreviation: string;
-  /** Country this identifier belongs to. */
-  country?: CountryCode;
-  /** What kind of entity this identifies. */
+type ParsedIdentifier = ParsedBirthDate | ParsedPersonId;
+/**
+ * Whether an identifier is scoped to a single
+ * country (e.g. Czech IČO) or is cross-border by
+ * design (e.g. IBAN, ISIN, BIC, LEI, EU VAT).
+ *
+ * Modeled as a discriminated union so consumers
+ * can group, filter, and exhaustively switch
+ * without null-checking `country`.
+ */
+type ValidatorScope = {
+  scope: "country";
+  country: CountryCode;
+} | {
+  scope: "global";
+};
+type ValidatorBase<TParsed extends ParsedIdentifier | undefined = undefined> = {
+  /** English name. */name: string; /** Name in the local language. */
+  localName: string; /** Common abbreviation (e.g. "IČO"). */
+  abbreviation: string; /** What kind of entity this identifies. */
   entityType: "person" | "company" | "any";
   /**
    * Strip separators and normalize to a
@@ -51,12 +66,9 @@ type Validator = {
    * compact form on success, or an error
    * with a code and message on failure.
    */
-  validate: (value: string) => ValidateResult;
-  /** One-liner describing the identifier. */
-  description?: string;
-  /** URL to official authority or spec page. */
-  sourceUrl?: string;
-  /** Valid lengths of the compact form. */
+  validate: (value: string) => ValidateResult; /** One-liner describing the identifier. */
+  description?: string; /** URL to official authority or spec page. */
+  sourceUrl?: string; /** Valid lengths of the compact form. */
   lengths?: readonly number[];
   /**
    * Known-valid compact values. Useful as test
@@ -89,7 +101,30 @@ type Validator = {
    * passed to validate() for confirmation.
    */
   candidatePattern?: string;
+  /**
+   * Extract structured data (e.g. birth date,
+   * gender) from a known-valid identifier.
+   * Available on personal IDs that encode such
+   * data. Returns null if the input cannot be
+   * parsed.
+   *
+   * On the base `Validator` type this is optional
+   * with a widened return; narrow it by typing the
+   * validator as `Validator<ParsedPersonId>` etc.
+   */
+  parse?: (value: string) => ParsedIdentifier | null;
+} & ([TParsed] extends [undefined] ? unknown : {
+  parse: (value: string) => TParsed | null;
+});
+type CountryValidator<TCountry extends CountryCode = CountryCode, TParsed extends ParsedIdentifier | undefined = undefined> = ValidatorBase<TParsed> & {
+  scope: "country";
+  country: TCountry;
+};
+type GlobalValidator<TParsed extends ParsedIdentifier | undefined = undefined> = ValidatorBase<TParsed> & {
+  scope: "global";
 };
+type Validator<TParsed extends ParsedIdentifier | undefined = undefined> = CountryValidator<CountryCode, TParsed> | GlobalValidator<TParsed>;
+type ParsableValidator<TParsed extends ParsedIdentifier = ParsedIdentifier> = Validator<TParsed>;
 //#endregion
-export { CountryCode, ErrorCode, ParsedPersonId, StdnumError, ValidateResult, Validator };
+export { CountryCode, CountryValidator, ErrorCode, GlobalValidator, ParsableValidator, ParsedBirthDate, ParsedIdentifier, ParsedPersonId, StdnumError, ValidateResult, Validator, ValidatorScope };
 //# sourceMappingURL=types.d.ts.map

package/dist/ua/edrpou.d.ts

@@ -1,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ua/edrpou.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Generate a random valid Ukrainian EDRPOU. */
 declare const generate: () => string;
 /** Ukrainian Company Register Number. */
-declare const edrpou: Validator;
+declare const edrpou: CountryValidator<"UA">;
 //#endregion
 export { compact, edrpou as default, format, generate, validate };
 //# sourceMappingURL=edrpou.d.ts.map