@stll/stdnum 2.1.0 → 2.1.2

package/dist/es/vat.js

@@ -1,98 +1,13 @@
-import { clean } from "../_util/clean.js";
-import { randomDigits } from "../_util/generate.js";
-import { err } from "../_util/result.js";
-import { isdigits } from "../_util/strings.js";
-//#region src/es/vat.ts
-const DNI_LETTERS = "TRWAGMYFPDXBNJZSQVHLCKE";
-const CIF_LETTERS = "JABCDEFGHI";
-const compact = (value) => {
-	let v = clean(value, " -/.");
-	if (v.startsWith("ES") || v.startsWith("es")) v = v.slice(2);
-	return v.toUpperCase();
-};
-const cifChecksum = (digits) => {
-	let even = 0;
-	let odd = 0;
-	for (let i = 0; i < 7; i++) {
-		const d = Number(digits.charAt(i));
-		if (i % 2 === 0) {
-			const doubled = d * 2;
-			odd += Math.floor(doubled / 10) + doubled % 10;
-		} else even += d;
-	}
-	return (10 - (even + odd) % 10) % 10;
-};
-const validate = (value) => {
-	const v = compact(value);
-	if (v.length !== 9) return err("INVALID_LENGTH", "Spanish VAT number must be 9 characters");
-	const first = v.charAt(0);
-	const last = v.charAt(8);
-	if (isdigits(v.slice(0, 8))) {
-		if (last !== DNI_LETTERS.charAt(Number.parseInt(v.slice(0, 8), 10) % 23)) return err("INVALID_CHECKSUM", "Spanish DNI check letter mismatch");
-		return {
-			valid: true,
-			compact: v
-		};
-	}
-	if (first === "X" || first === "Y" || first === "Z") {
-		let prefix = "2";
-		if (first === "X") prefix = "0";
-		else if (first === "Y") prefix = "1";
-		const digits = prefix + v.slice(1, 8);
-		if (!isdigits(digits) || !isdigits(v.slice(1, 8))) return err("INVALID_FORMAT", "Spanish NIE must have 7 digits after prefix");
-		if (last !== DNI_LETTERS.charAt(Number.parseInt(digits, 10) % 23)) return err("INVALID_CHECKSUM", "Spanish NIE check letter mismatch");
-		return {
-			valid: true,
-			compact: v
-		};
-	}
-	if (first === "K" || first === "L" || first === "M") {
-		if (!isdigits(v.slice(1, 8))) return err("INVALID_FORMAT", "Spanish K/L/M number must have 7 digits");
-		if (last !== DNI_LETTERS.charAt(Number.parseInt(v.slice(1, 8), 10) % 23)) return err("INVALID_CHECKSUM", "Spanish K/L/M check letter mismatch");
-		return {
-			valid: true,
-			compact: v
-		};
-	}
-	if ("ABCDEFGHJNPQRSUVW".includes(first)) {
-		if (!isdigits(v.slice(1, 8))) return err("INVALID_FORMAT", "Spanish CIF must have 7 digits after prefix");
-		const check = cifChecksum(v.slice(1, 8));
-		if (last !== String(check) && last !== CIF_LETTERS.charAt(check)) return err("INVALID_CHECKSUM", "Spanish CIF check digit/letter mismatch");
-		return {
-			valid: true,
-			compact: v
-		};
-	}
-	return err("INVALID_FORMAT", "Spanish VAT number has invalid format");
-};
-const format = (value) => `ES${compact(value)}`;
-/** Generate a random valid Spanish VAT (DNI form). */
-const generate = () => {
-	const letters = "TRWAGMYFPDXBNJZSQVHLCKE";
-	const num = randomDigits(8);
-	return num + letters.charAt(Number(num) % 23);
-};
-/** Spanish VAT Number. */
-const vat = {
-	name: "Spanish VAT Number",
-	localName: "Número de Identificación Fiscal",
-	abbreviation: "NIF",
-	aliases: [
-		"NIF",
-		"CIF",
-		"número de identificación fiscal"
-	],
-	candidatePattern: "ES[A-Z]\\d{7}[A-Z\\d]",
-	scope: "country",
-	country: "ES",
-	entityType: "any",
-	sourceUrl: "https://www.agenciatributaria.es/",
-	examples: ["12345678Z", "A78304516"],
-	compact,
-	format,
-	validate,
-	generate
-};
+import { createValidator, getBinding } from "../runtime.js";
+//#region src/generated/es/vat.ts
+const vat = createValidator("es.vat", 68);
+const compact = vat.compact;
+const format = vat.format;
+const validate = vat.validate;
+const generate = () => vat.generate?.() ?? (() => {
+	throw new Error("Validator es.vat cannot generate values");
+})();
+const cifChecksum = (digits) => getBinding().esVatCifChecksum(digits);
 //#endregion
 export { cifChecksum, compact, vat as default, format, generate, validate };
 

