@stll/stdnum 0.0.1

package/dist/fi/vat.js

@@ -0,0 +1,68 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+import { weightedSum } from "../_checksums/weighted-sum.js";
+//#region src/fi/vat.ts
+/**
+* ALV nro (Finnish VAT number).
+*
+* 8 digits. Weights [7,9,10,5,8,4,2,1],
+* sum % 11 === 0.
+*
+* @see https://www.vatify.eu/finland-vat-number.html
+* @see https://www.ytj.fi/en/index/businessid.html
+*/
+const WEIGHTS = [
+	7,
+	9,
+	10,
+	5,
+	8,
+	4,
+	2,
+	1
+];
+const compact = (value) => {
+	let v = clean(value, " -/.");
+	if (v.startsWith("FI") || v.startsWith("fi")) v = v.slice(2);
+	return v;
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 8) return err("INVALID_LENGTH", "Finnish VAT number must be 8 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "Finnish VAT number must contain only digits");
+	if (weightedSum(v, WEIGHTS, 11) !== 0) return err("INVALID_CHECKSUM", "Finnish VAT number check digit mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => `FI${compact(value)}`;
+/** Generate a random valid Finnish VAT number. */
+const generate = () => {
+	for (;;) {
+		const c = randomDigits(8);
+		if (validate(c).valid) return c;
+	}
+};
+/** Finnish VAT Number. */
+const vat = {
+	name: "Finnish VAT Number",
+	localName: "Arvonlisäveronumero",
+	abbreviation: "ALV nro",
+	aliases: ["ALV-numero", "Y-tunnus"],
+	candidatePattern: "FI\\d{8}",
+	country: "FI",
+	entityType: "company",
+	sourceUrl: "https://www.ytj.fi/en/index/businessid.html",
+	examples: ["20774740"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, vat as default, format, generate, validate };
+
+//# sourceMappingURL=vat.js.map

package/dist/fi/vat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vat.js","names":[],"sources":["../../src/fi/vat.ts"],"sourcesContent":["/**\n * ALV nro (Finnish VAT number).\n *\n * 8 digits. Weights [7,9,10,5,8,4,2,1],\n * sum % 11 === 0.\n *\n * @see https://www.vatify.eu/finland-vat-number.html\n * @see https://www.ytj.fi/en/index/businessid.html\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1];\n\nconst compact = (value: string): string => {\n  let v = clean(value, \" -/.\");\n  if (v.startsWith(\"FI\") || v.startsWith(\"fi\")) {\n    v = v.slice(2);\n  }\n  return v;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Finnish VAT number must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Finnish VAT number must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v, WEIGHTS, 11);\n  if (sum !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Finnish VAT number check digit mismatch\",\n    );\n  }\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string =>\n  `FI${compact(value)}`;\n\n/** Generate a random valid Finnish VAT number. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Finnish VAT Number. */\nconst vat: Validator = {\n  name: \"Finnish VAT Number\",\n  localName: \"Arvonlisäveronumero\",\n  abbreviation: \"ALV nro\",\n  aliases: [\"ALV-numero\", \"Y-tunnus\"] as const,\n  candidatePattern: \"FI\\\\d{8}\",\n  country: \"FI\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.ytj.fi/en/index/businessid.html\",\n  examples: [\"20774740\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default vat;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAG;CAAE;AAEzC,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;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,sCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,8CACD;AAGH,KADY,YAAY,GAAG,SAAS,GAAG,KAC3B,EACV,QAAO,IACL,oBACA,0CACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UACd,KAAK,QAAQ,MAAM;;AAGrB,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS,CAAC,cAAc,WAAW;CACnC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}

package/dist/fi/ytunnus.d.ts

@@ -0,0 +1,14 @@
+import { ValidateResult, Validator } from "../types.js";
+
+//#region src/fi/ytunnus.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+/** Generate a random valid Finnish Y-tunnus. */
+declare const generate: () => string;
+/** Finnish Business ID. */
+declare const ytunnus: Validator;
+//#endregion
+export { compact, ytunnus as default, format, generate, validate };
+//# sourceMappingURL=ytunnus.d.ts.map

package/dist/fi/ytunnus.js

@@ -0,0 +1,71 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { isdigits } from "../_util/strings.js";
+import { weightedSum } from "../_checksums/weighted-sum.js";
+//#region src/fi/ytunnus.ts
+/**
+* Y-tunnus (Finnish Business ID).
+*
+* 8 digits. Weights [7,9,10,5,8,4,2,1],
+* sum % 11 === 0. Same algorithm as FI VAT.
+* Display format: NNNNNNN-C.
+*
+* @see https://www.ytj.fi/en/index/businessid.html
+*/
+const WEIGHTS = [
+	7,
+	9,
+	10,
+	5,
+	8,
+	4,
+	2,
+	1
+];
+const compact = (value) => clean(value, " -/.");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 8) return err("INVALID_LENGTH", "Finnish Y-tunnus must be 8 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "Finnish Y-tunnus must contain only digits");
+	if (weightedSum(v, WEIGHTS, 11) !== 0) return err("INVALID_CHECKSUM", "Finnish Y-tunnus check digit mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return `${v.slice(0, 7)}-${v[7]}`;
+};
+/** Generate a random valid Finnish Y-tunnus. */
+const generate = () => {
+	for (;;) {
+		const c = randomDigits(8);
+		if (validate(c).valid) return c;
+	}
+};
+/** Finnish Business ID. */
+const ytunnus = {
+	name: "Finnish Business ID",
+	localName: "Y-tunnus",
+	abbreviation: "Y-tunnus",
+	aliases: [
+		"Y-tunnus",
+		"yritystunnus",
+		"FO-nummer"
+	],
+	candidatePattern: "\\d{7}-\\d",
+	country: "FI",
+	entityType: "company",
+	sourceUrl: "https://www.ytj.fi/en/index/businessid.html",
+	examples: ["20774740"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, ytunnus as default, format, generate, validate };
+
+//# sourceMappingURL=ytunnus.js.map

package/dist/fi/ytunnus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ytunnus.js","names":[],"sources":["../../src/fi/ytunnus.ts"],"sourcesContent":["/**\n * Y-tunnus (Finnish Business ID).\n *\n * 8 digits. Weights [7,9,10,5,8,4,2,1],\n * sum % 11 === 0. Same algorithm as FI VAT.\n * Display format: NNNNNNN-C.\n *\n * @see https://www.ytj.fi/en/index/businessid.html\n */\n\nimport { weightedSum } from \"#checksums/weighted-sum\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1];\n\nconst compact = (value: string): string =>\n  clean(value, \" -/.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 8) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"Finnish Y-tunnus must be 8 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"Finnish Y-tunnus must contain only digits\",\n    );\n  }\n  const sum = weightedSum(v, WEIGHTS, 11);\n  if (sum !== 0) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"Finnish Y-tunnus check digit mismatch\",\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, 7)}-${v[7]}`;\n};\n\n/** Generate a random valid Finnish Y-tunnus. */\nconst generate = (): string => {\n  for (;;) {\n    const c = randomDigits(8);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** Finnish Business ID. */\nconst ytunnus: Validator = {\n  name: \"Finnish Business ID\",\n  localName: \"Y-tunnus\",\n  abbreviation: \"Y-tunnus\",\n  aliases: [\n    \"Y-tunnus\",\n    \"yritystunnus\",\n    \"FO-nummer\",\n  ] as const,\n  candidatePattern: \"\\\\d{7}-\\\\d\",\n  country: \"FI\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.ytj.fi/en/index/businessid.html\",\n  examples: [\"20774740\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default ytunnus;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,UAAU;CAAC;CAAG;CAAG;CAAI;CAAG;CAAG;CAAG;CAAG;CAAE;AAEzC,MAAM,WAAW,UACf,MAAM,OAAO,OAAO;AAEtB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,oCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,4CACD;AAGH,KADY,YAAY,GAAG,SAAS,GAAG,KAC3B,EACV,QAAO,IACL,oBACA,wCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE;;;AAI/B,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,aAAa,EAAE;AACzB,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,UAAqB;CACzB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,WAAW;CACtB;CACA;CACA;CACA;CACD"}

package/dist/fr/mod.d.ts

@@ -0,0 +1,12 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import nif from "./nif.js";
+import nir from "./nir.js";
+import siren from "./siren.js";
+import siret from "./siret.js";
+import tva from "./tva.js";
+
+//#region src/fr/mod.d.ts
+
+//#endregion
+export { mod_d_exports, nif, nir, siren, siret, tva };
+//# sourceMappingURL=mod.d.ts.map

package/dist/fr/mod.js

@@ -0,0 +1,18 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import tva from "./tva.js";
+import nif from "./nif.js";
+import nir from "./nir.js";
+import siren from "./siren.js";
+import siret from "./siret.js";
+//#region src/fr/mod.ts
+var fr_exports = /* @__PURE__ */ __exportAll({
+	nif: () => nif,
+	nir: () => nir,
+	siren: () => siren,
+	siret: () => siret,
+	tva: () => tva
+});
+//#endregion
+export { fr_exports, nif, nir, siren, siret, tva };
+
+//# sourceMappingURL=mod.js.map

package/dist/fr/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":[],"sources":["../../src/fr/mod.ts"],"sourcesContent":["export { default as nif } from \"./nif\";\nexport { default as nir } from \"./nir\";\nexport { default as siren } from \"./siren\";\nexport { default as siret } from \"./siret\";\nexport { default as tva } from \"./tva\";\n"],"mappings":""}

package/dist/fr/nif.d.ts

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

package/dist/fr/nif.js

@@ -0,0 +1,64 @@
+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/fr/nif.ts
+/**
+* NIF (Numéro d'Identification Fiscale).
+*
+* French tax identification number. 13 digits;
+* first digit is 0-3. Last 3 digits are a
+* check: first_10_digits % 511 == last_3.
+*
+* @see https://www.impots.gouv.fr/
+*/
+const compact = (value) => clean(value, " -");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 13) return err("INVALID_LENGTH", "French NIF must be exactly 13 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "French NIF must contain only digits");
+	const first = v[0];
+	if (first !== "0" && first !== "1" && first !== "2" && first !== "3") return err("INVALID_COMPONENT", "French NIF must start with 0-3");
+	const front = Number(v.slice(0, 10));
+	const check = Number(v.slice(10));
+	if (front % 511 !== check) return err("INVALID_CHECKSUM", "French NIF check digits mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return `${v.slice(0, 2)} ${v.slice(2, 4)} ${v.slice(4, 7)} ${v.slice(7, 10)} ${v.slice(10)}`;
+};
+/** Generate a random valid French NIF. */
+const generate = () => {
+	for (;;) {
+		const c = String(randomInt(0, 3)) + randomDigits(12);
+		if (validate(c).valid) return c;
+	}
+};
+/** French Tax Identification Number. */
+const nif = {
+	name: "French Tax ID",
+	localName: "Numéro d'Identification Fiscale",
+	abbreviation: "NIF",
+	aliases: [
+		"numéro fiscal",
+		"NIF",
+		"numéro d'identification fiscale"
+	],
+	candidatePattern: "\\d{13}",
+	country: "FR",
+	entityType: "person",
+	sourceUrl: "https://www.impots.gouv.fr/",
+	examples: ["3023217600053"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, nif as default, format, generate, validate };
+
+//# sourceMappingURL=nif.js.map

package/dist/fr/nif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nif.js","names":[],"sources":["../../src/fr/nif.ts"],"sourcesContent":["/**\n * NIF (Numéro d'Identification Fiscale).\n *\n * French tax identification number. 13 digits;\n * first digit is 0-3. Last 3 digits are a\n * check: first_10_digits % 511 == last_3.\n *\n * @see https://www.impots.gouv.fr/\n */\n\nimport { clean } from \"#util/clean\";\nimport { randomDigits, randomInt } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 13) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French NIF must be exactly 13 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIF must contain only digits\",\n    );\n  }\n  const first = v[0];\n  if (\n    first !== \"0\" &&\n    first !== \"1\" &&\n    first !== \"2\" &&\n    first !== \"3\"\n  ) {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"French NIF must start with 0-3\",\n    );\n  }\n  const front = Number(v.slice(0, 10));\n  const check = Number(v.slice(10));\n  if (front % 511 !== check) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French NIF check digits mismatch\",\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, 4)} ${v.slice(4, 7)} ${v.slice(7, 10)} ${v.slice(10)}`;\n};\n\n/** Generate a random valid French NIF. */\nconst generate = (): string => {\n  for (;;) {\n    const c = String(randomInt(0, 3)) + randomDigits(12);\n    if (validate(c).valid) return c;\n  }\n};\n\n/** French Tax Identification Number. */\nconst nif: Validator = {\n  name: \"French Tax ID\",\n  localName: \"Numéro d'Identification Fiscale\",\n  abbreviation: \"NIF\",\n  aliases: [\n    \"numéro fiscal\",\n    \"NIF\",\n    \"numéro d'identification fiscale\",\n  ] as const,\n  candidatePattern: \"\\\\d{13}\",\n  country: \"FR\",\n  entityType: \"person\",\n  sourceUrl: \"https://www.impots.gouv.fr/\",\n  examples: [\"3023217600053\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nif;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAM,WAAW,UACf,MAAM,OAAO,KAAK;AAEpB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,uCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,sCACD;CAEH,MAAM,QAAQ,EAAE;AAChB,KACE,UAAU,OACV,UAAU,OACV,UAAU,OACV,UAAU,IAEV,QAAO,IACL,qBACA,iCACD;CAEH,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;CACpC,MAAM,QAAQ,OAAO,EAAE,MAAM,GAAG,CAAC;AACjC,KAAI,QAAQ,QAAQ,MAClB,QAAO,IACL,oBACA,mCACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;;;AAI5F,MAAM,iBAAyB;AAC7B,UAAS;EACP,MAAM,IAAI,OAAO,UAAU,GAAG,EAAE,CAAC,GAAG,aAAa,GAAG;AACpD,MAAI,SAAS,EAAE,CAAC,MAAO,QAAO;;;;AAKlC,MAAM,MAAiB;CACrB,MAAM;CACN,WAAW;CACX,cAAc;CACd,SAAS;EACP;EACA;EACA;EACD;CACD,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,gBAAgB;CAC3B;CACA;CACA;CACA;CACD"}

package/dist/fr/nir.d.ts

@@ -0,0 +1,15 @@
+import { ParsedPersonId, ValidateResult, Validator } from "../types.js";
+
+//#region src/fr/nir.d.ts
+
+declare const compact: (value: string) => string;
+declare const validate: (value: string) => ValidateResult;
+declare const format: (value: string) => string;
+declare const parse: (value: string) => ParsedPersonId | null;
+/** Generate a random valid French NIR. */
+declare const generate: () => string;
+/** French Social Security Number. */
+declare const nir: Validator;
+//#endregion
+export { compact, nir as default, format, generate, parse, validate };
+//# sourceMappingURL=nir.d.ts.map

package/dist/fr/nir.js

@@ -0,0 +1,106 @@
+import { clean } from "../_util/clean.js";
+import { randomInt } from "../_util/generate.js";
+import { err } from "../_util/result.js";
+import { resolveTwoDigitYear } from "../_util/date.js";
+//#region src/fr/nir.ts
+/**
+* NIR (Numero d'Inscription au Repertoire).
+*
+* French social security number (numero de securite
+* sociale). 15 digits: 13 identity digits + 2 check
+* digits. Encodes gender, year/month of birth, and
+* department of birth.
+*
+* Corsican departments 2A/2B are encoded as 19/18
+* for the mod-97 checksum computation.
+*
+* @see https://en.wikipedia.org/wiki/INSEE_code
+*/
+const compact = (value) => clean(value, " -.");
+const validate = (value) => {
+	const v = compact(value).toUpperCase();
+	if (v.length !== 15) return err("INVALID_LENGTH", "French NIR must be 15 characters");
+	const gender = v[0];
+	if (gender !== "1" && gender !== "2") return err("INVALID_COMPONENT", "French NIR first digit must be 1 or 2");
+	const yearPart = v.slice(1, 3);
+	if (!/^\d{2}$/.test(yearPart)) return err("INVALID_FORMAT", "French NIR year must be 2 digits");
+	const monthPart = v.slice(3, 5);
+	if (!/^\d{2}$/.test(monthPart) || monthPart === "00") return err("INVALID_FORMAT", "French NIR month must be 01-99");
+	const deptPart = v.slice(5, 7);
+	if (!(deptPart === "2A" || deptPart === "2B") && !/^\d{2}$/.test(deptPart)) return err("INVALID_FORMAT", "French NIR department must be 2 digits or 2A/2B");
+	const communePart = v.slice(7, 10);
+	if (!/^\d{3}$/.test(communePart)) return err("INVALID_FORMAT", "French NIR commune must be 3 digits");
+	const serialPart = v.slice(10, 13);
+	if (!/^\d{3}$/.test(serialPart)) return err("INVALID_FORMAT", "French NIR serial must be 3 digits");
+	const checkPart = v.slice(13, 15);
+	if (!/^\d{2}$/.test(checkPart)) return err("INVALID_FORMAT", "French NIR check must be 2 digits");
+	let numericBase;
+	if (deptPart === "2A") numericBase = v.slice(0, 5) + "19" + v.slice(7, 13);
+	else if (deptPart === "2B") numericBase = v.slice(0, 5) + "18" + v.slice(7, 13);
+	else numericBase = v.slice(0, 13);
+	if (97n - BigInt(numericBase) % 97n !== BigInt(checkPart)) return err("INVALID_CHECKSUM", "French NIR check digits mismatch");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value).toUpperCase();
+	return `${v.slice(0, 1)} ${v.slice(1, 3)} ${v.slice(3, 5)} ${v.slice(5, 7)} ${v.slice(7, 10)} ${v.slice(10, 13)} ${v.slice(13)}`;
+};
+const parse = (value) => {
+	const result = validate(value);
+	if (!result.valid) return null;
+	const v = result.compact;
+	const genderDigit = v[0];
+	const yy = Number(v.slice(1, 3));
+	const mm = Number(v.slice(3, 5));
+	if (mm < 1 || mm > 12) return null;
+	const year = resolveTwoDigitYear(yy);
+	const gender = genderDigit === "1" ? "male" : "female";
+	return {
+		birthDate: new Date(year, mm - 1, 1),
+		gender
+	};
+};
+/** Generate a random valid French NIR. */
+const generate = () => {
+	for (;;) {
+		const g = String(randomInt(1, 2));
+		const yy = String(randomInt(50, 99)).padStart(2, "0");
+		const mm = String(randomInt(1, 12)).padStart(2, "0");
+		const dept = String(randomInt(1, 95)).padStart(2, "0");
+		const com = String(randomInt(1, 999)).padStart(3, "0");
+		const s = String(randomInt(1, 999)).padStart(3, "0");
+		const base = g + yy + mm + dept + com + s;
+		const c = base + String(97 - Number(base) % 97).padStart(2, "0");
+		if (validate(c).valid) return c;
+	}
+};
+/** French Social Security Number. */
+const nir = {
+	name: "French Social Security Number",
+	localName: "Numero d'Inscription au Repertoire",
+	abbreviation: "NIR",
+	aliases: [
+		"NIR",
+		"numéro de sécurité sociale",
+		"numéro SS",
+		"sécu"
+	],
+	candidatePattern: "[12]\\s?\\d{2}\\s?\\d{2}\\s?\\d{2}\\s?\\d{3}\\s?\\d{3}\\s?\\d{2}",
+	country: "FR",
+	entityType: "person",
+	description: "French social security number encoding gender, birth date, and department",
+	sourceUrl: "https://en.wikipedia.org/wiki/INSEE_code",
+	lengths: [15],
+	examples: ["295117823456784"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, nir as default, format, generate, parse, validate };
+
+//# sourceMappingURL=nir.js.map

package/dist/fr/nir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nir.js","names":[],"sources":["../../src/fr/nir.ts"],"sourcesContent":["/**\n * NIR (Numero d'Inscription au Repertoire).\n *\n * French social security number (numero de securite\n * sociale). 15 digits: 13 identity digits + 2 check\n * digits. Encodes gender, year/month of birth, and\n * department of birth.\n *\n * Corsican departments 2A/2B are encoded as 19/18\n * for the mod-97 checksum computation.\n *\n * @see https://en.wikipedia.org/wiki/INSEE_code\n */\n\nimport { clean } from \"#util/clean\";\nimport { resolveTwoDigitYear } from \"#util/date\";\nimport { randomInt } from \"#util/generate\";\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, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value).toUpperCase();\n  if (v.length !== 15) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"French NIR must be 15 characters\",\n    );\n  }\n\n  const gender = v[0];\n  if (gender !== \"1\" && gender !== \"2\") {\n    return err(\n      \"INVALID_COMPONENT\",\n      \"French NIR first digit must be 1 or 2\",\n    );\n  }\n\n  const yearPart = v.slice(1, 3);\n  if (!/^\\d{2}$/.test(yearPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR year must be 2 digits\",\n    );\n  }\n\n  const monthPart = v.slice(3, 5);\n  if (!/^\\d{2}$/.test(monthPart) || monthPart === \"00\") {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR month must be 01-99\",\n    );\n  }\n\n  const deptPart = v.slice(5, 7);\n  const isCorsica = deptPart === \"2A\" || deptPart === \"2B\";\n  if (!isCorsica && !/^\\d{2}$/.test(deptPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR department must be 2 digits or 2A/2B\",\n    );\n  }\n\n  const communePart = v.slice(7, 10);\n  if (!/^\\d{3}$/.test(communePart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR commune must be 3 digits\",\n    );\n  }\n\n  const serialPart = v.slice(10, 13);\n  if (!/^\\d{3}$/.test(serialPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR serial must be 3 digits\",\n    );\n  }\n\n  const checkPart = v.slice(13, 15);\n  if (!/^\\d{2}$/.test(checkPart)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"French NIR check must be 2 digits\",\n    );\n  }\n\n  let numericBase: string;\n  if (deptPart === \"2A\") {\n    numericBase = v.slice(0, 5) + \"19\" + v.slice(7, 13);\n  } else if (deptPart === \"2B\") {\n    numericBase = v.slice(0, 5) + \"18\" + v.slice(7, 13);\n  } else {\n    numericBase = v.slice(0, 13);\n  }\n\n  const base = BigInt(numericBase);\n  const expected = 97n - (base % 97n);\n  const actual = BigInt(checkPart);\n\n  if (expected !== actual) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"French NIR check digits mismatch\",\n    );\n  }\n\n  return { valid: true, compact: v };\n};\n\nconst format = (value: string): string => {\n  const v = compact(value).toUpperCase();\n  return (\n    `${v.slice(0, 1)} ${v.slice(1, 3)}` +\n    ` ${v.slice(3, 5)} ${v.slice(5, 7)}` +\n    ` ${v.slice(7, 10)} ${v.slice(10, 13)}` +\n    ` ${v.slice(13)}`\n  );\n};\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 genderDigit = v[0];\n  const yy = Number(v.slice(1, 3));\n  const mm = Number(v.slice(3, 5));\n\n  if (mm < 1 || mm > 12) return null;\n\n  const year = resolveTwoDigitYear(yy);\n  const gender = genderDigit === \"1\" ? \"male\" : \"female\";\n\n  return {\n    birthDate: new Date(year, mm - 1, 1),\n    gender,\n  };\n};\n\n/** Generate a random valid French NIR. */\nconst generate = (): string => {\n  for (;;) {\n    const g = String(randomInt(1, 2));\n    const yy = String(randomInt(50, 99)).padStart(2, \"0\");\n    const mm = String(randomInt(1, 12)).padStart(2, \"0\");\n    const dept = String(randomInt(1, 95)).padStart(2, \"0\");\n    const com = String(randomInt(1, 999)).padStart(3, \"0\");\n    const s = String(randomInt(1, 999)).padStart(3, \"0\");\n    const base = g + yy + mm + dept + com + s;\n    const check = String(97 - (Number(base) % 97)).padStart(\n      2,\n      \"0\",\n    );\n    const c = base + check;\n    if (validate(c).valid) return c;\n  }\n};\n\n/** French Social Security Number. */\nconst nir: Validator = {\n  name: \"French Social Security Number\",\n  localName: \"Numero d'Inscription au Repertoire\",\n  abbreviation: \"NIR\",\n  aliases: [\n    \"NIR\",\n    \"numéro de sécurité sociale\",\n    \"numéro SS\",\n    \"sécu\",\n  ] as const,\n  candidatePattern:\n    \"[12]\\\\s?\\\\d{2}\\\\s?\\\\d{2}\\\\s?\\\\d{2}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{2}\",\n  country: \"FR\",\n  entityType: \"person\",\n  description:\n    \"French social security number encoding \" +\n    \"gender, birth date, and department\",\n  sourceUrl: \"https://en.wikipedia.org/wiki/INSEE_code\",\n  lengths: [15] as const,\n  examples: [\"295117823456784\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default nir;\nexport { compact, format, parse, validate, generate };\n"],"mappings":"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"}

