@stll/stdnum 0.0.1

package/dist/pa/ruc.js.map

@@ -0,0 +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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"}

package/dist/patterns.d.ts

@@ -0,0 +1,45 @@
+import { CountryCode, 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. */
+  regex: RegExp;
+};
+/**
+ * Derive a loose candidate-matching regex from
+ * a validator. The regex finds potential matches;
+ * use `validate()` to confirm.
+ *
+ * Handles both digit-only (IČO, NIP) and
+ * alphanumeric (IBAN, BIC, ISIN, LEI) validators.
+ */
+declare const toRegex: (v: Validator) => RegExp;
+/**
+ * All discovered validators, lazily populated.
+ * Import * from "../src" would pull everything;
+ * instead, callers pass validators explicitly.
+ */
+/**
+ * Build patterns for a list of validators.
+ */
+declare const toPatterns: (validators: readonly Validator[]) => ValidatorPattern[];
+/**
+ * Filter validators by country code and build
+ * patterns.
+ */
+declare const byCountry: (country: CountryCode, validators: readonly Validator[]) => ValidatorPattern[];
+/**
+ * Filter validators by entity type and build
+ * patterns.
+ */
+declare const byEntityType: (entityType: "person" | "company" | "any", validators: readonly Validator[]) => ValidatorPattern[];
+/**
+ * Build patterns for ALL provided validators.
+ */
+declare const allPatterns: (validators: readonly Validator[]) => ValidatorPattern[];
+//#endregion
+export { ValidatorPattern, allPatterns, byCountry, byEntityType, toPatterns, toRegex };
+//# sourceMappingURL=patterns.d.ts.map

package/dist/patterns.js

@@ -0,0 +1,123 @@
+//#region src/patterns.ts
+/** Separator chars that compact() strips. */
+const SEP = "[\\s\\-./]?";
+/**
+* Infer compact lengths from metadata or examples.
+*/
+const inferLengths = (v) => {
+	if (v.lengths && v.lengths.length > 0) return [...v.lengths];
+	if (v.examples && v.examples.length > 0) {
+		const lens = /* @__PURE__ */ new Set();
+		for (const ex of v.examples) lens.add(v.compact(ex).length);
+		return [...lens];
+	}
+	return [];
+};
+/**
+* Derive the display grouping from format().
+* Returns an array of group sizes, e.g.,
+* "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 formatted = v.format(compact);
+	if (formatted === compact) return null;
+	const parts = formatted.split(/[^a-zA-Z0-9]+/);
+	if (parts.length <= 1) return null;
+	const isAlphanumeric = parts.some((p) => /[a-zA-Z]/.test(p) && /\d/.test(p));
+	const groups = parts.filter((p) => p.length > 0 && (isAlphanumeric || /\d/.test(p))).map((p) => p.length);
+	return groups.length > 1 ? groups : null;
+};
+/**
+* Detect if this validator uses a known prefix
+* (e.g., "CZ" for DIČ, "CHE" for Swiss UID).
+*/
+const inferPrefix = (v) => {
+	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];
+	return null;
+};
+/**
+* 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";
+	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;
+		}
+	}
+	if (hasLetter && hasDigit) return "[A-Z0-9]";
+	if (hasLetter) return "[A-Z]";
+	return "\\d";
+};
+/**
+* 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);
+/**
+* Derive a loose candidate-matching regex from
+* a validator. The regex finds potential matches;
+* use `validate()` to confirm.
+*
+* Handles both digit-only (IČO, NIP) and
+* alphanumeric (IBAN, BIC, ISIN, LEI) validators.
+*/
+const toRegex = (v) => {
+	const prefix = inferPrefix(v);
+	const groups = inferGroups(v);
+	const lengths = inferLengths(v);
+	const cc = inferCharClass(v);
+	let pattern;
+	if (groups && lengths.length <= 1) pattern = groupsToPattern(groups, cc);
+	else if (lengths.length === 1) pattern = `${cc}{${lengths[0]}}`;
+	else if (lengths.length > 1) pattern = `${cc}{${Math.min(...lengths)},${Math.max(...lengths)}}`;
+	else pattern = `${cc}{6,20}`;
+	if (prefix) pattern = `${prefix}${SEP}${pattern}`;
+	return new RegExp(`(?<!\\w)${pattern}(?!\\w)`, "g");
+};
+/**
+* All discovered validators, lazily populated.
+* Import * from "../src" would pull everything;
+* instead, callers pass validators explicitly.
+*/
+/**
+* Build patterns for a list of validators.
+*/
+const toPatterns = (validators) => validators.map((v) => ({
+	validator: v,
+	regex: toRegex(v)
+}));
+/**
+* Filter validators by country code and build
+* patterns.
+*/
+const byCountry = (country, validators) => toPatterns(validators.filter((v) => v.country === country));
+/**
+* Filter validators by entity type and build
+* patterns.
+*/
+const byEntityType = (entityType, validators) => toPatterns(validators.filter((v) => entityType === "any" || v.entityType === entityType || v.entityType === "any"));
+/**
+* Build patterns for ALL provided validators.
+*/
+const allPatterns = (validators) => toPatterns(validators);
+//#endregion
+export { allPatterns, byCountry, byEntityType, toPatterns, toRegex };
+
+//# sourceMappingURL=patterns.js.map