package/dist/es/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","names":[],"sources":["../../src/es/vat.ts"],"sourcesContent":["/**\n * NIF/CIF (Spanish VAT number).\n *\n * 9 characters with 4 subtypes: DNI, NIE, CIF,\n * and K/L/M personal numbers.\n *\n * @see https://www.vatify.eu/spain-vat-number.html\n * @see https://www.agenciatributaria.es/\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 DNI_LETTERS = \"TRWAGMYFPDXBNJZSQVHLCKE\";\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 cifChecksum = (digits: string): number => {\n  let even = 0;\n  let odd = 0;\n  for (let i = 0; i < 7; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd positions (1-indexed): double and sum digits\n      const doubled = d * 2;\n      odd += Math.floor(doubled / 10) + (doubled % 10);\n    } else {\n      even += d;\n    }\n  }\n  return (10 - ((even + odd) % 10)) % 10;\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 VAT number must be 9 characters\",\n    );\n  }\n\n  const first = v.charAt(0);\n  const last = v.charAt(8);\n\n  // DNI: 8 digits + letter\n  if (isdigits(v.slice(0, 8))) {\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(v.slice(0, 8), 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish DNI check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // NIE: X/Y/Z + 7 digits + letter\n  if (first === \"X\" || first === \"Y\" || first === \"Z\") {\n    let prefix = \"2\";\n    if (first === \"X\") {\n      prefix = \"0\";\n    } else if (first === \"Y\") {\n      prefix = \"1\";\n    }\n    const digits = prefix + v.slice(1, 8);\n    if (!isdigits(digits) || !isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish NIE must have 7 digits after prefix\",\n      );\n    }\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(digits, 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish NIE check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // K, L, M: personal number, letter + 7 digits +\n  // check letter\n  if (first === \"K\" || first === \"L\" || first === \"M\") {\n    if (!isdigits(v.slice(1, 8))) {\n      return err(\n        \"INVALID_FORMAT\",\n        \"Spanish K/L/M number must have 7 digits\",\n      );\n    }\n    const expected = DNI_LETTERS.charAt(\n      Number.parseInt(v.slice(1, 8), 10) % 23,\n    );\n    if (last !== expected) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"Spanish K/L/M check letter mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // CIF: letter + 7 digits + check digit/letter\n  const CIF_PREFIXES = \"ABCDEFGHJNPQRSUVW\";\n  if (CIF_PREFIXES.includes(first)) {\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    const check = cifChecksum(v.slice(1, 8));\n    // Accept either numeric or alphabetic check digit\n    // for all CIF prefixes (sources conflict on which\n    // prefixes require which type)\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    return { valid: true, compact: v };\n  }\n\n  return err(\n    \"INVALID_FORMAT\",\n    \"Spanish VAT number has invalid format\",\n  );\n};\n\nconst format = (value: string): string =>\n  `ES${compact(value)}`;\n\n/** Generate a random valid Spanish VAT (DNI form). */\nconst generate = (): string => {\n  const letters = \"TRWAGMYFPDXBNJZSQVHLCKE\";\n  const num = randomDigits(8);\n  return num + letters.charAt(Number(num) % 23);\n};\n\n/** Spanish VAT Number. */\nconst vat: CountryValidator<\"ES\"> = {\n  name: \"Spanish VAT Number\",\n  localName: \"Número de Identificación Fiscal\",\n  abbreviation: \"NIF\",\n  aliases: [\n    \"NIF\",\n    \"CIF\",\n    \"número de identificación fiscal\",\n  ] as const,\n  candidatePattern: \"ES[A-Z]\\\\d{7}[A-Z\\\\d]\",\n  scope: \"country\",\n  country: \"ES\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.agenciatributaria.es/\",\n  examples: [\"12345678Z\", \"A78304516\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { cifChecksum, compact, format, validate, generate };\n"],"mappings":"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"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/generated/es/vat.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator, getBinding } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst vat: CountryValidator<\"ES\"> = createValidator(\n  \"es.vat\",\n  68,\n);\n\nexport default vat;\nexport const compact = vat.compact;\nexport const format = vat.format;\nexport const validate = vat.validate;\nexport const generate = (): string =>\n  vat.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator es.vat cannot generate values\",\n    );\n  })();\nexport const cifChecksum = (digits: string): number =>\n  getBinding().esVatCifChecksum(digits);\n"],"mappings":";;AAIA,MAAM,MAA8B,gBAClC,UACA,EACF;AAGA,MAAa,UAAU,IAAI;AAC3B,MAAa,SAAS,IAAI;AAC1B,MAAa,WAAW,IAAI;AAC5B,MAAa,iBACX,IAAI,WAAW,YACR;CACL,MAAM,IAAI,MACR,yCACF;AACF,EAAA,CAAG;AACL,MAAa,eAAe,WAC1B,WAAW,CAAC,CAAC,iBAAiB,MAAM"}