package/dist/fr/siren.d.ts

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

package/dist/fr/siren.js

@@ -0,0 +1,56 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } 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/fr/siren.ts
+/**
+* SIREN (Système d'Identification du Répertoire
+* des Entreprises).
+*
+* French company identification number. 9 digits
+* validated with standard Luhn algorithm.
+*
+* @see https://www.insee.fr/fr/information/2549588
+*/
+const compact = (value) => clean(value, " -.");
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 9) return err("INVALID_LENGTH", "SIREN must be exactly 9 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "SIREN must contain only digits");
+	if (!luhnValidate(v)) return err("INVALID_CHECKSUM", "SIREN fails Luhn check");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;
+};
+/** Generate a random valid French SIREN. */
+const generate = () => {
+	const payload = randomDigits(8);
+	const cs = luhnChecksum(payload + "0");
+	return payload + String((10 - cs) % 10);
+};
+/** French Company Identification Number. */
+const siren = {
+	name: "French Company ID",
+	localName: "Système d'Identification du Répertoire des Entreprises",
+	abbreviation: "SIREN",
+	aliases: ["SIREN", "numéro SIREN"],
+	candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}",
+	country: "FR",
+	entityType: "company",
+	sourceUrl: "https://www.insee.fr/fr/information/2549588",
+	examples: ["552008443"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, siren as default, format, generate, validate };
+
+//# sourceMappingURL=siren.js.map