package/dist/patterns.js.map

@@ -0,0 +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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"}

package/dist/pe/mod.d.ts

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

package/dist/pe/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import ruc from "./ruc.js";
+//#region src/pe/mod.ts
+var pe_exports = /* @__PURE__ */ __exportAll({ ruc: () => ruc });
+//#endregion
+export { pe_exports, ruc };
+
+//# sourceMappingURL=mod.js.map

package/dist/pe/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/pe/mod.ts"],"sourcesContent":["export { default as ruc } from \"./ruc\";\n"],"mappings":""}

package/dist/pe/ruc.d.ts

@@ -0,0 +1,19 @@
+import { ValidateResult, Validator } 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;
+/** Generate a random valid Peruvian RUC. */
+declare const generate: () => string;
+/**
+ * Peruvian RUC (tax identification number).
+ *
+ * Examples sourced from python-stdnum test suite
+ * (pe.ruc module).
+ */
+declare const ruc: Validator;
+//#endregion
+export { compact, ruc as default, format, generate, validate };
+//# sourceMappingURL=ruc.d.ts.map

package/dist/pe/ruc.js

@@ -0,0 +1,109 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/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,
+* others for specific entity types.
+*/
+const VALID_PREFIXES = new Set([
+	"10",
+	"15",
+	"17",
+	"20"
+]);
+const WEIGHTS = [
+	5,
+	4,
+	3,
+	2,
+	7,
+	6,
+	5,
+	4,
+	3,
+	2
+];
+const compact = (value) => clean(value, " -.").trim();
+/**
+* Compute the RUC check digit using weighted sum
+* mod 11. Weights: [5, 4, 3, 2, 7, 6, 5, 4, 3, 2].
+*
+* check = 11 - (sum % 11); if >= 10, subtract 10.
+*/
+const calcCheckDigit = (body) => {
+	let sum = 0;
+	for (let i = 0; i < 10; i++) sum += Number(body[i]) * WEIGHTS[i];
+	const remainder = 11 - sum % 11;
+	if (remainder >= 10) return remainder - 10;
+	return remainder;
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 11) return err("INVALID_LENGTH", "RUC must be 11 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "RUC must contain only digits");
+	const prefix = v.slice(0, 2);
+	if (!VALID_PREFIXES.has(prefix)) return err("INVALID_COMPONENT", "RUC has an invalid type prefix");
+	const expected = calcCheckDigit(v.slice(0, 10));
+	if (Number(v[10]) !== expected) return err("INVALID_CHECKSUM", "RUC check digit does not match");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+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);
+	return body + String(calcCheckDigit(body));
+};
+/**
+* Peruvian RUC (tax identification number).
+*
+* Examples sourced from python-stdnum test suite
+* (pe.ruc module).
+*/
+const ruc = {
+	name: "Peruvian Tax ID",
+	localName: "Registro Único de Contribuyentes",
+	abbreviation: "RUC",
+	aliases: ["RUC"],
+	candidatePattern: "\\d{11}",
+	country: "PE",
+	entityType: "any",
+	compact,
+	format,
+	validate,
+	sourceUrl: "https://www.sunat.gob.pe/",
+	lengths: [11],
+	examples: ["20131312955", "20100047218"],
+	generate
+};
+//#endregion
+export { compact, ruc as default, format, generate, validate };
+
+//# sourceMappingURL=ruc.js.map