package/dist/eu/mod.d.ts

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

package/dist/eu/mod.js

@@ -1,8 +1,8 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
-import euVat from "./vat.js";
-//#region src/eu/mod.ts
-var eu_exports = /* @__PURE__ */ __exportAll({ vat: () => euVat });
+import vat from "./vat.js";
+//#region src/generated/eu/mod.ts
+var eu_exports = /* @__PURE__ */ __exportAll({ vat: () => vat });
 //#endregion
-export { eu_exports, euVat as vat };
+export { eu_exports, vat };
 
 //# sourceMappingURL=mod.js.map

package/dist/eu/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":[],"sources":["../../src/eu/mod.ts"],"sourcesContent":["export { default as vat } from \"./vat\";\n"],"mappings":""}
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/generated/eu/mod.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nexport { default as vat } from \"./vat\";\n"],"mappings":""}

package/dist/eu/vat.d.ts

@@ -1,21 +1,10 @@
 import { GlobalValidator, ValidateResult } from "../types.js";
-
-//#region src/eu/vat.d.ts
+//#region src/generated/eu/vat.d.ts
+declare const vat: GlobalValidator;
 declare const compact: (value: string) => string;
-declare const validate: (value: string) => ValidateResult;
-/**
- * Format returns the compact EU VAT form:
- * `CC` + country-compacted number. Equivalent to
- * compact() because country format() methods
- * prepend their own prefix (e.g., AT UID format
- * returns "ATU..."), which would cause double-
- * prefixing if used here.
- */
 declare const format: (value: string) => string;
-/** Generate a random EU VAT number from a member validator. */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/** European Union VAT Number. */
-declare const euVat: GlobalValidator;
 //#endregion
-export { compact, euVat as default, format, generate, validate };
+export { compact, vat as default, format, generate, validate };
 //# sourceMappingURL=vat.d.ts.map

package/dist/eu/vat.js

