@stll/stdnum 0.0.1 → 2.0.0

package/dist/nz/ird.js

@@ -3,16 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/nz/ird.ts
-/**
-* IRD number (New Zealand Inland Revenue Department
-* number, Te Tari Take).
-*
-* 8 or 9 digit number with a weighted checksum.
-* Uses primary weights, falling back to secondary
-* weights if the primary check yields 10.
-*
-* @see https://www.ird.govt.nz/
-*/
 const PRIMARY_WEIGHTS = [
 	3,
 	2,
@@ -41,11 +31,11 @@ const SECONDARY_WEIGHTS = [
 const calcCheckDigit = (payload) => {
 	const padded = payload.padStart(8, "0");
 	let sum = 0;
-	for (let i = 0; i < 8; i++) sum += PRIMARY_WEIGHTS[i] * Number(padded[i]);
+	for (const [i, weight] of PRIMARY_WEIGHTS.entries()) sum += weight * Number(padded[i]);
 	let remainder = (-sum % 11 + 11) % 11;
 	if (remainder !== 10) return remainder;
 	sum = 0;
-	for (let i = 0; i < 8; i++) sum += SECONDARY_WEIGHTS[i] * Number(padded[i]);
+	for (const [i, weight] of SECONDARY_WEIGHTS.entries()) sum += weight * Number(padded[i]);
 	remainder = (-sum % 11 + 11) % 11;
 	if (remainder === 10) return null;
 	return remainder;
@@ -63,7 +53,7 @@ const validate = (value) => {
 	if (num < 1e7 || num >= 15e7) return err("INVALID_COMPONENT", "IRD number out of valid range");
 	const expected = calcCheckDigit(v.slice(0, -1));
 	if (expected === null) return err("INVALID_COMPONENT", "IRD number cannot have a valid check digit");
-	if (expected !== Number(v[v.length - 1])) return err("INVALID_CHECKSUM", "IRD check digit does not match");
+	if (expected !== Number(v.at(-1))) return err("INVALID_CHECKSUM", "IRD check digit does not match");
 	return {
 		valid: true,
 		compact: v
@@ -88,6 +78,7 @@ const ird = {
 	abbreviation: "IRD",
 	aliases: ["IRD number", "tax number NZ"],
 	candidatePattern: "\\d{8,9}",
+	scope: "country",
 	country: "NZ",
 	entityType: "any",
 	compact,

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 { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst 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 (let i = 0; i < 8; i++) {\n    sum += PRIMARY_WEIGHTS[i]! * Number(padded[i]);\n  }\n  let remainder = ((-sum % 11) + 11) % 11;\n  if (remainder !== 10) return remainder;\n\n  sum = 0;\n  for (let i = 0; i < 8; i++) {\n    sum += SECONDARY_WEIGHTS[i]! * 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[v.length - 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: Validator = {\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  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":";;;;;;;;;;;;;;;AAkBA,MAAM,kBAAkB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAEhD,MAAM,oBAAoB;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;;;;;;AAOlD,MAAM,kBAAkB,YAAmC;CACzD,MAAM,SAAS,QAAQ,SAAS,GAAG,IAAI;CACvC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,gBAAgB,KAAM,OAAO,OAAO,GAAG;CAEhD,IAAI,aAAc,CAAC,MAAM,KAAM,MAAM;AACrC,KAAI,cAAc,GAAI,QAAO;AAE7B,OAAM;AACN,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IACrB,QAAO,kBAAkB,KAAM,OAAO,OAAO,GAAG;AAElD,cAAc,CAAC,MAAM,KAAM,MAAM;AACjC,KAAI,cAAc,GAAI,QAAO;AAC7B,QAAO;;AAGT,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,KAAK,CAAC,aAAa;AACxC,KAAI,EAAE,WAAW,KAAK,CACpB,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,KAAK,EAAE,WAAW,EACjC,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,sCACD;CAEH,MAAM,MAAM,OAAO,EAAE;AACrB,KAAI,MAAM,OAAc,OAAO,KAC7B,QAAO,IACL,qBACA,gCACD;CAGH,MAAM,WAAW,eADD,EAAE,MAAM,GAAG,GAAG,CACU;AACxC,KAAI,aAAa,KACf,QAAO,IACL,qBACA,6CACD;AAEH,KAAI,aAAa,OAAO,EAAE,EAAE,SAAS,GAAG,CACtC,QAAO,IACL,oBACA,iCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;CACxB,MAAM,QAAQ,EAAE,MAAM,GAAG;AAEzB,QAAO,GADQ,EAAE,MAAM,GAAG,GAAG,CACZ,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,MAAM,EAAE;;;AAIzD,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,cAAc,gBAAgB;CACxC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,aACE;CACF,WAAW;CACX,SAAS,CAAC,GAAG,EAAE;CACf,UAAU,CAAC,YAAY,YAAY;CACnC;CACD"}
+{"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,EAAE,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,EAAE,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"}

package/dist/nz/mod.d.ts

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

package/dist/pa/mod.d.ts

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

package/dist/pa/ruc.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/pa/ruc.d.ts
-
 /**
  * Compact: normalize Unicode, collapse whitespace,
  * strip colons around DV, and uppercase. Keeps
@@ -17,7 +16,7 @@ declare const format: (value: string) => string;
 /** Generate a random valid Panama RUC (natural person). */
 declare const generate: () => string;
 /** Panama tax identification number. */
-declare const ruc: Validator;
+declare const ruc: CountryValidator<"PA">;
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 //# sourceMappingURL=ruc.d.ts.map

package/dist/pa/ruc.js

@@ -3,24 +3,6 @@ import { randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 //#region src/pa/ruc.ts
 /**
-* RUC (Registro Único de Contribuyente, Panama
-* tax number).
-*
-* The RUC identifies taxpayers in Panama. It comes
-* in several formats depending on entity type
-* (natural person, legal entity, foreigner, etc.)
-* and is always accompanied by a two-digit check
-* code called the "dígito verificador" (DV).
-*
-* The DV is computed by encoding the hyphen-separated
-* RUC into a 20-position numeric buffer, then applying
-* a double weighted-sum mod 11 algorithm. The encoding
-* and legacy-format handling follow the official ANIP/DGI
-* specification.
-*
-* @see https://dgi.mef.gob.pa/
-*/
-/**
 * Legacy cross-reference table: maps two-digit codes
 * at positions 5–6 of old-format juridical RUCs.
 */
@@ -96,7 +78,8 @@ const digitDV = (buf, isOldFormat) => {
 */
 const computeDV = (segments, raw) => {
 	const len = segments.length;
-	if (len < 3 || len > 4 || len === 4 && segments[1] !== "NT") return null;
+	if (len < 3 || len > 4) return null;
+	if (len === 4 !== (segments[1] === "NT")) return null;
 	let buf;
 	let isOld = false;
 	const s0 = segments[0];
@@ -175,6 +158,7 @@ const generate = () => {
 		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. */
@@ -184,6 +168,7 @@ const ruc = {
 	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",

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 { clean } from \"#util/clean\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\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 (\n    len < 3 ||\n    len > 4 ||\n    (len === 4 && segments[1] !== \"NT\")\n  ) {\n    return null;\n  }\n\n  let buf: string;\n  let isOld = false;\n\n  const s0 = segments[0]!;\n  const s1 = segments[1]!;\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-xxx-xxx)\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    isOld =\n      buf[3] === \"0\" && buf[4] === \"0\" && 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  const rucPart = dvMatch[1]!;\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  const rucPart = dvMatch[1]!.replace(/-+$/, \"\");\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  return `${segments.join(\"-\")} DV${dv}`;\n};\n\n/** Panama tax identification number. */\nconst ruc: Validator = {\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  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":"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"}
+{"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,EAAE,KAAK,EAAE,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,EAAE,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,EAAE,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,GAAI,QAAQ,OAAO,EAAE;CAE7C,MAAM,SAAS,QAAQ;CAEvB,OAAO,GADU,QAAQ,MAAM,GACd,EAAE,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"}

package/dist/patterns.d.ts

@@ -1,11 +1,8 @@
-import { CountryCode, Validator } from "./types.js";
+import { CountryCode, CountryValidator, Validator } from "./types.js";
 
 //#region src/patterns.d.ts
-
-type ValidatorPattern = {
-  /** The validator this pattern was derived from. */
-  validator: Validator;
-  /** Loose regex matching candidates in text. */
+type ValidatorPattern<TValidator extends Validator = Validator> = {
+  /** The validator this pattern was derived from. */validator: TValidator; /** Loose regex matching candidates in text. */
   regex: RegExp;
 };
 /**
@@ -25,21 +22,22 @@ declare const toRegex: (v: Validator) => RegExp;
 /**
  * Build patterns for a list of validators.
  */
-declare const toPatterns: (validators: readonly Validator[]) => ValidatorPattern[];
+declare const toPatterns: <TValidator extends Validator>(validators: readonly TValidator[]) => ValidatorPattern<TValidator>[];
 /**
  * Filter validators by country code and build
  * patterns.
  */
-declare const byCountry: (country: CountryCode, validators: readonly Validator[]) => ValidatorPattern[];
+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: (entityType: "person" | "company" | "any", validators: readonly Validator[]) => ValidatorPattern[];
+declare const byEntityType: <TValidator extends Validator>(entityType: "person" | "company" | "any", validators: readonly TValidator[]) => ValidatorPattern<TValidator>[];
 /**
  * Build patterns for ALL provided validators.
  */
-declare const allPatterns: (validators: readonly Validator[]) => ValidatorPattern[];
+declare const allPatterns: <TValidator extends Validator>(validators: readonly TValidator[]) => ValidatorPattern<TValidator>[];
 //#endregion
 export { ValidatorPattern, allPatterns, byCountry, byEntityType, toPatterns, toRegex };
 //# sourceMappingURL=patterns.d.ts.map

package/dist/patterns.js

@@ -19,8 +19,9 @@ const inferLengths = (v) => {
 * "25 123 891" → [2, 3, 3].
 */
 const inferGroups = (v) => {
-	if (!v.examples || v.examples.length === 0) return null;
-	const compact = v.compact(v.examples[0]);
+	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]+/);
@@ -34,43 +35,97 @@ const inferGroups = (v) => {
 * (e.g., "CZ" for DIČ, "CHE" for Swiss UID).
 */
 const inferPrefix = (v) => {
-	if (!v.examples || v.examples.length === 0) return null;
-	const compact = v.compact(v.examples[0]);
-	const compactMatch = compact.match(/^([A-Z]+)\d/);
-	if (compactMatch && v.examples.length > 1) {
-		const pfx = compactMatch[1];
-		if (v.examples.every((ex) => v.compact(ex).startsWith(pfx))) return pfx;
-	} else if (compactMatch && v.examples.length === 1) return compactMatch[1];
-	const fmtMatch = v.format(compact).match(/^([A-Z]+)[\s\-./]?\d/);
-	if (fmtMatch && !compact.startsWith(fmtMatch[1])) return fmtMatch[1];
+	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;
 };
 /**
-* Determine the character class needed for the
-* compact form: `\d` if all digits, `[A-Z0-9]`
-* if alphanumeric, etc.
+* Character class for a string fragment:
+* `\d` if all digits, `[A-Z]` if all letters,
+* `[A-Z0-9]` if mixed.
 */
-const inferCharClass = (v) => {
-	if (!v.examples || v.examples.length === 0) return "\\d";
+const charClassFor = (s) => {
 	let hasLetter = false;
 	let hasDigit = false;
-	for (const ex of v.examples) {
-		const c = v.compact(ex);
-		for (const ch of c) {
-			if (/[a-zA-Z]/.test(ch)) hasLetter = true;
-			if (/\d/.test(ch)) hasDigit = true;
-		}
+	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.
@@ -84,7 +139,9 @@ const toRegex = (v) => {
 	const lengths = inferLengths(v);
 	const cc = inferCharClass(v);
 	let pattern;
-	if (groups && lengths.length <= 1) pattern = groupsToPattern(groups, cc);
+	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}`;
@@ -103,11 +160,9 @@ const toPatterns = (validators) => validators.map((v) => ({
 	validator: v,
 	regex: toRegex(v)
 }));
-/**
-* Filter validators by country code and build
-* patterns.
-*/
-const byCountry = (country, validators) => toPatterns(validators.filter((v) => v.country === country));
+const byCountry = (country, validators) => {
+	return toPatterns(validators.filter((v) => v.scope === "country" && v.country === country));
+};
 /**
 * Filter validators by entity type and build
 * patterns.

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 { CountryCode, Validator } from \"./types\";\n\n// ─── Pattern type ─────────────────────────────\n\nexport type ValidatorPattern = {\n  /** The validator this pattern was derived from. */\n  validator: Validator;\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  if (!v.examples || v.examples.length === 0) {\n    return null;\n  }\n  const compact = v.compact(v.examples[0]!);\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  if (!v.examples || v.examples.length === 0) {\n    return null;\n  }\n  const compact = v.compact(v.examples[0]!);\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  if (compactMatch && v.examples!.length > 1) {\n    const pfx = compactMatch[1]!;\n    const allSame = v.examples!.every((ex) =>\n      v.compact(ex).startsWith(pfx),\n    );\n    if (allSame) return pfx;\n  } else if (compactMatch && v.examples!.length === 1) {\n    return compactMatch[1]!;\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  if (fmtMatch && !compact.startsWith(fmtMatch[1]!)) {\n    return fmtMatch[1]!;\n  }\n  return null;\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  let hasLetter = false;\n  let hasDigit = false;\n  for (const ex of v.examples) {\n    const c = v.compact(ex);\n    for (const ch of c) {\n      if (/[a-zA-Z]/.test(ch)) hasLetter = true;\n      if (/\\d/.test(ch)) hasDigit = true;\n    }\n  }\n  if (hasLetter && hasDigit) return \"[A-Z0-9]\";\n  if (hasLetter) return \"[A-Z]\";\n  return \"\\\\d\";\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 * 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  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 = (\n  validators: readonly Validator[],\n): ValidatorPattern[] =>\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 */\nexport const byCountry = (\n  country: CountryCode,\n  validators: readonly Validator[],\n): ValidatorPattern[] =>\n  toPatterns(\n    validators.filter((v) => v.country === country),\n  );\n\n/**\n * Filter validators by entity type and build\n * patterns.\n */\nexport const byEntityType = (\n  entityType: \"person\" | \"company\" | \"any\",\n  validators: readonly Validator[],\n): ValidatorPattern[] =>\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 = (\n  validators: readonly Validator[],\n): ValidatorPattern[] => toPatterns(validators);\n"],"mappings":"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"}
+{"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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"}

package/dist/pe/mod.d.ts

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

package/dist/pe/ruc.d.ts

@@ -1,7 +1,6 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/pe/ruc.d.ts
-
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
@@ -13,7 +12,7 @@ declare const generate: () => string;
  * Examples sourced from python-stdnum test suite
  * (pe.ruc module).
  */
-declare const ruc: Validator;
+declare const ruc: CountryValidator<"PE">;
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 //# sourceMappingURL=ruc.d.ts.map

package/dist/pe/ruc.js

@@ -1,24 +1,9 @@
 import { clean } from "../_util/clean.js";
-import { randomDigits } from "../_util/generate.js";
+import { randomDigits, randomPick } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/pe/ruc.ts
 /**
-* RUC (Registro Único de Contribuyentes).
-*
-* Peruvian tax identification number assigned by SUNAT
-* (Superintendencia Nacional de Aduanas y de
-* Administración Tributaria). The number consists of
-* 11 digits: a type prefix (10 = person, 20 = company,
-* among others), 8 identification digits, and a check
-* digit computed using a weighted modulo 11 algorithm.
-*
-* Format: XXXXXXXXXXX (11 digits, no separators).
-*
-* @see https://www.sunat.gob.pe/
-* @see https://en.wikipedia.org/wiki/Tax_identification_number#Peru
-*/
-/**
 * Valid type prefixes for RUC numbers.
 * 10 = natural person, 15 = non-domiciled without RUC,
 * 17 = non-domiciled, 20 = legal entity,
@@ -42,6 +27,12 @@ const WEIGHTS = [
 	3,
 	2
 ];
+const GENERATE_PREFIXES = [
+	"10",
+	"15",
+	"17",
+	"20"
+];
 const compact = (value) => clean(value, " -.").trim();
 /**
 * Compute the RUC check digit using weighted sum
@@ -51,7 +42,7 @@ const compact = (value) => clean(value, " -.").trim();
 */
 const calcCheckDigit = (body) => {
 	let sum = 0;
-	for (let i = 0; i < 10; i++) sum += Number(body[i]) * WEIGHTS[i];
+	for (const [i, weight] of WEIGHTS.entries()) sum += Number(body[i]) * weight;
 	const remainder = 11 - sum % 11;
 	if (remainder >= 10) return remainder - 10;
 	return remainder;
@@ -72,13 +63,7 @@ const validate = (value) => {
 const format = (value) => compact(value);
 /** Generate a random valid Peruvian RUC. */
 const generate = () => {
-	const prefixes = [
-		"10",
-		"15",
-		"17",
-		"20"
-	];
-	const body = prefixes[Math.floor(Math.random() * prefixes.length)] + randomDigits(8);
+	const body = randomPick(GENERATE_PREFIXES) + randomDigits(8);
 	return body + String(calcCheckDigit(body));
 };
 /**
@@ -93,6 +78,7 @@ const ruc = {
 	abbreviation: "RUC",
 	aliases: ["RUC"],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "PE",
 	entityType: "any",
 	compact,