@stll/stdnum 0.0.1

package/dist/cr/cpf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpf.js","names":[],"sources":["../../src/cr/cpf.ts"],"sourcesContent":["/** Generate a random valid Costa Rican CPF. */\nconst generate = (): string => {\n  const province = String(randomInt(1, 9));\n  const volume = randomDigits(4);\n  const entry = randomDigits(4);\n  return `0${province}${volume}${entry}`;\n};\n\n/**\n * CPF (Cédula de Persona Física, Costa Rican\n * physical person ID number).\n *\n * 10 digits: 0P-TTTT-AAAA where:\n *   - 0 = fixed leading zero\n *   - P = province digit\n *   - TTTT = volume (tomo), zero-padded\n *   - AAAA = entry (asiento), zero-padded\n *\n * No check digit; validation is by format only.\n *\n * Ported from python-stdnum cr.cpf module.\n *\n * @see https://www.tse.go.cr/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\n/**\n * Compact: strip spaces, pad hyphen-separated parts\n * (2-4-4), join, and prepend '0' if 9 digits.\n */\nconst compact = (value: string): string => {\n  let number = clean(value, \" \").trim().toUpperCase();\n\n  const parts = number.split(\"-\");\n  if (parts.length === 3) {\n    const p0 = parts[0]!.padStart(2, \"0\");\n    const p1 = parts[1]!.padStart(4, \"0\");\n    const p2 = parts[2]!.padStart(4, \"0\");\n    number = p0 + p1 + p2;\n  } else {\n    number = number.replaceAll(\"-\", \"\");\n  }\n\n  if (number.length === 9) {\n    number = \"0\" + number;\n  }\n\n  return number;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Costa Rican CPF must be 10 digits\",\n    );\n  }\n\n  if (!/^\\d{10}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Costa Rican CPF must contain only digits\",\n    );\n  }\n\n  if (v[0] !== \"0\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Costa Rican CPF must start with 0\",\n    );\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, 2)}-${v.slice(2, 6)}-${v.slice(6, 10)}`;\n};\n\n/**\n * Costa Rican physical person ID number (CPF).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst cpf: Validator = {\n  name: \"Costa Rican Physical Person ID\",\n  localName: \"Cédula de Persona Física\",\n  abbreviation: \"CPF\",\n  aliases: [\"CPF\", \"cédula de persona física\"] as const,\n  candidatePattern: \"\\\\d{9,12}\",\n  country: \"CR\",\n  entityType: \"person\",\n  lengths: [10] as const,\n  examples: [\"0304550175\", \"0109130259\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.tse.go.cr/\",\n  generate,\n};\n\nexport default cpf;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AACA,MAAM,iBAAyB;AAI7B,QAAO,IAHU,OAAO,UAAU,GAAG,EAAE,CAAC,GACzB,aAAa,EAAE,GAChB,aAAa,EAAE;;;;;;AA+B/B,MAAM,WAAW,UAA0B;CACzC,IAAI,SAAS,MAAM,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa;CAEnD,MAAM,QAAQ,OAAO,MAAM,IAAI;AAC/B,KAAI,MAAM,WAAW,GAAG;EACtB,MAAM,KAAK,MAAM,GAAI,SAAS,GAAG,IAAI;EACrC,MAAM,KAAK,MAAM,GAAI,SAAS,GAAG,IAAI;EACrC,MAAM,KAAK,MAAM,GAAI,SAAS,GAAG,IAAI;AACrC,WAAS,KAAK,KAAK;OAEnB,UAAS,OAAO,WAAW,KAAK,GAAG;AAGrC,KAAI,OAAO,WAAW,EACpB,UAAS,MAAM;AAGjB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,oCACD;AAGH,KAAI,CAAC,WAAW,KAAK,EAAE,CACrB,QAAO,IACL,kBACA,2CACD;AAGH,KAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,oCACD;AAGH,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,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;;;;;;;AAQ5D,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,2BAA2B;CAC5C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,cAAc,aAAa;CACtC;CACA;CACA;CACA,WAAW;CACX;CACD"}

package/dist/cr/mod.d.ts

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

package/dist/cr/mod.js

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

package/dist/cr/mod.js.map

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

package/dist/creditcard.d.ts

@@ -0,0 +1,25 @@
+import { ValidateResult, Validator } from "./types.js";
+
+//#region src/creditcard.d.ts
+
+/**
+ * Card network identifiers returned by
+ * {@link detectNetwork}.
+ */
+type CardNetwork = "visa" | "mastercard" | "amex" | "discover" | "diners" | "jcb" | "unionpay" | "maestro";
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/**
+ * Detect the card network from the BIN/IIN prefix.
+ *
+ * Accepts both formatted ("4111 1111 1111 1111")
+ * and compact ("4111111111111111") inputs.
+ * Returns null for unrecognized prefixes.
+ */
+declare const detectNetwork: (value: string) => CardNetwork | null;
+/** Credit Card Number (Luhn). */
+declare const creditCard: Validator;
+//#endregion
+export { type CardNetwork, compact, creditCard as default, detectNetwork, format, validate };
+//# sourceMappingURL=creditcard.d.ts.map

package/dist/creditcard.js

@@ -0,0 +1,121 @@
+import { clean } from "./_util/clean.js";
+import { randomDigits, randomInt } from "./_util/generate.js";
+import { err } from "./_util/result.js";
+import { luhnChecksum, luhnValidate } from "./_checksums/luhn.js";
+import { isdigits } from "./_util/strings.js";
+//#region src/creditcard.ts
+/**
+* Credit card number validation (Luhn algorithm).
+*
+* Validates card numbers using the Luhn checksum
+* (ISO/IEC 7812-1). Supports Visa, Mastercard,
+* Amex, Discover, and other networks (13-19
+* digits).
+*
+* @see https://www.iso.org/standard/70484.html
+*/
+const compact = (value) => clean(value, " -.");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length < 13 || v.length > 19) return err("INVALID_LENGTH", "Credit card number must be 13-19 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "Credit card number must contain only digits");
+	if (!luhnValidate(v)) return err("INVALID_CHECKSUM", "Credit card number fails Luhn check");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	if (v.length === 15 && v[0] === "3") return `${v.slice(0, 4)} ${v.slice(4, 10)} ${v.slice(10)}`;
+	const groups = [];
+	for (let i = 0; i < v.length; i += 4) groups.push(v.slice(i, i + 4));
+	return groups.join(" ");
+};
+const MAESTRO_PREFIXES = [
+	5018,
+	5020,
+	5038,
+	5893,
+	6304,
+	6759,
+	6761,
+	6762,
+	6763
+];
+/**
+* Detect the card network from the BIN/IIN prefix.
+*
+* Accepts both formatted ("4111 1111 1111 1111")
+* and compact ("4111111111111111") inputs.
+* Returns null for unrecognized prefixes.
+*/
+const detectNetwork = (value) => {
+	const v = compact(value);
+	if (v.length === 0) return null;
+	if (!isdigits(v)) return null;
+	const d2 = Number(v.slice(0, 2));
+	const d3 = Number(v.slice(0, 3));
+	const d4 = Number(v.slice(0, 4));
+	const d6 = Number(v.slice(0, 6));
+	if (d2 === 34 || d2 === 37) return "amex";
+	if (d2 === 36 || d2 === 38) return "diners";
+	if (d3 >= 300 && d3 <= 305) return "diners";
+	if (d4 >= 3528 && d4 <= 3589) return "jcb";
+	if (v[0] === "4") return "visa";
+	if (MAESTRO_PREFIXES.includes(d4)) return "maestro";
+	if (d2 >= 51 && d2 <= 55) return "mastercard";
+	if (d4 >= 2221 && d4 <= 2720) return "mastercard";
+	if (d4 === 6011) return "discover";
+	if (d6 >= 622126 && d6 <= 622925) return "discover";
+	if (d3 >= 644 && d3 <= 649) return "discover";
+	if (d2 === 65) return "discover";
+	if (d2 === 62) return "unionpay";
+	return null;
+};
+/**
+* Visa/Mastercard IIN prefixes. Each entry is
+* [prefix, totalLength].
+*/
+const CARD_PREFIXES = [
+	["4", 16],
+	["51", 16],
+	["52", 16],
+	["53", 16],
+	["54", 16],
+	["55", 16]
+];
+/**
+* Generate a random valid Visa or Mastercard
+* number (16 digits, Luhn-valid).
+*/
+const generate = () => {
+	const [prefix, length] = CARD_PREFIXES[randomInt(0, CARD_PREFIXES.length - 1)];
+	const payload = `${prefix}${randomDigits(length - prefix.length - 1)}`;
+	const check = (10 - luhnChecksum(`${payload}0`)) % 10;
+	return `${payload}${String(check)}`;
+};
+/** Credit Card Number (Luhn). */
+const creditCard = {
+	name: "Credit Card Number",
+	localName: "Credit Card Number",
+	abbreviation: "CC",
+	aliases: [
+		"credit card",
+		"card number",
+		"kreditní karta",
+		"Kreditkarte"
+	],
+	candidatePattern: "(?:\\d[\\s-]?){13,19}",
+	entityType: "any",
+	sourceUrl: "https://www.iso.org/standard/70484.html",
+	examples: ["4111111111111111", "5500000000000004"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, creditCard as default, detectNetwork, format, validate };
+
+//# sourceMappingURL=creditcard.js.map

package/dist/creditcard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creditcard.js","names":[],"sources":["../src/creditcard.ts"],"sourcesContent":["/**\n * Credit card number validation (Luhn algorithm).\n *\n * Validates card numbers using the Luhn checksum\n * (ISO/IEC 7812-1). Supports Visa, Mastercard,\n * Amex, Discover, and other networks (13-19\n * digits).\n *\n * @see https://www.iso.org/standard/70484.html\n */\n\nimport {\n  luhnChecksum,\n  luhnValidate,\n} from \"#checksums/luhn\";\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\n/**\n * Card network identifiers returned by\n * {@link detectNetwork}.\n */\ntype CardNetwork =\n  | \"visa\"\n  | \"mastercard\"\n  | \"amex\"\n  | \"discover\"\n  | \"diners\"\n  | \"jcb\"\n  | \"unionpay\"\n  | \"maestro\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 13 || v.length > 19) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Credit card number must be 13-19 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Credit card number must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Credit card number fails Luhn check\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value);\n  // Amex: 4-6-5 grouping\n  if (v.length === 15 && v[0] === \"3\") {\n    return `${v.slice(0, 4)} ${v.slice(4, 10)} ${v.slice(10)}`;\n  }\n  // Standard: groups of 4\n  const groups: string[] = [];\n  for (let i = 0; i < v.length; i += 4) {\n    groups.push(v.slice(i, i + 4));\n  }\n  return groups.join(\" \");\n};\n\nconst MAESTRO_PREFIXES: readonly number[] = [\n  5018, 5020, 5038, 5893, 6304, 6759, 6761, 6762, 6763,\n];\n\n/**\n * Detect the card network from the BIN/IIN prefix.\n *\n * Accepts both formatted (\"4111 1111 1111 1111\")\n * and compact (\"4111111111111111\") inputs.\n * Returns null for unrecognized prefixes.\n */\nconst detectNetwork = (\n  value: string,\n): CardNetwork | null => {\n  const v = compact(value);\n  if (v.length === 0) return null;\n  if (!isdigits(v)) return null;\n\n  const d2 = Number(v.slice(0, 2));\n  const d3 = Number(v.slice(0, 3));\n  const d4 = Number(v.slice(0, 4));\n  const d6 = Number(v.slice(0, 6));\n\n  // Amex: 34, 37\n  if (d2 === 34 || d2 === 37) return \"amex\";\n\n  // Diners Club: 300-305, 36, 38\n  if (d2 === 36 || d2 === 38) return \"diners\";\n  if (d3 >= 300 && d3 <= 305) return \"diners\";\n\n  // JCB: 3528-3589\n  if (d4 >= 3528 && d4 <= 3589) return \"jcb\";\n\n  // Visa: starts with 4\n  if (v[0] === \"4\") return \"visa\";\n\n  // Maestro (check before Mastercard; some share\n  // the 50xx prefix space)\n  if (MAESTRO_PREFIXES.includes(d4)) return \"maestro\";\n\n  // Mastercard: 51-55 or 2221-2720\n  if (d2 >= 51 && d2 <= 55) return \"mastercard\";\n  if (d4 >= 2221 && d4 <= 2720) return \"mastercard\";\n\n  // Discover: 6011, 622126-622925, 644-649, 65\n  if (d4 === 6011) return \"discover\";\n  if (d6 >= 622126 && d6 <= 622925) return \"discover\";\n  if (d3 >= 644 && d3 <= 649) return \"discover\";\n  if (d2 === 65) return \"discover\";\n\n  // UnionPay: starts with 62 (excluding Discover\n  // ranges already matched above)\n  if (d2 === 62) return \"unionpay\";\n\n  return null;\n};\n\n/**\n * Visa/Mastercard IIN prefixes. Each entry is\n * [prefix, totalLength].\n */\nconst CARD_PREFIXES = [\n  [\"4\", 16], // Visa\n  [\"51\", 16], // Mastercard\n  [\"52\", 16], // Mastercard\n  [\"53\", 16], // Mastercard\n  [\"54\", 16], // Mastercard\n  [\"55\", 16], // Mastercard\n] as const;\n\n/**\n * Generate a random valid Visa or Mastercard\n * number (16 digits, Luhn-valid).\n */\nconst generate = (): string => {\n  const idx = randomInt(0, CARD_PREFIXES.length - 1);\n  const [prefix, length] = CARD_PREFIXES[\n    idx\n  ] as (typeof CARD_PREFIXES)[number];\n  const remaining = length - prefix.length - 1;\n  const payload = `${prefix}${randomDigits(remaining)}`;\n  const partial = `${payload}0`;\n  const remainder = luhnChecksum(partial);\n  const check = (10 - remainder) % 10;\n  return `${payload}${String(check)}`;\n};\n\n/** Credit Card Number (Luhn). */\nconst creditCard: Validator = {\n  name: \"Credit Card Number\",\n  localName: \"Credit Card Number\",\n  abbreviation: \"CC\",\n  aliases: [\n    \"credit card\",\n    \"card number\",\n    \"kreditní karta\",\n    \"Kreditkarte\",\n  ] as const,\n  candidatePattern: \"(?:\\\\d[\\\\s-]?){13,19}\",\n  entityType: \"any\",\n  sourceUrl: \"https://www.iso.org/standard/70484.html\",\n  examples: [\n    \"4111111111111111\",\n    \"5500000000000004\",\n  ] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default creditCard;\nexport { compact, detectNetwork, format, validate };\nexport type { CardNetwork };\n"],"mappings":";;;;;;;;;;;;;;;;AAoCA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,MAAM,EAAE,SAAS,GAC9B,QAAO,IACL,kBACA,0CACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,sCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,MAAM,EAAE,OAAO,IAC9B,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;CAG1D,MAAM,SAAmB,EAAE;AAC3B,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,EACjC,QAAO,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;AAEhC,QAAO,OAAO,KAAK,IAAI;;AAGzB,MAAM,mBAAsC;CAC1C;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CACjD;;;;;;;;AASD,MAAM,iBACJ,UACuB;CACvB,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EAAG,QAAO;AAC3B,KAAI,CAAC,SAAS,EAAE,CAAE,QAAO;CAEzB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAGhC,KAAI,OAAO,MAAM,OAAO,GAAI,QAAO;AAGnC,KAAI,OAAO,MAAM,OAAO,GAAI,QAAO;AACnC,KAAI,MAAM,OAAO,MAAM,IAAK,QAAO;AAGnC,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AAGrC,KAAI,EAAE,OAAO,IAAK,QAAO;AAIzB,KAAI,iBAAiB,SAAS,GAAG,CAAE,QAAO;AAG1C,KAAI,MAAM,MAAM,MAAM,GAAI,QAAO;AACjC,KAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AAGrC,KAAI,OAAO,KAAM,QAAO;AACxB,KAAI,MAAM,UAAU,MAAM,OAAQ,QAAO;AACzC,KAAI,MAAM,OAAO,MAAM,IAAK,QAAO;AACnC,KAAI,OAAO,GAAI,QAAO;AAItB,KAAI,OAAO,GAAI,QAAO;AAEtB,QAAO;;;;;;AAOT,MAAM,gBAAgB;CACpB,CAAC,KAAK,GAAG;CACT,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACV,CAAC,MAAM,GAAG;CACX;;;;;AAMD,MAAM,iBAAyB;CAE7B,MAAM,CAAC,QAAQ,UAAU,cADb,UAAU,GAAG,cAAc,SAAS,EAAE;CAKlD,MAAM,UAAU,GAAG,SAAS,aADV,SAAS,OAAO,SAAS,EACQ;CAGnD,MAAM,SAAS,KADG,aADF,GAAG,QAAQ,GACY,IACN;AACjC,QAAO,GAAG,UAAU,OAAO,MAAM;;;AAInC,MAAM,aAAwB;CAC5B,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACA;EACD;CACD,kBAAkB;CAClB,YAAY;CACZ,WAAW;CACX,UAAU,CACR,oBACA,mBACD;CACD;CACA;CACA;CACA;CACD"}

