@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/transmission-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 TransmissionTypeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\ninterface TransmissionTypeDef {\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly rank: number;\n}\n\n/** A vehicle transmission/gearbox type (`v\u00E4xell\u00E5da`). */\nexport class TransmissionType {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Transmission Type\",\n    localizedName: \"V\u00E4xell\u00E5da\",\n    emoji: \"\u2699\uFE0F\",\n    sources: Object.freeze([\"https://www.transportstyrelsen.se/\"]),\n  });\n\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n\n  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */\n  private readonly rank: number;\n\n  private constructor(def: TransmissionTypeDef) {\n    this.value = def.value;\n    this.englishName = def.englishName;\n    this.localizedName = def.localizedName;\n    this.rank = def.rank;\n  }\n\n  static readonly Manual = new TransmissionType({\n    value: \"Manual\",\n    englishName: \"Manual\",\n    localizedName: \"Manuell\",\n    rank: 4,\n  });\n\n  static readonly Automatic = new TransmissionType({\n    value: \"Automatic\",\n    englishName: \"Automatic\",\n    localizedName: \"Automat\",\n    rank: 1,\n  });\n\n  static readonly Cvt = new TransmissionType({\n    value: \"CVT\",\n    englishName: \"CVT\",\n    localizedName: \"CVT\",\n    rank: 2,\n  });\n\n  static readonly DualClutch = new TransmissionType({\n    value: \"Dual clutch\",\n    englishName: \"Dual clutch\",\n    localizedName: \"Dubbelkoppling\",\n    rank: 3,\n  });\n\n  static readonly Sequential = new TransmissionType({\n    value: \"Sequential\",\n    englishName: \"Sequential\",\n    localizedName: \"Sekventiell\",\n    rank: 6,\n  });\n\n  static readonly SemiAutomatic = new TransmissionType({\n    value: \"Semi-automatic\",\n    englishName: \"Semi-automatic\",\n    localizedName: \"Halvautomatisk\",\n    rank: 5,\n  });\n\n  static readonly Amt = new TransmissionType({\n    value: \"AMT\",\n    englishName: \"AMT\",\n    localizedName: \"AMT\",\n    rank: 0,\n  });\n\n  /** All 7 values, in canonical order. */\n  static get all(): readonly TransmissionType[] {\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): TransmissionType | 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): TransmissionType {\n    const result = TransmissionType.tryParse(input);\n    if (result === null) throw new Error(`Invalid transmission type.`);\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return TransmissionType.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: TransmissionTypeFormatOptions,\n  ): string | null {\n    const r = TransmissionType.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?: TransmissionTypeFormatOptions,\n  ): string | null {\n    const r = TransmissionType.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 && TransmissionType.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: TransmissionType | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: TransmissionType | 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 TransmissionType[] = [\n  TransmissionType.Manual,\n  TransmissionType.Automatic,\n  TransmissionType.Cvt,\n  TransmissionType.DualClutch,\n  TransmissionType.Sequential,\n  TransmissionType.SemiAutomatic,\n  TransmissionType.Amt,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: TransmissionTypeFormatOptions,\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.trim();\n}\n\nconst ALIASES: readonly (readonly [TransmissionType, readonly string[]])[] = [\n  [\n    TransmissionType.Manual,\n    [\n      \"handvaxel\",\n      \"handvaxlad\",\n      \"m t\",\n      \"manual\",\n      \"manuell\",\n      \"manuell manual\",\n      \"manuell vaxellada\",\n      \"standard\",\n      \"stick\",\n    ],\n  ],\n  [\n    TransmissionType.Automatic,\n    [\n      \"a t\",\n      \"auto\",\n      \"automat\",\n      \"automatic\",\n      \"automatiserad\",\n      \"automatisk\",\n      \"automatisk vaxellada\",\n      \"automatvaxlad\",\n      \"momentomvandlare\",\n      \"tiptronic\",\n      \"torque converter\",\n    ],\n  ],\n  [\n    TransmissionType.Cvt,\n    [\n      \"continuously variable\",\n      \"cvt\",\n      \"e cvt\",\n      \"lineartronic\",\n      \"multitronic\",\n      \"steglos\",\n      \"variator\",\n      \"variomatic\",\n      \"xtronic\",\n    ],\n  ],\n  [\n    TransmissionType.DualClutch,\n    [\n      \"dct\",\n      \"dsg\",\n      \"dual clutch\",\n      \"dubbelkoppling\",\n      \"dubbelkopplingslada\",\n      \"edc\",\n      \"pdk\",\n      \"powershift\",\n      \"s tronic\",\n      \"twinclutch\",\n    ],\n  ],\n  [\n    TransmissionType.Sequential,\n    [\"sekvensiell\", \"sekventiell\", \"sekventiell vaxellada\", \"sequential\", \"smg\"],\n  ],\n  [\n    TransmissionType.SemiAutomatic,\n    [\n      \"automated manual\",\n      \"halvautomatisk\",\n      \"halvautomatvaxlad\",\n      \"semi automat\",\n      \"semi automatic\",\n      \"semi automatisk\",\n    ],\n  ],\n  [\n    TransmissionType.Amt,\n    [\n      \"amt\",\n      \"automated manual transmission\",\n      \"automatiserad manuell\",\n      \"easytronic\",\n      \"imt\",\n      \"robotized\",\n    ],\n  ],\n];\n\nconst LOOKUP = new Map<string, TransmissionType>();\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/vehicle-extensions.js

@@ -0,0 +1,15 @@
+function toBiluppgifterUrl(registration) {
+  return `https://biluppgifter.se/fordon/${registration.toNormalizedString()}`;
+}
+function getBiluppgifterUrl(registration) {
+  return new URL(`https://biluppgifter.se/fordon/${registration.value}`);
+}
+function getCarInfoUrl(registration) {
+  return new URL(`https://www.car.info/sv-se/license-plate/S/${registration.value}`);
+}
+export {
+  getBiluppgifterUrl,
+  getCarInfoUrl,
+  toBiluppgifterUrl
+};
+//# sourceMappingURL=vehicle-extensions.js.map

package/dist/esm/vehicle/vehicle-extensions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/vehicle-extensions.ts"],
+  "sourcesContent": ["import type { SwedishVehicleRegistrationNumber } from \"./swedish-vehicle-registration-number.js\";\n\n/** Returns the Biluppgifter.se lookup URL as a string. */\nexport function toBiluppgifterUrl(registration: SwedishVehicleRegistrationNumber): string {\n  return `https://biluppgifter.se/fordon/${registration.toNormalizedString()}`;\n}\n\n/** Returns the Biluppgifter.se vehicle-information URL. */\nexport function getBiluppgifterUrl(registration: SwedishVehicleRegistrationNumber): URL {\n  return new URL(`https://biluppgifter.se/fordon/${registration.value}`);\n}\n\n/** Returns the Car.info vehicle-information URL. */\nexport function getCarInfoUrl(registration: SwedishVehicleRegistrationNumber): URL {\n  return new URL(`https://www.car.info/sv-se/license-plate/S/${registration.value}`);\n}\n"],
+  "mappings": "AAGO,SAAS,kBAAkB,cAAwD;AACxF,SAAO,kCAAkC,aAAa,mBAAmB,CAAC;AAC5E;AAGO,SAAS,mBAAmB,cAAqD;AACtF,SAAO,IAAI,IAAI,kCAAkC,aAAa,KAAK,EAAE;AACvE;AAGO,SAAS,cAAc,cAAqD;AACjF,SAAO,IAAI,IAAI,8CAA8C,aAAa,KAAK,EAAE;AACnF;",
+  "names": []
+}

