@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/esm/vehicle/drivetrain-type.js

@@ -0,0 +1,180 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+class DrivetrainType {
+  static typeInfo = Object.freeze({
+    englishName: "Drivetrain Type",
+    localizedName: "Drivning",
+    emoji: "\u{1F697}",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/Drive_wheel",
+      "https://en.wikipedia.org/wiki/All-wheel_drive"
+    ])
+  });
+  value;
+  englishName;
+  localizedName;
+  drivenAxleCount;
+  /** @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.drivenAxleCount = def.drivenAxleCount;
+    this.rank = def.rank;
+  }
+  static Awd = new DrivetrainType({
+    value: "AWD",
+    englishName: "All-wheel drive",
+    localizedName: "Fyrhjulsdrift",
+    drivenAxleCount: 2,
+    rank: 0
+  });
+  static Fwd = new DrivetrainType({
+    value: "FWD",
+    englishName: "Front-wheel drive",
+    localizedName: "Framhjulsdrift",
+    drivenAxleCount: 1,
+    rank: 1
+  });
+  static Rwd = new DrivetrainType({
+    value: "RWD",
+    englishName: "Rear-wheel drive",
+    localizedName: "Bakhjulsdrift",
+    drivenAxleCount: 1,
+    rank: 2
+  });
+  /** All 3 values, in canonical order. */
+  static get all() {
+    return ALL;
+  }
+  /** Name in the language selected by {@link PrimitivesDefaults.uiCulture}. */
+  get displayName() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+  }
+  /** 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(sanitizeInput(input).trim());
+    if (key.length === 0) return null;
+    return LOOKUP.get(key) ?? null;
+  }
+  static parse(input) {
+    const result = DrivetrainType.tryParse(input);
+    if (result === null) throw new Error(`Invalid drivetrain type.`);
+    return result;
+  }
+  static isValid(input) {
+    return DrivetrainType.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = DrivetrainType.tryParse(input);
+    if (r !== null)
+      return PrimitivesDefaults.useLocalizedDisplayNames ? r.localizedName : r.englishName;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = DrivetrainType.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && DrivetrainType.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+  }
+  toDisplayString() {
+    return this.displayName;
+  }
+  toEnglishString() {
+    return this.englishName;
+  }
+  toLocalString() {
+    return this.localizedName;
+  }
+  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 = [DrivetrainType.Awd, DrivetrainType.Fwd, DrivetrainType.Rwd];
+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.replaceAll("\xE5", "a").replaceAll("\xE4", "a").replaceAll("\xF6", "o");
+  folded = folded.replace(KEY_PATTERN, "");
+  return folded;
+}
+const ALIASES = [
+  [
+    DrivetrainType.Awd,
+    [
+      "4matic",
+      "4motion",
+      "4wd",
+      "4x4",
+      "allwheeldrive",
+      "awd",
+      "awdsystem",
+      "fourwheeldrive",
+      "fyrahjul",
+      "fyrhjul",
+      "fyrhjulsdrift",
+      "fyrhjulsdriven",
+      "fyrhjulsdrivet",
+      "quattro",
+      "sawc",
+      "symmetricalawd",
+      "twincharger",
+      "xdrive"
+    ]
+  ],
+  [
+    DrivetrainType.Fwd,
+    [
+      "2wdfront",
+      "framdrift",
+      "framhjul",
+      "framhjulsdrift",
+      "framhjulsdriven",
+      "framhjulsdrivet",
+      "frontdrive",
+      "frontwheeldrive",
+      "fwd"
+    ]
+  ],
+  [
+    DrivetrainType.Rwd,
+    [
+      "2wdrear",
+      "bakdrift",
+      "bakhjul",
+      "bakhjulsdrift",
+      "bakhjulsdriven",
+      "bakhjulsdrivet",
+      "reardrive",
+      "rearwheeldrive",
+      "rwd"
+    ]
+  ]
+];
+const LOOKUP = /* @__PURE__ */ new Map();
+for (const [value, keys] of ALIASES) {
+  for (const key of keys) if (!LOOKUP.has(key)) LOOKUP.set(key, value);
+}
+export {
+  DrivetrainType
+};
+//# sourceMappingURL=drivetrain-type.js.map

