@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/cjs/product/ip-rating.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/ip-rating.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 { maskIpRating } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface IpRatingFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst PARSE_PATTERN = /^\\s*[Ii][Pp]\\s*[-/]?\\s*([0-6Xx])\\s*([0-9Xx])\\s*$/u;\nconst SCAN_PATTERN = /(?<![\\p{L}\\p{N}_])IP\\s*[-/]?\\s*[0-6Xx][0-9Xx](?![\\p{L}\\p{N}_])/giu;\n\nconst SOLIDS_DESCRIPTIONS: Readonly<Record<string, string>> = {\n  X: \"Not tested\",\n  \"0\": \"No protection\",\n  \"1\": \"Objects >50 mm\",\n  \"2\": \"Objects >12.5 mm\",\n  \"3\": \"Objects >2.5 mm\",\n  \"4\": \"Objects >1 mm\",\n  \"5\": \"Dust protected\",\n  \"6\": \"Dust tight\",\n};\n\nconst LIQUIDS_DESCRIPTIONS: Readonly<Record<string, string>> = {\n  X: \"Not tested\",\n  \"0\": \"No protection\",\n  \"1\": \"Dripping water\",\n  \"2\": \"Dripping water (15\u00B0 tilted)\",\n  \"3\": \"Spraying water\",\n  \"4\": \"Splashing water\",\n  \"5\": \"Water jets\",\n  \"6\": \"Powerful water jets\",\n  \"7\": \"Temporary immersion\",\n  \"8\": \"Continuous immersion\",\n  \"9\": \"High-pressure/steam cleaning\",\n};\n\n/**\n * Ingress Protection rating (`kapslingsklass`, `IP-klass`) per IEC 60529, e.g. `IP65` or `IPX4`,\n * where the first digit rates protection against solids and the second against liquids. An `X`\n * in either position means that level was not tested.\n */\nexport class IpRating {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"IP Rating\",\n    localizedName: \"IP-klass\",\n    emoji: \"\uD83D\uDEE1\uFE0F\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/IP_code\",\n      \"https://webstore.iec.ch/en/publication/2452\",\n    ]),\n  });\n\n  /** Solids protection, a single character `0`\u2013`6` or `X`. */\n  readonly solidsProtection: string;\n\n  /** Liquids protection, a single character `0`\u2013`9` or `X`. */\n  readonly liquidsProtection: string;\n\n  /** Normalized code, e.g. `IP65`. */\n  readonly value: string;\n\n  private constructor(solidsProtection: string, liquidsProtection: string) {\n    this.solidsProtection = solidsProtection;\n    this.liquidsProtection = liquidsProtection;\n    this.value = `IP${solidsProtection}${liquidsProtection}`;\n  }\n\n  /** English description of the solids level, e.g. `Dust tight`. */\n  get solidsDescription(): string {\n    return SOLIDS_DESCRIPTIONS[this.solidsProtection] ?? \"Unknown\";\n  }\n\n  /** English description of the liquids level, e.g. `Water jets`. */\n  get liquidsDescription(): string {\n    return LIQUIDS_DESCRIPTIONS[this.liquidsProtection] ?? \"Unknown\";\n  }\n\n  static tryParse(input: string | null | undefined): IpRating | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const match = PARSE_PATTERN.exec(sanitizeInput(input).trim());\n    if (match === null) return null;\n\n    return new IpRating(match[1]!.toUpperCase(), match[2]!.toUpperCase());\n  }\n\n  static parse(input: string): IpRating {\n    const result = IpRating.tryParse(input);\n    if (result === null) throw new Error(\"Invalid IP rating.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return IpRating.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical form, e.g. `IP65`. */\n  static format(input: string | null | undefined, options?: IpRatingFormatOptions): string | null {\n    const r = IpRating.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical form, e.g. `IP65`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: IpRatingFormatOptions,\n  ): string | null {\n    const r = IpRating.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 && IpRating.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for IP ratings such as `IP65`. The `IP` prefix makes matches fairly\n   * distinctive, but the scan stays heuristic and may produce false positives.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<IpRating>[] {\n    if (!text) return [];\n    const out: TextCandidate<IpRating>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = IpRating.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<IpRating>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"IpRating\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskIpRating(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: IpRating | null | undefined): boolean {\n    return (\n      other != null &&\n      this.solidsProtection === other.solidsProtection &&\n      this.liquidsProtection === other.liquidsProtection\n    );\n  }\n\n  compareTo(other: IpRating | null | undefined): number {\n    if (other == null) return 1;\n    const solids = compareChars(this.solidsProtection, other.solidsProtection);\n    return solids !== 0 ? solids : compareChars(this.liquidsProtection, other.liquidsProtection);\n  }\n}\n\n/** Compares by code point, the way .NET compares two `char` values. */\nfunction compareChars(a: string, b: string): number {\n  const left = a.charCodeAt(0);\n  const right = b.charCodeAt(0);\n  return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: IpRatingFormatOptions,\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/operating-system-family.js

@@ -0,0 +1,37 @@
+"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 operating_system_family_exports = {};
+__export(operating_system_family_exports, {
+  OperatingSystemFamily: () => OperatingSystemFamily
+});
+module.exports = __toCommonJS(operating_system_family_exports);
+const OperatingSystemFamily = {
+  Unknown: 0,
+  Windows: 1,
+  MacOS: 2,
+  Linux: 3,
+  Android: 4,
+  IOS: 5,
+  IPadOS: 6,
+  ChromeOS: 7,
+  WatchOS: 8,
+  Other: 9,
+  None: 10
+};
+//# sourceMappingURL=operating-system-family.js.map

package/dist/cjs/product/operating-system-family.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/operating-system-family.ts"],
+  "sourcesContent": ["/** The family a recognized operating system name belongs to. */\nexport const OperatingSystemFamily = {\n  Unknown: 0,\n  Windows: 1,\n  MacOS: 2,\n  Linux: 3,\n  Android: 4,\n  IOS: 5,\n  IPadOS: 6,\n  ChromeOS: 7,\n  WatchOS: 8,\n  Other: 9,\n  None: 10,\n} as const;\n\nexport type OperatingSystemFamily =\n  (typeof OperatingSystemFamily)[keyof typeof OperatingSystemFamily];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,MAAM,wBAAwB;AAAA,EACnC,SAAS;AAAA,EACT,SAAS;AAAA,EACT,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,SAAS;AAAA,EACT,OAAO;AAAA,EACP,MAAM;AACR;",
+  "names": []
+}

package/dist/cjs/product/operating-system-info.js

@@ -0,0 +1,100 @@
+"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 operating_system_info_exports = {};
+__export(operating_system_info_exports, {
+  OperatingSystemInfo: () => OperatingSystemInfo
+});
+module.exports = __toCommonJS(operating_system_info_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_operating_system_name = require("./operating-system-name.js");
+var import_operating_system_version = require("./operating-system-version.js");
+class OperatingSystemInfo {
+  static typeInfo = Object.freeze({
+    englishName: "Operating System",
+    localizedName: "Operativsystem",
+    emoji: "\u{1F4BB}",
+    sources: Object.freeze([])
+  });
+  /** The operating system name. */
+  name;
+  /** The version when the input carried one, otherwise `null`. */
+  version;
+  /** Display form, e.g. `Windows 11`. */
+  value;
+  constructor(name, version) {
+    this.name = name;
+    this.version = version;
+    this.value = version === null ? name.value : `${name.value} ${version.value}`;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const text = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    for (let i = text.length; i >= 1; i--) {
+      const name = import_operating_system_name.OperatingSystemName.tryParse(text.slice(0, i).trimEnd());
+      if (name === null) continue;
+      const rest = text.slice(i).trim();
+      if (rest.length === 0) return new OperatingSystemInfo(name, null);
+      const version = import_operating_system_version.OperatingSystemVersion.tryParse(rest);
+      if (version !== null) return new OperatingSystemInfo(name, version);
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = OperatingSystemInfo.tryParse(input);
+    if (result === null) throw new Error("Invalid operating system.");
+    return result;
+  }
+  static isValid(input) {
+    return OperatingSystemInfo.tryParse(input) !== null;
+  }
+  /** Returns the canonical display form, e.g. `Windows 11`. */
+  static format(input, options) {
+    const r = OperatingSystemInfo.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical display form, e.g. `Windows 11`. */
+  static normalize(input, options) {
+    const r = OperatingSystemInfo.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && OperatingSystemInfo.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=operating-system-info.js.map

package/dist/cjs/product/operating-system-info.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/operating-system-info.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { OperatingSystemName } from \"./operating-system-name.js\";\nimport { OperatingSystemVersion } from \"./operating-system-version.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface OperatingSystemInfoFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\n/**\n * An operating system name with an optional version, e.g. `Windows 11`, `macOS 14.5` or\n * `Ubuntu 22.04`. The name is matched greedily from the longest prefix, so multi-word names such\n * as `Arch Linux` are not mistaken for a shorter one followed by a version.\n */\nexport class OperatingSystemInfo {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Operating System\",\n    localizedName: \"Operativsystem\",\n    emoji: \"\uD83D\uDCBB\",\n    sources: Object.freeze([]),\n  });\n\n  /** The operating system name. */\n  readonly name: OperatingSystemName;\n\n  /** The version when the input carried one, otherwise `null`. */\n  readonly version: OperatingSystemVersion | null;\n\n  /** Display form, e.g. `Windows 11`. */\n  readonly value: string;\n\n  private constructor(name: OperatingSystemName, version: OperatingSystemVersion | null) {\n    this.name = name;\n    this.version = version;\n    this.value = version === null ? name.value : `${name.value} ${version.value}`;\n  }\n\n  static tryParse(input: string | null | undefined): OperatingSystemInfo | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const text = sanitizeInput(input).trim();\n\n    for (let i = text.length; i >= 1; i--) {\n      const name = OperatingSystemName.tryParse(text.slice(0, i).trimEnd());\n      if (name === null) continue;\n\n      const rest = text.slice(i).trim();\n      if (rest.length === 0) return new OperatingSystemInfo(name, null);\n\n      const version = OperatingSystemVersion.tryParse(rest);\n      if (version !== null) return new OperatingSystemInfo(name, version);\n    }\n\n    return null;\n  }\n\n  static parse(input: string): OperatingSystemInfo {\n    const result = OperatingSystemInfo.tryParse(input);\n    if (result === null) throw new Error(\"Invalid operating system.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return OperatingSystemInfo.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical display form, e.g. `Windows 11`. */\n  static format(\n    input: string | null | undefined,\n    options?: OperatingSystemInfoFormatOptions,\n  ): string | null {\n    const r = OperatingSystemInfo.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical display form, e.g. `Windows 11`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: OperatingSystemInfoFormatOptions,\n  ): string | null {\n    const r = OperatingSystemInfo.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 && OperatingSystemInfo.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: OperatingSystemInfo | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: OperatingSystemInfo | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: OperatingSystemInfoFormatOptions,\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": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAA8B;AAE9B,mCAAoC;AACpC,sCAAuC;AAahC,MAAM,oBAAoB;AAAA,EAC/B,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EAC3B,CAAC;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAED,YAAY,MAA2B,SAAwC;AACrF,SAAK,OAAO;AACZ,SAAK,UAAU;AACf,SAAK,QAAQ,YAAY,OAAO,KAAK,QAAQ,GAAG,KAAK,KAAK,IAAI,QAAQ,KAAK;AAAA,EAC7E;AAAA,EAEA,OAAO,SAAS,OAA8D;AAC5E,QAAI,SAAS,QAAQ,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AAEvD,UAAM,WAAO,yCAAc,KAAK,EAAE,KAAK;AAEvC,aAAS,IAAI,KAAK,QAAQ,KAAK,GAAG,KAAK;AACrC,YAAM,OAAO,iDAAoB,SAAS,KAAK,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC;AACpE,UAAI,SAAS,KAAM;AAEnB,YAAM,OAAO,KAAK,MAAM,CAAC,EAAE,KAAK;AAChC,UAAI,KAAK,WAAW,EAAG,QAAO,IAAI,oBAAoB,MAAM,IAAI;AAEhE,YAAM,UAAU,uDAAuB,SAAS,IAAI;AACpD,UAAI,YAAY,KAAM,QAAO,IAAI,oBAAoB,MAAM,OAAO;AAAA,IACpE;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAAM,OAAoC;AAC/C,UAAM,SAAS,oBAAoB,SAAS,KAAK;AACjD,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,2BAA2B;AAChE,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,oBAAoB,SAAS,KAAK,MAAM;AAAA,EACjD;AAAA;AAAA,EAGA,OAAO,OACL,OACA,SACe;AACf,UAAM,IAAI,oBAAoB,SAAS,KAAK;AAC5C,QAAI,MAAM,KAAM,QAAO,EAAE;AACzB,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA;AAAA,EAGA,OAAO,UACL,OACA,SACe;AACf,UAAM,IAAI,oBAAoB,SAAS,KAAK;AAC5C,QAAI,MAAM,KAAM,QAAO,EAAE;AACzB,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,oBAAoB,UAAU,KAAK,MAAM;AAAA,EACnE;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAwD;AAC7D,WAAO,SAAS,QAAQ,KAAK,UAAU,MAAM;AAAA,EAC/C;AAAA,EAEA,UAAU,OAAuD;AAC/D,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,QAAQ,MAAM,QAAQ,KAAK,KAAK,QAAQ,MAAM,QAAQ,IAAI;AAAA,EACxE;AACF;AAEA,SAAS,SACP,OACA,SACe;AACf,MAAI,SAAS,sCAAsC,QAAQ,SAAS,KAAM,QAAO;AACjF,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;",
+  "names": []
+}

package/dist/cjs/product/operating-system-name.js

@@ -0,0 +1,127 @@
+"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 operating_system_name_exports = {};
+__export(operating_system_name_exports, {
+  OperatingSystemName: () => OperatingSystemName
+});
+module.exports = __toCommonJS(operating_system_name_exports);
+var import_case_folding = require("../internal/case-folding.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_operating_system_family = require("./operating-system-family.js");
+const KNOWN_SYSTEMS = [
+  ["None", import_operating_system_family.OperatingSystemFamily.None, ["no os", "without os", "inget os", "inget operativsystem"]],
+  ["Windows", import_operating_system_family.OperatingSystemFamily.Windows, ["win", "microsoft windows", "ms windows"]],
+  ["macOS", import_operating_system_family.OperatingSystemFamily.MacOS, ["macos", "mac os", "mac os x", "os x", "osx", "mac"]],
+  ["Linux", import_operating_system_family.OperatingSystemFamily.Linux, []],
+  ["Ubuntu", import_operating_system_family.OperatingSystemFamily.Linux, ["ubuntu linux"]],
+  ["Debian", import_operating_system_family.OperatingSystemFamily.Linux, ["debian linux"]],
+  ["Fedora", import_operating_system_family.OperatingSystemFamily.Linux, ["fedora linux"]],
+  ["CentOS", import_operating_system_family.OperatingSystemFamily.Linux, ["centos linux"]],
+  ["Red Hat", import_operating_system_family.OperatingSystemFamily.Linux, ["rhel", "red hat enterprise linux", "redhat"]],
+  ["SUSE", import_operating_system_family.OperatingSystemFamily.Linux, ["suse linux"]],
+  ["openSUSE", import_operating_system_family.OperatingSystemFamily.Linux, ["opensuse linux"]],
+  ["Arch Linux", import_operating_system_family.OperatingSystemFamily.Linux, ["arch"]],
+  ["Linux Mint", import_operating_system_family.OperatingSystemFamily.Linux, ["mint"]],
+  ["Manjaro", import_operating_system_family.OperatingSystemFamily.Linux, ["manjaro linux"]],
+  ["Gentoo", import_operating_system_family.OperatingSystemFamily.Linux, ["gentoo linux"]],
+  ["Alpine", import_operating_system_family.OperatingSystemFamily.Linux, ["alpine linux"]],
+  ["Android", import_operating_system_family.OperatingSystemFamily.Android, []],
+  ["iOS", import_operating_system_family.OperatingSystemFamily.IOS, ["iphone os"]],
+  ["iPadOS", import_operating_system_family.OperatingSystemFamily.IPadOS, ["ipad os"]],
+  ["ChromeOS", import_operating_system_family.OperatingSystemFamily.ChromeOS, ["chrome os", "chromeos"]],
+  ["watchOS", import_operating_system_family.OperatingSystemFamily.WatchOS, ["watch os"]],
+  ["tvOS", import_operating_system_family.OperatingSystemFamily.Other, ["tv os"]],
+  ["FreeBSD", import_operating_system_family.OperatingSystemFamily.Other, []],
+  ["Unix", import_operating_system_family.OperatingSystemFamily.Other, []],
+  ["Solaris", import_operating_system_family.OperatingSystemFamily.Other, []],
+  ["HarmonyOS", import_operating_system_family.OperatingSystemFamily.Other, ["harmony os"]]
+];
+const LOOKUP = /* @__PURE__ */ new Map();
+class OperatingSystemName {
+  static typeInfo = Object.freeze({
+    englishName: "Operating System Name",
+    localizedName: "Operativsystemnamn",
+    emoji: "\u{1F4BB}",
+    sources: Object.freeze([])
+  });
+  /** The canonical name, e.g. `macOS`. */
+  value;
+  /** The family this name belongs to. */
+  family;
+  constructor(value, family) {
+    this.value = value;
+    this.family = family;
+  }
+  static {
+    for (const [canonical, family, aliases] of KNOWN_SYSTEMS) {
+      const instance = new OperatingSystemName(canonical, family);
+      LOOKUP.set((0, import_case_folding.foldOrdinalIgnoreCase)(canonical), instance);
+      for (const alias of aliases) {
+        const key = (0, import_case_folding.foldOrdinalIgnoreCase)(alias);
+        if (!LOOKUP.has(key)) LOOKUP.set(key, instance);
+      }
+    }
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    return LOOKUP.get((0, import_case_folding.foldOrdinalIgnoreCase)((0, import_input_sanitization.sanitizeInput)(input).trim())) ?? null;
+  }
+  static parse(input) {
+    const result = OperatingSystemName.tryParse(input);
+    if (result === null) throw new Error("Unknown operating system name.");
+    return result;
+  }
+  static isValid(input) {
+    return OperatingSystemName.tryParse(input) !== null;
+  }
+  /** Returns the canonical name, e.g. `macOS`. */
+  static format(input, options) {
+    const r = OperatingSystemName.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical name, e.g. `macOS`. */
+  static normalize(input, options) {
+    const r = OperatingSystemName.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && OperatingSystemName.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=operating-system-name.js.map

package/dist/cjs/product/operating-system-name.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/operating-system-name.ts"],
+  "sourcesContent": ["import { foldOrdinalIgnoreCase } from \"../internal/case-folding.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { OperatingSystemFamily } from \"./operating-system-family.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface OperatingSystemNameFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\n/** Canonical name, family and the aliases that resolve to it. */\nconst KNOWN_SYSTEMS: readonly (readonly [string, OperatingSystemFamily, readonly string[]])[] = [\n  [\"None\", OperatingSystemFamily.None, [\"no os\", \"without os\", \"inget os\", \"inget operativsystem\"]],\n  [\"Windows\", OperatingSystemFamily.Windows, [\"win\", \"microsoft windows\", \"ms windows\"]],\n  [\"macOS\", OperatingSystemFamily.MacOS, [\"macos\", \"mac os\", \"mac os x\", \"os x\", \"osx\", \"mac\"]],\n  [\"Linux\", OperatingSystemFamily.Linux, []],\n  [\"Ubuntu\", OperatingSystemFamily.Linux, [\"ubuntu linux\"]],\n  [\"Debian\", OperatingSystemFamily.Linux, [\"debian linux\"]],\n  [\"Fedora\", OperatingSystemFamily.Linux, [\"fedora linux\"]],\n  [\"CentOS\", OperatingSystemFamily.Linux, [\"centos linux\"]],\n  [\"Red Hat\", OperatingSystemFamily.Linux, [\"rhel\", \"red hat enterprise linux\", \"redhat\"]],\n  [\"SUSE\", OperatingSystemFamily.Linux, [\"suse linux\"]],\n  [\"openSUSE\", OperatingSystemFamily.Linux, [\"opensuse linux\"]],\n  [\"Arch Linux\", OperatingSystemFamily.Linux, [\"arch\"]],\n  [\"Linux Mint\", OperatingSystemFamily.Linux, [\"mint\"]],\n  [\"Manjaro\", OperatingSystemFamily.Linux, [\"manjaro linux\"]],\n  [\"Gentoo\", OperatingSystemFamily.Linux, [\"gentoo linux\"]],\n  [\"Alpine\", OperatingSystemFamily.Linux, [\"alpine linux\"]],\n  [\"Android\", OperatingSystemFamily.Android, []],\n  [\"iOS\", OperatingSystemFamily.IOS, [\"iphone os\"]],\n  [\"iPadOS\", OperatingSystemFamily.IPadOS, [\"ipad os\"]],\n  [\"ChromeOS\", OperatingSystemFamily.ChromeOS, [\"chrome os\", \"chromeos\"]],\n  [\"watchOS\", OperatingSystemFamily.WatchOS, [\"watch os\"]],\n  [\"tvOS\", OperatingSystemFamily.Other, [\"tv os\"]],\n  [\"FreeBSD\", OperatingSystemFamily.Other, []],\n  [\"Unix\", OperatingSystemFamily.Other, []],\n  [\"Solaris\", OperatingSystemFamily.Other, []],\n  [\"HarmonyOS\", OperatingSystemFamily.Other, [\"harmony os\"]],\n];\n\nconst LOOKUP = new Map<string, OperatingSystemName>();\n\n/**\n * A recognized operating system name, e.g. `Windows`, `macOS` or `Ubuntu`, resolved from the\n * aliases the trade uses, so `win`, `ms windows` and `Windows` all give the same value.\n */\nexport class OperatingSystemName {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Operating System Name\",\n    localizedName: \"Operativsystemnamn\",\n    emoji: \"\uD83D\uDCBB\",\n    sources: Object.freeze([]),\n  });\n\n  /** The canonical name, e.g. `macOS`. */\n  readonly value: string;\n\n  /** The family this name belongs to. */\n  readonly family: OperatingSystemFamily;\n\n  private constructor(value: string, family: OperatingSystemFamily) {\n    this.value = value;\n    this.family = family;\n  }\n\n  static {\n    for (const [canonical, family, aliases] of KNOWN_SYSTEMS) {\n      const instance = new OperatingSystemName(canonical, family);\n      LOOKUP.set(foldOrdinalIgnoreCase(canonical), instance);\n      for (const alias of aliases) {\n        const key = foldOrdinalIgnoreCase(alias);\n        if (!LOOKUP.has(key)) LOOKUP.set(key, instance);\n      }\n    }\n  }\n\n  static tryParse(input: string | null | undefined): OperatingSystemName | null {\n    if (input == null || input.trim().length === 0) return null;\n    return LOOKUP.get(foldOrdinalIgnoreCase(sanitizeInput(input).trim())) ?? null;\n  }\n\n  static parse(input: string): OperatingSystemName {\n    const result = OperatingSystemName.tryParse(input);\n    if (result === null) throw new Error(\"Unknown operating system name.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return OperatingSystemName.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical name, e.g. `macOS`. */\n  static format(\n    input: string | null | undefined,\n    options?: OperatingSystemNameFormatOptions,\n  ): string | null {\n    const r = OperatingSystemName.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical name, e.g. `macOS`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: OperatingSystemNameFormatOptions,\n  ): string | null {\n    const r = OperatingSystemName.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 && OperatingSystemName.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: OperatingSystemName | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  compareTo(other: OperatingSystemName | null | undefined): number {\n    if (other == null) return 1;\n    return this.value < other.value ? -1 : this.value > other.value ? 1 : 0;\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: OperatingSystemNameFormatOptions,\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/operating-system-version.js

@@ -0,0 +1,110 @@
+"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 operating_system_version_exports = {};
+__export(operating_system_version_exports, {
+  OperatingSystemVersion: () => OperatingSystemVersion
+});
+module.exports = __toCommonJS(operating_system_version_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+const VERSION_PATTERN = /^\s*v?(\d+(?:\.\d+){0,3})\s*$/iu;
+const MAX_INT32 = 2147483647;
+class OperatingSystemVersion {
+  static typeInfo = Object.freeze({
+    englishName: "Operating System Version",
+    localizedName: "Operativsystemversion",
+    emoji: "\u{1F4BB}",
+    sources: Object.freeze([])
+  });
+  /** The version string, e.g. `14.5`. */
+  value;
+  /** The first part, e.g. `14` in `14.5`. */
+  major;
+  /** The second part when present, e.g. `5` in `14.5`. */
+  minor;
+  /** The third part when present, e.g. `7` in `10.15.7`. */
+  patch;
+  /** The fourth part when present. */
+  build;
+  constructor(value, parts) {
+    this.value = value;
+    this.major = parts[0];
+    this.minor = parts[1] ?? null;
+    this.patch = parts[2] ?? null;
+    this.build = parts[3] ?? null;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const match = VERSION_PATTERN.exec((0, import_input_sanitization.sanitizeInput)(input));
+    if (match === null) return null;
+    const version = match[1];
+    const parts = version.split(".").map((part) => Number(part));
+    if (!parts.every((part) => Number.isInteger(part) && part >= 0 && part <= MAX_INT32)) {
+      return null;
+    }
+    return new OperatingSystemVersion(version, parts);
+  }
+  static parse(input) {
+    const result = OperatingSystemVersion.tryParse(input);
+    if (result === null) throw new Error("Invalid OS version.");
+    return result;
+  }
+  static isValid(input) {
+    return OperatingSystemVersion.tryParse(input) !== null;
+  }
+  /** Returns the canonical version string, e.g. `14.5`. */
+  static format(input, options) {
+    const r = OperatingSystemVersion.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical version string, e.g. `14.5`. */
+  static normalize(input, options) {
+    const r = OperatingSystemVersion.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && OperatingSystemVersion.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  /** Orders numerically part by part, treating a missing part as zero. */
+  compareTo(other) {
+    if (other == null) return 1;
+    const mine = [this.major, this.minor ?? 0, this.patch ?? 0, this.build ?? 0];
+    const theirs = [other.major, other.minor ?? 0, other.patch ?? 0, other.build ?? 0];
+    for (let i = 0; i < mine.length; i++) {
+      if (mine[i] !== theirs[i]) return mine[i] < theirs[i] ? -1 : 1;
+    }
+    return 0;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=operating-system-version.js.map

package/dist/cjs/product/operating-system-version.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/operating-system-version.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface OperatingSystemVersionFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst VERSION_PATTERN = /^\\s*v?(\\d+(?:\\.\\d+){0,3})\\s*$/iu;\nconst MAX_INT32 = 2_147_483_647;\n\n/**\n * An operating system version, e.g. `11`, `14.5`, `10.15.7` or `22.04`, with up to four numeric\n * parts. A leading `v` is accepted on input and dropped from the value.\n */\nexport class OperatingSystemVersion {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Operating System Version\",\n    localizedName: \"Operativsystemversion\",\n    emoji: \"\uD83D\uDCBB\",\n    sources: Object.freeze([]),\n  });\n\n  /** The version string, e.g. `14.5`. */\n  readonly value: string;\n\n  /** The first part, e.g. `14` in `14.5`. */\n  readonly major: number;\n\n  /** The second part when present, e.g. `5` in `14.5`. */\n  readonly minor: number | null;\n\n  /** The third part when present, e.g. `7` in `10.15.7`. */\n  readonly patch: number | null;\n\n  /** The fourth part when present. */\n  readonly build: number | null;\n\n  private constructor(value: string, parts: readonly number[]) {\n    this.value = value;\n    this.major = parts[0]!;\n    this.minor = parts[1] ?? null;\n    this.patch = parts[2] ?? null;\n    this.build = parts[3] ?? null;\n  }\n\n  static tryParse(input: string | null | undefined): OperatingSystemVersion | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const match = VERSION_PATTERN.exec(sanitizeInput(input));\n    if (match === null) return null;\n\n    const version = match[1]!;\n    const parts = version.split(\".\").map((part) => Number(part));\n    if (!parts.every((part) => Number.isInteger(part) && part >= 0 && part <= MAX_INT32)) {\n      return null;\n    }\n    return new OperatingSystemVersion(version, parts);\n  }\n\n  static parse(input: string): OperatingSystemVersion {\n    const result = OperatingSystemVersion.tryParse(input);\n    if (result === null) throw new Error(\"Invalid OS version.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return OperatingSystemVersion.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical version string, e.g. `14.5`. */\n  static format(\n    input: string | null | undefined,\n    options?: OperatingSystemVersionFormatOptions,\n  ): string | null {\n    const r = OperatingSystemVersion.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical version string, e.g. `14.5`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: OperatingSystemVersionFormatOptions,\n  ): string | null {\n    const r = OperatingSystemVersion.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 && OperatingSystemVersion.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: OperatingSystemVersion | null | undefined): boolean {\n    return other != null && this.value === other.value;\n  }\n\n  /** Orders numerically part by part, treating a missing part as zero. */\n  compareTo(other: OperatingSystemVersion | null | undefined): number {\n    if (other == null) return 1;\n\n    const mine = [this.major, this.minor ?? 0, this.patch ?? 0, this.build ?? 0];\n    const theirs = [other.major, other.minor ?? 0, other.patch ?? 0, other.build ?? 0];\n\n    for (let i = 0; i < mine.length; i++) {\n      if (mine[i]! !== theirs[i]!) return mine[i]! < theirs[i]! ? -1 : 1;\n    }\n    return 0;\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: OperatingSystemVersionFormatOptions,\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": []
+}