@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/cjs/vehicle/fuel-consumption.js

@@ -0,0 +1,281 @@
+"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 fuel_consumption_exports = {};
+__export(fuel_consumption_exports, {
+  FuelConsumption: () => FuelConsumption,
+  maskFuelConsumption: () => maskFuelConsumption
+});
+module.exports = __toCommonJS(fuel_consumption_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_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 MPG_US_CONVERSION = import_decimal.Decimal.parse("235.214583");
+const MPG_IMP_CONVERSION = import_decimal.Decimal.parse("282.481");
+const HUNDRED = import_decimal.Decimal.parse("100");
+const TEN = import_decimal.Decimal.parse("10");
+const CONVERSION_PRECISION = 6;
+const PATTERN = /^\s*([0-9][0-9 .,]*[0-9]|[0-9])\s*(l\/100\s*km|liter\/100\s*km|km\/l|km\/liter|mpg(?:\s*\(imp\))?|miles\s*per\s*gallon|kWh\/100\s*km|kWh\/km|Wh\/km)\s*$/iu;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])\d+[0-9 .,]*\s*(?:l\/100\s*km|liter\/100\s*km|km\/l|km\/liter|mpg|kWh\/100\s*km|kWh\/km|Wh\/km)(?![\p{L}\p{N}_])/giu;
+class FuelConsumption {
+  static typeInfo = Object.freeze({
+    englishName: "Fuel Consumption",
+    localizedName: "Br\xE4nslef\xF6rbrukning",
+    emoji: "\u26FD",
+    sources: Object.freeze(["https://en.wikipedia.org/wiki/Fuel_economy_in_automobiles"])
+  });
+  /** Display form preserving the parsed unit, e.g. `8.3 l/100km`. */
+  value;
+  exactLitersPer100Km;
+  exactKwhPer100Km;
+  electric;
+  constructor(litersPer100Km, kwhPer100Km, isElectric, value) {
+    this.exactLitersPer100Km = litersPer100Km;
+    this.exactKwhPer100Km = kwhPer100Km;
+    this.electric = isElectric;
+    this.value = value;
+  }
+  /** Consumption in litres per 100 km. Zero for electric vehicles. */
+  get litersPer100Km() {
+    return this.exactLitersPer100Km.toNumber();
+  }
+  /** Fuel economy in kilometres per litre. Zero for electric vehicles. */
+  get kilometersPerLiter() {
+    return this.reciprocal(HUNDRED);
+  }
+  /** Fuel economy in US miles per gallon. Zero for electric vehicles. */
+  get milesPerGallonUs() {
+    return this.reciprocal(MPG_US_CONVERSION);
+  }
+  /** Fuel economy in imperial miles per gallon. Zero for electric vehicles. */
+  get milesPerGallonImp() {
+    return this.reciprocal(MPG_IMP_CONVERSION);
+  }
+  /** Electric consumption in kWh per 100 km. Zero for combustion vehicles. */
+  get kwhPer100Km() {
+    return this.exactKwhPer100Km.toNumber();
+  }
+  /** `true` when the value came from a kWh-based unit. */
+  get isElectric() {
+    return this.electric;
+  }
+  static fromLitersPer100Km(value) {
+    const amount = positive(value);
+    return new FuelConsumption(
+      amount,
+      import_decimal.Decimal.zero,
+      false,
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} l/100km`
+    );
+  }
+  static fromKilometersPerLiter(value) {
+    const amount = positive(value);
+    return new FuelConsumption(
+      convert(HUNDRED, amount),
+      import_decimal.Decimal.zero,
+      false,
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} km/l`
+    );
+  }
+  static fromMpgUs(value) {
+    const amount = positive(value);
+    return new FuelConsumption(
+      convert(MPG_US_CONVERSION, amount),
+      import_decimal.Decimal.zero,
+      false,
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} mpg`
+    );
+  }
+  static fromKwhPer100Km(value) {
+    const amount = positive(value);
+    return new FuelConsumption(
+      import_decimal.Decimal.zero,
+      amount,
+      true,
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/100km`
+    );
+  }
+  static fromUnit(amount, unitRaw) {
+    const unit = unitRaw.toLowerCase().replaceAll(" ", "");
+    switch (unit) {
+      case "l/100km":
+      case "liter/100km":
+        return new FuelConsumption(
+          amount,
+          import_decimal.Decimal.zero,
+          false,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} l/100km`
+        );
+      case "km/l":
+      case "km/liter":
+        return new FuelConsumption(
+          convert(HUNDRED, amount),
+          import_decimal.Decimal.zero,
+          false,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} km/l`
+        );
+      case "mpg":
+      case "milespergallon":
+        return new FuelConsumption(
+          convert(MPG_US_CONVERSION, amount),
+          import_decimal.Decimal.zero,
+          false,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} mpg`
+        );
+      case "mpg(imp)":
+        return new FuelConsumption(
+          convert(MPG_IMP_CONVERSION, amount),
+          import_decimal.Decimal.zero,
+          false,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} mpg (imp)`
+        );
+      case "kwh/100km":
+        return new FuelConsumption(
+          import_decimal.Decimal.zero,
+          amount,
+          true,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/100km`
+        );
+      case "kwh/km":
+        return new FuelConsumption(
+          import_decimal.Decimal.zero,
+          round(amount.times(HUNDRED)),
+          true,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/km`
+        );
+      case "wh/km":
+        return new FuelConsumption(
+          import_decimal.Decimal.zero,
+          convert(amount, TEN),
+          true,
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} Wh/km`
+        );
+      default:
+        return null;
+    }
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    const match = PATTERN.exec(trimmed);
+    if (match !== null) {
+      const amount = (0, import_measurement_unit_parser.tryParseNumberOnly)(match[1]);
+      if (amount === null || amount.compareTo(import_decimal.Decimal.zero) <= 0) return null;
+      return FuelConsumption.fromUnit(amount, match[2]);
+    }
+    const bare = (0, import_measurement_unit_parser.tryParseNumberOnly)(trimmed);
+    if (bare === null || bare.compareTo(import_decimal.Decimal.zero) <= 0) return null;
+    return new FuelConsumption(bare, import_decimal.Decimal.zero, false, `${(0, import_quantity.formatQuantityDecimal)(bare)} l/100km`);
+  }
+  static parse(input) {
+    const result = FuelConsumption.tryParse(input);
+    if (result === null) throw new Error("Invalid fuel consumption.");
+    return result;
+  }
+  static isValid(input) {
+    return FuelConsumption.tryParse(input) !== null;
+  }
+  /** Returns the display form in the parsed unit, e.g. `12 km/l`. */
+  static format(input, options) {
+    const parsed = FuelConsumption.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  /** Returns the value in l/100km, or kWh/100km for electric vehicles. */
+  static normalize(input, options) {
+    const parsed = FuelConsumption.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && FuelConsumption.normalize(input) === input;
+  }
+  /** Finds fuel consumption values in unstructured text, e.g. `8.3 l/100km`. */
+  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 = FuelConsumption.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: "FuelConsumption",
+          category: import_text_candidate_category.TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskFuelConsumption(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the value in l/100km, or kWh/100km for electric vehicles. */
+  toNormalizedString() {
+    return this.electric ? `${(0, import_quantity.formatQuantityDecimal)(this.exactKwhPer100Km)} kWh/100km` : `${(0, import_quantity.formatQuantityDecimal)(this.exactLitersPer100Km)} l/100km`;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.exactLitersPer100Km.equals(other.exactLitersPer100Km) && this.exactKwhPer100Km.equals(other.exactKwhPer100Km);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    const byLiters = this.exactLitersPer100Km.compareTo(other.exactLitersPer100Km);
+    if (byLiters !== 0) return byLiters;
+    return this.exactKwhPer100Km.compareTo(other.exactKwhPer100Km);
+  }
+  reciprocal(numerator) {
+    if (this.exactLitersPer100Km.compareTo(import_decimal.Decimal.zero) <= 0) return 0;
+    return convert(numerator, this.exactLitersPer100Km).toNumber();
+  }
+}
+function maskFuelConsumption(consumption) {
+  const separator = consumption.value.indexOf(" ");
+  if (separator < 0) return "*".repeat(consumption.value.length);
+  return `*** ${consumption.value.slice(separator + 1)}`;
+}
+function convert(numerator, denominator) {
+  return round(numerator.dividedBy(denominator));
+}
+function round(value) {
+  return value.round(CONVERSION_PRECISION, "half-even");
+}
+function positive(value) {
+  const amount = value instanceof import_decimal.Decimal ? value : import_decimal.Decimal.fromNumber(value);
+  if (amount === null) throw new Error(`Value cannot be represented as a consumption: ${value}`);
+  if (amount.compareTo(import_decimal.Decimal.zero) <= 0) throw new Error("Value must be positive.");
+  return amount;
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=fuel-consumption.js.map

package/dist/cjs/vehicle/fuel-consumption.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/fuel-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 FuelConsumption.format} and {@link FuelConsumption.normalize}. */\nexport interface FuelConsumptionFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MPG_US_CONVERSION = Decimal.parse(\"235.214583\")!;\nconst MPG_IMP_CONVERSION = Decimal.parse(\"282.481\")!;\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*(l\\/100\\s*km|liter\\/100\\s*km|km\\/l|km\\/liter|mpg(?:\\s*\\(imp\\))?|miles\\s*per\\s*gallon|kWh\\/100\\s*km|kWh\\/km|Wh\\/km)\\s*$/iu;\n\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])\\d+[0-9 .,]*\\s*(?:l\\/100\\s*km|liter\\/100\\s*km|km\\/l|km\\/liter|mpg|kWh\\/100\\s*km|kWh\\/km|Wh\\/km)(?![\\p{L}\\p{N}_])/giu;\n\n/**\n * Vehicle fuel consumption (`br\u00E4nslef\u00F6rbrukning`), held as litres per 100 km. Both\n * combustion units (`l/100km`, `km/l`, `mpg`) and electric ones (`kWh/100km`,\n * `Wh/km`) are accepted; a bare number is read as litres per 100 km.\n *\n * Sources:\n * - https://en.wikipedia.org/wiki/Fuel_economy_in_automobiles\n */\nexport class FuelConsumption {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Fuel Consumption\",\n    localizedName: \"Br\u00E4nslef\u00F6rbrukning\",\n    emoji: \"\u26FD\",\n    sources: Object.freeze([\"https://en.wikipedia.org/wiki/Fuel_economy_in_automobiles\"]),\n  });\n\n  /** Display form preserving the parsed unit, e.g. `8.3 l/100km`. */\n  readonly value: string;\n\n  private readonly exactLitersPer100Km: Decimal;\n  private readonly exactKwhPer100Km: Decimal;\n  private readonly electric: boolean;\n\n  private constructor(\n    litersPer100Km: Decimal,\n    kwhPer100Km: Decimal,\n    isElectric: boolean,\n    value: string,\n  ) {\n    this.exactLitersPer100Km = litersPer100Km;\n    this.exactKwhPer100Km = kwhPer100Km;\n    this.electric = isElectric;\n    this.value = value;\n  }\n\n  /** Consumption in litres per 100 km. Zero for electric vehicles. */\n  get litersPer100Km(): number {\n    return this.exactLitersPer100Km.toNumber();\n  }\n\n  /** Fuel economy in kilometres per litre. Zero for electric vehicles. */\n  get kilometersPerLiter(): number {\n    return this.reciprocal(HUNDRED);\n  }\n\n  /** Fuel economy in US miles per gallon. Zero for electric vehicles. */\n  get milesPerGallonUs(): number {\n    return this.reciprocal(MPG_US_CONVERSION);\n  }\n\n  /** Fuel economy in imperial miles per gallon. Zero for electric vehicles. */\n  get milesPerGallonImp(): number {\n    return this.reciprocal(MPG_IMP_CONVERSION);\n  }\n\n  /** Electric consumption in kWh per 100 km. Zero for combustion vehicles. */\n  get kwhPer100Km(): number {\n    return this.exactKwhPer100Km.toNumber();\n  }\n\n  /** `true` when the value came from a kWh-based unit. */\n  get isElectric(): boolean {\n    return this.electric;\n  }\n\n  static fromLitersPer100Km(value: number | Decimal): FuelConsumption {\n    const amount = positive(value);\n    return new FuelConsumption(\n      amount,\n      Decimal.zero,\n      false,\n      `${formatQuantityDecimal(amount)} l/100km`,\n    );\n  }\n\n  static fromKilometersPerLiter(value: number | Decimal): FuelConsumption {\n    const amount = positive(value);\n    return new FuelConsumption(\n      convert(HUNDRED, amount),\n      Decimal.zero,\n      false,\n      `${formatQuantityDecimal(amount)} km/l`,\n    );\n  }\n\n  static fromMpgUs(value: number | Decimal): FuelConsumption {\n    const amount = positive(value);\n    return new FuelConsumption(\n      convert(MPG_US_CONVERSION, amount),\n      Decimal.zero,\n      false,\n      `${formatQuantityDecimal(amount)} mpg`,\n    );\n  }\n\n  static fromKwhPer100Km(value: number | Decimal): FuelConsumption {\n    const amount = positive(value);\n    return new FuelConsumption(\n      Decimal.zero,\n      amount,\n      true,\n      `${formatQuantityDecimal(amount)} kWh/100km`,\n    );\n  }\n\n  private static fromUnit(amount: Decimal, unitRaw: string): FuelConsumption | null {\n    const unit = unitRaw.toLowerCase().replaceAll(\" \", \"\");\n\n    switch (unit) {\n      case \"l/100km\":\n      case \"liter/100km\":\n        return new FuelConsumption(\n          amount,\n          Decimal.zero,\n          false,\n          `${formatQuantityDecimal(amount)} l/100km`,\n        );\n      case \"km/l\":\n      case \"km/liter\":\n        return new FuelConsumption(\n          convert(HUNDRED, amount),\n          Decimal.zero,\n          false,\n          `${formatQuantityDecimal(amount)} km/l`,\n        );\n      case \"mpg\":\n      case \"milespergallon\":\n        return new FuelConsumption(\n          convert(MPG_US_CONVERSION, amount),\n          Decimal.zero,\n          false,\n          `${formatQuantityDecimal(amount)} mpg`,\n        );\n      case \"mpg(imp)\":\n        return new FuelConsumption(\n          convert(MPG_IMP_CONVERSION, amount),\n          Decimal.zero,\n          false,\n          `${formatQuantityDecimal(amount)} mpg (imp)`,\n        );\n      case \"kwh/100km\":\n        return new FuelConsumption(\n          Decimal.zero,\n          amount,\n          true,\n          `${formatQuantityDecimal(amount)} kWh/100km`,\n        );\n      case \"kwh/km\":\n        return new FuelConsumption(\n          Decimal.zero,\n          round(amount.times(HUNDRED)),\n          true,\n          `${formatQuantityDecimal(amount)} kWh/km`,\n        );\n      case \"wh/km\":\n        return new FuelConsumption(\n          Decimal.zero,\n          convert(amount, TEN),\n          true,\n          `${formatQuantityDecimal(amount)} Wh/km`,\n        );\n      default:\n        return null;\n    }\n  }\n\n  static tryParse(input: string | null | undefined): FuelConsumption | 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 FuelConsumption.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 FuelConsumption(bare, Decimal.zero, false, `${formatQuantityDecimal(bare)} l/100km`);\n  }\n\n  static parse(input: string): FuelConsumption {\n    const result = FuelConsumption.tryParse(input);\n    if (result === null) throw new Error(\"Invalid fuel consumption.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return FuelConsumption.tryParse(input) !== null;\n  }\n\n  /** Returns the display form in the parsed unit, e.g. `12 km/l`. */\n  static format(\n    input: string | null | undefined,\n    options?: FuelConsumptionFormatOptions,\n  ): string | null {\n    const parsed = FuelConsumption.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the value in l/100km, or kWh/100km for electric vehicles. */\n  static normalize(\n    input: string | null | undefined,\n    options?: FuelConsumptionFormatOptions,\n  ): string | null {\n    const parsed = FuelConsumption.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 && FuelConsumption.normalize(input) === input;\n  }\n\n  /** Finds fuel consumption values in unstructured text, e.g. `8.3 l/100km`. */\n  static findCandidatesInText(text: string): readonly TextCandidate<FuelConsumption>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<FuelConsumption>[] = [];\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 = FuelConsumption.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<FuelConsumption>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"FuelConsumption\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskFuelConsumption(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the value in l/100km, or kWh/100km for electric vehicles. */\n  toNormalizedString(): string {\n    return this.electric\n      ? `${formatQuantityDecimal(this.exactKwhPer100Km)} kWh/100km`\n      : `${formatQuantityDecimal(this.exactLitersPer100Km)} l/100km`;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: FuelConsumption | null | undefined): boolean {\n    return (\n      other != null &&\n      this.exactLitersPer100Km.equals(other.exactLitersPer100Km) &&\n      this.exactKwhPer100Km.equals(other.exactKwhPer100Km)\n    );\n  }\n\n  compareTo(other: FuelConsumption | null | undefined): number {\n    if (other == null) return 1;\n    const byLiters = this.exactLitersPer100Km.compareTo(other.exactLitersPer100Km);\n    if (byLiters !== 0) return byLiters;\n    return this.exactKwhPer100Km.compareTo(other.exactKwhPer100Km);\n  }\n\n  private reciprocal(numerator: Decimal): number {\n    if (this.exactLitersPer100Km.compareTo(Decimal.zero) <= 0) return 0;\n    return convert(numerator, this.exactLitersPer100Km).toNumber();\n  }\n}\n\n/** Returns a masked fuel consumption, e.g. `8.3 l/100km` becomes `*** l/100km`. */\nexport function maskFuelConsumption(consumption: FuelConsumption): 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 convert(numerator: Decimal, denominator: Decimal): Decimal {\n  return round(numerator.dividedBy(denominator));\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?: FuelConsumptionFormatOptions,\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/fuel-type.js

@@ -0,0 +1,288 @@
+"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 fuel_type_exports = {};
+__export(fuel_type_exports, {
+  FuelType: () => FuelType
+});
+module.exports = __toCommonJS(fuel_type_exports);
+var import_primitives_defaults = require("../primitives-defaults.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+class FuelType {
+  static typeInfo = Object.freeze({
+    englishName: "Fuel Type",
+    localizedName: "Drivmedel",
+    emoji: "\u26FD",
+    sources: Object.freeze([
+      "https://www.transportstyrelsen.se/",
+      "https://www.energimyndigheten.se/"
+    ])
+  });
+  value;
+  englishName;
+  localizedName;
+  code;
+  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */
+  rank;
+  constructor(def) {
+    this.value = def.value;
+    this.englishName = def.englishName;
+    this.localizedName = def.localizedName;
+    this.code = def.code;
+    this.rank = def.rank;
+  }
+  static Petrol = new FuelType({
+    value: "Petrol",
+    englishName: "Petrol",
+    localizedName: "Bensin",
+    code: "BE",
+    rank: 0
+  });
+  static Diesel = new FuelType({
+    value: "Diesel",
+    englishName: "Diesel",
+    localizedName: "Diesel",
+    code: "DI",
+    rank: 1
+  });
+  static Electric = new FuelType({
+    value: "Electric",
+    englishName: "Electric",
+    localizedName: "El",
+    code: "EL",
+    rank: 2
+  });
+  static Ethanol = new FuelType({
+    value: "Ethanol",
+    englishName: "Ethanol",
+    localizedName: "Etanol",
+    code: "ET",
+    rank: 3
+  });
+  static NaturalGas = new FuelType({
+    value: "Natural gas",
+    englishName: "Natural gas",
+    localizedName: "Naturgas",
+    code: "CNG",
+    rank: 4
+  });
+  static Lpg = new FuelType({
+    value: "LPG",
+    englishName: "LPG",
+    localizedName: "Gasol",
+    code: "LPG",
+    rank: 5
+  });
+  static Hybrid = new FuelType({
+    value: "Hybrid",
+    englishName: "Hybrid",
+    localizedName: "Elhybrid",
+    code: "HEV",
+    rank: 6
+  });
+  static MildHybrid = new FuelType({
+    value: "Mild hybrid",
+    englishName: "Mild hybrid",
+    localizedName: "Mildhybrid",
+    code: "MHEV",
+    rank: 7
+  });
+  static PlugInHybrid = new FuelType({
+    value: "Plug-in hybrid",
+    englishName: "Plug-in hybrid",
+    localizedName: "Laddhybrid",
+    code: "PHEV",
+    rank: 8
+  });
+  static Hydrogen = new FuelType({
+    value: "Hydrogen",
+    englishName: "Hydrogen",
+    localizedName: "V\xE4tgas",
+    code: "H2",
+    rank: 9
+  });
+  static Biodiesel = new FuelType({
+    value: "Biodiesel",
+    englishName: "Biodiesel",
+    localizedName: "Biodiesel",
+    code: "BIO",
+    rank: 10
+  });
+  static Methane = new FuelType({
+    value: "Methane",
+    englishName: "Methane",
+    localizedName: "Metangas",
+    code: "MET",
+    rank: 11
+  });
+  static Methanol = new FuelType({
+    value: "Methanol",
+    englishName: "Methanol",
+    localizedName: "Metanol",
+    code: "M85",
+    rank: 12
+  });
+  static Hvo = new FuelType({
+    value: "HVO",
+    englishName: "HVO",
+    localizedName: "HVO",
+    code: "HVO",
+    rank: 13
+  });
+  static Kerosene = new FuelType({
+    value: "Kerosene",
+    englishName: "Kerosene",
+    localizedName: "Fotogen",
+    code: "FO",
+    rank: 14
+  });
+  static Other = new FuelType({
+    value: "Other",
+    englishName: "Other",
+    localizedName: "Annat",
+    code: "\xD6VR",
+    rank: 15
+  });
+  /** All 16 values, in canonical order. */
+  static get all() {
+    return ALL;
+  }
+  /** Resolves a value from its canonical name, localized name, code or any known alias. */
+  static tryParse(input) {
+    if (input == null) return null;
+    const key = normalizeLookupKey((0, import_input_sanitization.sanitizeInput)(input).trim());
+    if (key.length === 0) return null;
+    return LOOKUP.get(key) ?? null;
+  }
+  static parse(input) {
+    const result = FuelType.tryParse(input);
+    if (result === null) throw new Error(`Invalid fuel type.`);
+    return result;
+  }
+  static isValid(input) {
+    return FuelType.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = FuelType.tryParse(input);
+    if (r !== null)
+      return import_primitives_defaults.PrimitivesDefaults.useLocalizedDisplayNames ? r.localizedName : r.englishName;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = FuelType.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && FuelType.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return import_primitives_defaults.PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.rank < other.rank ? -1 : this.rank > other.rank ? 1 : 0;
+  }
+}
+const ALL = [
+  FuelType.Petrol,
+  FuelType.Diesel,
+  FuelType.Electric,
+  FuelType.Ethanol,
+  FuelType.NaturalGas,
+  FuelType.Lpg,
+  FuelType.Hybrid,
+  FuelType.MildHybrid,
+  FuelType.PlugInHybrid,
+  FuelType.Hydrogen,
+  FuelType.Biodiesel,
+  FuelType.Methane,
+  FuelType.Methanol,
+  FuelType.Hvo,
+  FuelType.Kerosene,
+  FuelType.Other
+];
+function fallback(input, options) {
+  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+const KEY_PATTERN = /[\s\-/]+/g;
+function normalizeLookupKey(value) {
+  let folded = value.trim().toLowerCase();
+  folded = folded.replace(KEY_PATTERN, " ");
+  return folded.trim();
+}
+const ALIASES = [
+  [
+    FuelType.Petrol,
+    ["95", "98", "be", "bensin", "blyfri", "blyfri bensin", "gas", "gasoline", "petrol"]
+  ],
+  [FuelType.Diesel, ["di", "diesel", "dieselbr\xE4nsle", "dieselolja"]],
+  [
+    FuelType.Electric,
+    ["battery electric", "bev", "el", "elbil", "electric", "elektrisk", "elmotor"]
+  ],
+  [FuelType.Ethanol, ["e85", "et", "etanol", "ethanol", "ffv", "flex fuel", "flexifuel"]],
+  [
+    FuelType.NaturalGas,
+    [
+      "cng",
+      "compressed natural gas",
+      "fordonsgas",
+      "komprimerad naturgas",
+      "natural gas",
+      "naturgas",
+      "ngv"
+    ]
+  ],
+  [
+    FuelType.Lpg,
+    ["autogas", "flytande gas", "gasol", "liquefied petroleum gas", "lpg", "motorgas", "propan"]
+  ],
+  [
+    FuelType.Hybrid,
+    ["bensin el", "elhybrid", "fhev", "full hybrid", "hev", "hybrid", "hybrid electric"]
+  ],
+  [FuelType.MildHybrid, ["48v", "48v hybrid", "mhev", "mild hybrid", "mildhybrid"]],
+  [FuelType.PlugInHybrid, ["laddbar hybrid", "laddhybrid", "phev", "plug in", "plug in hybrid"]],
+  [
+    FuelType.Hydrogen,
+    ["br\xE4nslecell", "fcev", "fuel cell", "h2", "hydrogen", "v\xE4tgas", "v\xE4tgasbil"]
+  ],
+  [FuelType.Biodiesel, ["b100", "bio", "biodiesel", "fame", "rme"]],
+  [
+    FuelType.Methane,
+    ["biogas", "biometan", "cbg", "flytande biogas", "lbg", "met", "metan", "metangas", "methane"]
+  ],
+  [FuelType.Methanol, ["m85", "metanol", "methanol"]],
+  [FuelType.Hvo, ["f\xF6rnybar diesel", "hvo", "hvo100", "hydrotreated vegetable oil"]],
+  [FuelType.Kerosene, ["fo", "fotogen", "kerosene", "paraffin"]],
+  [FuelType.Other, ["annat", "other", "\xF6vr", "\xF6vrig", "\xF6vrigt"]]
+];
+const LOOKUP = /* @__PURE__ */ new Map();
+for (const [value, keys] of ALIASES) {
+  for (const key of keys) if (!LOOKUP.has(key)) LOOKUP.set(key, value);
+}
+//# sourceMappingURL=fuel-type.js.map

package/dist/cjs/vehicle/fuel-type.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/fuel-type.ts"],
+  "sourcesContent": ["import type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface FuelTypeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\ninterface FuelTypeDef {\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly code: string;\n  readonly rank: number;\n}\n\n/**\n * A vehicle fuel or energy type (`drivmedel`) with canonical English identifier, Swedish\n * display name, and Transportstyrelsen code.\n */\nexport class FuelType {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Fuel Type\",\n    localizedName: \"Drivmedel\",\n    emoji: \"\u26FD\",\n    sources: Object.freeze([\n      \"https://www.transportstyrelsen.se/\",\n      \"https://www.energimyndigheten.se/\",\n    ]),\n  });\n\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly code: string;\n\n  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */\n  private readonly rank: number;\n\n  private constructor(def: FuelTypeDef) {\n    this.value = def.value;\n    this.englishName = def.englishName;\n    this.localizedName = def.localizedName;\n    this.code = def.code;\n    this.rank = def.rank;\n  }\n\n  static readonly Petrol = new FuelType({\n    value: \"Petrol\",\n    englishName: \"Petrol\",\n    localizedName: \"Bensin\",\n    code: \"BE\",\n    rank: 0,\n  });\n\n  static readonly Diesel = new FuelType({\n    value: \"Diesel\",\n    englishName: \"Diesel\",\n    localizedName: \"Diesel\",\n    code: \"DI\",\n    rank: 1,\n  });\n\n  static readonly Electric = new FuelType({\n    value: \"Electric\",\n    englishName: \"Electric\",\n    localizedName: \"El\",\n    code: \"EL\",\n    rank: 2,\n  });\n\n  static readonly Ethanol = new FuelType({\n    value: \"Ethanol\",\n    englishName: \"Ethanol\",\n    localizedName: \"Etanol\",\n    code: \"ET\",\n    rank: 3,\n  });\n\n  static readonly NaturalGas = new FuelType({\n    value: \"Natural gas\",\n    englishName: \"Natural gas\",\n    localizedName: \"Naturgas\",\n    code: \"CNG\",\n    rank: 4,\n  });\n\n  static readonly Lpg = new FuelType({\n    value: \"LPG\",\n    englishName: \"LPG\",\n    localizedName: \"Gasol\",\n    code: \"LPG\",\n    rank: 5,\n  });\n\n  static readonly Hybrid = new FuelType({\n    value: \"Hybrid\",\n    englishName: \"Hybrid\",\n    localizedName: \"Elhybrid\",\n    code: \"HEV\",\n    rank: 6,\n  });\n\n  static readonly MildHybrid = new FuelType({\n    value: \"Mild hybrid\",\n    englishName: \"Mild hybrid\",\n    localizedName: \"Mildhybrid\",\n    code: \"MHEV\",\n    rank: 7,\n  });\n\n  static readonly PlugInHybrid = new FuelType({\n    value: \"Plug-in hybrid\",\n    englishName: \"Plug-in hybrid\",\n    localizedName: \"Laddhybrid\",\n    code: \"PHEV\",\n    rank: 8,\n  });\n\n  static readonly Hydrogen = new FuelType({\n    value: \"Hydrogen\",\n    englishName: \"Hydrogen\",\n    localizedName: \"V\u00E4tgas\",\n    code: \"H2\",\n    rank: 9,\n  });\n\n  static readonly Biodiesel = new FuelType({\n    value: \"Biodiesel\",\n    englishName: \"Biodiesel\",\n    localizedName: \"Biodiesel\",\n    code: \"BIO\",\n    rank: 10,\n  });\n\n  static readonly Methane = new FuelType({\n    value: \"Methane\",\n    englishName: \"Methane\",\n    localizedName: \"Metangas\",\n    code: \"MET\",\n    rank: 11,\n  });\n\n  static readonly Methanol = new FuelType({\n    value: \"Methanol\",\n    englishName: \"Methanol\",\n    localizedName: \"Metanol\",\n    code: \"M85\",\n    rank: 12,\n  });\n\n  static readonly Hvo = new FuelType({\n    value: \"HVO\",\n    englishName: \"HVO\",\n    localizedName: \"HVO\",\n    code: \"HVO\",\n    rank: 13,\n  });\n\n  static readonly Kerosene = new FuelType({\n    value: \"Kerosene\",\n    englishName: \"Kerosene\",\n    localizedName: \"Fotogen\",\n    code: \"FO\",\n    rank: 14,\n  });\n\n  static readonly Other = new FuelType({\n    value: \"Other\",\n    englishName: \"Other\",\n    localizedName: \"Annat\",\n    code: \"\u00D6VR\",\n    rank: 15,\n  });\n\n  /** All 16 values, in canonical order. */\n  static get all(): readonly FuelType[] {\n    return ALL;\n  }\n\n  /** Resolves a value from its canonical name, localized name, code or any known alias. */\n  static tryParse(input: string | null | undefined): FuelType | null {\n    if (input == null) return null;\n    const key = normalizeLookupKey(sanitizeInput(input).trim());\n    if (key.length === 0) return null;\n    return LOOKUP.get(key) ?? null;\n  }\n\n  static parse(input: string): FuelType {\n    const result = FuelType.tryParse(input);\n    if (result === null) throw new Error(`Invalid fuel type.`);\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return FuelType.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: FuelTypeFormatOptions): string | null {\n    const r = FuelType.tryParse(input);\n    if (r !== null)\n      return PrimitivesDefaults.useLocalizedDisplayNames ? r.localizedName : r.englishName;\n    return fallback(input, options);\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: FuelTypeFormatOptions,\n  ): string | null {\n    const r = FuelType.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && FuelType.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;\n  }\n\n  equals(other: FuelType | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: FuelType | null | undefined): number {\n    if (other == null) return 1;\n    return this.rank < other.rank ? -1 : this.rank > other.rank ? 1 : 0;\n  }\n}\n\nconst ALL: readonly FuelType[] = [\n  FuelType.Petrol,\n  FuelType.Diesel,\n  FuelType.Electric,\n  FuelType.Ethanol,\n  FuelType.NaturalGas,\n  FuelType.Lpg,\n  FuelType.Hybrid,\n  FuelType.MildHybrid,\n  FuelType.PlugInHybrid,\n  FuelType.Hydrogen,\n  FuelType.Biodiesel,\n  FuelType.Methane,\n  FuelType.Methanol,\n  FuelType.Hvo,\n  FuelType.Kerosene,\n  FuelType.Other,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: FuelTypeFormatOptions,\n): string | null {\n  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nconst KEY_PATTERN = /[\\s\\-/]+/g;\n\nfunction normalizeLookupKey(value: string): string {\n  let folded = value.trim().toLowerCase();\n  folded = folded.replace(KEY_PATTERN, \" \");\n  return folded.trim();\n}\n\nconst ALIASES: readonly (readonly [FuelType, readonly string[]])[] = [\n  [\n    FuelType.Petrol,\n    [\"95\", \"98\", \"be\", \"bensin\", \"blyfri\", \"blyfri bensin\", \"gas\", \"gasoline\", \"petrol\"],\n  ],\n  [FuelType.Diesel, [\"di\", \"diesel\", \"dieselbr\u00E4nsle\", \"dieselolja\"]],\n  [\n    FuelType.Electric,\n    [\"battery electric\", \"bev\", \"el\", \"elbil\", \"electric\", \"elektrisk\", \"elmotor\"],\n  ],\n  [FuelType.Ethanol, [\"e85\", \"et\", \"etanol\", \"ethanol\", \"ffv\", \"flex fuel\", \"flexifuel\"]],\n  [\n    FuelType.NaturalGas,\n    [\n      \"cng\",\n      \"compressed natural gas\",\n      \"fordonsgas\",\n      \"komprimerad naturgas\",\n      \"natural gas\",\n      \"naturgas\",\n      \"ngv\",\n    ],\n  ],\n  [\n    FuelType.Lpg,\n    [\"autogas\", \"flytande gas\", \"gasol\", \"liquefied petroleum gas\", \"lpg\", \"motorgas\", \"propan\"],\n  ],\n  [\n    FuelType.Hybrid,\n    [\"bensin el\", \"elhybrid\", \"fhev\", \"full hybrid\", \"hev\", \"hybrid\", \"hybrid electric\"],\n  ],\n  [FuelType.MildHybrid, [\"48v\", \"48v hybrid\", \"mhev\", \"mild hybrid\", \"mildhybrid\"]],\n  [FuelType.PlugInHybrid, [\"laddbar hybrid\", \"laddhybrid\", \"phev\", \"plug in\", \"plug in hybrid\"]],\n  [\n    FuelType.Hydrogen,\n    [\"br\u00E4nslecell\", \"fcev\", \"fuel cell\", \"h2\", \"hydrogen\", \"v\u00E4tgas\", \"v\u00E4tgasbil\"],\n  ],\n  [FuelType.Biodiesel, [\"b100\", \"bio\", \"biodiesel\", \"fame\", \"rme\"]],\n  [\n    FuelType.Methane,\n    [\"biogas\", \"biometan\", \"cbg\", \"flytande biogas\", \"lbg\", \"met\", \"metan\", \"metangas\", \"methane\"],\n  ],\n  [FuelType.Methanol, [\"m85\", \"metanol\", \"methanol\"]],\n  [FuelType.Hvo, [\"f\u00F6rnybar diesel\", \"hvo\", \"hvo100\", \"hydrotreated vegetable oil\"]],\n  [FuelType.Kerosene, [\"fo\", \"fotogen\", \"kerosene\", \"paraffin\"]],\n  [FuelType.Other, [\"annat\", \"other\", \"\u00F6vr\", \"\u00F6vrig\", \"\u00F6vrigt\"]],\n];\n\nconst LOOKUP = new Map<string, FuelType>();\nfor (const [value, keys] of ALIASES) {\n  for (const key of keys) if (!LOOKUP.has(key)) LOOKUP.set(key, value);\n}\n"],
+  "mappings": "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",
+  "names": []
+}