package/dist/cu/mod.d.ts

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

package/dist/cu/mod.js

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

package/dist/cu/mod.js.map

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

package/dist/cu/ni.d.ts

@@ -0,0 +1,21 @@
+import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+
+//#region src/cu/ni.d.ts
+
+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 Cuban NI.
+ * Returns null if the value is not valid.
+ */
+declare const parse: (value: string) => ParsedPersonId | null;
+/**
+ * Cuban identity card number (NI).
+ *
+ * Examples sourced from python-stdnum test suite.
+ */
+declare const ni: Validator;
+//#endregion
+export { compact, ni as default, format, parse, validate };
+//# sourceMappingURL=ni.d.ts.map

package/dist/cu/ni.js

@@ -0,0 +1,90 @@
+import { clean } from "../_util/clean.js";
+import { err } from "../_util/result.js";
+import { isValidDate } from "../_util/date.js";
+//#region src/cu/ni.ts
+/**
+* NI (Número de Identidad, Cuban identity card number).
+*
+* 11 digits encoding birth date, century, sequence, and
+* gender. Structure: YYMMDDXNNNN where:
+*   - YYMMDD = birth date
+*   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)
+*   - NNNN = sequence (digit at position 9 encodes gender:
+*     even=male, odd=female)
+*
+* No check digit; validation is by date and format only.
+*
+* Ported from python-stdnum cu.ni module.
+*
+* @see https://www.ecured.cu/Carnet_de_Identidad
+*/
+const compact = (value) => clean(value, " -").trim();
+/**
+* Derive the full birth year from the two-digit year
+* and the century indicator at position 6.
+*/
+const centuryOffset = (digit) => {
+	if (digit === "9") return 1800;
+	if (digit >= "0" && digit <= "5") return 1900;
+	return 2e3;
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 11) return err("INVALID_LENGTH", "Cuban NI must be 11 digits");
+	if (!/^\d{11}$/.test(v)) return err("INVALID_FORMAT", "Cuban NI 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(centuryOffset(v[6]) + yy, mm, dd)) return err("INVALID_COMPONENT", "Cuban NI contains an invalid birth date");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => compact(value);
+/**
+* Extract birth date and gender from a Cuban NI.
+* 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 = centuryOffset(v[6]) + yy;
+	const gender = Number(v[9]) % 2 === 0 ? "male" : "female";
+	return {
+		birthDate: new Date(year, mm - 1, dd),
+		gender
+	};
+};
+/**
+* Cuban identity card number (NI).
+*
+* Examples sourced from python-stdnum test suite.
+*/
+const ni = {
+	name: "Cuban Identity Card Number",
+	localName: "Número de Identidad",
+	abbreviation: "NI",
+	aliases: [
+		"NI",
+		"número de identidad",
+		"carnet de identidad"
+	],
+	candidatePattern: "\\d{11}",
+	country: "CU",
+	entityType: "person",
+	lengths: [11],
+	examples: ["91021027775", "72062506561"],
+	compact,
+	format,
+	validate,
+	sourceUrl: "https://www.ecured.cu/Carnet_de_Identidad"
+};
+//#endregion
+export { compact, ni as default, format, parse, validate };
+
+//# sourceMappingURL=ni.js.map

package/dist/cu/ni.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ni.js","names":[],"sources":["../../src/cu/ni.ts"],"sourcesContent":["/**\n * NI (Número de Identidad, Cuban identity card number).\n *\n * 11 digits encoding birth date, century, sequence, and\n * gender. Structure: YYMMDDXNNNN where:\n *   - YYMMDD = birth date\n *   - X = century digit (9=1800s, 0-5=1900s, 6-8=2000s)\n *   - NNNN = sequence (digit at position 9 encodes gender:\n *     even=male, odd=female)\n *\n * No check digit; validation is by date and format only.\n *\n * Ported from python-stdnum cu.ni module.\n *\n * @see https://www.ecured.cu/Carnet_de_Identidad\n */\n\nimport { clean } from \"#util/clean\";\nimport { isValidDate } from \"#util/date\";\nimport { err } from \"#util/result\";\n\nimport type {\n  ParsedPersonId,\n  ValidateResult,\n  Validator,\n} from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\").trim();\n\n/**\n * Derive the full birth year from the two-digit year\n * and the century indicator at position 6.\n */\nconst centuryOffset = (digit: string): number => {\n  if (digit === \"9\") return 1800;\n  if (digit >= \"0\" && digit <= \"5\") return 1900;\n  return 2000;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n\n  if (v.length !== 11) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cuban NI must be 11 digits\",\n    );\n  }\n\n  if (!/^\\d{11}$/.test(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cuban NI must contain only digits\",\n    );\n  }\n\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 year = centuryOffset(v[6]!) + yy;\n\n  if (!isValidDate(year, mm, dd)) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cuban NI contains an invalid birth date\",\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 Cuban NI.\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 year = centuryOffset(v[6]!) + yy;\n\n  const genderDigit = Number(v[9]);\n  const gender: \"male\" | \"female\" =\n    genderDigit % 2 === 0 ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, dd),\n    gender,\n  };\n};\n\n/**\n * Cuban identity card number (NI).\n *\n * Examples sourced from python-stdnum test suite.\n */\nconst ni: Validator = {\n  name: \"Cuban Identity Card Number\",\n  localName: \"Número de Identidad\",\n  abbreviation: \"NI\",\n  aliases: [\n    \"NI\",\n    \"número de identidad\",\n    \"carnet de identidad\",\n  ] as const,\n  candidatePattern: \"\\\\d{11}\",\n  country: \"CU\",\n  entityType: \"person\",\n  lengths: [11] as const,\n  examples: [\"91021027775\", \"72062506561\"] as const,\n  compact,\n  format,\n  validate,\n  sourceUrl: \"https://www.ecured.cu/Carnet_de_Identidad\",\n};\n\nexport default ni;\nexport { compact, format, parse, validate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK,CAAC,MAAM;;;;;AAM3B,MAAM,iBAAiB,UAA0B;AAC/C,KAAI,UAAU,IAAK,QAAO;AAC1B,KAAI,SAAS,OAAO,SAAS,IAAK,QAAO;AACzC,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AAExB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,6BACD;AAGH,KAAI,CAAC,WAAW,KAAK,EAAE,CACrB,QAAO,IACL,kBACA,oCACD;CAGH,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;AAGhC,KAAI,CAAC,YAFQ,cAAc,EAAE,GAAI,GAAG,IAEb,IAAI,GAAG,CAC5B,QAAO,IACL,qBACA,0CACD;AAGH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B,QAAQ,MAAM;;;;;AAMxD,MAAM,SAAS,UAAyC;CACtD,MAAM,SAAS,SAAS,MAAM;AAC9B,KAAI,CAAC,OAAO,MAAO,QAAO;CAE1B,MAAM,IAAI,OAAO;CACjB,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,KAAK,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC;CAChC,MAAM,OAAO,cAAc,EAAE,GAAI,GAAG;CAGpC,MAAM,SADc,OAAO,EAAE,GAAG,GAEhB,MAAM,IAAI,SAAS;AAEnC,QAAO;EACL,WAAW,IAAI,KAAK,MAAM,KAAK,GAAG,GAAG;EACrC;EACD;;;;;;;AAQH,MAAM,KAAgB;CACpB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,SAAS,CAAC,GAAG;CACb,UAAU,CAAC,eAAe,cAAc;CACxC;CACA;CACA;CACA,WAAW;CACZ"}

