@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

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

@@ -0,0 +1,148 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var adult_clothing_size_exports = {};
+__export(adult_clothing_size_exports, {
+  AdultClothingSize: () => AdultClothingSize
+});
+module.exports = __toCommonJS(adult_clothing_size_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_clothing_size_system = require("./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 = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (text.length === 0) return null;
+    const fromLetter = euSizeForLetter(text);
+    if (fromLetter !== null) return new AdultClothingSize(fromLetter, import_clothing_size_system.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" ? import_clothing_size_system.ClothingSizeSystem.EU : system === "US" ? import_clothing_size_system.ClothingSizeSystem.US : import_clothing_size_system.ClothingSizeSystem.UK
+      );
+    }
+    if (BARE_NUMBER_PATTERN.test(text)) {
+      const euSize = Number(text);
+      if (isValidEuSize(euSize)) return new AdultClothingSize(euSize, import_clothing_size_system.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;
+}
+//# sourceMappingURL=adult-clothing-size.js.map

package/dist/cjs/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/cjs/product/adult-shoe-size.js

@@ -0,0 +1,139 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var adult_shoe_size_exports = {};
+__export(adult_shoe_size_exports, {
+  AdultShoeSize: () => AdultShoeSize
+});
+module.exports = __toCommonJS(adult_shoe_size_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_shoe_size_format = require("../internal/shoe-size-format.js");
+var import_shoe_size_system = require("./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 = (0, import_shoe_size_format.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 = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    const match = matchOffset(text, EU_PATTERN, 0, import_shoe_size_system.ShoeSizeSystem.EU) ?? matchOffset(text, UK_PATTERN, UK_OFFSET, import_shoe_size_system.ShoeSizeSystem.UK) ?? matchOffset(text, US_WOMEN_PATTERN, US_WOMEN_OFFSET, import_shoe_size_system.ShoeSizeSystem.USWomen) ?? matchOffset(text, US_MEN_PATTERN, US_MEN_OFFSET, import_shoe_size_system.ShoeSizeSystem.USMen) ?? matchOffset(text, US_BARE_PATTERN, US_MEN_OFFSET, import_shoe_size_system.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: import_shoe_size_system.ShoeSizeSystem.EU };
+}
+function parseDecimalNumber(text) {
+  return import_decimal.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;
+}
+//# sourceMappingURL=adult-shoe-size.js.map

package/dist/cjs/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": []
+}

package/dist/cjs/product/aspect-ratio.js

@@ -0,0 +1,188 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var aspect_ratio_exports = {};
+__export(aspect_ratio_exports, {
+  AspectRatio: () => AspectRatio
+});
+module.exports = __toCommonJS(aspect_ratio_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+const INTEGER_COLON_PATTERN = /^\s*(\d{1,3})\s*[:xX×/]\s*(\d{1,3})\s*$/u;
+const DECIMAL_PATTERN = /^\s*(\d+(?:[.,]\d+)?)\s*(?::\s*1)?\s*$/u;
+const WHITESPACE_PATTERN = /\s+/gu;
+const DECIMAL_TOLERANCE = import_decimal.Decimal.parse("0.02");
+class AspectRatio {
+  static typeInfo = Object.freeze({
+    englishName: "Aspect Ratio",
+    localizedName: "Bildformat",
+    emoji: "\u{1F5A5}\uFE0F",
+    sources: Object.freeze(["https://www.itu.int/rec/R-REC-BT.709"])
+  });
+  /** Canonical width:height form, e.g. `16:9`. */
+  value;
+  /** Width component, e.g. `16`. */
+  width;
+  /** Height component, e.g. `9`. */
+  height;
+  /** Common name when available, e.g. `Widescreen` for `16:9`; otherwise `null`. */
+  commonName;
+  constructor(value, width, height, commonName) {
+    this.value = value;
+    this.width = width;
+    this.height = height;
+    this.commonName = commonName;
+  }
+  static OneToOne = new AspectRatio("1:1", 1, 1, "Square");
+  static FourThree = new AspectRatio("4:3", 4, 3, "Standard");
+  static FiveFour = new AspectRatio("5:4", 5, 4, "Computer Standard");
+  static ThreeTwo = new AspectRatio("3:2", 3, 2, "Classic 35 mm");
+  static SixteenTen = new AspectRatio("16:10", 16, 10, "Widescreen Computer");
+  static SixteenNine = new AspectRatio("16:9", 16, 9, "Widescreen");
+  static EighteenNine = new AspectRatio("18:9", 18, 9, "Univisium");
+  static TwentyOneNine = new AspectRatio("21:9", 21, 9, "Ultrawide");
+  static ThirtyTwoNine = new AspectRatio("32:9", 32, 9, "Super Ultrawide");
+  static NineSixteen = new AspectRatio("9:16", 9, 16, "Vertical");
+  static NineEighteen = new AspectRatio("9:18", 9, 18, "Vertical Tall");
+  /** All 11 predefined ratios, in canonical order. */
+  static get all() {
+    return ALL;
+  }
+  /** Numeric ratio ({@link width} divided by {@link height}), e.g. `1.7777…`. */
+  get ratio() {
+    return import_decimal.Decimal.fromNumber(this.width).dividedBy(import_decimal.Decimal.fromNumber(this.height));
+  }
+  /**
+   * Resolves a ratio from a `width:height`, `width/height` or `width x height` form, or from a
+   * decimal ratio close enough to one of the canonical values.
+   */
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (trimmed.length === 0) return null;
+    const fromLookup = LOOKUP.get(normalizeLookupKey(trimmed));
+    if (fromLookup !== void 0) return fromLookup;
+    const integers = INTEGER_COLON_PATTERN.exec(trimmed);
+    if (integers !== null) {
+      const width = Number(integers[1]);
+      const height = Number(integers[2]);
+      if (width > 0 && height > 0) return reduceToCanonical(width, height);
+      return null;
+    }
+    const decimals = DECIMAL_PATTERN.exec(trimmed);
+    if (decimals !== null) {
+      const ratio = import_decimal.Decimal.parse(decimals[1].replace(",", "."));
+      if (ratio !== null && !ratio.isZero && !ratio.isNegative) return matchByDecimal(ratio);
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = AspectRatio.tryParse(input);
+    if (result === null) throw new Error("Invalid aspect ratio.");
+    return result;
+  }
+  static isValid(input) {
+    return AspectRatio.tryParse(input) !== null;
+  }
+  /** Returns the canonical width:height form, e.g. `16:9`. */
+  static format(input, options) {
+    const r = AspectRatio.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical width:height form, e.g. `16:9`. */
+  static normalize(input, options) {
+    const r = AspectRatio.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AspectRatio.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.width === other.width && this.height === other.height;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.ratio.compareTo(other.ratio);
+  }
+}
+const ALL = [
+  AspectRatio.OneToOne,
+  AspectRatio.FourThree,
+  AspectRatio.FiveFour,
+  AspectRatio.ThreeTwo,
+  AspectRatio.SixteenTen,
+  AspectRatio.SixteenNine,
+  AspectRatio.EighteenNine,
+  AspectRatio.TwentyOneNine,
+  AspectRatio.ThirtyTwoNine,
+  AspectRatio.NineSixteen,
+  AspectRatio.NineEighteen
+];
+function fallback(input, options) {
+  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeLookupKey(value) {
+  return value.trim().toLowerCase().replace(WHITESPACE_PATTERN, "");
+}
+function greatestCommonDivisor(a, b) {
+  let x = a;
+  let y = b;
+  while (y !== 0) [x, y] = [y, x % y];
+  return x;
+}
+function reduceToCanonical(width, height) {
+  const divisor = greatestCommonDivisor(width, height);
+  const w = width / divisor;
+  const h = height / divisor;
+  return ALL.find((r) => r.width === w && r.height === h) ?? null;
+}
+function matchByDecimal(ratio) {
+  let best = null;
+  let bestDifference = null;
+  for (const candidate of ALL) {
+    const difference = candidate.ratio.minus(ratio).abs();
+    if (bestDifference === null || difference.compareTo(bestDifference) < 0) {
+      bestDifference = difference;
+      best = candidate;
+    }
+  }
+  if (bestDifference === null || bestDifference.compareTo(DECIMAL_TOLERANCE) > 0) return null;
+  return best;
+}
+const LOOKUP = /* @__PURE__ */ new Map();
+for (const ratio of ALL) {
+  for (const key of [
+    ratio.value,
+    `${ratio.width}/${ratio.height}`,
+    `${ratio.width}x${ratio.height}`
+  ]) {
+    const folded = normalizeLookupKey(key);
+    if (folded.length > 0 && !LOOKUP.has(folded)) LOOKUP.set(folded, ratio);
+  }
+}
+//# sourceMappingURL=aspect-ratio.js.map

package/dist/cjs/product/aspect-ratio.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/aspect-ratio.ts"],
+  "sourcesContent": ["import type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface AspectRatioFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst INTEGER_COLON_PATTERN = /^\\s*(\\d{1,3})\\s*[:xX\u00D7/]\\s*(\\d{1,3})\\s*$/u;\nconst DECIMAL_PATTERN = /^\\s*(\\d+(?:[.,]\\d+)?)\\s*(?::\\s*1)?\\s*$/u;\nconst WHITESPACE_PATTERN = /\\s+/gu;\n\n/** Widest gap between a decimal input and a canonical ratio that still counts as a match. */\nconst DECIMAL_TOLERANCE = Decimal.parse(\"0.02\")!;\n\n/**\n * A display or image aspect ratio (`bildformat`) expressed as `width:height`, e.g. `16:9`,\n * `4:3`, `21:9`. Accepts colon, slash and `x`-separated forms, as well as decimal ratios such\n * as `1.78` or `1.78:1`. Decimal inputs snap to the closest known ratio within a small\n * tolerance, so `1.7777` and `16:9` do not become separate values.\n */\nexport class AspectRatio {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Aspect Ratio\",\n    localizedName: \"Bildformat\",\n    emoji: \"\uD83D\uDDA5\uFE0F\",\n    sources: Object.freeze([\"https://www.itu.int/rec/R-REC-BT.709\"]),\n  });\n\n  /** Canonical width:height form, e.g. `16:9`. */\n  readonly value: string;\n\n  /** Width component, e.g. `16`. */\n  readonly width: number;\n\n  /** Height component, e.g. `9`. */\n  readonly height: number;\n\n  /** Common name when available, e.g. `Widescreen` for `16:9`; otherwise `null`. */\n  readonly commonName: string | null;\n\n  private constructor(value: string, width: number, height: number, commonName: string | null) {\n    this.value = value;\n    this.width = width;\n    this.height = height;\n    this.commonName = commonName;\n  }\n\n  static readonly OneToOne = new AspectRatio(\"1:1\", 1, 1, \"Square\");\n  static readonly FourThree = new AspectRatio(\"4:3\", 4, 3, \"Standard\");\n  static readonly FiveFour = new AspectRatio(\"5:4\", 5, 4, \"Computer Standard\");\n  static readonly ThreeTwo = new AspectRatio(\"3:2\", 3, 2, \"Classic 35 mm\");\n  static readonly SixteenTen = new AspectRatio(\"16:10\", 16, 10, \"Widescreen Computer\");\n  static readonly SixteenNine = new AspectRatio(\"16:9\", 16, 9, \"Widescreen\");\n  static readonly EighteenNine = new AspectRatio(\"18:9\", 18, 9, \"Univisium\");\n  static readonly TwentyOneNine = new AspectRatio(\"21:9\", 21, 9, \"Ultrawide\");\n  static readonly ThirtyTwoNine = new AspectRatio(\"32:9\", 32, 9, \"Super Ultrawide\");\n  static readonly NineSixteen = new AspectRatio(\"9:16\", 9, 16, \"Vertical\");\n  static readonly NineEighteen = new AspectRatio(\"9:18\", 9, 18, \"Vertical Tall\");\n\n  /** All 11 predefined ratios, in canonical order. */\n  static get all(): readonly AspectRatio[] {\n    return ALL;\n  }\n\n  /** Numeric ratio ({@link width} divided by {@link height}), e.g. `1.7777\u2026`. */\n  get ratio(): Decimal {\n    return Decimal.fromNumber(this.width)!.dividedBy(Decimal.fromNumber(this.height)!);\n  }\n\n  /**\n   * Resolves a ratio from a `width:height`, `width/height` or `width x height` form, or from a\n   * decimal ratio close enough to one of the canonical values.\n   */\n  static tryParse(input: string | null | undefined): AspectRatio | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0) return null;\n\n    const fromLookup = LOOKUP.get(normalizeLookupKey(trimmed));\n    if (fromLookup !== undefined) return fromLookup;\n\n    const integers = INTEGER_COLON_PATTERN.exec(trimmed);\n    if (integers !== null) {\n      const width = Number(integers[1]);\n      const height = Number(integers[2]);\n      if (width > 0 && height > 0) return reduceToCanonical(width, height);\n      return null;\n    }\n\n    const decimals = DECIMAL_PATTERN.exec(trimmed);\n    if (decimals !== null) {\n      const ratio = Decimal.parse(decimals[1]!.replace(\",\", \".\"));\n      if (ratio !== null && !ratio.isZero && !ratio.isNegative) return matchByDecimal(ratio);\n    }\n\n    return null;\n  }\n\n  static parse(input: string): AspectRatio {\n    const result = AspectRatio.tryParse(input);\n    if (result === null) throw new Error(\"Invalid aspect ratio.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AspectRatio.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical width:height form, e.g. `16:9`. */\n  static format(\n    input: string | null | undefined,\n    options?: AspectRatioFormatOptions,\n  ): string | null {\n    const r = AspectRatio.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical width:height form, e.g. `16:9`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: AspectRatioFormatOptions,\n  ): string | null {\n    const r = AspectRatio.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && AspectRatio.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: AspectRatio | null | undefined): boolean {\n    return other != null && this.width === other.width && this.height === other.height;\n  }\n\n  compareTo(other: AspectRatio | null | undefined): number {\n    if (other == null) return 1;\n    return this.ratio.compareTo(other.ratio);\n  }\n}\n\nconst ALL: readonly AspectRatio[] = [\n  AspectRatio.OneToOne,\n  AspectRatio.FourThree,\n  AspectRatio.FiveFour,\n  AspectRatio.ThreeTwo,\n  AspectRatio.SixteenTen,\n  AspectRatio.SixteenNine,\n  AspectRatio.EighteenNine,\n  AspectRatio.TwentyOneNine,\n  AspectRatio.ThirtyTwoNine,\n  AspectRatio.NineSixteen,\n  AspectRatio.NineEighteen,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: AspectRatioFormatOptions,\n): string | null {\n  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction normalizeLookupKey(value: string): string {\n  return value.trim().toLowerCase().replace(WHITESPACE_PATTERN, \"\");\n}\n\nfunction greatestCommonDivisor(a: number, b: number): number {\n  let x = a;\n  let y = b;\n  while (y !== 0) [x, y] = [y, x % y];\n  return x;\n}\n\nfunction reduceToCanonical(width: number, height: number): AspectRatio | null {\n  const divisor = greatestCommonDivisor(width, height);\n  const w = width / divisor;\n  const h = height / divisor;\n  return ALL.find((r) => r.width === w && r.height === h) ?? null;\n}\n\nfunction matchByDecimal(ratio: Decimal): AspectRatio | null {\n  let best: AspectRatio | null = null;\n  let bestDifference: Decimal | null = null;\n  for (const candidate of ALL) {\n    const difference = candidate.ratio.minus(ratio).abs();\n    if (bestDifference === null || difference.compareTo(bestDifference) < 0) {\n      bestDifference = difference;\n      best = candidate;\n    }\n  }\n  if (bestDifference === null || bestDifference.compareTo(DECIMAL_TOLERANCE) > 0) return null;\n  return best;\n}\n\nconst LOOKUP = new Map<string, AspectRatio>();\nfor (const ratio of ALL) {\n  for (const key of [\n    ratio.value,\n    `${ratio.width}/${ratio.height}`,\n    `${ratio.width}x${ratio.height}`,\n  ]) {\n    const folded = normalizeLookupKey(key);\n    if (folded.length > 0 && !LOOKUP.has(folded)) LOOKUP.set(folded, ratio);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}