@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/esm/organization/swedish-sni-code.js

@@ -0,0 +1,76 @@
+import { keepDigits } from "../internal/input-sanitization.js";
+const MAX_INPUT_LENGTH = 20;
+class SwedishSniCode {
+  static typeInfo = Object.freeze({
+    englishName: "SNI Code",
+    localizedName: "SNI-kod",
+    emoji: "\u{1F4CA}",
+    sources: Object.freeze([
+      "https://www.scb.se/en/documentation/classifications-and-standards/swedish-standard-industrial-classification-sni/",
+      "https://snisok.scb.se/en"
+    ])
+  });
+  code;
+  formatted;
+  get divisionCode() {
+    return this.code.slice(0, 2);
+  }
+  get groupCode() {
+    return this.code.slice(0, 3);
+  }
+  get subGroupCode() {
+    return this.code.slice(0, 4);
+  }
+  constructor(code, formatted) {
+    this.code = code;
+    this.formatted = formatted;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const digits = keepDigits(input);
+    if (digits.length > MAX_INPUT_LENGTH) return null;
+    if (digits.length !== 5) return null;
+    if (digits === "00000") return null;
+    if (digits.slice(0, 2) === "00") return null;
+    return new SwedishSniCode(digits, `${digits.slice(0, 2)}.${digits.slice(2)}`);
+  }
+  static parse(input) {
+    const r = SwedishSniCode.tryParse(input);
+    if (r === null) throw new Error("Invalid SNI code.");
+    return r;
+  }
+  static isValid(input) {
+    return SwedishSniCode.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishSniCode.tryParse(input);
+    if (r) return r.formatted;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return SwedishSniCode.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && SwedishSniCode.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.formatted;
+  }
+  toString() {
+    return this.formatted;
+  }
+  equals(other) {
+    return other != null && this.formatted === other.formatted;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.formatted < other.formatted ? -1 : this.formatted > other.formatted ? 1 : 0;
+  }
+}
+export {
+  SwedishSniCode
+};
+//# sourceMappingURL=swedish-sni-code.js.map

package/dist/esm/organization/swedish-sni-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/organization/swedish-sni-code.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { keepDigits } from \"../internal/input-sanitization.js\";\n\nconst MAX_INPUT_LENGTH = 20;\n\n/** Swedish SNI code (`SNI-kod`). */\nexport class SwedishSniCode {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"SNI Code\",\n    localizedName: \"SNI-kod\",\n    emoji: \"\\u{1F4CA}\",\n    sources: Object.freeze([\n      \"https://www.scb.se/en/documentation/classifications-and-standards/swedish-standard-industrial-classification-sni/\",\n      \"https://snisok.scb.se/en\",\n    ]),\n  });\n\n  readonly code: string;\n  readonly formatted: string;\n  get divisionCode(): string {\n    return this.code.slice(0, 2);\n  }\n  get groupCode(): string {\n    return this.code.slice(0, 3);\n  }\n  get subGroupCode(): string {\n    return this.code.slice(0, 4);\n  }\n\n  private constructor(code: string, formatted: string) {\n    this.code = code;\n    this.formatted = formatted;\n  }\n\n  static tryParse(input: string | null | undefined): SwedishSniCode | null {\n    if (input == null || input.trim() === \"\") return null;\n    const digits = keepDigits(input);\n    if (digits.length > MAX_INPUT_LENGTH) return null;\n    if (digits.length !== 5) return null;\n    if (digits === \"00000\") return null;\n    if (digits.slice(0, 2) === \"00\") return null;\n    return new SwedishSniCode(digits, `${digits.slice(0, 2)}.${digits.slice(2)}`);\n  }\n\n  static parse(input: string): SwedishSniCode {\n    const r = SwedishSniCode.tryParse(input);\n    if (r === null) throw new Error(\"Invalid SNI code.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishSniCode.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = SwedishSniCode.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    return SwedishSniCode.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && SwedishSniCode.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.formatted;\n  }\n  toString(): string {\n    return this.formatted;\n  }\n\n  equals(other: SwedishSniCode | null | undefined): boolean {\n    return other != null && this.formatted === other.formatted;\n  }\n  compareTo(other: SwedishSniCode | null | undefined): number {\n    if (other == null) return 1;\n    return this.formatted < other.formatted ? -1 : this.formatted > other.formatted ? 1 : 0;\n  }\n}\n"],
+  "mappings": "AACA,SAAS,kBAAkB;AAE3B,MAAM,mBAAmB;AAGlB,MAAM,eAAe;AAAA,EAC1B,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,EACT,IAAI,eAAuB;AACzB,WAAO,KAAK,KAAK,MAAM,GAAG,CAAC;AAAA,EAC7B;AAAA,EACA,IAAI,YAAoB;AACtB,WAAO,KAAK,KAAK,MAAM,GAAG,CAAC;AAAA,EAC7B;AAAA,EACA,IAAI,eAAuB;AACzB,WAAO,KAAK,KAAK,MAAM,GAAG,CAAC;AAAA,EAC7B;AAAA,EAEQ,YAAY,MAAc,WAAmB;AACnD,SAAK,OAAO;AACZ,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,OAAO,SAAS,OAAyD;AACvE,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,SAAS,WAAW,KAAK;AAC/B,QAAI,OAAO,SAAS,iBAAkB,QAAO;AAC7C,QAAI,OAAO,WAAW,EAAG,QAAO;AAChC,QAAI,WAAW,QAAS,QAAO;AAC/B,QAAI,OAAO,MAAM,GAAG,CAAC,MAAM,KAAM,QAAO;AACxC,WAAO,IAAI,eAAe,QAAQ,GAAG,OAAO,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,MAAM,CAAC,CAAC,EAAE;AAAA,EAC9E;AAAA,EAEA,OAAO,MAAM,OAA+B;AAC1C,UAAM,IAAI,eAAe,SAAS,KAAK;AACvC,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,mBAAmB;AACnD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,eAAe,SAAS,KAAK,MAAM;AAAA,EAC5C;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,eAAe,SAAS,KAAK;AACvC,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,eAAe,OAAO,OAAO,OAAO;AAAA,EAC7C;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,eAAe,UAAU,KAAK,MAAM;AAAA,EAC9D;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAmD;AACxD,WAAO,SAAS,QAAQ,KAAK,cAAc,MAAM;AAAA,EACnD;AAAA,EACA,UAAU,OAAkD;AAC1D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,YAAY,MAAM,YAAY,KAAK,KAAK,YAAY,MAAM,YAAY,IAAI;AAAA,EACxF;AACF;",
+  "names": []
+}