package/dist/pe/ruc.js.map

@@ -0,0 +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 } 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];\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 (let i = 0; i < 10; i++) {\n    sum += Number(body[i]) * WEIGHTS[i]!;\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 prefixes = [\"10\", \"15\", \"17\", \"20\"] as const;\n  const prefix =\n    prefixes[Math.floor(Math.random() * prefixes.length)]!;\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;AAE9C,MAAM,WAAW,UACf,MAAM,OAAO,MAAM,CAAC,MAAM;;;;;;;AAQ5B,MAAM,kBAAkB,SAAyB;CAC/C,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,IAAI,IACtB,QAAO,OAAO,KAAK,GAAG,GAAG,QAAQ;CAEnC,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;CAC7B,MAAM,WAAW;EAAC;EAAM;EAAM;EAAM;EAAK;CAGzC,MAAM,OADJ,SAAS,KAAK,MAAM,KAAK,QAAQ,GAAG,SAAS,OAAO,IAChC,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"}

package/dist/ph/mod.d.ts

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import philid from "./philid.js";
+
+//#region src/ph/mod.d.ts
+
+//#endregion
+export { mod_d_exports, philid };
+//# sourceMappingURL=mod.d.ts.map

package/dist/ph/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import philid from "./philid.js";
+//#region src/ph/mod.ts
+var ph_exports = /* @__PURE__ */ __exportAll({ philid: () => philid });
+//#endregion
+export { ph_exports, philid };
+
+//# sourceMappingURL=mod.js.map

package/dist/ph/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/ph/mod.ts"],"sourcesContent":["export { default as philid } from \"./philid\";\n"],"mappings":""}

package/dist/ph/philid.d.ts

@@ -0,0 +1,13 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/ph/philid.d.ts
+/** Generate a random valid PhilID. */
+declare const generate: () => string;
+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;
+//#endregion
+export { compact, philid as default, format, generate, validate };
+//# sourceMappingURL=philid.d.ts.map

package/dist/ph/philid.js

