@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

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

@@ -0,0 +1,250 @@
+"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 energy_consumption_exports = {};
+__export(energy_consumption_exports, {
+  EnergyConsumption: () => EnergyConsumption,
+  maskEnergyConsumption: () => maskEnergyConsumption
+});
+module.exports = __toCommonJS(energy_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 KILOMETRES_PER_MILE = import_decimal.Decimal.parse("1.609344");
+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*(kWh\/100\s*km|kWh\/km|Wh\/km|mi\/kWh|miles\/kWh|kWh\/mi|kWh\/mile)\s*$/iu;
+const SCAN_PATTERN = /(?<![\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;
+class EnergyConsumption {
+  static typeInfo = Object.freeze({
+    englishName: "Energy Consumption",
+    localizedName: "Elf\xF6rbrukning",
+    emoji: "\u{1F50C}",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/Fuel_economy_in_electric_vehicles",
+      "https://www.energimyndigheten.se/"
+    ])
+  });
+  /** Display form preserving the parsed unit, e.g. `150 Wh/km`. */
+  value;
+  /** The unit the value was parsed from, e.g. `kWh/100km` or `mi/kWh`. */
+  originalUnit;
+  exactKwhPer100Km;
+  constructor(kwhPer100Km, displayUnit, value) {
+    this.exactKwhPer100Km = kwhPer100Km;
+    this.originalUnit = displayUnit;
+    this.value = value;
+  }
+  /** Consumption in kilowatt-hours per 100 km, e.g. `15` for a typical EV. */
+  get kwhPer100Km() {
+    return this.exactKwhPer100Km.toNumber();
+  }
+  /** Consumption in kilowatt-hours per km, e.g. `0.15` for 15 kWh/100km. */
+  get kwhPerKm() {
+    return round(this.exactKwhPer100Km.dividedBy(HUNDRED)).toNumber();
+  }
+  /** Consumption in watt-hours per km, e.g. `150` for 15 kWh/100km. */
+  get whPerKm() {
+    return round(this.exactKwhPer100Km.times(TEN)).toNumber();
+  }
+  /** Energy economy in US miles per kilowatt-hour, e.g. `4.13` for 15 kWh/100km. */
+  get milesPerKwh() {
+    if (this.exactKwhPer100Km.compareTo(import_decimal.Decimal.zero) <= 0) return 0;
+    return round(HUNDRED.dividedBy(this.exactKwhPer100Km.times(KILOMETRES_PER_MILE))).toNumber();
+  }
+  /** Consumption in kilowatt-hours per mile, e.g. `0.241` for 15 kWh/100km. */
+  get kwhPerMile() {
+    return round(this.exactKwhPer100Km.times(KILOMETRES_PER_MILE).dividedBy(HUNDRED)).toNumber();
+  }
+  static fromKwhPer100Km(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(amount, "kWh/100km", `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/100km`);
+  }
+  static fromWhPerKm(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(amount.dividedBy(TEN)),
+      "Wh/km",
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} Wh/km`
+    );
+  }
+  static fromKwhPerKm(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(amount.times(HUNDRED)),
+      "kWh/km",
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/km`
+    );
+  }
+  static fromMilesPerKwh(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(HUNDRED.dividedBy(amount.times(KILOMETRES_PER_MILE))),
+      "mi/kWh",
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} mi/kWh`
+    );
+  }
+  static fromKwhPerMile(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(amount.times(HUNDRED).dividedBy(KILOMETRES_PER_MILE)),
+      "kWh/mi",
+      `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/mi`
+    );
+  }
+  static fromUnit(amount, unitRaw) {
+    const unit = unitRaw.toLowerCase().replaceAll(" ", "");
+    switch (unit) {
+      case "kwh/100km":
+        return new EnergyConsumption(
+          amount,
+          "kWh/100km",
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/100km`
+        );
+      case "kwh/km":
+        return new EnergyConsumption(
+          round(amount.times(HUNDRED)),
+          "kWh/km",
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/km`
+        );
+      case "wh/km":
+        return new EnergyConsumption(
+          round(amount.dividedBy(TEN)),
+          "Wh/km",
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} Wh/km`
+        );
+      case "mi/kwh":
+      case "miles/kwh":
+        return new EnergyConsumption(
+          round(HUNDRED.dividedBy(amount.times(KILOMETRES_PER_MILE))),
+          "mi/kWh",
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} mi/kWh`
+        );
+      case "kwh/mi":
+      case "kwh/mile":
+        return new EnergyConsumption(
+          round(amount.times(HUNDRED).dividedBy(KILOMETRES_PER_MILE)),
+          "kWh/mi",
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} kWh/mi`
+        );
+      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 EnergyConsumption.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 EnergyConsumption(bare, "kWh/100km", `${(0, import_quantity.formatQuantityDecimal)(bare)} kWh/100km`);
+  }
+  static parse(input) {
+    const result = EnergyConsumption.tryParse(input);
+    if (result === null) throw new Error("Invalid energy consumption.");
+    return result;
+  }
+  static isValid(input) {
+    return EnergyConsumption.tryParse(input) !== null;
+  }
+  /** Returns the display form in the parsed unit, e.g. `4 mi/kWh`. */
+  static format(input, options) {
+    const parsed = EnergyConsumption.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  /** Returns the value in kWh/100km, e.g. `15 kWh/100km`. */
+  static normalize(input, options) {
+    const parsed = EnergyConsumption.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && EnergyConsumption.normalize(input) === input;
+  }
+  /** Finds energy consumption values in unstructured text, e.g. `150 Wh/km`. */
+  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 = EnergyConsumption.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: "EnergyConsumption",
+          category: import_text_candidate_category.TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEnergyConsumption(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the value in kWh/100km, e.g. `15 kWh/100km`. */
+  toNormalizedString() {
+    return `${(0, import_quantity.formatQuantityDecimal)(this.exactKwhPer100Km)} kWh/100km`;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.exactKwhPer100Km.equals(other.exactKwhPer100Km);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.exactKwhPer100Km.compareTo(other.exactKwhPer100Km);
+  }
+}
+function maskEnergyConsumption(consumption) {
+  const separator = consumption.value.indexOf(" ");
+  if (separator < 0) return "*".repeat(consumption.value.length);
+  return `*** ${consumption.value.slice(separator + 1)}`;
+}
+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=energy-consumption.js.map

package/dist/cjs/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": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAwB;AACxB,gCAA8B;AAC9B,qCAAmC;AACnC,sBAAsC;AAEtC,4BAA8B;AAC9B,qCAAsC;AACtC,mCAAoC;AAOpC,MAAM,sBAAsB,uBAAQ,MAAM,UAAU;AACpD,MAAM,UAAU,uBAAQ,MAAM,KAAK;AACnC,MAAM,MAAM,uBAAQ,MAAM,IAAI;AAC9B,MAAM,uBAAuB;AAE7B,MAAM,UACJ;AAEF,MAAM,eACJ;AAWK,MAAM,kBAAkB;AAAA,EAC7B,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGA;AAAA,EAEQ;AAAA,EAET,YAAY,aAAsB,aAAqB,OAAe;AAC5E,SAAK,mBAAmB;AACxB,SAAK,eAAe;AACpB,SAAK,QAAQ;AAAA,EACf;AAAA;AAAA,EAGA,IAAI,cAAsB;AACxB,WAAO,KAAK,iBAAiB,SAAS;AAAA,EACxC;AAAA;AAAA,EAGA,IAAI,WAAmB;AACrB,WAAO,MAAM,KAAK,iBAAiB,UAAU,OAAO,CAAC,EAAE,SAAS;AAAA,EAClE;AAAA;AAAA,EAGA,IAAI,UAAkB;AACpB,WAAO,MAAM,KAAK,iBAAiB,MAAM,GAAG,CAAC,EAAE,SAAS;AAAA,EAC1D;AAAA;AAAA,EAGA,IAAI,cAAsB;AACxB,QAAI,KAAK,iBAAiB,UAAU,uBAAQ,IAAI,KAAK,EAAG,QAAO;AAC/D,WAAO,MAAM,QAAQ,UAAU,KAAK,iBAAiB,MAAM,mBAAmB,CAAC,CAAC,EAAE,SAAS;AAAA,EAC7F;AAAA;AAAA,EAGA,IAAI,aAAqB;AACvB,WAAO,MAAM,KAAK,iBAAiB,MAAM,mBAAmB,EAAE,UAAU,OAAO,CAAC,EAAE,SAAS;AAAA,EAC7F;AAAA,EAEA,OAAO,gBAAgB,OAA4C;AACjE,UAAM,SAAS,SAAS,KAAK;AAC7B,WAAO,IAAI,kBAAkB,QAAQ,aAAa,OAAG,uCAAsB,MAAM,CAAC,YAAY;AAAA,EAChG;AAAA,EAEA,OAAO,YAAY,OAA4C;AAC7D,UAAM,SAAS,SAAS,KAAK;AAC7B,WAAO,IAAI;AAAA,MACT,MAAM,OAAO,UAAU,GAAG,CAAC;AAAA,MAC3B;AAAA,MACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,OAAO,aAAa,OAA4C;AAC9D,UAAM,SAAS,SAAS,KAAK;AAC7B,WAAO,IAAI;AAAA,MACT,MAAM,OAAO,MAAM,OAAO,CAAC;AAAA,MAC3B;AAAA,MACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,OAAO,gBAAgB,OAA4C;AACjE,UAAM,SAAS,SAAS,KAAK;AAC7B,WAAO,IAAI;AAAA,MACT,MAAM,QAAQ,UAAU,OAAO,MAAM,mBAAmB,CAAC,CAAC;AAAA,MAC1D;AAAA,MACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,OAAO,eAAe,OAA4C;AAChE,UAAM,SAAS,SAAS,KAAK;AAC7B,WAAO,IAAI;AAAA,MACT,MAAM,OAAO,MAAM,OAAO,EAAE,UAAU,mBAAmB,CAAC;AAAA,MAC1D;AAAA,MACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,OAAe,SAAS,QAAiB,SAA2C;AAClF,UAAM,OAAO,QAAQ,YAAY,EAAE,WAAW,KAAK,EAAE;AAErD,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,eAAO,IAAI;AAAA,UACT;AAAA,UACA;AAAA,UACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,QAClC;AAAA,MACF,KAAK;AACH,eAAO,IAAI;AAAA,UACT,MAAM,OAAO,MAAM,OAAO,CAAC;AAAA,UAC3B;AAAA,UACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,QAClC;AAAA,MACF,KAAK;AACH,eAAO,IAAI;AAAA,UACT,MAAM,OAAO,UAAU,GAAG,CAAC;AAAA,UAC3B;AAAA,UACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,QAClC;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,eAAO,IAAI;AAAA,UACT,MAAM,QAAQ,UAAU,OAAO,MAAM,mBAAmB,CAAC,CAAC;AAAA,UAC1D;AAAA,UACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,QAClC;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,eAAO,IAAI;AAAA,UACT,MAAM,OAAO,MAAM,OAAO,EAAE,UAAU,mBAAmB,CAAC;AAAA,UAC1D;AAAA,UACA,OAAG,uCAAsB,MAAM,CAAC;AAAA,QAClC;AAAA,MACF;AACE,eAAO;AAAA,IACX;AAAA,EACF;AAAA,EAEA,OAAO,SAAS,OAA4D;AAC1E,QAAI,SAAS,QAAQ,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AACvD,UAAM,cAAU,yCAAc,KAAK,EAAE,KAAK;AAE1C,UAAM,QAAQ,QAAQ,KAAK,OAAO;AAClC,QAAI,UAAU,MAAM;AAClB,YAAM,aAAS,mDAAmB,MAAM,CAAC,CAAE;AAC3C,UAAI,WAAW,QAAQ,OAAO,UAAU,uBAAQ,IAAI,KAAK,EAAG,QAAO;AACnE,aAAO,kBAAkB,SAAS,QAAQ,MAAM,CAAC,CAAE;AAAA,IACrD;AAEA,UAAM,WAAO,mDAAmB,OAAO;AACvC,QAAI,SAAS,QAAQ,KAAK,UAAU,uBAAQ,IAAI,KAAK,EAAG,QAAO;AAC/D,WAAO,IAAI,kBAAkB,MAAM,aAAa,OAAG,uCAAsB,IAAI,CAAC,YAAY;AAAA,EAC5F;AAAA,EAEA,OAAO,MAAM,OAAkC;AAC7C,UAAM,SAAS,kBAAkB,SAAS,KAAK;AAC/C,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,6BAA6B;AAClE,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,kBAAkB,SAAS,KAAK,MAAM;AAAA,EAC/C;AAAA;AAAA,EAGA,OAAO,OACL,OACA,SACe;AACf,UAAM,SAAS,kBAAkB,SAAS,KAAK;AAC/C,QAAI,WAAW,KAAM,QAAO,OAAO;AACnC,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,UACL,OACA,SACe;AACf,UAAM,SAAS,kBAAkB,SAAS,KAAK;AAC/C,QAAI,WAAW,KAAM,QAAO,OAAO,mBAAmB;AACtD,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,kBAAkB,UAAU,KAAK,MAAM;AAAA,EACjE;AAAA;AAAA,EAGA,OAAO,qBAAqB,MAA2D;AACrF,QAAI,CAAC,KAAM,QAAO,CAAC;AAEnB,UAAM,MAA0C,CAAC;AACjD,UAAM,UAAU,IAAI,OAAO,aAAa,QAAQ,aAAa,KAAK;AAClE,QAAI;AAEJ,YAAQ,QAAQ,QAAQ,KAAK,IAAI,OAAO,MAAM;AAC5C,YAAM,QAAQ,kBAAkB,SAAS,MAAM,CAAC,CAAC;AACjD,UAAI,UAAU,KAAM;AACpB,UAAI;AAAA,QACF,IAAI,oCAAiC;AAAA,UACnC,YAAY,MAAM;AAAA,UAClB,QAAQ,MAAM,CAAC,EAAE;AAAA,UACjB,cAAc,MAAM,CAAC;AAAA,UACrB,UAAU;AAAA,UACV,UAAU,qDAAsB;AAAA,UAChC,gBAAgB,MAAM,mBAAmB;AAAA,UACzC,eAAe,MAAM,SAAS;AAAA,UAC9B,YAAY,sBAAsB,KAAK;AAAA,UACvC,YAAY,iDAAoB;AAAA,UAChC;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,qBAA6B;AAC3B,WAAO,OAAG,uCAAsB,KAAK,gBAAgB,CAAC;AAAA,EACxD;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAsD;AAC3D,WAAO,SAAS,QAAQ,KAAK,iBAAiB,OAAO,MAAM,gBAAgB;AAAA,EAC7E;AAAA,EAEA,UAAU,OAAqD;AAC7D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,iBAAiB,UAAU,MAAM,gBAAgB;AAAA,EAC/D;AACF;AAGO,SAAS,sBAAsB,aAAwC;AAC5E,QAAM,YAAY,YAAY,MAAM,QAAQ,GAAG;AAC/C,MAAI,YAAY,EAAG,QAAO,IAAI,OAAO,YAAY,MAAM,MAAM;AAC7D,SAAO,OAAO,YAAY,MAAM,MAAM,YAAY,CAAC,CAAC;AACtD;AAEA,SAAS,MAAM,OAAyB;AACtC,SAAO,MAAM,MAAM,sBAAsB,WAAW;AACtD;AAEA,SAAS,SAAS,OAAkC;AAClD,QAAM,SAAS,iBAAiB,yBAAU,QAAQ,uBAAQ,WAAW,KAAK;AAC1E,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,iDAAiD,KAAK,EAAE;AAC7F,MAAI,OAAO,UAAU,uBAAQ,IAAI,KAAK,EAAG,OAAM,IAAI,MAAM,yBAAyB;AAClF,SAAO;AACT;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": []
+}

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