package/dist/esm/vehicle/vehicle-identification-number.js

@@ -0,0 +1,248 @@
+import { sanitizeInput } from "../internal/input-sanitization.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";
+import { ValidationErrorReason } from "../validation/validation-error-reason.js";
+import {
+  invalidResult,
+  validResult
+} from "../validation/validation-result.js";
+const MAX_INPUT_LENGTH = 30;
+const VIN_PATTERN = /^[A-HJ-NPR-Z0-9]{17}$/u;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])[A-HJ-NPR-Z0-9]{17}(?![\p{L}\p{N}_])/giu;
+const WEIGHTS = [8, 7, 6, 5, 4, 3, 2, 10, 0, 9, 8, 7, 6, 5, 4, 3, 2];
+const TRANSLITERATION = Object.freeze({
+  A: 1,
+  B: 2,
+  C: 3,
+  D: 4,
+  E: 5,
+  F: 6,
+  G: 7,
+  H: 8,
+  J: 1,
+  K: 2,
+  L: 3,
+  M: 4,
+  N: 5,
+  P: 7,
+  R: 9,
+  S: 2,
+  T: 3,
+  U: 4,
+  V: 5,
+  W: 6,
+  X: 7,
+  Y: 8,
+  Z: 9
+});
+const MODEL_YEAR_MAP = Object.freeze({
+  A: [1980, 2010],
+  B: [1981, 2011],
+  C: [1982, 2012],
+  D: [1983, 2013],
+  E: [1984, 2014],
+  F: [1985, 2015],
+  G: [1986, 2016],
+  H: [1987, 2017],
+  J: [1988, 2018],
+  K: [1989, 2019],
+  L: [1990, 2020],
+  M: [1991, 2021],
+  N: [1992, 2022],
+  P: [1993, 2023],
+  R: [1994, 2024],
+  S: [1995, 2025],
+  T: [1996, 2026],
+  V: [1997, 2027],
+  W: [1998, 2028],
+  X: [1999, 2029],
+  Y: [2e3, 2030],
+  "1": [2001, 2031],
+  "2": [2002, 2032],
+  "3": [2003, 2033],
+  "4": [2004, 2034],
+  "5": [2005, 2035],
+  "6": [2006, 2036],
+  "7": [2007, 2037],
+  "8": [2008, 2038],
+  "9": [2009, 2039]
+});
+class VehicleIdentificationNumber {
+  static typeInfo = Object.freeze({
+    englishName: "VIN",
+    localizedName: "Chassinummer",
+    emoji: "\u{1F527}",
+    sources: Object.freeze([
+      "https://www.iso.org/standard/52200.html",
+      "https://en.wikipedia.org/wiki/Vehicle_identification_number",
+      "https://en.wikibooks.org/wiki/Vehicle_Identification_Numbers_(VIN_codes)/Check_digit"
+    ])
+  });
+  /** The 17-character VIN in uppercase, e.g. `WBA3A5C55CF256789`. */
+  value;
+  /** World Manufacturer Identifier — positions 1–3. */
+  wmi;
+  /** Vehicle Descriptor Section — positions 4–8. */
+  vds;
+  /** The check digit at position 9 (a digit or `X`). */
+  checkDigit;
+  /** Vehicle Indicator Section — positions 10–17. */
+  vis;
+  /** The model year code at position 10. */
+  modelYearCode;
+  /** The model years the code at position 10 can encode, e.g. `M` means 1991 or 2021. */
+  modelYears;
+  /** The assembly plant code at position 11. */
+  assemblyPlantCode;
+  /** The sequential production number — positions 12–17. */
+  sequentialNumber;
+  /** Whether position 9 passes the ISO 3779 MOD-11 check. */
+  hasValidCheckDigit;
+  constructor(value, hasValidCheckDigit2) {
+    this.value = value;
+    this.wmi = value.slice(0, 3);
+    this.vds = value.slice(3, 8);
+    this.checkDigit = value[8];
+    this.vis = value.slice(9);
+    this.modelYearCode = value[9];
+    this.assemblyPlantCode = value[10];
+    this.sequentialNumber = value.slice(11);
+    this.hasValidCheckDigit = hasValidCheckDigit2;
+    this.modelYears = MODEL_YEAR_MAP[this.modelYearCode] ?? [];
+  }
+  static tryParse(input) {
+    const cleaned = clean(input);
+    if (cleaned === null || cleaned.length !== 17 || !VIN_PATTERN.test(cleaned)) return null;
+    return new VehicleIdentificationNumber(cleaned, hasValidCheckDigit(cleaned));
+  }
+  static parse(input) {
+    const result = VehicleIdentificationNumber.tryParse(input);
+    if (result === null) throw new Error("Invalid Vehicle Identification Number (VIN).");
+    return result;
+  }
+  static isValid(input) {
+    return VehicleIdentificationNumber.tryParse(input) !== null;
+  }
+  /** Returns the VIN in uppercase without separators, e.g. `WBA3A5C55CF256789`. */
+  static format(input, options) {
+    const parsed = VehicleIdentificationNumber.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  /** Returns the VIN in uppercase without separators, e.g. `WBA3A5C55CF256789`. */
+  static normalize(input, options) {
+    const parsed = VehicleIdentificationNumber.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && VehicleIdentificationNumber.normalize(input) === input;
+  }
+  /** Describes why the input is not a VIN, or reports it as valid. */
+  static validate(input) {
+    if (input == null || input.trim() === "") {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputIsEmpty,
+        "Input is empty or whitespace.",
+        "V\xE4rdet \xE4r tomt."
+      );
+    }
+    const cleaned = clean(input);
+    if (cleaned.length > MAX_INPUT_LENGTH) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputTooLong,
+        "Input contains too many characters.",
+        "V\xE4rdet inneh\xE5ller f\xF6r m\xE5nga tecken."
+      );
+    }
+    if (cleaned.length !== 17) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidLength,
+        "VIN must be exactly 17 characters.",
+        "VIN m\xE5ste vara exakt 17 tecken."
+      );
+    }
+    if (!VIN_PATTERN.test(cleaned)) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidCharacters,
+        "VIN contains invalid characters (I, O, Q are not allowed).",
+        "VIN inneh\xE5ller ogiltiga tecken (I, O, Q \xE4r inte till\xE5tna)."
+      );
+    }
+    return validResult(input);
+  }
+  /** Finds VIN candidates in unstructured text. */
+  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 = VehicleIdentificationNumber.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: text.slice(match.index, match.index + match[0].length),
+          typeName: "VehicleIdentificationNumber",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskVehicleIdentificationNumber(value),
+          confidence: value.hasValidCheckDigit ? TextMatchConfidence.High : TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the 17-character VIN in uppercase, e.g. `WBA3A5C55CF256789`. */
+  toNormalizedString() {
+    return this.value;
+  }
+  /** Returns the 17-character VIN in uppercase, e.g. `WBA3A5C55CF256789`. */
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+}
+function maskVehicleIdentificationNumber(vin) {
+  return vin.wmi + "*".repeat(vin.value.length - vin.wmi.length);
+}
+function hasValidCheckDigit(vin) {
+  let sum = 0;
+  for (let i = 0; i < 17; i++) {
+    const c = vin[i];
+    const value = c >= "0" && c <= "9" ? c.charCodeAt(0) - 48 : TRANSLITERATION[c];
+    if (value === void 0) return false;
+    sum += value * WEIGHTS[i];
+  }
+  const remainder = sum % 11;
+  return vin[8] === (remainder === 10 ? "X" : String(remainder));
+}
+function clean(input) {
+  if (input == null || input.trim().length === 0) return null;
+  return sanitizeInput(input).trim().toUpperCase().replaceAll(" ", "").replaceAll("-", "");
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  VehicleIdentificationNumber,
+  maskVehicleIdentificationNumber
+};
+//# sourceMappingURL=vehicle-identification-number.js.map

