@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/person/swedish-personal-identity-number.js

@@ -0,0 +1,175 @@
+import { systemClock } from "../internal/clock.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { ValidationErrorReason } from "../validation/index.js";
+import { invalidResult, validResult } from "../validation/validation-result.js";
+import {
+  parsePin,
+  pinAgeInYears,
+  pinDateOfBirth,
+  pinGender,
+  pinTo10Digit,
+  pinTo12Digit
+} from "./personnummer-parser.js";
+const MAX_INPUT_LENGTH = 20;
+const SCAN_PATTERN = /(?<!\d)(\d{6,8})([-+])(\d{4})(?!\d)/g;
+class SwedishPersonalIdentityNumber {
+  static typeInfo = Object.freeze({
+    englishName: "Personal Identity Number",
+    localizedName: "Personnummer",
+    emoji: "\u{1FAAA}",
+    sources: Object.freeze([
+      "https://skatteverket.se/privat/folkbokforing/personnummer.4.3810a01c150939e893f18c29.html",
+      "https://sv.wikipedia.org/wiki/Personnummer_i_Sverige",
+      "https://en.wikipedia.org/wiki/Luhn_algorithm"
+    ])
+  });
+  _pin;
+  _clock;
+  constructor(pin, clock) {
+    this._pin = pin;
+    this._clock = clock;
+  }
+  get formatted() {
+    return pinTo10Digit(this._pin, this._clock);
+  }
+  get value() {
+    return pinTo12Digit(this._pin);
+  }
+  get dateOfBirthHint() {
+    const d = pinDateOfBirth(this._pin);
+    if (d === null) throw new Error("Date of birth is unknown.");
+    return d;
+  }
+  get ageHint() {
+    const a = pinAgeInYears(this._pin, this._clock);
+    if (a === null) throw new Error("Age is unknown.");
+    return a;
+  }
+  get genderHint() {
+    return pinGender(this._pin);
+  }
+  static tryParse(input, options) {
+    if (input == null || input.trim() === "") return null;
+    const sanitized = sanitizeInput(input).trim();
+    if (sanitized.length === 0 || sanitized.length > MAX_INPUT_LENGTH) return null;
+    const clock = options?.clock ?? systemClock;
+    const pin = parsePin(sanitized, clock);
+    if (pin === null) return null;
+    if (pin.kind !== "personal") return null;
+    return new SwedishPersonalIdentityNumber(pin, clock);
+  }
+  static parse(input, options) {
+    const r = SwedishPersonalIdentityNumber.tryParse(input, options);
+    if (r === null) throw new Error("Invalid Swedish personal identity number.");
+    return r;
+  }
+  static isValid(input) {
+    return SwedishPersonalIdentityNumber.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = SwedishPersonalIdentityNumber.tryParse(input, options);
+    if (r) return r.formatted;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null && input.trim() !== "") {
+      return input.trim();
+    }
+    return null;
+  }
+  static normalize(input, options) {
+    const r = SwedishPersonalIdentityNumber.tryParse(input, options);
+    if (r) return r.value;
+    if (options?.fallbackToTrimmedInputWhenInvalid && input != null) {
+      const t = input.trim();
+      return t.length > 0 ? t : null;
+    }
+    return null;
+  }
+  static isNormalized(input) {
+    return input != null && SwedishPersonalIdentityNumber.normalize(input) === input;
+  }
+  static validate(input) {
+    if (input == null || input.trim() === "") {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputIsEmpty,
+        "Input is empty or whitespace.",
+        "V\xE4rdet \xE4r tomt."
+      );
+    }
+    const sanitized = sanitizeInput(input).trim();
+    if (sanitized.length > MAX_INPUT_LENGTH) {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InputTooLong,
+        "Input contains too many characters.",
+        "V\xE4rdet inneh\xE5ller f\xF6r m\xE5nga tecken."
+      );
+    }
+    const pin = parsePin(sanitized);
+    if (pin === null || pin.kind !== "personal") {
+      return invalidResult(
+        input,
+        ValidationErrorReason.InvalidFormat,
+        "Invalid personal identity number format.",
+        "Ogiltigt format f\xF6r personnummer."
+      );
+    }
+    return validResult(input);
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.formatted;
+  }
+  to10DigitString() {
+    return this.formatted;
+  }
+  to12DigitString() {
+    return this.value;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let m;
+    while ((m = SCAN_PATTERN.exec(text)) !== null) {
+      const pin = SwedishPersonalIdentityNumber.tryParse(m[0]);
+      if (!pin) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: m.index,
+          length: m[0].length,
+          originalText: m[0],
+          typeName: "SwedishPersonalIdentityNumber",
+          category: TextCandidateCategory.PersonalIdentifier,
+          normalizedForm: pin.toNormalizedString(),
+          formattedForm: pin.toString(),
+          maskedForm: maskPersonalIdentityNumber(pin),
+          confidence: TextMatchConfidence.High,
+          value: pin
+        })
+      );
+    }
+    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 maskPersonalIdentityNumber(p, options) {
+  const f = p.formatted;
+  if (options?.maskBirthDate) return "******-****";
+  return f.slice(0, f.length - 4) + "****";
+}
+export {
+  SwedishPersonalIdentityNumber,
+  maskPersonalIdentityNumber
+};
+//# sourceMappingURL=swedish-personal-identity-number.js.map

