@stll/stdnum 2.1.0 → 2.1.2

package/dist/pe/mod.js

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

package/dist/pe/mod.js.map

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

package/dist/pe/ruc.d.ts

@@ -1,18 +1,10 @@
 import { CountryValidator, ValidateResult } from "../types.js";
-
-//#region src/pe/ruc.d.ts
+//#region src/generated/pe/ruc.d.ts
+declare const ruc: CountryValidator<"PE">;
 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 validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/**
- * Peruvian RUC (tax identification number).
- *
- * Examples sourced from python-stdnum test suite
- * (pe.ruc module).
- */
-declare const ruc: CountryValidator<"PE">;
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 //# sourceMappingURL=ruc.d.ts.map

package/dist/pe/ruc.js

@@ -1,94 +1,12 @@
-import { clean } from "../_util/clean.js";
-import { randomDigits, randomPick } from "../_util/generate.js";
-import { err } from "../_util/result.js";
-import { isdigits } from "../_util/strings.js";
-//#region src/pe/ruc.ts
-/**
-* 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 GENERATE_PREFIXES = [
-	"10",
-	"15",
-	"17",
-	"20"
-];
-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 (const [i, weight] of WEIGHTS.entries()) sum += Number(body[i]) * weight;
-	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 body = randomPick(GENERATE_PREFIXES) + 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}",
-	scope: "country",
-	country: "PE",
-	entityType: "any",
-	compact,
-	format,
-	validate,
-	sourceUrl: "https://www.sunat.gob.pe/",
-	lengths: [11],
-	examples: ["20131312955", "20100047218"],
-	generate
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/pe/ruc.ts
+const ruc = createValidator("pe.ruc", 141);
+const compact = ruc.compact;
+const format = ruc.format;
+const validate = ruc.validate;
+const generate = () => ruc.generate?.() ?? (() => {
+	throw new Error("Validator pe.ruc cannot generate values");
+})();
 //#endregion
 export { compact, ruc as default, format, generate, validate };
 

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 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,CAAC,CAAC,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"}
+{"version":3,"file":"ruc.js","names":[],"sources":["../../src/generated/pe/ruc.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst ruc: CountryValidator<\"PE\"> = createValidator(\n  \"pe.ruc\",\n  141,\n);\n\nexport default ruc;\nexport const compact = ruc.compact;\nexport const format = ruc.format;\nexport const validate = ruc.validate;\nexport const generate = (): string =>\n  ruc.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator pe.ruc cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,MAA8B,gBAClC,UACA,GACF;AAGA,MAAa,UAAU,IAAI;AAC3B,MAAa,SAAS,IAAI;AAC1B,MAAa,WAAW,IAAI;AAC5B,MAAa,iBACX,IAAI,WAAW,YACR;CACL,MAAM,IAAI,MACR,yCACF;AACF,EAAA,CAAG"}

package/dist/ph/mod.d.ts

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

package/dist/ph/mod.js

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

package/dist/ph/mod.js.map

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

package/dist/ph/philid.d.ts

@@ -1,25 +1,10 @@
 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/
- */
+//#region src/generated/ph/philid.d.ts
+declare const philid: CountryValidator<"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: CountryValidator<"PH">;
+declare const validate: (value: string) => ValidateResult;
+declare const generate: () => string;
 //#endregion
 export { compact, philid as default, format, generate, validate };
 //# sourceMappingURL=philid.d.ts.map

package/dist/ph/philid.js