package/dist/esm/person/index.js

@@ -0,0 +1,42 @@
+import { PersonGivenName } from "./person-given-name.js";
+import { PersonFamilyName } from "./person-family-name.js";
+import { PersonFullName } from "./person-full-name.js";
+import { PersonAge } from "./person-age.js";
+import { maskGivenName, maskFamilyName, maskFullName, maskPersonAge } from "./person-masking.js";
+import {
+  SwedishPersonalIdentityNumber,
+  maskPersonalIdentityNumber
+} from "./swedish-personal-identity-number.js";
+import {
+  SwedishCoordinationNumber,
+  maskCoordinationNumber
+} from "./swedish-coordination-number.js";
+import {
+  parsePin,
+  pinTo10Digit,
+  pinTo12Digit,
+  pinDateOfBirth,
+  pinAgeInYears,
+  pinGender
+} from "./personnummer-parser.js";
+export {
+  PersonAge,
+  PersonFamilyName,
+  PersonFullName,
+  PersonGivenName,
+  SwedishCoordinationNumber,
+  SwedishPersonalIdentityNumber,
+  maskCoordinationNumber,
+  maskFamilyName,
+  maskFullName,
+  maskGivenName,
+  maskPersonAge,
+  maskPersonalIdentityNumber,
+  parsePin,
+  pinAgeInYears,
+  pinDateOfBirth,
+  pinGender,
+  pinTo10Digit,
+  pinTo12Digit
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/person/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/index.ts"],
+  "sourcesContent": ["export { PersonGivenName } from \"./person-given-name.js\";\nexport { PersonFamilyName } from \"./person-family-name.js\";\nexport { PersonFullName } from \"./person-full-name.js\";\nexport { PersonAge } from \"./person-age.js\";\nexport { maskGivenName, maskFamilyName, maskFullName, maskPersonAge } from \"./person-masking.js\";\nexport type { FullNameMaskingOptions, PersonNameMaskingOptions } from \"./person-masking.js\";\nexport {\n  SwedishPersonalIdentityNumber,\n  maskPersonalIdentityNumber,\n} from \"./swedish-personal-identity-number.js\";\nexport {\n  SwedishCoordinationNumber,\n  maskCoordinationNumber,\n} from \"./swedish-coordination-number.js\";\nexport {\n  parsePin,\n  pinTo10Digit,\n  pinTo12Digit,\n  pinDateOfBirth,\n  pinAgeInYears,\n  pinGender,\n} from \"./personnummer-parser.js\";\nexport type { ParsedPin, PinKind } from \"./personnummer-parser.js\";\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB;AAC1B,SAAS,eAAe,gBAAgB,cAAc,qBAAqB;AAE3E;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "names": []
+}

package/dist/esm/person/person-age.js

@@ -0,0 +1,167 @@
+import { systemClock } from "../internal/clock.js";
+const MAX_YEARS = 200;
+const DAYS_PER_YEAR = 365;
+const DAYS_PER_MONTH = 30;
+const MAX_TOTAL_DAYS = MAX_YEARS * DAYS_PER_YEAR;
+const YEARS_PATTERN = /^\s*(\d+(?:[.,]\d+)?)\s*(?:år|years?)?\s*$/iu;
+const MONTHS_PATTERN = /^\s*(\d+)\s+(?:månader?|månad|months?)\s*$/iu;
+const DAYS_PATTERN = /^\s*(\d+)\s+(?:dagar?|dag|days?)\s*$/iu;
+class PersonAge {
+  static typeInfo = Object.freeze({
+    englishName: "Age",
+    localizedName: "\xC5lder",
+    emoji: "\u{1F382}",
+    sources: Object.freeze([
+      "https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/foraldrabalk-1949381_sfs-1949-381/",
+      "https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/brottsbalk-1962700_sfs-1962-700/"
+    ])
+  });
+  years;
+  totalMonths;
+  totalDays;
+  get isOfSwedishLegalAge() {
+    return this.years >= 18;
+  }
+  get isSwedishCriminallyResponsible() {
+    return this.years >= 15;
+  }
+  get isOfSwedishRetirementAge() {
+    return this.years >= 65;
+  }
+  constructor(years, totalMonths, totalDays) {
+    this.years = years;
+    this.totalMonths = totalMonths;
+    this.totalDays = totalDays;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim() === "") return null;
+    const sanitized = input.trim();
+    if (sanitized.length > 50) return null;
+    let m = DAYS_PATTERN.exec(sanitized);
+    if (m) {
+      const d = parseInt(m[1], 10);
+      return tryFromDays(d);
+    }
+    m = MONTHS_PATTERN.exec(sanitized);
+    if (m) {
+      const months = parseInt(m[1], 10);
+      return tryFromMonths(months);
+    }
+    m = YEARS_PATTERN.exec(sanitized);
+    if (m) {
+      const value = parseFloat(m[1].replace(",", "."));
+      if (!Number.isFinite(value) || value < 0) return null;
+      const intYears = Math.trunc(value);
+      if (value === intYears) return tryFromYears(intYears);
+      return tryFromDays(Math.trunc(value * DAYS_PER_YEAR));
+    }
+    return null;
+  }
+  static parse(input) {
+    const r = PersonAge.tryParse(input);
+    if (r === null) throw new Error("Invalid person age.");
+    return r;
+  }
+  static isValid(input) {
+    return PersonAge.tryParse(input) !== null;
+  }
+  static fromYears(years) {
+    if (years < 0 || years > MAX_YEARS || !Number.isInteger(years)) {
+      throw new RangeError(`Years must be between 0 and ${MAX_YEARS}.`);
+    }
+    return new PersonAge(years, years * 12, years * DAYS_PER_YEAR);
+  }
+  static fromMonths(months) {
+    if (months < 0 || months > MAX_YEARS * 12 || !Number.isInteger(months)) {
+      throw new RangeError(`Months must be between 0 and ${MAX_YEARS * 12}.`);
+    }
+    return new PersonAge(Math.trunc(months / 12), months, months * DAYS_PER_MONTH);
+  }
+  static fromDays(days) {
+    if (days < 0 || days > MAX_TOTAL_DAYS || !Number.isInteger(days)) {
+      throw new RangeError(`Days must be between 0 and ${MAX_TOTAL_DAYS}.`);
+    }
+    return new PersonAge(Math.trunc(days / DAYS_PER_YEAR), Math.trunc(days / DAYS_PER_MONTH), days);
+  }
+  /**
+   * Build a {@link PersonAge} from a birth date and an optional reference date.
+   * `birthDate` and `referenceDate` are interpreted as UTC midnights of the date
+   * portion of the supplied {@link Date} values.
+   */
+  static fromBirthDate(birthDate, options) {
+    const ref = options?.referenceDate ?? options?.clock?.now() ?? systemClock.now();
+    const birth = new Date(
+      Date.UTC(birthDate.getUTCFullYear(), birthDate.getUTCMonth(), birthDate.getUTCDate())
+    );
+    const today = new Date(Date.UTC(ref.getUTCFullYear(), ref.getUTCMonth(), ref.getUTCDate()));
+    if (birth > today)
+      throw new RangeError("Birth date cannot be in the future relative to the reference date.");
+    const totalDays = Math.floor((today.getTime() - birth.getTime()) / 864e5);
+    let years = today.getUTCFullYear() - birth.getUTCFullYear();
+    if (today.getUTCMonth() < birth.getUTCMonth() || today.getUTCMonth() === birth.getUTCMonth() && today.getUTCDate() < birth.getUTCDate()) {
+      years--;
+    }
+    let monthDate = new Date(
+      Date.UTC(birth.getUTCFullYear() + years, birth.getUTCMonth(), birth.getUTCDate())
+    );
+    let months = 0;
+    while (true) {
+      const next = new Date(monthDate);
+      next.setUTCMonth(next.getUTCMonth() + 1);
+      if (next > today) break;
+      monthDate = next;
+      months++;
+    }
+    return new PersonAge(years, years * 12 + months, totalDays);
+  }
+  static format(input, options) {
+    const r = PersonAge.tryParse(input);
+    if (r) return r.toString();
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    const r = PersonAge.tryParse(input);
+    if (r) return r.toNormalizedString();
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {
+      const t = input.trim();
+      return t.length > 0 ? t : null;
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && PersonAge.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return String(this.years);
+  }
+  toString() {
+    return this.years >= 1 ? `${this.years} \xE5r` : `${this.totalMonths} m\xE5nader`;
+  }
+  equals(other) {
+    return other != null && this.totalDays === other.totalDays;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.totalDays - other.totalDays;
+  }
+}
+function tryFromYears(years) {
+  if (years < 0 || years > MAX_YEARS) return null;
+  return PersonAge.fromYears(years);
+}
+function tryFromMonths(months) {
+  if (months < 0 || months > MAX_YEARS * 12) return null;
+  if (months * DAYS_PER_MONTH > MAX_TOTAL_DAYS) return null;
+  return PersonAge.fromMonths(months);
+}
+function tryFromDays(days) {
+  if (days < 0 || days > MAX_TOTAL_DAYS) return null;
+  return PersonAge.fromDays(days);
+}
+export {
+  PersonAge
+};
+//# sourceMappingURL=person-age.js.map

package/dist/esm/person/person-age.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/person-age.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { Clock, systemClock } from \"../internal/clock.js\";\n\nconst MAX_YEARS = 200;\nconst DAYS_PER_YEAR = 365;\nconst DAYS_PER_MONTH = 30;\nconst MAX_TOTAL_DAYS = MAX_YEARS * DAYS_PER_YEAR;\n\nconst YEARS_PATTERN = /^\\s*(\\d+(?:[.,]\\d+)?)\\s*(?:\u00E5r|years?)?\\s*$/iu;\nconst MONTHS_PATTERN = /^\\s*(\\d+)\\s+(?:m\u00E5nader?|m\u00E5nad|months?)\\s*$/iu;\nconst DAYS_PATTERN = /^\\s*(\\d+)\\s+(?:dagar?|dag|days?)\\s*$/iu;\n\n/** A person's age (`\u00E5lder`). */\nexport class PersonAge {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Age\",\n    localizedName: \"\u00C5lder\",\n    emoji: \"\\u{1F382}\",\n    sources: Object.freeze([\n      \"https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/foraldrabalk-1949381_sfs-1949-381/\",\n      \"https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/brottsbalk-1962700_sfs-1962-700/\",\n    ]),\n  });\n\n  readonly years: number;\n  readonly totalMonths: number;\n  readonly totalDays: number;\n\n  get isOfSwedishLegalAge(): boolean {\n    return this.years >= 18;\n  }\n  get isSwedishCriminallyResponsible(): boolean {\n    return this.years >= 15;\n  }\n  get isOfSwedishRetirementAge(): boolean {\n    return this.years >= 65;\n  }\n\n  private constructor(years: number, totalMonths: number, totalDays: number) {\n    this.years = years;\n    this.totalMonths = totalMonths;\n    this.totalDays = totalDays;\n  }\n\n  static tryParse(input: string | null | undefined): PersonAge | null {\n    if (input == null || input.trim() === \"\") return null;\n    const sanitized = input.trim();\n    if (sanitized.length > 50) return null;\n\n    let m = DAYS_PATTERN.exec(sanitized);\n    if (m) {\n      const d = parseInt(m[1]!, 10);\n      return tryFromDays(d);\n    }\n    m = MONTHS_PATTERN.exec(sanitized);\n    if (m) {\n      const months = parseInt(m[1]!, 10);\n      return tryFromMonths(months);\n    }\n    m = YEARS_PATTERN.exec(sanitized);\n    if (m) {\n      const value = parseFloat(m[1]!.replace(\",\", \".\"));\n      if (!Number.isFinite(value) || value < 0) return null;\n      const intYears = Math.trunc(value);\n      if (value === intYears) return tryFromYears(intYears);\n      return tryFromDays(Math.trunc(value * DAYS_PER_YEAR));\n    }\n    return null;\n  }\n\n  static parse(input: string): PersonAge {\n    const r = PersonAge.tryParse(input);\n    if (r === null) throw new Error(\"Invalid person age.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return PersonAge.tryParse(input) !== null;\n  }\n\n  static fromYears(years: number): PersonAge {\n    if (years < 0 || years > MAX_YEARS || !Number.isInteger(years)) {\n      throw new RangeError(`Years must be between 0 and ${MAX_YEARS}.`);\n    }\n    return new PersonAge(years, years * 12, years * DAYS_PER_YEAR);\n  }\n\n  static fromMonths(months: number): PersonAge {\n    if (months < 0 || months > MAX_YEARS * 12 || !Number.isInteger(months)) {\n      throw new RangeError(`Months must be between 0 and ${MAX_YEARS * 12}.`);\n    }\n    return new PersonAge(Math.trunc(months / 12), months, months * DAYS_PER_MONTH);\n  }\n\n  static fromDays(days: number): PersonAge {\n    if (days < 0 || days > MAX_TOTAL_DAYS || !Number.isInteger(days)) {\n      throw new RangeError(`Days must be between 0 and ${MAX_TOTAL_DAYS}.`);\n    }\n    return new PersonAge(Math.trunc(days / DAYS_PER_YEAR), Math.trunc(days / DAYS_PER_MONTH), days);\n  }\n\n  /**\n   * Build a {@link PersonAge} from a birth date and an optional reference date.\n   * `birthDate` and `referenceDate` are interpreted as UTC midnights of the date\n   * portion of the supplied {@link Date} values.\n   */\n  static fromBirthDate(\n    birthDate: Date,\n    options?: { referenceDate?: Date; clock?: Clock },\n  ): PersonAge {\n    const ref = options?.referenceDate ?? options?.clock?.now() ?? systemClock.now();\n    const birth = new Date(\n      Date.UTC(birthDate.getUTCFullYear(), birthDate.getUTCMonth(), birthDate.getUTCDate()),\n    );\n    const today = new Date(Date.UTC(ref.getUTCFullYear(), ref.getUTCMonth(), ref.getUTCDate()));\n    if (birth > today)\n      throw new RangeError(\"Birth date cannot be in the future relative to the reference date.\");\n\n    const totalDays = Math.floor((today.getTime() - birth.getTime()) / 86400000);\n    let years = today.getUTCFullYear() - birth.getUTCFullYear();\n    if (\n      today.getUTCMonth() < birth.getUTCMonth() ||\n      (today.getUTCMonth() === birth.getUTCMonth() && today.getUTCDate() < birth.getUTCDate())\n    ) {\n      years--;\n    }\n    let monthDate = new Date(\n      Date.UTC(birth.getUTCFullYear() + years, birth.getUTCMonth(), birth.getUTCDate()),\n    );\n    let months = 0;\n    while (true) {\n      const next = new Date(monthDate);\n      next.setUTCMonth(next.getUTCMonth() + 1);\n      if (next > today) break;\n      monthDate = next;\n      months++;\n    }\n    return new PersonAge(years, years * 12 + months, totalDays);\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = PersonAge.tryParse(input);\n    if (r) return r.toString();\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 = PersonAge.tryParse(input);\n    if (r) return r.toNormalizedString();\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 && PersonAge.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return String(this.years);\n  }\n\n  toString(): string {\n    return this.years >= 1 ? `${this.years} \u00E5r` : `${this.totalMonths} m\u00E5nader`;\n  }\n\n  equals(other: PersonAge | null | undefined): boolean {\n    return other != null && this.totalDays === other.totalDays;\n  }\n  compareTo(other: PersonAge | null | undefined): number {\n    if (other == null) return 1;\n    return this.totalDays - other.totalDays;\n  }\n}\n\nfunction tryFromYears(years: number): PersonAge | null {\n  if (years < 0 || years > MAX_YEARS) return null;\n  return PersonAge.fromYears(years);\n}\n\nfunction tryFromMonths(months: number): PersonAge | null {\n  if (months < 0 || months > MAX_YEARS * 12) return null;\n  if (months * DAYS_PER_MONTH > MAX_TOTAL_DAYS) return null;\n  return PersonAge.fromMonths(months);\n}\n\nfunction tryFromDays(days: number): PersonAge | null {\n  if (days < 0 || days > MAX_TOTAL_DAYS) return null;\n  return PersonAge.fromDays(days);\n}\n"],
+  "mappings": "AACA,SAAgB,mBAAmB;AAEnC,MAAM,YAAY;AAClB,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AACvB,MAAM,iBAAiB,YAAY;AAEnC,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AACvB,MAAM,eAAe;AAGd,MAAM,UAAU;AAAA,EACrB,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,sBAA+B;AACjC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EACA,IAAI,iCAA0C;AAC5C,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EACA,IAAI,2BAAoC;AACtC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEQ,YAAY,OAAe,aAAqB,WAAmB;AACzE,SAAK,QAAQ;AACb,SAAK,cAAc;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,OAAO,SAAS,OAAoD;AAClE,QAAI,SAAS,QAAQ,MAAM,KAAK,MAAM,GAAI,QAAO;AACjD,UAAM,YAAY,MAAM,KAAK;AAC7B,QAAI,UAAU,SAAS,GAAI,QAAO;AAElC,QAAI,IAAI,aAAa,KAAK,SAAS;AACnC,QAAI,GAAG;AACL,YAAM,IAAI,SAAS,EAAE,CAAC,GAAI,EAAE;AAC5B,aAAO,YAAY,CAAC;AAAA,IACtB;AACA,QAAI,eAAe,KAAK,SAAS;AACjC,QAAI,GAAG;AACL,YAAM,SAAS,SAAS,EAAE,CAAC,GAAI,EAAE;AACjC,aAAO,cAAc,MAAM;AAAA,IAC7B;AACA,QAAI,cAAc,KAAK,SAAS;AAChC,QAAI,GAAG;AACL,YAAM,QAAQ,WAAW,EAAE,CAAC,EAAG,QAAQ,KAAK,GAAG,CAAC;AAChD,UAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,EAAG,QAAO;AACjD,YAAM,WAAW,KAAK,MAAM,KAAK;AACjC,UAAI,UAAU,SAAU,QAAO,aAAa,QAAQ;AACpD,aAAO,YAAY,KAAK,MAAM,QAAQ,aAAa,CAAC;AAAA,IACtD;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAM,OAA0B;AACrC,UAAM,IAAI,UAAU,SAAS,KAAK;AAClC,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,qBAAqB;AACrD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,UAAU,SAAS,KAAK,MAAM;AAAA,EACvC;AAAA,EAEA,OAAO,UAAU,OAA0B;AACzC,QAAI,QAAQ,KAAK,QAAQ,aAAa,CAAC,OAAO,UAAU,KAAK,GAAG;AAC9D,YAAM,IAAI,WAAW,+BAA+B,SAAS,GAAG;AAAA,IAClE;AACA,WAAO,IAAI,UAAU,OAAO,QAAQ,IAAI,QAAQ,aAAa;AAAA,EAC/D;AAAA,EAEA,OAAO,WAAW,QAA2B;AAC3C,QAAI,SAAS,KAAK,SAAS,YAAY,MAAM,CAAC,OAAO,UAAU,MAAM,GAAG;AACtE,YAAM,IAAI,WAAW,gCAAgC,YAAY,EAAE,GAAG;AAAA,IACxE;AACA,WAAO,IAAI,UAAU,KAAK,MAAM,SAAS,EAAE,GAAG,QAAQ,SAAS,cAAc;AAAA,EAC/E;AAAA,EAEA,OAAO,SAAS,MAAyB;AACvC,QAAI,OAAO,KAAK,OAAO,kBAAkB,CAAC,OAAO,UAAU,IAAI,GAAG;AAChE,YAAM,IAAI,WAAW,8BAA8B,cAAc,GAAG;AAAA,IACtE;AACA,WAAO,IAAI,UAAU,KAAK,MAAM,OAAO,aAAa,GAAG,KAAK,MAAM,OAAO,cAAc,GAAG,IAAI;AAAA,EAChG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,cACL,WACA,SACW;AACX,UAAM,MAAM,SAAS,iBAAiB,SAAS,OAAO,IAAI,KAAK,YAAY,IAAI;AAC/E,UAAM,QAAQ,IAAI;AAAA,MAChB,KAAK,IAAI,UAAU,eAAe,GAAG,UAAU,YAAY,GAAG,UAAU,WAAW,CAAC;AAAA,IACtF;AACA,UAAM,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,eAAe,GAAG,IAAI,YAAY,GAAG,IAAI,WAAW,CAAC,CAAC;AAC1F,QAAI,QAAQ;AACV,YAAM,IAAI,WAAW,oEAAoE;AAE3F,UAAM,YAAY,KAAK,OAAO,MAAM,QAAQ,IAAI,MAAM,QAAQ,KAAK,KAAQ;AAC3E,QAAI,QAAQ,MAAM,eAAe,IAAI,MAAM,eAAe;AAC1D,QACE,MAAM,YAAY,IAAI,MAAM,YAAY,KACvC,MAAM,YAAY,MAAM,MAAM,YAAY,KAAK,MAAM,WAAW,IAAI,MAAM,WAAW,GACtF;AACA;AAAA,IACF;AACA,QAAI,YAAY,IAAI;AAAA,MAClB,KAAK,IAAI,MAAM,eAAe,IAAI,OAAO,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC;AAAA,IAClF;AACA,QAAI,SAAS;AACb,WAAO,MAAM;AACX,YAAM,OAAO,IAAI,KAAK,SAAS;AAC/B,WAAK,YAAY,KAAK,YAAY,IAAI,CAAC;AACvC,UAAI,OAAO,MAAO;AAClB,kBAAY;AACZ;AAAA,IACF;AACA,WAAO,IAAI,UAAU,OAAO,QAAQ,KAAK,QAAQ,SAAS;AAAA,EAC5D;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,UAAU,SAAS,KAAK;AAClC,QAAI,EAAG,QAAO,EAAE,SAAS;AACzB,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,UAAU,SAAS,KAAK;AAClC,QAAI,EAAG,QAAO,EAAE,mBAAmB;AACnC,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,UAAU,UAAU,KAAK,MAAM;AAAA,EACzD;AAAA,EAEA,qBAA6B;AAC3B,WAAO,OAAO,KAAK,KAAK;AAAA,EAC1B;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK,SAAS,IAAI,GAAG,KAAK,KAAK,WAAQ,GAAG,KAAK,WAAW;AAAA,EACnE;AAAA,EAEA,OAAO,OAA8C;AACnD,WAAO,SAAS,QAAQ,KAAK,cAAc,MAAM;AAAA,EACnD;AAAA,EACA,UAAU,OAA6C;AACrD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,YAAY,MAAM;AAAA,EAChC;AACF;AAEA,SAAS,aAAa,OAAiC;AACrD,MAAI,QAAQ,KAAK,QAAQ,UAAW,QAAO;AAC3C,SAAO,UAAU,UAAU,KAAK;AAClC;AAEA,SAAS,cAAc,QAAkC;AACvD,MAAI,SAAS,KAAK,SAAS,YAAY,GAAI,QAAO;AAClD,MAAI,SAAS,iBAAiB,eAAgB,QAAO;AACrD,SAAO,UAAU,WAAW,MAAM;AACpC;AAEA,SAAS,YAAY,MAAgC;AACnD,MAAI,OAAO,KAAK,OAAO,eAAgB,QAAO;AAC9C,SAAO,UAAU,SAAS,IAAI;AAChC;",
+  "names": []
+}

