@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/vehicle/swedish-eco-vehicle-classification.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/swedish-eco-vehicle-classification.ts"],
+  "sourcesContent": ["import type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { maskSwedishEcoVehicleClassification } from \"./vehicle-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface SwedishEcoVehicleClassificationFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\ninterface SwedishEcoVehicleClassificationDef {\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly introductionYear: number;\n  readonly endYear: number | null;\n  readonly englishDescription: string;\n  readonly localizedDescription: string;\n  readonly rank: number;\n}\n\n/**\n * A Swedish eco-vehicle classification (`milj\u00F6bilsklassning`) used by Transportstyrelsen and\n * the Swedish tax legislation, e.g. `Milj\u00F6bil 2007`, `Milj\u00F6bil 2013`, `Supermilj\u00F6bil`,\n * `Klimatbonusbil`.\n */\nexport class SwedishEcoVehicleClassification {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Swedish Eco-Vehicle Classification\",\n    localizedName: \"Milj\u00F6bilsklassning\",\n    emoji: \"\uD83C\uDF3F\",\n    sources: Object.freeze([\"https://www.transportstyrelsen.se/\", \"https://www.skatteverket.se/\"]),\n  });\n\n  readonly value: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n  readonly introductionYear: number;\n  readonly endYear: number | null;\n  readonly englishDescription: string;\n  readonly localizedDescription: string;\n\n  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */\n  private readonly rank: number;\n\n  private constructor(def: SwedishEcoVehicleClassificationDef) {\n    this.value = def.value;\n    this.englishName = def.englishName;\n    this.localizedName = def.localizedName;\n    this.introductionYear = def.introductionYear;\n    this.endYear = def.endYear;\n    this.englishDescription = def.englishDescription;\n    this.localizedDescription = def.localizedDescription;\n    this.rank = def.rank;\n  }\n\n  static readonly Miljobil2007 = new SwedishEcoVehicleClassification({\n    value: \"Milj\u00F6bil 2007\",\n    englishName: \"Eco vehicle 2007\",\n    localizedName: \"Milj\u00F6bil 2007\",\n    introductionYear: 2007,\n    endYear: 2012,\n    englishDescription:\n      \"Definition under the 2007 Swedish eco-vehicle scheme: low CO\u2082 emissions and/or alternative fuel propulsion.\",\n    localizedDescription:\n      \"Milj\u00F6bilsdefinition fr\u00E5n 2007 \u00E5rs system: l\u00E5ga CO\u2082-utsl\u00E4pp och/eller alternativa drivmedel.\",\n    rank: 3,\n  });\n\n  static readonly Miljobil2013 = new SwedishEcoVehicleClassification({\n    value: \"Milj\u00F6bil 2013\",\n    englishName: \"Eco vehicle 2013\",\n    localizedName: \"Milj\u00F6bil 2013\",\n    introductionYear: 2013,\n    endYear: 2017,\n    englishDescription:\n      \"Definition under the 2013 Swedish eco-vehicle scheme: stricter CO\u2082 limits depending on weight.\",\n    localizedDescription:\n      \"Milj\u00F6bilsdefinition fr\u00E5n 2013 \u00E5rs system: striktare CO\u2082-gr\u00E4nser beroende p\u00E5 fordonsvikt.\",\n    rank: 4,\n  });\n\n  static readonly Supermiljobil = new SwedishEcoVehicleClassification({\n    value: \"Supermilj\u00F6bil\",\n    englishName: \"Super eco vehicle\",\n    localizedName: \"Supermilj\u00F6bil\",\n    introductionYear: 2012,\n    endYear: 2018,\n    englishDescription:\n      \"Vehicles emitting at most 50 g CO\u2082/km, eligible for the Swedish super eco-vehicle premium 2012\u20132018.\",\n    localizedDescription:\n      \"Fordon som sl\u00E4pper ut h\u00F6gst 50 g CO\u2082/km, ber\u00E4ttigade till supermilj\u00F6bilspremie 2012\u20132018.\",\n    rank: 5,\n  });\n\n  static readonly Klimatbonusbil = new SwedishEcoVehicleClassification({\n    value: \"Klimatbonusbil\",\n    englishName: \"Climate bonus vehicle\",\n    localizedName: \"Klimatbonusbil\",\n    introductionYear: 2018,\n    endYear: 2022,\n    englishDescription:\n      \"Vehicles eligible for the Swedish climate bonus 2018\u20132022 based on CO\u2082 emissions and electric propulsion.\",\n    localizedDescription:\n      \"Fordon som varit ber\u00E4ttigade till klimatbonus 2018\u20132022 utifr\u00E5n CO\u2082-utsl\u00E4pp och elektrisk drift.\",\n    rank: 2,\n  });\n\n  static readonly Bonusbil = new SwedishEcoVehicleClassification({\n    value: \"Bonusbil\",\n    englishName: \"Bonus vehicle\",\n    localizedName: \"Bonusbil\",\n    introductionYear: 2018,\n    endYear: 2022,\n    englishDescription: \"Synonym for klimatbonusbil \u2014 climate bonus eligible vehicle.\",\n    localizedDescription: \"Synonymt med klimatbonusbil \u2014 fordon ber\u00E4ttigade till klimatbonus.\",\n    rank: 0,\n  });\n\n  static readonly Elbil = new SwedishEcoVehicleClassification({\n    value: \"Elbil\",\n    englishName: \"Electric vehicle\",\n    localizedName: \"Elbil\",\n    introductionYear: 2010,\n    endYear: null,\n    englishDescription:\n      \"Battery electric vehicle \u2014 included as a Swedish eco-vehicle classification when no Euro stage applies.\",\n    localizedDescription:\n      \"Helelektriskt fordon \u2014 registreras som milj\u00F6bilsklassning n\u00E4r Euroklass inte \u00E4r till\u00E4mplig.\",\n    rank: 1,\n  });\n\n  /** All 6 values, in canonical order. */\n  static get all(): readonly SwedishEcoVehicleClassification[] {\n    return ALL;\n  }\n\n  /** Resolves a value from its canonical name, localized name, code or any known alias. */\n  static tryParse(input: string | null | undefined): SwedishEcoVehicleClassification | 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): SwedishEcoVehicleClassification {\n    const result = SwedishEcoVehicleClassification.tryParse(input);\n    if (result === null) throw new Error(`Invalid swedish eco-vehicle classification.`);\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishEcoVehicleClassification.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: SwedishEcoVehicleClassificationFormatOptions,\n  ): string | null {\n    const r = SwedishEcoVehicleClassification.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: SwedishEcoVehicleClassificationFormatOptions,\n  ): string | null {\n    const r = SwedishEcoVehicleClassification.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 && SwedishEcoVehicleClassification.normalize(input) === input;\n  }\n\n  /** Finds swedish eco-vehicle classification mentions in unstructured text. */\n  static findCandidatesInText(\n    text: string,\n  ): readonly TextCandidate<SwedishEcoVehicleClassification>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishEcoVehicleClassification>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = SCAN_PATTERN.exec(text)) !== null) {\n      const value = SwedishEcoVehicleClassification.tryParse(m[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<SwedishEcoVehicleClassification>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishEcoVehicleClassification\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskSwedishEcoVehicleClassification(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: SwedishEcoVehicleClassification | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: SwedishEcoVehicleClassification | 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 SwedishEcoVehicleClassification[] = [\n  SwedishEcoVehicleClassification.Miljobil2007,\n  SwedishEcoVehicleClassification.Miljobil2013,\n  SwedishEcoVehicleClassification.Supermiljobil,\n  SwedishEcoVehicleClassification.Klimatbonusbil,\n  SwedishEcoVehicleClassification.Bonusbil,\n  SwedishEcoVehicleClassification.Elbil,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: SwedishEcoVehicleClassificationFormatOptions,\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 [SwedishEcoVehicleClassification, readonly string[]])[] = [\n  [\n    SwedishEcoVehicleClassification.Miljobil2007,\n    [\"eco vehicle 2007\", \"mb2007\", \"miljobil 2007\", \"miljobil2007\"],\n  ],\n  [\n    SwedishEcoVehicleClassification.Miljobil2013,\n    [\"eco vehicle 2013\", \"mb2013\", \"miljobil 2013\", \"miljobil2013\"],\n  ],\n  [SwedishEcoVehicleClassification.Supermiljobil, [\"super eco vehicle\", \"supermiljobil\"]],\n  [\n    SwedishEcoVehicleClassification.Klimatbonusbil,\n    [\"climate bonus car\", \"climate bonus vehicle\", \"klimatbonus\", \"klimatbonusbil\"],\n  ],\n  [SwedishEcoVehicleClassification.Bonusbil, [\"bonus car\", \"bonus vehicle\", \"bonusbil\"]],\n  [\n    SwedishEcoVehicleClassification.Elbil,\n    [\"bev\", \"elbil\", \"electric car\", \"electric vehicle\", \"ev\"],\n  ],\n];\n\nconst LOOKUP = new Map<string, SwedishEcoVehicleClassification>();\nfor (const [value, keys] of ALIASES) {\n  for (const key of keys) if (!LOOKUP.has(key)) LOOKUP.set(key, value);\n}\n\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])(?:Milj\u00F6bil(?:\\s*20\\d{2})?|Supermilj\u00F6bil|Klimatbonusbil)(?![\\p{L}\\p{N}_])/giu;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/vehicle/swedish-vehicle-registration-number.js

@@ -0,0 +1,176 @@
+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 = 20;
+const PATTERN = /^[A-HJ-NOPR-UW-Z]{3}\d{2}[\dA-HJ-NPR-UW-Z]$/u;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])[A-HJ-NOPR-UW-Z]{3}\s?\d{2}[\dA-HJ-NPR-UW-Z](?![\p{L}\p{N}_])/giu;
+const TAX_MONTH_BY_DIGIT = [3, 4, 5, 6, 8, 10, 11, 12, 1, 2];
+class SwedishVehicleRegistrationNumber {
+  static typeInfo = Object.freeze({
+    englishName: "Registration Number",
+    localizedName: "Registreringsnummer",
+    emoji: "\u{1F697}",
+    sources: Object.freeze([
+      "https://www.transportstyrelsen.se/en/road/vehicles/licence-plates/",
+      "https://www.transportstyrelsen.se/en/road/vehicles/taxes-and-fees/vehicle-tax/",
+      "https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Sweden"
+    ])
+  });
+  /** The registration number without spaces, e.g. `ABC123`. */
+  value;
+  /** Display form with a space, e.g. `ABC 123`. */
+  formatted;
+  /** The three-letter prefix, e.g. `ABC`. */
+  letters;
+  /** The part after the letter prefix, e.g. `123` or `12A`. */
+  suffix;
+  /** `true` when the number uses the 2019 format whose last character is a letter. */
+  isNewFormat;
+  /** The digit the tax payment month is derived from. */
+  taxPaymentDigit;
+  /** The month (1–12) when vehicle tax is normally due. */
+  taxPaymentMonth;
+  constructor(value, letters, suffix, isNewFormat) {
+    this.value = value;
+    this.formatted = `${letters} ${suffix}`;
+    this.letters = letters;
+    this.suffix = suffix;
+    this.isNewFormat = isNewFormat;
+    this.taxPaymentDigit = Number(isNewFormat ? value[4] : value[5]);
+    this.taxPaymentMonth = TAX_MONTH_BY_DIGIT[this.taxPaymentDigit];
+  }
+  static tryParse(input) {
+    const cleaned = clean(input);
+    if (cleaned === null || cleaned.length !== 6 || !PATTERN.test(cleaned)) return null;
+    return new SwedishVehicleRegistrationNumber(
+      cleaned,
+      cleaned.slice(0, 3),
+      cleaned.slice(3),
+      /[A-Z]/u.test(cleaned[5])
+    );
+  }
+  static parse(input) {
+    const result = SwedishVehicleRegistrationNumber.tryParse(input);
+    if (result === null) throw new Error("Invalid Swedish vehicle registration number.");
+    return result;
+  }
+  static isValid(input) {
+    return SwedishVehicleRegistrationNumber.tryParse(input) !== null;
+  }
+  /** Returns the display form with a space, e.g. `ABC 123`. */
+  static format(input, options) {
+    const parsed = SwedishVehicleRegistrationNumber.tryParse(input);
+    if (parsed !== null) return parsed.formatted;
+    return fallback(input, options);
+  }
+  /** Returns the number without spaces, e.g. `ABC123`. */
+  static normalize(input, options) {
+    const parsed = SwedishVehicleRegistrationNumber.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && SwedishVehicleRegistrationNumber.normalize(input) === input;
+  }
+  /** Describes why the input is not a registration number, 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 !== 6) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidLength,
+        "Registration number must be exactly 6 characters.",
+        "Registreringsnumret m\xE5ste vara exakt 6 tecken."
+      );
+    }
+    if (!PATTERN.test(cleaned)) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidFormat,
+        "Registration number must be three letters followed by two digits and one digit or letter (I, Q, V, \xC5, \xC4, \xD6 excluded).",
+        "Registreringsnumret m\xE5ste vara tre bokst\xE4ver f\xF6ljt av tv\xE5 siffror och en siffra eller bokstav (I, Q, V, \xC5, \xC4, \xD6 exkluderade)."
+      );
+    }
+    return validResult(input);
+  }
+  /** Finds registration-number 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 = SwedishVehicleRegistrationNumber.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: "SwedishVehicleRegistrationNumber",
+          category: TextCandidateCategory.Vehicle,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskSwedishVehicleRegistrationNumber(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  /** Returns the number without spaces, e.g. `ABC123`. */
+  toNormalizedString() {
+    return this.value;
+  }
+  /** Returns the display form with a space, e.g. `ABC 123`. */
+  toString() {
+    return this.formatted;
+  }
+  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 maskSwedishVehicleRegistrationNumber(registration) {
+  return `${"*".repeat(registration.letters.length)} ${"*".repeat(registration.suffix.length)}`;
+}
+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 {
+  SwedishVehicleRegistrationNumber,
+  maskSwedishVehicleRegistrationNumber
+};
+//# sourceMappingURL=swedish-vehicle-registration-number.js.map

package/dist/esm/vehicle/swedish-vehicle-registration-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/swedish-vehicle-registration-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 SwedishVehicleRegistrationNumber.format} and `normalize`. */\nexport interface SwedishVehicleRegistrationNumberFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MAX_INPUT_LENGTH = 20;\n\n// I, Q, V, \u00C5, \u00C4 and \u00D6 are never used; O is additionally barred from the last position.\nconst PATTERN = /^[A-HJ-NOPR-UW-Z]{3}\\d{2}[\\dA-HJ-NPR-UW-Z]$/u;\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])[A-HJ-NOPR-UW-Z]{3}\\s?\\d{2}[\\dA-HJ-NPR-UW-Z](?![\\p{L}\\p{N}_])/giu;\n\n/** Transportstyrelsen's mapping from the tax digit to the month tax falls due. */\nconst TAX_MONTH_BY_DIGIT = [3, 4, 5, 6, 8, 10, 11, 12, 1, 2];\n\n/**\n * A Swedish vehicle registration number (`registreringsnummer`) issued by\n * Transportstyrelsen. The classic form is three letters and three digits\n * (`ABC 123`); since 2019 the final digit may instead be a letter (`ABC 12A`).\n *\n * The tax payment month is derived structurally from the number and says nothing\n * about any particular vehicle's actual tax status.\n *\n * Sources:\n * - https://www.transportstyrelsen.se/en/road/vehicles/licence-plates/\n * - https://www.transportstyrelsen.se/en/road/vehicles/taxes-and-fees/vehicle-tax/\n * - https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Sweden\n */\nexport class SwedishVehicleRegistrationNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Registration Number\",\n    localizedName: \"Registreringsnummer\",\n    emoji: \"\uD83D\uDE97\",\n    sources: Object.freeze([\n      \"https://www.transportstyrelsen.se/en/road/vehicles/licence-plates/\",\n      \"https://www.transportstyrelsen.se/en/road/vehicles/taxes-and-fees/vehicle-tax/\",\n      \"https://en.wikipedia.org/wiki/Vehicle_registration_plates_of_Sweden\",\n    ]),\n  });\n\n  /** The registration number without spaces, e.g. `ABC123`. */\n  readonly value: string;\n\n  /** Display form with a space, e.g. `ABC 123`. */\n  readonly formatted: string;\n\n  /** The three-letter prefix, e.g. `ABC`. */\n  readonly letters: string;\n\n  /** The part after the letter prefix, e.g. `123` or `12A`. */\n  readonly suffix: string;\n\n  /** `true` when the number uses the 2019 format whose last character is a letter. */\n  readonly isNewFormat: boolean;\n\n  /** The digit the tax payment month is derived from. */\n  readonly taxPaymentDigit: number;\n\n  /** The month (1\u201312) when vehicle tax is normally due. */\n  readonly taxPaymentMonth: number;\n\n  private constructor(value: string, letters: string, suffix: string, isNewFormat: boolean) {\n    this.value = value;\n    this.formatted = `${letters} ${suffix}`;\n    this.letters = letters;\n    this.suffix = suffix;\n    this.isNewFormat = isNewFormat;\n    this.taxPaymentDigit = Number(isNewFormat ? value[4] : value[5]);\n    this.taxPaymentMonth = TAX_MONTH_BY_DIGIT[this.taxPaymentDigit]!;\n  }\n\n  static tryParse(input: string | null | undefined): SwedishVehicleRegistrationNumber | null {\n    const cleaned = clean(input);\n    if (cleaned === null || cleaned.length !== 6 || !PATTERN.test(cleaned)) return null;\n\n    return new SwedishVehicleRegistrationNumber(\n      cleaned,\n      cleaned.slice(0, 3),\n      cleaned.slice(3),\n      /[A-Z]/u.test(cleaned[5]!),\n    );\n  }\n\n  static parse(input: string): SwedishVehicleRegistrationNumber {\n    const result = SwedishVehicleRegistrationNumber.tryParse(input);\n    if (result === null) throw new Error(\"Invalid Swedish vehicle registration number.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishVehicleRegistrationNumber.tryParse(input) !== null;\n  }\n\n  /** Returns the display form with a space, e.g. `ABC 123`. */\n  static format(\n    input: string | null | undefined,\n    options?: SwedishVehicleRegistrationNumberFormatOptions,\n  ): string | null {\n    const parsed = SwedishVehicleRegistrationNumber.tryParse(input);\n    if (parsed !== null) return parsed.formatted;\n    return fallback(input, options);\n  }\n\n  /** Returns the number without spaces, e.g. `ABC123`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: SwedishVehicleRegistrationNumberFormatOptions,\n  ): string | null {\n    const parsed = SwedishVehicleRegistrationNumber.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 && SwedishVehicleRegistrationNumber.normalize(input) === input;\n  }\n\n  /** Describes why the input is not a registration number, 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 !== 6) {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidLength,\n        \"Registration number must be exactly 6 characters.\",\n        \"Registreringsnumret m\u00E5ste vara exakt 6 tecken.\",\n      );\n    }\n\n    if (!PATTERN.test(cleaned)) {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidFormat,\n        \"Registration number must be three letters followed by two digits and one digit or letter (I, Q, V, \u00C5, \u00C4, \u00D6 excluded).\",\n        \"Registreringsnumret m\u00E5ste vara tre bokst\u00E4ver f\u00F6ljt av tv\u00E5 siffror och en siffra eller bokstav (I, Q, V, \u00C5, \u00C4, \u00D6 exkluderade).\",\n      );\n    }\n\n    return validResult(input);\n  }\n\n  /** Finds registration-number candidates in unstructured text. */\n  static findCandidatesInText(\n    text: string,\n  ): readonly TextCandidate<SwedishVehicleRegistrationNumber>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<SwedishVehicleRegistrationNumber>[] = [];\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 = SwedishVehicleRegistrationNumber.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<SwedishVehicleRegistrationNumber>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: text.slice(match.index, match.index + match[0].length),\n          typeName: \"SwedishVehicleRegistrationNumber\",\n          category: TextCandidateCategory.Vehicle,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskSwedishVehicleRegistrationNumber(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  /** Returns the number without spaces, e.g. `ABC123`. */\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  /** Returns the display form with a space, e.g. `ABC 123`. */\n  toString(): string {\n    return this.formatted;\n  }\n\n  equals(other: SwedishVehicleRegistrationNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: SwedishVehicleRegistrationNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\n/** Returns a masked registration number, e.g. `ABC 123` becomes `*** ***`. */\nexport function maskSwedishVehicleRegistrationNumber(\n  registration: SwedishVehicleRegistrationNumber,\n): string {\n  return `${\"*\".repeat(registration.letters.length)} ${\"*\".repeat(registration.suffix.length)}`;\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?: SwedishVehicleRegistrationNumberFormatOptions,\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/swedish-vehicle-status.js