@@ -1,48 +1,12 @@
-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
-/** 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}",
-	scope: "country",
-	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
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/ph/philid.ts
+const philid = createValidator("ph.philid", 142);
+const compact = philid.compact;
+const format = philid.format;
+const validate = philid.validate;
+const generate = () => philid.generate?.() ?? (() => {
+	throw new Error("Validator ph.philid cannot generate values");
+})();
 //#endregion
 export { compact, philid as default, format, generate, validate };
 

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 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"}
+{"version":3,"file":"philid.js","names":[],"sources":["../../src/generated/ph/philid.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst philid: CountryValidator<\"PH\"> = createValidator(\n  \"ph.philid\",\n  142,\n);\n\nexport default philid;\nexport const compact = philid.compact;\nexport const format = philid.format;\nexport const validate = philid.validate;\nexport const generate = (): string =>\n  philid.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator ph.philid cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,SAAiC,gBACrC,aACA,GACF;AAGA,MAAa,UAAU,OAAO;AAC9B,MAAa,SAAS,OAAO;AAC7B,MAAa,WAAW,OAAO;AAC/B,MAAa,iBACX,OAAO,WAAW,YACX;CACL,MAAM,IAAI,MACR,4CACF;AACF,EAAA,CAAG"}

package/dist/pk/cnic.d.ts

@@ -1,25 +1,10 @@
 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)
- */
+//#region src/generated/pk/cnic.d.ts
+declare const cnic: CountryValidator<"PK">;
 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: CountryValidator<"PK">;
+declare const validate: (value: string) => ValidateResult;
+declare const generate: () => string;
 //#endregion
 export { compact, cnic as default, format, generate, validate };
 //# sourceMappingURL=cnic.d.ts.map

package/dist/pk/cnic.js

@@ -1,57 +1,12 @@
-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
-/** 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",
-	scope: "country",
-	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
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/pk/cnic.ts
+const cnic = createValidator("pk.cnic", 143);
+const compact = cnic.compact;
+const format = cnic.format;
+const validate = cnic.validate;
+const generate = () => cnic.generate?.() ?? (() => {
+	throw new Error("Validator pk.cnic cannot generate values");
+})();
 //#endregion
 export { compact, cnic as default, format, generate, validate };
 

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 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"}
+{"version":3,"file":"cnic.js","names":[],"sources":["../../src/generated/pk/cnic.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst cnic: CountryValidator<\"PK\"> = createValidator(\n  \"pk.cnic\",\n  143,\n);\n\nexport default cnic;\nexport const compact = cnic.compact;\nexport const format = cnic.format;\nexport const validate = cnic.validate;\nexport const generate = (): string =>\n  cnic.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator pk.cnic cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,OAA+B,gBACnC,WACA,GACF;AAGA,MAAa,UAAU,KAAK;AAC5B,MAAa,SAAS,KAAK;AAC3B,MAAa,WAAW,KAAK;AAC7B,MAAa,iBACX,KAAK,WAAW,YACT;CACL,MAAM,IAAI,MACR,0CACF;AACF,EAAA,CAAG"}

package/dist/pk/mod.d.ts

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

package/dist/pk/mod.js

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

package/dist/pk/mod.js.map

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

package/dist/pl/mod.d.ts

@@ -1,8 +1,6 @@
 import nip from "./nip.js";
 import pesel from "./pesel.js";
 import regon from "./regon.js";
-
-//#region src/pl/mod.d.ts
 declare namespace mod_d_exports {
   export { nip, pesel, regon };
 }

package/dist/pl/mod.js

@@ -2,7 +2,7 @@ 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
+//#region src/generated/pl/mod.ts
 var pl_exports = /* @__PURE__ */ __exportAll({
 	nip: () => nip,
 	pesel: () => pesel,

package/dist/pl/mod.js.map

@@ -1 +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":""}
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/generated/pl/mod.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nexport { default as nip } from \"./nip\";\nexport { default as pesel } from \"./pesel\";\nexport { default as regon } from \"./regon\";\n"],"mappings":""}

package/dist/pl/nip.d.ts

@@ -1,17 +1,10 @@
 import { CountryValidator, ValidateResult } from "../types.js";
-
-//#region src/pl/nip.d.ts
+//#region src/generated/pl/nip.d.ts
+declare const nip: CountryValidator<"PL">;
 declare const compact: (value: string) => string;
-declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
-/**
- * Generate a random valid NIP. Retries if the
- * weighted sum mod 11 yields 10 (no valid check
- * digit for that payload).
- */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/** Polish VAT Number. */
-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,68 +1,12 @@
-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";
-//#region src/pl/nip.ts
-const WEIGHTS = [
-	6,
-	5,
-	7,
-	2,
-	3,
-	4,
-	5,
-	6,
-	7
-];
-const compact = (value) => {
-	const v = clean(value, " -");
-	if (v.startsWith("PL") || v.startsWith("pl")) return v.slice(2);
-	return v;
-};
-const validate = (value) => {
-	const v = compact(value);
-	if (v.length !== 10) return err("INVALID_LENGTH", "NIP must be exactly 10 digits");
-	if (!isdigits(v)) return err("INVALID_FORMAT", "NIP must contain only digits");
-	const sum = weightedSum(v.slice(0, 9), WEIGHTS, 11);
-	if (sum >= 10 || sum !== Number(v[9])) return err("INVALID_CHECKSUM", "NIP check digit does not match");
-	return {
-		valid: true,
-		compact: v
-	};
-};
-const format = (value) => `PL${compact(value)}`;
-const MAX_GENERATE_ATTEMPTS = 100;
-/**
-* Generate a random valid NIP. Retries if the
-* weighted sum mod 11 yields 10 (no valid check
-* digit for that payload).
-*/
-const generate = () => {
-	for (let i = 0; i < MAX_GENERATE_ATTEMPTS; i++) {
-		const payload = randomDigits(9);
-		const sum = weightedSum(payload, WEIGHTS, 11);
-		if (sum < 10) return `${payload}${String(sum)}`;
-	}
-	throw new Error("Failed to generate valid NIP");
-};
-/** Polish VAT Number. */
-const nip = {
-	name: "Polish VAT Number",
-	localName: "Numer Identyfikacji Podatkowej",
-	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",
-	examples: ["2234567895"],
-	compact,
-	format,
-	validate,
-	generate
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/pl/nip.ts
+const nip = createValidator("pl.nip", 144);
+const compact = nip.compact;
+const format = nip.format;
+const validate = nip.validate;
+const generate = () => nip.generate?.() ?? (() => {
+	throw new Error("Validator pl.nip cannot generate values");
+})();
 //#endregion
 export { compact, nip as default, format, generate, validate };
 

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 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"}
+{"version":3,"file":"nip.js","names":[],"sources":["../../src/generated/pl/nip.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst nip: CountryValidator<\"PL\"> = createValidator(\n  \"pl.nip\",\n  144,\n);\n\nexport default nip;\nexport const compact = nip.compact;\nexport const format = nip.format;\nexport const validate = nip.validate;\nexport const generate = (): string =>\n  nip.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator pl.nip cannot generate values\",\n    );\n  })();\n"],"mappings":";;AAIA,MAAM,MAA8B,gBAClC,UACA,GACF;AAGA,MAAa,UAAU,IAAI;AAC3B,MAAa,SAAS,IAAI;AAC1B,MAAa,WAAW,IAAI;AAC5B,MAAa,iBACX,IAAI,WAAW,YACR;CACL,MAAM,IAAI,MACR,yCACF;AACF,EAAA,CAAG"}

package/dist/pl/pesel.d.ts

@@ -1,18 +1,11 @@
-import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
-
-//#region src/pl/pesel.d.ts
+import { CountryValidator, ParsedIdentifier, ParsedPersonId, ValidateResult } from "../types.js";
+//#region src/generated/pl/pesel.d.ts
+declare const pesel: CountryValidator<"PL", ParsedPersonId>;
 declare const compact: (value: string) => string;
-declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
-/**
- * Extract birth date and gender from a PESEL number.
- * Returns null if the value is not valid.
- */
-declare const parse: (value: string) => ParsedPersonId | null;
-/** Generate a random valid Polish PESEL. */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/** Polish National Identification Number. */
-declare const pesel: CountryValidator<"PL", ParsedPersonId>;
+declare const parse: ((value: string) => ParsedIdentifier | null) & ((value: string) => ParsedPersonId | null);
 //#endregion
 export { compact, pesel as default, format, generate, parse, validate };
 //# sourceMappingURL=pesel.d.ts.map