package/dist/esm/person/person-family-name.js

@@ -0,0 +1,67 @@
+import {
+  collapseWhitespace,
+  normalizeCasing,
+  validateNamePart
+} from "./person-name-normalization.js";
+const MAX_INPUT_LENGTH = 200;
+class PersonFamilyName {
+  static typeInfo = Object.freeze({
+    englishName: "Family Name",
+    localizedName: "Efternamn",
+    emoji: "\u{1F4DB}",
+    sources: Object.freeze([
+      "https://skatteverket.se/privat/folkbokforing/namn.4.18e1b10334ebe8bc80004083.html",
+      "https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013/"
+    ])
+  });
+  value;
+  constructor(value) {
+    this.value = value;
+  }
+  static tryParse(input) {
+    const collapsed = collapseWhitespace(input);
+    if (collapsed.length === 0 || collapsed.length > MAX_INPUT_LENGTH) return null;
+    const normalized = normalizeCasing(collapsed);
+    if (!validateNamePart(normalized)) return null;
+    return new PersonFamilyName(normalized);
+  }
+  static parse(input) {
+    const r = PersonFamilyName.tryParse(input);
+    if (r === null) throw new Error("Invalid family name.");
+    return r;
+  }
+  static isValid(input) {
+    return PersonFamilyName.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = PersonFamilyName.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return PersonFamilyName.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && PersonFamilyName.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;
+  }
+}
+export {
+  PersonFamilyName
+};
+//# sourceMappingURL=person-family-name.js.map