package/dist/esm/person/swedish-personal-identity-number.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/person/swedish-personal-identity-number.ts"],
+  "sourcesContent": ["import { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { Clock, systemClock } from \"../internal/clock.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { ValidationErrorReason, ValidationResult } from \"../validation/index.js\";\nimport { invalidResult, validResult } from \"../validation/validation-result.js\";\nimport {\n  ParsedPin,\n  parsePin,\n  pinAgeInYears,\n  pinDateOfBirth,\n  pinGender,\n  pinTo10Digit,\n  pinTo12Digit,\n} from \"./personnummer-parser.js\";\n\nconst MAX_INPUT_LENGTH = 20;\n\nconst SCAN_PATTERN = /(?<!\\d)(\\d{6,8})([-+])(\\d{4})(?!\\d)/g;\n\n/** A Swedish Personal Identity Number (`personnummer`). */\nexport class SwedishPersonalIdentityNumber {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Personal Identity Number\",\n    localizedName: \"Personnummer\",\n    emoji: \"\\u{1FAAA}\",\n    sources: Object.freeze([\n      \"https://skatteverket.se/privat/folkbokforing/personnummer.4.3810a01c150939e893f18c29.html\",\n      \"https://sv.wikipedia.org/wiki/Personnummer_i_Sverige\",\n      \"https://en.wikipedia.org/wiki/Luhn_algorithm\",\n    ]),\n  });\n\n  readonly _pin: ParsedPin;\n  readonly _clock: Clock;\n\n  private constructor(pin: ParsedPin, clock: Clock) {\n    this._pin = pin;\n    this._clock = clock;\n  }\n\n  get formatted(): string {\n    return pinTo10Digit(this._pin, this._clock);\n  }\n  get value(): string {\n    return pinTo12Digit(this._pin);\n  }\n  get dateOfBirthHint(): Date {\n    const d = pinDateOfBirth(this._pin);\n    if (d === null) throw new Error(\"Date of birth is unknown.\");\n    return d;\n  }\n  get ageHint(): number {\n    const a = pinAgeInYears(this._pin, this._clock);\n    if (a === null) throw new Error(\"Age is unknown.\");\n    return a;\n  }\n  get genderHint(): \"female\" | \"male\" {\n    return pinGender(this._pin);\n  }\n\n  static tryParse(\n    input: string | null | undefined,\n    options?: { clock?: Clock },\n  ): SwedishPersonalIdentityNumber | null {\n    if (input == null || input.trim() === \"\") return null;\n    const sanitized = sanitizeInput(input).trim();\n    if (sanitized.length === 0 || sanitized.length > MAX_INPUT_LENGTH) return null;\n    const clock = options?.clock ?? systemClock;\n    const pin = parsePin(sanitized, clock);\n    if (pin === null) return null;\n    if (pin.kind !== \"personal\") return null;\n    return new SwedishPersonalIdentityNumber(pin, clock);\n  }\n\n  static parse(input: string, options?: { clock?: Clock }): SwedishPersonalIdentityNumber {\n    const r = SwedishPersonalIdentityNumber.tryParse(input, options);\n    if (r === null) throw new Error(\"Invalid Swedish personal identity number.\");\n    return r;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SwedishPersonalIdentityNumber.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: { fallbackToTrimmedInputWhenInvalid?: boolean; clock?: Clock },\n  ): string | null {\n    const r = SwedishPersonalIdentityNumber.tryParse(input, options);\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; clock?: Clock },\n  ): string | null {\n    const r = SwedishPersonalIdentityNumber.tryParse(input, options);\n    if (r) return r.value;\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 && SwedishPersonalIdentityNumber.normalize(input) === input;\n  }\n\n  static validate(input: string | null | undefined): ValidationResult {\n    if (input == null || input.trim() === \"\") {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputIsEmpty,\n        \"Input is empty or whitespace.\",\n        \"V\u00E4rdet \u00E4r tomt.\",\n      );\n    }\n    const sanitized = sanitizeInput(input).trim();\n    if (sanitized.length > MAX_INPUT_LENGTH) {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InputTooLong,\n        \"Input contains too many characters.\",\n        \"V\u00E4rdet inneh\u00E5ller f\u00F6r m\u00E5nga tecken.\",\n      );\n    }\n    const pin = parsePin(sanitized);\n    if (pin === null || pin.kind !== \"personal\") {\n      return invalidResult(\n        input,\n        ValidationErrorReason.InvalidFormat,\n        \"Invalid personal identity number format.\",\n        \"Ogiltigt format f\u00F6r personnummer.\",\n      );\n    }\n    return validResult(input);\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n  toString(): string {\n    return this.formatted;\n  }\n\n  to10DigitString(): string {\n    return this.formatted;\n  }\n  to12DigitString(): string {\n    return this.value;\n  }\n\n  static findCandidatesInText(\n    text: string,\n  ): readonly TextCandidate<SwedishPersonalIdentityNumber>[] {\n    if (!text) return [];\n    const out: TextCandidate<SwedishPersonalIdentityNumber>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = SCAN_PATTERN.exec(text)) !== null) {\n      const pin = SwedishPersonalIdentityNumber.tryParse(m[0]);\n      if (!pin) continue;\n      out.push(\n        new TextCandidate<SwedishPersonalIdentityNumber>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"SwedishPersonalIdentityNumber\",\n          category: TextCandidateCategory.PersonalIdentifier,\n          normalizedForm: pin.toNormalizedString(),\n          formattedForm: pin.toString(),\n          maskedForm: maskPersonalIdentityNumber(pin),\n          confidence: TextMatchConfidence.High,\n          value: pin,\n        }),\n      );\n    }\n    return out;\n  }\n\n  equals(other: SwedishPersonalIdentityNumber | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n  compareTo(other: SwedishPersonalIdentityNumber | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\n/** Mask a personal identity number, e.g. `990807-2391` -> `990807-****`. */\nexport function maskPersonalIdentityNumber(\n  p: SwedishPersonalIdentityNumber,\n  options?: { maskBirthDate?: boolean },\n): string {\n  const f = p.formatted;\n  if (options?.maskBirthDate) return \"******-****\";\n  return f.slice(0, f.length - 4) + \"****\";\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/primitive-type-info.js

@@ -0,0 +1 @@
+//# sourceMappingURL=primitive-type-info.js.map

package/dist/esm/primitive-type-info.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/esm/primitives-defaults.js

@@ -0,0 +1,72 @@
+const DEFAULT_CULTURE = "sv-SE";
+const DEFAULT_UI_CULTURE = "sv-SE";
+const DEFAULT_COUNTRY = "SE";
+const DEFAULT_CALLING_CODE = "46";
+const state = {
+  culture: DEFAULT_CULTURE,
+  uiCulture: DEFAULT_UI_CULTURE,
+  countryAlpha2Code: DEFAULT_COUNTRY,
+  defaultCallingCode: DEFAULT_CALLING_CODE
+};
+const PrimitivesDefaults = {
+  /**
+   * BCP-47 locale tag used for casing and number formatting.
+   * Defaults to `'sv-SE'`.
+   */
+  get culture() {
+    return state.culture;
+  },
+  set culture(value) {
+    state.culture = value;
+  },
+  /**
+   * BCP-47 locale tag used for display-name language selection.
+   * Defaults to `'sv-SE'`.
+   */
+  get uiCulture() {
+    return state.uiCulture;
+  },
+  set uiCulture(value) {
+    state.uiCulture = value;
+  },
+  /**
+   * Default ISO 3166-1 alpha-2 country code. Used by types like
+   * `PhoneNumber` and `SwedishOrganizationIdentifierParser` when no explicit
+   * country is supplied. Defaults to `'SE'`.
+   */
+  get countryAlpha2Code() {
+    return state.countryAlpha2Code;
+  },
+  set countryAlpha2Code(value) {
+    state.countryAlpha2Code = value;
+  },
+  /**
+   * Default phone calling code (digits only, no `+`). Used by {@link PhoneNumber}
+   * for inputs without an explicit country prefix. Defaults to `'46'` (Sweden).
+   */
+  get defaultCallingCode() {
+    return state.defaultCallingCode;
+  },
+  set defaultCallingCode(value) {
+    state.defaultCallingCode = value;
+  },
+  /**
+   * `true` when {@link uiCulture} is Swedish (`sv` or `sv-*`).
+   * Types use this to select between localized and English display names.
+   */
+  get useLocalizedDisplayNames() {
+    const lang = state.uiCulture.toLowerCase().split("-")[0];
+    return lang === "sv";
+  },
+  /** Resets all overrides to the package defaults. */
+  reset() {
+    state.culture = DEFAULT_CULTURE;
+    state.uiCulture = DEFAULT_UI_CULTURE;
+    state.countryAlpha2Code = DEFAULT_COUNTRY;
+    state.defaultCallingCode = DEFAULT_CALLING_CODE;
+  }
+};
+export {
+  PrimitivesDefaults
+};
+//# sourceMappingURL=primitives-defaults.js.map

package/dist/esm/primitives-defaults.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/primitives-defaults.ts"],
+  "sourcesContent": ["/**\n * Configurable defaults that control locale-sensitive behaviour across all\n * primitive types. When not explicitly set, values fall back to safe Swedish\n * defaults (the .NET version derives them from `CultureInfo.CurrentCulture`,\n * which has no direct equivalent in standard JavaScript).\n *\n * Set properties at application startup or override per-request as needed.\n */\n\nconst DEFAULT_CULTURE = \"sv-SE\";\nconst DEFAULT_UI_CULTURE = \"sv-SE\";\nconst DEFAULT_COUNTRY = \"SE\";\nconst DEFAULT_CALLING_CODE = \"46\";\n\ninterface PrimitivesDefaultsState {\n  culture: string;\n  uiCulture: string;\n  countryAlpha2Code: string;\n  defaultCallingCode: string;\n}\n\nconst state: PrimitivesDefaultsState = {\n  culture: DEFAULT_CULTURE,\n  uiCulture: DEFAULT_UI_CULTURE,\n  countryAlpha2Code: DEFAULT_COUNTRY,\n  defaultCallingCode: DEFAULT_CALLING_CODE,\n};\n\n/**\n * Configurable global defaults for locale, UI language, and default country.\n *\n * These mirror the .NET `PrimitivesDefaults` static class. `culture` controls\n * formatting and casing (Swedish-aware character handling for `\u00C5`/`\u00C4`/`\u00D6`),\n * `uiCulture` controls display-name language selection (Swedish vs English),\n * and `countryAlpha2Code` is used as the default ISO 3166-1 alpha-2 country\n * when no explicit country is supplied.\n */\nexport const PrimitivesDefaults = {\n  /**\n   * BCP-47 locale tag used for casing and number formatting.\n   * Defaults to `'sv-SE'`.\n   */\n  get culture(): string {\n    return state.culture;\n  },\n  set culture(value: string) {\n    state.culture = value;\n  },\n\n  /**\n   * BCP-47 locale tag used for display-name language selection.\n   * Defaults to `'sv-SE'`.\n   */\n  get uiCulture(): string {\n    return state.uiCulture;\n  },\n  set uiCulture(value: string) {\n    state.uiCulture = value;\n  },\n\n  /**\n   * Default ISO 3166-1 alpha-2 country code. Used by types like\n   * `PhoneNumber` and `SwedishOrganizationIdentifierParser` when no explicit\n   * country is supplied. Defaults to `'SE'`.\n   */\n  get countryAlpha2Code(): string {\n    return state.countryAlpha2Code;\n  },\n  set countryAlpha2Code(value: string) {\n    state.countryAlpha2Code = value;\n  },\n\n  /**\n   * Default phone calling code (digits only, no `+`). Used by {@link PhoneNumber}\n   * for inputs without an explicit country prefix. Defaults to `'46'` (Sweden).\n   */\n  get defaultCallingCode(): string {\n    return state.defaultCallingCode;\n  },\n  set defaultCallingCode(value: string) {\n    state.defaultCallingCode = value;\n  },\n\n  /**\n   * `true` when {@link uiCulture} is Swedish (`sv` or `sv-*`).\n   * Types use this to select between localized and English display names.\n   */\n  get useLocalizedDisplayNames(): boolean {\n    const lang = state.uiCulture.toLowerCase().split(\"-\")[0];\n    return lang === \"sv\";\n  },\n\n  /** Resets all overrides to the package defaults. */\n  reset(): void {\n    state.culture = DEFAULT_CULTURE;\n    state.uiCulture = DEFAULT_UI_CULTURE;\n    state.countryAlpha2Code = DEFAULT_COUNTRY;\n    state.defaultCallingCode = DEFAULT_CALLING_CODE;\n  },\n};\n"],
+  "mappings": "AASA,MAAM,kBAAkB;AACxB,MAAM,qBAAqB;AAC3B,MAAM,kBAAkB;AACxB,MAAM,uBAAuB;AAS7B,MAAM,QAAiC;AAAA,EACrC,SAAS;AAAA,EACT,WAAW;AAAA,EACX,mBAAmB;AAAA,EACnB,oBAAoB;AACtB;AAWO,MAAM,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKhC,IAAI,UAAkB;AACpB,WAAO,MAAM;AAAA,EACf;AAAA,EACA,IAAI,QAAQ,OAAe;AACzB,UAAM,UAAU;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,YAAoB;AACtB,WAAO,MAAM;AAAA,EACf;AAAA,EACA,IAAI,UAAU,OAAe;AAC3B,UAAM,YAAY;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,oBAA4B;AAC9B,WAAO,MAAM;AAAA,EACf;AAAA,EACA,IAAI,kBAAkB,OAAe;AACnC,UAAM,oBAAoB;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,qBAA6B;AAC/B,WAAO,MAAM;AAAA,EACf;AAAA,EACA,IAAI,mBAAmB,OAAe;AACpC,UAAM,qBAAqB;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,2BAAoC;AACtC,UAAM,OAAO,MAAM,UAAU,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AACvD,WAAO,SAAS;AAAA,EAClB;AAAA;AAAA,EAGA,QAAc;AACZ,UAAM,UAAU;AAChB,UAAM,YAAY;AAClB,UAAM,oBAAoB;AAC1B,UAAM,qBAAqB;AAAA,EAC7B;AACF;",
+  "names": []
+}

