@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/vehicle/energy-consumption.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/energy-consumption.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 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 EnergyConsumption.format} and {@link EnergyConsumption.normalize}. */\nexport interface EnergyConsumptionFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst KILOMETRES_PER_MILE = Decimal.parse(\"1.609344\")!;\nconst HUNDRED = Decimal.parse(\"100\")!;\nconst TEN = Decimal.parse(\"10\")!;\nconst CONVERSION_PRECISION = 6;\n\nconst PATTERN =\n  /^\\s*([0-9][0-9 .,]*[0-9]|[0-9])\\s*(kWh\\/100\\s*km|kWh\\/km|Wh\\/km|mi\\/kWh|miles\\/kWh|kWh\\/mi|kWh\\/mile)\\s*$/iu;\n\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])\\d+[0-9 .,]*\\s*(?:kWh\\/100\\s*km|kWh\\/km|Wh\\/km|mi\\/kWh|miles\\/kWh|kWh\\/mi|kWh\\/mile)(?![\\p{L}\\p{N}_])/giu;\n\n/**\n * Electric vehicle energy consumption (`elf\u00F6rbrukning`), held as kWh per 100 km.\n * Accepts `kWh/100km`, `kWh/km`, `Wh/km` and the US `mi/kWh` and `kWh/mi`; a bare\n * number is read as kWh per 100 km.\n *\n * Sources:\n * - https://en.wikipedia.org/wiki/Fuel_economy_in_electric_vehicles\n * - https://www.energimyndigheten.se/\n */\nexport class EnergyConsumption {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Energy Consumption\",\n    localizedName: \"Elf\u00F6rbrukning\",\n    emoji: \"\uD83D\uDD0C\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/Fuel_economy_in_electric_vehicles\",\n      \"https://www.energimyndigheten.se/\",\n    ]),\n  });\n\n  /** Display form preserving the parsed unit, e.g. `150 Wh/km`. */\n  readonly value: string;\n\n  /** The unit the value was parsed from, e.g. `kWh/100km` or `mi/kWh`. */\n  readonly originalUnit: string;\n\n  private readonly exactKwhPer100Km: Decimal;\n\n  private constructor(kwhPer100Km: Decimal, displayUnit: string, value: string) {\n    this.exactKwhPer100Km = kwhPer100Km;\n    this.originalUnit = displayUnit;\n    this.value = value;\n  }\n\n  /** Consumption in kilowatt-hours per 100 km, e.g. `15` for a typical EV. */\n  get kwhPer100Km(): number {\n    return this.exactKwhPer100Km.toNumber();\n  }\n\n  /** Consumption in kilowatt-hours per km, e.g. `0.15` for 15 kWh/100km. */\n  get kwhPerKm(): number {\n    return round(this.exactKwhPer100Km.dividedBy(HUNDRED)).toNumber();\n  }\n\n  /** Consumption in watt-hours per km, e.g. `150` for 15 kWh/100km. */\n  get whPerKm(): number {\n    return round(this.exactKwhPer100Km.times(TEN)).toNumber();\n  }\n\n  /** Energy economy in US miles per kilowatt-hour, e.g. `4.13` for 15 kWh/100km. */\n  get milesPerKwh(): number {\n    if (this.exactKwhPer100Km.compareTo(Decimal.zero) <= 0) return 0;\n    return round(HUNDRED.dividedBy(this.exactKwhPer100Km.times(KILOMETRES_PER_MILE))).toNumber();\n  }\n\n  /** Consumption in kilowatt-hours per mile, e.g. `0.241` for 15 kWh/100km. */\n  get kwhPerMile(): number {\n    return round(this.exactKwhPer100Km.times(KILOMETRES_PER_MILE).dividedBy(HUNDRED)).toNumber();\n  }\n\n  static fromKwhPer100Km(value: number | Decimal): EnergyConsumption {\n    const amount = positive(value);\n    return new EnergyConsumption(amount, \"kWh/100km\", `${formatQuantityDecimal(amount)} kWh/100km`);\n  }\n\n  static fromWhPerKm(value: number | Decimal): EnergyConsumption {\n    const amount = positive(value);\n    return new EnergyConsumption(\n      round(amount.dividedBy(TEN)),\n      \"Wh/km\",\n      `${formatQuantityDecimal(amount)} Wh/km`,\n    );\n  }\n\n  static fromKwhPerKm(value: number | Decimal): EnergyConsumption {\n    const amount = positive(value);\n    return new EnergyConsumption(\n      round(amount.times(HUNDRED)),\n      \"kWh/km\",\n      `${formatQuantityDecimal(amount)} kWh/km`,\n    );\n  }\n\n  static fromMilesPerKwh(value: number | Decimal): EnergyConsumption {\n    const amount = positive(value);\n    return new EnergyConsumption(\n      round(HUNDRED.dividedBy(amount.times(KILOMETRES_PER_MILE))),\n      \"mi/kWh\",\n      `${formatQuantityDecimal(amount)} mi/kWh`,\n    );\n  }\n\n  static fromKwhPerMile(value: number | Decimal): EnergyConsumption {\n    const amount = positive(value);\n    return new EnergyConsumption(\n      round(amount.times(HUNDRED).dividedBy(KILOMETRES_PER_MILE)),\n      \"kWh/mi\",\n      `${formatQuantityDecimal(amount)} kWh/mi`,\n    );\n  }\n\n  private static fromUnit(amount: Decimal, unitRaw: string): EnergyConsumption | null {\n    const unit = unitRaw.toLowerCase().replaceAll(\" \", \"\");\n\n    switch (unit) {\n      case \"kwh/100km\":\n        return new EnergyConsumption(\n          amount,\n          \"kWh/100km\",\n          `${formatQuantityDecimal(amount)} kWh/100km`,\n        );\n      case \"kwh/km\":\n        return new EnergyConsumption(\n          round(amount.times(HUNDRED)),\n          \"kWh/km\",\n          `${formatQuantityDecimal(amount)} kWh/km`,\n        );\n      case \"wh/km\":\n        return new EnergyConsumption(\n          round(amount.dividedBy(TEN)),\n          \"Wh/km\",\n          `${formatQuantityDecimal(amount)} Wh/km`,\n        );\n      case \"mi/kwh\":\n      case \"miles/kwh\":\n        return new EnergyConsumption(\n          round(HUNDRED.dividedBy(amount.times(KILOMETRES_PER_MILE))),\n          \"mi/kWh\",\n          `${formatQuantityDecimal(amount)} mi/kWh`,\n        );\n      case \"kwh/mi\":\n      case \"kwh/mile\":\n        return new EnergyConsumption(\n          round(amount.times(HUNDRED).dividedBy(KILOMETRES_PER_MILE)),\n          \"kWh/mi\",\n          `${formatQuantityDecimal(amount)} kWh/mi`,\n        );\n      default:\n        return null;\n    }\n  }\n\n  static tryParse(input: string | null | undefined): EnergyConsumption | null {\n    if (input == null || input.trim().length === 0) return null;\n    const trimmed = sanitizeInput(input).trim();\n\n    const match = PATTERN.exec(trimmed);\n    if (match !== null) {\n      const amount = tryParseNumberOnly(match[1]!);\n      if (amount === null || amount.compareTo(Decimal.zero) <= 0) return null;\n      return EnergyConsumption.fromUnit(amount, match[2]!);\n    }\n\n    const bare = tryParseNumberOnly(trimmed);\n    if (bare === null || bare.compareTo(Decimal.zero) <= 0) return null;\n    return new EnergyConsumption(bare, \"kWh/100km\", `${formatQuantityDecimal(bare)} kWh/100km`);\n  }\n\n  static parse(input: string): EnergyConsumption {\n    const result = EnergyConsumption.tryParse(input);\n    if (result === null) throw new Error(\"Invalid energy consumption.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return EnergyConsumption.tryParse(input) !== null;\n  }\n\n  /** Returns the display form in the parsed unit, e.g. `4 mi/kWh`. */\n  static format(\n    input: string | null | undefined,\n    options?: EnergyConsumptionFormatOptions,\n  ): string | null {\n    const parsed = EnergyConsumption.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the value in kWh/100km, e.g. `15 kWh/100km`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: EnergyConsumptionFormatOptions,\n  ): string | null {\n    const parsed = EnergyConsumption.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && EnergyConsumption.normalize(input) === input;\n  }\n\n  /** Finds energy consumption values in unstructured text, e.g. `150 Wh/km`. */\n  static findCandidatesInText(text: string): readonly TextCandidate<EnergyConsumption>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<EnergyConsumption>[] = [];\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 = EnergyConsumption.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<EnergyConsumption>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"EnergyConsumption\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskEnergyConsumption(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the value in kWh/100km, e.g. `15 kWh/100km`. */\n  toNormalizedString(): string {\n    return `${formatQuantityDecimal(this.exactKwhPer100Km)} kWh/100km`;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: EnergyConsumption | null | undefined): boolean {\n    return other != null && this.exactKwhPer100Km.equals(other.exactKwhPer100Km);\n  }\n\n  compareTo(other: EnergyConsumption | null | undefined): number {\n    if (other == null) return 1;\n    return this.exactKwhPer100Km.compareTo(other.exactKwhPer100Km);\n  }\n}\n\n/** Returns a masked energy consumption, e.g. `15 kWh/100km` becomes `*** kWh/100km`. */\nexport function maskEnergyConsumption(consumption: EnergyConsumption): string {\n  const separator = consumption.value.indexOf(\" \");\n  if (separator < 0) return \"*\".repeat(consumption.value.length);\n  return `*** ${consumption.value.slice(separator + 1)}`;\n}\n\nfunction round(value: Decimal): Decimal {\n  return value.round(CONVERSION_PRECISION, \"half-even\");\n}\n\nfunction positive(value: number | Decimal): Decimal {\n  const amount = value instanceof Decimal ? value : Decimal.fromNumber(value);\n  if (amount === null) throw new Error(`Value cannot be represented as a consumption: ${value}`);\n  if (amount.compareTo(Decimal.zero) <= 0) throw new Error(\"Value must be positive.\");\n  return amount;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: EnergyConsumptionFormatOptions,\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/esm/vehicle/engine-displacement.js

@@ -0,0 +1,149 @@
+import { Decimal } from "../internal/decimal.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { tryParseNumberOnly } from "../internal/measurement-unit-parser.js";
+import { formatQuantityDecimal } from "../internal/quantity.js";
+import { Volume } from "../measurement/volume.js";
+import { VolumeUnit } from "../measurement/volume-unit.js";
+class EngineDisplacement {
+  static typeInfo = Object.freeze({
+    englishName: "Engine Displacement",
+    localizedName: "Motorvolym",
+    emoji: "\u{1F529}",
+    sources: Object.freeze([])
+  });
+  /** The underlying volume. */
+  displacement;
+  /** Display form preserving the parsed unit, e.g. `1998 mL`. */
+  value;
+  constructor(displacement, displayValue) {
+    this.displacement = displacement;
+    this.value = displayValue ?? displacement.toString();
+  }
+  /** Displacement in cubic centimetres (cc), which are millilitres. */
+  get cubicCentimeters() {
+    return this.displacement.milliliters;
+  }
+  /** Displacement in litres. */
+  get liters() {
+    return this.displacement.liters;
+  }
+  /** Creates a displacement from a value and volume unit. The value must be positive. */
+  static create(value, unit) {
+    const amount = value instanceof Decimal ? value : decimalOf(value);
+    if (amount.compareTo(Decimal.zero) <= 0) {
+      throw new Error("Engine displacement must be positive.");
+    }
+    return new EngineDisplacement(Volume.create(amount, unit));
+  }
+  static fromCubicCentimeters(value) {
+    return EngineDisplacement.create(value, VolumeUnit.Milliliter);
+  }
+  static fromLiters(value) {
+    return EngineDisplacement.create(value, VolumeUnit.Liter);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = sanitizeInput(input).trim();
+    const bare = tryParseNumberOnly(trimmed);
+    if (bare !== null) {
+      if (bare.compareTo(Decimal.zero) <= 0) return null;
+      return new EngineDisplacement(
+        Volume.fromMilliliters(bare),
+        `${formatQuantityDecimal(bare)} mL`
+      );
+    }
+    if (trimmed.toLowerCase().endsWith("cc")) {
+      const amount = tryParseNumberOnly(trimmed.slice(0, -2).trim());
+      if (amount !== null && amount.compareTo(Decimal.zero) > 0) {
+        return new EngineDisplacement(
+          Volume.fromMilliliters(amount),
+          `${formatQuantityDecimal(amount)} mL`
+        );
+      }
+    }
+    const parsed = Volume.tryParse(trimmed);
+    if (parsed === null || parsed.liters <= 0) return null;
+    return new EngineDisplacement(parsed);
+  }
+  static parse(input) {
+    const result = EngineDisplacement.tryParse(input);
+    if (result === null) throw new Error("Invalid engine displacement.");
+    return result;
+  }
+  static isValid(input) {
+    return EngineDisplacement.tryParse(input) !== null;
+  }
+  /** Returns the display form, e.g. `1998 mL`. Returns `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = EngineDisplacement.tryParse(input);
+    if (parsed !== null) {
+      if (options?.unit !== void 0 || options?.decimals !== void 0) {
+        return parsed.displacement.toStringInUnit(
+          options.unit ?? parsed.displacement.originalUnit,
+          options.decimals
+        );
+      }
+      return parsed.value;
+    }
+    return fallback(input, options);
+  }
+  /** Returns the value in litres, e.g. `1.998 L`. Returns `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = EngineDisplacement.tryParse(input);
+    if (parsed !== null) return parsed.displacement.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && EngineDisplacement.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.displacement.toNormalizedString();
+  }
+  toString() {
+    return this.value;
+  }
+  /** Returns the value in the most readable metric unit, e.g. `2 L` rather than `2000 mL`. */
+  toNaturalString(decimals) {
+    return this.displacement.toNaturalString(decimals);
+  }
+  plus(other) {
+    return new EngineDisplacement(this.displacement.plus(other.displacement));
+  }
+  minus(other) {
+    return new EngineDisplacement(this.displacement.minus(other.displacement));
+  }
+  times(factor) {
+    return new EngineDisplacement(
+      this.displacement.times(factor instanceof Decimal ? factor : decimalOf(factor))
+    );
+  }
+  dividedBy(divisor) {
+    return new EngineDisplacement(
+      this.displacement.dividedBy(divisor instanceof Decimal ? divisor : decimalOf(divisor))
+    );
+  }
+  negated() {
+    return new EngineDisplacement(this.displacement.negated());
+  }
+  equals(other) {
+    return other != null && this.displacement.equals(other.displacement);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.displacement.compareTo(other.displacement);
+  }
+}
+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 = Decimal.fromNumber(value);
+  if (parsed === null) throw new Error(`Value cannot be represented as a displacement: ${value}`);
+  return parsed;
+}
+export {
+  EngineDisplacement
+};
+//# sourceMappingURL=engine-displacement.js.map

package/dist/esm/vehicle/engine-displacement.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/engine-displacement.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 { Volume } from \"../measurement/volume.js\";\nimport { VolumeUnit } from \"../measurement/volume-unit.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options for {@link EngineDisplacement.format} and {@link EngineDisplacement.normalize}. */\nexport interface EngineDisplacementFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: VolumeUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\n/**\n * Engine displacement (`motorvolym` / `slagvolym`), e.g. `1998 mL` or `2.0 L`.\n * A bare number is read as cubic centimetres, which are the same as millilitres.\n */\nexport class EngineDisplacement {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Engine Displacement\",\n    localizedName: \"Motorvolym\",\n    emoji: \"\uD83D\uDD29\",\n    sources: Object.freeze([]),\n  });\n\n  /** The underlying volume. */\n  readonly displacement: Volume;\n\n  /** Display form preserving the parsed unit, e.g. `1998 mL`. */\n  readonly value: string;\n\n  private constructor(displacement: Volume, displayValue?: string) {\n    this.displacement = displacement;\n    this.value = displayValue ?? displacement.toString();\n  }\n\n  /** Displacement in cubic centimetres (cc), which are millilitres. */\n  get cubicCentimeters(): number {\n    return this.displacement.milliliters;\n  }\n\n  /** Displacement in litres. */\n  get liters(): number {\n    return this.displacement.liters;\n  }\n\n  /** Creates a displacement from a value and volume unit. The value must be positive. */\n  static create(value: number | Decimal, unit: VolumeUnit): EngineDisplacement {\n    const amount = value instanceof Decimal ? value : decimalOf(value);\n    if (amount.compareTo(Decimal.zero) <= 0) {\n      throw new Error(\"Engine displacement must be positive.\");\n    }\n    return new EngineDisplacement(Volume.create(amount, unit));\n  }\n\n  static fromCubicCentimeters(value: number | Decimal): EngineDisplacement {\n    return EngineDisplacement.create(value, VolumeUnit.Milliliter);\n  }\n\n  static fromLiters(value: number | Decimal): EngineDisplacement {\n    return EngineDisplacement.create(value, VolumeUnit.Liter);\n  }\n\n  static tryParse(input: string | null | undefined): EngineDisplacement | null {\n    if (input == null || input.trim().length === 0) return null;\n    const trimmed = sanitizeInput(input).trim();\n\n    const bare = tryParseNumberOnly(trimmed);\n    if (bare !== null) {\n      if (bare.compareTo(Decimal.zero) <= 0) return null;\n      return new EngineDisplacement(\n        Volume.fromMilliliters(bare),\n        `${formatQuantityDecimal(bare)} mL`,\n      );\n    }\n\n    // `cc` is not a volume unit symbol, but it is the conventional spelling here.\n    if (trimmed.toLowerCase().endsWith(\"cc\")) {\n      const amount = tryParseNumberOnly(trimmed.slice(0, -2).trim());\n      if (amount !== null && amount.compareTo(Decimal.zero) > 0) {\n        return new EngineDisplacement(\n          Volume.fromMilliliters(amount),\n          `${formatQuantityDecimal(amount)} mL`,\n        );\n      }\n    }\n\n    const parsed = Volume.tryParse(trimmed);\n    if (parsed === null || parsed.liters <= 0) return null;\n    return new EngineDisplacement(parsed);\n  }\n\n  static parse(input: string): EngineDisplacement {\n    const result = EngineDisplacement.tryParse(input);\n    if (result === null) throw new Error(\"Invalid engine displacement.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return EngineDisplacement.tryParse(input) !== null;\n  }\n\n  /** Returns the display form, e.g. `1998 mL`. Returns `null` when the input is invalid. */\n  static format(\n    input: string | null | undefined,\n    options?: EngineDisplacementFormatOptions,\n  ): string | null {\n    const parsed = EngineDisplacement.tryParse(input);\n    if (parsed !== null) {\n      if (options?.unit !== undefined || options?.decimals !== undefined) {\n        return parsed.displacement.toStringInUnit(\n          options.unit ?? parsed.displacement.originalUnit,\n          options.decimals,\n        );\n      }\n      return parsed.value;\n    }\n    return fallback(input, options);\n  }\n\n  /** Returns the value in litres, e.g. `1.998 L`. Returns `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: EngineDisplacementFormatOptions,\n  ): string | null {\n    const parsed = EngineDisplacement.tryParse(input);\n    if (parsed !== null) return parsed.displacement.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && EngineDisplacement.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.displacement.toNormalizedString();\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  /** Returns the value in the most readable metric unit, e.g. `2 L` rather than `2000 mL`. */\n  toNaturalString(decimals?: number): string {\n    return this.displacement.toNaturalString(decimals);\n  }\n\n  plus(other: EngineDisplacement): EngineDisplacement {\n    return new EngineDisplacement(this.displacement.plus(other.displacement));\n  }\n\n  minus(other: EngineDisplacement): EngineDisplacement {\n    return new EngineDisplacement(this.displacement.minus(other.displacement));\n  }\n\n  times(factor: number | Decimal): EngineDisplacement {\n    return new EngineDisplacement(\n      this.displacement.times(factor instanceof Decimal ? factor : decimalOf(factor)),\n    );\n  }\n\n  dividedBy(divisor: number | Decimal): EngineDisplacement {\n    return new EngineDisplacement(\n      this.displacement.dividedBy(divisor instanceof Decimal ? divisor : decimalOf(divisor)),\n    );\n  }\n\n  negated(): EngineDisplacement {\n    return new EngineDisplacement(this.displacement.negated());\n  }\n\n  equals(other: EngineDisplacement | null | undefined): boolean {\n    return other != null && this.displacement.equals(other.displacement);\n  }\n\n  compareTo(other: EngineDisplacement | null | undefined): number {\n    if (other == null) return 1;\n    return this.displacement.compareTo(other.displacement);\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: EngineDisplacementFormatOptions,\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 displacement: ${value}`);\n  return parsed;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,191 @@
+import { Decimal } from "../internal/decimal.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { tryParseNumberOnly } from "../internal/measurement-unit-parser.js";
+import { formatQuantityDecimal } from "../internal/quantity.js";
+import { Power } from "../measurement/power.js";
+import { PowerUnit } from "../measurement/power-unit.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextMatchConfidence } from "../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 Decimal ? value : decimalOf(value);
+    if (amount.compareTo(Decimal.zero) <= 0) throw new Error("Engine power must be positive.");
+    return new EnginePower(Power.create(amount, unit));
+  }
+  static fromHorsepower(value) {
+    return EnginePower.create(value, PowerUnit.Horsepower);
+  }
+  static fromKilowatts(value) {
+    return EnginePower.create(value, PowerUnit.Kilowatt);
+  }
+  static fromWatts(value) {
+    return EnginePower.create(value, PowerUnit.Watt);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = sanitizeInput(input).trim().replace(APPROXIMATE_PREFIX, "");
+    const bare = tryParseNumberOnly(trimmed);
+    if (bare !== null) return fromHorsepower(bare);
+    const hk = HK_PATTERN.exec(trimmed);
+    if (hk !== null) {
+      const amount = tryParseNumberOnly(hk[1]);
+      return amount === null ? null : fromHorsepower(amount);
+    }
+    const parsed = 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 TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "EnginePower",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEnginePower(value),
+          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 Decimal ? factor : decimalOf(factor))
+    );
+  }
+  dividedBy(divisor) {
+    return new EnginePower(
+      this.powerValue.dividedBy(divisor instanceof 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(Decimal.zero) <= 0) return null;
+  return EnginePower._fromDisplay(
+    Power.fromHorsepower(amount),
+    `${formatQuantityDecimal(amount)} ${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 = Decimal.fromNumber(value);
+  if (parsed === null) throw new Error(`Value cannot be represented as a power: ${value}`);
+  return parsed;
+}
+export {
+  EnginePower,
+  maskEnginePower
+};
+//# sourceMappingURL=engine-power.js.map

package/dist/esm/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/esm/vehicle/eu-type-approval-number.js

@@ -0,0 +1,176 @@
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextMatchConfidence } from "../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 TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "EuTypeApprovalNumber",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEuTypeApprovalNumber(value),
+          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;
+}
+export {
+  EuTypeApprovalNumber,
+  maskEuTypeApprovalNumber
+};
+//# sourceMappingURL=eu-type-approval-number.js.map

package/dist/esm/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": "AACA,SAAS,qBAAqB;AAC9B,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AAOpC,MAAM,mBAAmB;AAEzB,MAAM,mBAAmB;AACzB,MAAM,eAAe;AAGrB,MAAM,mBAAqD,OAAO,OAAO;AAAA,EACvE,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN,CAAC;AAYM,MAAM,qBAAqB;AAAA,EAChC,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAED,YACN,qBACA,WACA,YACA,WACA;AACA,SAAK,sBAAsB;AAC3B,SAAK,sBAAsB,iBAAiB,mBAAmB,KAAK;AACpE,SAAK,YAAY;AACjB,SAAK,aAAa;AAClB,SAAK,YAAY;AACjB,SAAK,QAAQ,IAAI,mBAAmB,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS;AAAA,EAC9E;AAAA,EAEA,OAAO,SAAS,OAA+D;AAC7E,QAAI,SAAS,QAAQ,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AAEvD,UAAM,QAAQ,iBAAiB,KAAK,MAAM,KAAK,CAAC;AAChD,QAAI,UAAU,KAAM,QAAO;AAE3B,UAAM,cAAc,OAAO,MAAM,CAAC,CAAC;AACnC,QAAI,cAAc,KAAK,cAAc,iBAAkB,QAAO;AAE9D,WAAO,IAAI,qBAAqB,aAAa,MAAM,CAAC,GAAI,MAAM,CAAC,GAAI,MAAM,CAAC,CAAE;AAAA,EAC9E;AAAA,EAEA,OAAO,MAAM,OAAqC;AAChD,UAAM,SAAS,qBAAqB,SAAS,KAAK;AAClD,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,kCAAkC;AACvE,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,qBAAqB,SAAS,KAAK,MAAM;AAAA,EAClD;AAAA;AAAA,EAGA,OAAO,OACL,OACA,SACe;AACf,UAAM,SAAS,qBAAqB,SAAS,KAAK;AAClD,QAAI,WAAW,KAAM,QAAO,OAAO;AACnC,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,UACL,OACA,SACe;AACf,UAAM,SAAS,qBAAqB,SAAS,KAAK;AAClD,QAAI,WAAW,KAAM,QAAO,OAAO;AACnC,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,qBAAqB,UAAU,KAAK,MAAM;AAAA,EACpE;AAAA;AAAA,EAGA,OAAO,qBAAqB,MAA8D;AACxF,QAAI,CAAC,KAAM,QAAO,CAAC;AAEnB,UAAM,MAA6C,CAAC;AACpD,UAAM,UAAU,IAAI,OAAO,aAAa,QAAQ,aAAa,KAAK;AAClE,QAAI;AAEJ,YAAQ,QAAQ,QAAQ,KAAK,IAAI,OAAO,MAAM;AAC5C,YAAM,QAAQ,qBAAqB,SAAS,MAAM,CAAC,CAAC;AACpD,UAAI,UAAU,KAAM;AACpB,UAAI;AAAA,QACF,IAAI,cAAoC;AAAA,UACtC,YAAY,MAAM;AAAA,UAClB,QAAQ,MAAM,CAAC,EAAE;AAAA,UACjB,cAAc,MAAM,CAAC;AAAA,UACrB,UAAU;AAAA,UACV,UAAU,sBAAsB;AAAA,UAChC,gBAAgB,MAAM,mBAAmB;AAAA,UACzC,eAAe,MAAM,SAAS;AAAA,UAC9B,YAAY,yBAAyB,KAAK;AAAA,UAC1C,YAAY,oBAAoB;AAAA,UAChC;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAyD;AAC9D,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EAEA,UAAU,OAAwD;AAChE,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;AAGO,SAAS,yBAAyB,UAAwC;AAC/E,QAAM,SAAS,IAAI,SAAS,mBAAmB;AAC/C,SAAO,SAAS,IAAI,OAAO,SAAS,MAAM,SAAS,OAAO,MAAM;AAClE;AAEA,SAAS,SACP,OACA,SACe;AACf,MAAI,SAAS,sCAAsC,QAAQ,SAAS,KAAM,QAAO;AACjF,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;",
+  "names": []
+}