@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/cjs/vehicle/engine-power.js

@@ -0,0 +1,211 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var engine_power_exports = {};
+__export(engine_power_exports, {
+  EnginePower: () => EnginePower,
+  maskEnginePower: () => maskEnginePower
+});
+module.exports = __toCommonJS(engine_power_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_measurement_unit_parser = require("../internal/measurement-unit-parser.js");
+var import_quantity = require("../internal/quantity.js");
+var import_power = require("../measurement/power.js");
+var import_power_unit = require("../measurement/power-unit.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+const HK_PATTERN = /^\s*([0-9][0-9 .,]*[0-9]|[0-9])\s*hk\s*$/iu;
+const APPROXIMATE_PREFIX = /^(?:ca\.?\s+|circa\s+|~\s*|approx\.?\s+|ungefär\s+)/iu;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])\d+[0-9 .,]*\s*hk(?![\p{L}\p{N}_])/giu;
+class EnginePower {
+  static typeInfo = Object.freeze({
+    englishName: "Engine Power",
+    localizedName: "Motoreffekt",
+    emoji: "\u{1F40E}",
+    sources: Object.freeze([])
+  });
+  /** The underlying power value. */
+  powerValue;
+  /** Display form preserving the parsed unit, e.g. `150 hp`. */
+  value;
+  constructor(power, displayValue) {
+    this.powerValue = power;
+    this.value = displayValue ?? power.toString();
+  }
+  get horsepower() {
+    return this.powerValue.horsepower;
+  }
+  get kilowatts() {
+    return this.powerValue.kilowatts;
+  }
+  get watts() {
+    return this.powerValue.watts;
+  }
+  /** Creates an engine power from a value and power unit. The value must be positive. */
+  static create(value, unit) {
+    const amount = value instanceof import_decimal.Decimal ? value : decimalOf(value);
+    if (amount.compareTo(import_decimal.Decimal.zero) <= 0) throw new Error("Engine power must be positive.");
+    return new EnginePower(import_power.Power.create(amount, unit));
+  }
+  static fromHorsepower(value) {
+    return EnginePower.create(value, import_power_unit.PowerUnit.Horsepower);
+  }
+  static fromKilowatts(value) {
+    return EnginePower.create(value, import_power_unit.PowerUnit.Kilowatt);
+  }
+  static fromWatts(value) {
+    return EnginePower.create(value, import_power_unit.PowerUnit.Watt);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim().replace(APPROXIMATE_PREFIX, "");
+    const bare = (0, import_measurement_unit_parser.tryParseNumberOnly)(trimmed);
+    if (bare !== null) return fromHorsepower(bare);
+    const hk = HK_PATTERN.exec(trimmed);
+    if (hk !== null) {
+      const amount = (0, import_measurement_unit_parser.tryParseNumberOnly)(hk[1]);
+      return amount === null ? null : fromHorsepower(amount);
+    }
+    const parsed = import_power.Power.tryParse(trimmed);
+    if (parsed === null || parsed.watts <= 0) return null;
+    return new EnginePower(parsed);
+  }
+  static parse(input) {
+    const result = EnginePower.tryParse(input);
+    if (result === null) throw new Error("Invalid engine power.");
+    return result;
+  }
+  static isValid(input) {
+    return EnginePower.tryParse(input) !== null;
+  }
+  /** Returns the display form, e.g. `150 hp`. Returns `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = EnginePower.tryParse(input);
+    if (parsed !== null) {
+      if (options?.unit !== void 0 || options?.decimals !== void 0) {
+        return parsed.powerValue.toStringInUnit(
+          options.unit ?? parsed.powerValue.originalUnit,
+          options.decimals
+        );
+      }
+      return parsed.value;
+    }
+    return fallback(input, options);
+  }
+  /** Returns the value in watts, e.g. `110000 W`. Returns `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = EnginePower.tryParse(input);
+    if (parsed !== null) return parsed.powerValue.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && EnginePower.normalize(input) === input;
+  }
+  /**
+   * Finds engine power written with the Swedish `hk` suffix. Standard power units
+   * such as `kW` and `hp` are found by {@link Power.findCandidatesInText} instead.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const value = EnginePower.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "EnginePower",
+          category: import_text_candidate_category.TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEnginePower(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Low,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.powerValue.toNormalizedString();
+  }
+  toString() {
+    return this.value;
+  }
+  /** Returns the value in the most readable SI unit, e.g. `1.5 kW` rather than `1500 W`. */
+  toNaturalString(decimals) {
+    return this.powerValue.toNaturalString(decimals);
+  }
+  plus(other) {
+    return new EnginePower(this.powerValue.plus(other.powerValue));
+  }
+  minus(other) {
+    return new EnginePower(this.powerValue.minus(other.powerValue));
+  }
+  times(factor) {
+    return new EnginePower(
+      this.powerValue.times(factor instanceof import_decimal.Decimal ? factor : decimalOf(factor))
+    );
+  }
+  dividedBy(divisor) {
+    return new EnginePower(
+      this.powerValue.dividedBy(divisor instanceof import_decimal.Decimal ? divisor : decimalOf(divisor))
+    );
+  }
+  negated() {
+    return new EnginePower(this.powerValue.negated());
+  }
+  equals(other) {
+    return other != null && this.powerValue.equals(other.powerValue);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.powerValue.compareTo(other.powerValue);
+  }
+  /** @internal Used by the private factories that keep a custom display form. */
+  static _fromDisplay(power, displayValue) {
+    return new EnginePower(power, displayValue);
+  }
+}
+function maskEnginePower(power) {
+  return `*** ${power.powerValue.originalUnit.symbol}`;
+}
+function fromHorsepower(amount) {
+  if (amount.compareTo(import_decimal.Decimal.zero) <= 0) return null;
+  return EnginePower._fromDisplay(
+    import_power.Power.fromHorsepower(amount),
+    `${(0, import_quantity.formatQuantityDecimal)(amount)} ${import_power_unit.PowerUnit.Horsepower.symbol}`
+  );
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function decimalOf(value) {
+  const parsed = import_decimal.Decimal.fromNumber(value);
+  if (parsed === null) throw new Error(`Value cannot be represented as a power: ${value}`);
+  return parsed;
+}
+//# sourceMappingURL=engine-power.js.map

package/dist/cjs/vehicle/engine-power.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/engine-power.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { tryParseNumberOnly } from \"../internal/measurement-unit-parser.js\";\nimport { formatQuantityDecimal } from \"../internal/quantity.js\";\nimport { Power } from \"../measurement/power.js\";\nimport { PowerUnit } from \"../measurement/power-unit.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\n\n/** Options for {@link EnginePower.format} and {@link EnginePower.normalize}. */\nexport interface EnginePowerFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: PowerUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst HK_PATTERN = /^\\s*([0-9][0-9 .,]*[0-9]|[0-9])\\s*hk\\s*$/iu;\nconst APPROXIMATE_PREFIX = /^(?:ca\\.?\\s+|circa\\s+|~\\s*|approx\\.?\\s+|ungef\u00E4r\\s+)/iu;\nconst SCAN_PATTERN = /(?<![\\p{L}\\p{N}_])\\d+[0-9 .,]*\\s*hk(?![\\p{L}\\p{N}_])/giu;\n\n/**\n * Engine power output (`motoreffekt`), e.g. `150 hp`, `110 kW` or the Swedish\n * `150 hk`. A bare number is read as horsepower, and a leading `ca` or `~` is\n * ignored.\n */\nexport class EnginePower {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Engine Power\",\n    localizedName: \"Motoreffekt\",\n    emoji: \"\uD83D\uDC0E\",\n    sources: Object.freeze([]),\n  });\n\n  /** The underlying power value. */\n  readonly powerValue: Power;\n\n  /** Display form preserving the parsed unit, e.g. `150 hp`. */\n  readonly value: string;\n\n  private constructor(power: Power, displayValue?: string) {\n    this.powerValue = power;\n    this.value = displayValue ?? power.toString();\n  }\n\n  get horsepower(): number {\n    return this.powerValue.horsepower;\n  }\n\n  get kilowatts(): number {\n    return this.powerValue.kilowatts;\n  }\n\n  get watts(): number {\n    return this.powerValue.watts;\n  }\n\n  /** Creates an engine power from a value and power unit. The value must be positive. */\n  static create(value: number | Decimal, unit: PowerUnit): EnginePower {\n    const amount = value instanceof Decimal ? value : decimalOf(value);\n    if (amount.compareTo(Decimal.zero) <= 0) throw new Error(\"Engine power must be positive.\");\n    return new EnginePower(Power.create(amount, unit));\n  }\n\n  static fromHorsepower(value: number | Decimal): EnginePower {\n    return EnginePower.create(value, PowerUnit.Horsepower);\n  }\n\n  static fromKilowatts(value: number | Decimal): EnginePower {\n    return EnginePower.create(value, PowerUnit.Kilowatt);\n  }\n\n  static fromWatts(value: number | Decimal): EnginePower {\n    return EnginePower.create(value, PowerUnit.Watt);\n  }\n\n  static tryParse(input: string | null | undefined): EnginePower | null {\n    if (input == null || input.trim().length === 0) return null;\n    const trimmed = sanitizeInput(input).trim().replace(APPROXIMATE_PREFIX, \"\");\n\n    const bare = tryParseNumberOnly(trimmed);\n    if (bare !== null) return fromHorsepower(bare);\n\n    // `hk` is Swedish for horsepower and is not a symbol the Power unit index knows.\n    const hk = HK_PATTERN.exec(trimmed);\n    if (hk !== null) {\n      const amount = tryParseNumberOnly(hk[1]!);\n      return amount === null ? null : fromHorsepower(amount);\n    }\n\n    const parsed = Power.tryParse(trimmed);\n    if (parsed === null || parsed.watts <= 0) return null;\n    return new EnginePower(parsed);\n  }\n\n  static parse(input: string): EnginePower {\n    const result = EnginePower.tryParse(input);\n    if (result === null) throw new Error(\"Invalid engine power.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return EnginePower.tryParse(input) !== null;\n  }\n\n  /** Returns the display form, e.g. `150 hp`. Returns `null` when the input is invalid. */\n  static format(\n    input: string | null | undefined,\n    options?: EnginePowerFormatOptions,\n  ): string | null {\n    const parsed = EnginePower.tryParse(input);\n    if (parsed !== null) {\n      if (options?.unit !== undefined || options?.decimals !== undefined) {\n        return parsed.powerValue.toStringInUnit(\n          options.unit ?? parsed.powerValue.originalUnit,\n          options.decimals,\n        );\n      }\n      return parsed.value;\n    }\n    return fallback(input, options);\n  }\n\n  /** Returns the value in watts, e.g. `110000 W`. Returns `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: EnginePowerFormatOptions,\n  ): string | null {\n    const parsed = EnginePower.tryParse(input);\n    if (parsed !== null) return parsed.powerValue.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && EnginePower.normalize(input) === input;\n  }\n\n  /**\n   * Finds engine power written with the Swedish `hk` suffix. Standard power units\n   * such as `kW` and `hp` are found by {@link Power.findCandidatesInText} instead.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<EnginePower>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<EnginePower>[] = [];\n    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);\n    let match: RegExpExecArray | null;\n\n    while ((match = pattern.exec(text)) !== null) {\n      const value = EnginePower.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<EnginePower>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"EnginePower\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskEnginePower(value),\n          confidence: TextMatchConfidence.Low,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.powerValue.toNormalizedString();\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  /** Returns the value in the most readable SI unit, e.g. `1.5 kW` rather than `1500 W`. */\n  toNaturalString(decimals?: number): string {\n    return this.powerValue.toNaturalString(decimals);\n  }\n\n  plus(other: EnginePower): EnginePower {\n    return new EnginePower(this.powerValue.plus(other.powerValue));\n  }\n\n  minus(other: EnginePower): EnginePower {\n    return new EnginePower(this.powerValue.minus(other.powerValue));\n  }\n\n  times(factor: number | Decimal): EnginePower {\n    return new EnginePower(\n      this.powerValue.times(factor instanceof Decimal ? factor : decimalOf(factor)),\n    );\n  }\n\n  dividedBy(divisor: number | Decimal): EnginePower {\n    return new EnginePower(\n      this.powerValue.dividedBy(divisor instanceof Decimal ? divisor : decimalOf(divisor)),\n    );\n  }\n\n  negated(): EnginePower {\n    return new EnginePower(this.powerValue.negated());\n  }\n\n  equals(other: EnginePower | null | undefined): boolean {\n    return other != null && this.powerValue.equals(other.powerValue);\n  }\n\n  compareTo(other: EnginePower | null | undefined): number {\n    if (other == null) return 1;\n    return this.powerValue.compareTo(other.powerValue);\n  }\n\n  /** @internal Used by the private factories that keep a custom display form. */\n  static _fromDisplay(power: Power, displayValue: string): EnginePower {\n    return new EnginePower(power, displayValue);\n  }\n}\n\n/** Returns a masked engine power, e.g. `150 hp` becomes `*** hp`. */\nexport function maskEnginePower(power: EnginePower): string {\n  return `*** ${power.powerValue.originalUnit.symbol}`;\n}\n\nfunction fromHorsepower(amount: Decimal): EnginePower | null {\n  if (amount.compareTo(Decimal.zero) <= 0) return null;\n  return EnginePower._fromDisplay(\n    Power.fromHorsepower(amount),\n    `${formatQuantityDecimal(amount)} ${PowerUnit.Horsepower.symbol}`,\n  );\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: EnginePowerFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction decimalOf(value: number): Decimal {\n  const parsed = Decimal.fromNumber(value);\n  if (parsed === null) throw new Error(`Value cannot be represented as a power: ${value}`);\n  return parsed;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/vehicle/eu-type-approval-number.js

@@ -0,0 +1,196 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var eu_type_approval_number_exports = {};
+__export(eu_type_approval_number_exports, {
+  EuTypeApprovalNumber: () => EuTypeApprovalNumber,
+  maskEuTypeApprovalNumber: () => maskEuTypeApprovalNumber
+});
+module.exports = __toCommonJS(eu_type_approval_number_exports);
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+const MAX_COUNTRY_CODE = 58;
+const APPROVAL_PATTERN = /^[eE](\d{1,2})\*([0-9/]+)\*(\d+)\*(\d+)$/u;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])[eE]\d{1,2}\*[0-9/]+\*\d+\*\d+(?![\p{L}\p{N}_])/gu;
+const E_MARK_COUNTRIES = Object.freeze({
+  1: "Germany",
+  2: "France",
+  3: "Italy",
+  4: "Netherlands",
+  5: "Sweden",
+  6: "Belgium",
+  7: "Hungary",
+  8: "Czech Republic",
+  9: "Spain",
+  10: "Serbia",
+  11: "United Kingdom",
+  12: "Austria",
+  13: "Luxembourg",
+  14: "Switzerland",
+  16: "Norway",
+  17: "Finland",
+  18: "Denmark",
+  19: "Romania",
+  20: "Poland",
+  21: "Portugal",
+  22: "Russia",
+  23: "Greece",
+  24: "Ireland",
+  25: "Croatia",
+  26: "Slovenia",
+  27: "Slovakia",
+  28: "Belarus",
+  29: "Estonia",
+  31: "Bosnia and Herzegovina",
+  32: "Latvia",
+  34: "Bulgaria",
+  36: "Lithuania",
+  37: "Turkey",
+  39: "Azerbaijan",
+  40: "North Macedonia",
+  42: "EU",
+  43: "Japan",
+  45: "Australia",
+  46: "Ukraine",
+  47: "South Africa",
+  48: "New Zealand",
+  49: "Cyprus",
+  50: "Malta",
+  51: "South Korea",
+  52: "Malaysia",
+  53: "Thailand",
+  54: "Indonesia",
+  56: "Montenegro",
+  57: "San Marino",
+  58: "Tunisia"
+});
+class EuTypeApprovalNumber {
+  static typeInfo = Object.freeze({
+    englishName: "EU Type Approval Number",
+    localizedName: "Typgodk\xE4nnandenummer",
+    emoji: "\u2705",
+    sources: Object.freeze([
+      "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32018R0858",
+      "https://unece.org/transport/vehicle-regulations",
+      "https://www.transportstyrelsen.se/"
+    ])
+  });
+  /** Canonical form, e.g. `e9*2007/46*6364*09`. */
+  value;
+  /** E-mark country code, e.g. `9` for Spain and `5` for Sweden. */
+  approvalCountryCode;
+  /** Country name for the E-mark code, or `null` when the code is unassigned. */
+  approvalCountryName;
+  /** Directive or regulation reference, e.g. `2007/46`. */
+  directive;
+  /** Type approval number, e.g. `6364`. */
+  typeNumber;
+  /** Extension or variant number, e.g. `09`. */
+  extension;
+  constructor(approvalCountryCode, directive, typeNumber, extension) {
+    this.approvalCountryCode = approvalCountryCode;
+    this.approvalCountryName = E_MARK_COUNTRIES[approvalCountryCode] ?? null;
+    this.directive = directive;
+    this.typeNumber = typeNumber;
+    this.extension = extension;
+    this.value = `e${approvalCountryCode}*${directive}*${typeNumber}*${extension}`;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const match = APPROVAL_PATTERN.exec(input.trim());
+    if (match === null) return null;
+    const countryCode = Number(match[1]);
+    if (countryCode < 1 || countryCode > MAX_COUNTRY_CODE) return null;
+    return new EuTypeApprovalNumber(countryCode, match[2], match[3], match[4]);
+  }
+  static parse(input) {
+    const result = EuTypeApprovalNumber.tryParse(input);
+    if (result === null) throw new Error("Invalid EU type-approval number.");
+    return result;
+  }
+  static isValid(input) {
+    return EuTypeApprovalNumber.tryParse(input) !== null;
+  }
+  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */
+  static format(input, options) {
+    const parsed = EuTypeApprovalNumber.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */
+  static normalize(input, options) {
+    const parsed = EuTypeApprovalNumber.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && EuTypeApprovalNumber.normalize(input) === input;
+  }
+  /** Finds type-approval numbers in unstructured text, e.g. `e9*2007/46*6364*09`. */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const value = EuTypeApprovalNumber.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "EuTypeApprovalNumber",
+          category: import_text_candidate_category.TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEuTypeApprovalNumber(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.High,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */
+  toNormalizedString() {
+    return this.value;
+  }
+  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+}
+function maskEuTypeApprovalNumber(approval) {
+  const prefix = `e${approval.approvalCountryCode}`;
+  return prefix + "*".repeat(approval.value.length - prefix.length);
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=eu-type-approval-number.js.map

package/dist/cjs/vehicle/eu-type-approval-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/eu-type-approval-number.ts"],
+  "sourcesContent": ["import type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\n\n/** Options for {@link EuTypeApprovalNumber.format} and `normalize`. */\nexport interface EuTypeApprovalNumberFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MAX_COUNTRY_CODE = 58;\n\nconst APPROVAL_PATTERN = /^[eE](\\d{1,2})\\*([0-9/]+)\\*(\\d+)\\*(\\d+)$/u;\nconst SCAN_PATTERN = /(?<![\\p{L}\\p{N}_])[eE]\\d{1,2}\\*[0-9/]+\\*\\d+\\*\\d+(?![\\p{L}\\p{N}_])/gu;\n\n/** UNECE E-mark country codes. Gaps are codes that have never been assigned. */\nconst E_MARK_COUNTRIES: Readonly<Record<number, string>> = Object.freeze({\n  1: \"Germany\",\n  2: \"France\",\n  3: \"Italy\",\n  4: \"Netherlands\",\n  5: \"Sweden\",\n  6: \"Belgium\",\n  7: \"Hungary\",\n  8: \"Czech Republic\",\n  9: \"Spain\",\n  10: \"Serbia\",\n  11: \"United Kingdom\",\n  12: \"Austria\",\n  13: \"Luxembourg\",\n  14: \"Switzerland\",\n  16: \"Norway\",\n  17: \"Finland\",\n  18: \"Denmark\",\n  19: \"Romania\",\n  20: \"Poland\",\n  21: \"Portugal\",\n  22: \"Russia\",\n  23: \"Greece\",\n  24: \"Ireland\",\n  25: \"Croatia\",\n  26: \"Slovenia\",\n  27: \"Slovakia\",\n  28: \"Belarus\",\n  29: \"Estonia\",\n  31: \"Bosnia and Herzegovina\",\n  32: \"Latvia\",\n  34: \"Bulgaria\",\n  36: \"Lithuania\",\n  37: \"Turkey\",\n  39: \"Azerbaijan\",\n  40: \"North Macedonia\",\n  42: \"EU\",\n  43: \"Japan\",\n  45: \"Australia\",\n  46: \"Ukraine\",\n  47: \"South Africa\",\n  48: \"New Zealand\",\n  49: \"Cyprus\",\n  50: \"Malta\",\n  51: \"South Korea\",\n  52: \"Malaysia\",\n  53: \"Thailand\",\n  54: \"Indonesia\",\n  56: \"Montenegro\",\n  57: \"San Marino\",\n  58: \"Tunisia\",\n});\n\n/**\n * An EU whole-vehicle type-approval number (`typgodk\u00E4nnandenummer`) such as\n * `e9*2007/46*6364*09`: the E-mark country code, the directive or regulation, the\n * type number and the extension.\n *\n * Sources:\n * - https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32018R0858\n * - https://unece.org/transport/vehicle-regulations\n * - https://www.transportstyrelsen.se/\n */\nexport class EuTypeApprovalNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"EU Type Approval Number\",\n    localizedName: \"Typgodk\u00E4nnandenummer\",\n    emoji: \"\u2705\",\n    sources: Object.freeze([\n      \"https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32018R0858\",\n      \"https://unece.org/transport/vehicle-regulations\",\n      \"https://www.transportstyrelsen.se/\",\n    ]),\n  });\n\n  /** Canonical form, e.g. `e9*2007/46*6364*09`. */\n  readonly value: string;\n\n  /** E-mark country code, e.g. `9` for Spain and `5` for Sweden. */\n  readonly approvalCountryCode: number;\n\n  /** Country name for the E-mark code, or `null` when the code is unassigned. */\n  readonly approvalCountryName: string | null;\n\n  /** Directive or regulation reference, e.g. `2007/46`. */\n  readonly directive: string;\n\n  /** Type approval number, e.g. `6364`. */\n  readonly typeNumber: string;\n\n  /** Extension or variant number, e.g. `09`. */\n  readonly extension: string;\n\n  private constructor(\n    approvalCountryCode: number,\n    directive: string,\n    typeNumber: string,\n    extension: string,\n  ) {\n    this.approvalCountryCode = approvalCountryCode;\n    this.approvalCountryName = E_MARK_COUNTRIES[approvalCountryCode] ?? null;\n    this.directive = directive;\n    this.typeNumber = typeNumber;\n    this.extension = extension;\n    this.value = `e${approvalCountryCode}*${directive}*${typeNumber}*${extension}`;\n  }\n\n  static tryParse(input: string | null | undefined): EuTypeApprovalNumber | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const match = APPROVAL_PATTERN.exec(input.trim());\n    if (match === null) return null;\n\n    const countryCode = Number(match[1]);\n    if (countryCode < 1 || countryCode > MAX_COUNTRY_CODE) return null;\n\n    return new EuTypeApprovalNumber(countryCode, match[2]!, match[3]!, match[4]!);\n  }\n\n  static parse(input: string): EuTypeApprovalNumber {\n    const result = EuTypeApprovalNumber.tryParse(input);\n    if (result === null) throw new Error(\"Invalid EU type-approval number.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return EuTypeApprovalNumber.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */\n  static format(\n    input: string | null | undefined,\n    options?: EuTypeApprovalNumberFormatOptions,\n  ): string | null {\n    const parsed = EuTypeApprovalNumber.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: EuTypeApprovalNumberFormatOptions,\n  ): string | null {\n    const parsed = EuTypeApprovalNumber.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && EuTypeApprovalNumber.normalize(input) === input;\n  }\n\n  /** Finds type-approval numbers in unstructured text, e.g. `e9*2007/46*6364*09`. */\n  static findCandidatesInText(text: string): readonly TextCandidate<EuTypeApprovalNumber>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<EuTypeApprovalNumber>[] = [];\n    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);\n    let match: RegExpExecArray | null;\n\n    while ((match = pattern.exec(text)) !== null) {\n      const value = EuTypeApprovalNumber.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<EuTypeApprovalNumber>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"EuTypeApprovalNumber\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskEuTypeApprovalNumber(value),\n          confidence: TextMatchConfidence.High,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  /** Returns the canonical number, e.g. `e9*2007/46*6364*09`. */\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: EuTypeApprovalNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: EuTypeApprovalNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\n/** Returns a masked approval number keeping the e-mark, e.g. `e9*****`. */\nexport function maskEuTypeApprovalNumber(approval: EuTypeApprovalNumber): string {\n  const prefix = `e${approval.approvalCountryCode}`;\n  return prefix + \"*\".repeat(approval.value.length - prefix.length);\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: EuTypeApprovalNumberFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/vehicle/eu-vehicle-category.js

@@ -0,0 +1,167 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var eu_vehicle_category_exports = {};
+__export(eu_vehicle_category_exports, {
+  EuVehicleCategory: () => EuVehicleCategory
+});
+module.exports = __toCommonJS(eu_vehicle_category_exports);
+var import_primitives_defaults = require("../primitives-defaults.js");
+const CATEGORY_PATTERN = /^([MNOLTCRS])(\d)(e)?(-[A-Z]\d?)?(G)?$/iu;
+const KNOWN_CATEGORIES = Object.freeze({
+  M1: ["Passenger vehicle \u22648+1 seats", "Personbil \u22648+1 passagerare"],
+  M2: ["Bus/coach >8+1 seats, \u22645 t", "Buss >8+1 passagerare, \u22645 ton"],
+  M3: ["Bus/coach >8+1 seats, >5 t", "Buss >8+1 passagerare, >5 ton"],
+  N1: ["Light commercial vehicle \u22643.5 t", "L\xE4tt lastbil \u22643,5 ton"],
+  N2: ["Medium goods vehicle 3.5\u201312 t", "Lastbil 3,5\u201312 ton"],
+  N3: ["Heavy goods vehicle >12 t", "Tung lastbil >12 ton"],
+  O1: ["Light trailer \u22640.75 t", "L\xE4tt sl\xE4pvagn \u22640,75 ton"],
+  O2: ["Trailer 0.75\u20133.5 t", "Sl\xE4pvagn 0,75\u20133,5 ton"],
+  O3: ["Trailer 3.5\u201310 t", "Sl\xE4pvagn 3,5\u201310 ton"],
+  O4: ["Heavy trailer >10 t", "Tung sl\xE4pvagn >10 ton"],
+  L1e: ["Two-wheel moped", "Tv\xE5hjulig moped"],
+  L2e: ["Three-wheel moped", "Trehjulig moped"],
+  L3e: ["Two-wheel motorcycle", "Tv\xE5hjulig motorcykel"],
+  L4e: ["Motorcycle with sidecar", "Motorcykel med sidvagn"],
+  L5e: ["Motor tricycle", "Motordriven trehjuling"],
+  L6e: ["Light quadricycle", "L\xE4tt fyrhjuling"],
+  L7e: ["Heavy quadricycle", "Tung fyrhjuling"],
+  T1: ["Standard agricultural tractor", "Standardjordbrukstraktor"],
+  T2: ["Narrow-track tractor", "Smalsp\xE5rig traktor"],
+  T3: ["Low-clearance tractor", "L\xE5gbyggd traktor"],
+  T4: ["Special-purpose tractor", "Specialtraktor"],
+  T5: ["Fast tractor", "Snabb traktor"],
+  C1: ["Track-laying tractor (as T1)", "Bandtraktor (som T1)"],
+  C2: ["Track-laying tractor (as T2)", "Bandtraktor (som T2)"],
+  C3: ["Track-laying tractor (as T3)", "Bandtraktor (som T3)"],
+  C4: ["Track-laying tractor (as T4)", "Bandtraktor (som T4)"],
+  C5: ["Track-laying tractor (as T5)", "Bandtraktor (som T5)"],
+  R1: ["Agricultural trailer \u22641.5 t", "Jordbrukssl\xE4pvagn \u22641,5 ton"],
+  R2: ["Agricultural trailer 1.5\u20133.5 t", "Jordbrukssl\xE4pvagn 1,5\u20133,5 ton"],
+  R3: ["Agricultural trailer 3.5\u201321 t", "Jordbrukssl\xE4pvagn 3,5\u201321 ton"],
+  R4: ["Agricultural trailer >21 t", "Jordbrukssl\xE4pvagn >21 ton"],
+  S1: ["Towed machinery \u22643.5 t", "Utbytbar dragen maskin \u22643,5 ton"],
+  S2: ["Towed machinery >3.5 t", "Utbytbar dragen maskin >3,5 ton"]
+});
+class EuVehicleCategory {
+  static typeInfo = Object.freeze({
+    englishName: "EU Vehicle Category",
+    localizedName: "Fordonskategori",
+    emoji: "\u{1F69B}",
+    sources: Object.freeze([
+      "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32018R0858",
+      "https://www.transportstyrelsen.se/"
+    ])
+  });
+  /** Canonical category code, e.g. `N1`, `M1G` or `L3e-A2`. */
+  value;
+  /** Base category letter, e.g. `M`, `N` or `L`. */
+  baseCategory;
+  /** Numeric part of the category, e.g. `1`. */
+  categoryNumber;
+  /** Optional suffix such as `G` (off-road), `e` (L categories) or `e-A2`. */
+  suffix;
+  /** English description, e.g. `Passenger vehicle ≤8+1 seats`. */
+  englishDescription;
+  /** Swedish description, e.g. `Personbil ≤8+1 passagerare`. */
+  localizedDescription;
+  /** `true` when the `G` suffix marks an off-road variant. */
+  isOffRoad;
+  constructor(baseCategory, categoryNumber, suffix, englishDescription, localizedDescription, isOffRoad) {
+    this.value = `${baseCategory}${categoryNumber}${suffix ?? ""}`;
+    this.baseCategory = baseCategory;
+    this.categoryNumber = categoryNumber;
+    this.suffix = suffix;
+    this.englishDescription = englishDescription;
+    this.localizedDescription = localizedDescription;
+    this.isOffRoad = isOffRoad;
+  }
+  /** The description in the configured display language. */
+  get description() {
+    return import_primitives_defaults.PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedDescription : this.englishDescription;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const match = CATEGORY_PATTERN.exec(input.trim());
+    if (match === null) return null;
+    const baseLetter = match[1].toUpperCase();
+    const number = Number(match[2]);
+    const hasE = match[3] !== void 0;
+    const subSuffix = match[4]?.toUpperCase() ?? null;
+    const hasG = match[5] !== void 0;
+    if (baseLetter === "L" && !hasE) return null;
+    if (baseLetter !== "L" && hasE) return null;
+    if (hasG && baseLetter !== "M" && baseLetter !== "N") return null;
+    if (subSuffix !== null && !hasE) return null;
+    const descriptions = KNOWN_CATEGORIES[hasE ? `${baseLetter}${number}e` : `${baseLetter}${number}`];
+    if (descriptions === void 0) return null;
+    const suffix = hasE ? subSuffix !== null ? `e${subSuffix}` : "e" : hasG ? "G" : null;
+    return new EuVehicleCategory(
+      baseLetter,
+      number,
+      suffix,
+      hasG ? `${descriptions[0]} (off-road)` : descriptions[0],
+      hasG ? `${descriptions[1]} (terr\xE4ngfordon)` : descriptions[1],
+      hasG
+    );
+  }
+  static parse(input) {
+    const result = EuVehicleCategory.tryParse(input);
+    if (result === null) throw new Error("Invalid EU vehicle category.");
+    return result;
+  }
+  static isValid(input) {
+    return EuVehicleCategory.tryParse(input) !== null;
+  }
+  /** Returns the description, e.g. `Passenger vehicle ≤8+1 seats`. */
+  static format(input, options) {
+    const parsed = EuVehicleCategory.tryParse(input);
+    if (parsed !== null) return parsed.description;
+    return fallback(input, options);
+  }
+  /** Returns the canonical category code, e.g. `M1`. */
+  static normalize(input, options) {
+    const parsed = EuVehicleCategory.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && EuVehicleCategory.normalize(input) === input;
+  }
+  /** Returns the canonical category code, e.g. `M1`. */
+  toNormalizedString() {
+    return this.value;
+  }
+  /** Returns the canonical category code, e.g. `M1`. */
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=eu-vehicle-category.js.map