@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/cjs/product/refrigerant.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/refrigerant.ts"],
+  "sourcesContent": ["import type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { foldOrdinalIgnoreCase } from \"../internal/case-folding.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 { maskRefrigerant } from \"./product-masking.js\";\nimport { RefrigerantFamily } from \"./refrigerant-family.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface RefrigerantFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\ninterface RefrigerantDef {\n  readonly value: string;\n  readonly compactCode: string;\n  readonly composition: string;\n  readonly family: RefrigerantFamily;\n  readonly gwp100Year: number;\n  readonly safetyClass: string;\n  readonly isRestrictedInEu: boolean;\n  readonly rank: number;\n}\n\n/**\n * A refrigerant designation (`k\u00F6ldmedium`) following the ASHRAE Standard 34 numbering system,\n * with associated GWP (Global Warming Potential) metadata.\n */\nexport class Refrigerant {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Refrigerant\",\n    localizedName: \"K\u00F6ldmedium\",\n    emoji: \"\u2744\uFE0F\",\n    sources: Object.freeze([\n      \"https://www.ashrae.org/technical-resources/standards-and-guidelines/standards-addenda/standard-34-designation-and-safety-classification-of-refrigerants\",\n      \"https://eur-lex.europa.eu/eli/reg/2014/517/oj\",\n    ]),\n  });\n\n  readonly value: string;\n  readonly compactCode: string;\n  readonly composition: string;\n  readonly family: RefrigerantFamily;\n  readonly gwp100Year: number;\n  readonly safetyClass: string;\n  readonly isRestrictedInEu: boolean;\n\n  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */\n  private readonly rank: number;\n\n  private constructor(def: RefrigerantDef) {\n    this.value = def.value;\n    this.compactCode = def.compactCode;\n    this.composition = def.composition;\n    this.family = def.family;\n    this.gwp100Year = def.gwp100Year;\n    this.safetyClass = def.safetyClass;\n    this.isRestrictedInEu = def.isRestrictedInEu;\n    this.rank = def.rank;\n  }\n\n  static readonly R12 = new Refrigerant({\n    value: \"R-12\",\n    compactCode: \"R12\",\n    composition: \"Dichlorodifluoromethane\",\n    family: RefrigerantFamily.Cfc,\n    gwp100Year: 10900,\n    safetyClass: \"A1\",\n    isRestrictedInEu: true,\n    rank: 0,\n  });\n\n  static readonly R22 = new Refrigerant({\n    value: \"R-22\",\n    compactCode: \"R22\",\n    composition: \"Chlorodifluoromethane\",\n    family: RefrigerantFamily.Hcfc,\n    gwp100Year: 1810,\n    safetyClass: \"A1\",\n    isRestrictedInEu: true,\n    rank: 6,\n  });\n\n  static readonly R32 = new Refrigerant({\n    value: \"R-32\",\n    compactCode: \"R32\",\n    composition: \"Difluoromethane\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 675,\n    safetyClass: \"A2L\",\n    isRestrictedInEu: false,\n    rank: 8,\n  });\n\n  static readonly R134a = new Refrigerant({\n    value: \"R-134a\",\n    compactCode: \"R134a\",\n    composition: \"1,1,1,2-Tetrafluoroethane\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 1430,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 5,\n  });\n\n  static readonly R290 = new Refrigerant({\n    value: \"R-290\",\n    compactCode: \"R290\",\n    composition: \"Propane\",\n    family: RefrigerantFamily.Natural,\n    gwp100Year: 3,\n    safetyClass: \"A3\",\n    isRestrictedInEu: false,\n    rank: 7,\n  });\n\n  static readonly R404A = new Refrigerant({\n    value: \"R-404A\",\n    compactCode: \"R404A\",\n    composition: \"HFC blend (R-125/R-143a/R-134a)\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 3922,\n    safetyClass: \"A1\",\n    isRestrictedInEu: true,\n    rank: 9,\n  });\n\n  static readonly R407C = new Refrigerant({\n    value: \"R-407C\",\n    compactCode: \"R407C\",\n    composition: \"HFC blend (R-32/R-125/R-134a)\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 1774,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 10,\n  });\n\n  static readonly R407F = new Refrigerant({\n    value: \"R-407F\",\n    compactCode: \"R407F\",\n    composition: \"HFC blend (R-32/R-125/R-134a)\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 1825,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 11,\n  });\n\n  static readonly R410A = new Refrigerant({\n    value: \"R-410A\",\n    compactCode: \"R410A\",\n    composition: \"HFC blend (R-32/R-125)\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 2088,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 12,\n  });\n\n  static readonly R448A = new Refrigerant({\n    value: \"R-448A\",\n    compactCode: \"R448A\",\n    composition: \"HFC/HFO blend (R-32/R-125/R-134a/R-1234yf/R-1234ze)\",\n    family: RefrigerantFamily.HfcHfoBlend,\n    gwp100Year: 1387,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 13,\n  });\n\n  static readonly R449A = new Refrigerant({\n    value: \"R-449A\",\n    compactCode: \"R449A\",\n    composition: \"HFC/HFO blend (R-32/R-125/R-134a/R-1234yf)\",\n    family: RefrigerantFamily.HfcHfoBlend,\n    gwp100Year: 1397,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 14,\n  });\n\n  static readonly R452A = new Refrigerant({\n    value: \"R-452A\",\n    compactCode: \"R452A\",\n    composition: \"HFC/HFO blend (R-32/R-125/R-1234yf)\",\n    family: RefrigerantFamily.HfcHfoBlend,\n    gwp100Year: 2140,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 15,\n  });\n\n  static readonly R507A = new Refrigerant({\n    value: \"R-507A\",\n    compactCode: \"R507A\",\n    composition: \"HFC blend (R-125/R-143a)\",\n    family: RefrigerantFamily.Hfc,\n    gwp100Year: 3985,\n    safetyClass: \"A1\",\n    isRestrictedInEu: true,\n    rank: 16,\n  });\n\n  static readonly R513A = new Refrigerant({\n    value: \"R-513A\",\n    compactCode: \"R513A\",\n    composition: \"HFC/HFO blend (R-1234yf/R-134a)\",\n    family: RefrigerantFamily.HfcHfoBlend,\n    gwp100Year: 631,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 17,\n  });\n\n  static readonly R600a = new Refrigerant({\n    value: \"R-600a\",\n    compactCode: \"R600a\",\n    composition: \"Isobutane\",\n    family: RefrigerantFamily.Natural,\n    gwp100Year: 3,\n    safetyClass: \"A3\",\n    isRestrictedInEu: false,\n    rank: 18,\n  });\n\n  static readonly R717 = new Refrigerant({\n    value: \"R-717\",\n    compactCode: \"R717\",\n    composition: \"Ammonia\",\n    family: RefrigerantFamily.Natural,\n    gwp100Year: 0,\n    safetyClass: \"B2L\",\n    isRestrictedInEu: false,\n    rank: 19,\n  });\n\n  static readonly R718 = new Refrigerant({\n    value: \"R-718\",\n    compactCode: \"R718\",\n    composition: \"Water\",\n    family: RefrigerantFamily.Natural,\n    gwp100Year: 0,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 20,\n  });\n\n  static readonly R744 = new Refrigerant({\n    value: \"R-744\",\n    compactCode: \"R744\",\n    composition: \"Carbon dioxide\",\n    family: RefrigerantFamily.Natural,\n    gwp100Year: 1,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 21,\n  });\n\n  static readonly R1234yf = new Refrigerant({\n    value: \"R-1234yf\",\n    compactCode: \"R1234yf\",\n    composition: \"2,3,3,3-Tetrafluoropropene\",\n    family: RefrigerantFamily.Hfo,\n    gwp100Year: 4,\n    safetyClass: \"A2L\",\n    isRestrictedInEu: false,\n    rank: 2,\n  });\n\n  static readonly R1234ze = new Refrigerant({\n    value: \"R-1234ze\",\n    compactCode: \"R1234ze\",\n    composition: \"trans-1,3,3,3-Tetrafluoropropene\",\n    family: RefrigerantFamily.Hfo,\n    gwp100Year: 7,\n    safetyClass: \"A2L\",\n    isRestrictedInEu: false,\n    rank: 3,\n  });\n\n  static readonly R1233zd = new Refrigerant({\n    value: \"R-1233zd\",\n    compactCode: \"R1233zd\",\n    composition: \"trans-1-Chloro-3,3,3-trifluoropropene\",\n    family: RefrigerantFamily.Hfo,\n    gwp100Year: 1,\n    safetyClass: \"A1\",\n    isRestrictedInEu: false,\n    rank: 1,\n  });\n\n  static readonly R1270 = new Refrigerant({\n    value: \"R-1270\",\n    compactCode: \"R1270\",\n    composition: \"Propylene\",\n    family: RefrigerantFamily.Natural,\n    gwp100Year: 2,\n    safetyClass: \"A3\",\n    isRestrictedInEu: false,\n    rank: 4,\n  });\n\n  /** All 22 values, in canonical order. */\n  static get all(): readonly Refrigerant[] {\n    return ALL;\n  }\n\n  /** Resolves a value from its canonical name, localized name, code or any known alias. */\n  static tryParse(input: string | null | undefined): Refrigerant | null {\n    if (input == null) return null;\n    const key = normalizeLookupKey(sanitizeInput(input).trim());\n    if (key.length === 0) return null;\n    return LOOKUP.get(key) ?? null;\n  }\n\n  static parse(input: string): Refrigerant {\n    const result = Refrigerant.tryParse(input);\n    if (result === null) throw new Error(`Invalid refrigerant.`);\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Refrigerant.tryParse(input) !== null;\n  }\n\n  static format(\n    input: string | null | undefined,\n    options?: RefrigerantFormatOptions,\n  ): string | null {\n    const r = Refrigerant.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  static normalize(\n    input: string | null | undefined,\n    options?: RefrigerantFormatOptions,\n  ): string | null {\n    const r = Refrigerant.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 && Refrigerant.normalize(input) === input;\n  }\n\n  /** Finds refrigerant mentions in unstructured text. */\n  static findCandidatesInText(text: string): readonly TextCandidate<Refrigerant>[] {\n    if (!text) return [];\n    const out: TextCandidate<Refrigerant>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = SCAN_PATTERN.exec(text)) !== null) {\n      const value = Refrigerant.tryParse(m[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Refrigerant>({\n          startIndex: m.index,\n          length: m[0].length,\n          originalText: m[0],\n          typeName: \"Refrigerant\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskRefrigerant(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: Refrigerant | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: Refrigerant | null | undefined): number {\n    if (other == null) return 1;\n    return this.rank < other.rank ? -1 : this.rank > other.rank ? 1 : 0;\n  }\n}\n\nconst ALL: readonly Refrigerant[] = [\n  Refrigerant.R12,\n  Refrigerant.R22,\n  Refrigerant.R32,\n  Refrigerant.R134a,\n  Refrigerant.R290,\n  Refrigerant.R404A,\n  Refrigerant.R407C,\n  Refrigerant.R407F,\n  Refrigerant.R410A,\n  Refrigerant.R448A,\n  Refrigerant.R449A,\n  Refrigerant.R452A,\n  Refrigerant.R507A,\n  Refrigerant.R513A,\n  Refrigerant.R600a,\n  Refrigerant.R717,\n  Refrigerant.R718,\n  Refrigerant.R744,\n  Refrigerant.R1234yf,\n  Refrigerant.R1234ze,\n  Refrigerant.R1233zd,\n  Refrigerant.R1270,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: RefrigerantFormatOptions,\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\nconst KEY_PATTERN = /[\\s\\-_]+/g;\n\nfunction normalizeLookupKey(value: string): string {\n  let folded = value.trim().toLowerCase();\n  folded = folded.replace(KEY_PATTERN, \"\");\n  return foldOrdinalIgnoreCase(folded);\n}\n\nconst ALIASES: readonly (readonly [Refrigerant, readonly string[]])[] = [\n  [Refrigerant.R12, [\"r12\"]],\n  [Refrigerant.R22, [\"r22\"]],\n  [Refrigerant.R32, [\"r32\"]],\n  [Refrigerant.R134a, [\"r134a\"]],\n  [Refrigerant.R290, [\"propan\", \"propane\", \"r290\"]],\n  [Refrigerant.R404A, [\"r404a\"]],\n  [Refrigerant.R407C, [\"r407c\"]],\n  [Refrigerant.R407F, [\"r407f\"]],\n  [Refrigerant.R410A, [\"r410a\"]],\n  [Refrigerant.R448A, [\"r448a\"]],\n  [Refrigerant.R449A, [\"r449a\"]],\n  [Refrigerant.R452A, [\"r452a\"]],\n  [Refrigerant.R507A, [\"r507a\"]],\n  [Refrigerant.R513A, [\"r513a\"]],\n  [Refrigerant.R600a, [\"isobutan\", \"isobutane\", \"r600a\"]],\n  [Refrigerant.R717, [\"ammonia\", \"ammoniak\", \"nh3\", \"r717\"]],\n  [Refrigerant.R718, [\"h2o\", \"r718\", \"vatten\", \"water\"]],\n  [Refrigerant.R744, [\"carbondioxide\", \"co2\", \"co\u2082\", \"koldioxid\", \"r744\"]],\n  [Refrigerant.R1234yf, [\"r1234yf\"]],\n  [Refrigerant.R1234ze, [\"r1234ze\"]],\n  [Refrigerant.R1233zd, [\"r1233zd\"]],\n  [Refrigerant.R1270, [\"propen\", \"propylene\", \"r1270\"]],\n];\n\nconst LOOKUP = new Map<string, Refrigerant>();\nfor (const [value, keys] of ALIASES) {\n  for (const key of keys) {\n    const folded = foldOrdinalIgnoreCase(key);\n    if (!LOOKUP.has(folded)) LOOKUP.set(folded, value);\n  }\n}\n\nconst SCAN_PATTERN = /(?<![\\p{L}\\p{N}_])R-?\\d{2,4}[A-Za-z]?(?![\\p{L}\\p{N}_])/giu;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/product/screen-resolution.js

@@ -0,0 +1,197 @@
+"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 screen_resolution_exports = {};
+__export(screen_resolution_exports, {
+  ScreenResolution: () => ScreenResolution
+});
+module.exports = __toCommonJS(screen_resolution_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_product_masking = require("./product-masking.js");
+const WIDTH_BY_HEIGHT_PATTERN = /^\s*(\d+)\s*[xX]\s*(\d+)\s*$/u;
+const SCAN_PATTERN = /(?<!\d)\d{3,5}\s*[xX]\s*\d{3,5}(?!\d)/gu;
+const MAX_INT32 = 2147483647;
+const PIXELS_BY_NAME = [
+  ["HD", 1280, 720],
+  ["720p", 1280, 720],
+  ["Full HD", 1920, 1080],
+  ["FHD", 1920, 1080],
+  ["1080p", 1920, 1080],
+  ["QHD", 2560, 1440],
+  ["WQHD", 2560, 1440],
+  ["1440p", 2560, 1440],
+  ["4K", 3840, 2160],
+  ["UHD", 3840, 2160],
+  ["2160p", 3840, 2160],
+  ["8K", 7680, 4320],
+  ["4320p", 7680, 4320],
+  ["WQXGA", 2560, 1600],
+  ["UWQHD", 3440, 1440]
+];
+const NAME_BY_PIXELS = /* @__PURE__ */ new Map([
+  ["1280x720", "HD"],
+  ["1920x1080", "Full HD"],
+  ["2560x1440", "QHD"],
+  ["3840x2160", "4K"],
+  ["7680x4320", "8K"],
+  ["1366x768", "HD"],
+  ["2560x1600", "WQXGA"],
+  ["3440x1440", "UWQHD"]
+]);
+const PIXELS_BY_NAME_KEY = new Map(
+  PIXELS_BY_NAME.map(([name, width, height]) => [name.toUpperCase(), [width, height]])
+);
+class ScreenResolution {
+  static typeInfo = Object.freeze({
+    englishName: "Screen Resolution",
+    localizedName: "Sk\xE4rmuppl\xF6sning",
+    emoji: "\u{1F4FA}",
+    sources: Object.freeze(["https://en.wikipedia.org/wiki/Display_resolution"])
+  });
+  /** Width in pixels. */
+  width;
+  /** Height in pixels. */
+  height;
+  /** Marketing name when this size is a known standard, e.g. `Full HD`, otherwise `null`. */
+  name;
+  /** Reduced aspect ratio, e.g. `16:9`. */
+  aspectRatio;
+  /** Normalized form with a lowercase `x`, e.g. `1920x1080`. */
+  value;
+  constructor(width, height) {
+    this.width = width;
+    this.height = height;
+    this.value = `${width}x${height}`;
+    this.name = NAME_BY_PIXELS.get(this.value) ?? null;
+    const divisor = greatestCommonDivisor(width, height);
+    this.aspectRatio = `${width / divisor}:${height / divisor}`;
+  }
+  /** Total pixel count, width times height. */
+  get totalPixels() {
+    return BigInt(this.width) * BigInt(this.height);
+  }
+  /** Builds a resolution from pixel dimensions, e.g. `create(1920, 1080)`. */
+  static create(width, height) {
+    if (!Number.isInteger(width) || width <= 0 || width > MAX_INT32) {
+      throw new RangeError("Width must be a positive Int32.");
+    }
+    if (!Number.isInteger(height) || height <= 0 || height > MAX_INT32) {
+      throw new RangeError("Height must be a positive Int32.");
+    }
+    return new ScreenResolution(width, height);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const text = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    const dimensions = WIDTH_BY_HEIGHT_PATTERN.exec(text);
+    if (dimensions !== null) {
+      const width = Number(dimensions[1]);
+      const height = Number(dimensions[2]);
+      try {
+        return ScreenResolution.create(width, height);
+      } catch (error) {
+        if (error instanceof RangeError) return null;
+        throw error;
+      }
+    }
+    const named = PIXELS_BY_NAME_KEY.get(text.toUpperCase());
+    return named === void 0 ? null : ScreenResolution.create(named[0], named[1]);
+  }
+  static parse(input) {
+    const result = ScreenResolution.tryParse(input);
+    if (result === null) throw new Error("Invalid screen resolution.");
+    return result;
+  }
+  static isValid(input) {
+    return ScreenResolution.tryParse(input) !== null;
+  }
+  /** Returns the marketing name when known, otherwise `1920 x 1080` with spaces. */
+  static format(input, options) {
+    const r = ScreenResolution.tryParse(input);
+    if (r !== null) return r.toString();
+    return fallback(input, options);
+  }
+  /** Returns the compact form, e.g. `1920x1080`. */
+  static normalize(input, options) {
+    const r = ScreenResolution.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && ScreenResolution.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for `WIDTHxHEIGHT` spans. The scan is heuristic and may match
+   * numbers that are not resolutions at all.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SCAN_PATTERN.exec(text)) !== null) {
+      const value = ScreenResolution.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "ScreenResolution",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskScreenResolution)(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.name ?? `${this.width} x ${this.height}`;
+  }
+  equals(other) {
+    return other != null && this.width === other.width && this.height === other.height;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.totalPixels < other.totalPixels ? -1 : this.totalPixels > other.totalPixels ? 1 : 0;
+  }
+}
+function greatestCommonDivisor(a, b) {
+  let left = a;
+  let right = b;
+  while (right !== 0) {
+    [left, right] = [right, left % right];
+  }
+  return left;
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=screen-resolution.js.map

package/dist/cjs/product/screen-resolution.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/screen-resolution.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.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 { maskScreenResolution } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface ScreenResolutionFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst WIDTH_BY_HEIGHT_PATTERN = /^\\s*(\\d+)\\s*[xX]\\s*(\\d+)\\s*$/u;\nconst SCAN_PATTERN = /(?<!\\d)\\d{3,5}\\s*[xX]\\s*\\d{3,5}(?!\\d)/gu;\nconst MAX_INT32 = 2_147_483_647;\n\n/** Marketing names accepted on input, including the ones that share pixel dimensions. */\nconst PIXELS_BY_NAME: readonly (readonly [string, number, number])[] = [\n  [\"HD\", 1280, 720],\n  [\"720p\", 1280, 720],\n  [\"Full HD\", 1920, 1080],\n  [\"FHD\", 1920, 1080],\n  [\"1080p\", 1920, 1080],\n  [\"QHD\", 2560, 1440],\n  [\"WQHD\", 2560, 1440],\n  [\"1440p\", 2560, 1440],\n  [\"4K\", 3840, 2160],\n  [\"UHD\", 3840, 2160],\n  [\"2160p\", 3840, 2160],\n  [\"8K\", 7680, 4320],\n  [\"4320p\", 7680, 4320],\n  [\"WQXGA\", 2560, 1600],\n  [\"UWQHD\", 3440, 1440],\n];\n\n/** The name reported back for a given size; 1366x768 is sold as HD even though it is not 720p. */\nconst NAME_BY_PIXELS: ReadonlyMap<string, string> = new Map([\n  [\"1280x720\", \"HD\"],\n  [\"1920x1080\", \"Full HD\"],\n  [\"2560x1440\", \"QHD\"],\n  [\"3840x2160\", \"4K\"],\n  [\"7680x4320\", \"8K\"],\n  [\"1366x768\", \"HD\"],\n  [\"2560x1600\", \"WQXGA\"],\n  [\"3440x1440\", \"UWQHD\"],\n]);\n\nconst PIXELS_BY_NAME_KEY: ReadonlyMap<string, readonly [number, number]> = new Map(\n  PIXELS_BY_NAME.map(([name, width, height]) => [name.toUpperCase(), [width, height] as const]),\n);\n\n/**\n * Pixel dimensions of a display or video mode (`sk\u00E4rmuppl\u00F6sning`), parsed either as `1920x1080`\n * or by a marketing name such as `Full HD` or `4K`.\n */\nexport class ScreenResolution {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Screen Resolution\",\n    localizedName: \"Sk\u00E4rmuppl\u00F6sning\",\n    emoji: \"\uD83D\uDCFA\",\n    sources: Object.freeze([\"https://en.wikipedia.org/wiki/Display_resolution\"]),\n  });\n\n  /** Width in pixels. */\n  readonly width: number;\n\n  /** Height in pixels. */\n  readonly height: number;\n\n  /** Marketing name when this size is a known standard, e.g. `Full HD`, otherwise `null`. */\n  readonly name: string | null;\n\n  /** Reduced aspect ratio, e.g. `16:9`. */\n  readonly aspectRatio: string;\n\n  /** Normalized form with a lowercase `x`, e.g. `1920x1080`. */\n  readonly value: string;\n\n  private constructor(width: number, height: number) {\n    this.width = width;\n    this.height = height;\n    this.value = `${width}x${height}`;\n    this.name = NAME_BY_PIXELS.get(this.value) ?? null;\n\n    const divisor = greatestCommonDivisor(width, height);\n    this.aspectRatio = `${width / divisor}:${height / divisor}`;\n  }\n\n  /** Total pixel count, width times height. */\n  get totalPixels(): bigint {\n    return BigInt(this.width) * BigInt(this.height);\n  }\n\n  /** Builds a resolution from pixel dimensions, e.g. `create(1920, 1080)`. */\n  static create(width: number, height: number): ScreenResolution {\n    if (!Number.isInteger(width) || width <= 0 || width > MAX_INT32) {\n      throw new RangeError(\"Width must be a positive Int32.\");\n    }\n    if (!Number.isInteger(height) || height <= 0 || height > MAX_INT32) {\n      throw new RangeError(\"Height must be a positive Int32.\");\n    }\n    return new ScreenResolution(width, height);\n  }\n\n  static tryParse(input: string | null | undefined): ScreenResolution | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const text = sanitizeInput(input).trim();\n\n    const dimensions = WIDTH_BY_HEIGHT_PATTERN.exec(text);\n    if (dimensions !== null) {\n      const width = Number(dimensions[1]);\n      const height = Number(dimensions[2]);\n      try {\n        return ScreenResolution.create(width, height);\n      } catch (error) {\n        if (error instanceof RangeError) return null;\n        throw error;\n      }\n    }\n\n    const named = PIXELS_BY_NAME_KEY.get(text.toUpperCase());\n    return named === undefined ? null : ScreenResolution.create(named[0], named[1]);\n  }\n\n  static parse(input: string): ScreenResolution {\n    const result = ScreenResolution.tryParse(input);\n    if (result === null) throw new Error(\"Invalid screen resolution.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return ScreenResolution.tryParse(input) !== null;\n  }\n\n  /** Returns the marketing name when known, otherwise `1920 x 1080` with spaces. */\n  static format(\n    input: string | null | undefined,\n    options?: ScreenResolutionFormatOptions,\n  ): string | null {\n    const r = ScreenResolution.tryParse(input);\n    if (r !== null) return r.toString();\n    return fallback(input, options);\n  }\n\n  /** Returns the compact form, e.g. `1920x1080`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: ScreenResolutionFormatOptions,\n  ): string | null {\n    const r = ScreenResolution.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 && ScreenResolution.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for `WIDTHxHEIGHT` spans. The scan is heuristic and may match\n   * numbers that are not resolutions at all.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<ScreenResolution>[] {\n    if (!text) return [];\n    const out: TextCandidate<ScreenResolution>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = ScreenResolution.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<ScreenResolution>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"ScreenResolution\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskScreenResolution(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return this.name ?? `${this.width} x ${this.height}`;\n  }\n\n  equals(other: ScreenResolution | null | undefined): boolean {\n    return other != null && this.width === other.width && this.height === other.height;\n  }\n\n  compareTo(other: ScreenResolution | null | undefined): number {\n    if (other == null) return 1;\n    return this.totalPixels < other.totalPixels ? -1 : this.totalPixels > other.totalPixels ? 1 : 0;\n  }\n}\n\nfunction greatestCommonDivisor(a: number, b: number): number {\n  let left = a;\n  let right = b;\n  while (right !== 0) {\n    [left, right] = [right, left % right];\n  }\n  return left;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: ScreenResolutionFormatOptions,\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/screen-size.js

@@ -0,0 +1,184 @@
+"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 screen_size_exports = {};
+__export(screen_size_exports, {
+  ScreenSize: () => ScreenSize
+});
+module.exports = __toCommonJS(screen_size_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_measurement_unit_parser = require("../internal/measurement-unit-parser.js");
+var import_quantity = require("../internal/quantity.js");
+var import_length = require("../measurement/length.js");
+var import_length_unit = require("../measurement/length-unit.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_product_masking = require("./product-masking.js");
+const INCH_HYPHEN_PATTERN = /^\s*([+-])?\s*([0-9][0-9 .,]*[0-9]|[0-9])\s*-\s*inch(?:es)?\s*$/iu;
+const INCH_SYMBOL_PATTERN = /^\s*([0-9][0-9 .,]*[0-9]|[0-9])\s*(?:"|\u2033|'')\s*$/u;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])\d+[0-9.,]*\s*(?:"|\u2033|''|-\s*inch(?:es)?)(?![\p{L}\p{N}_])/giu;
+class ScreenSize {
+  static typeInfo = Object.freeze({
+    englishName: "Screen Size",
+    localizedName: "Sk\xE4rmstorlek",
+    emoji: "\u{1F5A5}\uFE0F",
+    sources: Object.freeze(["https://en.wikipedia.org/wiki/Display_size"])
+  });
+  /** The underlying length value. */
+  diagonal;
+  /** Normalized form in inches, e.g. `15 in`. */
+  value;
+  constructor(diagonal) {
+    this.diagonal = diagonal;
+    this.value = `${(0, import_quantity.formatQuantityDecimal)(diagonal.inDecimal(import_length_unit.LengthUnit.Inch))} in`;
+  }
+  /** Diagonal in inches, e.g. `15` for a 15-inch panel. */
+  get inches() {
+    return this.diagonal.inches;
+  }
+  /** Diagonal in centimetres. */
+  get centimeters() {
+    return this.diagonal.centimeters;
+  }
+  /** Builds a screen size from a value and a length unit. The value must be positive. */
+  static create(value, unit) {
+    const diagonal = import_length.Length.create(value, unit);
+    if (diagonal.inDecimal(import_length_unit.LengthUnit.Inch).compareTo(import_decimal.Decimal.zero) <= 0) {
+      throw new RangeError("Screen size must be positive.");
+    }
+    return new ScreenSize(diagonal);
+  }
+  /** Builds a screen size from inches, e.g. `fromInches(15.6)`. */
+  static fromInches(inches) {
+    return ScreenSize.create(inches, import_length_unit.LengthUnit.Inch);
+  }
+  /** Builds a screen size from centimetres, e.g. `fromCentimeters(39.6)`. */
+  static fromCentimeters(centimeters) {
+    return ScreenSize.create(centimeters, import_length_unit.LengthUnit.Centimeter);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const text = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    const bare = (0, import_measurement_unit_parser.tryParseNumberOnly)(text);
+    if (bare !== null && bare.compareTo(import_decimal.Decimal.zero) > 0) {
+      return new ScreenSize(import_length.Length.fromInches(bare));
+    }
+    const symbol = INCH_SYMBOL_PATTERN.exec(text);
+    if (symbol !== null) {
+      const inches = (0, import_measurement_unit_parser.tryParseNumberOnly)(symbol[1]);
+      if (inches === null || inches.compareTo(import_decimal.Decimal.zero) <= 0) return null;
+      return new ScreenSize(import_length.Length.fromInches(inches));
+    }
+    const hyphen = INCH_HYPHEN_PATTERN.exec(text);
+    if (hyphen !== null) {
+      const parsed = (0, import_measurement_unit_parser.tryParseNumberOnly)(hyphen[2]);
+      if (parsed === null) return null;
+      const inches = hyphen[1] === "-" ? parsed.negated() : parsed;
+      if (inches.compareTo(import_decimal.Decimal.zero) <= 0) return null;
+      return new ScreenSize(import_length.Length.fromInches(inches));
+    }
+    const length = import_length.Length.tryParse(text);
+    if (length === null || length.inDecimal(import_length_unit.LengthUnit.Inch).compareTo(import_decimal.Decimal.zero) <= 0)
+      return null;
+    return new ScreenSize(length);
+  }
+  static parse(input) {
+    const result = ScreenSize.tryParse(input);
+    if (result === null) throw new Error("Invalid screen size.");
+    return result;
+  }
+  static isValid(input) {
+    return ScreenSize.tryParse(input) !== null;
+  }
+  /** Returns the display form, e.g. `15 in`, or the diagonal converted to `options.unit`. */
+  static format(input, options) {
+    const r = ScreenSize.tryParse(input);
+    if (r !== null) {
+      if (options?.unit !== void 0)
+        return r.diagonal.toStringInUnit(options.unit, options.decimals);
+      if (options?.decimals !== void 0) {
+        const inches = r.diagonal.inDecimal(import_length_unit.LengthUnit.Inch);
+        return `${(0, import_quantity.formatQuantityDecimal)(inches, options.decimals)} in`;
+      }
+      return r.value;
+    }
+    return fallback(input, options);
+  }
+  /** Returns the normalized form in inches, e.g. `15 in`. */
+  static normalize(input, options) {
+    const formatted = ScreenSize.format(input);
+    if (formatted !== null) return formatted;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && ScreenSize.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for inch notation such as `55"`, `55″` or `55-inch`. The scan is
+   * heuristic and may produce false positives.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SCAN_PATTERN.exec(text)) !== null) {
+      const value = ScreenSize.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "ScreenSize",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskScreenSize)(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.exactInches.equals(other.exactInches);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.exactInches.compareTo(other.exactInches);
+  }
+  get exactInches() {
+    return this.diagonal.inDecimal(import_length_unit.LengthUnit.Inch);
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=screen-size.js.map

package/dist/cjs/product/screen-size.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/screen-size.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { tryParseNumberOnly } from \"../internal/measurement-unit-parser.js\";\nimport { formatQuantityDecimal } from \"../internal/quantity.js\";\nimport { Length } from \"../measurement/length.js\";\nimport { LengthUnit } from \"../measurement/length-unit.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.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 { maskScreenSize } from \"./product-masking.js\";\n\n/** Options for {@link ScreenSize.format}. */\nexport interface ScreenSizeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of displaying inches. */\n  unit?: LengthUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst INCH_HYPHEN_PATTERN = /^\\s*([+-])?\\s*([0-9][0-9 .,]*[0-9]|[0-9])\\s*-\\s*inch(?:es)?\\s*$/iu;\nconst INCH_SYMBOL_PATTERN = /^\\s*([0-9][0-9 .,]*[0-9]|[0-9])\\s*(?:\"|\\u2033|'')\\s*$/u;\nconst SCAN_PATTERN =\n  /(?<![\\p{L}\\p{N}_])\\d+[0-9.,]*\\s*(?:\"|\\u2033|''|-\\s*inch(?:es)?)(?![\\p{L}\\p{N}_])/giu;\n\n/**\n * Display diagonal (`sk\u00E4rmstorlek`) held as a {@link Length}. A bare number is read as inches, so\n * `15` and `15\"` and `15-inch` all mean the same panel.\n */\nexport class ScreenSize {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Screen Size\",\n    localizedName: \"Sk\u00E4rmstorlek\",\n    emoji: \"\uD83D\uDDA5\uFE0F\",\n    sources: Object.freeze([\"https://en.wikipedia.org/wiki/Display_size\"]),\n  });\n\n  /** The underlying length value. */\n  readonly diagonal: Length;\n\n  /** Normalized form in inches, e.g. `15 in`. */\n  readonly value: string;\n\n  private constructor(diagonal: Length) {\n    this.diagonal = diagonal;\n    this.value = `${formatQuantityDecimal(diagonal.inDecimal(LengthUnit.Inch))} in`;\n  }\n\n  /** Diagonal in inches, e.g. `15` for a 15-inch panel. */\n  get inches(): number {\n    return this.diagonal.inches;\n  }\n\n  /** Diagonal in centimetres. */\n  get centimeters(): number {\n    return this.diagonal.centimeters;\n  }\n\n  /** Builds a screen size from a value and a length unit. The value must be positive. */\n  static create(value: number | Decimal, unit: LengthUnit): ScreenSize {\n    const diagonal = Length.create(value, unit);\n    if (diagonal.inDecimal(LengthUnit.Inch).compareTo(Decimal.zero) <= 0) {\n      throw new RangeError(\"Screen size must be positive.\");\n    }\n    return new ScreenSize(diagonal);\n  }\n\n  /** Builds a screen size from inches, e.g. `fromInches(15.6)`. */\n  static fromInches(inches: number | Decimal): ScreenSize {\n    return ScreenSize.create(inches, LengthUnit.Inch);\n  }\n\n  /** Builds a screen size from centimetres, e.g. `fromCentimeters(39.6)`. */\n  static fromCentimeters(centimeters: number | Decimal): ScreenSize {\n    return ScreenSize.create(centimeters, LengthUnit.Centimeter);\n  }\n\n  static tryParse(input: string | null | undefined): ScreenSize | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const text = sanitizeInput(input).trim();\n\n    const bare = tryParseNumberOnly(text);\n    if (bare !== null && bare.compareTo(Decimal.zero) > 0) {\n      return new ScreenSize(Length.fromInches(bare));\n    }\n\n    const symbol = INCH_SYMBOL_PATTERN.exec(text);\n    if (symbol !== null) {\n      const inches = tryParseNumberOnly(symbol[1]!);\n      if (inches === null || inches.compareTo(Decimal.zero) <= 0) return null;\n      return new ScreenSize(Length.fromInches(inches));\n    }\n\n    const hyphen = INCH_HYPHEN_PATTERN.exec(text);\n    if (hyphen !== null) {\n      const parsed = tryParseNumberOnly(hyphen[2]!);\n      if (parsed === null) return null;\n      const inches = hyphen[1] === \"-\" ? parsed.negated() : parsed;\n      if (inches.compareTo(Decimal.zero) <= 0) return null;\n      return new ScreenSize(Length.fromInches(inches));\n    }\n\n    const length = Length.tryParse(text);\n    if (length === null || length.inDecimal(LengthUnit.Inch).compareTo(Decimal.zero) <= 0)\n      return null;\n    return new ScreenSize(length);\n  }\n\n  static parse(input: string): ScreenSize {\n    const result = ScreenSize.tryParse(input);\n    if (result === null) throw new Error(\"Invalid screen size.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return ScreenSize.tryParse(input) !== null;\n  }\n\n  /** Returns the display form, e.g. `15 in`, or the diagonal converted to `options.unit`. */\n  static format(\n    input: string | null | undefined,\n    options?: ScreenSizeFormatOptions,\n  ): string | null {\n    const r = ScreenSize.tryParse(input);\n    if (r !== null) {\n      if (options?.unit !== undefined)\n        return r.diagonal.toStringInUnit(options.unit, options.decimals);\n      if (options?.decimals !== undefined) {\n        const inches = r.diagonal.inDecimal(LengthUnit.Inch);\n        return `${formatQuantityDecimal(inches, options.decimals)} in`;\n      }\n      return r.value;\n    }\n    return fallback(input, options);\n  }\n\n  /** Returns the normalized form in inches, e.g. `15 in`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: ScreenSizeFormatOptions,\n  ): string | null {\n    const formatted = ScreenSize.format(input);\n    if (formatted !== null) return formatted;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && ScreenSize.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for inch notation such as `55\"`, `55\u2033` or `55-inch`. The scan is\n   * heuristic and may produce false positives.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<ScreenSize>[] {\n    if (!text) return [];\n    const out: TextCandidate<ScreenSize>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = ScreenSize.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<ScreenSize>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"ScreenSize\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskScreenSize(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  equals(other: ScreenSize | null | undefined): boolean {\n    return other != null && this.exactInches.equals(other.exactInches);\n  }\n\n  compareTo(other: ScreenSize | null | undefined): number {\n    if (other == null) return 1;\n    return this.exactInches.compareTo(other.exactInches);\n  }\n\n  private get exactInches(): Decimal {\n    return this.diagonal.inDecimal(LengthUnit.Inch);\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: ScreenSizeFormatOptions,\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/shoe-size-system.js

@@ -0,0 +1,31 @@
+"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 shoe_size_system_exports = {};
+__export(shoe_size_system_exports, {
+  ShoeSizeSystem: () => ShoeSizeSystem
+});
+module.exports = __toCommonJS(shoe_size_system_exports);
+const ShoeSizeSystem = {
+  Unknown: 0,
+  EU: 1,
+  USMen: 2,
+  USWomen: 3,
+  UK: 4
+};
+//# sourceMappingURL=shoe-size-system.js.map

package/dist/cjs/product/shoe-size-system.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/shoe-size-system.ts"],
+  "sourcesContent": ["/** Sizing system a parsed shoe size was expressed in. */\nexport const ShoeSizeSystem = {\n  Unknown: 0,\n  EU: 1,\n  USMen: 2,\n  USWomen: 3,\n  UK: 4,\n} as const;\n\nexport type ShoeSizeSystem = (typeof ShoeSizeSystem)[keyof typeof ShoeSizeSystem];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,MAAM,iBAAiB;AAAA,EAC5B,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,SAAS;AAAA,EACT,IAAI;AACN;",
+  "names": []
+}