@stll/stdnum 2.1.1 → 2.1.2

package/dist/nz/ird.js.map

@@ -1 +1 @@
-{"version":3,"file":"ird.js","names":[],"sources":["../../src/nz/ird.ts"],"sourcesContent":["/**\n * IRD number (New Zealand Inland Revenue Department\n * number, Te Tari Take).\n *\n * 8 or 9 digit number with a weighted checksum.\n * Uses primary weights, falling back to secondary\n * weights if the primary check yields 10.\n *\n * @see https://www.ird.govt.nz/\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 PRIMARY_WEIGHTS = [3, 2, 7, 6, 5, 4, 3, 2] as const;\n\nconst SECONDARY_WEIGHTS = [7, 4, 3, 2, 5, 2, 7, 6] as const;\n\n/**\n * Calculate the check digit for an IRD number.\n * The input should be the number without the check\n * digit, zero-padded to 8 digits.\n */\nconst calcCheckDigit = (payload: string): number | null => {\n  const padded = payload.padStart(8, \"0\");\n  let sum = 0;\n  for (const [i, weight] of PRIMARY_WEIGHTS.entries()) {\n    sum += weight * Number(padded[i]);\n  }\n  let remainder = ((-sum % 11) + 11) % 11;\n  if (remainder !== 10) return remainder;\n\n  sum = 0;\n  for (const [i, weight] of SECONDARY_WEIGHTS.entries()) {\n    sum += weight * Number(padded[i]);\n  }\n  remainder = ((-sum % 11) + 11) % 11;\n  if (remainder === 10) return null;\n  return remainder;\n};\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -\").toUpperCase();\n  if (v.startsWith(\"NZ\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8 && v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"IRD number must be 8 or 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"IRD number must contain only digits\",\n    );\n  }\n  const num = Number(v);\n  if (num < 10_000_000 || num >= 150_000_000) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"IRD number out of valid range\",\n    );\n  }\n  const payload = v.slice(0, -1);\n  const expected = calcCheckDigit(payload);\n  if (expected === null) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"IRD number cannot have a valid check digit\",\n    );\n  }\n  if (expected !== Number(v.at(-1))) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"IRD check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  const last6 = v.slice(-6);\n  const prefix = v.slice(0, -6);\n  return `${prefix}-${last6.slice(0, 3)}-${last6.slice(3)}`;\n};\n\n/** Generate a random valid NZ IRD number. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(9);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** New Zealand IRD Number. */\nconst ird: CountryValidator<\"NZ\"> = {\n  name: \"IRD Number\",\n  localName: \"IRD Number\",\n  abbreviation: \"IRD\",\n  aliases: [\"IRD number\", \"tax number NZ\"] as const,\n  candidatePattern: \"\\\\d{8,9}\",\n  scope: \"country\",\n  country: \"NZ\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  description:\n    \"New Zealand Inland Revenue Department number\",\n  sourceUrl: \"https://www.ird.govt.nz/\",\n  lengths: [8, 9] as const,\n  examples: [\"49091850\", \"136410132\"] as const,\n  generate,\n};\n\nexport default ird;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;AAqBA,MAAM,kBAAkB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAE/C,MAAM,oBAAoB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;;;;;;AAOjD,MAAM,kBAAkB,YAAmC;CACzD,MAAM,SAAS,QAAQ,SAAS,GAAG,GAAG;CACtC,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,gBAAgB,QAAQ,GAChD,OAAO,SAAS,OAAO,OAAO,EAAE;CAElC,IAAI,aAAc,CAAC,MAAM,KAAM,MAAM;CACrC,IAAI,cAAc,IAAI,OAAO;CAE7B,MAAM;CACN,KAAK,MAAM,CAAC,GAAG,WAAW,kBAAkB,QAAQ,GAClD,OAAO,SAAS,OAAO,OAAO,EAAE;CAElC,aAAc,CAAC,MAAM,KAAM,MAAM;CACjC,IAAI,cAAc,IAAI,OAAO;CAC7B,OAAO;AACT;AAEA,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,IAAI,CAAC,CAAC,YAAY;CACvC,IAAI,EAAE,WAAW,IAAI,GACnB,IAAI,EAAE,MAAM,CAAC;CAEf,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,KAAK,EAAE,WAAW,GACjC,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,qCACF;CAEF,MAAM,MAAM,OAAO,CAAC;CACpB,IAAI,MAAM,OAAc,OAAO,MAC7B,OAAO,IACL,qBACA,+BACF;CAGF,MAAM,WAAW,eADD,EAAE,MAAM,GAAG,EACW,CAAC;CACvC,IAAI,aAAa,MACf,OAAO,IACL,qBACA,4CACF;CAEF,IAAI,aAAa,OAAO,EAAE,GAAG,EAAE,CAAC,GAC9B,OAAO,IACL,oBACA,gCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,MAAM,QAAQ,EAAE,MAAM,EAAE;CAExB,OAAO,GADQ,EAAE,MAAM,GAAG,EACX,EAAE,GAAG,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,MAAM,MAAM,CAAC;AACxD;;AAGA,MAAM,iBAAyB;CAC7B,SAAS;EACP,MAAM,IAAI,aAAa,CAAC;EACxB,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,OAAO;CAChC;AACF;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,cAAc,eAAe;CACvC,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aACE;CACF,WAAW;CACX,SAAS,CAAC,GAAG,CAAC;CACd,UAAU,CAAC,YAAY,WAAW;CAClC;AACF"}
+{"version":3,"file":"ird.js","names":[],"sources":["../../src/generated/nz/ird.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst ird: CountryValidator<\"NZ\"> = createValidator(\n  \"nz.ird\",\n  139,\n);\n\nexport default ird;\nexport const compact = ird.compact;\nexport const format = ird.format;\nexport const validate = ird.validate;\nexport const generate = (): string =>\n  ird.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator nz.ird cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,MAA8B,gBAClC,UACA,GACF;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"}

package/dist/nz/mod.d.ts

@@ -1,6 +1,4 @@
 import ird from "./ird.js";
-
-//#region src/nz/mod.d.ts
 declare namespace mod_d_exports {
   export { ird };
 }

package/dist/nz/mod.js

@@ -1,6 +1,6 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import ird from "./ird.js";
-//#region src/nz/mod.ts
+//#region src/generated/nz/mod.ts
 var nz_exports = /* @__PURE__ */ __exportAll({ ird: () => ird });
 //#endregion
 export { ird, nz_exports };

package/dist/nz/mod.js.map

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

package/dist/pa/mod.d.ts

@@ -1,6 +1,4 @@
 import ruc from "./ruc.js";
-
-//#region src/pa/mod.d.ts
 declare namespace mod_d_exports {
   export { ruc };
 }

package/dist/pa/mod.js

@@ -1,6 +1,6 @@
 import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import ruc from "./ruc.js";
-//#region src/pa/mod.ts
+//#region src/generated/pa/mod.ts
 var pa_exports = /* @__PURE__ */ __exportAll({ ruc: () => ruc });
 //#endregion
 export { pa_exports, ruc };

package/dist/pa/mod.js.map

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

package/dist/pa/ruc.d.ts

@@ -1,22 +1,10 @@
 import { CountryValidator, ValidateResult } from "../types.js";
-
-//#region src/pa/ruc.d.ts
-/**
- * Compact: normalize Unicode, collapse whitespace,
- * strip colons around DV, and uppercase. Keeps
- * hyphens (structural separators) and a single
- * space before "DV".
- */
+//#region src/generated/pa/ruc.d.ts
+declare const ruc: CountryValidator<"PA">;
 declare const compact: (value: string) => string;
-declare const validate: (value: string) => ValidateResult;
-/**
- * Format: display as segments with " DV XX".
- */
 declare const format: (value: string) => string;
-/** Generate a random valid Panama RUC (natural person). */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/** Panama tax identification number. */
-declare const ruc: CountryValidator<"PA">;
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 //# sourceMappingURL=ruc.d.ts.map

package/dist/pa/ruc.js

@@ -1,184 +1,12 @@
-import { clean } from "../_util/clean.js";
-import { randomInt } from "../_util/generate.js";
-import { err } from "../_util/result.js";
-//#region src/pa/ruc.ts
-/**
-* Legacy cross-reference table: maps two-digit codes
-* at positions 5–6 of old-format juridical RUCs.
-*/
-const LEGACY_MAP = {
-	"00": "00",
-	"10": "01",
-	"11": "02",
-	"12": "03",
-	"13": "04",
-	"14": "05",
-	"15": "06",
-	"16": "07",
-	"17": "08",
-	"18": "09",
-	"19": "01",
-	"20": "02",
-	"21": "03",
-	"22": "04",
-	"23": "07",
-	"24": "08",
-	"25": "09",
-	"26": "02",
-	"27": "03",
-	"28": "04",
-	"29": "05",
-	"30": "06",
-	"31": "07",
-	"32": "08",
-	"33": "09",
-	"34": "01",
-	"35": "02",
-	"36": "03",
-	"37": "04",
-	"38": "05",
-	"39": "06",
-	"40": "07",
-	"41": "08",
-	"42": "09",
-	"43": "01",
-	"44": "02",
-	"45": "03",
-	"46": "04",
-	"47": "05",
-	"48": "06",
-	"49": "07"
-};
-/** Prepend n leading zeros. */
-const z = (n) => "0".repeat(Math.max(0, n));
-/**
-* Compute a single DV digit via weighted sum mod 11.
-* Weights start at 2 and increment, applied
-* right-to-left. For old-format juridical RUCs,
-* weight 12 is skipped (jumps from 11 to 13).
-*/
-const digitDV = (buf, isOldFormat) => {
-	let weight = 2;
-	let sum = 0;
-	for (let i = buf.length - 1; i >= 0; i--) {
-		if (isOldFormat && weight === 12) weight += 1;
-		sum += weight * (buf.charCodeAt(i) - 48);
-		weight += 1;
-	}
-	const r = sum % 11;
-	return r > 1 ? 11 - r : 0;
-};
-/**
-* Encode the RUC segments into a numeric buffer
-* according to entity type, then compute the two
-* DV digits.
-*
-* Returns the two-digit DV string, or null if the
-* format is unrecognized.
-*/
-const computeDV = (segments, raw) => {
-	const len = segments.length;
-	if (len < 3 || len > 4) return null;
-	if (len === 4 !== (segments[1] === "NT")) return null;
-	let buf;
-	let isOld = false;
-	const s0 = segments[0];
-	const s1 = segments[1];
-	const s2 = segments[2];
-	if (raw[0] === "E") buf = z(4 - s1.length) + "00000050050" + z(3 - s1.length) + s1 + z(5 - s2.length) + s2;
-	else if (s1 === "NT") {
-		const s3 = segments[3];
-		const prefix = s0.slice(0, -2);
-		buf = z(4 - s1.length) + "0000005" + z(4 - prefix.length) + prefix + "43" + z(3 - s2.length) + s2 + z(5 - s3.length) + s3;
-	} else if (s0.endsWith("AV")) {
-		const prefix = s0.slice(0, -2);
-		buf = z(4 - s1.length) + "0000005" + z(4 - prefix.length) + prefix + "15" + z(3 - s1.length) + s1 + z(5 - s2.length) + s2;
-	} else if (s0.endsWith("PI")) {
-		const prefix = s0.slice(0, -2);
-		buf = z(4 - s1.length) + "0000005" + z(4 - prefix.length) + prefix + "79" + z(3 - s1.length) + s1 + z(5 - s2.length) + s2;
-	} else if (s0 === "PE") buf = z(4 - s1.length) + "00000050075" + z(3 - s1.length) + s1 + z(5 - s2.length) + s2;
-	else if (raw[0] === "N") buf = z(4 - s1.length) + "00000050040" + z(3 - s1.length) + s1 + z(5 - s2.length) + s2;
-	else if (s0.length >= 1 && s0.length <= 2) buf = z(4 - s1.length) + "0000005" + z(2 - s0.length) + s0 + "00" + z(3 - s1.length) + s1 + z(5 - s2.length) + s2;
-	else {
-		buf = z(10 - s0.length) + s0 + z(4 - s1.length) + s1 + z(6 - s2.length) + s2;
-		isOld = buf[3] === "0" && buf[4] === "0" && buf[5] < "5";
-	}
-	if (isOld) {
-		const key = buf.slice(5, 7);
-		const mapped = LEGACY_MAP[key] ?? key;
-		buf = buf.slice(0, 5) + mapped + buf.slice(7);
-	}
-	const dv1 = digitDV(buf, isOld);
-	return `${dv1}${digitDV(buf + String.fromCharCode(48 + dv1), isOld)}`;
-};
-/**
-* Compact: normalize Unicode, collapse whitespace,
-* strip colons around DV, and uppercase. Keeps
-* hyphens (structural separators) and a single
-* space before "DV".
-*/
-const compact = (value) => {
-	let v = clean(value, "").trim().toUpperCase();
-	v = v.replace(/\s*DV[:\s]*(\d{2})$/, " DV$1");
-	v = v.replace(/\s+/g, " ");
-	return v;
-};
-const validate = (value) => {
-	const dvMatch = compact(value).match(/^(.+?)-?\s*DV[:\s]*(\d{2})$/);
-	if (!dvMatch) return err("INVALID_FORMAT", "Panama RUC must include DV (dígito verificador)");
-	const rucPart = dvMatch[1];
-	const dvPart = dvMatch[2];
-	const segments = rucPart.replace(/-+$/, "").split("-");
-	if (segments.length < 3 || segments.length > 4) return err("INVALID_FORMAT", "Panama RUC must have 3–4 hyphen-separated segments");
-	if (segments.some((s) => s.length === 0)) return err("INVALID_FORMAT", "Panama RUC segments must not be empty");
-	const computed = computeDV(segments, rucPart);
-	if (computed === null) return err("INVALID_FORMAT", "Unrecognized Panama RUC format");
-	if (computed !== dvPart) return err("INVALID_CHECKSUM", "Panama RUC dígito verificador does not match");
-	return {
-		valid: true,
-		compact: segments.join("-") + " DV" + dvPart
-	};
-};
-/**
-* Format: display as segments with " DV XX".
-*/
-const format = (value) => {
-	const v = compact(value);
-	const dvMatch = v.match(/^(.+?)-?\s*DV[:\s]*(\d{2})$/);
-	if (!dvMatch) return v;
-	const rucPart = dvMatch[1].replace(/-+$/, "");
-	const dvPart = dvMatch[2];
-	return `${rucPart.split("-").join("-")} DV ${dvPart}`;
-};
-/** Generate a random valid Panama RUC (natural person). */
-const generate = () => {
-	const segments = [
-		String(randomInt(1, 13)),
-		String(randomInt(1, 9999)),
-		String(randomInt(1, 99999))
-	];
-	const dv = computeDV(segments, segments.join("-"));
-	if (dv === null) throw new Error("Failed to compute Panama RUC DV");
-	return `${segments.join("-")} DV${dv}`;
-};
-/** Panama tax identification number. */
-const ruc = {
-	name: "Tax Identification Number",
-	localName: "Registro Único de Contribuyente",
-	abbreviation: "RUC",
-	aliases: ["RUC"],
-	candidatePattern: "\\d{1,2}-?\\d{1,4}-?\\d{1,6}",
-	scope: "country",
-	country: "PA",
-	entityType: "any",
-	description: "Tax identifier issued by Panama's DGI",
-	sourceUrl: "https://dgi.mef.gob.pa/",
-	examples: ["1-184-921 DV49", "2588017-1-831938 DV20"],
-	compact,
-	format,
-	validate,
-	generate
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/pa/ruc.ts
+const ruc = createValidator("pa.ruc", 140);
+const compact = ruc.compact;
+const format = ruc.format;
+const validate = ruc.validate;
+const generate = () => ruc.generate?.() ?? (() => {
+	throw new Error("Validator pa.ruc cannot generate values");
+})();
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 

package/dist/pa/ruc.js.map

@@ -1 +1 @@
-{"version":3,"file":"ruc.js","names":[],"sources":["../../src/pa/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyente, Panama\n * tax number).\n *\n * The RUC identifies taxpayers in Panama. It comes\n * in several formats depending on entity type\n * (natural person, legal entity, foreigner, etc.)\n * and is always accompanied by a two-digit check\n * code called the \"dígito verificador\" (DV).\n *\n * The DV is computed by encoding the hyphen-separated\n * RUC into a 20-position numeric buffer, then applying\n * a double weighted-sum mod 11 algorithm. The encoding\n * and legacy-format handling follow the official ANIP/DGI\n * specification.\n *\n * @see https://dgi.mef.gob.pa/\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\n/**\n * Legacy cross-reference table: maps two-digit codes\n * at positions 5–6 of old-format juridical RUCs.\n */\nconst LEGACY_MAP: Record<string, string> = {\n  \"00\": \"00\",\n  \"10\": \"01\",\n  \"11\": \"02\",\n  \"12\": \"03\",\n  \"13\": \"04\",\n  \"14\": \"05\",\n  \"15\": \"06\",\n  \"16\": \"07\",\n  \"17\": \"08\",\n  \"18\": \"09\",\n  \"19\": \"01\",\n  \"20\": \"02\",\n  \"21\": \"03\",\n  \"22\": \"04\",\n  \"23\": \"07\",\n  \"24\": \"08\",\n  \"25\": \"09\",\n  \"26\": \"02\",\n  \"27\": \"03\",\n  \"28\": \"04\",\n  \"29\": \"05\",\n  \"30\": \"06\",\n  \"31\": \"07\",\n  \"32\": \"08\",\n  \"33\": \"09\",\n  \"34\": \"01\",\n  \"35\": \"02\",\n  \"36\": \"03\",\n  \"37\": \"04\",\n  \"38\": \"05\",\n  \"39\": \"06\",\n  \"40\": \"07\",\n  \"41\": \"08\",\n  \"42\": \"09\",\n  \"43\": \"01\",\n  \"44\": \"02\",\n  \"45\": \"03\",\n  \"46\": \"04\",\n  \"47\": \"05\",\n  \"48\": \"06\",\n  \"49\": \"07\",\n};\n\n/** Prepend n leading zeros. */\nconst z = (n: number): string => \"0\".repeat(Math.max(0, n));\n\n/**\n * Compute a single DV digit via weighted sum mod 11.\n * Weights start at 2 and increment, applied\n * right-to-left. For old-format juridical RUCs,\n * weight 12 is skipped (jumps from 11 to 13).\n */\nconst digitDV = (\n  buf: string,\n  isOldFormat: boolean,\n): number => {\n  let weight = 2;\n  let sum = 0;\n  for (let i = buf.length - 1; i >= 0; i--) {\n    if (isOldFormat && weight === 12) {\n      weight += 1; // skip 12, continue from 13\n    }\n    sum += weight * (buf.charCodeAt(i) - 48);\n    weight += 1;\n  }\n  const r = sum % 11;\n  return r > 1 ? 11 - r : 0;\n};\n\n/**\n * Encode the RUC segments into a numeric buffer\n * according to entity type, then compute the two\n * DV digits.\n *\n * Returns the two-digit DV string, or null if the\n * format is unrecognized.\n */\nconst computeDV = (\n  segments: readonly string[],\n  raw: string,\n): string | null => {\n  const len = segments.length;\n\n  if (len < 3 || len > 4) {\n    return null;\n  }\n  // The NT designation requires exactly 4 segments\n  // (xxNT-NT-xxx-xxx); any other 4-segment shape is\n  // unrecognized, and a 3-segment \"NT\" in position 1\n  // is malformed.\n  if ((len === 4) !== (segments[1] === \"NT\")) {\n    return null;\n  }\n\n  let buf: string;\n  let isOld = false;\n\n  // SAFETY: length check above ensures 3..4 segments.\n  // eslint-disable-next-line no-non-null-assertion\n  const s0 = segments[0]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const s1 = segments[1]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const s2 = segments[2]!;\n\n  if (raw[0] === \"E\") {\n    // Foreign person (E-xxx-xxx)\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      \"00\" +\n      \"50\" +\n      z(3 - s1.length) +\n      s1 +\n      z(5 - s2.length) +\n      s2;\n  } else if (s1 === \"NT\") {\n    // NT designation (xxNT-NT-xxx-xxx)\n    // SAFETY: NT branch implies len === 4 (checked above).\n    // eslint-disable-next-line no-non-null-assertion\n    const s3 = segments[3]!;\n    const prefix = s0.slice(0, -2);\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      z(4 - prefix.length) +\n      prefix +\n      \"43\" +\n      z(3 - s2.length) +\n      s2 +\n      z(5 - s3.length) +\n      s3;\n  } else if (s0.endsWith(\"AV\")) {\n    // AV suffix\n    const prefix = s0.slice(0, -2);\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      z(4 - prefix.length) +\n      prefix +\n      \"15\" +\n      z(3 - s1.length) +\n      s1 +\n      z(5 - s2.length) +\n      s2;\n  } else if (s0.endsWith(\"PI\")) {\n    // PI suffix\n    const prefix = s0.slice(0, -2);\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      z(4 - prefix.length) +\n      prefix +\n      \"79\" +\n      z(3 - s1.length) +\n      s1 +\n      z(5 - s2.length) +\n      s2;\n  } else if (s0 === \"PE\") {\n    // PE prefix (foreign-born)\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      \"00\" +\n      \"75\" +\n      z(3 - s1.length) +\n      s1 +\n      z(5 - s2.length) +\n      s2;\n  } else if (raw[0] === \"N\") {\n    // N prefix (naturalized citizen)\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      \"00\" +\n      \"40\" +\n      z(3 - s1.length) +\n      s1 +\n      z(5 - s2.length) +\n      s2;\n  } else if (s0.length >= 1 && s0.length <= 2) {\n    // Natural person (province 1–2 digits)\n    buf =\n      z(4 - s1.length) +\n      \"0000005\" +\n      z(2 - s0.length) +\n      s0 +\n      \"00\" +\n      z(3 - s1.length) +\n      s1 +\n      z(5 - s2.length) +\n      s2;\n  } else {\n    // Juridical (company)\n    buf =\n      z(10 - s0.length) +\n      s0 +\n      z(4 - s1.length) +\n      s1 +\n      z(6 - s2.length) +\n      s2;\n    // SAFETY: juridical branch zero-pads s0 to at least\n    // 10 chars (z(10 - s0.length)), so buf[3..6] are\n    // always defined.\n    isOld =\n      buf[3] === \"0\" &&\n      buf[4] === \"0\" &&\n      // eslint-disable-next-line no-non-null-assertion\n      buf[5]! < \"5\";\n  }\n\n  // Apply legacy cross-reference for old format\n  if (isOld) {\n    const key = buf.slice(5, 7);\n    const mapped = LEGACY_MAP[key] ?? key;\n    buf = buf.slice(0, 5) + mapped + buf.slice(7);\n  }\n\n  const dv1 = digitDV(buf, isOld);\n  const dv2 = digitDV(\n    buf + String.fromCharCode(48 + dv1),\n    isOld,\n  );\n\n  return `${dv1}${dv2}`;\n};\n\n/**\n * Compact: normalize Unicode, collapse whitespace,\n * strip colons around DV, and uppercase. Keeps\n * hyphens (structural separators) and a single\n * space before \"DV\".\n */\nconst compact = (value: string): string => {\n  let v = clean(value, \"\").trim().toUpperCase();\n  // Normalize DV portion: \" DV: 49\" -> \" DV49\"\n  v = v.replace(/\\s*DV[:\\s]*(\\d{2})$/, \" DV$1\");\n  // Collapse any remaining internal whitespace\n  v = v.replace(/\\s+/g, \" \");\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  // Extract the DV portion: \"...DV49\", \"...DV:49\",\n  // or \"... DV 49\"\n  const dvMatch = v.match(/^(.+?)-?\\s*DV[:\\s]*(\\d{2})$/);\n\n  if (!dvMatch) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Panama RUC must include DV \" +\n        \"(dígito verificador)\",\n    );\n  }\n\n  // SAFETY: both DV regex capture groups are required.\n  // eslint-disable-next-line no-non-null-assertion\n  const rucPart = dvMatch[1]!;\n  // eslint-disable-next-line no-non-null-assertion\n  const dvPart = dvMatch[2]!;\n\n  // The RUC part should be hyphen-separated segments\n  const segments = rucPart.replace(/-+$/, \"\").split(\"-\");\n\n  if (segments.length < 3 || segments.length > 4) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Panama RUC must have 3–4 \" +\n        \"hyphen-separated segments\",\n    );\n  }\n\n  if (segments.some((s) => s.length === 0)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Panama RUC segments must not be empty\",\n    );\n  }\n\n  const computed = computeDV(segments, rucPart);\n  if (computed === null) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Unrecognized Panama RUC format\",\n    );\n  }\n\n  if (computed !== dvPart) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Panama RUC dígito verificador \" + \"does not match\",\n    );\n  }\n\n  const compactForm = segments.join(\"-\") + \" DV\" + dvPart;\n  return { valid: true, compact: compactForm };\n};\n\n/**\n * Format: display as segments with \" DV XX\".\n */\nconst format = (value: string): string => {\n  const v = compact(value);\n  const dvMatch = v.match(/^(.+?)-?\\s*DV[:\\s]*(\\d{2})$/);\n  if (!dvMatch) return v;\n\n  // SAFETY: both DV regex capture groups are required.\n  // eslint-disable-next-line no-non-null-assertion\n  const rucPart = dvMatch[1]!.replace(/-+$/, \"\");\n  // eslint-disable-next-line no-non-null-assertion\n  const dvPart = dvMatch[2]!;\n  const segments = rucPart.split(\"-\");\n  return `${segments.join(\"-\")} DV ${dvPart}`;\n};\n\n/** Generate a random valid Panama RUC (natural person). */\nconst generate = (): string => {\n  const province = String(randomInt(1, 13));\n  const volume = String(randomInt(1, 9999));\n  const folio = String(randomInt(1, 99999));\n  const segments = [province, volume, folio];\n  const dv = computeDV(segments, segments.join(\"-\"));\n  if (dv === null) {\n    throw new Error(\"Failed to compute Panama RUC DV\");\n  }\n  return `${segments.join(\"-\")} DV${dv}`;\n};\n\n/** Panama tax identification number. */\nconst ruc: CountryValidator<\"PA\"> = {\n  name: \"Tax Identification Number\",\n  localName: \"Registro Único de Contribuyente\",\n  abbreviation: \"RUC\",\n  aliases: [\"RUC\"] as const,\n  candidatePattern: \"\\\\d{1,2}-?\\\\d{1,4}-?\\\\d{1,6}\",\n  scope: \"country\",\n  country: \"PA\",\n  entityType: \"any\",\n  description: \"Tax identifier issued by Panama's DGI\",\n  sourceUrl: \"https://dgi.mef.gob.pa/\",\n  examples: [\n    \"1-184-921 DV49\",\n    \"2588017-1-831938 DV20\",\n  ] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;AAgCA,MAAM,aAAqC;CACzC,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;AACR;;AAGA,MAAM,KAAK,MAAsB,IAAI,OAAO,KAAK,IAAI,GAAG,CAAC,CAAC;;;;;;;AAQ1D,MAAM,WACJ,KACA,gBACW;CACX,IAAI,SAAS;CACb,IAAI,MAAM;CACV,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,GAAG,KAAK;EACxC,IAAI,eAAe,WAAW,IAC5B,UAAU;EAEZ,OAAO,UAAU,IAAI,WAAW,CAAC,IAAI;EACrC,UAAU;CACZ;CACA,MAAM,IAAI,MAAM;CAChB,OAAO,IAAI,IAAI,KAAK,IAAI;AAC1B;;;;;;;;;AAUA,MAAM,aACJ,UACA,QACkB;CAClB,MAAM,MAAM,SAAS;CAErB,IAAI,MAAM,KAAK,MAAM,GACnB,OAAO;CAMT,IAAK,QAAQ,OAAQ,SAAS,OAAO,OACnC,OAAO;CAGT,IAAI;CACJ,IAAI,QAAQ;CAIZ,MAAM,KAAK,SAAS;CAEpB,MAAM,KAAK,SAAS;CAEpB,MAAM,KAAK,SAAS;CAEpB,IAAI,IAAI,OAAO,KAEb,MACE,EAAE,IAAI,GAAG,MAAM,IACf,gBAGA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;MACG,IAAI,OAAO,MAAM;EAItB,MAAM,KAAK,SAAS;EACpB,MAAM,SAAS,GAAG,MAAM,GAAG,EAAE;EAC7B,MACE,EAAE,IAAI,GAAG,MAAM,IACf,YACA,EAAE,IAAI,OAAO,MAAM,IACnB,SACA,OACA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;CACJ,OAAO,IAAI,GAAG,SAAS,IAAI,GAAG;EAE5B,MAAM,SAAS,GAAG,MAAM,GAAG,EAAE;EAC7B,MACE,EAAE,IAAI,GAAG,MAAM,IACf,YACA,EAAE,IAAI,OAAO,MAAM,IACnB,SACA,OACA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;CACJ,OAAO,IAAI,GAAG,SAAS,IAAI,GAAG;EAE5B,MAAM,SAAS,GAAG,MAAM,GAAG,EAAE;EAC7B,MACE,EAAE,IAAI,GAAG,MAAM,IACf,YACA,EAAE,IAAI,OAAO,MAAM,IACnB,SACA,OACA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;CACJ,OAAO,IAAI,OAAO,MAEhB,MACE,EAAE,IAAI,GAAG,MAAM,IACf,gBAGA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;MACG,IAAI,IAAI,OAAO,KAEpB,MACE,EAAE,IAAI,GAAG,MAAM,IACf,gBAGA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;MACG,IAAI,GAAG,UAAU,KAAK,GAAG,UAAU,GAExC,MACE,EAAE,IAAI,GAAG,MAAM,IACf,YACA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,OACA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;MACG;EAEL,MACE,EAAE,KAAK,GAAG,MAAM,IAChB,KACA,EAAE,IAAI,GAAG,MAAM,IACf,KACA,EAAE,IAAI,GAAG,MAAM,IACf;EAIF,QACE,IAAI,OAAO,OACX,IAAI,OAAO,OAEX,IAAI,KAAM;CACd;CAGA,IAAI,OAAO;EACT,MAAM,MAAM,IAAI,MAAM,GAAG,CAAC;EAC1B,MAAM,SAAS,WAAW,QAAQ;EAClC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,SAAS,IAAI,MAAM,CAAC;CAC9C;CAEA,MAAM,MAAM,QAAQ,KAAK,KAAK;CAM9B,OAAO,GAAG,MALE,QACV,MAAM,OAAO,aAAa,KAAK,GAAG,GAClC,KAGgB;AACpB;;;;;;;AAQA,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY;CAE5C,IAAI,EAAE,QAAQ,uBAAuB,OAAO;CAE5C,IAAI,EAAE,QAAQ,QAAQ,GAAG;CACzB,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAKlD,MAAM,UAJI,QAAQ,KAIF,CAAC,CAAC,MAAM,6BAA6B;CAErD,IAAI,CAAC,SACH,OAAO,IACL,kBACA,iDAEF;CAKF,MAAM,UAAU,QAAQ;CAExB,MAAM,SAAS,QAAQ;CAGvB,MAAM,WAAW,QAAQ,QAAQ,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG;CAErD,IAAI,SAAS,SAAS,KAAK,SAAS,SAAS,GAC3C,OAAO,IACL,kBACA,oDAEF;CAGF,IAAI,SAAS,MAAM,MAAM,EAAE,WAAW,CAAC,GACrC,OAAO,IACL,kBACA,uCACF;CAGF,MAAM,WAAW,UAAU,UAAU,OAAO;CAC5C,IAAI,aAAa,MACf,OAAO,IACL,kBACA,gCACF;CAGF,IAAI,aAAa,QACf,OAAO,IACL,oBACA,8CACF;CAIF,OAAO;EAAE,OAAO;EAAM,SADF,SAAS,KAAK,GAAG,IAAI,QAAQ;CACN;AAC7C;;;;AAKA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,MAAM,UAAU,EAAE,MAAM,6BAA6B;CACrD,IAAI,CAAC,SAAS,OAAO;CAIrB,MAAM,UAAU,QAAQ,EAAE,CAAE,QAAQ,OAAO,EAAE;CAE7C,MAAM,SAAS,QAAQ;CAEvB,OAAO,GADU,QAAQ,MAAM,GACd,CAAC,CAAC,KAAK,GAAG,EAAE,MAAM;AACrC;;AAGA,MAAM,iBAAyB;CAI7B,MAAM,WAAW;EAHA,OAAO,UAAU,GAAG,EAAE,CAGd;EAFV,OAAO,UAAU,GAAG,IAAI,CAEN;EADnB,OAAO,UAAU,GAAG,KAAK,CACC;CAAC;CACzC,MAAM,KAAK,UAAU,UAAU,SAAS,KAAK,GAAG,CAAC;CACjD,IAAI,OAAO,MACT,MAAM,IAAI,MAAM,iCAAiC;CAEnD,OAAO,GAAG,SAAS,KAAK,GAAG,EAAE,KAAK;AACpC;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,KAAK;CACf,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aAAa;CACb,WAAW;CACX,UAAU,CACR,kBACA,uBACF;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"ruc.js","names":[],"sources":["../../src/generated/pa/ruc.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst ruc: CountryValidator<\"PA\"> = createValidator(\n  \"pa.ruc\",\n  140,\n);\n\nexport default ruc;\nexport const compact = ruc.compact;\nexport const format = ruc.format;\nexport const validate = ruc.validate;\nexport const generate = (): string =>\n  ruc.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator pa.ruc cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,MAA8B,gBAClC,UACA,GACF;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"}

package/dist/patterns.d.ts

@@ -1,43 +1,14 @@
-import { CountryCode, CountryValidator, Validator } from "./types.js";
-
+import { CountryCode, CountryValidator, GlobalValidator, ParsedBirthDate, ParsedPersonId, Validator } from "./types.js";
 //#region src/patterns.d.ts
 type ValidatorPattern<TValidator extends Validator = Validator> = {
-  /** The validator this pattern was derived from. */validator: TValidator; /** Loose regex matching candidates in text. */
+  validator: TValidator;
   regex: RegExp;
 };
-/**
- * Derive a loose candidate-matching regex from
- * a validator. The regex finds potential matches;
- * use `validate()` to confirm.
- *
- * Handles both digit-only (IČO, NIP) and
- * alphanumeric (IBAN, BIC, ISIN, LEI) validators.
- */
-declare const toRegex: (v: Validator) => RegExp;
-/**
- * All discovered validators, lazily populated.
- * Import * from "../src" would pull everything;
- * instead, callers pass validators explicitly.
- */
-/**
- * Build patterns for a list of validators.
- */
+declare const toRegex: (validator: Validator) => RegExp;
 declare const toPatterns: <TValidator extends Validator>(validators: readonly TValidator[]) => ValidatorPattern<TValidator>[];
-/**
- * Filter validators by country code and build
- * patterns.
- */
-type CountryScopedValidator<TValidator extends Validator, TCountry extends CountryCode> = TValidator extends CountryValidator<infer TValidatorCountry, infer TParsed> ? TCountry extends TValidatorCountry ? TValidator & CountryValidator<TCountry, TParsed> : TValidatorCountry extends TCountry ? TValidator : never : never;
-declare const byCountry: <TCountry extends CountryCode, TValidator extends Validator>(country: TCountry, validators: readonly TValidator[]) => ValidatorPattern<CountryScopedValidator<TValidator, TCountry>>[];
-/**
- * Filter validators by entity type and build
- * patterns.
- */
-declare const byEntityType: <TValidator extends Validator>(entityType: "person" | "company" | "any", validators: readonly TValidator[]) => ValidatorPattern<TValidator>[];
-/**
- * Build patterns for ALL provided validators.
- */
-declare const allPatterns: <TValidator extends Validator>(validators: readonly TValidator[]) => ValidatorPattern<TValidator>[];
+declare const byCountry: <TCountry extends CountryCode>(country: TCountry) => ValidatorPattern<CountryValidator<TCountry>>[];
+declare const byEntityType: (entityType: Validator["entityType"]) => ValidatorPattern<CountryValidator<"AD"> | CountryValidator<"AE"> | CountryValidator<"AI"> | CountryValidator<"AL"> | CountryValidator<"AM"> | CountryValidator<"AR"> | CountryValidator<"AT"> | CountryValidator<"AU"> | CountryValidator<"AZ"> | CountryValidator<"BD"> | CountryValidator<"BE"> | CountryValidator<"BG"> | CountryValidator<"BH"> | CountryValidator<"BR"> | CountryValidator<"BY"> | CountryValidator<"BZ"> | CountryValidator<"CA"> | CountryValidator<"CH"> | CountryValidator<"CL"> | CountryValidator<"CN"> | CountryValidator<"CO"> | CountryValidator<"CR"> | CountryValidator<"CY"> | CountryValidator<"CZ"> | CountryValidator<"DE"> | CountryValidator<"DK"> | CountryValidator<"DO"> | CountryValidator<"EC"> | CountryValidator<"EE"> | CountryValidator<"EG"> | CountryValidator<"ES"> | CountryValidator<"FI"> | CountryValidator<"FR"> | CountryValidator<"GB"> | CountryValidator<"GE"> | CountryValidator<"GH"> | CountryValidator<"GR"> | CountryValidator<"GT"> | CountryValidator<"HK"> | CountryValidator<"HR"> | CountryValidator<"HU"> | CountryValidator<"ID"> | CountryValidator<"IE"> | CountryValidator<"IL"> | CountryValidator<"IN"> | CountryValidator<"IQ"> | CountryValidator<"IR"> | CountryValidator<"IS"> | CountryValidator<"IT"> | CountryValidator<"JP"> | CountryValidator<"KR"> | CountryValidator<"LI"> | CountryValidator<"LT"> | CountryValidator<"LU"> | CountryValidator<"LV"> | CountryValidator<"MA"> | CountryValidator<"MC"> | CountryValidator<"MD"> | CountryValidator<"ME"> | CountryValidator<"MK"> | CountryValidator<"MT"> | CountryValidator<"MU"> | CountryValidator<"MX"> | CountryValidator<"NG"> | CountryValidator<"NI"> | CountryValidator<"NL"> | CountryValidator<"NO"> | CountryValidator<"NZ"> | CountryValidator<"PA"> | CountryValidator<"PE"> | CountryValidator<"PH"> | CountryValidator<"PK"> | CountryValidator<"PL"> | CountryValidator<"PT"> | CountryValidator<"RO"> | CountryValidator<"RS"> | CountryValidator<"RU"> | CountryValidator<"SE"> | CountryValidator<"SG"> | CountryValidator<"SI"> | CountryValidator<"SK"> | CountryValidator<"TH"> | CountryValidator<"TR"> | CountryValidator<"TW"> | CountryValidator<"UA"> | CountryValidator<"US"> | CountryValidator<"UY"> | CountryValidator<"VE"> | CountryValidator<"VN"> | CountryValidator<"BA", ParsedPersonId> | CountryValidator<"BG", ParsedPersonId> | CountryValidator<"CN", ParsedPersonId> | CountryValidator<"CU", ParsedPersonId> | CountryValidator<"CZ", ParsedPersonId> | CountryValidator<"DK", ParsedPersonId> | CountryValidator<"EE", ParsedPersonId> | CountryValidator<"FI", ParsedPersonId> | CountryValidator<"FR", ParsedPersonId> | CountryValidator<"IT", ParsedPersonId> | CountryValidator<"KR", ParsedPersonId> | CountryValidator<"KW", ParsedBirthDate> | CountryValidator<"KZ", ParsedPersonId> | CountryValidator<"LK", ParsedPersonId> | CountryValidator<"MX", ParsedPersonId> | CountryValidator<"MY", ParsedPersonId> | CountryValidator<"NO", ParsedPersonId> | CountryValidator<"PL", ParsedPersonId> | CountryValidator<"RO", ParsedPersonId> | CountryValidator<"SE", ParsedPersonId> | CountryValidator<"SI", ParsedPersonId> | CountryValidator<"SK", ParsedPersonId> | CountryValidator<"ZA", ParsedPersonId> | GlobalValidator>[];
+declare const allPatterns: () => ValidatorPattern<CountryValidator<"AD"> | CountryValidator<"AE"> | CountryValidator<"AI"> | CountryValidator<"AL"> | CountryValidator<"AM"> | CountryValidator<"AR"> | CountryValidator<"AT"> | CountryValidator<"AU"> | CountryValidator<"AZ"> | CountryValidator<"BD"> | CountryValidator<"BE"> | CountryValidator<"BG"> | CountryValidator<"BH"> | CountryValidator<"BR"> | CountryValidator<"BY"> | CountryValidator<"BZ"> | CountryValidator<"CA"> | CountryValidator<"CH"> | CountryValidator<"CL"> | CountryValidator<"CN"> | CountryValidator<"CO"> | CountryValidator<"CR"> | CountryValidator<"CY"> | CountryValidator<"CZ"> | CountryValidator<"DE"> | CountryValidator<"DK"> | CountryValidator<"DO"> | CountryValidator<"EC"> | CountryValidator<"EE"> | CountryValidator<"EG"> | CountryValidator<"ES"> | CountryValidator<"FI"> | CountryValidator<"FR"> | CountryValidator<"GB"> | CountryValidator<"GE"> | CountryValidator<"GH"> | CountryValidator<"GR"> | CountryValidator<"GT"> | CountryValidator<"HK"> | CountryValidator<"HR"> | CountryValidator<"HU"> | CountryValidator<"ID"> | CountryValidator<"IE"> | CountryValidator<"IL"> | CountryValidator<"IN"> | CountryValidator<"IQ"> | CountryValidator<"IR"> | CountryValidator<"IS"> | CountryValidator<"IT"> | CountryValidator<"JP"> | CountryValidator<"KR"> | CountryValidator<"LI"> | CountryValidator<"LT"> | CountryValidator<"LU"> | CountryValidator<"LV"> | CountryValidator<"MA"> | CountryValidator<"MC"> | CountryValidator<"MD"> | CountryValidator<"ME"> | CountryValidator<"MK"> | CountryValidator<"MT"> | CountryValidator<"MU"> | CountryValidator<"MX"> | CountryValidator<"NG"> | CountryValidator<"NI"> | CountryValidator<"NL"> | CountryValidator<"NO"> | CountryValidator<"NZ"> | CountryValidator<"PA"> | CountryValidator<"PE"> | CountryValidator<"PH"> | CountryValidator<"PK"> | CountryValidator<"PL"> | CountryValidator<"PT"> | CountryValidator<"RO"> | CountryValidator<"RS"> | CountryValidator<"RU"> | CountryValidator<"SE"> | CountryValidator<"SG"> | CountryValidator<"SI"> | CountryValidator<"SK"> | CountryValidator<"TH"> | CountryValidator<"TR"> | CountryValidator<"TW"> | CountryValidator<"UA"> | CountryValidator<"US"> | CountryValidator<"UY"> | CountryValidator<"VE"> | CountryValidator<"VN"> | CountryValidator<"BA", ParsedPersonId> | CountryValidator<"BG", ParsedPersonId> | CountryValidator<"CN", ParsedPersonId> | CountryValidator<"CU", ParsedPersonId> | CountryValidator<"CZ", ParsedPersonId> | CountryValidator<"DK", ParsedPersonId> | CountryValidator<"EE", ParsedPersonId> | CountryValidator<"FI", ParsedPersonId> | CountryValidator<"FR", ParsedPersonId> | CountryValidator<"IT", ParsedPersonId> | CountryValidator<"KR", ParsedPersonId> | CountryValidator<"KW", ParsedBirthDate> | CountryValidator<"KZ", ParsedPersonId> | CountryValidator<"LK", ParsedPersonId> | CountryValidator<"MX", ParsedPersonId> | CountryValidator<"MY", ParsedPersonId> | CountryValidator<"NO", ParsedPersonId> | CountryValidator<"PL", ParsedPersonId> | CountryValidator<"RO", ParsedPersonId> | CountryValidator<"SE", ParsedPersonId> | CountryValidator<"SI", ParsedPersonId> | CountryValidator<"SK", ParsedPersonId> | CountryValidator<"ZA", ParsedPersonId> | GlobalValidator>[];
 //#endregion
 export { ValidatorPattern, allPatterns, byCountry, byEntityType, toPatterns, toRegex };
 //# sourceMappingURL=patterns.d.ts.map

package/dist/patterns.js

@@ -1,177 +1,16 @@
+import { allValidators } from "./registry.js";
 //#region src/patterns.ts
-/** Separator chars that compact() strips. */
-const SEP = "[\\s\\-./]?";
-/**
-* Infer compact lengths from metadata or examples.
-*/
-const inferLengths = (v) => {
-	if (v.lengths && v.lengths.length > 0) return [...v.lengths];
-	if (v.examples && v.examples.length > 0) {
-		const lens = /* @__PURE__ */ new Set();
-		for (const ex of v.examples) lens.add(v.compact(ex).length);
-		return [...lens];
-	}
-	return [];
+const toRegex = (validator) => {
+	if (validator.candidatePattern === void 0) throw new Error(`${validator.name} does not define a candidate pattern`);
+	return new RegExp(validator.candidatePattern, "g");
 };
-/**
-* Derive the display grouping from format().
-* Returns an array of group sizes, e.g.,
-* "25 123 891" → [2, 3, 3].
-*/
-const inferGroups = (v) => {
-	const first = v.examples?.[0];
-	if (first === void 0) return null;
-	const compact = v.compact(first);
-	const formatted = v.format(compact);
-	if (formatted === compact) return null;
-	const parts = formatted.split(/[^a-zA-Z0-9]+/);
-	if (parts.length <= 1) return null;
-	const isAlphanumeric = parts.some((p) => /[a-zA-Z]/.test(p) && /\d/.test(p));
-	const groups = parts.filter((p) => p.length > 0 && (isAlphanumeric || /\d/.test(p))).map((p) => p.length);
-	return groups.length > 1 ? groups : null;
-};
-/**
-* Detect if this validator uses a known prefix
-* (e.g., "CZ" for DIČ, "CHE" for Swiss UID).
-*/
-const inferPrefix = (v) => {
-	const examples = v.examples;
-	const first = examples?.[0];
-	if (!examples || first === void 0) return null;
-	const compact = v.compact(first);
-	const compactPrefix = compact.match(/^([A-Z]+)\d/)?.[1];
-	if (compactPrefix !== void 0 && examples.length > 1) {
-		if (examples.every((ex) => v.compact(ex).startsWith(compactPrefix))) return compactPrefix;
-	} else if (compactPrefix !== void 0 && examples.length === 1) return compactPrefix;
-	const fmtPrefix = v.format(compact).match(/^([A-Z]+)[\s\-./]?\d/)?.[1];
-	if (fmtPrefix !== void 0 && !compact.startsWith(fmtPrefix)) return fmtPrefix;
-	return null;
-};
-/**
-* Character class for a string fragment:
-* `\d` if all digits, `[A-Z]` if all letters,
-* `[A-Z0-9]` if mixed.
-*/
-const charClassFor = (s) => {
-	let hasLetter = false;
-	let hasDigit = false;
-	for (const ch of s) {
-		if (/[a-zA-Z]/.test(ch)) hasLetter = true;
-		if (/\d/.test(ch)) hasDigit = true;
-	}
-	if (hasLetter && hasDigit) return "[A-Z0-9]";
-	if (hasLetter) return "[A-Z]";
-	return "\\d";
-};
-/**
-* Determine the character class needed for the
-* compact form: `\d` if all digits, `[A-Z0-9]`
-* if alphanumeric, etc.
-*/
-const inferCharClass = (v) => {
-	if (!v.examples || v.examples.length === 0) return "\\d";
-	return charClassFor(v.examples.map((ex) => v.compact(ex)).join(""));
-};
-/**
-* Infer per-group sizes AND character classes from
-* format(). Returns groups with per-position char
-* classes, e.g., "12 010188 M 01 1" →
-*   sizes: [2, 6, 1, 2, 1]
-*   classes: ["\d", "\d", "[A-Z]", "\d", "\d"]
-*
-* Only returns non-null when per-group classes
-* differ (some groups are letters, some digits).
-* Letter-only groups before the first digit group
-* are treated as prefixes and excluded (handled
-* by inferPrefix separately).
-*/
-const inferPerGroup = (v) => {
-	const first = v.examples?.[0];
-	if (first === void 0) return null;
-	const compact = v.compact(first);
-	const formatted = v.format(compact);
-	if (formatted === compact) return null;
-	if (!(/[a-zA-Z]/.test(compact) && /\d/.test(compact))) return null;
-	const parts = formatted.split(/[^a-zA-Z0-9]+/);
-	if (parts.some((p) => /[a-zA-Z]/.test(p) && /\d/.test(p))) return null;
-	const filtered = [];
-	let seenDigitGroup = false;
-	for (const p of parts) {
-		if (p.length === 0) continue;
-		if (/\d/.test(p)) {
-			seenDigitGroup = true;
-			filtered.push({
-				size: p.length,
-				charClass: charClassFor(p)
-			});
-		} else if (seenDigitGroup) filtered.push({
-			size: p.length,
-			charClass: charClassFor(p)
-		});
-	}
-	if (filtered.length <= 1) return null;
-	const firstClass = filtered[0]?.charClass;
-	if (filtered.every((g) => g.charClass === firstClass)) return null;
-	return filtered;
-};
-/**
-* Build a group regex from group sizes + char class.
-* [2, 3, 3] with \d → /\d{2}[\s\-.]?\d{3}[\s\-.]?\d{3}/
-*/
-const groupsToPattern = (groups, cc) => groups.map((g) => `${cc}{${g}}`).join(SEP);
-/**
-* Build a group regex with per-group char classes.
-* Produces tighter patterns when groups have different
-* character types (e.g., digits vs letters).
-*/
-const groupsToPatternPerClass = (groups) => groups.map(({ size, charClass }) => `${charClass}{${size}}`).join(SEP);
-/**
-* Derive a loose candidate-matching regex from
-* a validator. The regex finds potential matches;
-* use `validate()` to confirm.
-*
-* Handles both digit-only (IČO, NIP) and
-* alphanumeric (IBAN, BIC, ISIN, LEI) validators.
-*/
-const toRegex = (v) => {
-	const prefix = inferPrefix(v);
-	const groups = inferGroups(v);
-	const lengths = inferLengths(v);
-	const cc = inferCharClass(v);
-	let pattern;
-	const perGroup = inferPerGroup(v);
-	if (perGroup && lengths.length <= 1) pattern = groupsToPatternPerClass(perGroup);
-	else if (groups && lengths.length <= 1) pattern = groupsToPattern(groups, cc);
-	else if (lengths.length === 1) pattern = `${cc}{${lengths[0]}}`;
-	else if (lengths.length > 1) pattern = `${cc}{${Math.min(...lengths)},${Math.max(...lengths)}}`;
-	else pattern = `${cc}{6,20}`;
-	if (prefix) pattern = `${prefix}${SEP}${pattern}`;
-	return new RegExp(`(?<!\\w)${pattern}(?!\\w)`, "g");
-};
-/**
-* All discovered validators, lazily populated.
-* Import * from "../src" would pull everything;
-* instead, callers pass validators explicitly.
-*/
-/**
-* Build patterns for a list of validators.
-*/
-const toPatterns = (validators) => validators.map((v) => ({
-	validator: v,
-	regex: toRegex(v)
+const toPatterns = (validators) => validators.filter((validator) => validator.candidatePattern !== void 0).map((validator) => ({
+	validator,
+	regex: toRegex(validator)
 }));
-const byCountry = (country, validators) => {
-	return toPatterns(validators.filter((v) => v.scope === "country" && v.country === country));
-};
-/**
-* Filter validators by entity type and build
-* patterns.
-*/
-const byEntityType = (entityType, validators) => toPatterns(validators.filter((v) => entityType === "any" || v.entityType === entityType || v.entityType === "any"));
-/**
-* Build patterns for ALL provided validators.
-*/
-const allPatterns = (validators) => toPatterns(validators);
+const byCountry = (country) => toPatterns(allValidators.filter((validator) => validator.scope === "country" && validator.country === country));
+const byEntityType = (entityType) => toPatterns(allValidators.filter((validator) => validator.entityType === entityType));
+const allPatterns = () => toPatterns(allValidators);
 //#endregion
 export { allPatterns, byCountry, byEntityType, toPatterns, toRegex };
 

package/dist/patterns.js.map

@@ -1 +1 @@
-{"version":3,"file":"patterns.js","names":[],"sources":["../src/patterns.ts"],"sourcesContent":["/**\n * Derive candidate-matching regex patterns from\n * validators. These patterns find CANDIDATES in\n * text — use `validate()` to confirm each match.\n *\n * Designed for integration with regex-set or\n * similar multi-pattern scanning engines.\n *\n * @example\n * ```ts\n * import {\n *   toRegex, byCountry, byEntityType,\n * } from \"@stll/stdnum/patterns\";\n * import { cz } from \"@stll/stdnum\";\n *\n * // Single validator\n * toRegex(cz.ico);\n * // → /(?<!\\w)\\d{8}(?!\\w)/g\n *\n * // All Czech validators\n * byCountry(\"CZ\");\n * // → [{ validator: cz.ico, regex }, ...]\n *\n * // All company identifiers\n * byEntityType(\"company\");\n * // → [{ validator, regex }, ...]\n * ```\n */\n\nimport type {\n  CountryCode,\n  CountryValidator,\n  Validator,\n} from \"./types\";\n\n// ─── Pattern type ─────────────────────────────\n\nexport type ValidatorPattern<\n  TValidator extends Validator = Validator,\n> = {\n  /** The validator this pattern was derived from. */\n  validator: TValidator;\n  /** Loose regex matching candidates in text. */\n  regex: RegExp;\n};\n\n// ─── Regex derivation ─────────────────────────\n\n/** Separator chars that compact() strips. */\nconst SEP = \"[\\\\s\\\\-./]?\";\n\n/**\n * Infer compact lengths from metadata or examples.\n */\nconst inferLengths = (v: Validator): number[] => {\n  if (v.lengths && v.lengths.length > 0) {\n    return [...v.lengths];\n  }\n  if (v.examples && v.examples.length > 0) {\n    const lens = new Set<number>();\n    for (const ex of v.examples) {\n      lens.add(v.compact(ex).length);\n    }\n    return [...lens];\n  }\n  return [];\n};\n\n/**\n * Derive the display grouping from format().\n * Returns an array of group sizes, e.g.,\n * \"25 123 891\" → [2, 3, 3].\n */\nconst inferGroups = (v: Validator): number[] | null => {\n  const first = v.examples?.[0];\n  if (first === undefined) return null;\n  const compact = v.compact(first);\n  const formatted = v.format(compact);\n  if (formatted === compact) return null;\n\n  // Split on non-alphanumeric separators\n  const parts = formatted.split(/[^a-zA-Z0-9]+/);\n  if (parts.length <= 1) return null;\n\n  // For digit-only validators, skip letter-only\n  // tokens (prefix like \"CHE\"). For alphanumeric\n  // validators (IBAN, ISIN), keep all groups.\n  const isAlphanumeric = parts.some(\n    (p) => /[a-zA-Z]/.test(p) && /\\d/.test(p),\n  );\n  const groups = parts\n    .filter(\n      (p) =>\n        p.length > 0 && (isAlphanumeric || /\\d/.test(p)),\n    )\n    .map((p) => p.length);\n\n  return groups.length > 1 ? groups : null;\n};\n\n/**\n * Detect if this validator uses a known prefix\n * (e.g., \"CZ\" for DIČ, \"CHE\" for Swiss UID).\n */\nconst inferPrefix = (v: Validator): string | null => {\n  const examples = v.examples;\n  const first = examples?.[0];\n  if (!examples || first === undefined) return null;\n  const compact = v.compact(first);\n  // Prefix already present in compact form.\n  // But only if ALL examples share the same prefix\n  // (e.g., \"CHE\" for Swiss UID). If examples have\n  // different prefixes (IBAN: GB/DE/FR), there's\n  // no fixed prefix — it's part of the value.\n  const compactMatch = compact.match(/^([A-Z]+)\\d/);\n  const compactPrefix = compactMatch?.[1];\n  if (compactPrefix !== undefined && examples.length > 1) {\n    const allSame = examples.every((ex) =>\n      v.compact(ex).startsWith(compactPrefix),\n    );\n    if (allSame) return compactPrefix;\n  } else if (\n    compactPrefix !== undefined &&\n    examples.length === 1\n  ) {\n    return compactPrefix;\n  }\n  // Prefix added only by format()\n  // (e.g., \"DE\" for de.vat, \"CZ\" for cz.dic)\n  const formatted = v.format(compact);\n  const fmtMatch = formatted.match(/^([A-Z]+)[\\s\\-./]?\\d/);\n  const fmtPrefix = fmtMatch?.[1];\n  if (\n    fmtPrefix !== undefined &&\n    !compact.startsWith(fmtPrefix)\n  ) {\n    return fmtPrefix;\n  }\n  return null;\n};\n\n/**\n * Character class for a string fragment:\n * `\\d` if all digits, `[A-Z]` if all letters,\n * `[A-Z0-9]` if mixed.\n */\nconst charClassFor = (s: string): string => {\n  let hasLetter = false;\n  let hasDigit = false;\n  for (const ch of s) {\n    if (/[a-zA-Z]/.test(ch)) hasLetter = true;\n    if (/\\d/.test(ch)) hasDigit = true;\n  }\n  if (hasLetter && hasDigit) return \"[A-Z0-9]\";\n  if (hasLetter) return \"[A-Z]\";\n  return \"\\\\d\";\n};\n\n/**\n * Determine the character class needed for the\n * compact form: `\\d` if all digits, `[A-Z0-9]`\n * if alphanumeric, etc.\n */\nconst inferCharClass = (v: Validator): string => {\n  if (!v.examples || v.examples.length === 0) {\n    return \"\\\\d\";\n  }\n  const combined = v.examples\n    .map((ex) => v.compact(ex))\n    .join(\"\");\n  return charClassFor(combined);\n};\n\ntype PerGroup = { size: number; charClass: string };\n\n/**\n * Infer per-group sizes AND character classes from\n * format(). Returns groups with per-position char\n * classes, e.g., \"12 010188 M 01 1\" →\n *   sizes: [2, 6, 1, 2, 1]\n *   classes: [\"\\d\", \"\\d\", \"[A-Z]\", \"\\d\", \"\\d\"]\n *\n * Only returns non-null when per-group classes\n * differ (some groups are letters, some digits).\n * Letter-only groups before the first digit group\n * are treated as prefixes and excluded (handled\n * by inferPrefix separately).\n */\nconst inferPerGroup = (v: Validator): PerGroup[] | null => {\n  const first = v.examples?.[0];\n  if (first === undefined) return null;\n  const compact = v.compact(first);\n  const formatted = v.format(compact);\n  if (formatted === compact) return null;\n\n  // Only applies to mixed validators (compact has\n  // both letters and digits in separate positions,\n  // like German SVNR \"12010188M011\").\n  const compactMixed =\n    /[a-zA-Z]/.test(compact) && /\\d/.test(compact);\n  if (!compactMixed) return null;\n\n  // Also skip if any single part mixes letters and\n  // digits (IBAN, ISIN) — inferGroups already\n  // handles those correctly with the global class.\n  const parts = formatted.split(/[^a-zA-Z0-9]+/);\n  const isAlphanumeric = parts.some(\n    (p) => /[a-zA-Z]/.test(p) && /\\d/.test(p),\n  );\n  if (isAlphanumeric) return null;\n\n  // Keep digit groups and letter-only groups that\n  // appear AFTER the first digit group (embedded\n  // letters). Skip letter-only groups before the\n  // first digit group (prefix like \"CHE\").\n  const filtered: PerGroup[] = [];\n  let seenDigitGroup = false;\n  for (const p of parts) {\n    if (p.length === 0) continue;\n    if (/\\d/.test(p)) {\n      seenDigitGroup = true;\n      filtered.push({\n        size: p.length,\n        charClass: charClassFor(p),\n      });\n    } else if (seenDigitGroup) {\n      filtered.push({\n        size: p.length,\n        charClass: charClassFor(p),\n      });\n    }\n  }\n\n  if (filtered.length <= 1) return null;\n\n  const firstClass = filtered[0]?.charClass;\n  const allSame = filtered.every(\n    (g) => g.charClass === firstClass,\n  );\n  if (allSame) return null;\n\n  return filtered;\n};\n\n/**\n * Build a group regex from group sizes + char class.\n * [2, 3, 3] with \\d → /\\d{2}[\\s\\-.]?\\d{3}[\\s\\-.]?\\d{3}/\n */\nconst groupsToPattern = (\n  groups: number[],\n  cc: string,\n): string => groups.map((g) => `${cc}{${g}}`).join(SEP);\n\n/**\n * Build a group regex with per-group char classes.\n * Produces tighter patterns when groups have different\n * character types (e.g., digits vs letters).\n */\nconst groupsToPatternPerClass = (\n  groups: readonly { size: number; charClass: string }[],\n): string =>\n  groups\n    .map(({ size, charClass }) => `${charClass}{${size}}`)\n    .join(SEP);\n\n/**\n * Derive a loose candidate-matching regex from\n * a validator. The regex finds potential matches;\n * use `validate()` to confirm.\n *\n * Handles both digit-only (IČO, NIP) and\n * alphanumeric (IBAN, BIC, ISIN, LEI) validators.\n */\nexport const toRegex = (v: Validator): RegExp => {\n  const prefix = inferPrefix(v);\n  const groups = inferGroups(v);\n  const lengths = inferLengths(v);\n  const cc = inferCharClass(v);\n\n  let pattern: string;\n\n  // Use per-group char classes when groups mix\n  // digits and letters (e.g., German SVNR:\n  // \"12 010188 M 01 1\" → [\\d, \\d, [A-Z], \\d, \\d]).\n  // This prevents overly broad [A-Z0-9] from\n  // matching all-caps prose as identifiers.\n  const perGroup = inferPerGroup(v);\n\n  if (perGroup && lengths.length <= 1) {\n    pattern = groupsToPatternPerClass(perGroup);\n  } else if (groups && lengths.length <= 1) {\n    pattern = groupsToPattern(groups, cc);\n  } else if (lengths.length === 1) {\n    pattern = `${cc}{${lengths[0]}}`;\n  } else if (lengths.length > 1) {\n    const min = Math.min(...lengths);\n    const max = Math.max(...lengths);\n    pattern = `${cc}{${min},${max}}`;\n  } else {\n    pattern = `${cc}{6,20}`;\n  }\n\n  if (prefix) {\n    pattern = `${prefix}${SEP}${pattern}`;\n  }\n\n  // Word boundary to avoid matching inside\n  // larger numbers\n  return new RegExp(`(?<!\\\\w)${pattern}(?!\\\\w)`, \"g\");\n};\n\n// ─── Grouped collections ──────────────────────\n\n/**\n * All discovered validators, lazily populated.\n * Import * from \"../src\" would pull everything;\n * instead, callers pass validators explicitly.\n */\n\n/**\n * Build patterns for a list of validators.\n */\nexport const toPatterns = <TValidator extends Validator>(\n  validators: readonly TValidator[],\n): ValidatorPattern<TValidator>[] =>\n  validators.map((v) => ({\n    validator: v,\n    regex: toRegex(v),\n  }));\n\n/**\n * Filter validators by country code and build\n * patterns.\n */\ntype CountryScopedValidator<\n  TValidator extends Validator,\n  TCountry extends CountryCode,\n> =\n  TValidator extends CountryValidator<\n    infer TValidatorCountry,\n    infer TParsed\n  >\n    ? TCountry extends TValidatorCountry\n      ? TValidator & CountryValidator<TCountry, TParsed>\n      : TValidatorCountry extends TCountry\n        ? TValidator\n        : never\n    : never;\n\nexport const byCountry = <\n  TCountry extends CountryCode,\n  TValidator extends Validator,\n>(\n  country: TCountry,\n  validators: readonly TValidator[],\n): ValidatorPattern<\n  CountryScopedValidator<TValidator, TCountry>\n>[] => {\n  const countryValidators = validators.filter(\n    (\n      v,\n    ): v is CountryScopedValidator<TValidator, TCountry> =>\n      v.scope === \"country\" && v.country === country,\n  );\n  return toPatterns(countryValidators);\n};\n\n/**\n * Filter validators by entity type and build\n * patterns.\n */\nexport const byEntityType = <TValidator extends Validator>(\n  entityType: \"person\" | \"company\" | \"any\",\n  validators: readonly TValidator[],\n): ValidatorPattern<TValidator>[] =>\n  toPatterns(\n    validators.filter(\n      (v) =>\n        entityType === \"any\" ||\n        v.entityType === entityType ||\n        v.entityType === \"any\",\n    ),\n  );\n\n/**\n * Build patterns for ALL provided validators.\n */\nexport const allPatterns = <TValidator extends Validator>(\n  validators: readonly TValidator[],\n): ValidatorPattern<TValidator>[] => toPatterns(validators);\n"],"mappings":"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"}
+{"version":3,"file":"patterns.js","names":[],"sources":["../src/patterns.ts"],"sourcesContent":["import { allValidators } from \"./generated/registry\";\nimport type {\n  CountryCode,\n  CountryValidator,\n  Validator,\n} from \"./types\";\n\nexport type ValidatorPattern<\n  TValidator extends Validator = Validator,\n> = {\n  validator: TValidator;\n  regex: RegExp;\n};\n\nexport const toRegex = (validator: Validator): RegExp => {\n  if (validator.candidatePattern === undefined) {\n    throw new Error(\n      `${validator.name} does not define a candidate pattern`,\n    );\n  }\n  return new RegExp(validator.candidatePattern, \"g\");\n};\nexport const toPatterns = <TValidator extends Validator>(\n  validators: readonly TValidator[],\n): ValidatorPattern<TValidator>[] =>\n  validators\n    .filter(\n      (validator) =>\n        validator.candidatePattern !== undefined,\n    )\n    .map((validator) => ({\n      validator,\n      regex: toRegex(validator),\n    }));\nexport const byCountry = <TCountry extends CountryCode>(\n  country: TCountry,\n) =>\n  toPatterns(\n    allValidators.filter(\n      (validator) =>\n        validator.scope === \"country\" &&\n        validator.country === country,\n    ) as unknown as readonly CountryValidator<TCountry>[],\n  );\nexport const byEntityType = (\n  entityType: Validator[\"entityType\"],\n) =>\n  toPatterns(\n    allValidators.filter(\n      (validator) => validator.entityType === entityType,\n    ),\n  );\nexport const allPatterns = () => toPatterns(allValidators);\n"],"mappings":";;AAcA,MAAa,WAAW,cAAiC;CACvD,IAAI,UAAU,qBAAqB,KAAA,GACjC,MAAM,IAAI,MACR,GAAG,UAAU,KAAK,qCACpB;CAEF,OAAO,IAAI,OAAO,UAAU,kBAAkB,GAAG;AACnD;AACA,MAAa,cACX,eAEA,WACG,QACE,cACC,UAAU,qBAAqB,KAAA,CACnC,CAAC,CACA,KAAK,eAAe;CACnB;CACA,OAAO,QAAQ,SAAS;AAC1B,EAAE;AACN,MAAa,aACX,YAEA,WACE,cAAc,QACX,cACC,UAAU,UAAU,aACpB,UAAU,YAAY,OAC1B,CACF;AACF,MAAa,gBACX,eAEA,WACE,cAAc,QACX,cAAc,UAAU,eAAe,UAC1C,CACF;AACF,MAAa,oBAAoB,WAAW,aAAa"}

package/dist/pe/mod.d.ts

@@ -1,6 +1,4 @@
 import ruc from "./ruc.js";
-
-//#region src/pe/mod.d.ts
 declare namespace mod_d_exports {
   export { ruc };
 }