package/dist/esm/vehicle/vehicle-identification-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/vehicle-identification-number.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.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\";\nimport { ValidationErrorReason } from \"../validation/validation-error-reason.js\";\nimport {\n  invalidResult,\n  validResult,\n  type ValidationResult,\n} from \"../validation/validation-result.js\";\n\n/** Options for {@link VehicleIdentificationNumber.format} and `normalize`. */\nexport interface VehicleIdentificationNumberFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MAX_INPUT_LENGTH = 30;\n\n// I, O and Q are excluded so they cannot be confused with 1 and 0.\nconst VIN_PATTERN = /^[A-HJ-NPR-Z0-9]{17}$/u;\nconst SCAN_PATTERN = /(?<![\\p{L}\\p{N}_])[A-HJ-NPR-Z0-9]{17}(?![\\p{L}\\p{N}_])/giu;\n\nconst WEIGHTS = [8, 7, 6, 5, 4, 3, 2, 10, 0, 9, 8, 7, 6, 5, 4, 3, 2];\n\nconst TRANSLITERATION: Readonly<Record<string, number>> = Object.freeze({\n  A: 1,\n  B: 2,\n  C: 3,\n  D: 4,\n  E: 5,\n  F: 6,\n  G: 7,\n  H: 8,\n  J: 1,\n  K: 2,\n  L: 3,\n  M: 4,\n  N: 5,\n  P: 7,\n  R: 9,\n  S: 2,\n  T: 3,\n  U: 4,\n  V: 5,\n  W: 6,\n  X: 7,\n  Y: 8,\n  Z: 9,\n});\n\n// ISO 3779 / SAE J853 model year encoding; the cycle repeats every 30 years.\nconst MODEL_YEAR_MAP: Readonly<Record<string, readonly number[]>> = Object.freeze({\n  A: [1980, 2010],\n  B: [1981, 2011],\n  C: [1982, 2012],\n  D: [1983, 2013],\n  E: [1984, 2014],\n  F: [1985, 2015],\n  G: [1986, 2016],\n  H: [1987, 2017],\n  J: [1988, 2018],\n  K: [1989, 2019],\n  L: [1990, 2020],\n  M: [1991, 2021],\n  N: [1992, 2022],\n  P: [1993, 2023],\n  R: [1994, 2024],\n  S: [1995, 2025],\n  T: [1996, 2026],\n  V: [1997, 2027],\n  W: [1998, 2028],\n  X: [1999, 2029],\n  Y: [2000, 2030],\n  \"1\": [2001, 2031],\n  \"2\": [2002, 2032],\n  \"3\": [2003, 2033],\n  \"4\": [2004, 2034],\n  \"5\": [2005, 2035],\n  \"6\": [2006, 2036],\n  \"7\": [2007, 2037],\n  \"8\": [2008, 2038],\n  \"9\": [2009, 2039],\n});\n\n/**\n * A Vehicle Identification Number (VIN), also known as a chassis number\n * (`chassinummer`): the 17-character ISO 3779 code that uniquely identifies a motor\n * vehicle. Position 9 holds a MOD-11 check digit, mandatory in North America and\n * common but not universal in Europe.\n *\n * Sources:\n * - https://www.iso.org/standard/52200.html\n * - https://en.wikipedia.org/wiki/Vehicle_identification_number\n * - https://en.wikibooks.org/wiki/Vehicle_Identification_Numbers_(VIN_codes)/Check_digit\n */\nexport class VehicleIdentificationNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"VIN\",\n    localizedName: \"Chassinummer\",\n    emoji: \"\uD83D\uDD27\",\n    sources: Object.freeze([\n      \"https://www.iso.org/standard/52200.html\",\n      \"https://en.wikipedia.org/wiki/Vehicle_identification_number\",\n      \"https://en.wikibooks.org/wiki/Vehicle_Identification_Numbers_(VIN_codes)/Check_digit\",\n    ]),\n  });\n\n  /** The 17-character VIN in uppercase, e.g. `WBA3A5C55CF256789`. */\n  readonly value: string;\n\n  /** World Manufacturer Identifier \u2014 positions 1\u20133. */\n  readonly wmi: string;\n\n  /** Vehicle Descriptor Section \u2014 positions 4\u20138. */\n  readonly vds: string;\n\n  /** The check digit at position 9 (a digit or `X`). */\n  readonly checkDigit: string;\n\n  /** Vehicle Indicator Section \u2014 positions 10\u201317. */\n  readonly vis: string;\n\n  /** The model year code at position 10. */\n  readonly modelYearCode: string;\n\n  /** The model years the code at position 10 can encode, e.g. `M` means 1991 or 2021. */\n  readonly modelYears: readonly number[];\n\n  /** The assembly plant code at position 11. */\n  readonly assemblyPlantCode: string;\n\n  /** The sequential production number \u2014 positions 12\u201317. */\n  readonly sequentialNumber: string;\n\n  /** Whether position 9 passes the ISO 3779 MOD-11 check. */\n  readonly hasValidCheckDigit: boolean;\n\n  private constructor(value: string, hasValidCheckDigit: boolean) {\n    this.value = value;\n    this.wmi = value.slice(0, 3);\n    this.vds = value.slice(3, 8);\n    this.checkDigit = value[8]!;\n    this.vis = value.slice(9);\n    this.modelYearCode = value[9]!;\n    this.assemblyPlantCode = value[10]!;\n    this.sequentialNumber = value.slice(11);\n    this.hasValidCheckDigit = hasValidCheckDigit;\n    this.modelYears = MODEL_YEAR_MAP[this.modelYearCode] ?? [];\n  }\n\n  static tryParse(input: string | null | undefined): VehicleIdentificationNumber | null {\n    const cleaned = clean(input);\n    if (cleaned === null || cleaned.length !== 17 || !VIN_PATTERN.test(cleaned)) return null;\n    return new VehicleIdentificationNumber(cleaned, hasValidCheckDigit(cleaned));\n  }\n\n  static parse(input: string): VehicleIdentificationNumber {\n    const result = VehicleIdentificationNumber.tryParse(input);\n    if (result === null) throw new Error(\"Invalid Vehicle Identification Number (VIN).\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return VehicleIdentificationNumber.tryParse(input) !== null;\n  }\n\n  /** Returns the VIN in uppercase without separators, e.g. `WBA3A5C55CF256789`. */\n  static format(\n    input: string | null | undefined,\n    options?: VehicleIdentificationNumberFormatOptions,\n  ): string | null {\n    const parsed = VehicleIdentificationNumber.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the VIN in uppercase without separators, e.g. `WBA3A5C55CF256789`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: VehicleIdentificationNumberFormatOptions,\n  ): string | null {\n    const parsed = VehicleIdentificationNumber.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && VehicleIdentificationNumber.normalize(input) === input;\n  }\n\n  /** Describes why the input is not a VIN, or reports it as valid. */\n  static validate(input: string | null | undefined): ValidationResult {\n    if (input == null || input.trim() === \"\") {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputIsEmpty,\n        \"Input is empty or whitespace.\",\n        \"V\u00E4rdet \u00E4r tomt.\",\n      );\n    }\n\n    const cleaned = clean(input)!;\n\n    if (cleaned.length > MAX_INPUT_LENGTH) {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputTooLong,\n        \"Input contains too many characters.\",\n        \"V\u00E4rdet inneh\u00E5ller f\u00F6r m\u00E5nga tecken.\",\n      );\n    }\n\n    if (cleaned.length !== 17) {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidLength,\n        \"VIN must be exactly 17 characters.\",\n        \"VIN m\u00E5ste vara exakt 17 tecken.\",\n      );\n    }\n\n    if (!VIN_PATTERN.test(cleaned)) {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidCharacters,\n        \"VIN contains invalid characters (I, O, Q are not allowed).\",\n        \"VIN inneh\u00E5ller ogiltiga tecken (I, O, Q \u00E4r inte till\u00E5tna).\",\n      );\n    }\n\n    return validResult(input);\n  }\n\n  /** Finds VIN candidates in unstructured text. */\n  static findCandidatesInText(text: string): readonly TextCandidate<VehicleIdentificationNumber>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<VehicleIdentificationNumber>[] = [];\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 = VehicleIdentificationNumber.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<VehicleIdentificationNumber>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: text.slice(match.index, match.index + match[0].length),\n          typeName: \"VehicleIdentificationNumber\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskVehicleIdentificationNumber(value),\n          confidence: value.hasValidCheckDigit\n            ? TextMatchConfidence.High\n            : TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the 17-character VIN in uppercase, e.g. `WBA3A5C55CF256789`. */\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  /** Returns the 17-character VIN in uppercase, e.g. `WBA3A5C55CF256789`. */\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: VehicleIdentificationNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: VehicleIdentificationNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\n/** Returns a VIN with only the manufacturer prefix visible, e.g. `WBA**************`. */\nexport function maskVehicleIdentificationNumber(vin: VehicleIdentificationNumber): string {\n  return vin.wmi + \"*\".repeat(vin.value.length - vin.wmi.length);\n}\n\nfunction hasValidCheckDigit(vin: string): boolean {\n  let sum = 0;\n  for (let i = 0; i < 17; i++) {\n    const c = vin[i]!;\n    const value = c >= \"0\" && c <= \"9\" ? c.charCodeAt(0) - 48 : TRANSLITERATION[c];\n    if (value === undefined) return false;\n    sum += value * WEIGHTS[i]!;\n  }\n\n  const remainder = sum % 11;\n  return vin[8] === (remainder === 10 ? \"X\" : String(remainder));\n}\n\nfunction clean(input: string | null | undefined): string | null {\n  if (input == null || input.trim().length === 0) return null;\n  return sanitizeInput(input).trim().toUpperCase().replaceAll(\" \", \"\").replaceAll(\"-\", \"\");\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: VehicleIdentificationNumberFormatOptions,\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": ["hasValidCheckDigit"]
+}

