@stll/stdnum 0.0.1 → 1.0.0

package/dist/ec/ruc.js.map

@@ -1 +1 @@
-{"version":3,"file":"ruc.js","names":[],"sources":["../../src/ec/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyentes).\n *\n * Ecuadorian tax identification number. 13 digits:\n * - Digits 1-2: province code (01-24, 30, or 50)\n * - Digit 3: type indicator\n *   - 0-5: natural person (CI + establishment)\n *   - 6: public entity (or natural person fallback)\n *   - 9: juridical entity (public checksum first,\n *         then juridical fallback)\n *\n * Natural persons use a Luhn-like mod-10 checksum on\n * the first 10 digits. Public entities use a mod-11\n * checksum on the first 9 digits. Private companies\n * use a mod-11 checksum on the first 10 digits.\n *\n * @see https://www.sri.gob.ec/\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/** CI mod-10 checksum: weights [2,1,2,1,...], fold\n *  products > 9 by subtracting 9, sum mod 10 == 0. */\nconst ciChecksum = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < digits.length; i++) {\n    const weight = i % 2 === 0 ? 2 : 1;\n    let product = Number(digits[i]) * weight;\n    if (product > 9) product -= 9;\n    sum += product;\n  }\n  return sum % 10;\n};\n\n/** Weighted mod-11 checksum. */\nconst mod11Checksum = (\n  digits: string,\n  weights: readonly number[],\n): number => {\n  let sum = 0;\n  for (let i = 0; i < weights.length; i++) {\n    sum += Number(digits[i]) * weights[i]!;\n  }\n  return sum % 11;\n};\n\nconst PUBLIC_WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2, 1];\nconst JURIDICAL_WEIGHTS = [4, 3, 2, 7, 6, 5, 4, 3, 2, 1];\n\nconst isValidProvince = (v: string): boolean => {\n  const province = v.slice(0, 2);\n  return (\n    (province >= \"01\" && province <= \"24\") ||\n    province === \"30\" ||\n    province === \"50\"\n  );\n};\n\nconst validateNatural = (\n  v: string,\n): ValidateResult | null => {\n  if (v.slice(-3) === \"000\") return null;\n  if (ciChecksum(v.slice(0, 10)) !== 0) return null;\n  return { valid: true, compact: v };\n};\n\nconst validatePublic = (\n  v: string,\n): ValidateResult | null => {\n  if (v.slice(-4) === \"0000\") return null;\n  if (mod11Checksum(v, PUBLIC_WEIGHTS) !== 0) return null;\n  return { valid: true, compact: v };\n};\n\nconst validateJuridical = (\n  v: string,\n): ValidateResult | null => {\n  if (v.slice(-3) === \"000\") return null;\n  if (mod11Checksum(v, JURIDICAL_WEIGHTS) !== 0) {\n    return null;\n  }\n  return { valid: true, compact: v };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RUC must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUC must contain only digits\",\n    );\n  }\n  if (!isValidProvince(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUC province code is invalid\",\n    );\n  }\n\n  const typeDigit = Number(v[2]);\n\n  if (typeDigit <= 5) {\n    // Natural person\n    const result = validateNatural(v);\n    if (result) return result;\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  if (typeDigit === 6) {\n    // Public entity; fall back to natural person\n    const pub = validatePublic(v);\n    if (pub) return pub;\n    const nat = validateNatural(v);\n    if (nat) return nat;\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  if (typeDigit === 9) {\n    // Juridical RUC; try public checksum first, fall\n    // back to juridical (matches python-stdnum).\n    const pub = validatePublic(v);\n    if (pub) return pub;\n    const jur = validateJuridical(v);\n    if (jur) return jur;\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  return err(\n    \"INVALID_COMPONENT\",\n    \"RUC type digit is invalid\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Ecuadorian RUC. */\nconst generate = (): string => {\n  for (;;) {\n    const province = String(randomInt(1, 24)).padStart(\n      2,\n      \"0\",\n    );\n    const c = province + randomDigits(11);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ecuadorian tax identification number. */\nconst ruc: Validator = {\n  name: \"Registro Único de Contribuyentes\",\n  localName: \"Registro Único de Contribuyentes\",\n  abbreviation: \"RUC\",\n  aliases: [\n    \"RUC\",\n    \"Registro Único de Contribuyentes\",\n  ] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"EC\",\n  entityType: \"any\",\n  description:\n    \"13-digit tax identification number issued by the SRI\",\n  sourceUrl: \"https://www.sri.gob.ec/\",\n  lengths: [13] as const,\n  examples: [\"1792060346001\", \"1790011674001\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"ruc.js","names":[],"sources":["../../src/ec/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyentes).\n *\n * Ecuadorian tax identification number. 13 digits:\n * - Digits 1-2: province code (01-24, 30, or 50)\n * - Digit 3: type indicator\n *   - 0-5: natural person (CI + establishment)\n *   - 6: public entity (or natural person fallback)\n *   - 9: juridical entity (public checksum first,\n *         then juridical fallback)\n *\n * Natural persons use a Luhn-like mod-10 checksum on\n * the first 10 digits. Public entities use a mod-11\n * checksum on the first 9 digits. Private companies\n * use a mod-11 checksum on the first 10 digits.\n *\n * @see https://www.sri.gob.ec/\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/** CI mod-10 checksum: weights [2,1,2,1,...], fold\n *  products > 9 by subtracting 9, sum mod 10 == 0. */\nconst ciChecksum = (digits: string): number => {\n  let sum = 0;\n  for (let i = 0; i < digits.length; i++) {\n    const weight = i % 2 === 0 ? 2 : 1;\n    let product = Number(digits[i]) * weight;\n    if (product > 9) product -= 9;\n    sum += product;\n  }\n  return sum % 10;\n};\n\n/** Weighted mod-11 checksum. */\nconst mod11Checksum = (\n  digits: string,\n  weights: readonly number[],\n): number => {\n  let sum = 0;\n  for (const [i, weight] of weights.entries()) {\n    sum += Number(digits[i]) * weight;\n  }\n  return sum % 11;\n};\n\nconst PUBLIC_WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2, 1];\nconst JURIDICAL_WEIGHTS = [4, 3, 2, 7, 6, 5, 4, 3, 2, 1];\n\nconst isValidProvince = (v: string): boolean => {\n  const province = v.slice(0, 2);\n  return (\n    (province >= \"01\" && province <= \"24\") ||\n    province === \"30\" ||\n    province === \"50\"\n  );\n};\n\nconst validateNatural = (\n  v: string,\n): ValidateResult | null => {\n  if (v.slice(-3) === \"000\") return null;\n  if (ciChecksum(v.slice(0, 10)) !== 0) return null;\n  return { valid: true, compact: v };\n};\n\nconst validatePublic = (\n  v: string,\n): ValidateResult | null => {\n  if (v.slice(-4) === \"0000\") return null;\n  if (mod11Checksum(v, PUBLIC_WEIGHTS) !== 0) return null;\n  return { valid: true, compact: v };\n};\n\nconst validateJuridical = (\n  v: string,\n): ValidateResult | null => {\n  if (v.slice(-3) === \"000\") return null;\n  if (mod11Checksum(v, JURIDICAL_WEIGHTS) !== 0) {\n    return null;\n  }\n  return { valid: true, compact: v };\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RUC must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUC must contain only digits\",\n    );\n  }\n  if (!isValidProvince(v)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUC province code is invalid\",\n    );\n  }\n\n  const typeDigit = Number(v[2]);\n\n  if (typeDigit <= 5) {\n    // Natural person\n    const result = validateNatural(v);\n    if (result) return result;\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  if (typeDigit === 6) {\n    // Public entity; fall back to natural person\n    const pub = validatePublic(v);\n    if (pub) return pub;\n    const nat = validateNatural(v);\n    if (nat) return nat;\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  if (typeDigit === 9) {\n    // Juridical RUC; try public checksum first, fall\n    // back to juridical (matches python-stdnum).\n    const pub = validatePublic(v);\n    if (pub) return pub;\n    const jur = validateJuridical(v);\n    if (jur) return jur;\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  return err(\n    \"INVALID_COMPONENT\",\n    \"RUC type digit is invalid\",\n  );\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Ecuadorian RUC. */\nconst generate = (): string => {\n  for (;;) {\n    const province = String(randomInt(1, 24)).padStart(\n      2,\n      \"0\",\n    );\n    const c = province + randomDigits(11);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Ecuadorian tax identification number. */\nconst ruc: Validator = {\n  name: \"Registro Único de Contribuyentes\",\n  localName: \"Registro Único de Contribuyentes\",\n  abbreviation: \"RUC\",\n  aliases: [\n    \"RUC\",\n    \"Registro Único de Contribuyentes\",\n  ] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"EC\",\n  entityType: \"any\",\n  description:\n    \"13-digit tax identification number issued by the SRI\",\n  sourceUrl: \"https://www.sri.gob.ec/\",\n  lengths: [13] as const,\n  examples: [\"1792060346001\", \"1790011674001\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":"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"}

package/dist/ee/ik.d.ts

@@ -1,7 +1,6 @@
 import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
 
 //#region src/ee/ik.d.ts
-
 declare const compact: (value: string) => string;
 /**
  * Compute the two-pass check digit used by both
@@ -18,7 +17,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid Estonian IK. */
 declare const generate: () => string;
 /** Estonian Personal Identification Code. */
-declare const ik: Validator;
+declare const ik: Validator<ParsedPersonId>;
 //#endregion
 export { compact, ik as default, format, generate, parse, twoPassCheck, validate };
 //# sourceMappingURL=ik.d.ts.map

package/dist/ee/ik.js

@@ -12,7 +12,16 @@ import { isValidDate } from "../_util/date.js";
 * gender/century digit, YYMMDD, 3-digit serial, and
 * a check digit computed with two-pass weighted sums.
 *
+* Canonical sources:
+* - Estonian legislation for the personal code format
+* - OECD Estonia TIN sheet summarising the same
+*   first-digit ranges for cross-border tax use
+*
+* These sources are why we restrict the first digit
+* to 1-6 rather than accepting speculative 7/8 forms.
+*
 * @see https://www.riigiteataja.ee/en/eli/512012015003/consolide
+* @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Estonia-TIN.pdf
 */
 const WEIGHTS_1 = [
 	1,
@@ -44,9 +53,7 @@ const centuryMap = {
 	3: 1900,
 	4: 1900,
 	5: 2e3,
-	6: 2e3,
-	7: 2100,
-	8: 2100
+	6: 2e3
 };
 const compact = (value) => clean(value, " -");
 /**
@@ -64,7 +71,7 @@ const validate = (value) => {
 	if (v.length !== 11) return err("INVALID_LENGTH", "Isikukood must be exactly 11 digits");
 	if (!isdigits(v)) return err("INVALID_FORMAT", "Isikukood must contain only digits");
 	const g = Number(v[0]);
-	if (g < 1 || g > 8) return err("INVALID_COMPONENT", "Isikukood gender/century digit is invalid");
+	if (g < 1 || g > 6) return err("INVALID_COMPONENT", "Isikukood gender/century digit is invalid");
 	const century = centuryMap[g] ?? 1900;
 	const yy = Number(v.slice(1, 3));
 	const mm = Number(v.slice(3, 5));
@@ -122,6 +129,7 @@ const ik = {
 	examples: ["36805280109"],
 	compact,
 	format,
+	parse,
 	validate,
 	generate
 };

package/dist/ee/ik.js.map

@@ -1 +1 @@
-{"version":3,"file":"ik.js","names":[],"sources":["../../src/ee/ik.ts"],"sourcesContent":["/**\n * Isikukood (IK).\n *\n * Estonian personal identification code. 11 digits:\n * gender/century digit, YYMMDD, 3-digit serial, and\n * a check digit computed with two-pass weighted sums.\n *\n * @see https://www.riigiteataja.ee/en/eli/512012015003/consolide\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\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 WEIGHTS_1 = [1, 2, 3, 4, 5, 6, 7, 8, 9, 1] as const;\nconst WEIGHTS_2 = [3, 4, 5, 6, 7, 8, 9, 1, 2, 3] as const;\n\nconst centuryMap: Record<number, number> = {\n  1: 1800,\n  2: 1800,\n  3: 1900,\n  4: 1900,\n  5: 2000,\n  6: 2000,\n  7: 2100,\n  8: 2100,\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Compute the two-pass check digit used by both\n * Estonian IK and Lithuanian Asmens kodas.\n */\nexport const twoPassCheck = (digits: string): number => {\n  let remainder = weightedSum(digits, WEIGHTS_1, 11);\n  if (remainder !== 10) return remainder;\n  remainder = weightedSum(digits, WEIGHTS_2, 11);\n  return remainder === 10 ? 0 : remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Isikukood must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Isikukood must contain only digits\",\n    );\n  }\n\n  const g = Number(v[0]);\n  if (g < 1 || g > 8) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Isikukood gender/century digit is invalid\",\n    );\n  }\n\n  const century = centuryMap[g] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = century + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Isikukood contains an invalid date\",\n    );\n  }\n\n  const check = twoPassCheck(v.slice(0, 10));\n  if (check !== Number(v[10])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Isikukood check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an Isikukood.\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 g = Number(v[0]);\n  const century = centuryMap[g] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = century + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: g % 2 === 1 ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Estonian IK. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(3, 6));\n    const yy = String(randomInt(0, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const s = String(randomInt(0, 999)).padStart(3, \"0\");\n    const payload = g + yy + mm + dd + s;\n    const c = payload + String(twoPassCheck(payload));\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Estonian Personal Identification Code. */\nconst ik: Validator = {\n  name: \"Estonian Personal ID\",\n  localName: \"Isikukood\",\n  abbreviation: \"IK\",\n  aliases: [\"isikukood\", \"IK\"] as const,\n  candidatePattern: \"[1-6]\\\\d{10}\",\n  country: \"EE\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.riigiteataja.ee/en/eli/512012015003/consolide\",\n  examples: [\"36805280109\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ik;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"ik.js","names":[],"sources":["../../src/ee/ik.ts"],"sourcesContent":["/**\n * Isikukood (IK).\n *\n * Estonian personal identification code. 11 digits:\n * gender/century digit, YYMMDD, 3-digit serial, and\n * a check digit computed with two-pass weighted sums.\n *\n * Canonical sources:\n * - Estonian legislation for the personal code format\n * - OECD Estonia TIN sheet summarising the same\n *   first-digit ranges for cross-border tax use\n *\n * These sources are why we restrict the first digit\n * to 1-6 rather than accepting speculative 7/8 forms.\n *\n * @see https://www.riigiteataja.ee/en/eli/512012015003/consolide\n * @see https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/Estonia-TIN.pdf\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\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 WEIGHTS_1 = [1, 2, 3, 4, 5, 6, 7, 8, 9, 1] as const;\nconst WEIGHTS_2 = [3, 4, 5, 6, 7, 8, 9, 1, 2, 3] as const;\n\nconst centuryMap: Record<number, number> = {\n  1: 1800,\n  2: 1800,\n  3: 1900,\n  4: 1900,\n  5: 2000,\n  6: 2000,\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Compute the two-pass check digit used by both\n * Estonian IK and Lithuanian Asmens kodas.\n */\nexport const twoPassCheck = (digits: string): number => {\n  let remainder = weightedSum(digits, WEIGHTS_1, 11);\n  if (remainder !== 10) return remainder;\n  remainder = weightedSum(digits, WEIGHTS_2, 11);\n  return remainder === 10 ? 0 : remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Isikukood must be exactly 11 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Isikukood must contain only digits\",\n    );\n  }\n\n  const g = Number(v[0]);\n  // Official Estonian structure uses 1-6:\n  // 1-2 = 1800s, 3-4 = 1900s, 5-6 = 2000s.\n  if (g < 1 || g > 6) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Isikukood gender/century digit is invalid\",\n    );\n  }\n\n  const century = centuryMap[g] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = century + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Isikukood contains an invalid date\",\n    );\n  }\n\n  const check = twoPassCheck(v.slice(0, 10));\n  if (check !== Number(v[10])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Isikukood check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/**\n * Extract birth date and gender from an Isikukood.\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 g = Number(v[0]);\n  const century = centuryMap[g] ?? 1900;\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n  const dd = Number(v.slice(5, 7));\n  const year = century + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: g % 2 === 1 ? \"male\" : \"female\",\n  };\n};\n\n/** Generate a random valid Estonian IK. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(3, 6));\n    const yy = String(randomInt(0, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dd = String(randomInt(1, 28)).padStart(2, \"0\");\n    const s = String(randomInt(0, 999)).padStart(3, \"0\");\n    const payload = g + yy + mm + dd + s;\n    const c = payload + String(twoPassCheck(payload));\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Estonian Personal Identification Code. */\nconst ik: Validator<ParsedPersonId> = {\n  name: \"Estonian Personal ID\",\n  localName: \"Isikukood\",\n  abbreviation: \"IK\",\n  aliases: [\"isikukood\", \"IK\"] as const,\n  candidatePattern: \"[1-6]\\\\d{10}\",\n  country: \"EE\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.riigiteataja.ee/en/eli/512012015003/consolide\",\n  examples: [\"36805280109\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default ik;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}

package/dist/ee/mod.d.ts

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

package/dist/ee/registrikood.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/ee/registrikood.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/ee/registrikood.js

@@ -1,5 +1,5 @@
 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";
 import { isdigits } from "../_util/strings.js";
 import { twoPassCheck } from "./ik.js";
@@ -31,14 +31,15 @@ const validate = (value) => {
 	};
 };
 const format = (value) => compact(value);
+const REGISTRIKOOD_FIRSTS = [
+	1,
+	7,
+	8,
+	9
+];
 /** Generate a random valid Estonian Registrikood. */
 const generate = () => {
-	const payload = String([
-		1,
-		7,
-		8,
-		9
-	][randomInt(0, 3)]) + randomDigits(6);
+	const payload = String(randomPick(REGISTRIKOOD_FIRSTS)) + randomDigits(6);
 	return payload + String(twoPassCheck(payload));
 };
 /** Estonian Company Registration Code. */

package/dist/ee/registrikood.js.map

@@ -1 +1 @@
-{"version":3,"file":"registrikood.js","names":[],"sources":["../../src/ee/registrikood.ts"],"sourcesContent":["/**\n * Registrikood (Estonian company registration code).\n *\n * 8 digits. First digit must be 1, 7, 8, or 9.\n * Two-pass checksum (same algorithm as EE IK).\n *\n * @see https://www.rik.ee/\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\";\nimport { twoPassCheck } from \"./ik\";\n\nconst VALID_FIRST = new Set([\"1\", \"7\", \"8\", \"9\"]);\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      \"Estonian Registrikood must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Estonian Registrikood must contain only digits\",\n    );\n  }\n  if (!VALID_FIRST.has(v.charAt(0))) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Estonian Registrikood must start with 1, 7, 8, or 9\",\n    );\n  }\n  const check = twoPassCheck(v.slice(0, 7));\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Estonian Registrikood check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Estonian Registrikood. */\nconst generate = (): string => {\n  const firsts = [1, 7, 8, 9];\n  const first = String(firsts[randomInt(0, 3)]!);\n  const payload = first + randomDigits(6);\n  return payload + String(twoPassCheck(payload));\n};\n\n/** Estonian Company Registration Code. */\nconst registrikood: Validator = {\n  name: \"Estonian Company Registration Code\",\n  localName: \"Registrikood\",\n  abbreviation: \"Registrikood\",\n  aliases: [\"registrikood\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"EE\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.rik.ee/\",\n  examples: [\"12345678\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default registrikood;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,cAAc,IAAI,IAAI;CAAC;CAAK;CAAK;CAAK;CAAI,CAAC;AAEjD,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,yCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iDACD;AAEH,KAAI,CAAC,YAAY,IAAI,EAAE,OAAO,EAAE,CAAC,CAC/B,QAAO,IACL,qBACA,sDACD;AAGH,KADc,aAAa,EAAE,MAAM,GAAG,EAAE,CAAC,KAC3B,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,6CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAG7B,MAAM,UADQ,OADC;EAAC;EAAG;EAAG;EAAG;EAAE,CACC,UAAU,GAAG,EAAE,EAAG,GACtB,aAAa,EAAE;AACvC,QAAO,UAAU,OAAO,aAAa,QAAQ,CAAC;;;AAIhD,MAAM,eAA0B;CAC9B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,eAAe;CACzB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"registrikood.js","names":[],"sources":["../../src/ee/registrikood.ts"],"sourcesContent":["/**\n * Registrikood (Estonian company registration code).\n *\n * 8 digits. First digit must be 1, 7, 8, or 9.\n * Two-pass checksum (same algorithm as EE IK).\n *\n * @see https://www.rik.ee/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport { twoPassCheck } from \"./ik\";\n\nconst VALID_FIRST = new Set([\"1\", \"7\", \"8\", \"9\"]);\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      \"Estonian Registrikood must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Estonian Registrikood must contain only digits\",\n    );\n  }\n  if (!VALID_FIRST.has(v.charAt(0))) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Estonian Registrikood must start with 1, 7, 8, or 9\",\n    );\n  }\n  const check = twoPassCheck(v.slice(0, 7));\n  if (check !== Number(v[7])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Estonian Registrikood check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst REGISTRIKOOD_FIRSTS = [1, 7, 8, 9] as const;\n\n/** Generate a random valid Estonian Registrikood. */\nconst generate = (): string => {\n  const first = String(randomPick(REGISTRIKOOD_FIRSTS));\n  const payload = first + randomDigits(6);\n  return payload + String(twoPassCheck(payload));\n};\n\n/** Estonian Company Registration Code. */\nconst registrikood: Validator = {\n  name: \"Estonian Company Registration Code\",\n  localName: \"Registrikood\",\n  abbreviation: \"Registrikood\",\n  aliases: [\"registrikood\"] as const,\n  candidatePattern: \"\\\\d{8}\",\n  country: \"EE\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.rik.ee/\",\n  examples: [\"12345678\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default registrikood;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,cAAc,IAAI,IAAI;CAAC;CAAK;CAAK;CAAK;CAAI,CAAC;AAEjD,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,yCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iDACD;AAEH,KAAI,CAAC,YAAY,IAAI,EAAE,OAAO,EAAE,CAAC,CAC/B,QAAO,IACL,qBACA,sDACD;AAGH,KADc,aAAa,EAAE,MAAM,GAAG,EAAE,CAAC,KAC3B,OAAO,EAAE,GAAG,CACxB,QAAO,IACL,oBACA,6CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;AAExD,MAAM,sBAAsB;CAAC;CAAG;CAAG;CAAG;CAAE;;AAGxC,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,WAAW,oBAAoB,CAAC,GAC7B,aAAa,EAAE;AACvC,QAAO,UAAU,OAAO,aAAa,QAAQ,CAAC;;;AAIhD,MAAM,eAA0B;CAC9B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,eAAe;CACzB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}

package/dist/ee/vat.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/ee/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/eg/mod.d.ts

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

package/dist/es/cif.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/es/cif.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/es/cif.js

@@ -1,5 +1,5 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits, randomInt } from "../_util/generate.js";
+import { randomChar, randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 import { cifChecksum } from "./vat.js";
@@ -38,7 +38,7 @@ const validate = (value) => {
 const format = (value) => compact(value);
 /** Generate a random valid Spanish CIF. */
 const generate = () => {
-	const letter = CIF_PREFIXES[randomInt(0, 16)];
+	const letter = randomChar(CIF_PREFIXES);
 	const payload = randomDigits(7);
 	const check = cifChecksum(payload);
 	if ("KPQS".includes(letter)) return letter + payload + CIF_LETTERS.charAt(check);

package/dist/es/cif.js.map

@@ -1 +1 @@
-{"version":3,"file":"cif.js","names":[],"sources":["../../src/es/cif.ts"],"sourcesContent":["/**\n * CIF (Código de Identificación Fiscal).\n *\n * Spanish company tax identification number.\n * Letter prefix (ABCDEFGHJNPQRSUVW) + 7 digits +\n * check digit or letter. Delegates to the CIF\n * branch of es/vat validation.\n *\n * @see https://www.agenciatributaria.es/\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\";\nimport { cifChecksum } from \"./vat\";\n\nconst CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\nconst CIF_LETTERS = \"JABCDEFGHI\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"ES\") || v.startsWith(\"es\")) {\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      \"Spanish CIF must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  if (!CIF_PREFIXES.includes(first)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must start with a valid prefix letter\",\n    );\n  }\n\n  if (!isdigits(v.slice(1, 8))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must have 7 digits after prefix\",\n    );\n  }\n\n  const last = v.charAt(8);\n  const check = cifChecksum(v.slice(1, 8));\n\n  if (\n    last !== String(check) &&\n    last !== CIF_LETTERS.charAt(check)\n  ) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Spanish CIF check digit/letter mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish CIF. */\nconst generate = (): string => {\n  const letter =\n    CIF_PREFIXES[randomInt(0, CIF_PREFIXES.length - 1)]!;\n  const payload = randomDigits(7);\n  const check = cifChecksum(payload);\n  if (\"KPQS\".includes(letter))\n    return letter + payload + CIF_LETTERS.charAt(check);\n  return letter + payload + String(check);\n};\n\n/** Spanish Company Tax ID (CIF). */\nconst cif: Validator = {\n  name: \"Spanish Company Tax ID\",\n  localName: \"Código de Identificación Fiscal\",\n  abbreviation: \"CIF\",\n  aliases: [\n    \"CIF\",\n    \"código de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"[A-HJNP-SUVW]\\\\d{7}[\\\\dA-J]\",\n  country: \"ES\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"A13585625\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,eAAe;AACrB,MAAM,cAAc;AAEpB,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,mCACD;CAGH,MAAM,QAAQ,EAAE,OAAO,EAAE;AACzB,KAAI,CAAC,aAAa,SAAS,MAAM,CAC/B,QAAO,IACL,kBACA,oDACD;AAGH,KAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,8CACD;CAGH,MAAM,OAAO,EAAE,OAAO,EAAE;CACxB,MAAM,QAAQ,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAExC,KACE,SAAS,OAAO,MAAM,IACtB,SAAS,YAAY,OAAO,MAAM,CAElC,QAAO,IACL,oBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,SACJ,aAAa,UAAU,GAAG,GAAwB;CACpD,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,QAAQ,YAAY,QAAQ;AAClC,KAAI,OAAO,SAAS,OAAO,CACzB,QAAO,SAAS,UAAU,YAAY,OAAO,MAAM;AACrD,QAAO,SAAS,UAAU,OAAO,MAAM;;;AAIzC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,kCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cif.js","names":[],"sources":["../../src/es/cif.ts"],"sourcesContent":["/**\n * CIF (Código de Identificación Fiscal).\n *\n * Spanish company tax identification number.\n * Letter prefix (ABCDEFGHJNPQRSUVW) + 7 digits +\n * check digit or letter. Delegates to the CIF\n * branch of es/vat validation.\n *\n * @see https://www.agenciatributaria.es/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomChar, randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport { cifChecksum } from \"./vat\";\n\nconst CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\nconst CIF_LETTERS = \"JABCDEFGHI\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"ES\") || v.startsWith(\"es\")) {\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      \"Spanish CIF must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  if (!CIF_PREFIXES.includes(first)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must start with a valid prefix letter\",\n    );\n  }\n\n  if (!isdigits(v.slice(1, 8))) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Spanish CIF must have 7 digits after prefix\",\n    );\n  }\n\n  const last = v.charAt(8);\n  const check = cifChecksum(v.slice(1, 8));\n\n  if (\n    last !== String(check) &&\n    last !== CIF_LETTERS.charAt(check)\n  ) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Spanish CIF check digit/letter mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish CIF. */\nconst generate = (): string => {\n  const letter = randomChar(CIF_PREFIXES);\n  const payload = randomDigits(7);\n  const check = cifChecksum(payload);\n  if (\"KPQS\".includes(letter))\n    return letter + payload + CIF_LETTERS.charAt(check);\n  return letter + payload + String(check);\n};\n\n/** Spanish Company Tax ID (CIF). */\nconst cif: Validator = {\n  name: \"Spanish Company Tax ID\",\n  localName: \"Código de Identificación Fiscal\",\n  abbreviation: \"CIF\",\n  aliases: [\n    \"CIF\",\n    \"código de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"[A-HJNP-SUVW]\\\\d{7}[\\\\dA-J]\",\n  country: \"ES\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"A13585625\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAM,eAAe;AACrB,MAAM,cAAc;AAEpB,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,mCACD;CAGH,MAAM,QAAQ,EAAE,OAAO,EAAE;AACzB,KAAI,CAAC,aAAa,SAAS,MAAM,CAC/B,QAAO,IACL,kBACA,oDACD;AAGH,KAAI,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,CAC1B,QAAO,IACL,kBACA,8CACD;CAGH,MAAM,OAAO,EAAE,OAAO,EAAE;CACxB,MAAM,QAAQ,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAExC,KACE,SAAS,OAAO,MAAM,IACtB,SAAS,YAAY,OAAO,MAAM,CAElC,QAAO,IACL,oBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,SAAS,WAAW,aAAa;CACvC,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,QAAQ,YAAY,QAAQ;AAClC,KAAI,OAAO,SAAS,OAAO,CACzB,QAAO,SAAS,UAAU,YAAY,OAAO,MAAM;AACrD,QAAO,SAAS,UAAU,OAAO,MAAM;;;AAIzC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,kCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}

package/dist/es/dni.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/es/dni.d.ts
-
 declare const CHECK_LETTERS = "TRWAGMYFPDXBNJZSQVHLCKE";
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;

package/dist/es/mod.d.ts

@@ -1,4 +1,3 @@
-import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import cif from "./cif.js";
 import dni from "./dni.js";
 import nie from "./nie.js";
@@ -6,7 +5,9 @@ import nss from "./nss.js";
 import vat from "./vat.js";
 
 //#region src/es/mod.d.ts
-
+declare namespace mod_d_exports {
+  export { cif, dni, nie, nss, vat };
+}
 //#endregion
 export { cif, dni, mod_d_exports, nie, nss, vat };
 //# sourceMappingURL=mod.d.ts.map

package/dist/es/nie.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/es/nie.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/es/nie.js

@@ -1,5 +1,5 @@
 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";
 import { isdigits } from "../_util/strings.js";
 import { CHECK_LETTERS } from "./dni.js";
@@ -35,21 +35,21 @@ const validate = (value) => {
 	};
 };
 const format = (value) => compact(value);
+const NIE_PREFIXES = [
+	"X",
+	"Y",
+	"Z"
+];
+const NIE_PREFIX_VALUES = {
+	X: 0,
+	Y: 1,
+	Z: 2
+};
 /** Generate a random valid Spanish NIE. */
 const generate = () => {
-	const prefixes = [
-		"X",
-		"Y",
-		"Z"
-	];
-	const vals = {
-		X: 0,
-		Y: 1,
-		Z: 2
-	};
-	const prefix = prefixes[randomInt(0, 2)];
+	const prefix = randomPick(NIE_PREFIXES);
 	const digits = randomDigits(7);
-	const num = vals[prefix] * 1e7 + Number(digits);
+	const num = NIE_PREFIX_VALUES[prefix] * 1e7 + Number(digits);
 	return prefix + digits + CHECK_LETTERS.charAt(num % 23);
 };
 /** Spanish Foreigner Identification Number. */

package/dist/es/nie.js.map

@@ -1 +1 @@
-{"version":3,"file":"nie.js","names":[],"sources":["../../src/es/nie.ts"],"sourcesContent":["/**\n * NIE (Número de Identidad de Extranjero).\n *\n * Spanish foreigner identification number. Starts\n * with X, Y, or Z, followed by 7 digits and a check\n * letter computed using the DNI algorithm.\n *\n * @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\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\";\nimport { CHECK_LETTERS } from \"./dni\";\n\nconst PREFIX_MAP: Record<string, string> = {\n  X: \"0\",\n  Y: \"1\",\n  Z: \"2\",\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIE must be 9 characters\",\n    );\n  }\n\n  const prefix = v.charAt(0);\n  const replacement = PREFIX_MAP[prefix];\n  if (replacement === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must start with X, Y, or Z\",\n    );\n  }\n\n  const digits = v.slice(1, 8);\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must have 7 digits after prefix\",\n    );\n  }\n\n  const letter = v.charAt(8);\n  const num = Number(replacement + digits);\n  const expected = CHECK_LETTERS.charAt(num % 23);\n  if (letter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIE check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Spanish NIE. */\nconst generate = (): string => {\n  const prefixes = [\"X\", \"Y\", \"Z\"] as const;\n  const vals: Record<string, number> = { X: 0, Y: 1, Z: 2 };\n  const prefix = prefixes[randomInt(0, 2)]!;\n  const digits = randomDigits(7);\n  const num = vals[prefix]! * 10000000 + Number(digits);\n  return prefix + digits + CHECK_LETTERS.charAt(num % 23);\n};\n\n/** Spanish Foreigner Identification Number. */\nconst nie: Validator = {\n  name: \"Spanish Foreigner ID\",\n  localName: \"Número de Identidad de Extranjero\",\n  abbreviation: \"NIE\",\n  aliases: [\n    \"N.I.E.\",\n    \"NIE\",\n    \"número de identidad de extranjero\",\n  ] as const,\n  candidatePattern: \"[XYZ]-?\\\\d{7}-?[A-Z]\",\n  country: \"ES\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\",\n  examples: [\"X5253868R\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nie;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,aAAqC;CACzC,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,2BACD;CAIH,MAAM,cAAc,WADL,EAAE,OAAO,EAAE;AAE1B,KAAI,gBAAgB,KAAA,EAClB,QAAO,IACL,kBACA,iCACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,sCACD;CAGH,MAAM,SAAS,EAAE,OAAO,EAAE;CAC1B,MAAM,MAAM,OAAO,cAAc,OAAO;AAExC,KAAI,WAAA,0BAD2B,OAAO,MAAM,GAAG,CAE7C,QAAO,IACL,oBACA,kCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAC7B,MAAM,WAAW;EAAC;EAAK;EAAK;EAAI;CAChC,MAAM,OAA+B;EAAE,GAAG;EAAG,GAAG;EAAG,GAAG;EAAG;CACzD,MAAM,SAAS,SAAS,UAAU,GAAG,EAAE;CACvC,MAAM,SAAS,aAAa,EAAE;CAC9B,MAAM,MAAM,KAAK,UAAW,MAAW,OAAO,OAAO;AACrD,QAAO,SAAS,SAAS,cAAc,OAAO,MAAM,GAAG;;;AAIzD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nie.js","names":[],"sources":["../../src/es/nie.ts"],"sourcesContent":["/**\n * NIE (Número de Identidad de Extranjero).\n *\n * Spanish foreigner identification number. Starts\n * with X, Y, or Z, followed by 7 digits and a check\n * letter computed using the DNI algorithm.\n *\n * @see https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\nimport { CHECK_LETTERS } from \"./dni\";\n\nconst PREFIX_MAP: Record<string, string> = {\n  X: \"0\",\n  Y: \"1\",\n  Z: \"2\",\n};\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").toUpperCase();\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIE must be 9 characters\",\n    );\n  }\n\n  const prefix = v.charAt(0);\n  const replacement = PREFIX_MAP[prefix];\n  if (replacement === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must start with X, Y, or Z\",\n    );\n  }\n\n  const digits = v.slice(1, 8);\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIE must have 7 digits after prefix\",\n    );\n  }\n\n  const letter = v.charAt(8);\n  const num = Number(replacement + digits);\n  const expected = CHECK_LETTERS.charAt(num % 23);\n  if (letter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIE check letter does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst NIE_PREFIXES = [\"X\", \"Y\", \"Z\"] as const;\nconst NIE_PREFIX_VALUES: Record<\n  (typeof NIE_PREFIXES)[number],\n  number\n> = { X: 0, Y: 1, Z: 2 };\n\n/** Generate a random valid Spanish NIE. */\nconst generate = (): string => {\n  const prefix = randomPick(NIE_PREFIXES);\n  const digits = randomDigits(7);\n  const num =\n    NIE_PREFIX_VALUES[prefix] * 10000000 + Number(digits);\n  return prefix + digits + CHECK_LETTERS.charAt(num % 23);\n};\n\n/** Spanish Foreigner Identification Number. */\nconst nie: Validator = {\n  name: \"Spanish Foreigner ID\",\n  localName: \"Número de Identidad de Extranjero\",\n  abbreviation: \"NIE\",\n  aliases: [\n    \"N.I.E.\",\n    \"NIE\",\n    \"número de identidad de extranjero\",\n  ] as const,\n  candidatePattern: \"[XYZ]-?\\\\d{7}-?[A-Z]\",\n  country: \"ES\",\n  entityType: \"person\",\n  sourceUrl:\n    \"https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/nie/\",\n  examples: [\"X5253868R\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nie;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,aAAqC;CACzC,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,aAAa;AAElC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,2BACD;CAIH,MAAM,cAAc,WADL,EAAE,OAAO,EAAE;AAE1B,KAAI,gBAAgB,KAAA,EAClB,QAAO,IACL,kBACA,iCACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,sCACD;CAGH,MAAM,SAAS,EAAE,OAAO,EAAE;CAC1B,MAAM,MAAM,OAAO,cAAc,OAAO;AAExC,KAAI,WAAA,0BAD2B,OAAO,MAAM,GAAG,CAE7C,QAAO,IACL,oBACA,kCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;AAExD,MAAM,eAAe;CAAC;CAAK;CAAK;CAAI;AACpC,MAAM,oBAGF;CAAE,GAAG;CAAG,GAAG;CAAG,GAAG;CAAG;;AAGxB,MAAM,iBAAyB;CAC7B,MAAM,SAAS,WAAW,aAAa;CACvC,MAAM,SAAS,aAAa,EAAE;CAC9B,MAAM,MACJ,kBAAkB,UAAU,MAAW,OAAO,OAAO;AACvD,QAAO,SAAS,SAAS,cAAc,OAAO,MAAM,GAAG;;;AAIzD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WACE;CACF,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}

package/dist/es/nss.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/es/nss.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;

package/dist/es/vat.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/es/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const cifChecksum: (digits: string) => number;
 declare const validate: (value: string) => ValidateResult;

package/dist/eu/mod.d.ts

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

package/dist/eu/vat.d.ts

@@ -1,7 +1,6 @@
 import { ValidateResult, Validator } from "../types.js";
 
 //#region src/eu/vat.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 /**
@@ -13,8 +12,10 @@ declare const validate: (value: string) => ValidateResult;
  * prefixing if used here.
  */
 declare const format: (value: string) => string;
+/** Generate a random EU VAT number from a member validator. */
+declare const generate: () => string;
 /** European Union VAT Number. */
 declare const euVat: Validator;
 //#endregion
-export { compact, euVat as default, format, validate };
+export { compact, euVat as default, format, generate, validate };
 //# sourceMappingURL=vat.d.ts.map

package/dist/eu/vat.js

@@ -1,4 +1,5 @@
 import { clean } from "../_util/clean.js";
+import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import uid from "../at/uid.js";
 import vat from "../be/vat.js";
@@ -125,6 +126,45 @@ const format = (value) => {
 	if (validator === void 0) return value;
 	return `${parts.cc}${validator.compact(parts.rest)}`;
 };
+const GENERATORS = [
+	["AT", uid],
+	["BE", vat],
+	["BG", vat$1],
+	["CY", vat$2],
+	["CZ", dic],
+	["DE", vat$3],
+	["DK", vat$4],
+	["EE", vat$5],
+	["ES", vat$6],
+	["FI", vat$7],
+	["FR", tva],
+	["GR", vat$9],
+	["HR", vat$10],
+	["HU", vat$11],
+	["IE", vat$12],
+	["IT", iva],
+	["LT", vat$13],
+	["LU", vat$14],
+	["LV", vat$15],
+	["MT", vat$16],
+	["NL", vat$17],
+	["PL", nip],
+	["PT", vat$18],
+	["RO", vat$19],
+	["SE", vat$20],
+	["SI", vat$21],
+	["SK", dic$1]
+];
+/** Generate a random EU VAT number from a member validator. */
+const generate = () => {
+	for (;;) {
+		const candidate = GENERATORS[randomInt(0, GENERATORS.length - 1)];
+		if (!candidate) continue;
+		const [prefix, validator] = candidate;
+		if (validator.generate === void 0) continue;
+		return `${prefix}${validator.generate()}`;
+	}
+};
 /** European Union VAT Number. */
 const euVat = {
 	name: "EU VAT Number",
@@ -137,9 +177,10 @@ const euVat = {
 	examples: ["ATU13585627", "DE136695976"],
 	compact,
 	format,
-	validate
+	validate,
+	generate
 };
 //#endregion
-export { compact, euVat as default, format, validate };
+export { compact, euVat as default, format, generate, validate };
 
 //# sourceMappingURL=vat.js.map

package/dist/eu/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":["atUid","beVat","bgVat","cyVat","czDic","deVat","dkVat","eeVat","grVat","esVat","fiVat","frTva","hrVat","huVat","ieVat","itIva","ltVat","luVat","lvVat","mtVat","nlVat","plNip","ptVat","roVat","seVat","siVat","skDic","gbVat"],"sources":["../../src/eu/vat.ts"],"sourcesContent":["/**\n * EU VAT (European Union VAT Number).\n *\n * Dispatcher that routes to per-country VAT\n * validators. Extracts the 2-letter country prefix\n * and delegates to the matching country module.\n *\n * Special cases:\n *   - EL → Greece (gr.vat)\n *   - XI → Northern Ireland (gb.vat)\n *\n * @see https://ec.europa.eu/taxation_customs/vies/\n */\n\nimport { clean } from \"#util/clean\";\nimport { err } from \"#util/result\";\n\nimport atUid from \"../at/uid\";\nimport beVat from \"../be/vat\";\nimport bgVat from \"../bg/vat\";\nimport cyVat from \"../cy/vat\";\nimport czDic from \"../cz/dic\";\nimport deVat from \"../de/vat\";\nimport dkVat from \"../dk/vat\";\nimport eeVat from \"../ee/vat\";\nimport esVat from \"../es/vat\";\nimport fiVat from \"../fi/vat\";\nimport frTva from \"../fr/tva\";\nimport gbVat from \"../gb/vat\";\nimport grVat from \"../gr/vat\";\nimport hrVat from \"../hr/vat\";\nimport huVat from \"../hu/vat\";\nimport ieVat from \"../ie/vat\";\nimport itIva from \"../it/iva\";\nimport ltVat from \"../lt/vat\";\nimport luVat from \"../lu/vat\";\nimport lvVat from \"../lv/vat\";\nimport mtVat from \"../mt/vat\";\nimport nlVat from \"../nl/vat\";\nimport plNip from \"../pl/nip\";\nimport ptVat from \"../pt/vat\";\nimport roVat from \"../ro/vat\";\nimport seVat from \"../se/vat\";\nimport siVat from \"../si/vat\";\nimport skDic from \"../sk/dic\";\nimport type { Validator, ValidateResult } from \"../types\";\n\ntype CountryValidator = {\n  compact: (value: string) => string;\n  validate: (value: string) => ValidateResult;\n  format: (value: string) => string;\n};\n\n/**\n * Map of EU VAT country prefixes to their\n * country-specific validators.\n */\nconst VALIDATORS: Record<string, CountryValidator> = {\n  AT: atUid,\n  BE: beVat,\n  BG: bgVat,\n  CY: cyVat,\n  CZ: czDic,\n  DE: deVat,\n  DK: dkVat,\n  EE: eeVat,\n  EL: grVat, // Greece uses EL prefix in EU VAT\n  ES: esVat,\n  FI: fiVat,\n  FR: frTva,\n  GR: grVat,\n  HR: hrVat,\n  HU: huVat,\n  IE: ieVat,\n  IT: itIva,\n  LT: ltVat,\n  LU: luVat,\n  LV: lvVat,\n  MT: mtVat,\n  NL: nlVat,\n  PL: plNip,\n  PT: ptVat,\n  RO: roVat,\n  SE: seVat,\n  SI: siVat,\n  SK: skDic,\n  XI: gbVat, // Northern Ireland\n};\n\n/**\n * Extract the 2-letter country prefix and the\n * remaining number from an EU VAT string.\n */\nconst splitPrefix = (\n  value: string,\n): { cc: string; rest: string } | undefined => {\n  const v = clean(value, \" -\").toUpperCase();\n  if (v.length < 3) return undefined;\n  const cc = v.slice(0, 2);\n  if (!/^[A-Z]{2}$/.test(cc)) return undefined;\n  return { cc, rest: v.slice(2) };\n};\n\nconst compact = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EU VAT must start with a 2-letter country code\",\n    );\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `Unsupported EU VAT country: ${parts.cc}`,\n    );\n  }\n  const result = validator.validate(parts.rest);\n  if (!result.valid) return result;\n  return {\n    valid: true,\n    compact: `${parts.cc}${result.compact}`,\n  };\n};\n\n/**\n * Format returns the compact EU VAT form:\n * `CC` + country-compacted number. Equivalent to\n * compact() because country format() methods\n * prepend their own prefix (e.g., AT UID format\n * returns \"ATU...\"), which would cause double-\n * prefixing if used here.\n */\nconst format = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) return value;\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) return value;\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\n/** European Union VAT Number. */\nconst euVat: Validator = {\n  name: \"EU VAT Number\",\n  localName: \"EU VAT Number\",\n  abbreviation: \"EU VAT\",\n  aliases: [\"EU VAT\", \"VAT identification number\"] as const,\n  candidatePattern: \"[A-Z]{2}\\\\d{8,12}\",\n  entityType: \"company\",\n  sourceUrl: \"https://ec.europa.eu/taxation_customs/vies/\",\n  examples: [\"ATU13585627\", \"DE136695976\"] as const,\n  compact,\n  format,\n  validate,\n};\n\nexport default euVat;\nexport { compact, format, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,MAAM,aAA+C;CACnD,IAAIA;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIH;CACJ,IAAII;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACJ,IAAIC;CACL;;;;;AAMD,MAAM,eACJ,UAC6C;CAC7C,MAAM,IAAI,MAAM,OAAO,KAAK,CAAC,aAAa;AAC1C,KAAI,EAAE,SAAS,EAAG,QAAO,KAAA;CACzB,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE;AACxB,KAAI,CAAC,aAAa,KAAK,GAAG,CAAE,QAAO,KAAA;AACnC,QAAO;EAAE;EAAI,MAAM,EAAE,MAAM,EAAE;EAAE;;AAGjC,MAAM,WAAW,UAA0B;CACzC,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,UAAU,KAAA,EACZ,QAAO,MAAM,OAAO,KAAK,CAAC,aAAa;CAEzC,MAAM,YAAY,WAAW,MAAM;AACnC,KAAI,cAAc,KAAA,EAChB,QAAO,MAAM,OAAO,KAAK,CAAC,aAAa;AAEzC,QAAO,GAAG,MAAM,KAAK,UAAU,QAAQ,MAAM,KAAK;;AAGpD,MAAM,YAAY,UAAkC;CAClD,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,UAAU,KAAA,EACZ,QAAO,IACL,kBACA,iDACD;CAEH,MAAM,YAAY,WAAW,MAAM;AACnC,KAAI,cAAc,KAAA,EAChB,QAAO,IACL,qBACA,+BAA+B,MAAM,KACtC;CAEH,MAAM,SAAS,UAAU,SAAS,MAAM,KAAK;AAC7C,KAAI,CAAC,OAAO,MAAO,QAAO;AAC1B,QAAO;EACL,OAAO;EACP,SAAS,GAAG,MAAM,KAAK,OAAO;EAC/B;;;;;;;;;;AAWH,MAAM,UAAU,UAA0B;CACxC,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,UAAU,KAAA,EAAW,QAAO;CAChC,MAAM,YAAY,WAAW,MAAM;AACnC,KAAI,cAAc,KAAA,EAAW,QAAO;AACpC,QAAO,GAAG,MAAM,KAAK,UAAU,QAAQ,MAAM,KAAK;;;AAIpD,MAAM,QAAmB;CACvB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,UAAU,4BAA4B;CAChD,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,eAAe,cAAc;CACxC;CACA;CACA;CACD"}
+{"version":3,"file":"vat.js","names":["atUid","beVat","bgVat","cyVat","czDic","deVat","dkVat","eeVat","grVat","esVat","fiVat","frTva","hrVat","huVat","ieVat","itIva","ltVat","luVat","lvVat","mtVat","nlVat","plNip","ptVat","roVat","seVat","siVat","skDic","gbVat"],"sources":["../../src/eu/vat.ts"],"sourcesContent":["/**\n * EU VAT (European Union VAT Number).\n *\n * Dispatcher that routes to per-country VAT\n * validators. Extracts the 2-letter country prefix\n * and delegates to the matching country module.\n *\n * Special cases:\n *   - EL → Greece (gr.vat)\n *   - XI → Northern Ireland (gb.vat)\n *\n * @see https://ec.europa.eu/taxation_customs/vies/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport atUid from \"../at/uid\";\nimport beVat from \"../be/vat\";\nimport bgVat from \"../bg/vat\";\nimport cyVat from \"../cy/vat\";\nimport czDic from \"../cz/dic\";\nimport deVat from \"../de/vat\";\nimport dkVat from \"../dk/vat\";\nimport eeVat from \"../ee/vat\";\nimport esVat from \"../es/vat\";\nimport fiVat from \"../fi/vat\";\nimport frTva from \"../fr/tva\";\nimport gbVat from \"../gb/vat\";\nimport grVat from \"../gr/vat\";\nimport hrVat from \"../hr/vat\";\nimport huVat from \"../hu/vat\";\nimport ieVat from \"../ie/vat\";\nimport itIva from \"../it/iva\";\nimport ltVat from \"../lt/vat\";\nimport luVat from \"../lu/vat\";\nimport lvVat from \"../lv/vat\";\nimport mtVat from \"../mt/vat\";\nimport nlVat from \"../nl/vat\";\nimport plNip from \"../pl/nip\";\nimport ptVat from \"../pt/vat\";\nimport roVat from \"../ro/vat\";\nimport seVat from \"../se/vat\";\nimport siVat from \"../si/vat\";\nimport skDic from \"../sk/dic\";\nimport type { Validator, ValidateResult } from \"../types\";\n\ntype CountryValidator = {\n  compact: (value: string) => string;\n  validate: (value: string) => ValidateResult;\n  format: (value: string) => string;\n};\n\n/**\n * Map of EU VAT country prefixes to their\n * country-specific validators.\n */\nconst VALIDATORS: Record<string, CountryValidator> = {\n  AT: atUid,\n  BE: beVat,\n  BG: bgVat,\n  CY: cyVat,\n  CZ: czDic,\n  DE: deVat,\n  DK: dkVat,\n  EE: eeVat,\n  EL: grVat, // Greece uses EL prefix in EU VAT\n  ES: esVat,\n  FI: fiVat,\n  FR: frTva,\n  GR: grVat,\n  HR: hrVat,\n  HU: huVat,\n  IE: ieVat,\n  IT: itIva,\n  LT: ltVat,\n  LU: luVat,\n  LV: lvVat,\n  MT: mtVat,\n  NL: nlVat,\n  PL: plNip,\n  PT: ptVat,\n  RO: roVat,\n  SE: seVat,\n  SI: siVat,\n  SK: skDic,\n  XI: gbVat, // Northern Ireland\n};\n\n/**\n * Extract the 2-letter country prefix and the\n * remaining number from an EU VAT string.\n */\nconst splitPrefix = (\n  value: string,\n): { cc: string; rest: string } | undefined => {\n  const v = clean(value, \" -\").toUpperCase();\n  if (v.length < 3) return undefined;\n  const cc = v.slice(0, 2);\n  if (!/^[A-Z]{2}$/.test(cc)) return undefined;\n  return { cc, rest: v.slice(2) };\n};\n\nconst compact = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return clean(value, \" -\").toUpperCase();\n  }\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"EU VAT must start with a 2-letter country code\",\n    );\n  }\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) {\n    return err(\n      \"INVALID_COMPONENT\",\n      `Unsupported EU VAT country: ${parts.cc}`,\n    );\n  }\n  const result = validator.validate(parts.rest);\n  if (!result.valid) return result;\n  return {\n    valid: true,\n    compact: `${parts.cc}${result.compact}`,\n  };\n};\n\n/**\n * Format returns the compact EU VAT form:\n * `CC` + country-compacted number. Equivalent to\n * compact() because country format() methods\n * prepend their own prefix (e.g., AT UID format\n * returns \"ATU...\"), which would cause double-\n * prefixing if used here.\n */\nconst format = (value: string): string => {\n  const parts = splitPrefix(value);\n  if (parts === undefined) return value;\n  const validator = VALIDATORS[parts.cc];\n  if (validator === undefined) return value;\n  return `${parts.cc}${validator.compact(parts.rest)}`;\n};\n\nconst GENERATORS = [\n  [\"AT\", atUid],\n  [\"BE\", beVat],\n  [\"BG\", bgVat],\n  [\"CY\", cyVat],\n  [\"CZ\", czDic],\n  [\"DE\", deVat],\n  [\"DK\", dkVat],\n  [\"EE\", eeVat],\n  [\"ES\", esVat],\n  [\"FI\", fiVat],\n  [\"FR\", frTva],\n  [\"GR\", grVat],\n  [\"HR\", hrVat],\n  [\"HU\", huVat],\n  [\"IE\", ieVat],\n  [\"IT\", itIva],\n  [\"LT\", ltVat],\n  [\"LU\", luVat],\n  [\"LV\", lvVat],\n  [\"MT\", mtVat],\n  [\"NL\", nlVat],\n  [\"PL\", plNip],\n  [\"PT\", ptVat],\n  [\"RO\", roVat],\n  [\"SE\", seVat],\n  [\"SI\", siVat],\n  [\"SK\", skDic],\n] as const;\n\n/** Generate a random EU VAT number from a member validator. */\nconst generate = (): string => {\n  for (;;) {\n    const candidate =\n      GENERATORS[randomInt(0, GENERATORS.length - 1)];\n    if (!candidate) continue;\n\n    const [prefix, validator] = candidate;\n    if (validator.generate === undefined) continue;\n    return `${prefix}${validator.generate()}`;\n  }\n};\n\n/** European Union VAT Number. */\nconst euVat: Validator = {\n  name: \"EU VAT Number\",\n  localName: \"EU VAT Number\",\n  abbreviation: \"EU VAT\",\n  aliases: [\"EU VAT\", \"VAT identification number\"] as const,\n  candidatePattern: \"[A-Z]{2}\\\\d{8,12}\",\n  entityType: \"company\",\n  sourceUrl: \"https://ec.europa.eu/taxation_customs/vies/\",\n  examples: [\"ATU13585627\", \"DE136695976\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default euVat;\nexport { compact, format, generate, validate };\n"],"mappings":"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"}

package/dist/fi/hetu.d.ts

@@ -1,7 +1,6 @@
 import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
 
 //#region src/fi/hetu.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -10,8 +9,10 @@ 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 HETU. */
+declare const generate: () => string;
 /** Finnish Personal Identity Code. */
-declare const hetu: Validator;
+declare const hetu: Validator<ParsedPersonId>;
 //#endregion
-export { compact, hetu as default, format, parse, validate };
+export { compact, hetu as default, format, generate, parse, validate };
 //# sourceMappingURL=hetu.d.ts.map

package/dist/fi/hetu.js

@@ -1,4 +1,5 @@
 import { clean } from "../_util/clean.js";
+import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 import { isValidDate } from "../_util/date.js";
@@ -82,6 +83,17 @@ const parse = (value) => {
 		gender: serial % 2 === 0 ? "female" : "male"
 	};
 };
+/** Generate a random valid HETU. */
+const generate = () => {
+	const year = randomInt(1900, 2024);
+	const month = String(randomInt(1, 12)).padStart(2, "0");
+	const day = String(randomInt(1, 28)).padStart(2, "0");
+	const yy = String(year % 100).padStart(2, "0");
+	const separator = year >= 2e3 ? "A" : "-";
+	const serial = String(randomInt(2, 899)).padStart(3, "0");
+	const checkNum = Number(`${day}${month}${yy}${serial}`);
+	return `${day}${month}${yy}${separator}${serial}${CHECK_CHARS.charAt(checkNum % 31)}`;
+};
 /** Finnish Personal Identity Code. */
 const hetu = {
 	name: "Finnish Personal ID",
@@ -96,12 +108,15 @@ const hetu = {
 	country: "FI",
 	entityType: "person",
 	sourceUrl: "https://dvv.fi/en/personal-identity-code",
+	lengths: [11],
 	examples: ["131052-308T"],
 	compact,
 	format,
-	validate
+	parse,
+	validate,
+	generate
 };
 //#endregion
-export { compact, hetu as default, format, parse, validate };
+export { compact, hetu as default, format, generate, parse, validate };
 
 //# sourceMappingURL=hetu.js.map