@@ -0,0 +1,152 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+class SwedishVehicleStatus {
+  static typeInfo = Object.freeze({
+    englishName: "Vehicle Status",
+    localizedName: "Fordonsstatus",
+    emoji: "\u{1F4CB}",
+    sources: Object.freeze(["https://www.transportstyrelsen.se/"])
+  });
+  value;
+  code;
+  englishName;
+  localizedName;
+  constructor(def) {
+    this.value = def.value;
+    this.code = def.code;
+    this.englishName = def.englishName;
+    this.localizedName = def.localizedName;
+  }
+  static InService = new SwedishVehicleStatus({
+    value: "ITRAFIK",
+    code: "ITRAFIK",
+    englishName: "In service",
+    localizedName: "I trafik"
+  });
+  static Deregistered = new SwedishVehicleStatus({
+    value: "AVST",
+    code: "AVST",
+    englishName: "Deregistered",
+    localizedName: "Avst\xE4lld"
+  });
+  static Unregistered = new SwedishVehicleStatus({
+    value: "AVREG",
+    code: "AVREG",
+    englishName: "Unregistered",
+    localizedName: "Avregistrerad"
+  });
+  static Stolen = new SwedishVehicleStatus({
+    value: "STULEN",
+    code: "STULEN",
+    englishName: "Stolen",
+    localizedName: "Stulen"
+  });
+  static Exported = new SwedishVehicleStatus({
+    value: "EXPORT",
+    code: "EXPORT",
+    englishName: "Exported",
+    localizedName: "Exporterad"
+  });
+  static Scrapped = new SwedishVehicleStatus({
+    value: "SKROT",
+    code: "SKROT",
+    englishName: "Scrapped",
+    localizedName: "Skrotad"
+  });
+  static ReportedStolen = new SwedishVehicleStatus({
+    value: "ANMSTULEN",
+    code: "ANMSTULEN",
+    englishName: "Reported stolen",
+    localizedName: "Anm\xE4ld stulen"
+  });
+  /** All 7 values, in canonical order. */
+  static get all() {
+    return ALL;
+  }
+  /** Resolves a value from its canonical name, localized name, code or any known alias. */
+  static tryParse(input) {
+    if (input == null) return null;
+    const key = normalizeLookupKey(sanitizeInput(input).trim());
+    if (key.length === 0) return null;
+    return LOOKUP.get(key) ?? null;
+  }
+  static parse(input) {
+    const result = SwedishVehicleStatus.tryParse(input);
+    if (result === null) throw new Error(`Invalid vehicle status.`);
+    return result;
+  }
+  static isValid(input) {
+    return SwedishVehicleStatus.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishVehicleStatus.tryParse(input);
+    if (r !== null)
+      return PrimitivesDefaults.useLocalizedDisplayNames ? r.localizedName : r.englishName;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = SwedishVehicleStatus.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && SwedishVehicleStatus.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+}
+const ALL = [
+  SwedishVehicleStatus.InService,
+  SwedishVehicleStatus.Deregistered,
+  SwedishVehicleStatus.Unregistered,
+  SwedishVehicleStatus.Stolen,
+  SwedishVehicleStatus.Exported,
+  SwedishVehicleStatus.Scrapped,
+  SwedishVehicleStatus.ReportedStolen
+];
+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").replaceAll("\xE9", "e");
+  folded = folded.replaceAll("_", " ");
+  folded = folded.replace(KEY_PATTERN, " ");
+  return folded;
+}
+const ALIASES = [
+  [
+    SwedishVehicleStatus.InService,
+    ["active", "i trafik", "in service", "in traffic", "itrafik", "pastalld", "registered"]
+  ],
+  [
+    SwedishVehicleStatus.Deregistered,
+    ["avst", "avstalld", "avstallning", "deregistered", "off road", "off-road"]
+  ],
+  [
+    SwedishVehicleStatus.Unregistered,
+    ["avreg", "avregistrerad", "permanently deregistered", "unregistered"]
+  ],
+  [SwedishVehicleStatus.Stolen, ["stolen", "stulen"]],
+  [SwedishVehicleStatus.Exported, ["export", "exported", "exporterad"]],
+  [SwedishVehicleStatus.Scrapped, ["scrapped", "skrot", "skrotad", "skrotning"]],
+  [SwedishVehicleStatus.ReportedStolen, ["anmald stulen", "anmstulen", "reported stolen"]]
+];
+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 {
+  SwedishVehicleStatus
+};
+//# sourceMappingURL=swedish-vehicle-status.js.map