package/dist/esm/product/adult-clothing-size.js

@@ -0,0 +1,128 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { ClothingSizeSystem } from "./clothing-size-system.js";
+const LETTER_SIZES = [
+  ["XXXXL", 48],
+  ["XXXL", 46],
+  ["XXL", 44],
+  ["XL", 42],
+  ["XXS", 32],
+  ["XS", 34],
+  ["S", 36],
+  ["M", 38],
+  ["L", 40]
+];
+const PREFIXED_SIZE_PATTERN = /^(EU|US|UK)\s*(\d+)$/iu;
+const BARE_NUMBER_PATTERN = /^\d+$/u;
+class AdultClothingSize {
+  static typeInfo = Object.freeze({
+    englishName: "Adult Clothing Size",
+    localizedName: "Kl\xE4dstorlek (vuxen)",
+    emoji: "\u{1F454}",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/EN_13402",
+      "https://www.iso.org/standard/85084.html",
+      "https://en.wikipedia.org/wiki/Clothing_sizes"
+    ])
+  });
+  /** EU numeric size, even and between 32 and 56, e.g. `40`. */
+  euSize;
+  /** Approximate US numeric size (EU − 30), e.g. `10` for EU 40. */
+  usSize;
+  /** Approximate UK numeric size (EU − 28), e.g. `12` for EU 40. */
+  ukSize;
+  /** Standard letter size when the EU size maps to one; otherwise `null`. */
+  letterSize;
+  /** The sizing system the value was parsed from. */
+  system;
+  /** Display form: the letter when mapped, e.g. `L`, otherwise `EU 50`. */
+  value;
+  constructor(euSize, system) {
+    this.euSize = euSize;
+    this.system = system;
+    this.usSize = euSize - 30;
+    this.ukSize = euSize - 28;
+    this.letterSize = letterForEuSize(euSize);
+    this.value = this.letterSize ?? euDisplay(euSize);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const text = sanitizeInput(input).trim();
+    if (text.length === 0) return null;
+    const fromLetter = euSizeForLetter(text);
+    if (fromLetter !== null) return new AdultClothingSize(fromLetter, ClothingSizeSystem.Letter);
+    const prefixed = PREFIXED_SIZE_PATTERN.exec(text);
+    if (prefixed !== null) {
+      const system = prefixed[1].toUpperCase();
+      const number = Number(prefixed[2]);
+      const euSize = system === "EU" ? number : system === "US" ? number + 30 : number + 28;
+      if (!isValidEuSize(euSize)) return null;
+      return new AdultClothingSize(
+        euSize,
+        system === "EU" ? ClothingSizeSystem.EU : system === "US" ? ClothingSizeSystem.US : ClothingSizeSystem.UK
+      );
+    }
+    if (BARE_NUMBER_PATTERN.test(text)) {
+      const euSize = Number(text);
+      if (isValidEuSize(euSize)) return new AdultClothingSize(euSize, ClothingSizeSystem.EU);
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = AdultClothingSize.tryParse(input);
+    if (result === null) throw new Error("Invalid adult clothing size.");
+    return result;
+  }
+  static isValid(input) {
+    return AdultClothingSize.tryParse(input) !== null;
+  }
+  /** Returns the letter size when the EU size maps to one, otherwise the `EU 40` form. */
+  static format(input, options) {
+    const r = AdultClothingSize.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical EU form, e.g. `EU 40`. */
+  static normalize(input, options) {
+    const r = AdultClothingSize.tryParse(input);
+    if (r !== null) return euDisplay(r.euSize);
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AdultClothingSize.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return euDisplay(this.euSize);
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.euSize === other.euSize;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.euSize < other.euSize ? -1 : this.euSize > other.euSize ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function isValidEuSize(euSize) {
+  return euSize >= 32 && euSize <= 56 && euSize % 2 === 0;
+}
+function euDisplay(euSize) {
+  return `EU ${euSize}`;
+}
+function euSizeForLetter(text) {
+  const upper = text.toUpperCase();
+  return LETTER_SIZES.find(([letter]) => letter === upper)?.[1] ?? null;
+}
+function letterForEuSize(euSize) {
+  return LETTER_SIZES.find(([, size]) => size === euSize)?.[0] ?? null;
+}
+export {
+  AdultClothingSize
+};
+//# sourceMappingURL=adult-clothing-size.js.map

package/dist/esm/product/adult-clothing-size.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/adult-clothing-size.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { ClothingSizeSystem } from \"./clothing-size-system.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface AdultClothingSizeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\n/** Letter codes with the EU size each maps to, longest first so `XXL` wins over `XL`. */\nconst LETTER_SIZES: readonly (readonly [string, number])[] = [\n  [\"XXXXL\", 48],\n  [\"XXXL\", 46],\n  [\"XXL\", 44],\n  [\"XL\", 42],\n  [\"XXS\", 32],\n  [\"XS\", 34],\n  [\"S\", 36],\n  [\"M\", 38],\n  [\"L\", 40],\n];\n\nconst PREFIXED_SIZE_PATTERN = /^(EU|US|UK)\\s*(\\d+)$/iu;\nconst BARE_NUMBER_PATTERN = /^\\d+$/u;\n\n/**\n * Adult clothing size (`kl\u00E4dstorlek`) with approximate conversions between the EU numeric, US,\n * UK and letter (XXS\u2013XXXXL) systems. Stored as an even EU size between 32 and 56. A bare number\n * is always read as EU; US and UK sizes need an explicit prefix.\n *\n * The conversions are industry approximations (EU \u2248 US + 30, EU \u2248 UK + 28) and vary by brand.\n */\nexport class AdultClothingSize {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Adult Clothing Size\",\n    localizedName: \"Kl\u00E4dstorlek (vuxen)\",\n    emoji: \"\uD83D\uDC54\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/EN_13402\",\n      \"https://www.iso.org/standard/85084.html\",\n      \"https://en.wikipedia.org/wiki/Clothing_sizes\",\n    ]),\n  });\n\n  /** EU numeric size, even and between 32 and 56, e.g. `40`. */\n  readonly euSize: number;\n\n  /** Approximate US numeric size (EU \u2212 30), e.g. `10` for EU 40. */\n  readonly usSize: number;\n\n  /** Approximate UK numeric size (EU \u2212 28), e.g. `12` for EU 40. */\n  readonly ukSize: number;\n\n  /** Standard letter size when the EU size maps to one; otherwise `null`. */\n  readonly letterSize: string | null;\n\n  /** The sizing system the value was parsed from. */\n  readonly system: ClothingSizeSystem;\n\n  /** Display form: the letter when mapped, e.g. `L`, otherwise `EU 50`. */\n  readonly value: string;\n\n  private constructor(euSize: number, system: ClothingSizeSystem) {\n    this.euSize = euSize;\n    this.system = system;\n    this.usSize = euSize - 30;\n    this.ukSize = euSize - 28;\n    this.letterSize = letterForEuSize(euSize);\n    this.value = this.letterSize ?? euDisplay(euSize);\n  }\n\n  static tryParse(input: string | null | undefined): AdultClothingSize | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const text = sanitizeInput(input).trim();\n    if (text.length === 0) return null;\n\n    const fromLetter = euSizeForLetter(text);\n    if (fromLetter !== null) return new AdultClothingSize(fromLetter, ClothingSizeSystem.Letter);\n\n    const prefixed = PREFIXED_SIZE_PATTERN.exec(text);\n    if (prefixed !== null) {\n      const system = prefixed[1]!.toUpperCase();\n      const number = Number(prefixed[2]);\n      const euSize = system === \"EU\" ? number : system === \"US\" ? number + 30 : number + 28;\n      if (!isValidEuSize(euSize)) return null;\n      return new AdultClothingSize(\n        euSize,\n        system === \"EU\"\n          ? ClothingSizeSystem.EU\n          : system === \"US\"\n            ? ClothingSizeSystem.US\n            : ClothingSizeSystem.UK,\n      );\n    }\n\n    if (BARE_NUMBER_PATTERN.test(text)) {\n      const euSize = Number(text);\n      if (isValidEuSize(euSize)) return new AdultClothingSize(euSize, ClothingSizeSystem.EU);\n    }\n\n    return null;\n  }\n\n  static parse(input: string): AdultClothingSize {\n    const result = AdultClothingSize.tryParse(input);\n    if (result === null) throw new Error(\"Invalid adult clothing size.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AdultClothingSize.tryParse(input) !== null;\n  }\n\n  /** Returns the letter size when the EU size maps to one, otherwise the `EU 40` form. */\n  static format(\n    input: string | null | undefined,\n    options?: AdultClothingSizeFormatOptions,\n  ): string | null {\n    const r = AdultClothingSize.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical EU form, e.g. `EU 40`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: AdultClothingSizeFormatOptions,\n  ): string | null {\n    const r = AdultClothingSize.tryParse(input);\n    if (r !== null) return euDisplay(r.euSize);\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AdultClothingSize.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return euDisplay(this.euSize);\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: AdultClothingSize | null | undefined): boolean {\n    return other != null && this.euSize === other.euSize;\n  }\n\n  compareTo(other: AdultClothingSize | null | undefined): number {\n    if (other == null) return 1;\n    return this.euSize < other.euSize ? -1 : this.euSize > other.euSize ? 1 : 0;\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: AdultClothingSizeFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction isValidEuSize(euSize: number): boolean {\n  return euSize >= 32 && euSize <= 56 && euSize % 2 === 0;\n}\n\nfunction euDisplay(euSize: number): string {\n  return `EU ${euSize}`;\n}\n\nfunction euSizeForLetter(text: string): number | null {\n  const upper = text.toUpperCase();\n  return LETTER_SIZES.find(([letter]) => letter === upper)?.[1] ?? null;\n}\n\nfunction letterForEuSize(euSize: number): string | null {\n  return LETTER_SIZES.find(([, size]) => size === euSize)?.[0] ?? null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/product/adult-shoe-size.js

@@ -0,0 +1,119 @@
+import { Decimal } from "../internal/decimal.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { formatEuShoeSize } from "../internal/shoe-size-format.js";
+import { ShoeSizeSystem } from "./shoe-size-system.js";
+const US_MEN_OFFSET = 33;
+const US_WOMEN_OFFSET = 31.5;
+const UK_OFFSET = 33.5;
+const EU_PATTERN = /^\s*EU\s*([0-9]+(?:[.,][0-9]+)?)\s*$/iu;
+const UK_PATTERN = /^\s*UK\s*([0-9]+(?:[.,][0-9]+)?)\s*$/iu;
+const US_WOMEN_PATTERN = /^\s*US\s+(?:WOMEN|W)\s*([0-9]+(?:[.,][0-9]+)?)\s*$/iu;
+const US_MEN_PATTERN = /^\s*US\s+(?:MEN|M)\s*([0-9]+(?:[.,][0-9]+)?)\s*$/iu;
+const US_BARE_PATTERN = /^\s*US\s+([0-9]+(?:[.,][0-9]+)?)\s*$/iu;
+const BARE_NUMBER_PATTERN = /^\s*([0-9]+(?:[.,][0-9]+)?)\s*$/u;
+class AdultShoeSize {
+  static typeInfo = Object.freeze({
+    englishName: "Adult Shoe Size",
+    localizedName: "Skostorlek (vuxen)",
+    emoji: "\u{1F45E}",
+    sources: Object.freeze([
+      "https://www.iso.org/standard/83106.html",
+      "https://www.iso.org/standard/71594.html",
+      "https://en.wikipedia.org/wiki/Shoe_size"
+    ])
+  });
+  /** The EU size, e.g. `42` or `42.5`. */
+  euSize;
+  /** The sizing system the value was parsed from. */
+  system;
+  /** Display form as an EU size, e.g. `EU 42` or `EU 42.5`. */
+  value;
+  constructor(euSize, system) {
+    this.euSize = euSize;
+    this.system = system;
+    this.value = formatEuShoeSize(euSize);
+  }
+  /** US men's size derived from EU, e.g. `9` for EU 42. */
+  get usMenSize() {
+    return this.euSize - US_MEN_OFFSET;
+  }
+  /** US women's size derived from EU, e.g. `10.5` for EU 42. */
+  get usWomenSize() {
+    return this.euSize - US_WOMEN_OFFSET;
+  }
+  /** UK size derived from EU, e.g. `8.5` for EU 42. */
+  get ukSize() {
+    return this.euSize - UK_OFFSET;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const text = sanitizeInput(input).trim();
+    const match = matchOffset(text, EU_PATTERN, 0, ShoeSizeSystem.EU) ?? matchOffset(text, UK_PATTERN, UK_OFFSET, ShoeSizeSystem.UK) ?? matchOffset(text, US_WOMEN_PATTERN, US_WOMEN_OFFSET, ShoeSizeSystem.USWomen) ?? matchOffset(text, US_MEN_PATTERN, US_MEN_OFFSET, ShoeSizeSystem.USMen) ?? matchOffset(text, US_BARE_PATTERN, US_MEN_OFFSET, ShoeSizeSystem.USMen) ?? matchBareEu(text);
+    if (match === null || !isValidEuSize(match.euSize)) return null;
+    return new AdultShoeSize(match.euSize, match.system);
+  }
+  static parse(input) {
+    const result = AdultShoeSize.tryParse(input);
+    if (result === null) throw new Error("Invalid adult shoe size.");
+    return result;
+  }
+  static isValid(input) {
+    return AdultShoeSize.tryParse(input) !== null;
+  }
+  /** Returns the canonical `EU 42` form. */
+  static format(input, options) {
+    const r = AdultShoeSize.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical `EU 42` form, the same as {@link format} for this type. */
+  static normalize(input, options) {
+    const r = AdultShoeSize.tryParse(input);
+    if (r !== null) return r.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AdultShoeSize.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.euSize === other.euSize;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.euSize < other.euSize ? -1 : this.euSize > other.euSize ? 1 : 0;
+  }
+}
+function matchOffset(text, pattern, offset, system) {
+  const match = pattern.exec(text);
+  if (match === null) return null;
+  const value = parseDecimalNumber(match[1]);
+  return value === null ? null : { euSize: value + offset, system };
+}
+function matchBareEu(text) {
+  const match = BARE_NUMBER_PATTERN.exec(text);
+  if (match === null) return null;
+  const value = parseDecimalNumber(match[1]);
+  if (value === null || value < 35) return null;
+  return { euSize: value, system: ShoeSizeSystem.EU };
+}
+function parseDecimalNumber(text) {
+  return Decimal.parse(text.replace(",", "."))?.toNumber() ?? null;
+}
+function isValidEuSize(euSize) {
+  return euSize >= 35 && euSize <= 50 && Number.isInteger(euSize * 2);
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  AdultShoeSize
+};
+//# sourceMappingURL=adult-shoe-size.js.map

package/dist/esm/product/adult-shoe-size.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/adult-shoe-size.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { formatEuShoeSize } from \"../internal/shoe-size-format.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { ShoeSizeSystem } from \"./shoe-size-system.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface AdultShoeSizeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst US_MEN_OFFSET = 33;\nconst US_WOMEN_OFFSET = 31.5;\nconst UK_OFFSET = 33.5;\n\nconst EU_PATTERN = /^\\s*EU\\s*([0-9]+(?:[.,][0-9]+)?)\\s*$/iu;\nconst UK_PATTERN = /^\\s*UK\\s*([0-9]+(?:[.,][0-9]+)?)\\s*$/iu;\nconst US_WOMEN_PATTERN = /^\\s*US\\s+(?:WOMEN|W)\\s*([0-9]+(?:[.,][0-9]+)?)\\s*$/iu;\nconst US_MEN_PATTERN = /^\\s*US\\s+(?:MEN|M)\\s*([0-9]+(?:[.,][0-9]+)?)\\s*$/iu;\nconst US_BARE_PATTERN = /^\\s*US\\s+([0-9]+(?:[.,][0-9]+)?)\\s*$/iu;\nconst BARE_NUMBER_PATTERN = /^\\s*([0-9]+(?:[.,][0-9]+)?)\\s*$/u;\n\n/**\n * Adult shoe size (`skostorlek`) stored as an EU size between 35 and 50 in half steps, with\n * US men's, US women's and UK conversions. A bare number below 35 is rejected so that children's\n * sizes do not silently resolve as adult ones.\n *\n * Conversions follow common retail charts with EU as the anchor: US men \u2248 EU \u2212 33,\n * US women \u2248 EU \u2212 31.5, UK \u2248 EU \u2212 33.5.\n */\nexport class AdultShoeSize {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Adult Shoe Size\",\n    localizedName: \"Skostorlek (vuxen)\",\n    emoji: \"\uD83D\uDC5E\",\n    sources: Object.freeze([\n      \"https://www.iso.org/standard/83106.html\",\n      \"https://www.iso.org/standard/71594.html\",\n      \"https://en.wikipedia.org/wiki/Shoe_size\",\n    ]),\n  });\n\n  /** The EU size, e.g. `42` or `42.5`. */\n  readonly euSize: number;\n\n  /** The sizing system the value was parsed from. */\n  readonly system: ShoeSizeSystem;\n\n  /** Display form as an EU size, e.g. `EU 42` or `EU 42.5`. */\n  readonly value: string;\n\n  private constructor(euSize: number, system: ShoeSizeSystem) {\n    this.euSize = euSize;\n    this.system = system;\n    this.value = formatEuShoeSize(euSize);\n  }\n\n  /** US men's size derived from EU, e.g. `9` for EU 42. */\n  get usMenSize(): number {\n    return this.euSize - US_MEN_OFFSET;\n  }\n\n  /** US women's size derived from EU, e.g. `10.5` for EU 42. */\n  get usWomenSize(): number {\n    return this.euSize - US_WOMEN_OFFSET;\n  }\n\n  /** UK size derived from EU, e.g. `8.5` for EU 42. */\n  get ukSize(): number {\n    return this.euSize - UK_OFFSET;\n  }\n\n  static tryParse(input: string | null | undefined): AdultShoeSize | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const text = sanitizeInput(input).trim();\n    const match =\n      matchOffset(text, EU_PATTERN, 0, ShoeSizeSystem.EU) ??\n      matchOffset(text, UK_PATTERN, UK_OFFSET, ShoeSizeSystem.UK) ??\n      matchOffset(text, US_WOMEN_PATTERN, US_WOMEN_OFFSET, ShoeSizeSystem.USWomen) ??\n      matchOffset(text, US_MEN_PATTERN, US_MEN_OFFSET, ShoeSizeSystem.USMen) ??\n      matchOffset(text, US_BARE_PATTERN, US_MEN_OFFSET, ShoeSizeSystem.USMen) ??\n      matchBareEu(text);\n\n    if (match === null || !isValidEuSize(match.euSize)) return null;\n    return new AdultShoeSize(match.euSize, match.system);\n  }\n\n  static parse(input: string): AdultShoeSize {\n    const result = AdultShoeSize.tryParse(input);\n    if (result === null) throw new Error(\"Invalid adult shoe size.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AdultShoeSize.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical `EU 42` form. */\n  static format(\n    input: string | null | undefined,\n    options?: AdultShoeSizeFormatOptions,\n  ): string | null {\n    const r = AdultShoeSize.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical `EU 42` form, the same as {@link format} for this type. */\n  static normalize(\n    input: string | null | undefined,\n    options?: AdultShoeSizeFormatOptions,\n  ): string | null {\n    const r = AdultShoeSize.tryParse(input);\n    if (r !== null) return r.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AdultShoeSize.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: AdultShoeSize | null | undefined): boolean {\n    return other != null && this.euSize === other.euSize;\n  }\n\n  compareTo(other: AdultShoeSize | null | undefined): number {\n    if (other == null) return 1;\n    return this.euSize < other.euSize ? -1 : this.euSize > other.euSize ? 1 : 0;\n  }\n}\n\ninterface SizeMatch {\n  readonly euSize: number;\n  readonly system: ShoeSizeSystem;\n}\n\nfunction matchOffset(\n  text: string,\n  pattern: RegExp,\n  offset: number,\n  system: ShoeSizeSystem,\n): SizeMatch | null {\n  const match = pattern.exec(text);\n  if (match === null) return null;\n\n  const value = parseDecimalNumber(match[1]!);\n  return value === null ? null : { euSize: value + offset, system };\n}\n\nfunction matchBareEu(text: string): SizeMatch | null {\n  const match = BARE_NUMBER_PATTERN.exec(text);\n  if (match === null) return null;\n\n  const value = parseDecimalNumber(match[1]!);\n  if (value === null || value < 35) return null;\n  return { euSize: value, system: ShoeSizeSystem.EU };\n}\n\nfunction parseDecimalNumber(text: string): number | null {\n  return Decimal.parse(text.replace(\",\", \".\"))?.toNumber() ?? null;\n}\n\nfunction isValidEuSize(euSize: number): boolean {\n  return euSize >= 35 && euSize <= 50 && Number.isInteger(euSize * 2);\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: AdultShoeSizeFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n"],
+  "mappings": "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",
+  "names": []
+}