@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/esm/banking/swedish-swish-number.js

@@ -0,0 +1,145 @@
+import { keepDigits, sanitizeInput } from "../internal/input-sanitization.js";
+import { PhoneNumber, maskPhoneNumber } from "../contact/phone-number.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 = 50;
+const DIGITS_7_STARTING_90 = /^90\d{5}$/;
+class SwedishSwishNumber {
+  static typeInfo = Object.freeze({
+    englishName: "Swish Number",
+    localizedName: "Swish-nummer",
+    emoji: "\u{1F4F1}",
+    sources: Object.freeze([
+      "https://www.swish.nu/faq/company/what-is-the-format-of-the-swish-number",
+      "https://github.com/cisene/swish-123",
+      "https://www.insamlingskontroll.se/"
+    ])
+  });
+  value;
+  formatted;
+  isSwish123;
+  isMobileNumber;
+  is90Number;
+  phoneNumber;
+  constructor(value, formatted, isSwish123, isMobileNumber, is90Number, phoneNumber) {
+    this.value = value;
+    this.formatted = formatted;
+    this.isSwish123 = isSwish123;
+    this.isMobileNumber = isMobileNumber;
+    this.is90Number = is90Number;
+    this.phoneNumber = phoneNumber;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const cleaned = sanitizeInput(input).trim();
+    if (cleaned.length > MAX_INPUT_LENGTH) return null;
+    const digits = keepDigits(cleaned);
+    if (DIGITS_7_STARTING_90.test(digits)) {
+      const expanded = "123" + digits;
+      return new SwedishSwishNumber(expanded, format90Number(digits), true, false, true, null);
+    }
+    if (digits.length === 10 && digits.startsWith("123")) {
+      const is90 = digits.startsWith("1239");
+      return new SwedishSwishNumber(
+        digits,
+        is90 ? format90Number(digits.slice(3)) : formatSwish123(digits),
+        true,
+        false,
+        is90,
+        null
+      );
+    }
+    const phone = PhoneNumber.tryParse(cleaned);
+    if (phone !== null && phone.isSwedish && phone.isMobile) {
+      return new SwedishSwishNumber(phone.digits, phone.formatted, false, true, false, phone);
+    }
+    return null;
+  }
+  static parse(input) {
+    const r = SwedishSwishNumber.tryParse(input);
+    if (r === null) throw new Error("Invalid Swish number.");
+    return r;
+  }
+  static isValid(input) {
+    return SwedishSwishNumber.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishSwishNumber.tryParse(input);
+    if (r) return r.formatted;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    const r = SwedishSwishNumber.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && SwedishSwishNumber.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.formatted;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const re = /(?<!\d)123[\s-]?\d{3}[\s-]?\d{2}[\s-]?\d{2}(?!\d)|(?<!\d)90[0-9][\s-]?\d{2}[\s-]?\d{2}(?!\d)/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      const r = SwedishSwishNumber.tryParse(m[0]);
+      if (!r) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "SwedishSwishNumber",
+          category: TextCandidateCategory.Financial,
+          normalizedForm: r.toNormalizedString(),
+          formattedForm: r.toString(),
+          maskedForm: maskSwedishSwishNumber(r),
+          confidence: TextMatchConfidence.Medium,
+          value: r
+        })
+      );
+    }
+    return out;
+  }
+  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 formatSwish123(digits) {
+  if (digits.length !== 10) return digits;
+  return `${digits.slice(0, 3)}-${digits.slice(3, 6)} ${digits.slice(6, 8)} ${digits.slice(8, 10)}`;
+}
+function format90Number(shortDigits) {
+  if (shortDigits.length !== 7) return shortDigits;
+  return `${shortDigits.slice(0, 3)} ${shortDigits.slice(3, 5)} ${shortDigits.slice(5, 7)}`;
+}
+function maskSwedishSwishNumber(swish) {
+  if (swish.is90Number) {
+    const shortDigits = swish.value.slice(3);
+    return `${shortDigits[0]}** ** **`;
+  }
+  if (swish.isSwish123) return "123-*** ** **";
+  return swish.phoneNumber !== null ? maskPhoneNumber(swish.phoneNumber) : "*".repeat(swish.value.length);
+}
+export {
+  SwedishSwishNumber,
+  maskSwedishSwishNumber
+};
+//# sourceMappingURL=swedish-swish-number.js.map