package/dist/esm/person/person-family-name.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/person-family-name.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport {\n  collapseWhitespace,\n  normalizeCasing,\n  validateNamePart,\n} from \"./person-name-normalization.js\";\n\nconst MAX_INPUT_LENGTH = 200;\n\n/** A person's family name (`efternamn`). */\nexport class PersonFamilyName {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Family Name\",\n    localizedName: \"Efternamn\",\n    emoji: \"\\u{1F4DB}\",\n    sources: Object.freeze([\n      \"https://skatteverket.se/privat/folkbokforing/namn.4.18e1b10334ebe8bc80004083.html\",\n      \"https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013/\",\n    ]),\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): PersonFamilyName | null {\n    const collapsed = collapseWhitespace(input);\n    if (collapsed.length === 0 || collapsed.length > MAX_INPUT_LENGTH) return null;\n    const normalized = normalizeCasing(collapsed);\n    if (!validateNamePart(normalized)) return null;\n    return new PersonFamilyName(normalized);\n  }\n\n  static parse(input: string): PersonFamilyName {\n    const r = PersonFamilyName.tryParse(input);\n    if (r === null) throw new Error(\"Invalid family name.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return PersonFamilyName.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = PersonFamilyName.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 PersonFamilyName.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && PersonFamilyName.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: PersonFamilyName | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: PersonFamilyName | 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"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,mBAAmB;AAGlB,MAAM,iBAAiB;AAAA,EAC5B,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,EAED,YAAY,OAAe;AACjC,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAO,SAAS,OAA2D;AACzE,UAAM,YAAY,mBAAmB,KAAK;AAC1C,QAAI,UAAU,WAAW,KAAK,UAAU,SAAS,iBAAkB,QAAO;AAC1E,UAAM,aAAa,gBAAgB,SAAS;AAC5C,QAAI,CAAC,iBAAiB,UAAU,EAAG,QAAO;AAC1C,WAAO,IAAI,iBAAiB,UAAU;AAAA,EACxC;AAAA,EAEA,OAAO,MAAM,OAAiC;AAC5C,UAAM,IAAI,iBAAiB,SAAS,KAAK;AACzC,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,sBAAsB;AACtD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,iBAAiB,SAAS,KAAK,MAAM;AAAA,EAC9C;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,iBAAiB,SAAS,KAAK;AACzC,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,iBAAiB,OAAO,OAAO,OAAO;AAAA,EAC/C;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,iBAAiB,UAAU,KAAK,MAAM;AAAA,EAChE;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAqD;AAC1D,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EACA,UAAU,OAAoD;AAC5D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;",
+  "names": []
+}