package/dist/esm/vehicle/vehicle-masking.js

@@ -0,0 +1,48 @@
+const MASK_CHAR = "*";
+function maskBoatCeDesignCategory(category) {
+  return MASK_CHAR.repeat(category.value.length);
+}
+function maskBoatHullMaterial(material) {
+  return MASK_CHAR.repeat(material.value.length);
+}
+function maskBodyType(bodyType) {
+  return MASK_CHAR.repeat(bodyType.value.length);
+}
+function maskDrivetrainType(drivetrain) {
+  return MASK_CHAR.repeat(drivetrain.value.length);
+}
+function maskFuelConsumptionNorm(norm) {
+  return MASK_CHAR.repeat(norm.value.length);
+}
+function maskSuspensionType(suspension) {
+  return maskExcept(suspension.value, " /");
+}
+function maskSwedishEcoVehicleClassification(classification) {
+  const value = classification.value;
+  const space = value.indexOf(" ");
+  if (space < 0) return MASK_CHAR.repeat(value.length);
+  return `${value.slice(0, space)} ${MASK_CHAR.repeat(value.length - space - 1)}`;
+}
+function maskTireType(tireType) {
+  return maskExcept(tireType.value, " ()-");
+}
+function maskTrackType(track) {
+  return maskExcept(track.value, " -");
+}
+function maskExcept(value, keep) {
+  let out = "";
+  for (const char of value) out += keep.includes(char) ? char : MASK_CHAR;
+  return out;
+}
+export {
+  maskBoatCeDesignCategory,
+  maskBoatHullMaterial,
+  maskBodyType,
+  maskDrivetrainType,
+  maskFuelConsumptionNorm,
+  maskSuspensionType,
+  maskSwedishEcoVehicleClassification,
+  maskTireType,
+  maskTrackType
+};
+//# sourceMappingURL=vehicle-masking.js.map