package/dist/esm/vehicle/drivetrain-type.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/drivetrain-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 DrivetrainTypeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\ninterface DrivetrainTypeDef {\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly drivenAxleCount: number;\n  readonly rank: number;\n}\n\n/**\n * Drivetrain layout (`drivning`) of a road vehicle, e.g. `AWD` (all-wheel drive,\n * `fyrhjulsdrift`), `FWD` (front-wheel drive, `framhjulsdrift`), or `RWD` (rear-wheel drive,\n * `bakhjulsdrift`).\n */\nexport class DrivetrainType {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Drivetrain Type\",\n    localizedName: \"Drivning\",\n    emoji: \"\uD83D\uDE97\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/Drive_wheel\",\n      \"https://en.wikipedia.org/wiki/All-wheel_drive\",\n    ]),\n  });\n\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly drivenAxleCount: number;\n\n  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */\n  private readonly rank: number;\n\n  private constructor(def: DrivetrainTypeDef) {\n    this.value = def.value;\n    this.englishName = def.englishName;\n    this.localizedName = def.localizedName;\n    this.drivenAxleCount = def.drivenAxleCount;\n    this.rank = def.rank;\n  }\n\n  static readonly Awd = new DrivetrainType({\n    value: \"AWD\",\n    englishName: \"All-wheel drive\",\n    localizedName: \"Fyrhjulsdrift\",\n    drivenAxleCount: 2,\n    rank: 0,\n  });\n\n  static readonly Fwd = new DrivetrainType({\n    value: \"FWD\",\n    englishName: \"Front-wheel drive\",\n    localizedName: \"Framhjulsdrift\",\n    drivenAxleCount: 1,\n    rank: 1,\n  });\n\n  static readonly Rwd = new DrivetrainType({\n    value: \"RWD\",\n    englishName: \"Rear-wheel drive\",\n    localizedName: \"Bakhjulsdrift\",\n    drivenAxleCount: 1,\n    rank: 2,\n  });\n\n  /** All 3 values, in canonical order. */\n  static get all(): readonly DrivetrainType[] {\n    return ALL;\n  }\n\n  /** Name in the language selected by {@link PrimitivesDefaults.uiCulture}. */\n  get displayName(): string {\n    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;\n  }\n\n  /** Resolves a value from its canonical name, localized name, code or any known alias. */\n  static tryParse(input: string | null | undefined): DrivetrainType | 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): DrivetrainType {\n    const result = DrivetrainType.tryParse(input);\n    if (result === null) throw new Error(`Invalid drivetrain type.`);\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return DrivetrainType.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: DrivetrainTypeFormatOptions,\n  ): string | null {\n    const r = DrivetrainType.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?: DrivetrainTypeFormatOptions,\n  ): string | null {\n    const r = DrivetrainType.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 && DrivetrainType.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  toDisplayString(): string {\n    return this.displayName;\n  }\n\n  toEnglishString(): string {\n    return this.englishName;\n  }\n\n  toLocalString(): string {\n    return this.localizedName;\n  }\n\n  equals(other: DrivetrainType | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: DrivetrainType | 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 DrivetrainType[] = [DrivetrainType.Awd, DrivetrainType.Fwd, DrivetrainType.Rwd];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: DrivetrainTypeFormatOptions,\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.replaceAll(\"\u00E5\", \"a\").replaceAll(\"\u00E4\", \"a\").replaceAll(\"\u00F6\", \"o\");\n  folded = folded.replace(KEY_PATTERN, \"\");\n  return folded;\n}\n\nconst ALIASES: readonly (readonly [DrivetrainType, readonly string[]])[] = [\n  [\n    DrivetrainType.Awd,\n    [\n      \"4matic\",\n      \"4motion\",\n      \"4wd\",\n      \"4x4\",\n      \"allwheeldrive\",\n      \"awd\",\n      \"awdsystem\",\n      \"fourwheeldrive\",\n      \"fyrahjul\",\n      \"fyrhjul\",\n      \"fyrhjulsdrift\",\n      \"fyrhjulsdriven\",\n      \"fyrhjulsdrivet\",\n      \"quattro\",\n      \"sawc\",\n      \"symmetricalawd\",\n      \"twincharger\",\n      \"xdrive\",\n    ],\n  ],\n  [\n    DrivetrainType.Fwd,\n    [\n      \"2wdfront\",\n      \"framdrift\",\n      \"framhjul\",\n      \"framhjulsdrift\",\n      \"framhjulsdriven\",\n      \"framhjulsdrivet\",\n      \"frontdrive\",\n      \"frontwheeldrive\",\n      \"fwd\",\n    ],\n  ],\n  [\n    DrivetrainType.Rwd,\n    [\n      \"2wdrear\",\n      \"bakdrift\",\n      \"bakhjul\",\n      \"bakhjulsdrift\",\n      \"bakhjulsdriven\",\n      \"bakhjulsdrivet\",\n      \"reardrive\",\n      \"rearwheeldrive\",\n      \"rwd\",\n    ],\n  ],\n];\n\nconst LOOKUP = new Map<string, DrivetrainType>();\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": []
+}

