@stll/stdnum 0.0.1 → 2.0.0

package/dist/cu/ni.d.ts

@@ -1,7 +1,6 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/cu/ni.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -10,12 +9,14 @@ declare const format: (value: string) => string;
  * Returns null if the value is not valid.
  */
 declare const parse: (value: string) => ParsedPersonId | null;
+/** Generate a random valid Cuban NI. */
+declare const generate: () => string;
 /**
  * Cuban identity card number (NI).
  *
  * Examples sourced from python-stdnum test suite.
  */
-declare const ni: Validator;
+declare const ni: CountryValidator<"CU", ParsedPersonId>;
 //#endregion
-export { compact, ni as default, format, parse, validate };
+export { compact, ni as default, format, generate, parse, validate };
 //# sourceMappingURL=ni.d.ts.map

package/dist/cu/ni.js

@@ -1,23 +1,8 @@
 import { clean } from "../_util/clean.js";
-import { err } from "../_util/result.js";
 import { isValidDate } from "../_util/date.js";
+import { randomDigits, randomInt } from "../_util/generate.js";
+import { err } from "../_util/result.js";
 //#region src/cu/ni.ts
-/**
-* NI (Número de Identidad, Cuban identity card number).
-*
-* 11 digits encoding birth date, century, sequence, and
-* gender. Structure: YYMMDDXNNNN where:
-*   - YYMMDD = birth date
-*   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)
-*   - NNNN = sequence (digit at position 9 encodes gender:
-*     even=male, odd=female)
-*
-* No check digit; validation is by date and format only.
-*
-* Ported from python-stdnum cu.ni module.
-*
-* @see https://www.ecured.cu/Carnet_de_Identidad
-*/
 const compact = (value) => clean(value, " -").trim();
 /**
 * Derive the full birth year from the two-digit year
@@ -60,6 +45,13 @@ const parse = (value) => {
 		gender
 	};
 };
+/** Generate a random valid Cuban NI. */
+const generate = () => {
+	const year = randomInt(1950, 2024);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	return `${String(year % 100).padStart(2, "0")}${month}${day}${year >= 2e3 ? String(randomInt(6, 8)) : String(randomInt(0, 5))}${randomDigits(4)}`;
+};
 /**
 * Cuban identity card number (NI).
 *
@@ -75,16 +67,19 @@ const ni = {
 		"carnet de identidad"
 	],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "CU",
 	entityType: "person",
 	lengths: [11],
 	examples: ["91021027775", "72062506561"],
 	compact,
 	format,
+	parse,
 	validate,
+	generate,
 	sourceUrl: "https://www.ecured.cu/Carnet_de_Identidad"
 };
 //#endregion
-export { compact, ni as default, format, parse, validate };
+export { compact, ni as default, format, generate, parse, validate };
 
 //# sourceMappingURL=ni.js.map

package/dist/cu/ni.js.map

@@ -1 +1 @@
-{"version":3,"file":"ni.js","names":[],"sources":["../../src/cu/ni.ts"],"sourcesContent":["/**\n * NI (Número de Identidad, Cuban identity card number).\n *\n * 11 digits encoding birth date, century, sequence, and\n * gender. Structure: YYMMDDXNNNN where:\n *   - YYMMDD = birth date\n *   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)\n *   - NNNN = sequence (digit at position 9 encodes gender:\n *     even=male, odd=female)\n *\n * No check digit; validation is by date and format only.\n *\n * Ported from python-stdnum cu.ni module.\n *\n * @see https://www.ecured.cu/Carnet_de_Identidad\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Derive the full birth year from the two-digit year\n * and the century indicator at position 6.\n */\nconst centuryOffset = (digit: string): number => {\n  if (digit === \"9\") return 1800;\n  if (digit >= \"0\" && digit <= \"5\") return 1900;\n  return 2000;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cuban NI must be 11 digits\",\n    );\n  }\n\n  if (!/^\\d{11}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cuban NI 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  const year = centuryOffset(v[6]!) + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cuban NI contains an invalid birth date\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a Cuban NI.\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  const year = centuryOffset(v[6]!) + yy;\n\n  const genderDigit = Number(v[9]);\n  const gender: \"male\" | \"female\" =\n    genderDigit % 2 === 0 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/**\n * Cuban identity card number (NI).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst ni: Validator = {\n  name: \"Cuban Identity Card Number\",\n  localName: \"Número de Identidad\",\n  abbreviation: \"NI\",\n  aliases: [\n    \"NI\",\n    \"número de identidad\",\n    \"carnet de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"CU\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"91021027775\", \"72062506561\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.ecured.cu/Carnet_de_Identidad\",\n};\n\nexport default ni;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;;;;;AAM3B,MAAM,iBAAiB,UAA0B;AAC/C,KAAI,UAAU,IAAK,QAAO;AAC1B,KAAI,SAAS,OAAO,SAAS,IAAK,QAAO;AACzC,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAGH,KAAI,CAAC,WAAW,KAAK,EAAE,CACrB,QAAO,IACL,kBACA,oCACD;CAGH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAGhC,KAAI,CAAC,YAFQ,cAAc,EAAE,GAAI,GAAG,IAEb,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,OAAO,cAAc,EAAE,GAAI,GAAG;CAGpC,MAAM,SADc,OAAO,EAAE,GAAG,GAEhB,MAAM,IAAI,SAAS;AAEnC,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;;;;;;AAQH,MAAM,KAAgB;CACpB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe,cAAc;CACxC;CACA;CACA;CACA,WAAW;CACZ"}
+{"version":3,"file":"ni.js","names":[],"sources":["../../src/cu/ni.ts"],"sourcesContent":["/**\n * NI (Número de Identidad, Cuban identity card number).\n *\n * 11 digits encoding birth date, century, sequence, and\n * gender. Structure: YYMMDDXNNNN where:\n *   - YYMMDD = birth date\n *   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)\n *   - NNNN = sequence (digit at position 9 encodes gender:\n *     even=male, odd=female)\n *\n * No check digit; validation is by date and format only.\n *\n * Ported from python-stdnum cu.ni module.\n *\n * @see https://www.ecured.cu/Carnet_de_Identidad\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Derive the full birth year from the two-digit year\n * and the century indicator at position 6.\n */\nconst centuryOffset = (digit: string): number => {\n  if (digit === \"9\") return 1800;\n  if (digit >= \"0\" && digit <= \"5\") return 1900;\n  return 2000;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cuban NI must be 11 digits\",\n    );\n  }\n\n  if (!/^\\d{11}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cuban NI 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  // SAFETY: regex check above guarantees v.length === 11.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = centuryOffset(v[6]!) + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cuban NI contains an invalid birth date\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from a Cuban NI.\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  // SAFETY: regex check above guarantees v.length === 11.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = centuryOffset(v[6]!) + yy;\n\n  const genderDigit = Number(v[9]);\n  const gender: \"male\" | \"female\" =\n    genderDigit % 2 === 0 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/** Generate a random valid Cuban NI. */\nconst generate = (): string => {\n  const year = randomInt(1950, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const century =\n    year >= 2000\n      ? String(randomInt(6, 8))\n      : String(randomInt(0, 5));\n  return `${yy}${month}${day}${century}${randomDigits(4)}`;\n};\n\n/**\n * Cuban identity card number (NI).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst ni: CountryValidator<\"CU\", ParsedPersonId> = {\n  name: \"Cuban Identity Card Number\",\n  localName: \"Número de Identidad\",\n  abbreviation: \"NI\",\n  aliases: [\n    \"NI\",\n    \"número de identidad\",\n    \"carnet de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  scope: \"country\",\n  country: \"CU\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"91021027775\", \"72062506561\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n  sourceUrl: \"https://www.ecured.cu/Carnet_de_Identidad\",\n};\n\nexport default ni;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;AA4BA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI,EAAE,KAAK;;;;;AAM1B,MAAM,iBAAiB,UAA0B;CAC/C,IAAI,UAAU,KAAK,OAAO;CAC1B,IAAI,SAAS,OAAO,SAAS,KAAK,OAAO;CACzC,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,4BACF;CAGF,IAAI,CAAC,WAAW,KAAK,CAAC,GACpB,OAAO,IACL,kBACA,mCACF;CAGF,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAK/B,IAAI,CAAC,YAFQ,cAAc,EAAE,EAAG,IAAI,IAEb,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,yCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;;;;AAMvD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAG/B,MAAM,OAAO,cAAc,EAAE,EAAG,IAAI;CAGpC,MAAM,SADc,OAAO,EAAE,EAEjB,IAAI,MAAM,IAAI,SAAS;CAEnC,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE;EACpC;CACF;AACF;;AAGA,MAAM,iBAAyB;CAC7B,MAAM,OAAO,UAAU,MAAM,IAAI;CACjC,MAAM,QAAQ,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;CACtD,MAAM,MAAM,OAAO,UAAU,GAAG,EAAE,CAAC,EAAE,SAAS,GAAG,GAAG;CAMpD,OAAO,GALI,OAAO,OAAO,GAAG,EAAE,SAAS,GAAG,GAK/B,IAAI,QAAQ,MAHrB,QAAQ,MACJ,OAAO,UAAU,GAAG,CAAC,CAAC,IACtB,OAAO,UAAU,GAAG,CAAC,CAAC,IACW,aAAa,CAAC;AACvD;;;;;;AAOA,MAAM,KAA6C;CACjD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;CACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,eAAe,aAAa;CACvC;CACA;CACA;CACA;CACA;CACA,WAAW;AACb"}

package/dist/cy/mod.d.ts

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

package/dist/cy/vat.d.ts

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

package/dist/cy/vat.js

@@ -3,14 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/cy/vat.ts
-/**
-* ΦΠΑ (Cypriot VAT number).
-*
-* 8 digits + 1 check letter. Cannot start with "12".
-*
-* @see https://www.vatify.eu/cyprus-vat-number.html
-* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf
-*/
 const ODD_MAP = {
 	0: 1,
 	1: 0,
@@ -73,6 +65,7 @@ const vat = {
 	abbreviation: "ΦΠΑ",
 	aliases: ["ΦΠΑ", "VAT CY"],
 	candidatePattern: "CY\\d{8}[A-Z]",
+	scope: "country",
 	country: "CY",
 	entityType: "company",
 	sourceUrl: "https://www.mof.gov.cy/",

package/dist/cy/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/cy/vat.ts"],"sourcesContent":["/**\n * ΦΠΑ (Cypriot VAT number).\n *\n * 8 digits + 1 check letter. Cannot start with \"12\".\n *\n * @see https://www.vatify.eu/cyprus-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst ODD_MAP: Record<number, number> = {\n  0: 1,\n  1: 0,\n  2: 5,\n  3: 7,\n  4: 9,\n  5: 13,\n  6: 15,\n  7: 17,\n  8: 19,\n  9: 21,\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"CY\") || v.startsWith(\"cy\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cypriot VAT number must be 8 digits + 1 letter\",\n    );\n  }\n  const digits = v.slice(0, 8);\n  const checkLetter = v[8];\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must start with 8 digits\",\n    );\n  }\n  if (\n    checkLetter === undefined ||\n    !LETTERS.includes(checkLetter)\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must end with a letter\",\n    );\n  }\n  if (v.startsWith(\"12\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cypriot VAT number cannot start with 12\",\n    );\n  }\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 8; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd position (1-indexed: 1,3,5,7)\n      odd += ODD_MAP[d] ?? 0;\n    } else {\n      // Even position (1-indexed: 2,4,6,8)\n      even += d;\n    }\n  }\n  const expected = LETTERS.charAt((odd + even) % 26);\n  if (checkLetter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Cypriot VAT number check letter mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `CY${compact(value)}`;\n\n/** Generate a random valid Cypriot VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const digits = randomDigits(8);\n    if (digits.startsWith(\"12\")) continue;\n    let odd = 0;\n    let even = 0;\n    for (let i = 0; i < 8; i++) {\n      const d = Number(digits.charAt(i));\n      if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;\n      else even += d;\n    }\n    return digits + LETTERS.charAt((odd + even) % 26);\n  }\n};\n\n/** Cypriot VAT Number. */\nconst vat: Validator = {\n  name: \"Cypriot VAT Number\",\n  localName: \"Αριθμός Εγγραφής Φ.Π.Α.\",\n  abbreviation: \"ΦΠΑ\",\n  aliases: [\"ΦΠΑ\", \"VAT CY\"] as const,\n  candidatePattern: \"CY\\\\d{8}[A-Z]\",\n  country: \"CY\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.mof.gov.cy/\",\n  examples: [\"10259033P\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,UAAkC;CACtC,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,UAAU;AAEhB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,iDACD;CAEH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,cAAc,EAAE;AACtB,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,8CACD;AAEH,KACE,gBAAgB,KAAA,KAChB,CAAC,QAAQ,SAAS,YAAY,CAE9B,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,EAAE,WAAW,KAAK,CACpB,QAAO,IACL,qBACA,0CACD;CAEH,IAAI,MAAM;CACV,IAAI,OAAO;AACX,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,MAAI,IAAI,MAAM,EAEZ,QAAO,QAAQ,MAAM;MAGrB,SAAQ;;AAIZ,KAAI,gBADa,QAAQ,QAAQ,MAAM,QAAQ,GAAG,CAEhD,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,SAAS,aAAa,EAAE;AAC9B,MAAI,OAAO,WAAW,KAAK,CAAE;EAC7B,IAAI,MAAM;EACV,IAAI,OAAO;AACX,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;GAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,OAAI,IAAI,MAAM,EAAG,QAAO,QAAQ,MAAM;OACjC,SAAQ;;AAEf,SAAO,SAAS,QAAQ,QAAQ,MAAM,QAAQ,GAAG;;;;AAKrD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,SAAS;CAC1B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/cy/vat.ts"],"sourcesContent":["/**\n * ΦΠΑ (Cypriot VAT number).\n *\n * 8 digits + 1 check letter. Cannot start with \"12\".\n *\n * @see https://www.vatify.eu/cyprus-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst ODD_MAP: Record<number, number> = {\n  0: 1,\n  1: 0,\n  2: 5,\n  3: 7,\n  4: 9,\n  5: 13,\n  6: 15,\n  7: 17,\n  8: 19,\n  9: 21,\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"CY\") || v.startsWith(\"cy\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cypriot VAT number must be 8 digits + 1 letter\",\n    );\n  }\n  const digits = v.slice(0, 8);\n  const checkLetter = v[8];\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must start with 8 digits\",\n    );\n  }\n  if (\n    checkLetter === undefined ||\n    !LETTERS.includes(checkLetter)\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must end with a letter\",\n    );\n  }\n  if (v.startsWith(\"12\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cypriot VAT number cannot start with 12\",\n    );\n  }\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 8; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd position (1-indexed: 1,3,5,7)\n      odd += ODD_MAP[d] ?? 0;\n    } else {\n      // Even position (1-indexed: 2,4,6,8)\n      even += d;\n    }\n  }\n  const expected = LETTERS.charAt((odd + even) % 26);\n  if (checkLetter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Cypriot VAT number check letter mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `CY${compact(value)}`;\n\n/** Generate a random valid Cypriot VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const digits = randomDigits(8);\n    if (digits.startsWith(\"12\")) continue;\n    let odd = 0;\n    let even = 0;\n    for (let i = 0; i < 8; i++) {\n      const d = Number(digits.charAt(i));\n      if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;\n      else even += d;\n    }\n    return digits + LETTERS.charAt((odd + even) % 26);\n  }\n};\n\n/** Cypriot VAT Number. */\nconst vat: CountryValidator<\"CY\"> = {\n  name: \"Cypriot VAT Number\",\n  localName: \"Αριθμός Εγγραφής Φ.Π.Α.\",\n  abbreviation: \"ΦΠΑ\",\n  aliases: [\"ΦΠΑ\", \"VAT CY\"] as const,\n  candidatePattern: \"CY\\\\d{8}[A-Z]\",\n  scope: \"country\",\n  country: \"CY\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.mof.gov.cy/\",\n  examples: [\"10259033P\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAmBA,MAAM,UAAkC;CACtC,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;AAEA,MAAM,UAAU;AAEhB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,MAAM;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO,EAAE,YAAY;AACvB;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,GACf,OAAO,IACL,kBACA,gDACF;CAEF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,MAAM,cAAc,EAAE;CACtB,IAAI,CAAC,SAAS,MAAM,GAClB,OAAO,IACL,kBACA,6CACF;CAEF,IACE,gBAAgB,KAAA,KAChB,CAAC,QAAQ,SAAS,WAAW,GAE7B,OAAO,IACL,kBACA,2CACF;CAEF,IAAI,EAAE,WAAW,IAAI,GACnB,OAAO,IACL,qBACA,yCACF;CAEF,IAAI,MAAM;CACV,IAAI,OAAO;CACX,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC;EACjC,IAAI,IAAI,MAAM,GAEZ,OAAO,QAAQ,MAAM;OAGrB,QAAQ;CAEZ;CAEA,IAAI,gBADa,QAAQ,QAAQ,MAAM,QAAQ,EACpB,GACzB,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,SAAS,aAAa,CAAC;EAC7B,IAAI,OAAO,WAAW,IAAI,GAAG;EAC7B,IAAI,MAAM;EACV,IAAI,OAAO;EACX,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;GAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,CAAC,CAAC;GACjC,IAAI,IAAI,MAAM,GAAG,OAAO,QAAQ,MAAM;QACjC,QAAQ;EACf;EACA,OAAO,SAAS,QAAQ,QAAQ,MAAM,QAAQ,EAAE;CAClD;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,QAAQ;CACzB,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;AACF"}

package/dist/cz/dic.d.ts

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

package/dist/cz/dic.js

@@ -1,22 +1,10 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 import { validate as validate$1 } from "./rc.js";
 //#region src/cz/dic.ts
-/**
-* DIČ (Daňové identifikační číslo).
-*
-* Czech tax identification number / VAT number.
-* Format: "CZ" prefix + 8, 9, or 10 digits.
-* - 8 digits: company (same checksum as IČO,
-*   but first digit cannot be 9)
-* - 9 digits starting with 6: special entity
-* - 9-10 digits: individual (birth number)
-*
-* @see https://adisspr.mfcr.cz/dpr/DphReg
-*/
 const ICO_WEIGHTS = [
 	8,
 	7,
@@ -82,9 +70,15 @@ const dic = {
 	abbreviation: "DIČ",
 	aliases: ["DIČ", "daňové identifikační číslo"],
 	candidatePattern: "CZ\\d{8,10}",
+	scope: "country",
 	country: "CZ",
 	entityType: "any",
 	sourceUrl: "https://adisspr.mfcr.cz/dpr/DphReg",
+	lengths: [
+		8,
+		9,
+		10
+	],
 	examples: ["25123891", "7103192745"],
 	compact,
 	format,

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,14 +1,13 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/cz/ico.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 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/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/cz/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/cz/rc.d.ts

@@ -1,7 +1,6 @@
-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;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -16,7 +15,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
  */
 declare const generate: () => string;
 /** Czech/Slovak Birth Number. */
-declare const rc: Validator;
+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,25 +1,23 @@
 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. Since 2004,
-* an extra +20 offset is used when the serial
-* range is exhausted.
-*
-* @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 ? [
+		0,
+		50,
+		20,
+		70
+	] : [0, 50];
+	for (const offset of candidates) {
+		const month = rawMonth - offset;
+		if (month >= 1 && month <= 12) return month;
+	}
+	return null;
+};
 const validate = (value) => {
 	const v = compact(value);
 	if (v.length !== 9 && v.length !== 10) return err("INVALID_LENGTH", "Birth number must be 9 or 10 digits");
@@ -27,14 +25,14 @@ const validate = (value) => {
 	const yy = Number(v.slice(0, 2));
 	const mm = Number(v.slice(2, 4));
 	const dd = Number(v.slice(4, 6));
-	const month = mm % 50 % 20 || mm % 50;
-	if (month < 1 || month > 12) return err("INVALID_COMPONENT", "Birth number contains an invalid month");
-	if (dd < 1 || dd > 31) return err("INVALID_COMPONENT", "Birth number contains an invalid day");
 	let year = yy + 1900;
 	if (v.length === 9) {
 		if (year >= 1980) year -= 100;
 		if (year > 1953) return err("INVALID_COMPONENT", "9-digit birth numbers are pre-1954 only");
 	} else if (year < 1954) year += 100;
+	const month = decodeMonth(mm, year, v.length);
+	if (month === null) return err("INVALID_COMPONENT", "Birth number contains an invalid month");
+	if (dd < 1 || dd > 31) return err("INVALID_COMPONENT", "Birth number contains an invalid day");
 	if (!isValidDate(year, month, dd)) return err("INVALID_COMPONENT", "Birth number contains an invalid date");
 	if (v.length === 10) {
 		const check = Number(v.slice(0, 9)) % 11 % 10;
@@ -60,11 +58,12 @@ const parse = (value) => {
 	const yy = Number(v.slice(0, 2));
 	const mm = Number(v.slice(2, 4));
 	const dd = Number(v.slice(4, 6));
-	const gender = mm > 50 ? "female" : "male";
-	const month = mm % 50 % 20 || mm % 50;
+	const gender = mm >= 50 ? "female" : "male";
 	let year = yy + 1900;
 	if (v.length === 10 && year < 1954) year += 100;
 	if (v.length === 9 && year >= 1980) year -= 100;
+	const month = decodeMonth(mm, year, v.length);
+	if (month === null) return null;
 	return {
 		birthDate: new Date(year, month - 1, dd),
 		gender
@@ -99,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",
@@ -107,6 +107,7 @@ const rc = {
 	examples: ["7103192745"],
 	compact,
 	format,
+	parse,
 	validate,
 	generate
 };

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. Since 2004,\n * an extra +20 offset is used when the serial\n * range is exhausted.\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 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  // Strip gender (+50) and overflow (+20) offsets\n  const month = (mm % 50) % 20 || mm % 50;\n  if (month < 1 || month > 12) {\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  // 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  // 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  const month = (mm % 50) % 20 || mm % 50;\n\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  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 = {\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  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

@@ -1,34 +1,17 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.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",
+	"GNR",
+	"PR",
+	"VR"
+];
 /** Generate a random valid Handelsregisternummer. */
 const generate = () => {
-	const types = [
-		"HRA",
-		"HRB",
-		"GNR",
-		"PR",
-		"VR"
-	];
-	return `${types[randomInt(0, types.length - 1)]} ${randomDigits(5)}`;
+	return `${randomPick(GENERATE_TYPES)} ${randomDigits(5)}`;
 };
 const REGISTER_TYPES = new Set([
 	"HRA",
@@ -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)",