package/dist/esm/vehicle/swedish-vehicle-status.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/vehicle/swedish-vehicle-status.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 SwedishVehicleStatusFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\ninterface SwedishVehicleStatusDef {\n  readonly value: string;\n  readonly code: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n}\n\n/** Swedish vehicle registration status (`fordonsstatus`) from Transportstyrelsen. */\nexport class SwedishVehicleStatus {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Vehicle Status\",\n    localizedName: \"Fordonsstatus\",\n    emoji: \"\uD83D\uDCCB\",\n    sources: Object.freeze([\"https://www.transportstyrelsen.se/\"]),\n  });\n\n  readonly value: string;\n  readonly code: string;\n  readonly englishName: string;\n  readonly localizedName: string;\n\n  private constructor(def: SwedishVehicleStatusDef) {\n    this.value = def.value;\n    this.code = def.code;\n    this.englishName = def.englishName;\n    this.localizedName = def.localizedName;\n  }\n\n  static readonly InService = new SwedishVehicleStatus({\n    value: \"ITRAFIK\",\n    code: \"ITRAFIK\",\n    englishName: \"In service\",\n    localizedName: \"I trafik\",\n  });\n\n  static readonly Deregistered = new SwedishVehicleStatus({\n    value: \"AVST\",\n    code: \"AVST\",\n    englishName: \"Deregistered\",\n    localizedName: \"Avst\u00E4lld\",\n  });\n\n  static readonly Unregistered = new SwedishVehicleStatus({\n    value: \"AVREG\",\n    code: \"AVREG\",\n    englishName: \"Unregistered\",\n    localizedName: \"Avregistrerad\",\n  });\n\n  static readonly Stolen = new SwedishVehicleStatus({\n    value: \"STULEN\",\n    code: \"STULEN\",\n    englishName: \"Stolen\",\n    localizedName: \"Stulen\",\n  });\n\n  static readonly Exported = new SwedishVehicleStatus({\n    value: \"EXPORT\",\n    code: \"EXPORT\",\n    englishName: \"Exported\",\n    localizedName: \"Exporterad\",\n  });\n\n  static readonly Scrapped = new SwedishVehicleStatus({\n    value: \"SKROT\",\n    code: \"SKROT\",\n    englishName: \"Scrapped\",\n    localizedName: \"Skrotad\",\n  });\n\n  static readonly ReportedStolen = new SwedishVehicleStatus({\n    value: \"ANMSTULEN\",\n    code: \"ANMSTULEN\",\n    englishName: \"Reported stolen\",\n    localizedName: \"Anm\u00E4ld stulen\",\n  });\n\n  /** All 7 values, in canonical order. */\n  static get all(): readonly SwedishVehicleStatus[] {\n    return ALL;\n  }\n\n  /** Resolves a value from its canonical name, localized name, code or any known alias. */\n  static tryParse(input: string | null | undefined): SwedishVehicleStatus | 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): SwedishVehicleStatus {\n    const result = SwedishVehicleStatus.tryParse(input);\n    if (result === null) throw new Error(`Invalid vehicle status.`);\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishVehicleStatus.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: SwedishVehicleStatusFormatOptions,\n  ): string | null {\n    const r = SwedishVehicleStatus.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?: SwedishVehicleStatusFormatOptions,\n  ): string | null {\n    const r = SwedishVehicleStatus.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 && SwedishVehicleStatus.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;\n  }\n\n  equals(other: SwedishVehicleStatus | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n}\n\nconst ALL: readonly SwedishVehicleStatus[] = [\n  SwedishVehicleStatus.InService,\n  SwedishVehicleStatus.Deregistered,\n  SwedishVehicleStatus.Unregistered,\n  SwedishVehicleStatus.Stolen,\n  SwedishVehicleStatus.Exported,\n  SwedishVehicleStatus.Scrapped,\n  SwedishVehicleStatus.ReportedStolen,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: SwedishVehicleStatusFormatOptions,\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\n    .replaceAll(\"\u00E5\", \"a\")\n    .replaceAll(\"\u00E4\", \"a\")\n    .replaceAll(\"\u00F6\", \"o\")\n    .replaceAll(\"\u00E9\", \"e\");\n  folded = folded.replaceAll(\"_\", \" \");\n  folded = folded.replace(KEY_PATTERN, \" \");\n  return folded;\n}\n\nconst ALIASES: readonly (readonly [SwedishVehicleStatus, readonly string[]])[] = [\n  [\n    SwedishVehicleStatus.InService,\n    [\"active\", \"i trafik\", \"in service\", \"in traffic\", \"itrafik\", \"pastalld\", \"registered\"],\n  ],\n  [\n    SwedishVehicleStatus.Deregistered,\n    [\"avst\", \"avstalld\", \"avstallning\", \"deregistered\", \"off road\", \"off-road\"],\n  ],\n  [\n    SwedishVehicleStatus.Unregistered,\n    [\"avreg\", \"avregistrerad\", \"permanently deregistered\", \"unregistered\"],\n  ],\n  [SwedishVehicleStatus.Stolen, [\"stolen\", \"stulen\"]],\n  [SwedishVehicleStatus.Exported, [\"export\", \"exported\", \"exporterad\"]],\n  [SwedishVehicleStatus.Scrapped, [\"scrapped\", \"skrot\", \"skrotad\", \"skrotning\"]],\n  [SwedishVehicleStatus.ReportedStolen, [\"anmald stulen\", \"anmstulen\", \"reported stolen\"]],\n];\n\nconst LOOKUP = new Map<string, SwedishVehicleStatus>();\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": []
+}