package/dist/esm/person/person-full-name.js

@@ -0,0 +1,86 @@
+import { collapseWhitespace } from "./person-name-normalization.js";
+import { PersonGivenName } from "./person-given-name.js";
+import { PersonFamilyName } from "./person-family-name.js";
+const MAX_INPUT_LENGTH = 500;
+class PersonFullName {
+  static typeInfo = Object.freeze({
+    englishName: "Full Name",
+    localizedName: "Fullst\xE4ndigt namn",
+    emoji: "\u{1F4C7}",
+    sources: Object.freeze([
+      "https://skatteverket.se/privat/folkbokforing/namn.4.18e1b10334ebe8bc80004083.html",
+      "https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013/"
+    ])
+  });
+  givenName;
+  familyName;
+  value;
+  get preferredName() {
+    return this.givenName.preferredName;
+  }
+  constructor(given, family, value) {
+    this.givenName = given;
+    this.familyName = family;
+    this.value = value;
+  }
+  static create(givenName, familyName) {
+    return new PersonFullName(givenName, familyName, `${givenName.value} ${familyName.value}`);
+  }
+  static tryParse(input, options) {
+    const collapsed = collapseWhitespace(input);
+    if (collapsed.length === 0 || collapsed.length > MAX_INPUT_LENGTH) return null;
+    const tokens = collapsed.split(" ").filter((t) => t !== "");
+    if (tokens.length < 2) return null;
+    const givenPart = tokens.slice(0, tokens.length - 1).join(" ");
+    const given = PersonGivenName.tryParse(givenPart, options);
+    if (given === null) return null;
+    const family = PersonFamilyName.tryParse(tokens[tokens.length - 1]);
+    if (family === null) return null;
+    return new PersonFullName(given, family, `${given.value} ${family.value}`);
+  }
+  static parse(input, options) {
+    const r = PersonFullName.tryParse(input, options);
+    if (r === null) {
+      throw new Error("Invalid full name. Must contain at least given name(s) and a family name.");
+    }
+    return r;
+  }
+  static isValid(input) {
+    return PersonFullName.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = PersonFullName.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return PersonFullName.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && PersonFullName.normalize(input) === input;
+  }
+  withPreferredName(preferredName) {
+    const given = this.givenName.withPreferredName(preferredName);
+    return new PersonFullName(given, this.familyName, this.value);
+  }
+  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;
+  }
+}
+export {
+  PersonFullName
+};
+//# sourceMappingURL=person-full-name.js.map

