@stll/stdnum 2.1.1 → 2.1.3

package/dist/mx/curp.js.map

@@ -1 +1 @@
-{"version":3,"file":"curp.js","names":[],"sources":["../../src/mx/curp.ts"],"sourcesContent":["/**\n * CURP (Clave Única de Registro de Población).\n *\n * Mexican personal identification number. 18 characters:\n * 4 letters (name encoding) + 6 digits (YYMMDD birth\n * date) + 1 letter (gender: H=male, M=female) + 2\n * letters (state code) + 3 consonants (name\n * disambiguation) + 1 digit (century discriminator) +\n * 1 check digit.\n *\n * The check digit is computed as a weighted sum mod 10\n * using an alphabet mapping (0-9, A-N, &, O-Z).\n *\n * @see https://en.wikipedia.org/wiki/CURP\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\n/** Valid Mexican state codes (2-letter). */\nconst STATE_CODES = new Set([\n  \"AS\",\n  \"BC\",\n  \"BS\",\n  \"CC\",\n  \"CL\",\n  \"CM\",\n  \"CS\",\n  \"CH\",\n  \"DF\",\n  \"DG\",\n  \"GT\",\n  \"GR\",\n  \"HG\",\n  \"JC\",\n  \"MC\",\n  \"MN\",\n  \"MS\",\n  \"NT\",\n  \"NL\",\n  \"OC\",\n  \"PL\",\n  \"QT\",\n  \"QR\",\n  \"SP\",\n  \"SL\",\n  \"SR\",\n  \"TC\",\n  \"TS\",\n  \"TL\",\n  \"VZ\",\n  \"YN\",\n  \"ZS\",\n  \"NE\", // Born abroad\n]);\nconst STATE_CODE_LIST = [...STATE_CODES];\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\n/**\n * Alphabet for CURP check digit computation.\n * Matches python-stdnum: digits 0-9, then A-N,\n * ampersand, O-Z.\n */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (const [i, ch] of ALPHABET.split(\"\").entries()) {\n  CHAR_MAP.set(ch, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim().toUpperCase();\n\n/**\n * Compute the CURP check digit. Sum each of the first\n * 17 characters multiplied by weight (18 - position),\n * then check = (10 - sum % 10) % 10.\n */\nconst calcCheckDigit = (value: string): string => {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    const ch = value[i];\n    if (ch === undefined) continue;\n    sum += (CHAR_MAP.get(ch) ?? 0) * (18 - i);\n  }\n  return String((10 - (sum % 10)) % 10);\n};\n\n/**\n * Resolve full year from 2-digit year and century\n * discriminator: 0-9 = 1900s, letter = 2000s.\n */\nconst resolveCurpYear = (\n  yy: number,\n  centuryChar: string,\n): number =>\n  centuryChar >= \"0\" && centuryChar <= \"9\"\n    ? 1900 + yy\n    : 2000 + yy;\n\nconst CURP_RE =\n  /^[A-Z]{4}\\d{6}[HM][A-Z]{2}[A-Z]{3}[0-9A-Z]\\d$/;\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 18) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"CURP must be 18 characters\",\n    );\n  }\n\n  if (!CURP_RE.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"CURP has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD at positions 4-9).\n  const yy = Number(v.slice(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  // SAFETY: regex validation ensures v.length === 18.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = resolveCurpYear(yy, v[16]!);\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid birth date\",\n    );\n  }\n\n  // Validate state code at positions 11-12.\n  const state = v.slice(11, 13);\n  if (!STATE_CODES.has(state)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"CURP contains an invalid state code\",\n    );\n  }\n\n  // Verify check digit (last character).\n  const expected = calcCheckDigit(v);\n  if (v[17] !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"CURP 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/**\n * Extract birth date and gender from a CURP.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const yy = Number(v.slice(4, 6));\n  const mm = Number(v.slice(6, 8));\n  const dd = Number(v.slice(8, 10));\n\n  // SAFETY: regex validation ensures v.length === 18.\n  // eslint-disable-next-line no-non-null-assertion\n  const year = resolveCurpYear(yy, v[16]!);\n\n  const genderChar = v[10];\n  const gender: \"male\" | \"female\" =\n    genderChar === \"H\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\nconst randomLetter = (): string =>\n  LETTERS.charAt(randomInt(0, LETTERS.length - 1));\n\n/** Generate a random valid CURP. */\nconst generate = (): string => {\n  const year = randomInt(1980, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const yy = String(year % 100).padStart(2, \"0\");\n  const gender = Math.random() < 0.5 ? \"H\" : \"M\";\n  const state =\n    STATE_CODE_LIST[\n      randomInt(0, STATE_CODE_LIST.length - 1)\n    ] ?? \"NE\";\n  const centuryChar =\n    year >= 2000 ? randomLetter() : String(randomInt(0, 9));\n  const body =\n    `${randomLetter()}${randomLetter()}` +\n    `${randomLetter()}${randomLetter()}` +\n    `${yy}${month}${day}${gender}${state}` +\n    `${randomLetter()}${randomLetter()}${randomLetter()}` +\n    `${centuryChar}`;\n  return `${body}${calcCheckDigit(body)}`;\n};\n\n/**\n * Mexican CURP (personal identification number).\n *\n * Example sourced from python-stdnum test suite.\n */\nconst curp: CountryValidator<\"MX\", ParsedPersonId> = {\n  name: \"Mexican Personal ID\",\n  localName: \"Clave Única de Registro de Población\",\n  abbreviation: \"CURP\",\n  aliases: [\n    \"CURP\",\n    \"Clave Única de Registro de Población\",\n  ] as const,\n  candidatePattern: \"[A-Z]{4}\\\\d{6}[HM][A-Z]{5}[A-Z\\\\d]\\\\d\",\n  scope: \"country\",\n  country: \"MX\",\n  entityType: \"person\",\n  lengths: [18] as const,\n  examples: [\"BOXW310820HNERXN09\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n  sourceUrl: \"https://en.wikipedia.org/wiki/CURP\",\n};\n\nexport default curp;\nexport { compact, format, generate, parse, validate };\n"],"mappings":"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"}
+{"version":3,"file":"curp.js","names":[],"sources":["../../src/generated/mx/curp.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type {\n  CountryValidator,\n  ParsedPersonId,\n} from \"../../types\";\n\nconst curp: CountryValidator<\"MX\", ParsedPersonId> =\n  createValidator(\"mx.curp\", 128);\n\nexport default curp;\nexport const compact = curp.compact;\nexport const format = curp.format;\nexport const validate = curp.validate;\nexport const generate = (): string =>\n  curp.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator mx.curp cannot generate values\",\n    );\n  })();\nexport const parse = curp.parse;\n"],"mappings":";;AAOA,MAAM,OACJ,gBAAgB,WAAW,GAAG;AAGhC,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;AACL,MAAa,QAAQ,KAAK"}

package/dist/mx/mod.d.ts

@@ -1,8 +1,6 @@
 import clabe from "./clabe.js";
 import curp from "./curp.js";
 import rfc from "./rfc.js";
-
-//#region src/mx/mod.d.ts
 declare namespace mod_d_exports {
   export { clabe, curp, rfc };
 }

package/dist/mx/mod.js

@@ -2,7 +2,7 @@ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
 import clabe from "./clabe.js";
 import curp from "./curp.js";
 import rfc from "./rfc.js";
-//#region src/mx/mod.ts
+//#region src/generated/mx/mod.ts
 var mx_exports = /* @__PURE__ */ __exportAll({
 	clabe: () => clabe,
 	curp: () => curp,

package/dist/mx/mod.js.map

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

package/dist/mx/rfc.d.ts

@@ -1,17 +1,10 @@
 import { CountryValidator, ValidateResult } from "../types.js";
-
-//#region src/mx/rfc.d.ts
+//#region src/generated/mx/rfc.d.ts
+declare const rfc: CountryValidator<"MX">;
 declare const compact: (value: string) => string;
-declare const validate: (value: string) => ValidateResult;
 declare const format: (value: string) => string;
-/** Generate a random valid RFC. */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/**
- * Mexican RFC (tax identification number).
- *
- * Examples sourced from python-stdnum test suite.
- */
-declare const rfc: CountryValidator<"MX">;
 //#endregion
 export { compact, rfc as default, format, generate, validate };
 //# sourceMappingURL=rfc.d.ts.map

package/dist/mx/rfc.js

@@ -1,94 +1,12 @@
-import { clean } from "../_util/clean.js";
-import { isValidDate } from "../_util/date.js";
-import { randomInt } from "../_util/generate.js";
-import { err } from "../_util/result.js";
-//#region src/mx/rfc.ts
-/** Alphabet for RFC check digit computation. */
-const ALPHABET = "0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ";
-const CHAR_MAP = /* @__PURE__ */ new Map();
-for (const [i, ch] of ALPHABET.split("").entries()) CHAR_MAP.set(ch, i);
-const compact = (value) => clean(value, " -.").trim().toUpperCase();
-/**
-* Compute the RFC check digit using mod 11 with
-* the SAT alphabet mapping.
-*
-* Each character is mapped to its position in the
-* ALPHABET, then multiplied by a weight that starts
-* at (len + 1) and decreases by 1. The check digit
-* is (11 - sum % 11) % 11, mapped to 0-9 or "A".
-*/
-const calcCheckDigit = (value) => {
-	const padded = value.length === 11 ? ` ${value}` : value;
-	let sum = 0;
-	for (let i = 0; i < 12; i++) {
-		const ch = padded[i];
-		if (ch === void 0) continue;
-		const v = CHAR_MAP.get(ch) ?? 0;
-		sum += v * (13 - i);
-	}
-	const remainder = sum % 11;
-	if (remainder === 0) return "0";
-	const digit = 11 - remainder;
-	return digit === 10 ? "A" : String(digit);
-};
-const PERSON_RE = /^[A-ZÑ&]{4}\d{6}[A-Z\d]{3}$/;
-const COMPANY_RE = /^[A-ZÑ&]{3}\d{6}[A-Z\d]{3}$/;
-const PREFIX_ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZÑ&";
-const RFC_ALNUM = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
-const validate = (value) => {
-	const v = compact(value);
-	if (v.length !== 12 && v.length !== 13) return err("INVALID_LENGTH", "RFC must be 12 or 13 characters");
-	const isPerson = v.length === 13;
-	if (!(isPerson ? PERSON_RE : COMPANY_RE).test(v)) return err("INVALID_FORMAT", "RFC has an invalid format");
-	const dateOffset = isPerson ? 4 : 3;
-	const yy = Number(v.slice(dateOffset, dateOffset + 2));
-	const mm = Number(v.slice(dateOffset + 2, dateOffset + 4));
-	const dd = Number(v.slice(dateOffset + 4, dateOffset + 6));
-	if (!isValidDate(2e3 + yy, mm, dd)) return err("INVALID_COMPONENT", "RFC contains an invalid date");
-	const expected = calcCheckDigit(v.slice(0, -1));
-	if (v.at(-1) !== expected) return err("INVALID_CHECKSUM", "RFC check digit does not match");
-	return {
-		valid: true,
-		compact: v
-	};
-};
-const format = (value) => compact(value);
-const randomCharFrom = (chars) => chars.charAt(randomInt(0, chars.length - 1));
-/** Generate a random valid RFC. */
-const generate = () => {
-	const prefixLength = Math.random() < .5 ? 4 : 3;
-	let prefix = "";
-	for (let i = 0; i < prefixLength; i++) prefix += randomCharFrom(PREFIX_ALPHA);
-	const year = randomInt(2e3, 2099);
-	const month = String(randomInt(1, 12)).padStart(2, "0");
-	const day = String(randomInt(1, 28)).padStart(2, "0");
-	let homoclave = "";
-	for (let i = 0; i < 2; i++) homoclave += randomCharFrom(RFC_ALNUM);
-	const body = `${prefix}${String(year % 100).padStart(2, "0")}${month}${day}${homoclave}`;
-	return `${body}${calcCheckDigit(body)}`;
-};
-/**
-* Mexican RFC (tax identification number).
-*
-* Examples sourced from python-stdnum test suite.
-*/
-const rfc = {
-	name: "Mexican Tax ID",
-	localName: "Registro Federal de Contribuyentes",
-	abbreviation: "RFC",
-	aliases: ["RFC", "Registro Federal de Contribuyentes"],
-	candidatePattern: "[A-ZÑ&]{3,4}\\d{6}[A-Z\\d]{3}",
-	scope: "country",
-	country: "MX",
-	entityType: "any",
-	lengths: [12, 13],
-	examples: ["GODE561231GR8", "MAB9307148T4"],
-	compact,
-	format,
-	validate,
-	generate,
-	sourceUrl: "https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)"
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/mx/rfc.ts
+const rfc = createValidator("mx.rfc", 129);
+const compact = rfc.compact;
+const format = rfc.format;
+const validate = rfc.validate;
+const generate = () => rfc.generate?.() ?? (() => {
+	throw new Error("Validator mx.rfc cannot generate values");
+})();
 //#endregion
 export { compact, rfc as default, format, generate, validate };
 

package/dist/mx/rfc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rfc.js","names":[],"sources":["../../src/mx/rfc.ts"],"sourcesContent":["/**\n * RFC (Registro Federal de Contribuyentes).\n *\n * Mexican tax identification number issued by the SAT\n * (Servicio de Administración Tributaria). The number is\n * 13 characters for individuals (4 letters + 6 digits\n * YYMMDD + 3 alphanumeric) or 12 characters for\n * companies (3 letters + 6 digits YYMMDD + 3\n * alphanumeric). The last character is a check digit\n * computed with a mod 11 algorithm over a specific\n * alphabet mapping.\n *\n * Format: AAAA######XXX (persons, 13 chars)\n *         AAA######XXX  (companies, 12 chars)\n *\n * @see https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\n */\n\nimport type {\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\n/** Alphabet for RFC check digit computation. */\nconst ALPHABET = \"0123456789ABCDEFGHIJKLMN&OPQRSTUVWXYZ Ñ\";\n\nconst CHAR_MAP = new Map<string, number>();\nfor (const [i, ch] of ALPHABET.split(\"\").entries()) {\n  CHAR_MAP.set(ch, i);\n}\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\").trim().toUpperCase();\n\n/**\n * Compute the RFC check digit using mod 11 with\n * the SAT alphabet mapping.\n *\n * Each character is mapped to its position in the\n * ALPHABET, then multiplied by a weight that starts\n * at (len + 1) and decreases by 1. The check digit\n * is (11 - sum % 11) % 11, mapped to 0-9 or \"A\".\n */\nconst calcCheckDigit = (value: string): string => {\n  // Pad 12-char company RFCs with a leading space\n  // to align weights with the 13-char algorithm.\n  const padded = value.length === 11 ? ` ${value}` : value;\n  let sum = 0;\n  for (let i = 0; i < 12; i++) {\n    const ch = padded[i];\n    if (ch === undefined) continue;\n    const v = CHAR_MAP.get(ch) ?? 0;\n    sum += v * (13 - i);\n  }\n  const remainder = sum % 11;\n  if (remainder === 0) return \"0\";\n  const digit = 11 - remainder;\n  return digit === 10 ? \"A\" : String(digit);\n};\n\nconst PERSON_RE = /^[A-ZÑ&]{4}\\d{6}[A-Z\\d]{3}$/;\nconst COMPANY_RE = /^[A-ZÑ&]{3}\\d{6}[A-Z\\d]{3}$/;\nconst PREFIX_ALPHA = \"ABCDEFGHIJKLMNOPQRSTUVWXYZÑ&\";\nconst RFC_ALNUM = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 12 && v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"RFC must be 12 or 13 characters\",\n    );\n  }\n\n  const isPerson = v.length === 13;\n  const re = isPerson ? PERSON_RE : COMPANY_RE;\n  if (!re.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"RFC has an invalid format\",\n    );\n  }\n\n  // Validate the embedded date (YYMMDD).\n  const dateOffset = isPerson ? 4 : 3;\n  const yy = Number(v.slice(dateOffset, dateOffset + 2));\n  const mm = Number(\n    v.slice(dateOffset + 2, dateOffset + 4),\n  );\n  const dd = Number(\n    v.slice(dateOffset + 4, dateOffset + 6),\n  );\n\n  // RFC dates use 2-digit years; use 2000 century for\n  // date validation (any valid calendar date is accepted).\n  const year = 2000 + yy;\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"RFC contains an invalid date\",\n    );\n  }\n\n  // Verify check digit (last character).\n  const body = v.slice(0, -1);\n  const expected = calcCheckDigit(body);\n  if (v.at(-1) !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"RFC check digit does not match\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => compact(value);\n\nconst randomCharFrom = (chars: string): string =>\n  chars.charAt(randomInt(0, chars.length - 1));\n\n/** Generate a random valid RFC. */\nconst generate = (): string => {\n  const isPerson = Math.random() < 0.5;\n  const prefixLength = isPerson ? 4 : 3;\n  let prefix = \"\";\n  for (let i = 0; i < prefixLength; i++) {\n    prefix += randomCharFrom(PREFIX_ALPHA);\n  }\n\n  const year = randomInt(2000, 2099);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  let homoclave = \"\";\n  for (let i = 0; i < 2; i++) {\n    homoclave += randomCharFrom(RFC_ALNUM);\n  }\n\n  const body =\n    `${prefix}${String(year % 100).padStart(2, \"0\")}` +\n    `${month}${day}${homoclave}`;\n  return `${body}${calcCheckDigit(body)}`;\n};\n\n/**\n * Mexican RFC (tax identification number).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst rfc: CountryValidator<\"MX\"> = {\n  name: \"Mexican Tax ID\",\n  localName: \"Registro Federal de Contribuyentes\",\n  abbreviation: \"RFC\",\n  aliases: [\n    \"RFC\",\n    \"Registro Federal de Contribuyentes\",\n  ] as const,\n  candidatePattern: \"[A-ZÑ&]{3,4}\\\\d{6}[A-Z\\\\d]{3}\",\n  scope: \"country\",\n  country: \"MX\",\n  entityType: \"any\",\n  lengths: [12, 13] as const,\n  examples: [\"GODE561231GR8\", \"MAB9307148T4\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Tax_Identification_Number_(Mexico)\",\n};\n\nexport default rfc;\nexport { compact, format, generate, validate };\n"],"mappings":"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"}
+{"version":3,"file":"rfc.js","names":[],"sources":["../../src/generated/mx/rfc.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type { CountryValidator } from \"../../types\";\n\nconst rfc: CountryValidator<\"MX\"> = createValidator(\n  \"mx.rfc\",\n  129,\n);\n\nexport default rfc;\nexport const compact = rfc.compact;\nexport const format = rfc.format;\nexport const validate = rfc.validate;\nexport const generate = (): string =>\n  rfc.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator mx.rfc 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/my/mod.d.ts

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

package/dist/my/mod.js

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

package/dist/my/mod.js.map

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

package/dist/my/nric.d.ts

@@ -1,18 +1,11 @@
-import { CountryValidator, ParsedPersonId, ValidateResult } from "../types.js";
-
-//#region src/my/nric.d.ts
+import { CountryValidator, ParsedIdentifier, ParsedPersonId, ValidateResult } from "../types.js";
+//#region src/generated/my/nric.d.ts
+declare const nric: CountryValidator<"MY", 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 an NRIC.
- * Returns null if the value is not valid.
- */
-declare const parse: (value: string) => ParsedPersonId | null;
-/** Generate a random valid Malaysian NRIC. */
+declare const validate: (value: string) => ValidateResult;
 declare const generate: () => string;
-/** Malaysian National Registration Identity Card. */
-declare const nric: CountryValidator<"MY", ParsedPersonId>;
+declare const parse: ((value: string) => ParsedIdentifier | null) & ((value: string) => ParsedPersonId | null);
 //#endregion
 export { compact, nric as default, format, generate, parse, validate };
 //# sourceMappingURL=nric.d.ts.map

package/dist/my/nric.js

@@ -1,187 +1,13 @@
-import { clean } from "../_util/clean.js";
-import { isValidDate } from "../_util/date.js";
-import { randomInt } from "../_util/generate.js";
-import { err } from "../_util/result.js";
-import { isdigits } from "../_util/strings.js";
-//#region src/my/nric.ts
-/**
-* Valid place-of-birth codes (2-digit).
-* Codes 01-16 are states, 21-59 are pre-2000
-* state codes, 60-68 born outside (ASEAN),
-* 71-72/74-79 foreign nationals, 82-93 regions,
-* 98-99 legacy.
-*/
-const VALID_PB_CODES = new Set([
-	"01",
-	"02",
-	"03",
-	"04",
-	"05",
-	"06",
-	"07",
-	"08",
-	"09",
-	"10",
-	"11",
-	"12",
-	"13",
-	"14",
-	"15",
-	"16",
-	"21",
-	"22",
-	"23",
-	"24",
-	"25",
-	"26",
-	"27",
-	"28",
-	"29",
-	"30",
-	"31",
-	"32",
-	"33",
-	"34",
-	"35",
-	"36",
-	"37",
-	"38",
-	"39",
-	"40",
-	"41",
-	"42",
-	"43",
-	"44",
-	"45",
-	"46",
-	"47",
-	"48",
-	"49",
-	"50",
-	"51",
-	"52",
-	"53",
-	"54",
-	"55",
-	"56",
-	"57",
-	"58",
-	"59",
-	"60",
-	"61",
-	"62",
-	"63",
-	"64",
-	"65",
-	"66",
-	"67",
-	"68",
-	"71",
-	"72",
-	"74",
-	"75",
-	"76",
-	"77",
-	"78",
-	"79",
-	"82",
-	"83",
-	"84",
-	"85",
-	"86",
-	"87",
-	"88",
-	"89",
-	"90",
-	"91",
-	"92",
-	"93",
-	"98",
-	"99"
-]);
-const compact = (value) => clean(value, " -");
-/**
-* Resolve the birth year from a 2-digit year.
-* Years after the reference year are assumed to be
-* in the previous century. Accepts an explicit
-* reference year to avoid multiple clock reads.
-*/
-const resolveYear = (yy, referenceYear) => {
-	const year = Math.floor(referenceYear / 100) * 100 + yy;
-	return year > referenceYear ? year - 100 : year;
-};
-const validate = (value) => {
-	const v = compact(value);
-	if (v.length !== 12) return err("INVALID_LENGTH", "NRIC must be exactly 12 digits");
-	if (!isdigits(v)) return err("INVALID_FORMAT", "NRIC must contain only digits");
-	const yy = Number(v.slice(0, 2));
-	const mm = Number(v.slice(2, 4));
-	const dd = Number(v.slice(4, 6));
-	if (!isValidDate(resolveYear(yy, (/* @__PURE__ */ new Date()).getFullYear()), mm, dd)) return err("INVALID_COMPONENT", "NRIC contains an invalid birth date");
-	const pb = v.slice(6, 8);
-	if (!VALID_PB_CODES.has(pb)) return err("INVALID_COMPONENT", "Invalid place-of-birth code: " + pb);
-	return {
-		valid: true,
-		compact: v
-	};
-};
-const format = (value) => {
-	const v = compact(value);
-	return v.slice(0, 6) + "-" + v.slice(6, 8) + "-" + v.slice(8);
-};
-/**
-* Extract birth date and gender from an NRIC.
-* Returns null if the value is not valid.
-*/
-const parse = (value) => {
-	const result = validate(value);
-	if (!result.valid) return null;
-	const v = result.compact;
-	const yy = Number(v.slice(0, 2));
-	const mm = Number(v.slice(2, 4));
-	const dd = Number(v.slice(4, 6));
-	const year = resolveYear(yy, (/* @__PURE__ */ new Date()).getFullYear());
-	const gender = Number(v[11]) % 2 === 1 ? "male" : "female";
-	return {
-		birthDate: new Date(year, mm - 1, dd),
-		gender
-	};
-};
-const PB_CODES = [...VALID_PB_CODES];
-/** Generate a random valid Malaysian NRIC. */
-const generate = () => {
-	const year = randomInt(1950, 2024);
-	const month = String(randomInt(1, 12)).padStart(2, "0");
-	const day = String(randomInt(1, 28)).padStart(2, "0");
-	const pb = PB_CODES[randomInt(0, PB_CODES.length - 1)] ?? "01";
-	const serial = String(randomInt(0, 999)).padStart(3, "0");
-	const lastDigit = Math.random() < .5 ? String(randomInt(0, 4) * 2 + 1) : String(randomInt(0, 4) * 2);
-	return `${String(year % 100).padStart(2, "0")}${month}${day}${pb}${serial}${lastDigit}`;
-};
-/** Malaysian National Registration Identity Card. */
-const nric = {
-	name: "Malaysian National Registration Identity Card Number",
-	localName: "Nombor Kad Pengenalan",
-	abbreviation: "NRIC",
-	aliases: [
-		"NRIC",
-		"MyKad",
-		"kad pengenalan"
-	],
-	candidatePattern: "\\d{6}-?\\d{2}-?\\d{4}",
-	scope: "country",
-	country: "MY",
-	entityType: "person",
-	description: "12-digit identity card number encoding birth date, place of birth, and gender",
-	sourceUrl: "https://en.wikipedia.org/wiki/Malaysian_identity_card",
-	lengths: [12],
-	examples: ["770305021234", "880715141234"],
-	compact,
-	format,
-	parse,
-	validate,
-	generate
-};
+import { createValidator } from "../runtime.js";
+//#region src/generated/my/nric.ts
+const nric = createValidator("my.nric", 130);
+const compact = nric.compact;
+const format = nric.format;
+const validate = nric.validate;
+const generate = () => nric.generate?.() ?? (() => {
+	throw new Error("Validator my.nric cannot generate values");
+})();
+const parse = nric.parse;
 //#endregion
 export { compact, nric as default, format, generate, parse, validate };
 

package/dist/my/nric.js.map

@@ -1 +1 @@
-{"version":3,"file":"nric.js","names":[],"sources":["../../src/my/nric.ts"],"sourcesContent":["/**\n * NRIC (Malaysian National Registration Identity\n * Card Number, Nombor Kad Pengenalan).\n *\n * 12 digits: YYMMDD (birth date) + PB (place of\n * birth, 2 digits) + SSS (serial) + G (gender:\n * odd = male, even = female).\n *\n * No checksum; validation is structural (valid date\n * and valid place-of-birth code).\n *\n * @see https://en.wikipedia.org/wiki/Malaysian_identity_card\n */\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  CountryValidator,\n} from \"../types\";\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\n/**\n * Valid place-of-birth codes (2-digit).\n * Codes 01-16 are states, 21-59 are pre-2000\n * state codes, 60-68 born outside (ASEAN),\n * 71-72/74-79 foreign nationals, 82-93 regions,\n * 98-99 legacy.\n */\nconst VALID_PB_CODES = new Set([\n  \"01\",\n  \"02\",\n  \"03\",\n  \"04\",\n  \"05\",\n  \"06\",\n  \"07\",\n  \"08\",\n  \"09\",\n  \"10\",\n  \"11\",\n  \"12\",\n  \"13\",\n  \"14\",\n  \"15\",\n  \"16\",\n  \"21\",\n  \"22\",\n  \"23\",\n  \"24\",\n  \"25\",\n  \"26\",\n  \"27\",\n  \"28\",\n  \"29\",\n  \"30\",\n  \"31\",\n  \"32\",\n  \"33\",\n  \"34\",\n  \"35\",\n  \"36\",\n  \"37\",\n  \"38\",\n  \"39\",\n  \"40\",\n  \"41\",\n  \"42\",\n  \"43\",\n  \"44\",\n  \"45\",\n  \"46\",\n  \"47\",\n  \"48\",\n  \"49\",\n  \"50\",\n  \"51\",\n  \"52\",\n  \"53\",\n  \"54\",\n  \"55\",\n  \"56\",\n  \"57\",\n  \"58\",\n  \"59\",\n  \"60\",\n  \"61\",\n  \"62\",\n  \"63\",\n  \"64\",\n  \"65\",\n  \"66\",\n  \"67\",\n  \"68\",\n  \"71\",\n  \"72\",\n  \"74\",\n  \"75\",\n  \"76\",\n  \"77\",\n  \"78\",\n  \"79\",\n  \"82\",\n  \"83\",\n  \"84\",\n  \"85\",\n  \"86\",\n  \"87\",\n  \"88\",\n  \"89\",\n  \"90\",\n  \"91\",\n  \"92\",\n  \"93\",\n  \"98\",\n  \"99\",\n]);\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\n/**\n * Resolve the birth year from a 2-digit year.\n * Years after the reference year are assumed to be\n * in the previous century. Accepts an explicit\n * reference year to avoid multiple clock reads.\n */\nconst resolveYear = (\n  yy: number,\n  referenceYear: number,\n): number => {\n  const century = Math.floor(referenceYear / 100);\n  const year = century * 100 + yy;\n  return year > referenceYear ? year - 100 : year;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 12) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"NRIC must be exactly 12 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"NRIC must contain only digits\",\n    );\n  }\n\n  // Validate birth date (YYMMDD)\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n\n  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"NRIC contains an invalid birth date\",\n    );\n  }\n\n  // Validate place-of-birth code\n  const pb = v.slice(6, 8);\n  if (!VALID_PB_CODES.has(pb)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Invalid place-of-birth code: \" + pb,\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  return (\n    v.slice(0, 6) + \"-\" + v.slice(6, 8) + \"-\" + v.slice(8)\n  );\n};\n\n/**\n * Extract birth date and gender from an NRIC.\n * Returns null if the value is not valid.\n */\nconst parse = (value: string): ParsedPersonId | null => {\n  const result = validate(value);\n  if (!result.valid) return null;\n\n  const v = result.compact;\n  const yy = Number(v.slice(0, 2));\n  const mm = Number(v.slice(2, 4));\n  const dd = Number(v.slice(4, 6));\n  const now = new Date().getFullYear();\n  const year = resolveYear(yy, now);\n\n  // Last digit: odd = male, even = female\n  const lastDigit = Number(v[11]);\n  const gender = lastDigit % 2 === 1 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\nconst PB_CODES = [...VALID_PB_CODES];\n\n/** Generate a random valid Malaysian NRIC. */\nconst generate = (): string => {\n  const year = randomInt(1950, 2024);\n  const month = String(randomInt(1, 12)).padStart(2, \"0\");\n  const day = String(randomInt(1, 28)).padStart(2, \"0\");\n  const pb =\n    PB_CODES[randomInt(0, PB_CODES.length - 1)] ?? \"01\";\n  const serial = String(randomInt(0, 999)).padStart(3, \"0\");\n  const isMale = Math.random() < 0.5;\n  const lastDigit = isMale\n    ? String(randomInt(0, 4) * 2 + 1)\n    : String(randomInt(0, 4) * 2);\n\n  return (\n    `${String(year % 100).padStart(2, \"0\")}` +\n    `${month}${day}${pb}${serial}${lastDigit}`\n  );\n};\n\n/** Malaysian National Registration Identity Card. */\nconst nric: CountryValidator<\"MY\", ParsedPersonId> = {\n  name: \"Malaysian National Registration Identity Card Number\",\n  localName: \"Nombor Kad Pengenalan\",\n  abbreviation: \"NRIC\",\n  aliases: [\"NRIC\", \"MyKad\", \"kad pengenalan\"] as const,\n  candidatePattern: \"\\\\d{6}-?\\\\d{2}-?\\\\d{4}\",\n  scope: \"country\",\n  country: \"MY\",\n  entityType: \"person\",\n  description:\n    \"12-digit identity card number encoding birth date, place of birth, and gender\",\n  sourceUrl:\n    \"https://en.wikipedia.org/wiki/Malaysian_identity_card\",\n  lengths: [12] as const,\n  examples: [\"770305021234\", \"880715141234\"] as const,\n  compact,\n  format,\n  parse,\n  validate,\n  generate,\n};\n\nexport default nric;\nexport { compact, format, generate, parse, validate };\n"],"mappings":";;;;;;;;;;;;;AAiCA,MAAM,iBAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,WAAW,UACf,MAAM,OAAO,IAAI;;;;;;;AAQnB,MAAM,eACJ,IACA,kBACW;CAEX,MAAM,OADU,KAAK,MAAM,gBAAgB,GACxB,IAAI,MAAM;CAC7B,OAAO,OAAO,gBAAgB,OAAO,MAAM;AAC7C;AAEA,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,KAAK;CACvB,IAAI,EAAE,WAAW,IACf,OAAO,IACL,kBACA,gCACF;CAEF,IAAI,CAAC,SAAS,CAAC,GACb,OAAO,IACL,kBACA,+BACF;CAIF,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAK/B,IAAI,CAAC,YAFQ,YAAY,qBADb,IAAI,KAAK,EAAA,CAAE,YACQ,CAEX,GAAG,IAAI,EAAE,GAC3B,OAAO,IACL,qBACA,qCACF;CAIF,MAAM,KAAK,EAAE,MAAM,GAAG,CAAC;CACvB,IAAI,CAAC,eAAe,IAAI,EAAE,GACxB,OAAO,IACL,qBACA,kCAAkC,EACpC;CAGF,OAAO;EAAE,OAAO;EAAM,SAAS;CAAE;AACnC;AAEA,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,KAAK;CACvB,OACE,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,MAAM,CAAC;AAEzD;;;;;AAMA,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,KAAK;CAC7B,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAC/B,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAE/B,MAAM,OAAO,YAAY,qBADb,IAAI,KAAK,EAAA,CAAE,YACQ,CAAC;CAIhC,MAAM,SADY,OAAO,EAAE,GACJ,IAAI,MAAM,IAAI,SAAS;CAE9C,OAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,EAAE;EACpC;CACF;AACF;AAEA,MAAM,WAAW,CAAC,GAAG,cAAc;;AAGnC,MAAM,iBAAyB;CAC7B,MAAM,OAAO,UAAU,MAAM,IAAI;CACjC,MAAM,QAAQ,OAAO,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CACtD,MAAM,MAAM,OAAO,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CACpD,MAAM,KACJ,SAAS,UAAU,GAAG,SAAS,SAAS,CAAC,MAAM;CACjD,MAAM,SAAS,OAAO,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;CAExD,MAAM,YADS,KAAK,OAAO,IAAI,KAE3B,OAAO,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,IAC9B,OAAO,UAAU,GAAG,CAAC,IAAI,CAAC;CAE9B,OACE,GAAG,OAAO,OAAO,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,IAClC,QAAQ,MAAM,KAAK,SAAS;AAEnC;;AAGA,MAAM,OAA+C;CACnD,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EAAC;EAAQ;EAAS;CAAgB;CAC3C,kBAAkB;CAClB,OAAO;CACP,SAAS;CACT,YAAY;CACZ,aACE;CACF,WACE;CACF,SAAS,CAAC,EAAE;CACZ,UAAU,CAAC,gBAAgB,cAAc;CACzC;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"nric.js","names":[],"sources":["../../src/generated/my/nric.ts"],"sourcesContent":["// Generated by scripts/generate-public-surface.ts. Do not edit.\nimport { createValidator } from \"../../runtime\";\nimport type {\n  CountryValidator,\n  ParsedPersonId,\n} from \"../../types\";\n\nconst nric: CountryValidator<\"MY\", ParsedPersonId> =\n  createValidator(\"my.nric\", 130);\n\nexport default nric;\nexport const compact = nric.compact;\nexport const format = nric.format;\nexport const validate = nric.validate;\nexport const generate = (): string =>\n  nric.generate?.() ??\n  (() => {\n    throw new Error(\n      \"Validator my.nric cannot generate values\",\n    );\n  })();\nexport const parse = nric.parse;\n"],"mappings":";;AAOA,MAAM,OACJ,gBAAgB,WAAW,GAAG;AAGhC,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;AACL,MAAa,QAAQ,KAAK"}

package/dist/native-node.d.ts

@@ -0,0 +1,14 @@
+import { NativeParsedIdentifier, NativeStdnumBinding, NativeValidateResult, NativeValidationError, ValidatorMetadata, asNativeBinding } from "./native.js";
+//#region src/native-node.d.ts
+type NativeLibc = "gnu" | "musl";
+type LoadNativeBindingOptions = {
+  platform?: string;
+  arch?: string;
+  libc?: NativeLibc;
+  env?: Record<string, string | undefined>;
+  requireModule?: (specifier: string) => unknown;
+};
+declare const loadNativeStdnumBinding: (options?: LoadNativeBindingOptions) => NativeStdnumBinding;
+//#endregion
+export { LoadNativeBindingOptions, NativeLibc, NativeParsedIdentifier, NativeStdnumBinding, NativeValidateResult, NativeValidationError, ValidatorMetadata, asNativeBinding, loadNativeStdnumBinding };
+//# sourceMappingURL=native-node.d.ts.map

package/dist/native-node.js

@@ -0,0 +1,75 @@
+import { asNativeBinding } from "./native.js";
+import { createRequire } from "node:module";
+import process from "node:process";
+//#region src/native-node.ts
+const targets = [
+	[
+		"darwin",
+		"arm64",
+		void 0,
+		"@stll/stdnum-darwin-arm64"
+	],
+	[
+		"darwin",
+		"x64",
+		void 0,
+		"@stll/stdnum-darwin-x64"
+	],
+	[
+		"linux",
+		"arm64",
+		"gnu",
+		"@stll/stdnum-linux-arm64-gnu"
+	],
+	[
+		"linux",
+		"x64",
+		"gnu",
+		"@stll/stdnum-linux-x64-gnu"
+	],
+	[
+		"win32",
+		"x64",
+		void 0,
+		"@stll/stdnum-win32-x64-msvc"
+	]
+];
+const loadNativeStdnumBinding = (options = {}) => {
+	const platform = options.platform ?? process.platform;
+	const arch = options.arch ?? process.arch;
+	const libc = options.libc ?? detectLibc(platform);
+	const requireModule = options.requireModule ?? createRequire(import.meta.url);
+	const match = targets.find(([targetPlatform, targetArch, targetLibc]) => targetPlatform === platform && targetArch === arch && (targetLibc === void 0 || targetLibc === libc));
+	const candidates = [
+		options.env?.["STELLA_STDNUM_NATIVE_LIBRARY_PATH"] ?? process.env["STELLA_STDNUM_NATIVE_LIBRARY_PATH"],
+		"../index.cjs",
+		match?.[3]
+	].filter((value) => value !== void 0);
+	const errors = [];
+	for (const specifier of candidates) try {
+		const binding = asNativeBinding(requireModule(specifier));
+		if (binding !== null) return binding;
+		errors.push(`${specifier}: module does not match the stdnum binding contract`);
+	} catch (error) {
+		errors.push(`${specifier}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	const supported = targets.map(([p, a, l]) => [
+		p,
+		a,
+		l
+	].filter(Boolean).join("-")).join(", ");
+	throw new Error(`Unable to load native stdnum binding for ${[
+		platform,
+		arch,
+		libc
+	].filter(Boolean).join("-")}; supported targets: ${supported}.\n${errors.join("\n")}`);
+};
+const detectLibc = (platform) => {
+	if (platform !== "linux") return void 0;
+	const { header } = process.report.getReport();
+	return typeof header.glibcVersionRuntime === "string" ? "gnu" : "musl";
+};
+//#endregion
+export { asNativeBinding, loadNativeStdnumBinding };
+
+//# sourceMappingURL=native-node.js.map

package/dist/native-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-node.js","names":[],"sources":["../src/native-node.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport process from \"node:process\";\n\nimport {\n  asNativeBinding,\n  type NativeStdnumBinding,\n} from \"./native\";\n\nexport type NativeLibc = \"gnu\" | \"musl\";\nexport type LoadNativeBindingOptions = {\n  platform?: string;\n  arch?: string;\n  libc?: NativeLibc;\n  env?: Record<string, string | undefined>;\n  requireModule?: (specifier: string) => unknown;\n};\n\nconst targets = [\n  [\n    \"darwin\",\n    \"arm64\",\n    undefined,\n    \"@stll/stdnum-darwin-arm64\",\n  ],\n  [\"darwin\", \"x64\", undefined, \"@stll/stdnum-darwin-x64\"],\n  [\"linux\", \"arm64\", \"gnu\", \"@stll/stdnum-linux-arm64-gnu\"],\n  [\"linux\", \"x64\", \"gnu\", \"@stll/stdnum-linux-x64-gnu\"],\n  [\n    \"win32\",\n    \"x64\",\n    undefined,\n    \"@stll/stdnum-win32-x64-msvc\",\n  ],\n] as const;\n\nexport const loadNativeStdnumBinding = (\n  options: LoadNativeBindingOptions = {},\n): NativeStdnumBinding => {\n  const platform = options.platform ?? process.platform;\n  const arch = options.arch ?? process.arch;\n  const libc = options.libc ?? detectLibc(platform);\n  const requireModule =\n    options.requireModule ?? createRequire(import.meta.url);\n  const match = targets.find(\n    ([targetPlatform, targetArch, targetLibc]) =>\n      targetPlatform === platform &&\n      targetArch === arch &&\n      (targetLibc === undefined || targetLibc === libc),\n  );\n  const candidates = [\n    options.env?.[\"STELLA_STDNUM_NATIVE_LIBRARY_PATH\"] ??\n      process.env[\"STELLA_STDNUM_NATIVE_LIBRARY_PATH\"],\n    \"../index.cjs\",\n    match?.[3],\n  ].filter((value): value is string => value !== undefined);\n  const errors: string[] = [];\n  for (const specifier of candidates) {\n    try {\n      const binding = asNativeBinding(\n        requireModule(specifier),\n      );\n      if (binding !== null) return binding;\n      errors.push(\n        `${specifier}: module does not match the stdnum binding contract`,\n      );\n    } catch (error) {\n      errors.push(\n        `${specifier}: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n  const supported = targets\n    .map(([p, a, l]) => [p, a, l].filter(Boolean).join(\"-\"))\n    .join(\", \");\n  throw new Error(\n    `Unable to load native stdnum binding for ${[platform, arch, libc].filter(Boolean).join(\"-\")}; ` +\n      `supported targets: ${supported}.\\n${errors.join(\"\\n\")}`,\n  );\n};\n\nconst detectLibc = (\n  platform: string,\n): NativeLibc | undefined => {\n  if (platform !== \"linux\") return undefined;\n  const { header } = process.report.getReport() as {\n    header: { glibcVersionRuntime?: unknown };\n  };\n  return typeof header.glibcVersionRuntime === \"string\"\n    ? \"gnu\"\n    : \"musl\";\n};\n\nexport * from \"./native\";\n"],"mappings":";;;;AAiBA,MAAM,UAAU;CACd;EACE;EACA;EACA,KAAA;EACA;CACF;CACA;EAAC;EAAU;EAAO,KAAA;EAAW;CAAyB;CACtD;EAAC;EAAS;EAAS;EAAO;CAA8B;CACxD;EAAC;EAAS;EAAO;EAAO;CAA4B;CACpD;EACE;EACA;EACA,KAAA;EACA;CACF;AACF;AAEA,MAAa,2BACX,UAAoC,CAAC,MACb;CACxB,MAAM,WAAW,QAAQ,YAAY,QAAQ;CAC7C,MAAM,OAAO,QAAQ,QAAQ,QAAQ;CACrC,MAAM,OAAO,QAAQ,QAAQ,WAAW,QAAQ;CAChD,MAAM,gBACJ,QAAQ,iBAAiB,cAAc,OAAO,KAAK,GAAG;CACxD,MAAM,QAAQ,QAAQ,MACnB,CAAC,gBAAgB,YAAY,gBAC5B,mBAAmB,YACnB,eAAe,SACd,eAAe,KAAA,KAAa,eAAe,KAChD;CACA,MAAM,aAAa;EACjB,QAAQ,MAAM,wCACZ,QAAQ,IAAI;EACd;EACA,QAAQ;CACV,CAAC,CAAC,QAAQ,UAA2B,UAAU,KAAA,CAAS;CACxD,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,aAAa,YACtB,IAAI;EACF,MAAM,UAAU,gBACd,cAAc,SAAS,CACzB;EACA,IAAI,YAAY,MAAM,OAAO;EAC7B,OAAO,KACL,GAAG,UAAU,oDACf;CACF,SAAS,OAAO;EACd,OAAO,KACL,GAAG,UAAU,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACxE;CACF;CAEF,MAAM,YAAY,QACf,KAAK,CAAC,GAAG,GAAG,OAAO;EAAC;EAAG;EAAG;CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CACvD,KAAK,IAAI;CACZ,MAAM,IAAI,MACR,4CAA4C;EAAC;EAAU;EAAM;CAAI,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,EAAE,uBACrE,UAAU,KAAK,OAAO,KAAK,IAAI,GACzD;AACF;AAEA,MAAM,cACJ,aAC2B;CAC3B,IAAI,aAAa,SAAS,OAAO,KAAA;CACjC,MAAM,EAAE,WAAW,QAAQ,OAAO,UAAU;CAG5C,OAAO,OAAO,OAAO,wBAAwB,WACzC,QACA;AACN"}