@stll/stdnum 1.0.0 → 2.0.1

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.
 */
@@ -186,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 (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: 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":"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"}

package/dist/patterns.d.ts

@@ -1,8 +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;
 };
 /**
@@ -22,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

@@ -160,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  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 = (\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/ruc.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/pe/ruc.d.ts
 declare const compact: (value: string) => string;
@@ -12,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

@@ -4,21 +4,6 @@ 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,
@@ -93,6 +78,7 @@ const ruc = {
 	abbreviation: "RUC",
 	aliases: ["RUC"],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "PE",
 	entityType: "any",
 	compact,

package/dist/pe/ruc.js.map

@@ -1 +1 @@
-{"version":3,"file":"ruc.js","names":[],"sources":["../../src/pe/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyentes).\n *\n * Peruvian tax identification number assigned by SUNAT\n * (Superintendencia Nacional de Aduanas y de\n * Administración Tributaria). The number consists of\n * 11 digits: a type prefix (10 = person, 20 = company,\n * among others), 8 identification digits, and a check\n * digit computed using a weighted modulo 11 algorithm.\n *\n * Format: XXXXXXXXXXX (11 digits, no separators).\n *\n * @see https://www.sunat.gob.pe/\n * @see https://en.wikipedia.org/wiki/Tax_identification_number#Peru\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Valid type prefixes for RUC numbers.\n * 10 = natural person, 15 = non-domiciled without RUC,\n * 17 = non-domiciled, 20 = legal entity,\n * others for specific entity types.\n */\nconst VALID_PREFIXES = new Set([\"10\", \"15\", \"17\", \"20\"]);\n\nconst WEIGHTS = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2] as const;\nconst GENERATE_PREFIXES = [\"10\", \"15\", \"17\", \"20\"] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim();\n\n/**\n * Compute the RUC check digit using weighted sum\n * mod 11. Weights: [5, 4, 3, 2, 7, 6, 5, 4, 3, 2].\n *\n * check = 11 - (sum % 11); if >= 10, subtract 10.\n */\nconst calcCheckDigit = (body: string): number => {\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(body[i]) * weight;\n  }\n  const remainder = 11 - (sum % 11);\n  if (remainder >= 10) return remainder - 10;\n  return remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\"INVALID_LENGTH\", \"RUC must be 11 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUC must contain only digits\",\n    );\n  }\n\n  const prefix = v.slice(0, 2);\n  if (!VALID_PREFIXES.has(prefix)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUC has an invalid type prefix\",\n    );\n  }\n\n  const expected = calcCheckDigit(v.slice(0, 10));\n  if (Number(v[10]) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Peruvian RUC. */\nconst generate = (): string => {\n  const prefix = randomPick(GENERATE_PREFIXES);\n  const body = prefix + randomDigits(8);\n  return body + String(calcCheckDigit(body));\n};\n\n/**\n * Peruvian RUC (tax identification number).\n *\n * Examples sourced from python-stdnum test suite\n * (pe.ruc module).\n */\nconst ruc: Validator = {\n  name: \"Peruvian Tax ID\",\n  localName: \"Registro Único de Contribuyentes\",\n  abbreviation: \"RUC\",\n  aliases: [\"RUC\"] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"PE\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.sunat.gob.pe/\",\n  lengths: [11] as const,\n  examples: [\"20131312955\", \"20100047218\"] as const,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAM;CAAM;CAAM;CAAK,CAAC;AAExD,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAC9C,MAAM,oBAAoB;CAAC;CAAM;CAAM;CAAM;CAAK;AAElD,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,MAAM;;;;;;;AAQ5B,MAAM,kBAAkB,SAAyB;CAC/C,IAAI,MAAM;AACV,MAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,SAAS,CACzC,QAAO,OAAO,KAAK,GAAG,GAAG;CAE3B,MAAM,YAAY,KAAM,MAAM;AAC9B,KAAI,aAAa,GAAI,QAAO,YAAY;AACxC,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,wBAAwB;AAGvD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAGH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;AAC5B,KAAI,CAAC,eAAe,IAAI,OAAO,CAC7B,QAAO,IACL,qBACA,iCACD;CAGH,MAAM,WAAW,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;AAC/C,KAAI,OAAO,EAAE,IAAI,KAAK,SACpB,QAAO,IACL,oBACA,iCACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;AAGxD,MAAM,iBAAyB;CAE7B,MAAM,OADS,WAAW,kBAAkB,GACtB,aAAa,EAAE;AACrC,QAAO,OAAO,OAAO,eAAe,KAAK,CAAC;;;;;;;;AAS5C,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,MAAM;CAChB,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,WAAW;CACX,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe,cAAc;CACxC;CACD"}
+{"version":3,"file":"ruc.js","names":[],"sources":["../../src/pe/ruc.ts"],"sourcesContent":["/**\n * RUC (Registro Único de Contribuyentes).\n *\n * Peruvian tax identification number assigned by SUNAT\n * (Superintendencia Nacional de Aduanas y de\n * Administración Tributaria). The number consists of\n * 11 digits: a type prefix (10 = person, 20 = company,\n * among others), 8 identification digits, and a check\n * digit computed using a weighted modulo 11 algorithm.\n *\n * Format: XXXXXXXXXXX (11 digits, no separators).\n *\n * @see https://www.sunat.gob.pe/\n * @see https://en.wikipedia.org/wiki/Tax_identification_number#Peru\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomPick } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/**\n * Valid type prefixes for RUC numbers.\n * 10 = natural person, 15 = non-domiciled without RUC,\n * 17 = non-domiciled, 20 = legal entity,\n * others for specific entity types.\n */\nconst VALID_PREFIXES = new Set([\"10\", \"15\", \"17\", \"20\"]);\n\nconst WEIGHTS = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2] as const;\nconst GENERATE_PREFIXES = [\"10\", \"15\", \"17\", \"20\"] as const;\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim();\n\n/**\n * Compute the RUC check digit using weighted sum\n * mod 11. Weights: [5, 4, 3, 2, 7, 6, 5, 4, 3, 2].\n *\n * check = 11 - (sum % 11); if >= 10, subtract 10.\n */\nconst calcCheckDigit = (body: string): number => {\n  let sum = 0;\n  for (const [i, weight] of WEIGHTS.entries()) {\n    sum += Number(body[i]) * weight;\n  }\n  const remainder = 11 - (sum % 11);\n  if (remainder >= 10) return remainder - 10;\n  return remainder;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\"INVALID_LENGTH\", \"RUC must be 11 digits\");\n  }\n\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RUC must contain only digits\",\n    );\n  }\n\n  const prefix = v.slice(0, 2);\n  if (!VALID_PREFIXES.has(prefix)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RUC has an invalid type prefix\",\n    );\n  }\n\n  const expected = calcCheckDigit(v.slice(0, 10));\n  if (Number(v[10]) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RUC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\n/** Generate a random valid Peruvian RUC. */\nconst generate = (): string => {\n  const prefix = randomPick(GENERATE_PREFIXES);\n  const body = prefix + randomDigits(8);\n  return body + String(calcCheckDigit(body));\n};\n\n/**\n * Peruvian RUC (tax identification number).\n *\n * Examples sourced from python-stdnum test suite\n * (pe.ruc module).\n */\nconst ruc: CountryValidator<\"PE\"> = {\n  name: \"Peruvian Tax ID\",\n  localName: \"Registro Único de Contribuyentes\",\n  abbreviation: \"RUC\",\n  aliases: [\"RUC\"] as const,\n  candidatePattern: \"\\\\d{11}\",\n  scope: \"country\",\n  country: \"PE\",\n  entityType: \"any\",\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.sunat.gob.pe/\",\n  lengths: [11] as const,\n  examples: [\"20131312955\", \"20100047218\"] as const,\n  generate,\n};\n\nexport default ruc;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;AAgCA,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAM;CAAM;CAAM;AAAI,CAAC;AAEvD,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAC7C,MAAM,oBAAoB;CAAC;CAAM;CAAM;CAAM;AAAI;AAEjD,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,EAAE,KAAK;;;;;;;AAQ3B,MAAM,kBAAkB,SAAyB;CAC/C,IAAI,MAAM;CACV,KAAK,MAAM,CAAC,GAAG,WAAW,QAAQ,QAAQ,GACxC,OAAO,OAAO,KAAK,EAAE,IAAI;CAE3B,MAAM,YAAY,KAAM,MAAM;CAC9B,IAAI,aAAa,IAAI,OAAO,YAAY;CACxC,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CAEvB,IAAI,EAAE,WAAW,IACf,OAAO,IAAI,kBAAkB,uBAAuB;CAGtD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAGF,MAAM,SAAS,EAAE,MAAM,GAAG,CAAC;CAC3B,IAAI,CAAC,eAAe,IAAI,MAAM,GAC5B,OAAO,IACL,qBACA,gCACF;CAGF,MAAM,WAAW,eAAe,EAAE,MAAM,GAAG,EAAE,CAAC;CAC9C,IAAI,OAAO,EAAE,GAAG,MAAM,UACpB,OAAO,IACL,oBACA,gCACF;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B,QAAQ,KAAK;;AAGvD,MAAM,iBAAyB;CAE7B,MAAM,OADS,WAAW,iBACR,IAAI,aAAa,CAAC;CACpC,OAAO,OAAO,OAAO,eAAe,IAAI,CAAC;AAC3C;;;;;;;AAQA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,KAAK;CACf,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ;CACA;CACA;CACA,WAAW;CACX,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,eAAe,aAAa;CACvC;AACF"}

package/dist/ph/philid.d.ts

@@ -1,13 +1,25 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/ph/philid.d.ts
 /** Generate a random valid PhilID. */
 declare const generate: () => string;
+/**
+ * PhilID (Philippine Identification System Number,
+ * PhilSys Card Number, PCN).
+ *
+ * 12-digit personal identifier issued under the
+ * Philippine Identification System (PhilSys).
+ * Formatted as XXXX-XXXXXXX-X. No check digit
+ * algorithm is publicly documented.
+ *
+ * @see https://en.wikipedia.org/wiki/Philippine_national_identity_card
+ * @see https://philsys.gov.ph/
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Philippine Identification System Number. */
-declare const philid: Validator;
+declare const philid: CountryValidator<"PH">;
 //#endregion
 export { compact, philid as default, format, generate, validate };
 //# sourceMappingURL=philid.d.ts.map

package/dist/ph/philid.js

@@ -3,18 +3,6 @@ import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/ph/philid.ts
-/**
-* PhilID (Philippine Identification System Number,
-* PhilSys Card Number, PCN).
-*
-* 12-digit personal identifier issued under the
-* Philippine Identification System (PhilSys).
-* Formatted as XXXX-XXXXXXX-X. No check digit
-* algorithm is publicly documented.
-*
-* @see https://en.wikipedia.org/wiki/Philippine_national_identity_card
-* @see https://philsys.gov.ph/
-*/
 /** Generate a random valid PhilID. */
 const generate = () => randomDigits(12);
 const compact = (value) => clean(value, " -");
@@ -43,6 +31,7 @@ const philid = {
 		"Philippine ID"
 	],
 	candidatePattern: "\\d{4}-\\d{4}-\\d{4}-\\d{4}",
+	scope: "country",
 	country: "PH",
 	entityType: "person",
 	description: "12-digit personal identifier issued under the Philippine Identification System",

package/dist/ph/philid.js.map

@@ -1 +1 @@
-{"version":3,"file":"philid.js","names":[],"sources":["../../src/ph/philid.ts"],"sourcesContent":["/** Generate a random valid PhilID. */\nconst generate = (): string => randomDigits(12);\n\n/**\n * PhilID (Philippine Identification System Number,\n * PhilSys Card Number, PCN).\n *\n * 12-digit personal identifier issued under the\n * Philippine Identification System (PhilSys).\n * Formatted as XXXX-XXXXXXX-X. No check digit\n * algorithm is publicly documented.\n *\n * @see https://en.wikipedia.org/wiki/Philippine_national_identity_card\n * @see https://philsys.gov.ph/\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 compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"PhilID must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"PhilID must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 12) {\n    return `${v.slice(0, 4)}-${v.slice(4, 11)}-${v.slice(11)}`;\n  }\n  return v;\n};\n\n/** Philippine Identification System Number. */\nconst philid: Validator = {\n  name: \"Philippine Identification System Number\",\n  localName: \"PhilSys Card Number\",\n  abbreviation: \"PhilID\",\n  aliases: [\"PhilID\", \"PhilSys\", \"Philippine ID\"] as const,\n  candidatePattern: \"\\\\d{4}-\\\\d{4}-\\\\d{4}-\\\\d{4}\",\n  country: \"PH\",\n  entityType: \"person\",\n  description:\n    \"12-digit personal identifier issued under\" +\n    \" the Philippine Identification System\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"Philippine_national_identity_card\",\n  lengths: [12] as const,\n  examples: [\"123456789012\", \"000011112222\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default philid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB,aAAa,GAAG;AAsB/C,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,mCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,kCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;AAE1D,QAAO;;;AAIT,MAAM,SAAoB;CACxB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAU;EAAW;EAAgB;CAC/C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CAEF,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,gBAAgB,eAAe;CAC1C;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"philid.js","names":[],"sources":["../../src/ph/philid.ts"],"sourcesContent":["/** Generate a random valid PhilID. */\nconst generate = (): string => randomDigits(12);\n\n/**\n * PhilID (Philippine Identification System Number,\n * PhilSys Card Number, PCN).\n *\n * 12-digit personal identifier issued under the\n * Philippine Identification System (PhilSys).\n * Formatted as XXXX-XXXXXXX-X. No check digit\n * algorithm is publicly documented.\n *\n * @see https://en.wikipedia.org/wiki/Philippine_national_identity_card\n * @see https://philsys.gov.ph/\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 compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"PhilID must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"PhilID must contain only digits\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  if (v.length === 12) {\n    return `${v.slice(0, 4)}-${v.slice(4, 11)}-${v.slice(11)}`;\n  }\n  return v;\n};\n\n/** Philippine Identification System Number. */\nconst philid: CountryValidator<\"PH\"> = {\n  name: \"Philippine Identification System Number\",\n  localName: \"PhilSys Card Number\",\n  abbreviation: \"PhilID\",\n  aliases: [\"PhilID\", \"PhilSys\", \"Philippine ID\"] as const,\n  candidatePattern: \"\\\\d{4}-\\\\d{4}-\\\\d{4}-\\\\d{4}\",\n  scope: \"country\",\n  country: \"PH\",\n  entityType: \"person\",\n  description:\n    \"12-digit personal identifier issued under\" +\n    \" the Philippine Identification System\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/\" +\n    \"Philippine_national_identity_card\",\n  lengths: [12] as const,\n  examples: [\"123456789012\", \"000011112222\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default philid;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB,aAAa,EAAE;AAyB9C,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;AAEnB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,kCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,iCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;CAEzD,OAAO;AACT;;AAGA,MAAM,SAAiC;CACrC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAU;EAAW;CAAe;CAC9C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CAEF,WACE;CAEF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,gBAAgB,cAAc;CACzC;CACA;CACA;CACA;AACF"}

package/dist/pk/cnic.d.ts

@@ -1,13 +1,25 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/pk/cnic.d.ts
 /** Generate a random valid Pakistan CNIC. */
 declare const generate: () => string;
+/**
+ * CNIC (Computerized National Identity Card, Pakistan).
+ *
+ * 13 digits: PPPPP-DDDDDDD-G where P is a province/
+ * district code (5 digits), D is a sequential number
+ * (7 digits), and G is a gender digit (odd = male,
+ * even = female, including 0). No checksum; structural
+ * validation.
+ *
+ * @see https://www.geo.tv/latest/157233-secret-behind-every-digit-of-the-cnic-number
+ * @see https://en.wikipedia.org/wiki/CNIC_(Pakistan)
+ */
 declare const compact: (value: string) => string;
 declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
 /** Pakistan Computerized National Identity Card. */
-declare const cnic: Validator;
+declare const cnic: CountryValidator<"PK">;
 //#endregion
 export { compact, cnic as default, format, generate, validate };
 //# sourceMappingURL=cnic.d.ts.map

package/dist/pk/cnic.js

@@ -3,18 +3,6 @@ import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
 //#region src/pk/cnic.ts
-/**
-* CNIC (Computerized National Identity Card, Pakistan).
-*
-* 13 digits: PPPPP-DDDDDDD-G where P is a province/
-* district code (5 digits), D is a sequential number
-* (7 digits), and G is a gender digit (odd = male,
-* even = female, including 0). No checksum; structural
-* validation.
-*
-* @see https://www.geo.tv/latest/157233-secret-behind-every-digit-of-the-cnic-number
-* @see https://en.wikipedia.org/wiki/CNIC_(Pakistan)
-*/
 /** Generate a random valid Pakistan CNIC. */
 const generate = () => {
 	return `${String(randomInt(1, 7))}${randomDigits(4)}${randomDigits(7)}${String(randomInt(1, 9))}`;
@@ -52,6 +40,7 @@ const cnic = {
 	abbreviation: "CNIC",
 	aliases: ["CNIC", "شناختی کارڈ"],
 	candidatePattern: "\\d{5}-?\\d{7}-?\\d",
+	scope: "country",
 	country: "PK",
 	entityType: "person",
 	lengths: [13],

package/dist/pk/cnic.js.map

@@ -1 +1 @@
-{"version":3,"file":"cnic.js","names":[],"sources":["../../src/pk/cnic.ts"],"sourcesContent":["/** Generate a random valid Pakistan CNIC. */\nconst generate = (): string => {\n  const province = String(randomInt(1, 7));\n  const district = randomDigits(4);\n  const serial = randomDigits(7);\n  const gender = String(randomInt(1, 9));\n  return `${province}${district}${serial}${gender}`;\n};\n\n/**\n * CNIC (Computerized National Identity Card, Pakistan).\n *\n * 13 digits: PPPPP-DDDDDDD-G where P is a province/\n * district code (5 digits), D is a sequential number\n * (7 digits), and G is a gender digit (odd = male,\n * even = female, including 0). No checksum; structural\n * validation.\n *\n * @see https://www.geo.tv/latest/157233-secret-behind-every-digit-of-the-cnic-number\n * @see https://en.wikipedia.org/wiki/CNIC_(Pakistan)\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/** Valid province IDs (first digit). */\nconst VALID_PROVINCES = new Set([\n  \"1\",\n  \"2\",\n  \"3\",\n  \"4\",\n  \"5\",\n  \"6\",\n  \"7\",\n]);\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\"INVALID_LENGTH\", \"CNIC must be 13 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CNIC must contain only digits\",\n    );\n  }\n  // First digit must be a valid province code\n  // SAFETY: v.length === 13 above guarantees v[0] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  if (!VALID_PROVINCES.has(v[0]!)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CNIC province code is invalid\",\n    );\n  }\n  // Last digit indicates gender: odd = male,\n  // even = female. Digit 0 is rejected per\n  // python-stdnum convention; NADRA does not\n  // publish whether 0 is a valid gender code.\n  // @see https://www.geo.tv/latest/157233\n  if (v[12] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CNIC gender digit must not be 0\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 5)}-${v.slice(5, 12)}-${v.slice(12)}`;\n};\n\n/** Pakistan Computerized National Identity Card. */\nconst cnic: Validator = {\n  name: \"Computerized National Identity Card\",\n  localName: \"Computerized National Identity Card\",\n  abbreviation: \"CNIC\",\n  aliases: [\"CNIC\", \"شناختی کارڈ\"] as const,\n  candidatePattern: \"\\\\d{5}-?\\\\d{7}-?\\\\d\",\n  country: \"PK\",\n  entityType: \"person\",\n  lengths: [13],\n  examples: [\"3520112345671\", \"4210112345672\"],\n  description:\n    \"13-digit identity card number issued by NADRA\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/CNIC_(Pakistan)\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cnic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;AAK7B,QAAO,GAJU,OAAO,UAAU,GAAG,EAAE,CAAC,GACvB,aAAa,EAAE,GACjB,aAAa,EAAE,GACf,OAAO,UAAU,GAAG,EAAE,CAAC;;AAwBxC,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;;AAGpB,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IAAI,kBAAkB,yBAAyB;AAExD,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,gCACD;AAKH,KAAI,CAAC,gBAAgB,IAAI,EAAE,GAAI,CAC7B,QAAO,IACL,qBACA,gCACD;AAOH,KAAI,EAAE,QAAQ,IACZ,QAAO,IACL,qBACA,kCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI1D,MAAM,OAAkB;CACtB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,cAAc;CAChC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,iBAAiB,gBAAgB;CAC5C,aACE;CACF,WACE;CACF;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"cnic.js","names":[],"sources":["../../src/pk/cnic.ts"],"sourcesContent":["/** Generate a random valid Pakistan CNIC. */\nconst generate = (): string => {\n  const province = String(randomInt(1, 7));\n  const district = randomDigits(4);\n  const serial = randomDigits(7);\n  const gender = String(randomInt(1, 9));\n  return `${province}${district}${serial}${gender}`;\n};\n\n/**\n * CNIC (Computerized National Identity Card, Pakistan).\n *\n * 13 digits: PPPPP-DDDDDDD-G where P is a province/\n * district code (5 digits), D is a sequential number\n * (7 digits), and G is a gender digit (odd = male,\n * even = female, including 0). No checksum; structural\n * validation.\n *\n * @see https://www.geo.tv/latest/157233-secret-behind-every-digit-of-the-cnic-number\n * @see https://en.wikipedia.org/wiki/CNIC_(Pakistan)\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/** Valid province IDs (first digit). */\nconst VALID_PROVINCES = new Set([\n  \"1\",\n  \"2\",\n  \"3\",\n  \"4\",\n  \"5\",\n  \"6\",\n  \"7\",\n]);\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\"INVALID_LENGTH\", \"CNIC must be 13 digits\");\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CNIC must contain only digits\",\n    );\n  }\n  // First digit must be a valid province code\n  // SAFETY: v.length === 13 above guarantees v[0] exists.\n  // eslint-disable-next-line no-non-null-assertion\n  if (!VALID_PROVINCES.has(v[0]!)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CNIC province code is invalid\",\n    );\n  }\n  // Last digit indicates gender: odd = male,\n  // even = female. Digit 0 is rejected per\n  // python-stdnum convention; NADRA does not\n  // publish whether 0 is a valid gender code.\n  // @see https://www.geo.tv/latest/157233\n  if (v[12] === \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CNIC gender digit must not be 0\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return `${v.slice(0, 5)}-${v.slice(5, 12)}-${v.slice(12)}`;\n};\n\n/** Pakistan Computerized National Identity Card. */\nconst cnic: CountryValidator<\"PK\"> = {\n  name: \"Computerized National Identity Card\",\n  localName: \"Computerized National Identity Card\",\n  abbreviation: \"CNIC\",\n  aliases: [\"CNIC\", \"شناختی کارڈ\"] as const,\n  candidatePattern: \"\\\\d{5}-?\\\\d{7}-?\\\\d\",\n  scope: \"country\",\n  country: \"PK\",\n  entityType: \"person\",\n  lengths: [13],\n  examples: [\"3520112345671\", \"4210112345672\"],\n  description:\n    \"13-digit identity card number issued by NADRA\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/CNIC_(Pakistan)\",\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default cnic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;AACA,MAAM,iBAAyB;CAK7B,OAAO,GAJU,OAAO,UAAU,GAAG,CAAC,CAIrB,IAHA,aAAa,CAGF,IAFb,aAAa,CAES,IADtB,OAAO,UAAU,GAAG,CAAC,CACU;AAChD;AAyBA,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;;AAGnB,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IAAI,kBAAkB,wBAAwB;CAEvD,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,+BACF;CAKF,IAAI,CAAC,gBAAgB,IAAI,EAAE,EAAG,GAC5B,OAAO,IACL,qBACA,+BACF;CAOF,IAAI,EAAE,QAAQ,KACZ,OAAO,IACL,qBACA,iCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OAAO,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;AACzD;;AAGA,MAAM,OAA+B;CACnC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,QAAQ,aAAa;CAC/B,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,iBAAiB,eAAe;CAC3C,aACE;CACF,WACE;CACF;CACA;CACA;CACA;AACF"}

package/dist/pl/nip.d.ts

@@ -1,4 +1,4 @@
-import { ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ValidateResult } from "../types.js";
 
 //#region src/pl/nip.d.ts
 declare const compact: (value: string) => string;
@@ -11,7 +11,7 @@ declare const format: (value: string) => string;
  */
 declare const generate: () => string;
 /** Polish VAT Number. */
-declare const nip: Validator;
+declare const nip: CountryValidator<"PL">;
 //#endregion
 export { compact, nip as default, format, generate, validate };
 //# sourceMappingURL=nip.d.ts.map

package/dist/pl/nip.js

@@ -1,18 +1,9 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
 import { randomDigits } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
 //#region src/pl/nip.ts
-/**
-* NIP (Numer Identyfikacji Podatkowej).
-*
-* Polish VAT number. 10 digits with a weighted
-* checksum. The last digit is the check digit.
-*
-* @see https://www.biznes.gov.pl/en/portal/004124
-* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/poland-tin.pdf
-*/
 const WEIGHTS = [
 	6,
 	5,
@@ -62,6 +53,7 @@ const nip = {
 	abbreviation: "NIP",
 	aliases: ["NIP", "numer identyfikacji podatkowej"],
 	candidatePattern: "\\d{3}-?\\d{3}-?\\d{2}-?\\d{2}",
+	scope: "country",
 	country: "PL",
 	entityType: "company",
 	sourceUrl: "https://www.biznes.gov.pl/en/portal/004124",

package/dist/pl/nip.js.map

@@ -1 +1 @@
-{"version":3,"file":"nip.js","names":[],"sources":["../../src/pl/nip.ts"],"sourcesContent":["/**\n * NIP (Numer Identyfikacji Podatkowej).\n *\n * Polish VAT number. 10 digits with a weighted\n * checksum. The last digit is the check digit.\n *\n * @see https://www.biznes.gov.pl/en/portal/004124\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/poland-tin.pdf\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [6, 5, 7, 2, 3, 4, 5, 6, 7] as const;\n\nconst compact = (value: string): string => {\n  const v = clean(value, \" -\");\n  if (v.startsWith(\"PL\") || v.startsWith(\"pl\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIP must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIP must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS, 11);\n  // If remainder is 10, no valid check digit exists\n  if (sum >= 10 || sum !== Number(v[9])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIP check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `PL${compact(value)}`;\n\nconst MAX_GENERATE_ATTEMPTS = 100;\n\n/**\n * Generate a random valid NIP. Retries if the\n * weighted sum mod 11 yields 10 (no valid check\n * digit for that payload).\n */\nconst generate = (): string => {\n  for (let i = 0; i < MAX_GENERATE_ATTEMPTS; i++) {\n    const payload = randomDigits(9);\n    const sum = weightedSum(payload, WEIGHTS, 11);\n    if (sum < 10) {\n      return `${payload}${String(sum)}`;\n    }\n  }\n  throw new Error(\"Failed to generate valid NIP\");\n};\n\n/** Polish VAT Number. */\nconst nip: Validator = {\n  name: \"Polish VAT Number\",\n  localName: \"Numer Identyfikacji Podatkowej\",\n  abbreviation: \"NIP\",\n  aliases: [\n    \"NIP\",\n    \"numer identyfikacji podatkowej\",\n  ] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{3}-?\\\\d{2}-?\\\\d{2}\",\n  country: \"PL\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.biznes.gov.pl/en/portal/004124\",\n  examples: [\"2234567895\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nip;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAE3C,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,KAAK;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,QAAO,EAAE,MAAM,EAAE;AAEnB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,gCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;CAEH,MAAM,MAAM,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,SAAS,GAAG;AAEnD,KAAI,OAAO,MAAM,QAAQ,OAAO,EAAE,GAAG,CACnC,QAAO,IACL,oBACA,iCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;AAErB,MAAM,wBAAwB;;;;;;AAO9B,MAAM,iBAAyB;AAC7B,MAAK,IAAI,IAAI,GAAG,IAAI,uBAAuB,KAAK;EAC9C,MAAM,UAAU,aAAa,EAAE;EAC/B,MAAM,MAAM,YAAY,SAAS,SAAS,GAAG;AAC7C,MAAI,MAAM,GACR,QAAO,GAAG,UAAU,OAAO,IAAI;;AAGnC,OAAM,IAAI,MAAM,+BAA+B;;;AAIjD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,iCACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,aAAa;CACxB;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"nip.js","names":[],"sources":["../../src/pl/nip.ts"],"sourcesContent":["/**\n * NIP (Numer Identyfikacji Podatkowej).\n *\n * Polish VAT number. 10 digits with a weighted\n * checksum. The last digit is the check digit.\n *\n * @see https://www.biznes.gov.pl/en/portal/004124\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/poland-tin.pdf\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nconst WEIGHTS = [6, 5, 7, 2, 3, 4, 5, 6, 7] as const;\n\nconst compact = (value: string): string => {\n  const v = clean(value, \" -\");\n  if (v.startsWith(\"PL\") || v.startsWith(\"pl\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NIP must be exactly 10 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NIP must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v.slice(0, 9), WEIGHTS, 11);\n  // If remainder is 10, no valid check digit exists\n  if (sum >= 10 || sum !== Number(v[9])) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"NIP check digit does not match\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `PL${compact(value)}`;\n\nconst MAX_GENERATE_ATTEMPTS = 100;\n\n/**\n * Generate a random valid NIP. Retries if the\n * weighted sum mod 11 yields 10 (no valid check\n * digit for that payload).\n */\nconst generate = (): string => {\n  for (let i = 0; i < MAX_GENERATE_ATTEMPTS; i++) {\n    const payload = randomDigits(9);\n    const sum = weightedSum(payload, WEIGHTS, 11);\n    if (sum < 10) {\n      return `${payload}${String(sum)}`;\n    }\n  }\n  throw new Error(\"Failed to generate valid NIP\");\n};\n\n/** Polish VAT Number. */\nconst nip: CountryValidator<\"PL\"> = {\n  name: \"Polish VAT Number\",\n  localName: \"Numer Identyfikacji Podatkowej\",\n  abbreviation: \"NIP\",\n  aliases: [\n    \"NIP\",\n    \"numer identyfikacji podatkowej\",\n  ] as const,\n  candidatePattern: \"\\\\d{3}-?\\\\d{3}-?\\\\d{2}-?\\\\d{2}\",\n  scope: \"country\",\n  country: \"PL\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.biznes.gov.pl/en/portal/004124\",\n  examples: [\"2234567895\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nip;\nexport { compact, format, generate, validate };\n"],"mappings":";;;;;;AAqBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;AAAC;AAE1C,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,IAAI;CAC3B,IAAI,EAAE,WAAW,IAAI,KAAK,EAAE,WAAW,IAAI,GACzC,OAAO,EAAE,MAAM,CAAC;CAElB,OAAO;AACT;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,+BACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,8BACF;CAEF,MAAM,MAAM,YAAY,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,EAAE;CAElD,IAAI,OAAO,MAAM,QAAQ,OAAO,EAAE,EAAE,GAClC,OAAO,IACL,oBACA,gCACF;CAEF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UACd,KAAK,QAAQ,KAAK;AAEpB,MAAM,wBAAwB;;;;;;AAO9B,MAAM,iBAAyB;CAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,uBAAuB,KAAK;EAC9C,MAAM,UAAU,aAAa,CAAC;EAC9B,MAAM,MAAM,YAAY,SAAS,SAAS,EAAE;EAC5C,IAAI,MAAM,IACR,OAAO,GAAG,UAAU,OAAO,GAAG;CAElC;CACA,MAAM,IAAI,MAAM,8BAA8B;AAChD;;AAGA,MAAM,MAA8B;CAClC,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CACP,OACA,gCACF;CACA,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;AACF"}

package/dist/pl/pesel.d.ts

@@ -1,4 +1,4 @@
-import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
 
 //#region src/pl/pesel.d.ts
 declare const compact: (value: string) => string;
@@ -12,7 +12,7 @@ declare const parse: (value: string) => ParsedPersonId | null;
 /** Generate a random valid Polish PESEL. */
 declare const generate: () => string;
 /** Polish National Identification Number. */
-declare const pesel: Validator<ParsedPersonId>;
+declare const pesel: CountryValidator<"PL", ParsedPersonId>;
 //#endregion
 export { compact, pesel as default, format, generate, parse, validate };
 //# sourceMappingURL=pesel.d.ts.map

package/dist/pl/pesel.js

@@ -1,21 +1,10 @@
+import { weightedSum } from "../_checksums/weighted-sum.js";
 import { clean } from "../_util/clean.js";
+import { isValidDate } from "../_util/date.js";
 import { randomDigits, randomInt } from "../_util/generate.js";
 import { err } from "../_util/result.js";
 import { isdigits } from "../_util/strings.js";
-import { weightedSum } from "../_checksums/weighted-sum.js";
-import { isValidDate } from "../_util/date.js";
 //#region src/pl/pesel.ts
-/**
-* PESEL (Powszechny Elektroniczny System
-* Ewidencji Ludności).
-*
-* Polish national identification number.
-* 11 digits encoding date of birth, serial
-* number, gender, and a check digit.
-*
-* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/poland-tin.pdf
-* @see https://www.gov.pl/web/cyfryzacja/numer-pesel
-*/
 const WEIGHTS = [
 	1,
 	3,
@@ -94,6 +83,7 @@ const pesel = {
 	abbreviation: "PESEL",
 	aliases: ["PESEL"],
 	candidatePattern: "\\d{11}",
+	scope: "country",
 	country: "PL",
 	entityType: "person",
 	sourceUrl: "https://www.gov.pl/web/cyfryzacja/numer-pesel",