@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/cjs/product/gtin8.js

@@ -0,0 +1,130 @@
+"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 gtin8_exports = {};
+__export(gtin8_exports, {
+  Gtin8: () => Gtin8
+});
+module.exports = __toCommonJS(gtin8_exports);
+var import_gtin_check_digit = require("../internal/gtin-check-digit.js");
+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 SCAN_PATTERN = /(?<!\d)\d{8}(?!\d)/gu;
+class Gtin8 {
+  static typeInfo = Object.freeze({
+    englishName: "GTIN-8",
+    localizedName: "GTIN-8",
+    emoji: "\u{1F4E6}",
+    sources: Object.freeze([
+      "https://www.gs1.org/standards/id-keys/gtin",
+      "https://www.gs1.org/services/check-digit-calculator",
+      "https://en.wikipedia.org/wiki/EAN-8"
+    ])
+  });
+  /** The 8 digits, e.g. `96385074`. */
+  digits;
+  /** The GS1 modulo-10 check digit (last digit). */
+  checkDigit;
+  constructor(digits) {
+    this.digits = digits;
+    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;
+  }
+  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */
+  toGtin14Digits() {
+    return this.digits.padStart(14, "0");
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = (0, import_gtin_check_digit.extractGtinDigits)((0, import_input_sanitization.sanitizeInput)(input));
+    if (digits === null || digits.length !== 8) return null;
+    if (!(0, import_gtin_check_digit.validateGtinCheckDigit)(digits)) return null;
+    return new Gtin8(digits);
+  }
+  static parse(input) {
+    const result = Gtin8.tryParse(input);
+    if (result === null) throw new Error("Invalid GTIN-8.");
+    return result;
+  }
+  static isValid(input) {
+    return Gtin8.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = Gtin8.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = Gtin8.tryParse(input);
+    if (r !== null) return r.digits;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Gtin8.normalize(input) === input;
+  }
+  /**
+   * Scans unstructured text for potential GTIN-8 barcodes. Results are heuristic candidates
+   * and may include false positives; nothing guarantees a candidate is a real product code.
+   */
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    SCAN_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = SCAN_PATTERN.exec(text)) !== null) {
+      const value = Gtin8.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: "Gtin8",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskGtin8)(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.High,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  toNormalizedString() {
+    return this.digits;
+  }
+  toString() {
+    return this.digits;
+  }
+  equals(other) {
+    return other != null && this.digits === other.digits;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.digits < other.digits ? -1 : this.digits > other.digits ? 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=gtin8.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/gtin8.ts"],
+  "sourcesContent": ["import { extractGtinDigits, validateGtinCheckDigit } from \"../internal/gtin-check-digit.js\";\nimport { 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 { maskGtin8 } from \"./product-masking.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface Gtin8FormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst SCAN_PATTERN = /(?<!\\d)\\d{8}(?!\\d)/gu;\n\n/**\n * An 8-digit Global Trade Item Number (GTIN-8), also known as EAN-8. Used on small packages\n * where a GTIN-13 barcode would not fit. Validated with the GS1 modulo-10 check digit.\n */\nexport class Gtin8 {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"GTIN-8\",\n    localizedName: \"GTIN-8\",\n    emoji: \"\uD83D\uDCE6\",\n    sources: Object.freeze([\n      \"https://www.gs1.org/standards/id-keys/gtin\",\n      \"https://www.gs1.org/services/check-digit-calculator\",\n      \"https://en.wikipedia.org/wiki/EAN-8\",\n    ]),\n  });\n\n  /** The 8 digits, e.g. `96385074`. */\n  readonly digits: string;\n\n  /** The GS1 modulo-10 check digit (last digit). */\n  readonly checkDigit: number;\n\n  private constructor(digits: string) {\n    this.digits = digits;\n    this.checkDigit = digits.charCodeAt(digits.length - 1) - 48;\n  }\n\n  /** Returns the GTIN zero-padded to 14 digits, the form used for cross-length comparison. */\n  toGtin14Digits(): string {\n    return this.digits.padStart(14, \"0\");\n  }\n\n  static tryParse(input: string | null | undefined): Gtin8 | null {\n    if (input == null || input.trim().length === 0) return null;\n    const digits = extractGtinDigits(sanitizeInput(input));\n    if (digits === null || digits.length !== 8) return null;\n    if (!validateGtinCheckDigit(digits)) return null;\n    return new Gtin8(digits);\n  }\n\n  static parse(input: string): Gtin8 {\n    const result = Gtin8.tryParse(input);\n    if (result === null) throw new Error(\"Invalid GTIN-8.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Gtin8.tryParse(input) !== null;\n  }\n\n  static format(input: string | null | undefined, options?: Gtin8FormatOptions): string | null {\n    const r = Gtin8.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static normalize(input: string | null | undefined, options?: Gtin8FormatOptions): string | null {\n    const r = Gtin8.tryParse(input);\n    if (r !== null) return r.digits;\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Gtin8.normalize(input) === input;\n  }\n\n  /**\n   * Scans unstructured text for potential GTIN-8 barcodes. Results are heuristic candidates\n   * and may include false positives; nothing guarantees a candidate is a real product code.\n   */\n  static findCandidatesInText(text: string): readonly TextCandidate<Gtin8>[] {\n    if (!text) return [];\n    const out: TextCandidate<Gtin8>[] = [];\n    SCAN_PATTERN.lastIndex = 0;\n    let match: RegExpExecArray | null;\n    while ((match = SCAN_PATTERN.exec(text)) !== null) {\n      const value = Gtin8.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Gtin8>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Gtin8\",\n          category: TextCandidateCategory.Product,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskGtin8(value),\n          confidence: TextMatchConfidence.High,\n          value,\n        }),\n      );\n    }\n    return out;\n  }\n\n  toNormalizedString(): string {\n    return this.digits;\n  }\n\n  toString(): string {\n    return this.digits;\n  }\n\n  equals(other: Gtin8 | null | undefined): boolean {\n    return other != null && this.digits === other.digits;\n  }\n\n  compareTo(other: Gtin8 | 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\nfunction fallback(input: string | null | undefined, options?: Gtin8FormatOptions): 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,8BAA0D;AAC1D,gCAA8B;AAE9B,qCAAsC;AACtC,4BAA8B;AAC9B,mCAAoC;AACpC,6BAA0B;AAQ1B,MAAM,eAAe;AAMd,MAAM,MAAM;AAAA,EACjB,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAAA;AAAA,EAGQ;AAAA;AAAA,EAGA;AAAA,EAED,YAAY,QAAgB;AAClC,SAAK,SAAS;AACd,SAAK,aAAa,OAAO,WAAW,OAAO,SAAS,CAAC,IAAI;AAAA,EAC3D;AAAA;AAAA,EAGA,iBAAyB;AACvB,WAAO,KAAK,OAAO,SAAS,IAAI,GAAG;AAAA,EACrC;AAAA,EAEA,OAAO,SAAS,OAAgD;AAC9D,QAAI,SAAS,QAAQ,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AACvD,UAAM,aAAS,+CAAkB,yCAAc,KAAK,CAAC;AACrD,QAAI,WAAW,QAAQ,OAAO,WAAW,EAAG,QAAO;AACnD,QAAI,KAAC,gDAAuB,MAAM,EAAG,QAAO;AAC5C,WAAO,IAAI,MAAM,MAAM;AAAA,EACzB;AAAA,EAEA,OAAO,MAAM,OAAsB;AACjC,UAAM,SAAS,MAAM,SAAS,KAAK;AACnC,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,iBAAiB;AACtD,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,QAAQ,OAA2C;AACxD,WAAO,MAAM,SAAS,KAAK,MAAM;AAAA,EACnC;AAAA,EAEA,OAAO,OAAO,OAAkC,SAA6C;AAC3F,UAAM,IAAI,MAAM,SAAS,KAAK;AAC9B,QAAI,MAAM,KAAM,QAAO,EAAE;AACzB,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,UAAU,OAAkC,SAA6C;AAC9F,UAAM,IAAI,MAAM,SAAS,KAAK;AAC9B,QAAI,MAAM,KAAM,QAAO,EAAE;AACzB,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC;AAAA,EAEA,OAAO,aAAa,OAA2C;AAC7D,WAAO,SAAS,QAAQ,MAAM,UAAU,KAAK,MAAM;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,qBAAqB,MAA+C;AACzE,QAAI,CAAC,KAAM,QAAO,CAAC;AACnB,UAAM,MAA8B,CAAC;AACrC,iBAAa,YAAY;AACzB,QAAI;AACJ,YAAQ,QAAQ,aAAa,KAAK,IAAI,OAAO,MAAM;AACjD,YAAM,QAAQ,MAAM,SAAS,MAAM,CAAC,CAAC;AACrC,UAAI,UAAU,KAAM;AACpB,UAAI;AAAA,QACF,IAAI,oCAAqB;AAAA,UACvB,YAAY,MAAM;AAAA,UAClB,QAAQ,MAAM,CAAC,EAAE;AAAA,UACjB,cAAc,MAAM,CAAC;AAAA,UACrB,UAAU;AAAA,UACV,UAAU,qDAAsB;AAAA,UAChC,gBAAgB,MAAM,mBAAmB;AAAA,UACzC,eAAe,MAAM,SAAS;AAAA,UAC9B,gBAAY,kCAAU,KAAK;AAAA,UAC3B,YAAY,iDAAoB;AAAA,UAChC;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,qBAA6B;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,WAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAA0C;AAC/C,WAAO,SAAS,QAAQ,KAAK,WAAW,MAAM;AAAA,EAChD;AAAA,EAEA,UAAU,OAAyC;AACjD,QAAI,SAAS,KAAM,QAAO;AAC1B,WAAO,KAAK,SAAS,MAAM,SAAS,KAAK,KAAK,SAAS,MAAM,SAAS,IAAI;AAAA,EAC5E;AACF;AAEA,SAAS,SAAS,OAAkC,SAA6C;AAC/F,MAAI,SAAS,sCAAsC,QAAQ,SAAS,KAAM,QAAO;AACjF,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;",
+  "names": []
+}

package/dist/cjs/product/hs-code-level.js

@@ -0,0 +1,32 @@
+"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 hs_code_level_exports = {};
+__export(hs_code_level_exports, {
+  HsCodeLevel: () => HsCodeLevel
+});
+module.exports = __toCommonJS(hs_code_level_exports);
+const HsCodeLevel = {
+  Unknown: 0,
+  Chapter: 1,
+  Heading: 2,
+  Subheading: 3,
+  CnSubheading: 4,
+  TaricCode: 5
+};
+//# sourceMappingURL=hs-code-level.js.map

package/dist/cjs/product/hs-code-level.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/hs-code-level.ts"],
+  "sourcesContent": ["/** The hierarchy level of an HS code, from a two-digit chapter to a ten-digit TARIC code. */\nexport const HsCodeLevel = {\n  Unknown: 0,\n  Chapter: 1,\n  Heading: 2,\n  Subheading: 3,\n  CnSubheading: 4,\n  TaricCode: 5,\n} as const;\n\nexport type HsCodeLevel = (typeof HsCodeLevel)[keyof typeof HsCodeLevel];\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,MAAM,cAAc;AAAA,EACzB,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AACb;",
+  "names": []
+}

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

@@ -0,0 +1,126 @@
+"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 hs_code_exports = {};
+__export(hs_code_exports, {
+  HsCode: () => HsCode
+});
+module.exports = __toCommonJS(hs_code_exports);
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_hs_code_level = require("./hs-code-level.js");
+const MAX_INPUT_LENGTH = 30;
+const LEVEL_BY_LENGTH = /* @__PURE__ */ new Map([
+  [2, import_hs_code_level.HsCodeLevel.Chapter],
+  [4, import_hs_code_level.HsCodeLevel.Heading],
+  [6, import_hs_code_level.HsCodeLevel.Subheading],
+  [8, import_hs_code_level.HsCodeLevel.CnSubheading],
+  [10, import_hs_code_level.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) ?? import_hs_code_level.HsCodeLevel.Unknown;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const digits = (0, import_input_sanitization.keepDigits)((0, import_input_sanitization.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;
+}
+//# sourceMappingURL=hs-code.js.map

package/dist/cjs/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/cjs/product/index.js

@@ -0,0 +1,128 @@
+"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 product_exports = {};
+__export(product_exports, {
+  AdultClothingSize: () => import_adult_clothing_size.AdultClothingSize,
+  AdultShoeSize: () => import_adult_shoe_size.AdultShoeSize,
+  AspectRatio: () => import_aspect_ratio.AspectRatio,
+  BatteryCapacity: () => import_battery_capacity.BatteryCapacity,
+  BatteryChemistry: () => import_battery_chemistry.BatteryChemistry,
+  CameraResolution: () => import_camera_resolution.CameraResolution,
+  ChildClothingSize: () => import_child_clothing_size.ChildClothingSize,
+  ChildShoeSize: () => import_child_shoe_size.ChildShoeSize,
+  ClothingFit: () => import_clothing_fit.ClothingFit,
+  ClothingGender: () => import_clothing_gender.ClothingGender,
+  ClothingSeason: () => import_clothing_season.ClothingSeason,
+  ClothingSize: () => import_clothing_size.ClothingSize,
+  ClothingSizeSystem: () => import_clothing_size_system.ClothingSizeSystem,
+  Color: () => import_color.Color,
+  DisplayPanelType: () => import_display_panel_type.DisplayPanelType,
+  ElectricalPhase: () => import_electrical_phase.ElectricalPhase,
+  EnergyScale: () => import_energy_scale.EnergyScale,
+  EuEnergyEfficiencyClass: () => import_eu_energy_efficiency_class.EuEnergyEfficiencyClass,
+  GoogleProductCategory: () => import_google_product_category.GoogleProductCategory,
+  Gtin: () => import_gtin.Gtin,
+  Gtin12: () => import_gtin12.Gtin12,
+  Gtin13: () => import_gtin13.Gtin13,
+  Gtin14: () => import_gtin14.Gtin14,
+  Gtin8: () => import_gtin8.Gtin8,
+  HsCode: () => import_hs_code.HsCode,
+  HsCodeLevel: () => import_hs_code_level.HsCodeLevel,
+  IpRating: () => import_ip_rating.IpRating,
+  OperatingSystemFamily: () => import_operating_system_family.OperatingSystemFamily,
+  OperatingSystemInfo: () => import_operating_system_info.OperatingSystemInfo,
+  OperatingSystemName: () => import_operating_system_name.OperatingSystemName,
+  OperatingSystemVersion: () => import_operating_system_version.OperatingSystemVersion,
+  PowerSource: () => import_power_source.PowerSource,
+  ProcessorSpeed: () => import_processor_speed.ProcessorSpeed,
+  RamCapacity: () => import_ram_capacity.RamCapacity,
+  Refrigerant: () => import_refrigerant.Refrigerant,
+  RefrigerantFamily: () => import_refrigerant_family.RefrigerantFamily,
+  ScreenResolution: () => import_screen_resolution.ScreenResolution,
+  ScreenSize: () => import_screen_size.ScreenSize,
+  ShoeSize: () => import_shoe_size.ShoeSize,
+  ShoeSizeSystem: () => import_shoe_size_system.ShoeSizeSystem,
+  StorageCapacity: () => import_storage_capacity.StorageCapacity,
+  StorageMediaType: () => import_storage_media_type.StorageMediaType,
+  maskAspectRatio: () => import_product_masking.maskAspectRatio,
+  maskBatteryChemistry: () => import_product_masking.maskBatteryChemistry,
+  maskCameraResolution: () => import_product_masking.maskCameraResolution,
+  maskClothingFit: () => import_product_masking.maskClothingFit,
+  maskClothingSeason: () => import_product_masking.maskClothingSeason,
+  maskColor: () => import_product_masking.maskColor,
+  maskDisplayPanelType: () => import_product_masking.maskDisplayPanelType,
+  maskElectricalPhase: () => import_product_masking.maskElectricalPhase,
+  maskGtin12: () => import_product_masking.maskGtin12,
+  maskGtin13: () => import_product_masking.maskGtin13,
+  maskGtin14: () => import_product_masking.maskGtin14,
+  maskGtin8: () => import_product_masking.maskGtin8,
+  maskIpRating: () => import_product_masking.maskIpRating,
+  maskPowerSource: () => import_product_masking.maskPowerSource,
+  maskRefrigerant: () => import_product_masking.maskRefrigerant,
+  maskScreenResolution: () => import_product_masking.maskScreenResolution,
+  maskScreenSize: () => import_product_masking.maskScreenSize,
+  maskStorageMediaType: () => import_product_masking.maskStorageMediaType,
+  toBarcodeLookupUrl: () => import_product_extensions.toBarcodeLookupUrl
+});
+module.exports = __toCommonJS(product_exports);
+var import_adult_clothing_size = require("./adult-clothing-size.js");
+var import_adult_shoe_size = require("./adult-shoe-size.js");
+var import_aspect_ratio = require("./aspect-ratio.js");
+var import_battery_capacity = require("./battery-capacity.js");
+var import_battery_chemistry = require("./battery-chemistry.js");
+var import_camera_resolution = require("./camera-resolution.js");
+var import_child_clothing_size = require("./child-clothing-size.js");
+var import_child_shoe_size = require("./child-shoe-size.js");
+var import_clothing_fit = require("./clothing-fit.js");
+var import_clothing_gender = require("./clothing-gender.js");
+var import_clothing_season = require("./clothing-season.js");
+var import_clothing_size = require("./clothing-size.js");
+var import_clothing_size_system = require("./clothing-size-system.js");
+var import_color = require("./color.js");
+var import_display_panel_type = require("./display-panel-type.js");
+var import_electrical_phase = require("./electrical-phase.js");
+var import_energy_scale = require("./energy-scale.js");
+var import_eu_energy_efficiency_class = require("./eu-energy-efficiency-class.js");
+var import_google_product_category = require("./google-product-category.js");
+var import_gtin = require("./gtin.js");
+var import_gtin12 = require("./gtin12.js");
+var import_gtin13 = require("./gtin13.js");
+var import_gtin14 = require("./gtin14.js");
+var import_gtin8 = require("./gtin8.js");
+var import_hs_code = require("./hs-code.js");
+var import_hs_code_level = require("./hs-code-level.js");
+var import_ip_rating = require("./ip-rating.js");
+var import_operating_system_family = require("./operating-system-family.js");
+var import_operating_system_info = require("./operating-system-info.js");
+var import_operating_system_name = require("./operating-system-name.js");
+var import_operating_system_version = require("./operating-system-version.js");
+var import_power_source = require("./power-source.js");
+var import_processor_speed = require("./processor-speed.js");
+var import_ram_capacity = require("./ram-capacity.js");
+var import_refrigerant = require("./refrigerant.js");
+var import_refrigerant_family = require("./refrigerant-family.js");
+var import_screen_resolution = require("./screen-resolution.js");
+var import_screen_size = require("./screen-size.js");
+var import_shoe_size = require("./shoe-size.js");
+var import_shoe_size_system = require("./shoe-size-system.js");
+var import_storage_capacity = require("./storage-capacity.js");
+var import_storage_media_type = require("./storage-media-type.js");
+var import_product_extensions = require("./product-extensions.js");
+var import_product_masking = require("./product-masking.js");
+//# sourceMappingURL=index.js.map

package/dist/cjs/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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iCAAuE;AACvE,6BAA+D;AAC/D,0BAA2D;AAC3D,8BAAmE;AACnE,+BAAqE;AACrE,+BAAqE;AACrE,iCAAuE;AACvE,6BAA+D;AAC/D,0BAA2D;AAC3D,6BAAiE;AACjE,6BAAiE;AACjE,2BAA6D;AAC7D,kCAAmC;AACnC,mBAA+C;AAC/C,gCAAqE;AACrE,8BAAmE;AACnE,0BAA4B;AAC5B,wCAGO;AACP,qCAGO;AACP,kBAA6C;AAC7C,oBAAiD;AACjD,oBAAiD;AACjD,oBAAiD;AACjD,mBAA+C;AAC/C,qBAAiD;AACjD,2BAA4B;AAC5B,uBAAqD;AACrD,qCAAsC;AACtC,mCAGO;AACP,mCAGO;AACP,sCAGO;AACP,0BAA2D;AAC3D,6BAAiE;AACjE,0BAA2D;AAC3D,yBAA2D;AAC3D,gCAAkC;AAClC,+BAAqE;AACrE,yBAAyD;AACzD,uBAAqD;AACrD,8BAA+B;AAC/B,8BAAmE;AACnE,gCAAqE;AAErE,gCAAmC;AAEnC,6BAmBO;",
+  "names": []
+}

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

@@ -0,0 +1,166 @@
+"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 ip_rating_exports = {};
+__export(ip_rating_exports, {
+  IpRating: () => IpRating
+});
+module.exports = __toCommonJS(ip_rating_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 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((0, import_input_sanitization.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 import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "IpRating",
+          category: import_text_candidate_category.TextCandidateCategory.Product,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: (0, import_product_masking.maskIpRating)(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.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;
+}
+//# sourceMappingURL=ip-rating.js.map