package/dist/cy/mod.d.ts

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

package/dist/cy/mod.js

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

package/dist/cy/mod.js.map

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

package/dist/cy/vat.d.ts

@@ -0,0 +1,14 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/cy/vat.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Generate a random valid Cypriot VAT number. */
+declare const generate: () => string;
+/** Cypriot VAT Number. */
+declare const vat: Validator;
+//#endregion
+export { compact, vat as default, format, generate, validate };
+//# sourceMappingURL=vat.d.ts.map

package/dist/cy/vat.js

@@ -0,0 +1,88 @@
+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/cy/vat.ts
+/**
+* ΦΠΑ (Cypriot VAT number).
+*
+* 8 digits + 1 check letter. Cannot start with "12".
+*
+* @see https://www.vatify.eu/cyprus-vat-number.html
+* @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf
+*/
+const ODD_MAP = {
+	0: 1,
+	1: 0,
+	2: 5,
+	3: 7,
+	4: 9,
+	5: 13,
+	6: 15,
+	7: 17,
+	8: 19,
+	9: 21
+};
+const LETTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+const compact = (value) => {
+	let v = clean(value, " -/.");
+	if (v.startsWith("CY") || v.startsWith("cy")) v = v.slice(2);
+	return v.toUpperCase();
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 9) return err("INVALID_LENGTH", "Cypriot VAT number must be 8 digits + 1 letter");
+	const digits = v.slice(0, 8);
+	const checkLetter = v[8];
+	if (!isdigits(digits)) return err("INVALID_FORMAT", "Cypriot VAT number must start with 8 digits");
+	if (checkLetter === void 0 || !LETTERS.includes(checkLetter)) return err("INVALID_FORMAT", "Cypriot VAT number must end with a letter");
+	if (v.startsWith("12")) return err("INVALID_COMPONENT", "Cypriot VAT number cannot start with 12");
+	let odd = 0;
+	let even = 0;
+	for (let i = 0; i < 8; i++) {
+		const d = Number(digits.charAt(i));
+		if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;
+		else even += d;
+	}
+	if (checkLetter !== LETTERS.charAt((odd + even) % 26)) return err("INVALID_CHECKSUM", "Cypriot VAT number check letter mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => `CY${compact(value)}`;
+/** Generate a random valid Cypriot VAT number. */
+const generate = () => {
+	for (;;) {
+		const digits = randomDigits(8);
+		if (digits.startsWith("12")) continue;
+		let odd = 0;
+		let even = 0;
+		for (let i = 0; i < 8; i++) {
+			const d = Number(digits.charAt(i));
+			if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;
+			else even += d;
+		}
+		return digits + LETTERS.charAt((odd + even) % 26);
+	}
+};
+/** Cypriot VAT Number. */
+const vat = {
+	name: "Cypriot VAT Number",
+	localName: "Αριθμός Εγγραφής Φ.Π.Α.",
+	abbreviation: "ΦΠΑ",
+	aliases: ["ΦΠΑ", "VAT CY"],
+	candidatePattern: "CY\\d{8}[A-Z]",
+	country: "CY",
+	entityType: "company",
+	sourceUrl: "https://www.mof.gov.cy/",
+	examples: ["10259033P"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, vat as default, format, generate, validate };
+
+//# sourceMappingURL=vat.js.map

package/dist/cy/vat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/cy/vat.ts"],"sourcesContent":["/**\n * ΦΠΑ (Cypriot VAT number).\n *\n * 8 digits + 1 check letter. Cannot start with \"12\".\n *\n * @see https://www.vatify.eu/cyprus-vat-number.html\n * @see https://www.oecd.org/content/dam/oecd/en/topics/policy-issue-focus/aeoi/cyprus-tin.pdf\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 ODD_MAP: Record<number, number> = {\n  0: 1,\n  1: 0,\n  2: 5,\n  3: 7,\n  4: 9,\n  5: 13,\n  6: 15,\n  7: 17,\n  8: 19,\n  9: 21,\n};\n\nconst LETTERS = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"CY\") || v.startsWith(\"cy\")) {\n    v = v.slice(2);\n  }\n  return v.toUpperCase();\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Cypriot VAT number must be 8 digits + 1 letter\",\n    );\n  }\n  const digits = v.slice(0, 8);\n  const checkLetter = v[8];\n  if (!isdigits(digits)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must start with 8 digits\",\n    );\n  }\n  if (\n    checkLetter === undefined ||\n    !LETTERS.includes(checkLetter)\n  ) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Cypriot VAT number must end with a letter\",\n    );\n  }\n  if (v.startsWith(\"12\")) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"Cypriot VAT number cannot start with 12\",\n    );\n  }\n  let odd = 0;\n  let even = 0;\n  for (let i = 0; i < 8; i++) {\n    const d = Number(digits.charAt(i));\n    if (i % 2 === 0) {\n      // Odd position (1-indexed: 1,3,5,7)\n      odd += ODD_MAP[d] ?? 0;\n    } else {\n      // Even position (1-indexed: 2,4,6,8)\n      even += d;\n    }\n  }\n  const expected = LETTERS.charAt((odd + even) % 26);\n  if (checkLetter !== expected) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Cypriot VAT number check letter mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `CY${compact(value)}`;\n\n/** Generate a random valid Cypriot VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const digits = randomDigits(8);\n    if (digits.startsWith(\"12\")) continue;\n    let odd = 0;\n    let even = 0;\n    for (let i = 0; i < 8; i++) {\n      const d = Number(digits.charAt(i));\n      if (i % 2 === 0) odd += ODD_MAP[d] ?? 0;\n      else even += d;\n    }\n    return digits + LETTERS.charAt((odd + even) % 26);\n  }\n};\n\n/** Cypriot VAT Number. */\nconst vat: Validator = {\n  name: \"Cypriot VAT Number\",\n  localName: \"Αριθμός Εγγραφής Φ.Π.Α.\",\n  abbreviation: \"ΦΠΑ\",\n  aliases: [\"ΦΠΑ\", \"VAT CY\"] as const,\n  candidatePattern: \"CY\\\\d{8}[A-Z]\",\n  country: \"CY\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.mof.gov.cy/\",\n  examples: [\"10259033P\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,UAAkC;CACtC,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACJ;AAED,MAAM,UAAU;AAEhB,MAAM,WAAW,UAA0B;CACzC,IAAI,IAAI,MAAM,OAAO,OAAO;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,KAAI,EAAE,MAAM,EAAE;AAEhB,QAAO,EAAE,aAAa;;AAGxB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,iDACD;CAEH,MAAM,SAAS,EAAE,MAAM,GAAG,EAAE;CAC5B,MAAM,cAAc,EAAE;AACtB,KAAI,CAAC,SAAS,OAAO,CACnB,QAAO,IACL,kBACA,8CACD;AAEH,KACE,gBAAgB,KAAA,KAChB,CAAC,QAAQ,SAAS,YAAY,CAE9B,QAAO,IACL,kBACA,4CACD;AAEH,KAAI,EAAE,WAAW,KAAK,CACpB,QAAO,IACL,qBACA,0CACD;CAEH,IAAI,MAAM;CACV,IAAI,OAAO;AACX,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,MAAI,IAAI,MAAM,EAEZ,QAAO,QAAQ,MAAM;MAGrB,SAAQ;;AAIZ,KAAI,gBADa,QAAQ,QAAQ,MAAM,QAAQ,GAAG,CAEhD,QAAO,IACL,oBACA,2CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,SAAS,aAAa,EAAE;AAC9B,MAAI,OAAO,WAAW,KAAK,CAAE;EAC7B,IAAI,MAAM;EACV,IAAI,OAAO;AACX,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;GAC1B,MAAM,IAAI,OAAO,OAAO,OAAO,EAAE,CAAC;AAClC,OAAI,IAAI,MAAM,EAAG,QAAO,QAAQ,MAAM;OACjC,SAAQ;;AAEf,SAAO,SAAS,QAAQ,QAAQ,MAAM,QAAQ,GAAG;;;;AAKrD,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,SAAS;CAC1B,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}

package/dist/cz/dic.d.ts

@@ -0,0 +1,14 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/cz/dic.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Generate a random valid 8-digit DIČ. */
+declare const generate: () => string;
+/** Czech VAT Number. */
+declare const dic: Validator;
+//#endregion
+export { compact, dic as default, format, generate, validate };
+//# sourceMappingURL=dic.d.ts.map

package/dist/cz/dic.js

@@ -0,0 +1,97 @@
+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";
+import { weightedSum } from "../_checksums/weighted-sum.js";
+import { validate as validate$1 } from "./rc.js";
+//#region src/cz/dic.ts
+/**
+* DIČ (Daňové identifikační číslo).
+*
+* Czech tax identification number / VAT number.
+* Format: "CZ" prefix + 8, 9, or 10 digits.
+* - 8 digits: company (same checksum as IČO,
+*   but first digit cannot be 9)
+* - 9 digits starting with 6: special entity
+* - 9-10 digits: individual (birth number)
+*
+* @see https://adisspr.mfcr.cz/dpr/DphReg
+*/
+const ICO_WEIGHTS = [
+	8,
+	7,
+	6,
+	5,
+	4,
+	3,
+	2
+];
+const compact = (value) => {
+	const v = clean(value, " -");
+	if (v.startsWith("CZ") || v.startsWith("cz")) return v.slice(2);
+	return v;
+};
+const checkLegal = (value) => {
+	const v11 = (11 - weightedSum(value.slice(0, 7), ICO_WEIGHTS, 11)) % 11;
+	return (v11 === 0 ? 1 : v11 % 10) === Number(value[7]);
+};
+const checkSpecial = (value) => {
+	return ((8 - ((10 - weightedSum(value.slice(1, 8), [
+		8,
+		7,
+		6,
+		5,
+		4,
+		3,
+		2
+	], 11)) % 11 + 11) % 11) % 10 + 10) % 10 === Number(value[8]);
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length < 8 || v.length > 10) return err("INVALID_LENGTH", "DIČ must be 8-10 digits (without CZ prefix)");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "DIČ must contain only digits");
+	if (v.length === 8) {
+		if (v[0] === "9") return err("INVALID_COMPONENT", "8-digit DIČ cannot start with 9");
+		if (!checkLegal(v)) return err("INVALID_CHECKSUM", "DIČ check digit does not match");
+		return {
+			valid: true,
+			compact: v
+		};
+	}
+	if (v.length === 9 && v[0] === "6") {
+		if (!checkSpecial(v)) return err("INVALID_CHECKSUM", "DIČ special entity check digit mismatch");
+		return {
+			valid: true,
+			compact: v
+		};
+	}
+	return validate$1(v);
+};
+const format = (value) => `CZ${compact(value)}`;
+/** Generate a random valid 8-digit DIČ. */
+const generate = () => {
+	const payload = String(randomInt(1, 8)) + randomDigits(6);
+	const v11 = (11 - weightedSum(payload, ICO_WEIGHTS, 11)) % 11;
+	const check = v11 === 0 ? 1 : v11 % 10;
+	return payload + String(check);
+};
+/** Czech VAT Number. */
+const dic = {
+	name: "Czech VAT Number",
+	localName: "Daňové identifikační číslo",
+	abbreviation: "DIČ",
+	aliases: ["DIČ", "daňové identifikační číslo"],
+	candidatePattern: "CZ\\d{8,10}",
+	country: "CZ",
+	entityType: "any",
+	sourceUrl: "https://adisspr.mfcr.cz/dpr/DphReg",
+	examples: ["25123891", "7103192745"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, dic as default, format, generate, validate };
+
+//# sourceMappingURL=dic.js.map

package/dist/cz/dic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dic.js","names":["validateRc"],"sources":["../../src/cz/dic.ts"],"sourcesContent":["/**\n * DIČ (Daňové identifikační číslo).\n *\n * Czech tax identification number / VAT number.\n * Format: \"CZ\" prefix + 8, 9, or 10 digits.\n * - 8 digits: company (same checksum as IČO,\n *   but first digit cannot be 9)\n * - 9 digits starting with 6: special entity\n * - 9-10 digits: individual (birth number)\n *\n * @see https://adisspr.mfcr.cz/dpr/DphReg\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\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\";\nimport { validate as validateRc } from \"./rc\";\n\nconst ICO_WEIGHTS = [8, 7, 6, 5, 4, 3, 2] as const;\n\nconst compact = (value: string): string => {\n  const v = clean(value, \" -\");\n  if (v.startsWith(\"CZ\") || v.startsWith(\"cz\")) {\n    return v.slice(2);\n  }\n  return v;\n};\n\nconst checkLegal = (value: string): boolean => {\n  const sum = weightedSum(\n    value.slice(0, 7),\n    ICO_WEIGHTS,\n    11,\n  );\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return check === Number(value[7]);\n};\n\nconst checkSpecial = (value: string): boolean => {\n  // Skip the leading \"6\"; check digits 1..7\n  const sum = weightedSum(\n    value.slice(1, 8),\n    [8, 7, 6, 5, 4, 3, 2],\n    11,\n  );\n  const check =\n    (((8 - ((((10 - sum) % 11) + 11) % 11)) % 10) + 10) %\n    10;\n  return check === Number(value[8]);\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length < 8 || v.length > 10) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"DIČ must be 8-10 digits (without CZ prefix)\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"DIČ must contain only digits\",\n    );\n  }\n\n  // 8-digit: legal entity (IČO-like checksum)\n  if (v.length === 8) {\n    if (v[0] === \"9\") {\n      return err(\n        \"INVALID_COMPONENT\",\n        \"8-digit DIČ cannot start with 9\",\n      );\n    }\n    if (!checkLegal(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"DIČ check digit does not match\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 9-digit starting with 6: special entity\n  if (v.length === 9 && v[0] === \"6\") {\n    if (!checkSpecial(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"DIČ special entity check digit mismatch\",\n      );\n    }\n    return { valid: true, compact: v };\n  }\n\n  // 9-10 digit: birth number\n  return validateRc(v);\n};\n\nconst format = (value: string): string =>\n  `CZ${compact(value)}`;\n\n/** Generate a random valid 8-digit DIČ. */\nconst generate = (): string => {\n  const first = String(randomInt(1, 8));\n  const payload = first + randomDigits(6);\n  const sum = weightedSum(payload, ICO_WEIGHTS, 11);\n  const v11 = (11 - sum) % 11;\n  const check = v11 === 0 ? 1 : v11 % 10;\n  return payload + String(check);\n};\n\n/** Czech VAT Number. */\nconst dic: Validator = {\n  name: \"Czech VAT Number\",\n  localName: \"Daňové identifikační číslo\",\n  abbreviation: \"DIČ\",\n  aliases: [\"DIČ\", \"daňové identifikační číslo\"] as const,\n  candidatePattern: \"CZ\\\\d{8,10}\",\n  country: \"CZ\",\n  entityType: \"any\",\n  sourceUrl: \"https://adisspr.mfcr.cz/dpr/DphReg\",\n  examples: [\"25123891\", \"7103192745\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default dic;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAM,cAAc;CAAC;CAAG;CAAG;CAAG;CAAG;CAAG;CAAG;CAAE;AAEzC,MAAM,WAAW,UAA0B;CACzC,MAAM,IAAI,MAAM,OAAO,KAAK;AAC5B,KAAI,EAAE,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,CAC1C,QAAO,EAAE,MAAM,EAAE;AAEnB,QAAO;;AAGT,MAAM,cAAc,UAA2B;CAM7C,MAAM,OAAO,KALD,YACV,MAAM,MAAM,GAAG,EAAE,EACjB,aACA,GACD,IACwB;AAEzB,SADc,QAAQ,IAAI,IAAI,MAAM,QACnB,OAAO,MAAM,GAAG;;AAGnC,MAAM,gBAAgB,UAA2B;AAU/C,UAFK,MAAQ,KAND,YACV,MAAM,MAAM,GAAG,EAAE,EACjB;EAAC;EAAG;EAAG;EAAG;EAAG;EAAG;EAAG;EAAE,EACrB,GACD,IAEwB,KAAM,MAAM,MAAO,KAAM,MAChD,OACe,OAAO,MAAM,GAAG;;AAGnC,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,SAAS,KAAK,EAAE,SAAS,GAC7B,QAAO,IACL,kBACA,8CACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,+BACD;AAIH,KAAI,EAAE,WAAW,GAAG;AAClB,MAAI,EAAE,OAAO,IACX,QAAO,IACL,qBACA,kCACD;AAEH,MAAI,CAAC,WAAW,EAAE,CAChB,QAAO,IACL,oBACA,iCACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,KAAI,EAAE,WAAW,KAAK,EAAE,OAAO,KAAK;AAClC,MAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,0CACD;AAEH,SAAO;GAAE,OAAO;GAAM,SAAS;GAAG;;AAIpC,QAAOA,WAAW,EAAE;;AAGtB,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;CAE7B,MAAM,UADQ,OAAO,UAAU,GAAG,EAAE,CAAC,GACb,aAAa,EAAE;CAEvC,MAAM,OAAO,KADD,YAAY,SAAS,aAAa,GAAG,IACxB;CACzB,MAAM,QAAQ,QAAQ,IAAI,IAAI,MAAM;AACpC,QAAO,UAAU,OAAO,MAAM;;;AAIhC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,OAAO,6BAA6B;CAC9C,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY,aAAa;CACpC;CACA;CACA;CACA;CACD"}

package/dist/cz/ico.d.ts

@@ -0,0 +1,14 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/cz/ico.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Generate a random valid ICO. */
+declare const generate: () => string;
+/** Czech Company Identification Number. */
+declare const ico: Validator;
+//#endregion
+export { compact, ico as default, format, generate, validate };
+//# sourceMappingURL=ico.d.ts.map