package/dist/esm/banking/swedish-swish-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/banking/swedish-swish-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { keepDigits, sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { PhoneNumber, maskPhoneNumber } from \"../contact/phone-number.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 = 50;\nconst DIGITS_7_STARTING_90 = /^90\\d{5}$/;\n\n/**\n * A Swedish Swish payment number (`Swish-nummer`).\n * Accepts:\n * - Swish 123 numbers (10 digits starting with `123`)\n * - 90-numbers (7 digits starting with `90X`, expanded to `123` + 7 digits)\n * - Swedish mobile phone numbers\n */\nexport class SwedishSwishNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Swish Number\",\n    localizedName: \"Swish-nummer\",\n    emoji: \"\\u{1F4F1}\",\n    sources: Object.freeze([\n      \"https://www.swish.nu/faq/company/what-is-the-format-of-the-swish-number\",\n      \"https://github.com/cisene/swish-123\",\n      \"https://www.insamlingskontroll.se/\",\n    ]),\n  });\n\n  readonly value: string;\n  readonly formatted: string;\n  readonly isSwish123: boolean;\n  readonly isMobileNumber: boolean;\n  readonly is90Number: boolean;\n  readonly phoneNumber: PhoneNumber | null;\n\n  private constructor(\n    value: string,\n    formatted: string,\n    isSwish123: boolean,\n    isMobileNumber: boolean,\n    is90Number: boolean,\n    phoneNumber: PhoneNumber | null,\n  ) {\n    this.value = value;\n    this.formatted = formatted;\n    this.isSwish123 = isSwish123;\n    this.isMobileNumber = isMobileNumber;\n    this.is90Number = is90Number;\n    this.phoneNumber = phoneNumber;\n  }\n\n  static tryParse(input: string | null | undefined): SwedishSwishNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const cleaned = sanitizeInput(input).trim();\n    if (cleaned.length > MAX_INPUT_LENGTH) return null;\n\n    const digits = keepDigits(cleaned);\n\n    if (DIGITS_7_STARTING_90.test(digits)) {\n      const expanded = \"123\" + digits;\n      return new SwedishSwishNumber(expanded, format90Number(digits), true, false, true, null);\n    }\n\n    if (digits.length === 10 && digits.startsWith(\"123\")) {\n      const is90 = digits.startsWith(\"1239\");\n      return new SwedishSwishNumber(\n        digits,\n        is90 ? format90Number(digits.slice(3)) : formatSwish123(digits),\n        true,\n        false,\n        is90,\n        null,\n      );\n    }\n\n    const phone = PhoneNumber.tryParse(cleaned);\n    if (phone !== null && phone.isSwedish && phone.isMobile) {\n      return new SwedishSwishNumber(phone.digits, phone.formatted, false, true, false, phone);\n    }\n\n    return null;\n  }\n\n  static parse(input: string): SwedishSwishNumber {\n    const r = SwedishSwishNumber.tryParse(input);\n    if (r === null) throw new Error(\"Invalid Swish number.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishSwishNumber.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = SwedishSwishNumber.tryParse(input);\n    if (r) return r.formatted;\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 = SwedishSwishNumber.tryParse(input);\n    if (r) return r.value;\n    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== \"\") {\n      return input.trim();\n    }\n    return null;\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && SwedishSwishNumber.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.formatted;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<SwedishSwishNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishSwishNumber>[] = [];\n    const re =\n      /(?<!\\d)123[\\s-]?\\d{3}[\\s-]?\\d{2}[\\s-]?\\d{2}(?!\\d)|(?<!\\d)90[0-9][\\s-]?\\d{2}[\\s-]?\\d{2}(?!\\d)/g;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n      const r = SwedishSwishNumber.tryParse(m[0]);\n      if (!r) continue;\n      out.push(\n        new TextCandidate<SwedishSwishNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishSwishNumber\",\n          category: TextCandidateCategory.Financial,\n          normalizedForm: r.toNormalizedString(),\n          formattedForm: r.toString(),\n          maskedForm: maskSwedishSwishNumber(r),\n          confidence: TextMatchConfidence.Medium,\n          value: r,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: SwedishSwishNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: SwedishSwishNumber | 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\nfunction formatSwish123(digits: string): string {\n  if (digits.length !== 10) return digits;\n  return `${digits.slice(0, 3)}-${digits.slice(3, 6)} ${digits.slice(6, 8)} ${digits.slice(8, 10)}`;\n}\n\nfunction format90Number(shortDigits: string): string {\n  if (shortDigits.length !== 7) return shortDigits;\n  return `${shortDigits.slice(0, 3)} ${shortDigits.slice(3, 5)} ${shortDigits.slice(5, 7)}`;\n}\n\n/**\n * Returns a masked Swish number, e.g. `123-*** ** **` for 123-numbers,\n * `9** ** **` for 90-numbers.\n */\nexport function maskSwedishSwishNumber(swish: SwedishSwishNumber): string {\n  if (swish.is90Number) {\n    const shortDigits = swish.value.slice(3);\n    return `${shortDigits[0]}** ** **`;\n  }\n  if (swish.isSwish123) return \"123-*** ** **\";\n  return swish.phoneNumber !== null\n    ? maskPhoneNumber(swish.phoneNumber)\n    : \"*\".repeat(swish.value.length);\n}\n"],
+  "mappings": "AACA,SAAS,YAAY,qBAAqB;AAC1C,SAAS,aAAa,uBAAuB;AAC7C,SAAS,6BAA6B;AACtC,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AAEpC,MAAM,mBAAmB;AACzB,MAAM,uBAAuB;AAStB,MAAM,mBAAmB;AAAA,EAC9B,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA,EAEQ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAED,YACN,OACA,WACA,YACA,gBACA,YACA,aACA;AACA,SAAK,QAAQ;AACb,SAAK,YAAY;AACjB,SAAK,aAAa;AAClB,SAAK,iBAAiB;AACtB,SAAK,aAAa;AAClB,SAAK,cAAc;AAAA,EACrB;AAAA,EAEA,OAAO,SAAS,OAA6D;AAC3E,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,UAAU,cAAc,KAAK,EAAE,KAAK;AAC1C,QAAI,QAAQ,SAAS,iBAAkB,QAAO;AAE9C,UAAM,SAAS,WAAW,OAAO;AAEjC,QAAI,qBAAqB,KAAK,MAAM,GAAG;AACrC,YAAM,WAAW,QAAQ;AACzB,aAAO,IAAI,mBAAmB,UAAU,eAAe,MAAM,GAAG,MAAM,OAAO,MAAM,IAAI;AAAA,IACzF;AAEA,QAAI,OAAO,WAAW,MAAM,OAAO,WAAW,KAAK,GAAG;AACpD,YAAM,OAAO,OAAO,WAAW,MAAM;AACrC,aAAO,IAAI;AAAA,QACT;AAAA,QACA,OAAO,eAAe,OAAO,MAAM,CAAC,CAAC,IAAI,eAAe,MAAM;AAAA,QAC9D;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,QAAQ,YAAY,SAAS,OAAO;AAC1C,QAAI,UAAU,QAAQ,MAAM,aAAa,MAAM,UAAU;AACvD,aAAO,IAAI,mBAAmB,MAAM,QAAQ,MAAM,WAAW,OAAO,MAAM,OAAO,KAAK;AAAA,IACxF;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAM,OAAmC;AAC9C,UAAM,IAAI,mBAAmB,SAAS,KAAK;AAC3C,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,uBAAuB;AACvD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,mBAAmB,SAAS,KAAK,MAAM;AAAA,EAChD;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,mBAAmB,SAAS,KAAK;AAC3C,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,mBAAmB,SAAS,KAAK;AAC3C,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,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,mBAAmB,UAAU,KAAK,MAAM;AAAA,EAClE;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,qBAAqB,MAA4D;AACtF,QAAI,CAAC,KAAM,QAAO,CAAC;AACnB,UAAM,MAA2C,CAAC;AAClD,UAAM,KACJ;AACF,QAAI;AACJ,YAAQ,IAAI,GAAG,KAAK,IAAI,OAAO,MAAM;AACnC,YAAM,IAAI,mBAAmB,SAAS,EAAE,CAAC,CAAC;AAC1C,UAAI,CAAC,EAAG;AACR,UAAI;AAAA,QACF,IAAI,cAAkC;AAAA,UACpC,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,uBAAuB,CAAC;AAAA,UACpC,YAAY,oBAAoB;AAAA,UAChC,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAAuD;AAC5D,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EACA,UAAU,OAAsD;AAC9D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;AAEA,SAAS,eAAe,QAAwB;AAC9C,MAAI,OAAO,WAAW,GAAI,QAAO;AACjC,SAAO,GAAG,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,MAAM,GAAG,EAAE,CAAC;AACjG;AAEA,SAAS,eAAe,aAA6B;AACnD,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,GAAG,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI,YAAY,MAAM,GAAG,CAAC,CAAC;AACzF;AAMO,SAAS,uBAAuB,OAAmC;AACxE,MAAI,MAAM,YAAY;AACpB,UAAM,cAAc,MAAM,MAAM,MAAM,CAAC;AACvC,WAAO,GAAG,YAAY,CAAC,CAAC;AAAA,EAC1B;AACA,MAAI,MAAM,WAAY,QAAO;AAC7B,SAAO,MAAM,gBAAgB,OACzB,gBAAgB,MAAM,WAAW,IACjC,IAAI,OAAO,MAAM,MAAM,MAAM;AACnC;",
+  "names": []
+}