@@ -0,0 +1,60 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+//#region src/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, " -");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 12) return err("INVALID_LENGTH", "PhilID must be exactly 12 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "PhilID must contain only digits");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	if (v.length === 12) return `${v.slice(0, 4)}-${v.slice(4, 11)}-${v.slice(11)}`;
+	return v;
+};
+/** Philippine Identification System Number. */
+const philid = {
+	name: "Philippine Identification System Number",
+	localName: "PhilSys Card Number",
+	abbreviation: "PhilID",
+	aliases: [
+		"PhilID",
+		"PhilSys",
+		"Philippine ID"
+	],
+	candidatePattern: "\\d{4}-\\d{4}-\\d{4}-\\d{4}",
+	country: "PH",
+	entityType: "person",
+	description: "12-digit personal identifier issued under the Philippine Identification System",
+	sourceUrl: "https://en.wikipedia.org/wiki/Philippine_national_identity_card",
+	lengths: [12],
+	examples: ["123456789012", "000011112222"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, philid as default, format, generate, validate };
+
+//# sourceMappingURL=philid.js.map

package/dist/ph/philid.js.map

@@ -0,0 +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"}

package/dist/pk/cnic.d.ts

@@ -0,0 +1,13 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/pk/cnic.d.ts
+/** Generate a random valid Pakistan CNIC. */
+declare const generate: () => string;
+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;
+//#endregion
+export { compact, cnic as default, format, generate, validate };
+//# sourceMappingURL=cnic.d.ts.map

package/dist/pk/cnic.js

@@ -0,0 +1,69 @@
+import { clean } from "../_util/clean.js";
+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))}`;
+};
+const compact = (value) => clean(value, " -");
+/** Valid province IDs (first digit). */
+const VALID_PROVINCES = new Set([
+	"1",
+	"2",
+	"3",
+	"4",
+	"5",
+	"6",
+	"7"
+]);
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 13) return err("INVALID_LENGTH", "CNIC must be 13 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "CNIC must contain only digits");
+	if (!VALID_PROVINCES.has(v[0])) return err("INVALID_COMPONENT", "CNIC province code is invalid");
+	if (v[12] === "0") return err("INVALID_COMPONENT", "CNIC gender digit must not be 0");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return `${v.slice(0, 5)}-${v.slice(5, 12)}-${v.slice(12)}`;
+};
+/** Pakistan Computerized National Identity Card. */
+const cnic = {
+	name: "Computerized National Identity Card",
+	localName: "Computerized National Identity Card",
+	abbreviation: "CNIC",
+	aliases: ["CNIC", "شناختی کارڈ"],
+	candidatePattern: "\\d{5}-?\\d{7}-?\\d",
+	country: "PK",
+	entityType: "person",
+	lengths: [13],
+	examples: ["3520112345671", "4210112345672"],
+	description: "13-digit identity card number issued by NADRA",
+	sourceUrl: "https://en.wikipedia.org/wiki/CNIC_(Pakistan)",
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, cnic as default, format, generate, validate };
+
+//# sourceMappingURL=cnic.js.map

package/dist/pk/cnic.js.map

@@ -0,0 +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  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;AAGH,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"}

package/dist/pk/mod.d.ts

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import cnic from "./cnic.js";
+
+//#region src/pk/mod.d.ts
+
+//#endregion
+export { cnic, mod_d_exports };
+//# sourceMappingURL=mod.d.ts.map

package/dist/pk/mod.js

@@ -0,0 +1,8 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import cnic from "./cnic.js";
+//#region src/pk/mod.ts
+var pk_exports = /* @__PURE__ */ __exportAll({ cnic: () => cnic });
+//#endregion
+export { cnic, pk_exports };
+
+//# sourceMappingURL=mod.js.map

package/dist/pk/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/pk/mod.ts"],"sourcesContent":["export { default as cnic } from \"./cnic\";\n"],"mappings":""}

package/dist/pl/mod.d.ts

@@ -0,0 +1,10 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nip from "./nip.js";
+import pesel from "./pesel.js";
+import regon from "./regon.js";
+
+//#region src/pl/mod.d.ts
+
+//#endregion
+export { mod_d_exports, nip, pesel, regon };
+//# sourceMappingURL=mod.d.ts.map

package/dist/pl/mod.js

@@ -0,0 +1,14 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nip from "./nip.js";
+import pesel from "./pesel.js";
+import regon from "./regon.js";
+//#region src/pl/mod.ts
+var pl_exports = /* @__PURE__ */ __exportAll({
+	nip: () => nip,
+	pesel: () => pesel,
+	regon: () => regon
+});
+//#endregion
+export { nip, pesel, pl_exports, regon };
+
+//# sourceMappingURL=mod.js.map

package/dist/pl/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/pl/mod.ts"],"sourcesContent":["export { default as nip } from \"./nip\";\nexport { default as pesel } from \"./pesel\";\nexport { default as regon } from \"./regon\";\n"],"mappings":""}