package/dist/esm/vehicle/emission-rate.js

@@ -0,0 +1,174 @@
+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 { 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 KM_PER_MILE = Decimal.parse("1.60934");
+const THOUSAND = Decimal.parse("1000");
+const CONVERSION_PRECISION = 6;
+const PATTERN = /^\s*([0-9][0-9 .,]*[0-9]|[0-9])\s*(g\/km|mg\/km|g\/mi|g\/mile|mg\/mi)\s*$/iu;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])\d+[0-9 .,]*\s*(?:g\/km|mg\/km|g\/mi(?:le)?|mg\/mi)(?![\p{L}\p{N}_])/giu;
+class EmissionRate {
+  static typeInfo = Object.freeze({
+    englishName: "Emission Rate",
+    localizedName: "Utsl\xE4pp",
+    emoji: "\u{1F4A8}",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/European_emission_standards",
+      "https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle"
+    ])
+  });
+  /** Display form preserving the parsed unit, e.g. `221 g/km`. */
+  value;
+  exactGramsPerKm;
+  constructor(gramsPerKm, value) {
+    this.exactGramsPerKm = gramsPerKm;
+    this.value = value;
+  }
+  /** The rate in grams per kilometre, e.g. `221`. */
+  get gramsPerKm() {
+    return this.exactGramsPerKm.toNumber();
+  }
+  /** The rate in milligrams per kilometre, e.g. `95700`. */
+  get milligramsPerKm() {
+    return this.exactGramsPerKm.times(THOUSAND).toNumber();
+  }
+  /** The rate in grams per mile, e.g. `355.66`. */
+  get gramsPerMile() {
+    return this.exactGramsPerKm.times(KM_PER_MILE).toNumber();
+  }
+  static fromGramsPerKm(value) {
+    const amount = positive(value);
+    return new EmissionRate(amount, `${formatQuantityDecimal(amount)} g/km`);
+  }
+  static fromMilligramsPerKm(value) {
+    const amount = positive(value);
+    return new EmissionRate(amount.dividedBy(THOUSAND), `${formatQuantityDecimal(amount)} mg/km`);
+  }
+  static fromUnit(amount, unitRaw) {
+    switch (unitRaw.toLowerCase()) {
+      case "g/km":
+        return new EmissionRate(amount, `${formatQuantityDecimal(amount)} g/km`);
+      case "mg/km":
+        return new EmissionRate(
+          amount.dividedBy(THOUSAND),
+          `${formatQuantityDecimal(amount)} mg/km`
+        );
+      case "g/mi":
+      case "g/mile":
+        return new EmissionRate(
+          round(amount.dividedBy(KM_PER_MILE)),
+          `${formatQuantityDecimal(amount)} g/mi`
+        );
+      case "mg/mi":
+        return new EmissionRate(
+          round(amount.dividedBy(THOUSAND).dividedBy(KM_PER_MILE)),
+          `${formatQuantityDecimal(amount)} mg/mi`
+        );
+      default:
+        return null;
+    }
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = sanitizeInput(input).trim();
+    const match = PATTERN.exec(trimmed);
+    if (match !== null) {
+      const amount = tryParseNumberOnly(match[1]);
+      if (amount === null || amount.compareTo(Decimal.zero) <= 0) return null;
+      return EmissionRate.fromUnit(amount, match[2]);
+    }
+    const bare = tryParseNumberOnly(trimmed);
+    if (bare === null || bare.compareTo(Decimal.zero) <= 0) return null;
+    return new EmissionRate(bare, `${formatQuantityDecimal(bare)} g/km`);
+  }
+  static parse(input) {
+    const result = EmissionRate.tryParse(input);
+    if (result === null) throw new Error("Invalid emission rate.");
+    return result;
+  }
+  static isValid(input) {
+    return EmissionRate.tryParse(input) !== null;
+  }
+  /** Returns the display form in the parsed unit, e.g. `95.7 mg/km`. */
+  static format(input, options) {
+    const parsed = EmissionRate.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  /** Returns the value in g/km, e.g. `221 g/km`. */
+  static normalize(input, options) {
+    const parsed = EmissionRate.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && EmissionRate.normalize(input) === input;
+  }
+  /** Finds emission rates in unstructured text, e.g. `221 g/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 = EmissionRate.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "EmissionRate",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEmissionRate(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the value in g/km, e.g. `221 g/km`. */
+  toNormalizedString() {
+    return `${formatQuantityDecimal(this.exactGramsPerKm)} g/km`;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.exactGramsPerKm.equals(other.exactGramsPerKm);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.exactGramsPerKm.compareTo(other.exactGramsPerKm);
+  }
+}
+function maskEmissionRate(rate) {
+  const separator = rate.value.indexOf(" ");
+  if (separator < 0) return "*".repeat(rate.value.length);
+  return `*** ${rate.value.slice(separator + 1)}`;
+}
+function round(value) {
+  return value.round(CONVERSION_PRECISION, "half-even");
+}
+function positive(value) {
+  const amount = value instanceof Decimal ? value : Decimal.fromNumber(value);
+  if (amount === null) throw new Error(`Value cannot be represented as an emission rate: ${value}`);
+  if (amount.compareTo(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;
+}
+export {
+  EmissionRate,
+  maskEmissionRate
+};
+//# sourceMappingURL=emission-rate.js.map

package/dist/esm/vehicle/emission-rate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/emission-rate.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 EmissionRate.format} and {@link EmissionRate.normalize}. */\nexport interface EmissionRateFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst KM_PER_MILE = Decimal.parse(\"1.60934\")!;\nconst THOUSAND = Decimal.parse(\"1000\")!;\nconst CONVERSION_PRECISION = 6;\n\nconst PATTERN = /^\\s*([0-9][0-9 .,]*[0-9]|[0-9])\\s*(g\\/km|mg\\/km|g\\/mi|g\\/mile|mg\\/mi)\\s*$/iu;\n\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])\\d+[0-9 .,]*\\s*(?:g\\/km|mg\\/km|g\\/mi(?:le)?|mg\\/mi)(?![\\p{L}\\p{N}_])/giu;\n\n/**\n * A vehicle emission rate (`utsl\u00E4pp`) such as CO\u2082 per distance, held as grams per\n * kilometre. Accepts `g/km`, `mg/km`, `g/mi` and `mg/mi`; a bare number is read as\n * grams per kilometre.\n *\n * Sources:\n * - https://en.wikipedia.org/wiki/European_emission_standards\n * - https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle\n */\nexport class EmissionRate {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Emission Rate\",\n    localizedName: \"Utsl\u00E4pp\",\n    emoji: \"\uD83D\uDCA8\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/European_emission_standards\",\n      \"https://www.epa.gov/greenvehicles/greenhouse-gas-emissions-typical-passenger-vehicle\",\n    ]),\n  });\n\n  /** Display form preserving the parsed unit, e.g. `221 g/km`. */\n  readonly value: string;\n\n  private readonly exactGramsPerKm: Decimal;\n\n  private constructor(gramsPerKm: Decimal, value: string) {\n    this.exactGramsPerKm = gramsPerKm;\n    this.value = value;\n  }\n\n  /** The rate in grams per kilometre, e.g. `221`. */\n  get gramsPerKm(): number {\n    return this.exactGramsPerKm.toNumber();\n  }\n\n  /** The rate in milligrams per kilometre, e.g. `95700`. */\n  get milligramsPerKm(): number {\n    return this.exactGramsPerKm.times(THOUSAND).toNumber();\n  }\n\n  /** The rate in grams per mile, e.g. `355.66`. */\n  get gramsPerMile(): number {\n    return this.exactGramsPerKm.times(KM_PER_MILE).toNumber();\n  }\n\n  static fromGramsPerKm(value: number | Decimal): EmissionRate {\n    const amount = positive(value);\n    return new EmissionRate(amount, `${formatQuantityDecimal(amount)} g/km`);\n  }\n\n  static fromMilligramsPerKm(value: number | Decimal): EmissionRate {\n    const amount = positive(value);\n    return new EmissionRate(amount.dividedBy(THOUSAND), `${formatQuantityDecimal(amount)} mg/km`);\n  }\n\n  private static fromUnit(amount: Decimal, unitRaw: string): EmissionRate | null {\n    switch (unitRaw.toLowerCase()) {\n      case \"g/km\":\n        return new EmissionRate(amount, `${formatQuantityDecimal(amount)} g/km`);\n      case \"mg/km\":\n        return new EmissionRate(\n          amount.dividedBy(THOUSAND),\n          `${formatQuantityDecimal(amount)} mg/km`,\n        );\n      case \"g/mi\":\n      case \"g/mile\":\n        return new EmissionRate(\n          round(amount.dividedBy(KM_PER_MILE)),\n          `${formatQuantityDecimal(amount)} g/mi`,\n        );\n      case \"mg/mi\":\n        return new EmissionRate(\n          round(amount.dividedBy(THOUSAND).dividedBy(KM_PER_MILE)),\n          `${formatQuantityDecimal(amount)} mg/mi`,\n        );\n      default:\n        return null;\n    }\n  }\n\n  static tryParse(input: string | null | undefined): EmissionRate | 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 EmissionRate.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 EmissionRate(bare, `${formatQuantityDecimal(bare)} g/km`);\n  }\n\n  static parse(input: string): EmissionRate {\n    const result = EmissionRate.tryParse(input);\n    if (result === null) throw new Error(\"Invalid emission rate.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return EmissionRate.tryParse(input) !== null;\n  }\n\n  /** Returns the display form in the parsed unit, e.g. `95.7 mg/km`. */\n  static format(\n    input: string | null | undefined,\n    options?: EmissionRateFormatOptions,\n  ): string | null {\n    const parsed = EmissionRate.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the value in g/km, e.g. `221 g/km`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: EmissionRateFormatOptions,\n  ): string | null {\n    const parsed = EmissionRate.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 && EmissionRate.normalize(input) === input;\n  }\n\n  /** Finds emission rates in unstructured text, e.g. `221 g/km`. */\n  static findCandidatesInText(text: string): readonly TextCandidate<EmissionRate>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<EmissionRate>[] = [];\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 = EmissionRate.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<EmissionRate>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"EmissionRate\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskEmissionRate(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the value in g/km, e.g. `221 g/km`. */\n  toNormalizedString(): string {\n    return `${formatQuantityDecimal(this.exactGramsPerKm)} g/km`;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: EmissionRate | null | undefined): boolean {\n    return other != null && this.exactGramsPerKm.equals(other.exactGramsPerKm);\n  }\n\n  compareTo(other: EmissionRate | null | undefined): number {\n    if (other == null) return 1;\n    return this.exactGramsPerKm.compareTo(other.exactGramsPerKm);\n  }\n}\n\n/** Returns a masked emission rate, e.g. `221 g/km` becomes `*** g/km`. */\nexport function maskEmissionRate(rate: EmissionRate): string {\n  const separator = rate.value.indexOf(\" \");\n  if (separator < 0) return \"*\".repeat(rate.value.length);\n  return `*** ${rate.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 an emission rate: ${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?: EmissionRateFormatOptions,\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/energy-consumption.js

@@ -0,0 +1,230 @@
+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 { 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 KILOMETRES_PER_MILE = Decimal.parse("1.609344");
+const HUNDRED = Decimal.parse("100");
+const TEN = 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(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", `${formatQuantityDecimal(amount)} kWh/100km`);
+  }
+  static fromWhPerKm(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(amount.dividedBy(TEN)),
+      "Wh/km",
+      `${formatQuantityDecimal(amount)} Wh/km`
+    );
+  }
+  static fromKwhPerKm(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(amount.times(HUNDRED)),
+      "kWh/km",
+      `${formatQuantityDecimal(amount)} kWh/km`
+    );
+  }
+  static fromMilesPerKwh(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(HUNDRED.dividedBy(amount.times(KILOMETRES_PER_MILE))),
+      "mi/kWh",
+      `${formatQuantityDecimal(amount)} mi/kWh`
+    );
+  }
+  static fromKwhPerMile(value) {
+    const amount = positive(value);
+    return new EnergyConsumption(
+      round(amount.times(HUNDRED).dividedBy(KILOMETRES_PER_MILE)),
+      "kWh/mi",
+      `${formatQuantityDecimal(amount)} kWh/mi`
+    );
+  }
+  static fromUnit(amount, unitRaw) {
+    const unit = unitRaw.toLowerCase().replaceAll(" ", "");
+    switch (unit) {
+      case "kwh/100km":
+        return new EnergyConsumption(
+          amount,
+          "kWh/100km",
+          `${formatQuantityDecimal(amount)} kWh/100km`
+        );
+      case "kwh/km":
+        return new EnergyConsumption(
+          round(amount.times(HUNDRED)),
+          "kWh/km",
+          `${formatQuantityDecimal(amount)} kWh/km`
+        );
+      case "wh/km":
+        return new EnergyConsumption(
+          round(amount.dividedBy(TEN)),
+          "Wh/km",
+          `${formatQuantityDecimal(amount)} Wh/km`
+        );
+      case "mi/kwh":
+      case "miles/kwh":
+        return new EnergyConsumption(
+          round(HUNDRED.dividedBy(amount.times(KILOMETRES_PER_MILE))),
+          "mi/kWh",
+          `${formatQuantityDecimal(amount)} mi/kWh`
+        );
+      case "kwh/mi":
+      case "kwh/mile":
+        return new EnergyConsumption(
+          round(amount.times(HUNDRED).dividedBy(KILOMETRES_PER_MILE)),
+          "kWh/mi",
+          `${formatQuantityDecimal(amount)} kWh/mi`
+        );
+      default:
+        return null;
+    }
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = sanitizeInput(input).trim();
+    const match = PATTERN.exec(trimmed);
+    if (match !== null) {
+      const amount = tryParseNumberOnly(match[1]);
+      if (amount === null || amount.compareTo(Decimal.zero) <= 0) return null;
+      return EnergyConsumption.fromUnit(amount, match[2]);
+    }
+    const bare = tryParseNumberOnly(trimmed);
+    if (bare === null || bare.compareTo(Decimal.zero) <= 0) return null;
+    return new EnergyConsumption(bare, "kWh/100km", `${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 TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "EnergyConsumption",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskEnergyConsumption(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the value in kWh/100km, e.g. `15 kWh/100km`. */
+  toNormalizedString() {
+    return `${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 Decimal ? value : Decimal.fromNumber(value);
+  if (amount === null) throw new Error(`Value cannot be represented as a consumption: ${value}`);
+  if (amount.compareTo(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;
+}
+export {
+  EnergyConsumption,
+  maskEnergyConsumption
+};
+//# sourceMappingURL=energy-consumption.js.map