@@ -1,187 +1,13 @@
-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";
-import vat$1 from "../bg/vat.js";
-import vat$2 from "../cy/vat.js";
-import dic from "../cz/dic.js";
-import vat$3 from "../de/vat.js";
-import vat$4 from "../dk/vat.js";
-import vat$5 from "../ee/vat.js";
-import vat$6 from "../es/vat.js";
-import vat$7 from "../fi/vat.js";
-import tva from "../fr/tva.js";
-import vat$8 from "../gb/vat.js";
-import vat$9 from "../gr/vat.js";
-import vat$10 from "../hr/vat.js";
-import vat$11 from "../hu/vat.js";
-import vat$12 from "../ie/vat.js";
-import iva from "../it/iva.js";
-import vat$13 from "../lt/vat.js";
-import vat$14 from "../lu/vat.js";
-import vat$15 from "../lv/vat.js";
-import vat$16 from "../mt/vat.js";
-import vat$17 from "../nl/vat.js";
-import nip from "../pl/nip.js";
-import vat$18 from "../pt/vat.js";
-import vat$19 from "../ro/vat.js";
-import vat$20 from "../se/vat.js";
-import vat$21 from "../si/vat.js";
-import dic$1 from "../sk/dic.js";
-//#region src/eu/vat.ts
-/**
-* EU VAT (European Union VAT Number).
-*
-* Dispatcher that routes to per-country VAT
-* validators. Extracts the 2-letter country prefix
-* and delegates to the matching country module.
-*
-* Special cases:
-*   - EL → Greece (gr.vat)
-*   - XI → Northern Ireland (gb.vat)
-*
-* @see https://ec.europa.eu/taxation_customs/vies/
-*/
-/**
-* Map of EU VAT country prefixes to their
-* country-specific validators.
-*/
-const VALIDATORS = {
-	AT: uid,
-	BE: vat,
-	BG: vat$1,
-	CY: vat$2,
-	CZ: dic,
-	DE: vat$3,
-	DK: vat$4,
-	EE: vat$5,
-	EL: vat$9,
-	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,
-	XI: vat$8
-};
-/**
-* Extract the 2-letter country prefix and the
-* remaining number from an EU VAT string.
-*/
-const splitPrefix = (value) => {
-	const v = clean(value, " -").toUpperCase();
-	if (v.length < 3) return void 0;
-	const cc = v.slice(0, 2);
-	if (!/^[A-Z]{2}$/.test(cc)) return void 0;
-	return {
-		cc,
-		rest: v.slice(2)
-	};
-};
-const compact = (value) => {
-	const parts = splitPrefix(value);
-	if (parts === void 0) return clean(value, " -").toUpperCase();
-	const validator = VALIDATORS[parts.cc];
-	if (validator === void 0) return clean(value, " -").toUpperCase();
-	return `${parts.cc}${validator.compact(parts.rest)}`;
-};
-const validate = (value) => {
-	const parts = splitPrefix(value);
-	if (parts === void 0) return err("INVALID_FORMAT", "EU VAT must start with a 2-letter country code");
-	const validator = VALIDATORS[parts.cc];
-	if (validator === void 0) return err("INVALID_COMPONENT", `Unsupported EU VAT country: ${parts.cc}`);
-	const result = validator.validate(parts.rest);
-	if (!result.valid) return result;
-	return {
-		valid: true,
-		compact: `${parts.cc}${result.compact}`
-	};
-};
-/**
-* Format returns the compact EU VAT form:
-* `CC` + country-compacted number. Equivalent to
-* compact() because country format() methods
-* prepend their own prefix (e.g., AT UID format
-* returns "ATU..."), which would cause double-
-* prefixing if used here.
-*/
-const format = (value) => {
-	const parts = splitPrefix(value);
-	if (parts === void 0) return value;
-	const validator = VALIDATORS[parts.cc];
-	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 = {
-	scope: "global",
-	name: "EU VAT Number",
-	localName: "EU VAT Number",
-	abbreviation: "EU VAT",
-	aliases: ["EU VAT", "VAT identification number"],
-	candidatePattern: "[A-Z]{2}\\d{8,12}",
-	entityType: "company",
-	sourceUrl: "https://ec.europa.eu/taxation_customs/vies/",
-	examples: ["ATU13585627", "DE136695976"],
-	compact,
-	format,
-	validate,
-	generate
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/eu/vat.ts
+const vat = createValidator("eu.vat", 69);
+const compact = vat.compact;
+const format = vat.format;
+const validate = vat.validate;
+const generate = () => vat.generate?.() ?? (() => {
+	throw new Error("Validator eu.vat cannot generate values");
+})();
 //#endregion
-export { compact, euVat as default, format, generate, validate };
+export { compact, vat 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 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 {\n  GlobalValidator,\n  ValidateResult,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\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: GlobalValidator = {\n  scope: \"global\",\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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"}
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/generated/eu/vat.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { GlobalValidator } from \"../../types\";\n\nconst vat: GlobalValidator = createValidator(\"eu.vat\", 69);\n\nexport default vat;\nexport const compact = vat.compact;\nexport const format = vat.format;\nexport const validate = vat.validate;\nexport const generate = (): string =>\n  vat.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator eu.vat cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,MAAuB,gBAAgB,UAAU,EAAE;AAGzD,MAAa,UAAU,IAAI;AAC3B,MAAa,SAAS,IAAI;AAC1B,MAAa,WAAW,IAAI;AAC5B,MAAa,iBACX,IAAI,WAAW,YACR;CACL,MAAM,IAAI,MACR,yCACF;AACF,EAAA,CAAG"}

package/dist/fi/hetu.d.ts

@@ -1,18 +1,11 @@
-import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
-
-//#region src/fi/hetu.d.ts
+import { CountryValidator, ParsedIdentifier, ParsedPersonId, ValidateResult } from "../types.js";
+//#region src/generated/fi/hetu.d.ts
+declare const hetu: CountryValidator<"FI", ParsedPersonId>;
 declare const compact: (value: string) => string;
-declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
-/**
- * Extract birth date and gender from a HETU.
- * Returns null if the value is not valid.
- */
-declare const parse: (value: string) => ParsedPersonId | null;
-/** Generate a random valid HETU. */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/** Finnish Personal Identity Code. */
-declare const hetu: CountryValidator<"FI", ParsedPersonId>;
+declare const parse: ((value: string) => ParsedIdentifier | null) & ((value: string) => ParsedPersonId | null);
 //#endregion
 export { compact, hetu as default, format, generate, parse, validate };
 //# sourceMappingURL=hetu.d.ts.map

package/dist/fi/hetu.js

@@ -1,113 +1,13 @@
-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";
-//#region src/fi/hetu.ts
-const CHECK_CHARS = "0123456789ABCDEFHJKLMNPRSTUVWXY";
-const SEPARATORS_1800 = new Set(["+"]);
-const SEPARATORS_1900 = new Set([
-	"-",
-	"Y",
-	"X",
-	"W",
-	"V",
-	"U"
-]);
-const SEPARATORS_2000 = new Set([
-	"A",
-	"B",
-	"C",
-	"D",
-	"E",
-	"F"
-]);
-const compact = (value) => clean(value, " ").toUpperCase();
-const validate = (value) => {
-	const v = compact(value);
-	if (v.length !== 11) return err("INVALID_LENGTH", "HETU must be exactly 11 characters");
-	const dd = v.slice(0, 2);
-	const mm = v.slice(2, 4);
-	const yy = v.slice(4, 6);
-	const separator = v.charAt(6);
-	const serial = v.slice(7, 10);
-	const checkChar = v.charAt(10);
-	if (!isdigits(dd) || !isdigits(mm) || !isdigits(yy)) return err("INVALID_FORMAT", "HETU date part must be digits");
-	if (!isdigits(serial)) return err("INVALID_FORMAT", "HETU serial must be digits");
-	let century;
-	if (SEPARATORS_1800.has(separator)) century = 1800;
-	else if (SEPARATORS_1900.has(separator)) century = 1900;
-	else if (SEPARATORS_2000.has(separator)) century = 2e3;
-	else return err("INVALID_COMPONENT", "HETU separator is invalid");
-	if (!isValidDate(century + Number(yy), Number(mm), Number(dd))) return err("INVALID_COMPONENT", "HETU contains an invalid date");
-	const serialNum = Number(serial);
-	if (serialNum < 2) return err("INVALID_COMPONENT", "HETU individual number must be >= 002");
-	if (serialNum >= 900) return err("INVALID_COMPONENT", "HETU temporary individual range 900-999");
-	const checkNum = Number(`${dd}${mm}${yy}${serial}`);
-	if (checkChar !== CHECK_CHARS.charAt(checkNum % 31)) return err("INVALID_CHECKSUM", "HETU check character does not match");
-	return {
-		valid: true,
-		compact: v
-	};
-};
-const format = (value) => compact(value);
-/**
-* Extract birth date and gender from a HETU.
-* Returns null if the value is not valid.
-*/
-const parse = (value) => {
-	const result = validate(value);
-	if (!result.valid) return null;
-	const v = result.compact;
-	const dd = Number(v.slice(0, 2));
-	const mm = Number(v.slice(2, 4));
-	const yy = Number(v.slice(4, 6));
-	const separator = v.charAt(6);
-	const serial = Number(v.slice(7, 10));
-	let century;
-	if (SEPARATORS_1800.has(separator)) century = 1800;
-	else if (SEPARATORS_1900.has(separator)) century = 1900;
-	else century = 2e3;
-	const year = century + yy;
-	return {
-		birthDate: new Date(year, mm - 1, dd),
-		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",
-	localName: "Henkilötunnus",
-	abbreviation: "HETU",
-	aliases: [
-		"henkilötunnus",
-		"HETU",
-		"sosiaaliturvatunnus"
-	],
-	candidatePattern: "\\d{6}[-+A]\\d{3}[\\dA-Z]",
-	scope: "country",
-	country: "FI",
-	entityType: "person",
-	sourceUrl: "https://dvv.fi/en/personal-identity-code",
-	lengths: [11],
-	examples: ["131052-308T"],
-	compact,
-	format,
-	parse,
-	validate,
-	generate
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/fi/hetu.ts
+const hetu = createValidator("fi.hetu", 70);
+const compact = hetu.compact;
+const format = hetu.format;
+const validate = hetu.validate;
+const generate = () => hetu.generate?.() ?? (() => {
+	throw new Error("Validator fi.hetu cannot generate values");
+})();
+const parse = hetu.parse;
 //#endregion
 export { compact, hetu as default, format, generate, parse, validate };
 

package/dist/fi/hetu.js.map

@@ -1 +1 @@
-{"version":3,"file":"hetu.js","names":[],"sources":["../../src/fi/hetu.ts"],"sourcesContent":["/**\n * HETU (Henkilötunnus).\n *\n * Finnish personal identity code. 11 characters in\n * format DDMMYY+CCC+X where the separator indicates\n * the century and X is a check character.\n *\n * @see https://dvv.fi/en/personal-identity-code\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 CHECK_CHARS = \"0123456789ABCDEFHJKLMNPRSTUVWXY\";\n\nconst SEPARATORS_1800 = new Set([\"+\"]);\nconst SEPARATORS_1900 = new Set([\n  \"-\",\n  \"Y\",\n  \"X\",\n  \"W\",\n  \"V\",\n  \"U\",\n]);\nconst SEPARATORS_2000 = new Set([\n  \"A\",\n  \"B\",\n  \"C\",\n  \"D\",\n  \"E\",\n  \"F\",\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 !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"HETU must be exactly 11 characters\",\n    );\n  }\n\n  const dd = v.slice(0, 2);\n  const mm = v.slice(2, 4);\n  const yy = v.slice(4, 6);\n  const separator = v.charAt(6);\n  const serial = v.slice(7, 10);\n  const checkChar = v.charAt(10);\n\n  if (!isdigits(dd) || !isdigits(mm) || !isdigits(yy)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"HETU date part must be digits\",\n    );\n  }\n  if (!isdigits(serial)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"HETU serial must be digits\",\n    );\n  }\n\n  let century: number;\n  if (SEPARATORS_1800.has(separator)) {\n    century = 1800;\n  } else if (SEPARATORS_1900.has(separator)) {\n    century = 1900;\n  } else if (SEPARATORS_2000.has(separator)) {\n    century = 2000;\n  } else {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU separator is invalid\",\n    );\n  }\n\n  const year = century + Number(yy);\n  const month = Number(mm);\n  const day = Number(dd);\n\n  if (!isValidDate(year, month, day)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU contains an invalid date\",\n    );\n  }\n\n  // Individual number must be >= 002\n  const serialNum = Number(serial);\n  if (serialNum < 2) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU individual number must be >= 002\",\n    );\n  }\n  // Temporary range 900-999 is not valid\n  if (serialNum >= 900) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"HETU temporary individual range 900-999\",\n    );\n  }\n\n  const checkNum = Number(`${dd}${mm}${yy}${serial}`);\n  const expected = CHECK_CHARS.charAt(checkNum % 31);\n  if (checkChar !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"HETU check character 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 a HETU.\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 dd = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const yy = Number(v.slice(4, 6));\n  const separator = v.charAt(6);\n  const serial = Number(v.slice(7, 10));\n\n  let century: number;\n  if (SEPARATORS_1800.has(separator)) {\n    century = 1800;\n  } else if (SEPARATORS_1900.has(separator)) {\n    century = 1900;\n  } else {\n    century = 2000;\n  }\n\n  const year = century + yy;\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender: serial % 2 === 0 ? \"female\" : \"male\",\n  };\n};\n\n/** Generate a random valid HETU. */\nconst generate = (): string => {\n  const year = randomInt(1900, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const separator = year >= 2000 ? \"A\" : \"-\";\n  const serial = String(randomInt(2, 899)).padStart(3, \"0\");\n  const checkNum = Number(`${day}${month}${yy}${serial}`);\n  const checkChar = CHECK_CHARS.charAt(checkNum % 31);\n  return `${day}${month}${yy}${separator}${serial}${checkChar}`;\n};\n\n/** Finnish Personal Identity Code. */\nconst hetu: CountryValidator<\"FI\", ParsedPersonId> = {\n  name: \"Finnish Personal ID\",\n  localName: \"Henkilötunnus\",\n  abbreviation: \"HETU\",\n  aliases: [\n    \"henkilötunnus\",\n    \"HETU\",\n    \"sosiaaliturvatunnus\",\n  ] as const,\n  candidatePattern: \"\\\\d{6}[-+A]\\\\d{3}[\\\\dA-Z]\",\n  scope: \"country\",\n  country: \"FI\",\n  entityType: \"person\",\n  sourceUrl: \"https://dvv.fi/en/personal-identity-code\",\n  lengths: [11] as const,\n  examples: [\"131052-308T\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default hetu;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"hetu.js","names":[],"sources":["../../src/generated/fi/hetu.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type {\n  CountryValidator,\n  ParsedPersonId,\n} from \"../../types\";\n\nconst hetu: CountryValidator<\"FI\", ParsedPersonId> =\n  createValidator(\"fi.hetu\", 70);\n\nexport default hetu;\nexport const compact = hetu.compact;\nexport const format = hetu.format;\nexport const validate = hetu.validate;\nexport const generate = (): string =>\n  hetu.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator fi.hetu cannot generate values\",\n    );\n  })();\nexport const parse = hetu.parse;\n"],"mappings":";;AAOA,MAAM,OACJ,gBAAgB,WAAW,EAAE;AAG/B,MAAa,UAAU,KAAK;AAC5B,MAAa,SAAS,KAAK;AAC3B,MAAa,WAAW,KAAK;AAC7B,MAAa,iBACX,KAAK,WAAW,YACT;CACL,MAAM,IAAI,MACR,0CACF;AACF,EAAA,CAAG;AACL,MAAa,QAAQ,KAAK"}

package/dist/fi/mod.d.ts

@@ -1,8 +1,6 @@
 import hetu from "./hetu.js";
 import vat from "./vat.js";
 import ytunnus from "./ytunnus.js";
-
-//#region src/fi/mod.d.ts
 declare namespace mod_d_exports {
   export { hetu, vat, ytunnus };
 }

package/dist/fi/mod.js

@@ -1,8 +1,8 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
-import vat from "./vat.js";
 import hetu from "./hetu.js";
+import vat from "./vat.js";
 import ytunnus from "./ytunnus.js";
-//#region src/fi/mod.ts
+//#region src/generated/fi/mod.ts
 var fi_exports = /* @__PURE__ */ __exportAll({
 	hetu: () => hetu,
 	vat: () => vat,

package/dist/fi/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":[],"sources":["../../src/fi/mod.ts"],"sourcesContent":["export { default as hetu } from \"./hetu\";\nexport { default as vat } from \"./vat\";\nexport { default as ytunnus } from \"./ytunnus\";\n"],"mappings":""}
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/generated/fi/mod.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nexport { default as hetu } from \"./hetu\";\nexport { default as vat } from \"./vat\";\nexport { default as ytunnus } from \"./ytunnus\";\n"],"mappings":""}

package/dist/fi/vat.d.ts

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