package/dist/esm/person/person-full-name.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/person-full-name.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { collapseWhitespace } from \"./person-name-normalization.js\";\nimport { PersonGivenName } from \"./person-given-name.js\";\nimport { PersonFamilyName } from \"./person-family-name.js\";\n\nconst MAX_INPUT_LENGTH = 500;\n\n/** A person's full name (`fullst\u00E4ndigt namn`). */\nexport class PersonFullName {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Full Name\",\n    localizedName: \"Fullst\u00E4ndigt namn\",\n    emoji: \"\\u{1F4C7}\",\n    sources: Object.freeze([\n      \"https://skatteverket.se/privat/folkbokforing/namn.4.18e1b10334ebe8bc80004083.html\",\n      \"https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013/\",\n    ]),\n  });\n\n  readonly givenName: PersonGivenName;\n  readonly familyName: PersonFamilyName;\n  readonly value: string;\n\n  get preferredName(): string | null {\n    return this.givenName.preferredName;\n  }\n\n  private constructor(given: PersonGivenName, family: PersonFamilyName, value: string) {\n    this.givenName = given;\n    this.familyName = family;\n    this.value = value;\n  }\n\n  static create(givenName: PersonGivenName, familyName: PersonFamilyName): PersonFullName {\n    return new PersonFullName(givenName, familyName, `${givenName.value} ${familyName.value}`);\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { preferredName?: string | null },\n  ): PersonFullName | null {\n    const collapsed = collapseWhitespace(input);\n    if (collapsed.length === 0 || collapsed.length > MAX_INPUT_LENGTH) return null;\n    const tokens = collapsed.split(\" \").filter((t) => t !== \"\");\n    if (tokens.length < 2) return null;\n    const givenPart = tokens.slice(0, tokens.length - 1).join(\" \");\n    const given = PersonGivenName.tryParse(givenPart, options);\n    if (given === null) return null;\n    const family = PersonFamilyName.tryParse(tokens[tokens.length - 1]!);\n    if (family === null) return null;\n    return new PersonFullName(given, family, `${given.value} ${family.value}`);\n  }\n\n  static parse(input: string, options?: { preferredName?: string | null }): PersonFullName {\n    const r = PersonFullName.tryParse(input, options);\n    if (r === null) {\n      throw new Error(\"Invalid full name. Must contain at least given name(s) and a family name.\");\n    }\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return PersonFullName.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = PersonFullName.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 PersonFullName.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && PersonFullName.normalize(input) === input;\n  }\n\n  withPreferredName(preferredName: string): PersonFullName {\n    const given = this.givenName.withPreferredName(preferredName);\n    return new PersonFullName(given, this.familyName, this.value);\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: PersonFullName | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: PersonFullName | 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"],
+  "mappings": "AACA,SAAS,0BAA0B;AACnC,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAEjC,MAAM,mBAAmB;AAGlB,MAAM,eAAe;AAAA,EAC1B,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,gBAA+B;AACjC,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEQ,YAAY,OAAwB,QAA0B,OAAe;AACnF,SAAK,YAAY;AACjB,SAAK,aAAa;AAClB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAO,OAAO,WAA4B,YAA8C;AACtF,WAAO,IAAI,eAAe,WAAW,YAAY,GAAG,UAAU,KAAK,IAAI,WAAW,KAAK,EAAE;AAAA,EAC3F;AAAA,EAEA,OAAO,SACL,OACA,SACuB;AACvB,UAAM,YAAY,mBAAmB,KAAK;AAC1C,QAAI,UAAU,WAAW,KAAK,UAAU,SAAS,iBAAkB,QAAO;AAC1E,UAAM,SAAS,UAAU,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AAC1D,QAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,UAAM,YAAY,OAAO,MAAM,GAAG,OAAO,SAAS,CAAC,EAAE,KAAK,GAAG;AAC7D,UAAM,QAAQ,gBAAgB,SAAS,WAAW,OAAO;AACzD,QAAI,UAAU,KAAM,QAAO;AAC3B,UAAM,SAAS,iBAAiB,SAAS,OAAO,OAAO,SAAS,CAAC,CAAE;AACnE,QAAI,WAAW,KAAM,QAAO;AAC5B,WAAO,IAAI,eAAe,OAAO,QAAQ,GAAG,MAAM,KAAK,IAAI,OAAO,KAAK,EAAE;AAAA,EAC3E;AAAA,EAEA,OAAO,MAAM,OAAe,SAA6D;AACvF,UAAM,IAAI,eAAe,SAAS,OAAO,OAAO;AAChD,QAAI,MAAM,MAAM;AACd,YAAM,IAAI,MAAM,2EAA2E;AAAA,IAC7F;AACA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,eAAe,SAAS,KAAK,MAAM;AAAA,EAC5C;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,eAAe,SAAS,KAAK;AACvC,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,eAAe,OAAO,OAAO,OAAO;AAAA,EAC7C;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,eAAe,UAAU,KAAK,MAAM;AAAA,EAC9D;AAAA,EAEA,kBAAkB,eAAuC;AACvD,UAAM,QAAQ,KAAK,UAAU,kBAAkB,aAAa;AAC5D,WAAO,IAAI,eAAe,OAAO,KAAK,YAAY,KAAK,KAAK;AAAA,EAC9D;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAmD;AACxD,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EACA,UAAU,OAAkD;AAC1D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;",
+  "names": []
+}