package/dist/esm/contact/address-city.js

@@ -0,0 +1,84 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { collapseWhitespace } from "../internal/input-sanitization.js";
+const MAX_INPUT_LENGTH = 100;
+const NAME_PATTERN = /^(?:[\p{L}\p{M}]{2,}|['\p{L}\p{M}]{2,}|[\p{Lo}])(?:['\p{Zs}-][\p{L}\p{M}]+)*$/u;
+class AddressCity {
+  static typeInfo = Object.freeze({
+    englishName: "City",
+    localizedName: "Postort",
+    emoji: "\u{1F3D9}\uFE0F",
+    sources: Object.freeze(["https://www.postnord.se/"])
+  });
+  value;
+  constructor(value) {
+    this.value = value;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const cleaned = collapseWhitespace(input);
+    if (cleaned.length === 0 || cleaned.length > MAX_INPUT_LENGTH) return null;
+    const capitalized = capitalizeEachWord(cleaned);
+    if ([...capitalized].some(isDisallowed)) return null;
+    if (!NAME_PATTERN.test(capitalized)) return null;
+    return new AddressCity(capitalized);
+  }
+  static parse(input) {
+    const r = AddressCity.tryParse(input);
+    if (r === null) throw new Error("Invalid city name.");
+    return r;
+  }
+  static isValid(input) {
+    return AddressCity.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = AddressCity.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return AddressCity.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AddressCity.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  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 capitalizeEachWord(input) {
+  return input.split(" ").filter(Boolean).map((w) => capitalizeHyphenated(w)).join(" ");
+}
+function capitalizeHyphenated(word) {
+  return word.split("-").map(capitalizeWord).join("-");
+}
+function capitalizeWord(word) {
+  if (!word) return word;
+  const culture = PrimitivesDefaults.culture;
+  const lowered = word.toLocaleLowerCase(culture);
+  for (let i = 0; i < lowered.length; i++) {
+    if (/\p{L}/u.test(lowered[i])) {
+      return lowered.slice(0, i) + lowered[i].toLocaleUpperCase(culture) + lowered.slice(i + 1);
+    }
+  }
+  return lowered;
+}
+function isDisallowed(c) {
+  return /[\p{Cc}\p{Cf}\p{Cs}\p{Co}\p{Cn}]/u.test(c);
+}
+export {
+  AddressCity
+};
+//# sourceMappingURL=address-city.js.map

package/dist/esm/contact/address-city.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/address-city.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { collapseWhitespace } from \"../internal/input-sanitization.js\";\n\nconst MAX_INPUT_LENGTH = 100;\n\nconst NAME_PATTERN =\n  /^(?:[\\p{L}\\p{M}]{2,}|['\\p{L}\\p{M}]{2,}|[\\p{Lo}])(?:['\\p{Zs}-][\\p{L}\\p{M}]+)*$/u;\n\n/**\n * The postal city (`postort`) is the locality associated with a postal code.\n * Normalization applies Swedish-aware title casing.\n */\nexport class AddressCity {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"City\",\n    localizedName: \"Postort\",\n    emoji: \"\\u{1F3D9}\\uFE0F\",\n    sources: Object.freeze([\"https://www.postnord.se/\"]),\n  });\n\n  readonly value: string;\n\n  private constructor(value: string) {\n    this.value = value;\n  }\n\n  static tryParse(input: string | null | undefined): AddressCity | null {\n    if (input == null || input.trim() === \"\") return null;\n    const cleaned = collapseWhitespace(input);\n    if (cleaned.length === 0 || cleaned.length > MAX_INPUT_LENGTH) return null;\n    const capitalized = capitalizeEachWord(cleaned);\n    if ([...capitalized].some(isDisallowed)) return null;\n    if (!NAME_PATTERN.test(capitalized)) return null;\n    return new AddressCity(capitalized);\n  }\n\n  static parse(input: string): AddressCity {\n    const r = AddressCity.tryParse(input);\n    if (r === null) throw new Error(\"Invalid city name.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AddressCity.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = AddressCity.tryParse(input);\n    if (r) return r.value;\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 AddressCity.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AddressCity.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: AddressCity | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: AddressCity | 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\nfunction capitalizeEachWord(input: string): string {\n  return input\n    .split(\" \")\n    .filter(Boolean)\n    .map((w) => capitalizeHyphenated(w))\n    .join(\" \");\n}\n\nfunction capitalizeHyphenated(word: string): string {\n  return word.split(\"-\").map(capitalizeWord).join(\"-\");\n}\n\nfunction capitalizeWord(word: string): string {\n  if (!word) return word;\n  const culture = PrimitivesDefaults.culture;\n  const lowered = word.toLocaleLowerCase(culture);\n  for (let i = 0; i < lowered.length; i++) {\n    if (/\\p{L}/u.test(lowered[i]!)) {\n      return lowered.slice(0, i) + lowered[i]!.toLocaleUpperCase(culture) + lowered.slice(i + 1);\n    }\n  }\n  return lowered;\n}\n\nfunction isDisallowed(c: string): boolean {\n  return /[\\p{Cc}\\p{Cf}\\p{Cs}\\p{Co}\\p{Cn}]/u.test(c);\n}\n"],
+  "mappings": "AACA,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AAEnC,MAAM,mBAAmB;AAEzB,MAAM,eACJ;AAMK,MAAM,YAAY;AAAA,EACvB,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,0BAA0B,CAAC;AAAA,EACrD,CAAC;AAAA,EAEQ;AAAA,EAED,YAAY,OAAe;AACjC,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAO,SAAS,OAAsD;AACpE,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,UAAU,mBAAmB,KAAK;AACxC,QAAI,QAAQ,WAAW,KAAK,QAAQ,SAAS,iBAAkB,QAAO;AACtE,UAAM,cAAc,mBAAmB,OAAO;AAC9C,QAAI,CAAC,GAAG,WAAW,EAAE,KAAK,YAAY,EAAG,QAAO;AAChD,QAAI,CAAC,aAAa,KAAK,WAAW,EAAG,QAAO;AAC5C,WAAO,IAAI,YAAY,WAAW;AAAA,EACpC;AAAA,EAEA,OAAO,MAAM,OAA4B;AACvC,UAAM,IAAI,YAAY,SAAS,KAAK;AACpC,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,oBAAoB;AACpD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,YAAY,SAAS,KAAK,MAAM;AAAA,EACzC;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,YAAY,SAAS,KAAK;AACpC,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,YAAY,OAAO,OAAO,OAAO;AAAA,EAC1C;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,YAAY,UAAU,KAAK,MAAM;AAAA,EAC3D;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAgD;AACrD,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EACA,UAAU,OAA+C;AACvD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;AAEA,SAAS,mBAAmB,OAAuB;AACjD,SAAO,MACJ,MAAM,GAAG,EACT,OAAO,OAAO,EACd,IAAI,CAAC,MAAM,qBAAqB,CAAC,CAAC,EAClC,KAAK,GAAG;AACb;AAEA,SAAS,qBAAqB,MAAsB;AAClD,SAAO,KAAK,MAAM,GAAG,EAAE,IAAI,cAAc,EAAE,KAAK,GAAG;AACrD;AAEA,SAAS,eAAe,MAAsB;AAC5C,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,UAAU,mBAAmB;AACnC,QAAM,UAAU,KAAK,kBAAkB,OAAO;AAC9C,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,QAAI,SAAS,KAAK,QAAQ,CAAC,CAAE,GAAG;AAC9B,aAAO,QAAQ,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,EAAG,kBAAkB,OAAO,IAAI,QAAQ,MAAM,IAAI,CAAC;AAAA,IAC3F;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,aAAa,GAAoB;AACxC,SAAO,oCAAoC,KAAK,CAAC;AACnD;",
+  "names": []
+}

