@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/product/hs-code.js

@@ -0,0 +1,106 @@
+import { keepDigits, sanitizeInput } from "../internal/input-sanitization.js";
+import { HsCodeLevel } from "./hs-code-level.js";
+const MAX_INPUT_LENGTH = 30;
+const LEVEL_BY_LENGTH = /* @__PURE__ */ new Map([
+  [2, HsCodeLevel.Chapter],
+  [4, HsCodeLevel.Heading],
+  [6, HsCodeLevel.Subheading],
+  [8, HsCodeLevel.CnSubheading],
+  [10, HsCodeLevel.TaricCode]
+]);
+class HsCode {
+  static typeInfo = Object.freeze({
+    englishName: "HS Code",
+    localizedName: "HS-kod",
+    emoji: "\u{1F4CB}",
+    sources: Object.freeze([
+      "https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx",
+      "https://taxation-customs.ec.europa.eu/customs/common-customs-tariff-cct/tariff-classification-goods/combined-nomenclature_en",
+      "https://www.tullverket.se",
+      "https://en.wikipedia.org/wiki/Harmonized_System",
+      "https://en.wikipedia.org/wiki/Combined_Nomenclature"
+    ])
+  });
+  /** The code as digits only, e.g. `847130`. */
+  digits;
+  /** The display form with dots, e.g. `8471.30`. */
+  formatted;
+  /** The chapter, the first two digits, e.g. `84`. */
+  chapter;
+  /** The hierarchy level this code sits at. */
+  level;
+  constructor(digits) {
+    this.digits = digits;
+    this.formatted = formatDigits(digits);
+    this.chapter = digits.slice(0, 2);
+    this.level = LEVEL_BY_LENGTH.get(digits.length) ?? HsCodeLevel.Unknown;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = keepDigits(sanitizeInput(input));
+    if (digits.length > MAX_INPUT_LENGTH) return null;
+    if (!LEVEL_BY_LENGTH.has(digits.length)) return null;
+    const chapter = Number(digits.slice(0, 2));
+    if (chapter < 1 || chapter > 97) return null;
+    return new HsCode(digits);
+  }
+  static parse(input) {
+    const result = HsCode.tryParse(input);
+    if (result === null) throw new Error("Invalid HS code.");
+    return result;
+  }
+  static isValid(input) {
+    return HsCode.tryParse(input) !== null;
+  }
+  /** Returns the dot-separated display form, e.g. `8471.30` or `8471.30.00`. */
+  static format(input, options) {
+    const r = HsCode.tryParse(input);
+    if (r !== null) return r.formatted;
+    return fallback(input, options);
+  }
+  /** Returns the dot-separated canonical form, e.g. `8471.30`. */
+  static normalize(input, options) {
+    const r = HsCode.tryParse(input);
+    if (r !== null) return r.formatted;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && HsCode.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.formatted;
+  }
+  toString() {
+    return this.formatted;
+  }
+  equals(other) {
+    return other != null && this.formatted === other.formatted;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;
+  }
+}
+function formatDigits(digits) {
+  switch (digits.length) {
+    case 4:
+      return `${digits.slice(0, 2)}.${digits.slice(2)}`;
+    case 6:
+      return `${digits.slice(0, 4)}.${digits.slice(4)}`;
+    case 8:
+      return `${digits.slice(0, 4)}.${digits.slice(4, 6)}.${digits.slice(6)}`;
+    case 10:
+      return `${digits.slice(0, 4)}.${digits.slice(4, 6)}.${digits.slice(6, 8)}.${digits.slice(8)}`;
+    default:
+      return digits;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  HsCode
+};
+//# sourceMappingURL=hs-code.js.map

package/dist/esm/product/hs-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/hs-code.ts"],
+  "sourcesContent": ["import { keepDigits, sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { HsCodeLevel } from \"./hs-code-level.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface HsCodeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst MAX_INPUT_LENGTH = 30;\n\nconst LEVEL_BY_LENGTH: ReadonlyMap<number, HsCodeLevel> = new Map([\n  [2, HsCodeLevel.Chapter],\n  [4, HsCodeLevel.Heading],\n  [6, HsCodeLevel.Subheading],\n  [8, HsCodeLevel.CnSubheading],\n  [10, HsCodeLevel.TaricCode],\n]);\n\n/**\n * A Harmonized System code for classifying goods in international trade, accepted at all five\n * levels: the two-digit chapter, four-digit heading, six-digit subheading maintained by the WCO,\n * the EU's eight-digit Combined Nomenclature code (`KN-nummer`) and its ten-digit TARIC code.\n *\n * Separators in the input are ignored, so `8471.30` and `8471 30` both give the same code.\n */\nexport class HsCode {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"HS Code\",\n    localizedName: \"HS-kod\",\n    emoji: \"\uD83D\uDCCB\",\n    sources: Object.freeze([\n      \"https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx\",\n      \"https://taxation-customs.ec.europa.eu/customs/common-customs-tariff-cct/tariff-classification-goods/combined-nomenclature_en\",\n      \"https://www.tullverket.se\",\n      \"https://en.wikipedia.org/wiki/Harmonized_System\",\n      \"https://en.wikipedia.org/wiki/Combined_Nomenclature\",\n    ]),\n  });\n\n  /** The code as digits only, e.g. `847130`. */\n  readonly digits: string;\n\n  /** The display form with dots, e.g. `8471.30`. */\n  readonly formatted: string;\n\n  /** The chapter, the first two digits, e.g. `84`. */\n  readonly chapter: string;\n\n  /** The hierarchy level this code sits at. */\n  readonly level: HsCodeLevel;\n\n  private constructor(digits: string) {\n    this.digits = digits;\n    this.formatted = formatDigits(digits);\n    this.chapter = digits.slice(0, 2);\n    this.level = LEVEL_BY_LENGTH.get(digits.length) ?? HsCodeLevel.Unknown;\n  }\n\n  static tryParse(input: string | null | undefined): HsCode | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const digits = keepDigits(sanitizeInput(input));\n    if (digits.length > MAX_INPUT_LENGTH) return null;\n    if (!LEVEL_BY_LENGTH.has(digits.length)) return null;\n\n    const chapter = Number(digits.slice(0, 2));\n    if (chapter < 1 || chapter > 97) return null;\n\n    return new HsCode(digits);\n  }\n\n  static parse(input: string): HsCode {\n    const result = HsCode.tryParse(input);\n    if (result === null) throw new Error(\"Invalid HS code.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return HsCode.tryParse(input) !== null;\n  }\n\n  /** Returns the dot-separated display form, e.g. `8471.30` or `8471.30.00`. */\n  static format(input: string | null | undefined, options?: HsCodeFormatOptions): string | null {\n    const r = HsCode.tryParse(input);\n    if (r !== null) return r.formatted;\n    return fallback(input, options);\n  }\n\n  /** Returns the dot-separated canonical form, e.g. `8471.30`. */\n  static normalize(input: string | null | undefined, options?: HsCodeFormatOptions): string | null {\n    const r = HsCode.tryParse(input);\n    if (r !== null) return r.formatted;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && HsCode.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.formatted;\n  }\n\n  toString(): string {\n    return this.formatted;\n  }\n\n  equals(other: HsCode | null | undefined): boolean {\n    return other != null && this.formatted === other.formatted;\n  }\n\n  compareTo(other: HsCode | null | undefined): number {\n    if (other == null) return 1;\n    return this.digits < other.digits ? -1 : this.digits > other.digits ? 1 : 0;\n  }\n}\n\n/** Groups the digits the way customs tariffs print them, e.g. `8471.30.00.00`. */\nfunction formatDigits(digits: string): string {\n  switch (digits.length) {\n    case 4:\n      return `${digits.slice(0, 2)}.${digits.slice(2)}`;\n    case 6:\n      return `${digits.slice(0, 4)}.${digits.slice(4)}`;\n    case 8:\n      return `${digits.slice(0, 4)}.${digits.slice(4, 6)}.${digits.slice(6)}`;\n    case 10:\n      return `${digits.slice(0, 4)}.${digits.slice(4, 6)}.${digits.slice(6, 8)}.${digits.slice(8)}`;\n    default:\n      return digits;\n  }\n}\n\nfunction fallback(input: string | null | undefined, options?: HsCodeFormatOptions): 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/esm/product/index.js

@@ -0,0 +1,137 @@
+import { AdultClothingSize } from "./adult-clothing-size.js";
+import { AdultShoeSize } from "./adult-shoe-size.js";
+import { AspectRatio } from "./aspect-ratio.js";
+import { BatteryCapacity } from "./battery-capacity.js";
+import { BatteryChemistry } from "./battery-chemistry.js";
+import { CameraResolution } from "./camera-resolution.js";
+import { ChildClothingSize } from "./child-clothing-size.js";
+import { ChildShoeSize } from "./child-shoe-size.js";
+import { ClothingFit } from "./clothing-fit.js";
+import { ClothingGender } from "./clothing-gender.js";
+import { ClothingSeason } from "./clothing-season.js";
+import { ClothingSize } from "./clothing-size.js";
+import { ClothingSizeSystem } from "./clothing-size-system.js";
+import { Color } from "./color.js";
+import { DisplayPanelType } from "./display-panel-type.js";
+import { ElectricalPhase } from "./electrical-phase.js";
+import { EnergyScale } from "./energy-scale.js";
+import {
+  EuEnergyEfficiencyClass
+} from "./eu-energy-efficiency-class.js";
+import {
+  GoogleProductCategory
+} from "./google-product-category.js";
+import { Gtin } from "./gtin.js";
+import { Gtin12 } from "./gtin12.js";
+import { Gtin13 } from "./gtin13.js";
+import { Gtin14 } from "./gtin14.js";
+import { Gtin8 } from "./gtin8.js";
+import { HsCode } from "./hs-code.js";
+import { HsCodeLevel } from "./hs-code-level.js";
+import { IpRating } from "./ip-rating.js";
+import { OperatingSystemFamily } from "./operating-system-family.js";
+import {
+  OperatingSystemInfo
+} from "./operating-system-info.js";
+import {
+  OperatingSystemName
+} from "./operating-system-name.js";
+import {
+  OperatingSystemVersion
+} from "./operating-system-version.js";
+import { PowerSource } from "./power-source.js";
+import { ProcessorSpeed } from "./processor-speed.js";
+import { RamCapacity } from "./ram-capacity.js";
+import { Refrigerant } from "./refrigerant.js";
+import { RefrigerantFamily } from "./refrigerant-family.js";
+import { ScreenResolution } from "./screen-resolution.js";
+import { ScreenSize } from "./screen-size.js";
+import { ShoeSize } from "./shoe-size.js";
+import { ShoeSizeSystem } from "./shoe-size-system.js";
+import { StorageCapacity } from "./storage-capacity.js";
+import { StorageMediaType } from "./storage-media-type.js";
+import { toBarcodeLookupUrl } from "./product-extensions.js";
+import {
+  maskAspectRatio,
+  maskBatteryChemistry,
+  maskCameraResolution,
+  maskClothingFit,
+  maskClothingSeason,
+  maskColor,
+  maskDisplayPanelType,
+  maskElectricalPhase,
+  maskGtin12,
+  maskGtin13,
+  maskGtin14,
+  maskGtin8,
+  maskIpRating,
+  maskPowerSource,
+  maskRefrigerant,
+  maskScreenResolution,
+  maskScreenSize,
+  maskStorageMediaType
+} from "./product-masking.js";
+export {
+  AdultClothingSize,
+  AdultShoeSize,
+  AspectRatio,
+  BatteryCapacity,
+  BatteryChemistry,
+  CameraResolution,
+  ChildClothingSize,
+  ChildShoeSize,
+  ClothingFit,
+  ClothingGender,
+  ClothingSeason,
+  ClothingSize,
+  ClothingSizeSystem,
+  Color,
+  DisplayPanelType,
+  ElectricalPhase,
+  EnergyScale,
+  EuEnergyEfficiencyClass,
+  GoogleProductCategory,
+  Gtin,
+  Gtin12,
+  Gtin13,
+  Gtin14,
+  Gtin8,
+  HsCode,
+  HsCodeLevel,
+  IpRating,
+  OperatingSystemFamily,
+  OperatingSystemInfo,
+  OperatingSystemName,
+  OperatingSystemVersion,
+  PowerSource,
+  ProcessorSpeed,
+  RamCapacity,
+  Refrigerant,
+  RefrigerantFamily,
+  ScreenResolution,
+  ScreenSize,
+  ShoeSize,
+  ShoeSizeSystem,
+  StorageCapacity,
+  StorageMediaType,
+  maskAspectRatio,
+  maskBatteryChemistry,
+  maskCameraResolution,
+  maskClothingFit,
+  maskClothingSeason,
+  maskColor,
+  maskDisplayPanelType,
+  maskElectricalPhase,
+  maskGtin12,
+  maskGtin13,
+  maskGtin14,
+  maskGtin8,
+  maskIpRating,
+  maskPowerSource,
+  maskRefrigerant,
+  maskScreenResolution,
+  maskScreenSize,
+  maskStorageMediaType,
+  toBarcodeLookupUrl
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/index.ts"],
+  "sourcesContent": ["export { AdultClothingSize, type AdultClothingSizeFormatOptions } from \"./adult-clothing-size.js\";\nexport { AdultShoeSize, type AdultShoeSizeFormatOptions } from \"./adult-shoe-size.js\";\nexport { AspectRatio, type AspectRatioFormatOptions } from \"./aspect-ratio.js\";\nexport { BatteryCapacity, type BatteryCapacityFormatOptions } from \"./battery-capacity.js\";\nexport { BatteryChemistry, type BatteryChemistryFormatOptions } from \"./battery-chemistry.js\";\nexport { CameraResolution, type CameraResolutionFormatOptions } from \"./camera-resolution.js\";\nexport { ChildClothingSize, type ChildClothingSizeFormatOptions } from \"./child-clothing-size.js\";\nexport { ChildShoeSize, type ChildShoeSizeFormatOptions } from \"./child-shoe-size.js\";\nexport { ClothingFit, type ClothingFitFormatOptions } from \"./clothing-fit.js\";\nexport { ClothingGender, type ClothingGenderFormatOptions } from \"./clothing-gender.js\";\nexport { ClothingSeason, type ClothingSeasonFormatOptions } from \"./clothing-season.js\";\nexport { ClothingSize, type ClothingSizeFormatOptions } from \"./clothing-size.js\";\nexport { ClothingSizeSystem } from \"./clothing-size-system.js\";\nexport { Color, type ColorFormatOptions } from \"./color.js\";\nexport { DisplayPanelType, type DisplayPanelTypeFormatOptions } from \"./display-panel-type.js\";\nexport { ElectricalPhase, type ElectricalPhaseFormatOptions } from \"./electrical-phase.js\";\nexport { EnergyScale } from \"./energy-scale.js\";\nexport {\n  EuEnergyEfficiencyClass,\n  type EuEnergyEfficiencyClassFormatOptions,\n} from \"./eu-energy-efficiency-class.js\";\nexport {\n  GoogleProductCategory,\n  type GoogleProductCategoryFormatOptions,\n} from \"./google-product-category.js\";\nexport { Gtin, type GtinFormatOptions } from \"./gtin.js\";\nexport { Gtin12, type Gtin12FormatOptions } from \"./gtin12.js\";\nexport { Gtin13, type Gtin13FormatOptions } from \"./gtin13.js\";\nexport { Gtin14, type Gtin14FormatOptions } from \"./gtin14.js\";\nexport { Gtin8, type Gtin8FormatOptions } from \"./gtin8.js\";\nexport { HsCode, type HsCodeFormatOptions } from \"./hs-code.js\";\nexport { HsCodeLevel } from \"./hs-code-level.js\";\nexport { IpRating, type IpRatingFormatOptions } from \"./ip-rating.js\";\nexport { OperatingSystemFamily } from \"./operating-system-family.js\";\nexport {\n  OperatingSystemInfo,\n  type OperatingSystemInfoFormatOptions,\n} from \"./operating-system-info.js\";\nexport {\n  OperatingSystemName,\n  type OperatingSystemNameFormatOptions,\n} from \"./operating-system-name.js\";\nexport {\n  OperatingSystemVersion,\n  type OperatingSystemVersionFormatOptions,\n} from \"./operating-system-version.js\";\nexport { PowerSource, type PowerSourceFormatOptions } from \"./power-source.js\";\nexport { ProcessorSpeed, type ProcessorSpeedFormatOptions } from \"./processor-speed.js\";\nexport { RamCapacity, type RamCapacityFormatOptions } from \"./ram-capacity.js\";\nexport { Refrigerant, type RefrigerantFormatOptions } from \"./refrigerant.js\";\nexport { RefrigerantFamily } from \"./refrigerant-family.js\";\nexport { ScreenResolution, type ScreenResolutionFormatOptions } from \"./screen-resolution.js\";\nexport { ScreenSize, type ScreenSizeFormatOptions } from \"./screen-size.js\";\nexport { ShoeSize, type ShoeSizeFormatOptions } from \"./shoe-size.js\";\nexport { ShoeSizeSystem } from \"./shoe-size-system.js\";\nexport { StorageCapacity, type StorageCapacityFormatOptions } from \"./storage-capacity.js\";\nexport { StorageMediaType, type StorageMediaTypeFormatOptions } from \"./storage-media-type.js\";\n\nexport { toBarcodeLookupUrl } from \"./product-extensions.js\";\n\nexport {\n  maskAspectRatio,\n  maskBatteryChemistry,\n  maskCameraResolution,\n  maskClothingFit,\n  maskClothingSeason,\n  maskColor,\n  maskDisplayPanelType,\n  maskElectricalPhase,\n  maskGtin12,\n  maskGtin13,\n  maskGtin14,\n  maskGtin8,\n  maskIpRating,\n  maskPowerSource,\n  maskRefrigerant,\n  maskScreenResolution,\n  maskScreenSize,\n  maskStorageMediaType,\n} from \"./product-masking.js\";\n"],
+  "mappings": "AAAA,SAAS,yBAA8D;AACvE,SAAS,qBAAsD;AAC/D,SAAS,mBAAkD;AAC3D,SAAS,uBAA0D;AACnE,SAAS,wBAA4D;AACrE,SAAS,wBAA4D;AACrE,SAAS,yBAA8D;AACvE,SAAS,qBAAsD;AAC/D,SAAS,mBAAkD;AAC3D,SAAS,sBAAwD;AACjE,SAAS,sBAAwD;AACjE,SAAS,oBAAoD;AAC7D,SAAS,0BAA0B;AACnC,SAAS,aAAsC;AAC/C,SAAS,wBAA4D;AACrE,SAAS,uBAA0D;AACnE,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,OAEK;AACP,SAAS,YAAoC;AAC7C,SAAS,cAAwC;AACjD,SAAS,cAAwC;AACjD,SAAS,cAAwC;AACjD,SAAS,aAAsC;AAC/C,SAAS,cAAwC;AACjD,SAAS,mBAAmB;AAC5B,SAAS,gBAA4C;AACrD,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,OAEK;AACP,SAAS,mBAAkD;AAC3D,SAAS,sBAAwD;AACjE,SAAS,mBAAkD;AAC3D,SAAS,mBAAkD;AAC3D,SAAS,yBAAyB;AAClC,SAAS,wBAA4D;AACrE,SAAS,kBAAgD;AACzD,SAAS,gBAA4C;AACrD,SAAS,sBAAsB;AAC/B,SAAS,uBAA0D;AACnE,SAAS,wBAA4D;AAErE,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "names": []
+}

package/dist/esm/product/ip-rating.js

@@ -0,0 +1,146 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { maskIpRating } from "./product-masking.js";
+const PARSE_PATTERN = /^\s*[Ii][Pp]\s*[-/]?\s*([0-6Xx])\s*([0-9Xx])\s*$/u;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])IP\s*[-/]?\s*[0-6Xx][0-9Xx](?![\p{L}\p{N}_])/giu;
+const SOLIDS_DESCRIPTIONS = {
+  X: "Not tested",
+  "0": "No protection",
+  "1": "Objects >50 mm",
+  "2": "Objects >12.5 mm",
+  "3": "Objects >2.5 mm",
+  "4": "Objects >1 mm",
+  "5": "Dust protected",
+  "6": "Dust tight"
+};
+const LIQUIDS_DESCRIPTIONS = {
+  X: "Not tested",
+  "0": "No protection",
+  "1": "Dripping water",
+  "2": "Dripping water (15\xB0 tilted)",
+  "3": "Spraying water",
+  "4": "Splashing water",
+  "5": "Water jets",
+  "6": "Powerful water jets",
+  "7": "Temporary immersion",
+  "8": "Continuous immersion",
+  "9": "High-pressure/steam cleaning"
+};
+class IpRating {
+  static typeInfo = Object.freeze({
+    englishName: "IP Rating",
+    localizedName: "IP-klass",
+    emoji: "\u{1F6E1}\uFE0F",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/IP_code",
+      "https://webstore.iec.ch/en/publication/2452"
+    ])
+  });
+  /** Solids protection, a single character `0`–`6` or `X`. */
+  solidsProtection;
+  /** Liquids protection, a single character `0`–`9` or `X`. */
+  liquidsProtection;
+  /** Normalized code, e.g. `IP65`. */
+  value;
+  constructor(solidsProtection, liquidsProtection) {
+    this.solidsProtection = solidsProtection;
+    this.liquidsProtection = liquidsProtection;
+    this.value = `IP${solidsProtection}${liquidsProtection}`;
+  }
+  /** English description of the solids level, e.g. `Dust tight`. */
+  get solidsDescription() {
+    return SOLIDS_DESCRIPTIONS[this.solidsProtection] ?? "Unknown";
+  }
+  /** English description of the liquids level, e.g. `Water jets`. */
+  get liquidsDescription() {
+    return LIQUIDS_DESCRIPTIONS[this.liquidsProtection] ?? "Unknown";
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const match = PARSE_PATTERN.exec(sanitizeInput(input).trim());
+    if (match === null) return null;
+    return new IpRating(match[1].toUpperCase(), match[2].toUpperCase());
+  }
+  static parse(input) {
+    const result = IpRating.tryParse(input);
+    if (result === null) throw new Error("Invalid IP rating.");
+    return result;
+  }
+  static isValid(input) {
+    return IpRating.tryParse(input) !== null;
+  }
+  /** Returns the canonical form, e.g. `IP65`. */
+  static format(input, options) {
+    const r = IpRating.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical form, e.g. `IP65`. */
+  static normalize(input, options) {
+    const r = IpRating.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && IpRating.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for IP ratings such as `IP65`. The `IP` prefix makes matches fairly
+   * distinctive, but the scan stays 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 = IpRating.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "IpRating",
+          category: TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskIpRating(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.solidsProtection === other.solidsProtection && this.liquidsProtection === other.liquidsProtection;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    const solids = compareChars(this.solidsProtection, other.solidsProtection);
+    return solids !== 0 ? solids : compareChars(this.liquidsProtection, other.liquidsProtection);
+  }
+}
+function compareChars(a, b) {
+  const left = a.charCodeAt(0);
+  const right = b.charCodeAt(0);
+  return left < right ? -1 : left > right ? 1 : 0;
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  IpRating
+};
+//# sourceMappingURL=ip-rating.js.map

package/dist/esm/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/esm/product/operating-system-family.js

@@ -0,0 +1,17 @@
+const OperatingSystemFamily = {
+  Unknown: 0,
+  Windows: 1,
+  MacOS: 2,
+  Linux: 3,
+  Android: 4,
+  IOS: 5,
+  IPadOS: 6,
+  ChromeOS: 7,
+  WatchOS: 8,
+  Other: 9,
+  None: 10
+};
+export {
+  OperatingSystemFamily
+};
+//# sourceMappingURL=operating-system-family.js.map

package/dist/esm/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": "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/esm/product/operating-system-info.js

@@ -0,0 +1,80 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { OperatingSystemName } from "./operating-system-name.js";
+import { OperatingSystemVersion } from "./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 = sanitizeInput(input).trim();
+    for (let i = text.length; i >= 1; i--) {
+      const 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 = 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;
+}
+export {
+  OperatingSystemInfo
+};
+//# sourceMappingURL=operating-system-info.js.map

package/dist/esm/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,SAAS,qBAAqB;AAE9B,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;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,OAAO,cAAc,KAAK,EAAE,KAAK;AAEvC,aAAS,IAAI,KAAK,QAAQ,KAAK,GAAG,KAAK;AACrC,YAAM,OAAO,oBAAoB,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,uBAAuB,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": []
+}