package/dist/esm/person/person-given-name.js

@@ -0,0 +1,87 @@
+import {
+  collapseWhitespace,
+  normalizeCasing,
+  validateGivenNames
+} from "./person-name-normalization.js";
+const MAX_INPUT_LENGTH = 200;
+class PersonGivenName {
+  static typeInfo = Object.freeze({
+    englishName: "Given Name",
+    localizedName: "F\xF6rnamn",
+    emoji: "\u270F\uFE0F",
+    sources: Object.freeze([
+      "https://skatteverket.se/privat/folkbokforing/namn.4.18e1b10334ebe8bc80004083.html",
+      "https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013/"
+    ])
+  });
+  value;
+  names;
+  preferredName;
+  constructor(value, names, preferredName) {
+    this.value = value;
+    this.names = Object.freeze([...names]);
+    this.preferredName = preferredName;
+  }
+  static tryParse(input, options) {
+    const collapsed = collapseWhitespace(input);
+    if (collapsed.length === 0 || collapsed.length > MAX_INPUT_LENGTH) return null;
+    const normalized = normalizeCasing(collapsed);
+    if (!validateGivenNames(normalized)) return null;
+    const names = normalized.split(" ").filter((p) => p !== "");
+    let preferred = null;
+    const preferredInput = options?.preferredName ?? null;
+    if (preferredInput != null && preferredInput.trim() !== "") {
+      const np = normalizeCasing(collapseWhitespace(preferredInput));
+      const found = names.find((n) => n.toLowerCase() === np.toLowerCase()) ?? null;
+      if (found === null) return null;
+      preferred = found;
+    }
+    return new PersonGivenName(normalized, names, preferred);
+  }
+  static parse(input, options) {
+    const r = PersonGivenName.tryParse(input, options);
+    if (r === null) throw new Error("Invalid given name(s).");
+    return r;
+  }
+  static isValid(input) {
+    return PersonGivenName.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = PersonGivenName.tryParse(input);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    return PersonGivenName.format(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && PersonGivenName.normalize(input) === input;
+  }
+  withPreferredName(preferredName) {
+    const found = this.names.find((n) => n.toLowerCase() === preferredName.toLowerCase()) ?? null;
+    if (found === null) {
+      throw new Error("Preferred name must be one of the given names.");
+    }
+    return new PersonGivenName(this.value, this.names, found);
+  }
+  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;
+  }
+}
+export {
+  PersonGivenName
+};
+//# sourceMappingURL=person-given-name.js.map