package/dist/esm/contact/address-street.js

@@ -0,0 +1,200 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { collapseWhitespace } from "../internal/input-sanitization.js";
+const MAX_INPUT_LENGTH = 200;
+const ADDRESS_PATTERN = /^[\p{L}0-9\s,.:'/-]+$/u;
+const CARE_OF = /^c[/.]o\.?\s+/i;
+const APARTMENT = /[,\s]+(?:lgh\.?|lägenhet|apt\.?)\s*(\d+\w*)\s*$/iu;
+const BOX = /^(?:p\.?o\.?\s*)?box\s+(\d{1,7})\s*$/i;
+const STREET_NUMBER = /^(.*?)\s+(\d+[A-ZÅÄÖ]*)$/u;
+class AddressStreet {
+  static typeInfo = Object.freeze({
+    englishName: "Street Address",
+    localizedName: "Gatuadress",
+    emoji: "\u{1F6E3}\uFE0F",
+    sources: Object.freeze(["https://www.lantmateriet.se/"])
+  });
+  street;
+  streetName;
+  streetNumber;
+  apartmentNumber;
+  careOf;
+  postBox;
+  constructor(street, streetName, streetNumber, apartmentNumber, careOf, postBox) {
+    this.street = street;
+    this.streetName = streetName;
+    this.streetNumber = streetNumber;
+    this.apartmentNumber = apartmentNumber;
+    this.careOf = careOf;
+    this.postBox = postBox;
+  }
+  get isPostBox() {
+    return this.postBox !== null;
+  }
+  static tryParse(input, options) {
+    if (input == null || input.trim() === "") return null;
+    let text = collapseWhitespace(input);
+    if (text.length === 0 || text.length > MAX_INPUT_LENGTH) return null;
+    let careOf = null;
+    const co = text.match(CARE_OF);
+    if (co) {
+      const after = text.slice(co[0].length);
+      const comma = after.indexOf(",");
+      if (comma >= 0) {
+        careOf = after.slice(0, comma).trim();
+        text = after.slice(comma + 1).trim();
+      } else {
+        careOf = after.trim();
+        text = "";
+      }
+      if (careOf.trim() === "") careOf = null;
+    }
+    if (text.trim() !== "") {
+      const boxText = collapseWhitespace(text.replace(/,/g, " "));
+      const boxMatch = boxText.match(BOX);
+      if (boxMatch) {
+        const postBox = boxMatch[1];
+        return new AddressStreet(`Box ${postBox}`, null, null, null, careOf, postBox);
+      }
+    }
+    if (text.trim() === "") {
+      if (careOf !== null) {
+        return new AddressStreet(`c/o ${careOf}`, null, null, null, careOf, null);
+      }
+      return null;
+    }
+    let apartment = null;
+    const apt = text.match(APARTMENT);
+    if (apt) {
+      apartment = apt[1];
+      text = text.slice(0, apt.index).trim();
+    }
+    const normalized = normalizeStreet(text, options?.city ?? null, options?.zipCode ?? null);
+    if (!validateStreet(normalized)) return null;
+    let streetName = null;
+    let streetNumber = null;
+    const num = normalized.match(STREET_NUMBER);
+    if (num) {
+      streetName = num[1];
+      streetNumber = num[2];
+    }
+    return new AddressStreet(normalized, streetName, streetNumber, apartment, careOf, null);
+  }
+  static parse(input) {
+    const r = AddressStreet.tryParse(input);
+    if (r === null) throw new Error("Invalid street address.");
+    return r;
+  }
+  static isValid(input) {
+    return AddressStreet.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = AddressStreet.tryParse(input);
+    if (r) return r.street;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return AddressStreet.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AddressStreet.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.street;
+  }
+  toString() {
+    return this.street;
+  }
+  equals(other) {
+    return other != null && this.street === other.street;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.street < other.street ? -1 : this.street > other.street ? 1 : 0;
+  }
+}
+function normalizeStreet(input, city, zip) {
+  let cleaned = collapseWhitespace(input);
+  if (cleaned === "") return "";
+  cleaned = collapseWhitespace(cleaned.replace(/,/g, " "));
+  cleaned = cleaned.replace(/(\p{L})(\d+\p{L}*)$/u, "$1 $2");
+  cleaned = collapseWhitespace(cleaned);
+  let stripped = removeTrailingCityAndZip(cleaned, city, zip);
+  if (shouldSentenceCase(stripped)) stripped = toSentenceCase(stripped);
+  stripped = uppercaseHouseNumberSuffixes(stripped);
+  return stripped;
+}
+function validateStreet(addr) {
+  if (!addr || addr.trim() === "") return false;
+  if (/[\p{Cc}]/u.test(addr)) return false;
+  if (addr !== addr.trim()) return false;
+  if (addr.includes("  ")) return false;
+  if (addr.length < 5 || addr.length > 50) return false;
+  if (/[\p{Cn}]/u.test(addr)) return false;
+  return ADDRESS_PATTERN.test(addr);
+}
+function shouldSentenceCase(input) {
+  if (!input || input.trim() === "") return false;
+  const letters = [...input].filter((c) => /\p{L}/u.test(c));
+  if (letters.length === 0) return false;
+  const allUpper = letters.every((c) => c === c.toLocaleUpperCase(PrimitivesDefaults.culture));
+  let firstLetterIndex = -1;
+  for (let i = 0; i < input.length; i++) {
+    if (/\p{L}/u.test(input[i])) {
+      firstLetterIndex = i;
+      break;
+    }
+  }
+  if (firstLetterIndex === -1) return allUpper;
+  const startsWithUpper = input[firstLetterIndex] === input[firstLetterIndex].toLocaleUpperCase(PrimitivesDefaults.culture);
+  return allUpper || !startsWithUpper;
+}
+function toSentenceCase(input) {
+  if (!input || input.trim() === "") return "";
+  const culture = PrimitivesDefaults.culture;
+  const lowered = input.toLocaleLowerCase(culture);
+  let out = lowered;
+  for (let i = 0; i < lowered.length; i++) {
+    if (/\p{L}/u.test(lowered[i])) {
+      out = lowered.slice(0, i) + lowered[i].toLocaleUpperCase(culture) + lowered.slice(i + 1);
+      break;
+    }
+  }
+  return uppercaseHouseNumberSuffixes(out);
+}
+function uppercaseHouseNumberSuffixes(input) {
+  return input.replace(
+    /(\d+)(\p{L}+)(?=[^\p{L}\d]|$)/gu,
+    (_, d, s) => d + s.toLocaleUpperCase(PrimitivesDefaults.culture)
+  );
+}
+function removeTrailingCityAndZip(street, city, zip) {
+  const cityNorm = city == null ? "" : collapseWhitespace(city);
+  const zipNorm = zip == null ? "" : collapseWhitespace(zip);
+  const cityU = cityNorm.toUpperCase();
+  const zipU = zipNorm.toUpperCase();
+  const zipNoSpaceU = zipNorm.replace(/ /g, "").toUpperCase();
+  const orig = collapseWhitespace(street.replace(/,/g, " "));
+  const upper = orig.toUpperCase();
+  const has = (s) => s.length > 0;
+  const removeTail = (s, tail) => tail <= 0 || tail > s.length ? s : collapseWhitespace(s.slice(0, s.length - tail));
+  if (has(cityU) && has(zipU) && upper.endsWith(` ${zipU} ${cityU}`))
+    return removeTail(orig, (zipU + " " + cityU).length);
+  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU} ${cityU}`))
+    return removeTail(orig, (zipNoSpaceU + " " + cityU).length);
+  if (has(cityU) && has(zipU) && upper.endsWith(` ${cityU} ${zipU}`))
+    return removeTail(orig, (cityU + " " + zipU).length);
+  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${cityU} ${zipNoSpaceU}`))
+    return removeTail(orig, (cityU + " " + zipNoSpaceU).length);
+  if (has(cityU) && upper.endsWith(` ${cityU}`)) return removeTail(orig, cityU.length);
+  if (has(zipU) && upper.endsWith(` ${zipU}`)) return removeTail(orig, zipU.length);
+  if (has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU}`))
+    return removeTail(orig, zipNoSpaceU.length);
+  return orig;
+}
+export {
+  AddressStreet
+};
+//# sourceMappingURL=address-street.js.map

package/dist/esm/contact/address-street.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/contact/address-street.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { PrimitivesDefaults } from \"../primitives-defaults.js\";\nimport { collapseWhitespace } from \"../internal/input-sanitization.js\";\n\nconst MAX_INPUT_LENGTH = 200;\n\nconst ADDRESS_PATTERN = /^[\\p{L}0-9\\s,.:'/-]+$/u;\nconst CARE_OF = /^c[/.]o\\.?\\s+/i;\nconst APARTMENT = /[,\\s]+(?:lgh\\.?|l\u00E4genhet|apt\\.?)\\s*(\\d+\\w*)\\s*$/iu;\nconst BOX = /^(?:p\\.?o\\.?\\s*)?box\\s+(\\d{1,7})\\s*$/i;\nconst STREET_NUMBER = /^(.*?)\\s+(\\d+[A-Z\u00C5\u00C4\u00D6]*)$/u;\n\n/**\n * A street address (`gatuadress`). Extracts care-of (c/o), apartment number\n * (lgh/apt), and post box (Box) when present.\n */\nexport class AddressStreet {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Street Address\",\n    localizedName: \"Gatuadress\",\n    emoji: \"\\u{1F6E3}\\uFE0F\",\n    sources: Object.freeze([\"https://www.lantmateriet.se/\"]),\n  });\n\n  readonly street: string;\n  readonly streetName: string | null;\n  readonly streetNumber: string | null;\n  readonly apartmentNumber: string | null;\n  readonly careOf: string | null;\n  readonly postBox: string | null;\n\n  private constructor(\n    street: string,\n    streetName: string | null,\n    streetNumber: string | null,\n    apartmentNumber: string | null,\n    careOf: string | null,\n    postBox: string | null,\n  ) {\n    this.street = street;\n    this.streetName = streetName;\n    this.streetNumber = streetNumber;\n    this.apartmentNumber = apartmentNumber;\n    this.careOf = careOf;\n    this.postBox = postBox;\n  }\n\n  get isPostBox(): boolean {\n    return this.postBox !== null;\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { city?: string | null; zipCode?: string | null },\n  ): AddressStreet | null {\n    if (input == null || input.trim() === \"\") return null;\n\n    let text = collapseWhitespace(input);\n    if (text.length === 0 || text.length > MAX_INPUT_LENGTH) return null;\n\n    let careOf: string | null = null;\n    const co = text.match(CARE_OF);\n    if (co) {\n      const after = text.slice(co[0].length);\n      const comma = after.indexOf(\",\");\n      if (comma >= 0) {\n        careOf = after.slice(0, comma).trim();\n        text = after.slice(comma + 1).trim();\n      } else {\n        careOf = after.trim();\n        text = \"\";\n      }\n      if (careOf.trim() === \"\") careOf = null;\n    }\n\n    if (text.trim() !== \"\") {\n      const boxText = collapseWhitespace(text.replace(/,/g, \" \"));\n      const boxMatch = boxText.match(BOX);\n      if (boxMatch) {\n        const postBox = boxMatch[1]!;\n        return new AddressStreet(`Box ${postBox}`, null, null, null, careOf, postBox);\n      }\n    }\n\n    if (text.trim() === \"\") {\n      if (careOf !== null) {\n        return new AddressStreet(`c/o ${careOf}`, null, null, null, careOf, null);\n      }\n      return null;\n    }\n\n    let apartment: string | null = null;\n    const apt = text.match(APARTMENT);\n    if (apt) {\n      apartment = apt[1]!;\n      text = text.slice(0, apt.index!).trim();\n    }\n\n    const normalized = normalizeStreet(text, options?.city ?? null, options?.zipCode ?? null);\n    if (!validateStreet(normalized)) return null;\n\n    let streetName: string | null = null;\n    let streetNumber: string | null = null;\n    const num = normalized.match(STREET_NUMBER);\n    if (num) {\n      streetName = num[1]!;\n      streetNumber = num[2]!;\n    }\n\n    return new AddressStreet(normalized, streetName, streetNumber, apartment, careOf, null);\n  }\n\n  static parse(input: string): AddressStreet {\n    const r = AddressStreet.tryParse(input);\n    if (r === null) throw new Error(\"Invalid street address.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AddressStreet.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = AddressStreet.tryParse(input);\n    if (r) return r.street;\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 AddressStreet.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AddressStreet.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.street;\n  }\n  toString(): string {\n    return this.street;\n  }\n\n  equals(other: AddressStreet | null | undefined): boolean {\n    return other != null && this.street === other.street;\n  }\n  compareTo(other: AddressStreet | null | undefined): number {\n    if (other == null) return 1;\n    return this.street < other.street ? -1 : this.street > other.street ? 1 : 0;\n  }\n}\n\nfunction normalizeStreet(input: string, city: string | null, zip: string | null): string {\n  let cleaned = collapseWhitespace(input);\n  if (cleaned === \"\") return \"\";\n  cleaned = collapseWhitespace(cleaned.replace(/,/g, \" \"));\n  cleaned = cleaned.replace(/(\\p{L})(\\d+\\p{L}*)$/u, \"$1 $2\");\n  cleaned = collapseWhitespace(cleaned);\n  let stripped = removeTrailingCityAndZip(cleaned, city, zip);\n  if (shouldSentenceCase(stripped)) stripped = toSentenceCase(stripped);\n  stripped = uppercaseHouseNumberSuffixes(stripped);\n  return stripped;\n}\n\nfunction validateStreet(addr: string): boolean {\n  if (!addr || addr.trim() === \"\") return false;\n  if (/[\\p{Cc}]/u.test(addr)) return false;\n  if (addr !== addr.trim()) return false;\n  if (addr.includes(\"  \")) return false;\n  if (addr.length < 5 || addr.length > 50) return false;\n  if (/[\\p{Cn}]/u.test(addr)) return false;\n  return ADDRESS_PATTERN.test(addr);\n}\n\nfunction shouldSentenceCase(input: string): boolean {\n  if (!input || input.trim() === \"\") return false;\n  const letters = [...input].filter((c) => /\\p{L}/u.test(c));\n  if (letters.length === 0) return false;\n  const allUpper = letters.every((c) => c === c.toLocaleUpperCase(PrimitivesDefaults.culture));\n  let firstLetterIndex = -1;\n  for (let i = 0; i < input.length; i++) {\n    if (/\\p{L}/u.test(input[i]!)) {\n      firstLetterIndex = i;\n      break;\n    }\n  }\n  if (firstLetterIndex === -1) return allUpper;\n  const startsWithUpper =\n    input[firstLetterIndex] ===\n    input[firstLetterIndex]!.toLocaleUpperCase(PrimitivesDefaults.culture);\n  return allUpper || !startsWithUpper;\n}\n\nfunction toSentenceCase(input: string): string {\n  if (!input || input.trim() === \"\") return \"\";\n  const culture = PrimitivesDefaults.culture;\n  const lowered = input.toLocaleLowerCase(culture);\n  let out = lowered;\n  for (let i = 0; i < lowered.length; i++) {\n    if (/\\p{L}/u.test(lowered[i]!)) {\n      out = lowered.slice(0, i) + lowered[i]!.toLocaleUpperCase(culture) + lowered.slice(i + 1);\n      break;\n    }\n  }\n  return uppercaseHouseNumberSuffixes(out);\n}\n\nfunction uppercaseHouseNumberSuffixes(input: string): string {\n  return input.replace(\n    /(\\d+)(\\p{L}+)(?=[^\\p{L}\\d]|$)/gu,\n    (_, d: string, s: string) => d + s.toLocaleUpperCase(PrimitivesDefaults.culture),\n  );\n}\n\nfunction removeTrailingCityAndZip(street: string, city: string | null, zip: string | null): string {\n  const cityNorm = city == null ? \"\" : collapseWhitespace(city);\n  const zipNorm = zip == null ? \"\" : collapseWhitespace(zip);\n  const cityU = cityNorm.toUpperCase();\n  const zipU = zipNorm.toUpperCase();\n  const zipNoSpaceU = zipNorm.replace(/ /g, \"\").toUpperCase();\n  const orig = collapseWhitespace(street.replace(/,/g, \" \"));\n  const upper = orig.toUpperCase();\n\n  const has = (s: string) => s.length > 0;\n  const removeTail = (s: string, tail: number) =>\n    tail <= 0 || tail > s.length ? s : collapseWhitespace(s.slice(0, s.length - tail));\n\n  if (has(cityU) && has(zipU) && upper.endsWith(` ${zipU} ${cityU}`))\n    return removeTail(orig, (zipU + \" \" + cityU).length);\n  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU} ${cityU}`))\n    return removeTail(orig, (zipNoSpaceU + \" \" + cityU).length);\n  if (has(cityU) && has(zipU) && upper.endsWith(` ${cityU} ${zipU}`))\n    return removeTail(orig, (cityU + \" \" + zipU).length);\n  if (has(cityU) && has(zipNoSpaceU) && upper.endsWith(` ${cityU} ${zipNoSpaceU}`))\n    return removeTail(orig, (cityU + \" \" + zipNoSpaceU).length);\n  if (has(cityU) && upper.endsWith(` ${cityU}`)) return removeTail(orig, cityU.length);\n  if (has(zipU) && upper.endsWith(` ${zipU}`)) return removeTail(orig, zipU.length);\n  if (has(zipNoSpaceU) && upper.endsWith(` ${zipNoSpaceU}`))\n    return removeTail(orig, zipNoSpaceU.length);\n  return orig;\n}\n"],
+  "mappings": "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",
+  "names": []
+}