package/dist/esm/vehicle/vehicle-masking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/vehicle-masking.ts"],
+  "sourcesContent": ["import { BoatCeDesignCategory } from \"./boat-ce-design-category.js\";\nimport { BoatHullMaterial } from \"./boat-hull-material.js\";\nimport { BodyType } from \"./body-type.js\";\nimport { DrivetrainType } from \"./drivetrain-type.js\";\nimport { FuelConsumptionNorm } from \"./fuel-consumption-norm.js\";\nimport { SuspensionType } from \"./suspension-type.js\";\nimport { SwedishEcoVehicleClassification } from \"./swedish-eco-vehicle-classification.js\";\nimport { TireType } from \"./tire-type.js\";\nimport { TrackType } from \"./track-type.js\";\n\nconst MASK_CHAR = \"*\";\n\n/** Mask a boat CE design category, e.g. `A` becomes `*`. */\nexport function maskBoatCeDesignCategory(category: BoatCeDesignCategory): string {\n  return MASK_CHAR.repeat(category.value.length);\n}\n\n/** Mask a boat hull material, e.g. `Fiberglass` becomes `**********`. */\nexport function maskBoatHullMaterial(material: BoatHullMaterial): string {\n  return MASK_CHAR.repeat(material.value.length);\n}\n\n/** Mask a body type, e.g. `Sedan` becomes `*****`. */\nexport function maskBodyType(bodyType: BodyType): string {\n  return MASK_CHAR.repeat(bodyType.value.length);\n}\n\n/** Mask a drivetrain type, e.g. `AWD` becomes `***`. */\nexport function maskDrivetrainType(drivetrain: DrivetrainType): string {\n  return MASK_CHAR.repeat(drivetrain.value.length);\n}\n\n/** Mask a fuel consumption norm, e.g. `WLTP` becomes `****`. */\nexport function maskFuelConsumptionNorm(norm: FuelConsumptionNorm): string {\n  return MASK_CHAR.repeat(norm.value.length);\n}\n\n/**\n * Mask a suspension type, e.g. `Coil spring` becomes `**** ******`. Spaces and\n * slashes stay visible so the structure remains recognizable.\n */\nexport function maskSuspensionType(suspension: SuspensionType): string {\n  return maskExcept(suspension.value, \" /\");\n}\n\n/**\n * Mask a Swedish eco-vehicle classification, keeping the leading word:\n * `Milj\u00F6bil 2013` becomes `Milj\u00F6bil ****`.\n */\nexport function maskSwedishEcoVehicleClassification(\n  classification: SwedishEcoVehicleClassification,\n): string {\n  const value = classification.value;\n  const space = value.indexOf(\" \");\n  if (space < 0) return MASK_CHAR.repeat(value.length);\n  return `${value.slice(0, space)} ${MASK_CHAR.repeat(value.length - space - 1)}`;\n}\n\n/**\n * Mask a tire type, e.g. `Winter (studded)` becomes `****** (*******)`. Spaces,\n * parentheses and hyphens stay visible.\n */\nexport function maskTireType(tireType: TireType): string {\n  return maskExcept(tireType.value, \" ()-\");\n}\n\n/** Mask a track type, e.g. `Half-track` becomes `****-*****`. Hyphens stay visible. */\nexport function maskTrackType(track: TrackType): string {\n  return maskExcept(track.value, \" -\");\n}\n\nfunction maskExcept(value: string, keep: string): string {\n  let out = \"\";\n  for (const char of value) out += keep.includes(char) ? char : MASK_CHAR;\n  return out;\n}\n"],
+  "mappings": "AAUA,MAAM,YAAY;AAGX,SAAS,yBAAyB,UAAwC;AAC/E,SAAO,UAAU,OAAO,SAAS,MAAM,MAAM;AAC/C;AAGO,SAAS,qBAAqB,UAAoC;AACvE,SAAO,UAAU,OAAO,SAAS,MAAM,MAAM;AAC/C;AAGO,SAAS,aAAa,UAA4B;AACvD,SAAO,UAAU,OAAO,SAAS,MAAM,MAAM;AAC/C;AAGO,SAAS,mBAAmB,YAAoC;AACrE,SAAO,UAAU,OAAO,WAAW,MAAM,MAAM;AACjD;AAGO,SAAS,wBAAwB,MAAmC;AACzE,SAAO,UAAU,OAAO,KAAK,MAAM,MAAM;AAC3C;AAMO,SAAS,mBAAmB,YAAoC;AACrE,SAAO,WAAW,WAAW,OAAO,IAAI;AAC1C;AAMO,SAAS,oCACd,gBACQ;AACR,QAAM,QAAQ,eAAe;AAC7B,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,MAAI,QAAQ,EAAG,QAAO,UAAU,OAAO,MAAM,MAAM;AACnD,SAAO,GAAG,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,UAAU,OAAO,MAAM,SAAS,QAAQ,CAAC,CAAC;AAC/E;AAMO,SAAS,aAAa,UAA4B;AACvD,SAAO,WAAW,SAAS,OAAO,MAAM;AAC1C;AAGO,SAAS,cAAc,OAA0B;AACtD,SAAO,WAAW,MAAM,OAAO,IAAI;AACrC;AAEA,SAAS,WAAW,OAAe,MAAsB;AACvD,MAAI,MAAM;AACV,aAAW,QAAQ,MAAO,QAAO,KAAK,SAAS,IAAI,IAAI,OAAO;AAC9D,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/vehicle/wheel-rim-dimension.js

