@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/esm/measurement/year-month.js

@@ -0,0 +1,184 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+const MIN_YEAR = 1e3;
+const MAX_YEAR = 9999;
+const ISO_LIKE_PATTERN = /^\s*(?<year>\d{4})[-/](?<month>0?[1-9]|1[0-2])(?:[-/](?<day>0?[1-9]|[12]\d|3[01]))?\s*$/u;
+const MONTH_YEAR_NUMERIC_PATTERN = /^\s*(?<month>0?[1-9]|1[0-2])[-/](?<year>\d{4})\s*$/u;
+const MONTH_NAME_YEAR_PATTERN = /^\s*(?<name>[A-Za-zÅÄÖåäö]+\.?)\s+(?<year>\d{4})\s*$/u;
+const YEAR_MONTH_NAME_PATTERN = /^\s*(?<year>\d{4})\s+(?<name>[A-Za-zÅÄÖåäö]+\.?)\s*$/u;
+const MONTH_NAMES = /* @__PURE__ */ new Map([
+  ["januari", 1],
+  ["februari", 2],
+  ["mars", 3],
+  ["april", 4],
+  ["maj", 5],
+  ["juni", 6],
+  ["juli", 7],
+  ["augusti", 8],
+  ["september", 9],
+  ["oktober", 10],
+  ["november", 11],
+  ["december", 12],
+  ["january", 1],
+  ["february", 2],
+  ["march", 3],
+  ["may", 5],
+  ["june", 6],
+  ["july", 7],
+  ["august", 8],
+  ["october", 10],
+  ["jan", 1],
+  ["feb", 2],
+  ["mar", 3],
+  ["apr", 4],
+  ["jun", 6],
+  ["jul", 7],
+  ["aug", 8],
+  ["sep", 9],
+  ["sept", 9],
+  ["okt", 10],
+  ["oct", 10],
+  ["nov", 11],
+  ["dec", 12]
+]);
+class YearMonth {
+  constructor(year, month) {
+    this.year = year;
+    this.month = month;
+  }
+  year;
+  month;
+  static typeInfo = Object.freeze({
+    englishName: "Year-Month",
+    localizedName: "\xC5rsm\xE5nad",
+    emoji: "\u{1F4C5}",
+    sources: Object.freeze(["https://www.iso.org/iso-8601-date-and-time-format.html"])
+  });
+  /** The earliest supported year. */
+  static minYear = MIN_YEAR;
+  /** The latest supported year. */
+  static maxYear = MAX_YEAR;
+  /** Creates a year-month. Throws when either part is out of range. */
+  static create(year, month) {
+    if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {
+      throw new Error(`Year must be between ${MIN_YEAR} and ${MAX_YEAR}.`);
+    }
+    if (!Number.isInteger(month) || month < 1 || month > 12) {
+      throw new Error("Month must be between 1 and 12.");
+    }
+    return new YearMonth(year, month);
+  }
+  /** Creates a year-month from a date, discarding the day. */
+  static fromDate(date) {
+    return YearMonth.create(date.getFullYear(), date.getMonth() + 1);
+  }
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = sanitizeInput(input).trim();
+    if (trimmed.length === 0) return null;
+    const iso = ISO_LIKE_PATTERN.exec(trimmed);
+    if (iso?.groups !== void 0) {
+      const day = iso.groups["day"];
+      if (day !== void 0 && !isValidDay(iso.groups["year"], iso.groups["month"], day)) {
+        return null;
+      }
+      return build(iso.groups["year"], iso.groups["month"]);
+    }
+    const monthYear = MONTH_YEAR_NUMERIC_PATTERN.exec(trimmed);
+    if (monthYear?.groups !== void 0) {
+      return build(monthYear.groups["year"], monthYear.groups["month"]);
+    }
+    const nameYear = MONTH_NAME_YEAR_PATTERN.exec(trimmed);
+    if (nameYear?.groups !== void 0) {
+      const month = tryParseMonthName(nameYear.groups["name"]);
+      if (month !== null) return build(nameYear.groups["year"], String(month));
+    }
+    const yearName = YEAR_MONTH_NAME_PATTERN.exec(trimmed);
+    if (yearName?.groups !== void 0) {
+      const month = tryParseMonthName(yearName.groups["name"]);
+      if (month !== null) return build(yearName.groups["year"], String(month));
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = YearMonth.tryParse(input);
+    if (result === null) throw new Error("Invalid year-month.");
+    return result;
+  }
+  static isValid(input) {
+    return YearMonth.tryParse(input) !== null;
+  }
+  /** The canonical ISO 8601 form, e.g. `2026-07`. */
+  static format(input, options) {
+    const parsed = YearMonth.tryParse(input);
+    if (parsed !== null) return parsed.toString();
+    return fallback(input, options);
+  }
+  /** The canonical ISO 8601 form, e.g. `2026-07`. */
+  static normalize(input, options) {
+    const parsed = YearMonth.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && YearMonth.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return `${String(this.year).padStart(4, "0")}-${String(this.month).padStart(2, "0")}`;
+  }
+  toString() {
+    return this.toNormalizedString();
+  }
+  /** The first day of the month, as a UTC date. */
+  toFirstDayOfMonth() {
+    return new Date(Date.UTC(this.year, this.month - 1, 1));
+  }
+  /** The last day of the month, as a UTC date. */
+  toLastDayOfMonth() {
+    return new Date(Date.UTC(this.year, this.month, 0));
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    if (this.year !== other.year) return this.year - other.year;
+    return this.month - other.month;
+  }
+  equals(other) {
+    return other != null && this.year === other.year && this.month === other.month;
+  }
+}
+function maskYearMonth(yearMonth) {
+  void yearMonth;
+  return "****-**";
+}
+function build(yearText, monthText) {
+  const year = Number(yearText);
+  const month = Number(monthText);
+  if (year < MIN_YEAR || year > MAX_YEAR) return null;
+  if (month < 1 || month > 12) return null;
+  return YearMonth.create(year, month);
+}
+function isValidDay(yearText, monthText, dayText) {
+  const year = Number(yearText);
+  const month = Number(monthText);
+  const day = Number(dayText);
+  if (year < MIN_YEAR || year > MAX_YEAR) return false;
+  if (month < 1 || month > 12) return false;
+  return day <= daysInMonth(year, month);
+}
+function daysInMonth(year, month) {
+  return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+function tryParseMonthName(name) {
+  const key = name.trim().replace(/\.$/u, "").toLowerCase();
+  return MONTH_NAMES.get(key) ?? null;
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+  if (input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  YearMonth,
+  maskYearMonth
+};
+//# sourceMappingURL=year-month.js.map

package/dist/esm/measurement/year-month.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/year-month.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options for {@link YearMonth.format} and {@link YearMonth.normalize}. */\nexport interface YearMonthFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MIN_YEAR = 1000;\nconst MAX_YEAR = 9999;\n\nconst ISO_LIKE_PATTERN =\n  /^\\s*(?<year>\\d{4})[-/](?<month>0?[1-9]|1[0-2])(?:[-/](?<day>0?[1-9]|[12]\\d|3[01]))?\\s*$/u;\nconst MONTH_YEAR_NUMERIC_PATTERN = /^\\s*(?<month>0?[1-9]|1[0-2])[-/](?<year>\\d{4})\\s*$/u;\nconst MONTH_NAME_YEAR_PATTERN = /^\\s*(?<name>[A-Za-z\u00C5\u00C4\u00D6\u00E5\u00E4\u00F6]+\\.?)\\s+(?<year>\\d{4})\\s*$/u;\nconst YEAR_MONTH_NAME_PATTERN = /^\\s*(?<year>\\d{4})\\s+(?<name>[A-Za-z\u00C5\u00C4\u00D6\u00E5\u00E4\u00F6]+\\.?)\\s*$/u;\n\nconst MONTH_NAMES = new Map<string, number>([\n  [\"januari\", 1],\n  [\"februari\", 2],\n  [\"mars\", 3],\n  [\"april\", 4],\n  [\"maj\", 5],\n  [\"juni\", 6],\n  [\"juli\", 7],\n  [\"augusti\", 8],\n  [\"september\", 9],\n  [\"oktober\", 10],\n  [\"november\", 11],\n  [\"december\", 12],\n  [\"january\", 1],\n  [\"february\", 2],\n  [\"march\", 3],\n  [\"may\", 5],\n  [\"june\", 6],\n  [\"july\", 7],\n  [\"august\", 8],\n  [\"october\", 10],\n  [\"jan\", 1],\n  [\"feb\", 2],\n  [\"mar\", 3],\n  [\"apr\", 4],\n  [\"jun\", 6],\n  [\"jul\", 7],\n  [\"aug\", 8],\n  [\"sep\", 9],\n  [\"sept\", 9],\n  [\"okt\", 10],\n  [\"oct\", 10],\n  [\"nov\", 11],\n  [\"dec\", 12],\n]);\n\n/**\n * A calendar month, held as a year from 1000 to 9999 and a month from 1 to 12.\n *\n * Accepts ISO 8601 (`2026-07`), a full ISO date read at month precision\n * (`2026-07-01`), slash-separated forms (`2026/07`, `07/2026`), and Swedish or\n * English month names (`juli 2026`, `Jul 2026`, `2026 July`).\n *\n * Sources:\n * - https://www.iso.org/iso-8601-date-and-time-format.html\n */\nexport class YearMonth {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Year-Month\",\n    localizedName: \"\u00C5rsm\u00E5nad\",\n    emoji: \"\uD83D\uDCC5\",\n    sources: Object.freeze([\"https://www.iso.org/iso-8601-date-and-time-format.html\"]),\n  });\n\n  /** The earliest supported year. */\n  static readonly minYear = MIN_YEAR;\n\n  /** The latest supported year. */\n  static readonly maxYear = MAX_YEAR;\n\n  private constructor(\n    /** The calendar year, e.g. `2026`. */\n    readonly year: number,\n    /** The calendar month, from 1 to 12. */\n    readonly month: number,\n  ) {}\n\n  /** Creates a year-month. Throws when either part is out of range. */\n  static create(year: number, month: number): YearMonth {\n    if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {\n      throw new Error(`Year must be between ${MIN_YEAR} and ${MAX_YEAR}.`);\n    }\n    if (!Number.isInteger(month) || month < 1 || month > 12) {\n      throw new Error(\"Month must be between 1 and 12.\");\n    }\n    return new YearMonth(year, month);\n  }\n\n  /** Creates a year-month from a date, discarding the day. */\n  static fromDate(date: Date): YearMonth {\n    return YearMonth.create(date.getFullYear(), date.getMonth() + 1);\n  }\n\n  static tryParse(input: string | null | undefined): YearMonth | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0) return null;\n\n    const iso = ISO_LIKE_PATTERN.exec(trimmed);\n    if (iso?.groups !== undefined) {\n      const day = iso.groups[\"day\"];\n      if (day !== undefined && !isValidDay(iso.groups[\"year\"]!, iso.groups[\"month\"]!, day)) {\n        return null;\n      }\n      return build(iso.groups[\"year\"]!, iso.groups[\"month\"]!);\n    }\n\n    const monthYear = MONTH_YEAR_NUMERIC_PATTERN.exec(trimmed);\n    if (monthYear?.groups !== undefined) {\n      return build(monthYear.groups[\"year\"]!, monthYear.groups[\"month\"]!);\n    }\n\n    const nameYear = MONTH_NAME_YEAR_PATTERN.exec(trimmed);\n    if (nameYear?.groups !== undefined) {\n      const month = tryParseMonthName(nameYear.groups[\"name\"]!);\n      if (month !== null) return build(nameYear.groups[\"year\"]!, String(month));\n    }\n\n    const yearName = YEAR_MONTH_NAME_PATTERN.exec(trimmed);\n    if (yearName?.groups !== undefined) {\n      const month = tryParseMonthName(yearName.groups[\"name\"]!);\n      if (month !== null) return build(yearName.groups[\"year\"]!, String(month));\n    }\n\n    return null;\n  }\n\n  static parse(input: string): YearMonth {\n    const result = YearMonth.tryParse(input);\n    if (result === null) throw new Error(\"Invalid year-month.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return YearMonth.tryParse(input) !== null;\n  }\n\n  /** The canonical ISO 8601 form, e.g. `2026-07`. */\n  static format(input: string | null | undefined, options?: YearMonthFormatOptions): string | null {\n    const parsed = YearMonth.tryParse(input);\n    if (parsed !== null) return parsed.toString();\n    return fallback(input, options);\n  }\n\n  /** The canonical ISO 8601 form, e.g. `2026-07`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: YearMonthFormatOptions,\n  ): string | null {\n    const parsed = YearMonth.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 && YearMonth.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return `${String(this.year).padStart(4, \"0\")}-${String(this.month).padStart(2, \"0\")}`;\n  }\n\n  toString(): string {\n    return this.toNormalizedString();\n  }\n\n  /** The first day of the month, as a UTC date. */\n  toFirstDayOfMonth(): Date {\n    return new Date(Date.UTC(this.year, this.month - 1, 1));\n  }\n\n  /** The last day of the month, as a UTC date. */\n  toLastDayOfMonth(): Date {\n    return new Date(Date.UTC(this.year, this.month, 0));\n  }\n\n  compareTo(other: YearMonth | null | undefined): number {\n    if (other == null) return 1;\n    if (this.year !== other.year) return this.year - other.year;\n    return this.month - other.month;\n  }\n\n  equals(other: YearMonth | null | undefined): boolean {\n    return other != null && this.year === other.year && this.month === other.month;\n  }\n}\n\n/** Returns a masked year-month, e.g. `2026-07` becomes `****-**`. */\nexport function maskYearMonth(yearMonth: YearMonth): string {\n  void yearMonth;\n  return \"****-**\";\n}\n\nfunction build(yearText: string, monthText: string): YearMonth | null {\n  const year = Number(yearText);\n  const month = Number(monthText);\n  if (year < MIN_YEAR || year > MAX_YEAR) return null;\n  if (month < 1 || month > 12) return null;\n  return YearMonth.create(year, month);\n}\n\nfunction isValidDay(yearText: string, monthText: string, dayText: string): boolean {\n  const year = Number(yearText);\n  const month = Number(monthText);\n  const day = Number(dayText);\n  if (year < MIN_YEAR || year > MAX_YEAR) return false;\n  if (month < 1 || month > 12) return false;\n  return day <= daysInMonth(year, month);\n}\n\nfunction daysInMonth(year: number, month: number): number {\n  return new Date(Date.UTC(year, month, 0)).getUTCDate();\n}\n\nfunction tryParseMonthName(name: string): number | null {\n  const key = name.trim().replace(/\\.$/u, \"\").toLowerCase();\n  return MONTH_NAMES.get(key) ?? null;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: YearMonthFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;\n  if (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/measurement/year.js

@@ -0,0 +1,89 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+const MIN_YEAR = 1e3;
+const MAX_YEAR = 9999;
+const YEAR_PATTERN = /^\s*(?<year>\d{4})\s*$/u;
+class Year {
+  constructor(value) {
+    this.value = value;
+  }
+  value;
+  static typeInfo = Object.freeze({
+    englishName: "Year",
+    localizedName: "\xC5r",
+    emoji: "\u{1F4C5}",
+    sources: Object.freeze(["https://www.iso.org/iso-8601-date-and-time-format.html"])
+  });
+  /** The earliest supported year. */
+  static minYear = MIN_YEAR;
+  /** The latest supported year. */
+  static maxYear = MAX_YEAR;
+  /** Creates a year from an integer. Throws when it is out of range. */
+  static create(year) {
+    if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {
+      throw new Error(`Year must be between ${MIN_YEAR} and ${MAX_YEAR}.`);
+    }
+    return new Year(year);
+  }
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = sanitizeInput(input).trim();
+    if (trimmed.length === 0) return null;
+    const match = YEAR_PATTERN.exec(trimmed);
+    const digits = match?.groups?.["year"];
+    if (digits === void 0) return null;
+    const year = Number(digits);
+    if (year < MIN_YEAR || year > MAX_YEAR) return null;
+    return new Year(year);
+  }
+  static parse(input) {
+    const result = Year.tryParse(input);
+    if (result === null) throw new Error("Invalid year.");
+    return result;
+  }
+  static isValid(input) {
+    return Year.tryParse(input) !== null;
+  }
+  /** The year as a four-digit string, e.g. `2024`. */
+  static format(input, options) {
+    const parsed = Year.tryParse(input);
+    if (parsed !== null) return parsed.toString();
+    return fallback(input, options);
+  }
+  /** The canonical four-digit year, e.g. `2024`. */
+  static normalize(input, options) {
+    const parsed = Year.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Year.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return String(this.value).padStart(4, "0");
+  }
+  toString() {
+    return this.toNormalizedString();
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value - other.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+}
+function maskYear(year) {
+  void year;
+  return "****";
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+  if (input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  Year,
+  maskYear
+};
+//# sourceMappingURL=year.js.map

package/dist/esm/measurement/year.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/year.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options for {@link Year.format} and {@link Year.normalize}. */\nexport interface YearFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MIN_YEAR = 1000;\nconst MAX_YEAR = 9999;\n\nconst YEAR_PATTERN = /^\\s*(?<year>\\d{4})\\s*$/u;\n\n/**\n * A four-digit calendar year from 1000 to 9999.\n *\n * Sources:\n * - https://www.iso.org/iso-8601-date-and-time-format.html\n */\nexport class Year {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Year\",\n    localizedName: \"\u00C5r\",\n    emoji: \"\uD83D\uDCC5\",\n    sources: Object.freeze([\"https://www.iso.org/iso-8601-date-and-time-format.html\"]),\n  });\n\n  /** The earliest supported year. */\n  static readonly minYear = MIN_YEAR;\n\n  /** The latest supported year. */\n  static readonly maxYear = MAX_YEAR;\n\n  private constructor(\n    /** The calendar year as an integer, e.g. `2024`. */\n    readonly value: number,\n  ) {}\n\n  /** Creates a year from an integer. Throws when it is out of range. */\n  static create(year: number): Year {\n    if (!Number.isInteger(year) || year < MIN_YEAR || year > MAX_YEAR) {\n      throw new Error(`Year must be between ${MIN_YEAR} and ${MAX_YEAR}.`);\n    }\n    return new Year(year);\n  }\n\n  static tryParse(input: string | null | undefined): Year | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0) return null;\n\n    const match = YEAR_PATTERN.exec(trimmed);\n    const digits = match?.groups?.[\"year\"];\n    if (digits === undefined) return null;\n\n    const year = Number(digits);\n    if (year < MIN_YEAR || year > MAX_YEAR) return null;\n\n    return new Year(year);\n  }\n\n  static parse(input: string): Year {\n    const result = Year.tryParse(input);\n    if (result === null) throw new Error(\"Invalid year.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Year.tryParse(input) !== null;\n  }\n\n  /** The year as a four-digit string, e.g. `2024`. */\n  static format(input: string | null | undefined, options?: YearFormatOptions): string | null {\n    const parsed = Year.tryParse(input);\n    if (parsed !== null) return parsed.toString();\n    return fallback(input, options);\n  }\n\n  /** The canonical four-digit year, e.g. `2024`. */\n  static normalize(input: string | null | undefined, options?: YearFormatOptions): string | null {\n    const parsed = Year.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 && Year.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return String(this.value).padStart(4, \"0\");\n  }\n\n  toString(): string {\n    return this.toNormalizedString();\n  }\n\n  compareTo(other: Year | null | undefined): number {\n    if (other == null) return 1;\n    return this.value - other.value;\n  }\n\n  equals(other: Year | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n}\n\n/** Returns a masked year, e.g. `2024` becomes `****`. */\nexport function maskYear(year: Year): string {\n  void year;\n  return \"****\";\n}\n\nfunction fallback(input: string | null | undefined, options?: YearFormatOptions): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;\n  if (input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAQ9B,MAAM,WAAW;AACjB,MAAM,WAAW;AAEjB,MAAM,eAAe;AAQd,MAAM,KAAK;AAAA,EAcR,YAEG,OACT;AADS;AAAA,EACR;AAAA,EADQ;AAAA,EAfX,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,wDAAwD,CAAC;AAAA,EACnF,CAAC;AAAA;AAAA,EAGD,OAAgB,UAAU;AAAA;AAAA,EAG1B,OAAgB,UAAU;AAAA;AAAA,EAQ1B,OAAO,OAAO,MAAoB;AAChC,QAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,YAAY,OAAO,UAAU;AACjE,YAAM,IAAI,MAAM,wBAAwB,QAAQ,QAAQ,QAAQ,GAAG;AAAA,IACrE;AACA,WAAO,IAAI,KAAK,IAAI;AAAA,EACtB;AAAA,EAEA,OAAO,SAAS,OAA+C;AAC7D,QAAI,SAAS,KAAM,QAAO;AAE1B,UAAM,UAAU,cAAc,KAAK,EAAE,KAAK;AAC1C,QAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,UAAM,QAAQ,aAAa,KAAK,OAAO;AACvC,UAAM,SAAS,OAAO,SAAS,MAAM;AACrC,QAAI,WAAW,OAAW,QAAO;AAEjC,UAAM,OAAO,OAAO,MAAM;AAC1B,QAAI,OAAO,YAAY,OAAO,SAAU,QAAO;AAE/C,WAAO,IAAI,KAAK,IAAI;AAAA,EACtB;AAAA,EAEA,OAAO,MAAM,OAAqB;AAChC,UAAM,SAAS,KAAK,SAAS,KAAK;AAClC,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,eAAe;AACpD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,KAAK,SAAS,KAAK,MAAM;AAAA,EAClC;AAAA;AAAA,EAGA,OAAO,OAAO,OAAkC,SAA4C;AAC1F,UAAM,SAAS,KAAK,SAAS,KAAK;AAClC,QAAI,WAAW,KAAM,QAAO,OAAO,SAAS;AAC5C,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,UAAU,OAAkC,SAA4C;AAC7F,UAAM,SAAS,KAAK,SAAS,KAAK;AAClC,QAAI,WAAW,KAAM,QAAO,OAAO,mBAAmB;AACtD,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,KAAK,UAAU,KAAK,MAAM;AAAA,EACpD;AAAA,EAEA,qBAA6B;AAC3B,WAAO,OAAO,KAAK,KAAK,EAAE,SAAS,GAAG,GAAG;AAAA,EAC3C;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK,mBAAmB;AAAA,EACjC;AAAA,EAEA,UAAU,OAAwC;AAChD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM;AAAA,EAC5B;AAAA,EAEA,OAAO,OAAyC;AAC9C,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AACF;AAGO,SAAS,SAAS,MAAoB;AAC3C,OAAK;AACL,SAAO;AACT;AAEA,SAAS,SAAS,OAAkC,SAA4C;AAC9F,MAAI,SAAS,sCAAsC,KAAM,QAAO;AAChE,MAAI,SAAS,KAAM,QAAO;AAC1B,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;",
+  "names": []
+}

package/dist/esm/organization/duns-number.js

@@ -0,0 +1,94 @@
+import { keepDigits, sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+const MAX_INPUT_LENGTH = 20;
+class DunsNumber {
+  static typeInfo = Object.freeze({
+    englishName: "D-U-N-S Number",
+    localizedName: "D-U-N-S-nummer",
+    emoji: "\u{1F522}",
+    sources: Object.freeze([
+      "https://www.dnb.com/duns.html",
+      "https://en.wikipedia.org/wiki/Data_Universal_Numbering_System"
+    ])
+  });
+  digits;
+  constructor(digits) {
+    this.digits = digits;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const digits = keepDigits(sanitizeInput(input));
+    if (digits.length > MAX_INPUT_LENGTH || digits.length !== 9) return null;
+    return new DunsNumber(digits);
+  }
+  static parse(input) {
+    const r = DunsNumber.tryParse(input);
+    if (r === null) throw new Error("Invalid D-U-N-S number.");
+    return r;
+  }
+  static isValid(input) {
+    return DunsNumber.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = DunsNumber.tryParse(input);
+    if (r) return r.digits;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return DunsNumber.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && DunsNumber.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.digits;
+  }
+  toString() {
+    return this.digits;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const re = /(?<!\d)\d{9}(?!\d)/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      const r = DunsNumber.tryParse(m[0]);
+      if (!r) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "DunsNumber",
+          category: TextCandidateCategory.OrganizationIdentifier,
+          normalizedForm: r.toNormalizedString(),
+          formattedForm: r.toString(),
+          maskedForm: maskDunsNumber(r),
+          confidence: TextMatchConfidence.Low,
+          value: r
+        })
+      );
+    }
+    return out;
+  }
+  equals(other) {
+    return other != null && this.digits === other.digits;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;
+  }
+}
+function maskDunsNumber(d) {
+  return "*".repeat(d.digits.length);
+}
+export {
+  DunsNumber,
+  maskDunsNumber
+};
+//# sourceMappingURL=duns-number.js.map

package/dist/esm/organization/duns-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/organization/duns-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { keepDigits, 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\";\n\nconst MAX_INPUT_LENGTH = 20;\n\n/** A 9-digit D-U-N-S number. */\nexport class DunsNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"D-U-N-S Number\",\n    localizedName: \"D-U-N-S-nummer\",\n    emoji: \"\\u{1F522}\",\n    sources: Object.freeze([\n      \"https://www.dnb.com/duns.html\",\n      \"https://en.wikipedia.org/wiki/Data_Universal_Numbering_System\",\n    ]),\n  });\n\n  readonly digits: string;\n  private constructor(digits: string) {\n    this.digits = digits;\n  }\n\n  static tryParse(input: string | null | undefined): DunsNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const digits = keepDigits(sanitizeInput(input));\n    if (digits.length > MAX_INPUT_LENGTH || digits.length !== 9) return null;\n    return new DunsNumber(digits);\n  }\n\n  static parse(input: string): DunsNumber {\n    const r = DunsNumber.tryParse(input);\n    if (r === null) throw new Error(\"Invalid D-U-N-S number.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return DunsNumber.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = DunsNumber.tryParse(input);\n    if (r) return r.digits;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    return DunsNumber.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && DunsNumber.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.digits;\n  }\n  toString(): string {\n    return this.digits;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<DunsNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<DunsNumber>[] = [];\n    const re = /(?<!\\d)\\d{9}(?!\\d)/g;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n      const r = DunsNumber.tryParse(m[0]);\n      if (!r) continue;\n      out.push(\n        new TextCandidate<DunsNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"DunsNumber\",\n          category: TextCandidateCategory.OrganizationIdentifier,\n          normalizedForm: r.toNormalizedString(),\n          formattedForm: r.toString(),\n          maskedForm: maskDunsNumber(r),\n          confidence: TextMatchConfidence.Low,\n          value: r,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: DunsNumber | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n  compareTo(other: DunsNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;\n  }\n}\n\n/** Masks all digits of a D-U-N-S number. */\nexport function maskDunsNumber(d: DunsNumber): string {\n  return \"*\".repeat(d.digits.length);\n}\n"],
+  "mappings": "AACA,SAAS,YAAY,qBAAqB;AAC1C,SAAS,6BAA6B;AACtC,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AAEpC,MAAM,mBAAmB;AAGlB,MAAM,WAAW;AAAA,EACtB,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA,EAEQ;AAAA,EACD,YAAY,QAAgB;AAClC,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,OAAO,SAAS,OAAqD;AACnE,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,SAAS,WAAW,cAAc,KAAK,CAAC;AAC9C,QAAI,OAAO,SAAS,oBAAoB,OAAO,WAAW,EAAG,QAAO;AACpE,WAAO,IAAI,WAAW,MAAM;AAAA,EAC9B;AAAA,EAEA,OAAO,MAAM,OAA2B;AACtC,UAAM,IAAI,WAAW,SAAS,KAAK;AACnC,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,yBAAyB;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,WAAW,SAAS,KAAK,MAAM;AAAA,EACxC;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,WAAW,SAAS,KAAK;AACnC,QAAI,EAAG,QAAO,EAAE;AAChB,QAAI,SAAS,qCAAqC,SAAS,QAAQ,MAAM,KAAK,MAAM,IAAI;AACtF,aAAO,MAAM,KAAK;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,UACL,OACA,SACe;AACf,WAAO,WAAW,OAAO,OAAO,OAAO;AAAA,EACzC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,WAAW,UAAU,KAAK,MAAM;AAAA,EAC1D;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,qBAAqB,MAAoD;AAC9E,QAAI,CAAC,KAAM,QAAO,CAAC;AACnB,UAAM,MAAmC,CAAC;AAC1C,UAAM,KAAK;AACX,QAAI;AACJ,YAAQ,IAAI,GAAG,KAAK,IAAI,OAAO,MAAM;AACnC,YAAM,IAAI,WAAW,SAAS,EAAE,CAAC,CAAC;AAClC,UAAI,CAAC,EAAG;AACR,UAAI;AAAA,QACF,IAAI,cAA0B;AAAA,UAC5B,YAAY,EAAE;AAAA,UACd,QAAQ,EAAE,CAAC,EAAE;AAAA,UACb,cAAc,EAAE,CAAC;AAAA,UACjB,UAAU;AAAA,UACV,UAAU,sBAAsB;AAAA,UAChC,gBAAgB,EAAE,mBAAmB;AAAA,UACrC,eAAe,EAAE,SAAS;AAAA,UAC1B,YAAY,eAAe,CAAC;AAAA,UAC5B,YAAY,oBAAoB;AAAA,UAChC,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAA+C;AACpD,WAAO,SAAS,QAAQ,KAAK,WAAW,MAAM;AAAA,EAChD;AAAA,EACA,UAAU,OAA8C;AACtD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;AAAA,EAC5E;AACF;AAGO,SAAS,eAAe,GAAuB;AACpD,SAAO,IAAI,OAAO,EAAE,OAAO,MAAM;AACnC;",
+  "names": []
+}

package/dist/esm/organization/elf-code.js

@@ -0,0 +1,112 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { keepAsciiAlphanumericUppercase } from "../internal/input-sanitization.js";
+const CODE_LENGTH = 4;
+const MAX_INPUT_LENGTH = 20;
+const KNOWN_CODES = /* @__PURE__ */ new Map([
+  ["XTIQ", { englishName: "Limited company", swedishName: "Aktiebolag" }],
+  ["N2GY", { englishName: "General partnership", swedishName: "Handelsbolag" }],
+  ["FR3V", { englishName: "Limited partnership", swedishName: "Kommanditbolag" }],
+  ["V2YH", { englishName: "Economic association", swedishName: "Ekonomisk f\xF6rening" }],
+  ["WJEL", { englishName: "Sole proprietorship", swedishName: "Enskild n\xE4ringsidkare" }],
+  ["CLBQ", { englishName: "Foundation", swedishName: "Stiftelse" }],
+  ["F85L", { englishName: "Non-profit association", swedishName: "Ideell f\xF6rening" }],
+  ["O9FH", { englishName: "Housing cooperative", swedishName: "Bostadsr\xE4ttsf\xF6rening" }],
+  [
+    "H0PO",
+    {
+      englishName: "Cooperative housing association",
+      swedishName: "Kooperativ hyresr\xE4ttsf\xF6rening"
+    }
+  ],
+  ["2HBR", { englishName: "Government entity", swedishName: "Statlig enhet" }],
+  ["EVKQ", { englishName: "Municipality", swedishName: "Kommun" }],
+  ["R7GX", { englishName: "Region", swedishName: "Region" }],
+  ["KQM9", { englishName: "Banking company", swedishName: "Bankaktiebolag" }],
+  ["L5CF", { englishName: "Insurance company", swedishName: "F\xF6rs\xE4kringsaktiebolag" }],
+  ["LRQE", { englishName: "Mutual insurance company", swedishName: "\xD6msesidigt f\xF6rs\xE4kringsbolag" }],
+  [
+    "J4GF",
+    { englishName: "Branch of foreign company", swedishName: "Filial till utl\xE4ndskt f\xF6retag" }
+  ],
+  ["9GQP", { englishName: "European company (SE)", swedishName: "Europabolag" }]
+]);
+class ElfCode {
+  static typeInfo = Object.freeze({
+    englishName: "Entity Legal Form Code",
+    localizedName: "Juridisk f\xF6retagsform",
+    emoji: "\u{1F4CB}",
+    sources: Object.freeze([
+      "https://www.gleif.org/en/about-lei/code-lists/iso-20275-entity-legal-forms-code-list",
+      "https://www.iso.org/standard/67462.html"
+    ])
+  });
+  code;
+  englishName;
+  localizedName;
+  get displayName() {
+    const localized = PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+    return localized ?? this.code;
+  }
+  get isKnown() {
+    return this.englishName !== null;
+  }
+  constructor(code, en, sv) {
+    this.code = code;
+    this.englishName = en;
+    this.localizedName = sv;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const cleaned = keepAsciiAlphanumericUppercase(input);
+    if (cleaned.length > MAX_INPUT_LENGTH || cleaned.length !== CODE_LENGTH) return null;
+    const known = KNOWN_CODES.get(cleaned);
+    return new ElfCode(cleaned, known?.englishName ?? null, known?.swedishName ?? null);
+  }
+  static parse(input) {
+    const r = ElfCode.tryParse(input);
+    if (r === null) {
+      throw new Error("Invalid ELF code (must be exactly 4 alphanumeric characters).");
+    }
+    return r;
+  }
+  static isValid(input) {
+    return ElfCode.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = ElfCode.tryParse(input);
+    if (r) return r.displayName;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    const r = ElfCode.tryParse(input);
+    if (r) return r.code;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {
+      const t = input.trim();
+      return t.length > 0 ? t : null;
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && ElfCode.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.code;
+  }
+  toString() {
+    return this.displayName;
+  }
+  equals(other) {
+    return other != null && this.code === other.code;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.code < other.code ? -1 : this.code > other.code ? 1 : 0;
+  }
+}
+export {
+  ElfCode
+};
+//# sourceMappingURL=elf-code.js.map

package/dist/esm/organization/elf-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/organization/elf-code.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { keepAsciiAlphanumericUppercase } from \"../internal/input-sanitization.js\";\n\nconst CODE_LENGTH = 4;\nconst MAX_INPUT_LENGTH = 20;\n\ninterface KnownElf {\n  englishName: string;\n  swedishName: string;\n}\n\nconst KNOWN_CODES: ReadonlyMap<string, KnownElf> = new Map<string, KnownElf>([\n  [\"XTIQ\", { englishName: \"Limited company\", swedishName: \"Aktiebolag\" }],\n  [\"N2GY\", { englishName: \"General partnership\", swedishName: \"Handelsbolag\" }],\n  [\"FR3V\", { englishName: \"Limited partnership\", swedishName: \"Kommanditbolag\" }],\n  [\"V2YH\", { englishName: \"Economic association\", swedishName: \"Ekonomisk f\u00F6rening\" }],\n  [\"WJEL\", { englishName: \"Sole proprietorship\", swedishName: \"Enskild n\u00E4ringsidkare\" }],\n  [\"CLBQ\", { englishName: \"Foundation\", swedishName: \"Stiftelse\" }],\n  [\"F85L\", { englishName: \"Non-profit association\", swedishName: \"Ideell f\u00F6rening\" }],\n  [\"O9FH\", { englishName: \"Housing cooperative\", swedishName: \"Bostadsr\u00E4ttsf\u00F6rening\" }],\n  [\n    \"H0PO\",\n    {\n      englishName: \"Cooperative housing association\",\n      swedishName: \"Kooperativ hyresr\u00E4ttsf\u00F6rening\",\n    },\n  ],\n  [\"2HBR\", { englishName: \"Government entity\", swedishName: \"Statlig enhet\" }],\n  [\"EVKQ\", { englishName: \"Municipality\", swedishName: \"Kommun\" }],\n  [\"R7GX\", { englishName: \"Region\", swedishName: \"Region\" }],\n  [\"KQM9\", { englishName: \"Banking company\", swedishName: \"Bankaktiebolag\" }],\n  [\"L5CF\", { englishName: \"Insurance company\", swedishName: \"F\u00F6rs\u00E4kringsaktiebolag\" }],\n  [\"LRQE\", { englishName: \"Mutual insurance company\", swedishName: \"\u00D6msesidigt f\u00F6rs\u00E4kringsbolag\" }],\n  [\n    \"J4GF\",\n    { englishName: \"Branch of foreign company\", swedishName: \"Filial till utl\u00E4ndskt f\u00F6retag\" },\n  ],\n  [\"9GQP\", { englishName: \"European company (SE)\", swedishName: \"Europabolag\" }],\n]);\n\n/** ISO 20275 Entity Legal Form code. */\nexport class ElfCode {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Entity Legal Form Code\",\n    localizedName: \"Juridisk f\u00F6retagsform\",\n    emoji: \"\\u{1F4CB}\",\n    sources: Object.freeze([\n      \"https://www.gleif.org/en/about-lei/code-lists/iso-20275-entity-legal-forms-code-list\",\n      \"https://www.iso.org/standard/67462.html\",\n    ]),\n  });\n\n  readonly code: string;\n  readonly englishName: string | null;\n  readonly localizedName: string | null;\n\n  get displayName(): string {\n    const localized = PrimitivesDefaults.useLocalizedDisplayNames\n      ? this.localizedName\n      : this.englishName;\n    return localized ?? this.code;\n  }\n\n  get isKnown(): boolean {\n    return this.englishName !== null;\n  }\n\n  private constructor(code: string, en: string | null, sv: string | null) {\n    this.code = code;\n    this.englishName = en;\n    this.localizedName = sv;\n  }\n\n  static tryParse(input: string | null | undefined): ElfCode | null {\n    if (input == null || input.trim() === \"\") return null;\n    const cleaned = keepAsciiAlphanumericUppercase(input);\n    if (cleaned.length > MAX_INPUT_LENGTH || cleaned.length !== CODE_LENGTH) return null;\n    const known = KNOWN_CODES.get(cleaned);\n    return new ElfCode(cleaned, known?.englishName ?? null, known?.swedishName ?? null);\n  }\n\n  static parse(input: string): ElfCode {\n    const r = ElfCode.tryParse(input);\n    if (r === null) {\n      throw new Error(\"Invalid ELF code (must be exactly 4 alphanumeric characters).\");\n    }\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return ElfCode.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = ElfCode.tryParse(input);\n    if (r) return r.displayName;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = ElfCode.tryParse(input);\n    if (r) return r.code;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {\n      const t = input.trim();\n      return t.length > 0 ? t : null;\n    }\n    return null;\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && ElfCode.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.code;\n  }\n  toString(): string {\n    return this.displayName;\n  }\n\n  equals(other: ElfCode | null | undefined): boolean {\n    return other != null && this.code === other.code;\n  }\n  compareTo(other: ElfCode | null | undefined): number {\n    if (other == null) return 1;\n    return this.code < other.code ? -1 : this.code > other.code ? 1 : 0;\n  }\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AACnC,SAAS,sCAAsC;AAE/C,MAAM,cAAc;AACpB,MAAM,mBAAmB;AAOzB,MAAM,cAA6C,oBAAI,IAAsB;AAAA,EAC3E,CAAC,QAAQ,EAAE,aAAa,mBAAmB,aAAa,aAAa,CAAC;AAAA,EACtE,CAAC,QAAQ,EAAE,aAAa,uBAAuB,aAAa,eAAe,CAAC;AAAA,EAC5E,CAAC,QAAQ,EAAE,aAAa,uBAAuB,aAAa,iBAAiB,CAAC;AAAA,EAC9E,CAAC,QAAQ,EAAE,aAAa,wBAAwB,aAAa,wBAAqB,CAAC;AAAA,EACnF,CAAC,QAAQ,EAAE,aAAa,uBAAuB,aAAa,2BAAwB,CAAC;AAAA,EACrF,CAAC,QAAQ,EAAE,aAAa,cAAc,aAAa,YAAY,CAAC;AAAA,EAChE,CAAC,QAAQ,EAAE,aAAa,0BAA0B,aAAa,qBAAkB,CAAC;AAAA,EAClF,CAAC,QAAQ,EAAE,aAAa,uBAAuB,aAAa,6BAAuB,CAAC;AAAA,EACpF;AAAA,IACE;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,CAAC,QAAQ,EAAE,aAAa,qBAAqB,aAAa,gBAAgB,CAAC;AAAA,EAC3E,CAAC,QAAQ,EAAE,aAAa,gBAAgB,aAAa,SAAS,CAAC;AAAA,EAC/D,CAAC,QAAQ,EAAE,aAAa,UAAU,aAAa,SAAS,CAAC;AAAA,EACzD,CAAC,QAAQ,EAAE,aAAa,mBAAmB,aAAa,iBAAiB,CAAC;AAAA,EAC1E,CAAC,QAAQ,EAAE,aAAa,qBAAqB,aAAa,8BAAwB,CAAC;AAAA,EACnF,CAAC,QAAQ,EAAE,aAAa,4BAA4B,aAAa,uCAA8B,CAAC;AAAA,EAChG;AAAA,IACE;AAAA,IACA,EAAE,aAAa,6BAA6B,aAAa,sCAAgC;AAAA,EAC3F;AAAA,EACA,CAAC,QAAQ,EAAE,aAAa,yBAAyB,aAAa,cAAc,CAAC;AAC/E,CAAC;AAGM,MAAM,QAAQ;AAAA,EACnB,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA,EAEQ;AAAA,EACA;AAAA,EACA;AAAA,EAET,IAAI,cAAsB;AACxB,UAAM,YAAY,mBAAmB,2BACjC,KAAK,gBACL,KAAK;AACT,WAAO,aAAa,KAAK;AAAA,EAC3B;AAAA,EAEA,IAAI,UAAmB;AACrB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEQ,YAAY,MAAc,IAAmB,IAAmB;AACtE,SAAK,OAAO;AACZ,SAAK,cAAc;AACnB,SAAK,gBAAgB;AAAA,EACvB;AAAA,EAEA,OAAO,SAAS,OAAkD;AAChE,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,UAAU,+BAA+B,KAAK;AACpD,QAAI,QAAQ,SAAS,oBAAoB,QAAQ,WAAW,YAAa,QAAO;AAChF,UAAM,QAAQ,YAAY,IAAI,OAAO;AACrC,WAAO,IAAI,QAAQ,SAAS,OAAO,eAAe,MAAM,OAAO,eAAe,IAAI;AAAA,EACpF;AAAA,EAEA,OAAO,MAAM,OAAwB;AACnC,UAAM,IAAI,QAAQ,SAAS,KAAK;AAChC,QAAI,MAAM,MAAM;AACd,YAAM,IAAI,MAAM,+DAA+D;AAAA,IACjF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,QAAQ,SAAS,KAAK,MAAM;AAAA,EACrC;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,QAAQ,SAAS,KAAK;AAChC,QAAI,EAAG,QAAO,EAAE;AAChB,QAAI,SAAS,qCAAqC,SAAS,QAAQ,MAAM,KAAK,MAAM,IAAI;AACtF,aAAO,MAAM,KAAK;AAAA,IACpB;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,UACL,OACA,SACe;AACf,UAAM,IAAI,QAAQ,SAAS,KAAK;AAChC,QAAI,EAAG,QAAO,EAAE;AAChB,QAAI,SAAS,qCAAqC,SAAS,MAAM;AAC/D,YAAM,IAAI,MAAM,KAAK;AACrB,aAAO,EAAE,SAAS,IAAI,IAAI;AAAA,IAC5B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,QAAQ,UAAU,KAAK,MAAM;AAAA,EACvD;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAA4C;AACjD,WAAO,SAAS,QAAQ,KAAK,SAAS,MAAM;AAAA,EAC9C;AAAA,EACA,UAAU,OAA2C;AACnD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,OAAO,MAAM,OAAO,KAAK,KAAK,OAAO,MAAM,OAAO,IAAI;AAAA,EACpE;AACF;",
+  "names": []
+}