package/dist/fr/siren.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"siren.js","names":[],"sources":["../../src/fr/siren.ts"],"sourcesContent":["/**\n * SIREN (Système d'Identification du Répertoire\n * des Entreprises).\n *\n * French company identification number. 9 digits\n * validated with standard Luhn algorithm.\n *\n * @see https://www.insee.fr/fr/information/2549588\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 9) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIREN must be exactly 9 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIREN must contain only digits\",\n    );\n  }\n  if (!luhnValidate(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIREN fails Luhn check\",\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, 3)} ${v.slice(3, 6)} ${v.slice(6)}`;\n};\n\n/** Generate a random valid French SIREN. */\nconst generate = (): string => {\n  const payload = randomDigits(8);\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Company Identification Number. */\nconst siren: Validator = {\n  name: \"French Company ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Entreprises\",\n  abbreviation: \"SIREN\",\n  aliases: [\"SIREN\", \"numéro SIREN\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"552008443\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siren;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;AAErB,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,EACf,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAEH,KAAI,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,yBACD;AAEH,QAAO;EAAE,OAAO;EAAM,SAAS;EAAG;;AAGpC,MAAM,UAAU,UAA0B;CACxC,MAAM,IAAI,QAAQ,MAAM;AACxB,QAAO,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIxD,MAAM,iBAAyB;CAC7B,MAAM,UAAU,aAAa,EAAE;CAC/B,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,QAAmB;CACvB,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,SAAS,eAAe;CAClC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,YAAY;CACvB;CACA;CACA;CACA;CACD"}

package/dist/fr/siret.d.ts

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

package/dist/fr/siret.js

@@ -0,0 +1,73 @@
+import { clean } from "../_util/clean.js";
+import { randomDigits } 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/fr/siret.ts
+/**
+* SIRET (Système d'Identification du Répertoire
+* des Établissements).
+*
+* French establishment identification number.
+* 14 digits: SIREN (9) + NIC (5). Validated
+* with Luhn, with a special case for La Poste.
+*
+* @see https://www.insee.fr/fr/information/2549588
+*/
+const compact = (value) => clean(value, " -.");
+/**
+* La Poste SIRET uses digit sum % 5 instead of
+* Luhn, EXCEPT the head office (35600000000048)
+* which uses standard Luhn.
+*/
+const isLaPoste = (v) => v.startsWith("356000000") && v !== "35600000000048";
+const digitSum = (v) => {
+	let sum = 0;
+	for (let i = 0; i < v.length; i++) sum += Number(v[i]);
+	return sum;
+};
+const validate = (value) => {
+	const v = compact(value);
+	if (v.length !== 14) return err("INVALID_LENGTH", "SIRET must be exactly 14 digits");
+	if (!isdigits(v)) return err("INVALID_FORMAT", "SIRET must contain only digits");
+	if (!luhnValidate(v.slice(0, 9)) && !isLaPoste(v)) return err("INVALID_CHECKSUM", "SIRET SIREN part fails Luhn check");
+	if (isLaPoste(v)) {
+		if (digitSum(v) % 5 !== 0) return err("INVALID_CHECKSUM", "SIRET La Poste digit sum check failed");
+	} else if (!luhnValidate(v)) return err("INVALID_CHECKSUM", "SIRET fails Luhn check");
+	return {
+		valid: true,
+		compact: v
+	};
+};
+const format = (value) => {
+	const v = compact(value);
+	return `${v.slice(0, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;
+};
+/** Generate a random valid French SIRET. */
+const generate = () => {
+	const sp = randomDigits(8);
+	const sc = luhnChecksum(sp + "0");
+	const payload = sp + String((10 - sc) % 10) + randomDigits(4);
+	const cs = luhnChecksum(payload + "0");
+	return payload + String((10 - cs) % 10);
+};
+/** French Establishment Identification Number. */
+const siret = {
+	name: "French Establishment ID",
+	localName: "Système d'Identification du Répertoire des Établissements",
+	abbreviation: "SIRET",
+	aliases: ["SIRET", "numéro SIRET"],
+	candidatePattern: "\\d{3}\\s?\\d{3}\\s?\\d{3}\\s?\\d{5}",
+	country: "FR",
+	entityType: "company",
+	sourceUrl: "https://www.insee.fr/fr/information/2549588",
+	examples: ["73282932000074"],
+	compact,
+	format,
+	validate,
+	generate
+};
+//#endregion
+export { compact, siret as default, format, generate, validate };
+
+//# sourceMappingURL=siret.js.map

package/dist/fr/siret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"siret.js","names":[],"sources":["../../src/fr/siret.ts"],"sourcesContent":["/**\n * SIRET (Système d'Identification du Répertoire\n * des Établissements).\n *\n * French establishment identification number.\n * 14 digits: SIREN (9) + NIC (5). Validated\n * with Luhn, with a special case for La Poste.\n *\n * @see https://www.insee.fr/fr/information/2549588\n */\n\nimport {\n  luhnValidate,\n  luhnChecksum,\n} from \"#checksums/luhn\";\nimport { clean } from \"#util/clean\";\nimport { randomDigits } from \"#util/generate\";\nimport { err } from \"#util/result\";\nimport { isdigits } from \"#util/strings\";\n\nimport type { ValidateResult, Validator } from \"../types\";\n\nconst compact = (value: string): string =>\n  clean(value, \" -.\");\n\n/**\n * La Poste SIRET uses digit sum % 5 instead of\n * Luhn, EXCEPT the head office (35600000000048)\n * which uses standard Luhn.\n */\nconst isLaPoste = (v: string): boolean =>\n  v.startsWith(\"356000000\") && v !== \"35600000000048\";\n\nconst digitSum = (v: string): number => {\n  let sum = 0;\n  for (let i = 0; i < v.length; i++) {\n    sum += Number(v[i]);\n  }\n  return sum;\n};\n\nconst validate = (value: string): ValidateResult => {\n  const v = compact(value);\n  if (v.length !== 14) {\n    return err(\n      \"INVALID_LENGTH\",\n      \"SIRET must be exactly 14 digits\",\n    );\n  }\n  if (!isdigits(v)) {\n    return err(\n      \"INVALID_FORMAT\",\n      \"SIRET must contain only digits\",\n    );\n  }\n\n  // Validate SIREN part (first 9 digits)\n  const siren = v.slice(0, 9);\n  if (!luhnValidate(siren) && !isLaPoste(v)) {\n    return err(\n      \"INVALID_CHECKSUM\",\n      \"SIRET SIREN part fails Luhn check\",\n    );\n  }\n\n  // La Poste: digit sum mod 5\n  if (isLaPoste(v)) {\n    if (digitSum(v) % 5 !== 0) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET La Poste digit sum check failed\",\n      );\n    }\n  } else {\n    // Standard: full 14-digit Luhn\n    if (!luhnValidate(v)) {\n      return err(\n        \"INVALID_CHECKSUM\",\n        \"SIRET fails Luhn check\",\n      );\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, 3)} ${v.slice(3, 6)} ${v.slice(6, 9)} ${v.slice(9)}`;\n};\n\n/** Generate a random valid French SIRET. */\nconst generate = (): string => {\n  const sp = randomDigits(8);\n  const sc = luhnChecksum(sp + \"0\");\n  const siren = sp + String((10 - sc) % 10);\n  const nic = randomDigits(4);\n  const payload = siren + nic;\n  const cs = luhnChecksum(payload + \"0\");\n  return payload + String((10 - cs) % 10);\n};\n\n/** French Establishment Identification Number. */\nconst siret: Validator = {\n  name: \"French Establishment ID\",\n  localName:\n    \"Système d'Identification du Répertoire des Établissements\",\n  abbreviation: \"SIRET\",\n  aliases: [\"SIRET\", \"numéro SIRET\"] as const,\n  candidatePattern: \"\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{3}\\\\s?\\\\d{5}\",\n  country: \"FR\",\n  entityType: \"company\",\n  sourceUrl: \"https://www.insee.fr/fr/information/2549588\",\n  examples: [\"73282932000074\"] as const,\n  compact,\n  format,\n  validate,\n  generate,\n};\n\nexport default siret;\nexport { compact, format, validate, generate };\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,MAAM,WAAW,UACf,MAAM,OAAO,MAAM;;;;;;AAOrB,MAAM,aAAa,MACjB,EAAE,WAAW,YAAY,IAAI,MAAM;AAErC,MAAM,YAAY,MAAsB;CACtC,IAAI,MAAM;AACV,MAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,IAC5B,QAAO,OAAO,EAAE,GAAG;AAErB,QAAO;;AAGT,MAAM,YAAY,UAAkC;CAClD,MAAM,IAAI,QAAQ,MAAM;AACxB,KAAI,EAAE,WAAW,GACf,QAAO,IACL,kBACA,kCACD;AAEH,KAAI,CAAC,SAAS,EAAE,CACd,QAAO,IACL,kBACA,iCACD;AAKH,KAAI,CAAC,aADS,EAAE,MAAM,GAAG,EAAE,CACH,IAAI,CAAC,UAAU,EAAE,CACvC,QAAO,IACL,oBACA,oCACD;AAIH,KAAI,UAAU,EAAE;MACV,SAAS,EAAE,GAAG,MAAM,EACtB,QAAO,IACL,oBACA,wCACD;YAIC,CAAC,aAAa,EAAE,CAClB,QAAO,IACL,oBACA,yBACD;AAIL,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,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE;;;AAIzE,MAAM,iBAAyB;CAC7B,MAAM,KAAK,aAAa,EAAE;CAC1B,MAAM,KAAK,aAAa,KAAK,IAAI;CAGjC,MAAM,UAFQ,KAAK,QAAQ,KAAK,MAAM,GAAG,GAC7B,aAAa,EAAE;CAE3B,MAAM,KAAK,aAAa,UAAU,IAAI;AACtC,QAAO,UAAU,QAAQ,KAAK,MAAM,GAAG;;;AAIzC,MAAM,QAAmB;CACvB,MAAM;CACN,WACE;CACF,cAAc;CACd,SAAS,CAAC,SAAS,eAAe;CAClC,kBAAkB;CAClB,SAAS;CACT,YAAY;CACZ,WAAW;CACX,UAAU,CAAC,iBAAiB;CAC5B;CACA;CACA;CACA;CACD"}

package/dist/fr/tva.d.ts

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