@@ -0,0 +1,163 @@
+import { Decimal } from "../internal/decimal.js";
+import { sanitizeInput } from "../internal/input-sanitization.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 MIN_DIAMETER = Decimal.parse("10");
+const MAX_DIAMETER = Decimal.parse("26");
+const MIN_WIDTH = Decimal.parse("3");
+const MAX_WIDTH = Decimal.parse("16");
+const NORMAL_PATTERN = /^\s*(\d{2}(?:[.,]\d{1,2})?)\s*[x×]\s*(\d{1,2}(?:[.,]\d{1,2})?)\s*(JJ|JK|J|B|K|P|D)?\s*$/iu;
+const REVERSED_PATTERN = /^\s*(\d{1,2}(?:[.,]\d{1,2})?)\s*(JJ|JK|J|B|K|P|D)?\s*[x×]\s*(\d{2}(?:[.,]\d{1,2})?)\s*$/iu;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])\d{1,2}(?:[.,]\d{1,2})?\s*(?:JJ|JK|J|B|K|P|D)?\s*[x×]\s*\d{1,2}(?:[.,]\d{1,2})?\s*(?:JJ|JK|J|B|K|P|D)?(?![\p{L}\p{N}_])/giu;
+class WheelRimDimension {
+  static typeInfo = Object.freeze({
+    englishName: "Wheel Rim Dimension",
+    localizedName: "F\xE4lgdimension",
+    emoji: "\u2B55",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/Wheel_sizing",
+      "https://www.etrto.org/"
+    ])
+  });
+  /** Normalized compact form, e.g. `18x7J`. */
+  value;
+  /** Flange type code, e.g. `J` or `JJ`, or an empty string when unspecified. */
+  flangeType;
+  exactDiameter;
+  exactWidth;
+  constructor(diameter, width, flangeType) {
+    this.exactDiameter = diameter;
+    this.exactWidth = width;
+    this.flangeType = flangeType;
+    this.value = build(diameter, width, flangeType, false);
+  }
+  /** Rim diameter in inches, e.g. `18`. */
+  get diameterInches() {
+    return this.exactDiameter.toNumber();
+  }
+  /** Rim width in inches, e.g. `7`. */
+  get widthInches() {
+    return this.exactWidth.toNumber();
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = sanitizeInput(input).trim();
+    let diameter;
+    let width;
+    let flange;
+    const normal = NORMAL_PATTERN.exec(trimmed);
+    if (normal !== null) {
+      diameter = decimalOf(normal[1]);
+      width = decimalOf(normal[2]);
+      flange = normal[3]?.toUpperCase() ?? "";
+    } else {
+      const reversed = REVERSED_PATTERN.exec(trimmed);
+      if (reversed === null) return null;
+      width = decimalOf(reversed[1]);
+      flange = reversed[2]?.toUpperCase() ?? "";
+      diameter = decimalOf(reversed[3]);
+    }
+    if (diameter === null || width === null) return null;
+    if (diameter.compareTo(MIN_DIAMETER) < 0 || diameter.compareTo(MAX_DIAMETER) > 0) return null;
+    if (width.compareTo(MIN_WIDTH) < 0 || width.compareTo(MAX_WIDTH) > 0) return null;
+    return new WheelRimDimension(diameter, width, flange);
+  }
+  static parse(input) {
+    const result = WheelRimDimension.tryParse(input);
+    if (result === null) throw new Error("Invalid wheel rim dimension.");
+    return result;
+  }
+  static isValid(input) {
+    return WheelRimDimension.tryParse(input) !== null;
+  }
+  /** Returns the spaced display form, e.g. `18 x 7 J`. */
+  static format(input, options) {
+    const parsed = WheelRimDimension.tryParse(input);
+    if (parsed !== null) return parsed.toString();
+    return fallback(input, options);
+  }
+  /** Returns the compact form, e.g. `18x7J`. */
+  static normalize(input, options) {
+    const parsed = WheelRimDimension.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && WheelRimDimension.normalize(input) === input;
+  }
+  /** Finds wheel rim dimensions in unstructured text, e.g. `18x7J` or `7.5Jx17`. */
+  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 = WheelRimDimension.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "WheelRimDimension",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskWheelRimDimension(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the compact form, e.g. `18x7J`. */
+  toNormalizedString() {
+    return this.value;
+  }
+  /** Returns the spaced display form, e.g. `18 x 7 J`. */
+  toString() {
+    return build(this.exactDiameter, this.exactWidth, this.flangeType, true);
+  }
+  equals(other) {
+    return other != null && this.exactDiameter.equals(other.exactDiameter) && this.exactWidth.equals(other.exactWidth) && this.flangeType === other.flangeType;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    const byDiameter = this.exactDiameter.compareTo(other.exactDiameter);
+    if (byDiameter !== 0) return byDiameter;
+    const byWidth = this.exactWidth.compareTo(other.exactWidth);
+    if (byWidth !== 0) return byWidth;
+    return this.flangeType < other.flangeType ? -1 : this.flangeType > other.flangeType ? 1 : 0;
+  }
+  /** @internal Exposes the parsed scale, which masking mirrors star for star. */
+  get _exactParts() {
+    return { diameter: this.exactDiameter, width: this.exactWidth };
+  }
+}
+function maskWheelRimDimension(dimension) {
+  const { diameter, width } = dimension._exactParts;
+  const d = "*".repeat(diameter.toString().length);
+  const w = "*".repeat(width.toString().length);
+  return dimension.flangeType.length > 0 ? `${d} x ${w} ${dimension.flangeType}` : `${d} x ${w}`;
+}
+function build(diameter, width, flange, spaced) {
+  const d = diameter.toTrimmedString();
+  const w = width.toTrimmedString();
+  if (spaced) return flange.length > 0 ? `${d} x ${w} ${flange}` : `${d} x ${w}`;
+  return flange.length > 0 ? `${d}x${w}${flange}` : `${d}x${w}`;
+}
+function decimalOf(text) {
+  return Decimal.parse(text.replace(",", "."));
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  WheelRimDimension,
+  maskWheelRimDimension
+};
+//# sourceMappingURL=wheel-rim-dimension.js.map