package/dist/esm/person/person-given-name.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/person-given-name.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport {\n  collapseWhitespace,\n  normalizeCasing,\n  validateGivenNames,\n} from \"./person-name-normalization.js\";\n\nconst MAX_INPUT_LENGTH = 200;\n\n/** A person's given names (`f\u00F6rnamn`). */\nexport class PersonGivenName {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Given Name\",\n    localizedName: \"F\u00F6rnamn\",\n    emoji: \"\\u{270F}\\uFE0F\",\n    sources: Object.freeze([\n      \"https://skatteverket.se/privat/folkbokforing/namn.4.18e1b10334ebe8bc80004083.html\",\n      \"https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-20161013-om-personnamn_sfs-2016-1013/\",\n    ]),\n  });\n\n  readonly value: string;\n  readonly names: readonly string[];\n  readonly preferredName: string | null;\n\n  private constructor(value: string, names: readonly string[], preferredName: string | null) {\n    this.value = value;\n    this.names = Object.freeze([...names]);\n    this.preferredName = preferredName;\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { preferredName?: string | null },\n  ): PersonGivenName | null {\n    const collapsed = collapseWhitespace(input);\n    if (collapsed.length === 0 || collapsed.length > MAX_INPUT_LENGTH) return null;\n    const normalized = normalizeCasing(collapsed);\n    if (!validateGivenNames(normalized)) return null;\n    const names = normalized.split(\" \").filter((p) => p !== \"\");\n    let preferred: string | null = null;\n    const preferredInput = options?.preferredName ?? null;\n    if (preferredInput != null && preferredInput.trim() !== \"\") {\n      const np = normalizeCasing(collapseWhitespace(preferredInput));\n      const found = names.find((n) => n.toLowerCase() === np.toLowerCase()) ?? null;\n      if (found === null) return null;\n      preferred = found;\n    }\n    return new PersonGivenName(normalized, names, preferred);\n  }\n\n  static parse(input: string, options?: { preferredName?: string | null }): PersonGivenName {\n    const r = PersonGivenName.tryParse(input, options);\n    if (r === null) throw new Error(\"Invalid given name(s).\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return PersonGivenName.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean },\n  ): string | null {\n    const r = PersonGivenName.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 PersonGivenName.format(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && PersonGivenName.normalize(input) === input;\n  }\n\n  withPreferredName(preferredName: string): PersonGivenName {\n    const found = this.names.find((n) => n.toLowerCase() === preferredName.toLowerCase()) ?? null;\n    if (found === null) {\n      throw new Error(\"Preferred name must be one of the given names.\");\n    }\n    return new PersonGivenName(this.value, this.names, found);\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: PersonGivenName | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: PersonGivenName | 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"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,mBAAmB;AAGlB,MAAM,gBAAgB;AAAA,EAC3B,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,EAED,YAAY,OAAe,OAA0B,eAA8B;AACzF,SAAK,QAAQ;AACb,SAAK,QAAQ,OAAO,OAAO,CAAC,GAAG,KAAK,CAAC;AACrC,SAAK,gBAAgB;AAAA,EACvB;AAAA,EAEA,OAAO,SACL,OACA,SACwB;AACxB,UAAM,YAAY,mBAAmB,KAAK;AAC1C,QAAI,UAAU,WAAW,KAAK,UAAU,SAAS,iBAAkB,QAAO;AAC1E,UAAM,aAAa,gBAAgB,SAAS;AAC5C,QAAI,CAAC,mBAAmB,UAAU,EAAG,QAAO;AAC5C,UAAM,QAAQ,WAAW,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AAC1D,QAAI,YAA2B;AAC/B,UAAM,iBAAiB,SAAS,iBAAiB;AACjD,QAAI,kBAAkB,QAAQ,eAAe,KAAK,MAAM,IAAI;AAC1D,YAAM,KAAK,gBAAgB,mBAAmB,cAAc,CAAC;AAC7D,YAAM,QAAQ,MAAM,KAAK,CAAC,MAAM,EAAE,YAAY,MAAM,GAAG,YAAY,CAAC,KAAK;AACzE,UAAI,UAAU,KAAM,QAAO;AAC3B,kBAAY;AAAA,IACd;AACA,WAAO,IAAI,gBAAgB,YAAY,OAAO,SAAS;AAAA,EACzD;AAAA,EAEA,OAAO,MAAM,OAAe,SAA8D;AACxF,UAAM,IAAI,gBAAgB,SAAS,OAAO,OAAO;AACjD,QAAI,MAAM,KAAM,OAAM,IAAI,MAAM,wBAAwB;AACxD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,gBAAgB,SAAS,KAAK,MAAM;AAAA,EAC7C;AAAA,EAEA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,gBAAgB,SAAS,KAAK;AACxC,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,gBAAgB,OAAO,OAAO,OAAO;AAAA,EAC9C;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,gBAAgB,UAAU,KAAK,MAAM;AAAA,EAC/D;AAAA,EAEA,kBAAkB,eAAwC;AACxD,UAAM,QAAQ,KAAK,MAAM,KAAK,CAAC,MAAM,EAAE,YAAY,MAAM,cAAc,YAAY,CAAC,KAAK;AACzF,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE;AACA,WAAO,IAAI,gBAAgB,KAAK,OAAO,KAAK,OAAO,KAAK;AAAA,EAC1D;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EACA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAoD;AACzD,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EACA,UAAU,OAAmD;AAC3D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;",
+  "names": []
+}