@@ -0,0 +1,169 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var engine_displacement_exports = {};
+__export(engine_displacement_exports, {
+  EngineDisplacement: () => EngineDisplacement
+});
+module.exports = __toCommonJS(engine_displacement_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_volume = require("../measurement/volume.js");
+var import_volume_unit = require("../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 import_decimal.Decimal ? value : decimalOf(value);
+    if (amount.compareTo(import_decimal.Decimal.zero) <= 0) {
+      throw new Error("Engine displacement must be positive.");
+    }
+    return new EngineDisplacement(import_volume.Volume.create(amount, unit));
+  }
+  static fromCubicCentimeters(value) {
+    return EngineDisplacement.create(value, import_volume_unit.VolumeUnit.Milliliter);
+  }
+  static fromLiters(value) {
+    return EngineDisplacement.create(value, import_volume_unit.VolumeUnit.Liter);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    const bare = (0, import_measurement_unit_parser.tryParseNumberOnly)(trimmed);
+    if (bare !== null) {
+      if (bare.compareTo(import_decimal.Decimal.zero) <= 0) return null;
+      return new EngineDisplacement(
+        import_volume.Volume.fromMilliliters(bare),
+        `${(0, import_quantity.formatQuantityDecimal)(bare)} mL`
+      );
+    }
+    if (trimmed.toLowerCase().endsWith("cc")) {
+      const amount = (0, import_measurement_unit_parser.tryParseNumberOnly)(trimmed.slice(0, -2).trim());
+      if (amount !== null && amount.compareTo(import_decimal.Decimal.zero) > 0) {
+        return new EngineDisplacement(
+          import_volume.Volume.fromMilliliters(amount),
+          `${(0, import_quantity.formatQuantityDecimal)(amount)} mL`
+        );
+      }
+    }
+    const parsed = import_volume.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 import_decimal.Decimal ? factor : decimalOf(factor))
+    );
+  }
+  dividedBy(divisor) {
+    return new EngineDisplacement(
+      this.displacement.dividedBy(divisor instanceof import_decimal.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 = import_decimal.Decimal.fromNumber(value);
+  if (parsed === null) throw new Error(`Value cannot be represented as a displacement: ${value}`);
+  return parsed;
+}
+//# sourceMappingURL=engine-displacement.js.map

package/dist/cjs/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": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAwB;AACxB,gCAA8B;AAC9B,qCAAmC;AACnC,sBAAsC;AACtC,oBAAuB;AACvB,yBAA2B;AAgBpB,MAAM,mBAAmB;AAAA,EAC9B,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EAC3B,CAAC;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGA;AAAA,EAED,YAAY,cAAsB,cAAuB;AAC/D,SAAK,eAAe;AACpB,SAAK,QAAQ,gBAAgB,aAAa,SAAS;AAAA,EACrD;AAAA;AAAA,EAGA,IAAI,mBAA2B;AAC7B,WAAO,KAAK,aAAa;AAAA,EAC3B;AAAA;AAAA,EAGA,IAAI,SAAiB;AACnB,WAAO,KAAK,aAAa;AAAA,EAC3B;AAAA;AAAA,EAGA,OAAO,OAAO,OAAyB,MAAsC;AAC3E,UAAM,SAAS,iBAAiB,yBAAU,QAAQ,UAAU,KAAK;AACjE,QAAI,OAAO,UAAU,uBAAQ,IAAI,KAAK,GAAG;AACvC,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AACA,WAAO,IAAI,mBAAmB,qBAAO,OAAO,QAAQ,IAAI,CAAC;AAAA,EAC3D;AAAA,EAEA,OAAO,qBAAqB,OAA6C;AACvE,WAAO,mBAAmB,OAAO,OAAO,8BAAW,UAAU;AAAA,EAC/D;AAAA,EAEA,OAAO,WAAW,OAA6C;AAC7D,WAAO,mBAAmB,OAAO,OAAO,8BAAW,KAAK;AAAA,EAC1D;AAAA,EAEA,OAAO,SAAS,OAA6D;AAC3E,QAAI,SAAS,QAAQ,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AACvD,UAAM,cAAU,yCAAc,KAAK,EAAE,KAAK;AAE1C,UAAM,WAAO,mDAAmB,OAAO;AACvC,QAAI,SAAS,MAAM;AACjB,UAAI,KAAK,UAAU,uBAAQ,IAAI,KAAK,EAAG,QAAO;AAC9C,aAAO,IAAI;AAAA,QACT,qBAAO,gBAAgB,IAAI;AAAA,QAC3B,OAAG,uCAAsB,IAAI,CAAC;AAAA,MAChC;AAAA,IACF;AAGA,QAAI,QAAQ,YAAY,EAAE,SAAS,IAAI,GAAG;AACxC,YAAM,aAAS,mDAAmB,QAAQ,MAAM,GAAG,EAAE,EAAE,KAAK,CAAC;AAC7D,UAAI,WAAW,QAAQ,OAAO,UAAU,uBAAQ,IAAI,IAAI,GAAG;AACzD,eAAO,IAAI;AAAA,UACT,qBAAO,gBAAgB,MAAM;AAAA,UAC7B,OAAG,uCAAsB,MAAM,CAAC;AAAA,QAClC;AAAA,MACF;AAAA,IACF;AAEA,UAAM,SAAS,qBAAO,SAAS,OAAO;AACtC,QAAI,WAAW,QAAQ,OAAO,UAAU,EAAG,QAAO;AAClD,WAAO,IAAI,mBAAmB,MAAM;AAAA,EACtC;AAAA,EAEA,OAAO,MAAM,OAAmC;AAC9C,UAAM,SAAS,mBAAmB,SAAS,KAAK;AAChD,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,8BAA8B;AACnE,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,mBAAmB,SAAS,KAAK,MAAM;AAAA,EAChD;AAAA;AAAA,EAGA,OAAO,OACL,OACA,SACe;AACf,UAAM,SAAS,mBAAmB,SAAS,KAAK;AAChD,QAAI,WAAW,MAAM;AACnB,UAAI,SAAS,SAAS,UAAa,SAAS,aAAa,QAAW;AAClE,eAAO,OAAO,aAAa;AAAA,UACzB,QAAQ,QAAQ,OAAO,aAAa;AAAA,UACpC,QAAQ;AAAA,QACV;AAAA,MACF;AACA,aAAO,OAAO;AAAA,IAChB;AACA,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,UACL,OACA,SACe;AACf,UAAM,SAAS,mBAAmB,SAAS,KAAK;AAChD,QAAI,WAAW,KAAM,QAAO,OAAO,aAAa,mBAAmB;AACnE,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,mBAAmB,UAAU,KAAK,MAAM;AAAA,EAClE;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK,aAAa,mBAAmB;AAAA,EAC9C;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,gBAAgB,UAA2B;AACzC,WAAO,KAAK,aAAa,gBAAgB,QAAQ;AAAA,EACnD;AAAA,EAEA,KAAK,OAA+C;AAClD,WAAO,IAAI,mBAAmB,KAAK,aAAa,KAAK,MAAM,YAAY,CAAC;AAAA,EAC1E;AAAA,EAEA,MAAM,OAA+C;AACnD,WAAO,IAAI,mBAAmB,KAAK,aAAa,MAAM,MAAM,YAAY,CAAC;AAAA,EAC3E;AAAA,EAEA,MAAM,QAA8C;AAClD,WAAO,IAAI;AAAA,MACT,KAAK,aAAa,MAAM,kBAAkB,yBAAU,SAAS,UAAU,MAAM,CAAC;AAAA,IAChF;AAAA,EACF;AAAA,EAEA,UAAU,SAA+C;AACvD,WAAO,IAAI;AAAA,MACT,KAAK,aAAa,UAAU,mBAAmB,yBAAU,UAAU,UAAU,OAAO,CAAC;AAAA,IACvF;AAAA,EACF;AAAA,EAEA,UAA8B;AAC5B,WAAO,IAAI,mBAAmB,KAAK,aAAa,QAAQ,CAAC;AAAA,EAC3D;AAAA,EAEA,OAAO,OAAuD;AAC5D,WAAO,SAAS,QAAQ,KAAK,aAAa,OAAO,MAAM,YAAY;AAAA,EACrE;AAAA,EAEA,UAAU,OAAsD;AAC9D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,aAAa,UAAU,MAAM,YAAY;AAAA,EACvD;AACF;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;AAEA,SAAS,UAAU,OAAwB;AACzC,QAAM,SAAS,uBAAQ,WAAW,KAAK;AACvC,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,kDAAkD,KAAK,EAAE;AAC9F,SAAO;AACT;",
+  "names": []
+}