package/dist/esm/vehicle/wheel-rim-dimension.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/wheel-rim-dimension.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.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 WheelRimDimension.format} and {@link WheelRimDimension.normalize}. */\nexport interface WheelRimDimensionFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MIN_DIAMETER = Decimal.parse(\"10\")!;\nconst MAX_DIAMETER = Decimal.parse(\"26\")!;\nconst MIN_WIDTH = Decimal.parse(\"3\")!;\nconst MAX_WIDTH = Decimal.parse(\"16\")!;\n\nconst NORMAL_PATTERN =\n  /^\\s*(\\d{2}(?:[.,]\\d{1,2})?)\\s*[x\u00D7]\\s*(\\d{1,2}(?:[.,]\\d{1,2})?)\\s*(JJ|JK|J|B|K|P|D)?\\s*$/iu;\n\nconst REVERSED_PATTERN =\n  /^\\s*(\\d{1,2}(?:[.,]\\d{1,2})?)\\s*(JJ|JK|J|B|K|P|D)?\\s*[x\u00D7]\\s*(\\d{2}(?:[.,]\\d{1,2})?)\\s*$/iu;\n\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])\\d{1,2}(?:[.,]\\d{1,2})?\\s*(?:JJ|JK|J|B|K|P|D)?\\s*[x\u00D7]\\s*\\d{1,2}(?:[.,]\\d{1,2})?\\s*(?:JJ|JK|J|B|K|P|D)?(?![\\p{L}\\p{N}_])/giu;\n\n/**\n * Wheel rim size notation (`f\u00E4lgdimension`) such as `18x7J`: rim diameter in inches,\n * width in inches and an optional flange type. The reversed order used on many rims,\n * e.g. `7.5Jx17`, is accepted as well.\n *\n * Sources:\n * - https://en.wikipedia.org/wiki/Wheel_sizing\n * - https://www.etrto.org/\n */\nexport class WheelRimDimension {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Wheel Rim Dimension\",\n    localizedName: \"F\u00E4lgdimension\",\n    emoji: \"\u2B55\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/Wheel_sizing\",\n      \"https://www.etrto.org/\",\n    ]),\n  });\n\n  /** Normalized compact form, e.g. `18x7J`. */\n  readonly value: string;\n\n  /** Flange type code, e.g. `J` or `JJ`, or an empty string when unspecified. */\n  readonly flangeType: string;\n\n  private readonly exactDiameter: Decimal;\n  private readonly exactWidth: Decimal;\n\n  private constructor(diameter: Decimal, width: Decimal, flangeType: string) {\n    this.exactDiameter = diameter;\n    this.exactWidth = width;\n    this.flangeType = flangeType;\n    this.value = build(diameter, width, flangeType, false);\n  }\n\n  /** Rim diameter in inches, e.g. `18`. */\n  get diameterInches(): number {\n    return this.exactDiameter.toNumber();\n  }\n\n  /** Rim width in inches, e.g. `7`. */\n  get widthInches(): number {\n    return this.exactWidth.toNumber();\n  }\n\n  static tryParse(input: string | null | undefined): WheelRimDimension | null {\n    if (input == null || input.trim().length === 0) return null;\n    const trimmed = sanitizeInput(input).trim();\n\n    let diameter: Decimal | null;\n    let width: Decimal | null;\n    let flange: string;\n\n    const normal = NORMAL_PATTERN.exec(trimmed);\n    if (normal !== null) {\n      diameter = decimalOf(normal[1]!);\n      width = decimalOf(normal[2]!);\n      flange = normal[3]?.toUpperCase() ?? \"\";\n    } else {\n      const reversed = REVERSED_PATTERN.exec(trimmed);\n      if (reversed === null) return null;\n      width = decimalOf(reversed[1]!);\n      flange = reversed[2]?.toUpperCase() ?? \"\";\n      diameter = decimalOf(reversed[3]!);\n    }\n\n    if (diameter === null || width === null) return null;\n    if (diameter.compareTo(MIN_DIAMETER) < 0 || diameter.compareTo(MAX_DIAMETER) > 0) return null;\n    if (width.compareTo(MIN_WIDTH) < 0 || width.compareTo(MAX_WIDTH) > 0) return null;\n\n    return new WheelRimDimension(diameter, width, flange);\n  }\n\n  static parse(input: string): WheelRimDimension {\n    const result = WheelRimDimension.tryParse(input);\n    if (result === null) throw new Error(\"Invalid wheel rim dimension.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return WheelRimDimension.tryParse(input) !== null;\n  }\n\n  /** Returns the spaced display form, e.g. `18 x 7 J`. */\n  static format(\n    input: string | null | undefined,\n    options?: WheelRimDimensionFormatOptions,\n  ): string | null {\n    const parsed = WheelRimDimension.tryParse(input);\n    if (parsed !== null) return parsed.toString();\n    return fallback(input, options);\n  }\n\n  /** Returns the compact form, e.g. `18x7J`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: WheelRimDimensionFormatOptions,\n  ): string | null {\n    const parsed = WheelRimDimension.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && WheelRimDimension.normalize(input) === input;\n  }\n\n  /** Finds wheel rim dimensions in unstructured text, e.g. `18x7J` or `7.5Jx17`. */\n  static findCandidatesInText(text: string): readonly TextCandidate<WheelRimDimension>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<WheelRimDimension>[] = [];\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 = WheelRimDimension.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<WheelRimDimension>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"WheelRimDimension\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskWheelRimDimension(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the compact form, e.g. `18x7J`. */\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  /** Returns the spaced display form, e.g. `18 x 7 J`. */\n  toString(): string {\n    return build(this.exactDiameter, this.exactWidth, this.flangeType, true);\n  }\n\n  equals(other: WheelRimDimension | null | undefined): boolean {\n    return (\n      other != null &&\n      this.exactDiameter.equals(other.exactDiameter) &&\n      this.exactWidth.equals(other.exactWidth) &&\n      this.flangeType === other.flangeType\n    );\n  }\n\n  compareTo(other: WheelRimDimension | null | undefined): number {\n    if (other == null) return 1;\n    const byDiameter = this.exactDiameter.compareTo(other.exactDiameter);\n    if (byDiameter !== 0) return byDiameter;\n    const byWidth = this.exactWidth.compareTo(other.exactWidth);\n    if (byWidth !== 0) return byWidth;\n    return this.flangeType < other.flangeType ? -1 : this.flangeType > other.flangeType ? 1 : 0;\n  }\n\n  /** @internal Exposes the parsed scale, which masking mirrors star for star. */\n  get _exactParts(): { diameter: Decimal; width: Decimal } {\n    return { diameter: this.exactDiameter, width: this.exactWidth };\n  }\n}\n\n/** Returns a masked rim dimension keeping the flange type, e.g. `18x7J` becomes `** x * J`. */\nexport function maskWheelRimDimension(dimension: WheelRimDimension): string {\n  const { diameter, width } = dimension._exactParts;\n  const d = \"*\".repeat(diameter.toString().length);\n  const w = \"*\".repeat(width.toString().length);\n  return dimension.flangeType.length > 0 ? `${d} x ${w} ${dimension.flangeType}` : `${d} x ${w}`;\n}\n\nfunction build(diameter: Decimal, width: Decimal, flange: string, spaced: boolean): string {\n  const d = diameter.toTrimmedString();\n  const w = width.toTrimmedString();\n  if (spaced) return flange.length > 0 ? `${d} x ${w} ${flange}` : `${d} x ${w}`;\n  return flange.length > 0 ? `${d}x${w}${flange}` : `${d}x${w}`;\n}\n\nfunction decimalOf(text: string): Decimal | null {\n  return Decimal.parse(text.replace(\",\", \".\"));\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: WheelRimDimensionFormatOptions,\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": []
+}