@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/product/screen-size.js

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

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

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

package/dist/esm/product/shoe-size-system.js

@@ -0,0 +1,11 @@
+const ShoeSizeSystem = {
+  Unknown: 0,
+  EU: 1,
+  USMen: 2,
+  USWomen: 3,
+  UK: 4
+};
+export {
+  ShoeSizeSystem
+};
+//# sourceMappingURL=shoe-size-system.js.map

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

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

package/dist/esm/product/shoe-size.js

@@ -0,0 +1,118 @@
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { AdultShoeSize } from "./adult-shoe-size.js";
+import { ChildShoeSize } from "./child-shoe-size.js";
+const ADULT_PREFIX_PATTERN = /^\s*(?:adult|vuxen)\s+/iu;
+const CHILD_PREFIX_PATTERN = /^\s*(?:child|barn)\s+/iu;
+const US_CHILD_HINT_PATTERN = /\bUS\s+[0-9]+(?:[.,][0-9]+)?\s*[CY]\b/iu;
+class ShoeSize {
+  static typeInfo = Object.freeze({
+    englishName: "Shoe Size",
+    localizedName: "Skostorlek",
+    emoji: "\u{1F45F}",
+    sources: Object.freeze([
+      "https://www.iso.org/standard/83106.html",
+      "https://www.iso.org/standard/71594.html",
+      "https://en.wikipedia.org/wiki/Shoe_size"
+    ])
+  });
+  adult;
+  child;
+  constructor(adult, child) {
+    this.adult = adult;
+    this.child = child;
+  }
+  /** `true` when this instance wraps an {@link AdultShoeSize}. */
+  get isAdult() {
+    return this.adult !== null;
+  }
+  /** `true` when this instance wraps a {@link ChildShoeSize}. */
+  get isChild() {
+    return this.child !== null;
+  }
+  /** Display form of the wrapped size, e.g. `EU 42` or `EU 28`. */
+  get value() {
+    return this.adult?.value ?? this.child.value;
+  }
+  /** Returns the adult size when {@link isAdult}, otherwise `null`. */
+  asAdult() {
+    return this.adult;
+  }
+  /** Returns the child size when {@link isChild}, otherwise `null`. */
+  asChild() {
+    return this.child;
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const text = sanitizeInput(input).trim();
+    const adultPrefix = ADULT_PREFIX_PATTERN.exec(text);
+    if (adultPrefix !== null) {
+      const adult2 = AdultShoeSize.tryParse(text.slice(adultPrefix[0].length).trim());
+      return adult2 === null ? null : new ShoeSize(adult2, null);
+    }
+    const childPrefix = CHILD_PREFIX_PATTERN.exec(text);
+    if (childPrefix !== null) {
+      const child2 = ChildShoeSize.tryParse(text.slice(childPrefix[0].length).trim());
+      return child2 === null ? null : new ShoeSize(null, child2);
+    }
+    if (US_CHILD_HINT_PATTERN.test(text)) {
+      const child2 = ChildShoeSize.tryParse(text);
+      if (child2 !== null) return new ShoeSize(null, child2);
+      const adult2 = AdultShoeSize.tryParse(text);
+      return adult2 === null ? null : new ShoeSize(adult2, null);
+    }
+    const adult = AdultShoeSize.tryParse(text);
+    if (adult !== null) return new ShoeSize(adult, null);
+    const child = ChildShoeSize.tryParse(text);
+    return child === null ? null : new ShoeSize(null, child);
+  }
+  static parse(input) {
+    const result = ShoeSize.tryParse(input);
+    if (result === null) throw new Error("Invalid shoe size.");
+    return result;
+  }
+  static isValid(input) {
+    return ShoeSize.tryParse(input) !== null;
+  }
+  /** Returns the canonical EU display of the resolved kind, e.g. `EU 42` or `EU 28`. */
+  static format(input, options) {
+    const r = ShoeSize.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical EU display, the same as {@link format} for this wrapper. */
+  static normalize(input, options) {
+    const r = ShoeSize.tryParse(input);
+    if (r !== null) return r.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && ShoeSize.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    if (other == null) return false;
+    if (this.adult !== null && other.adult !== null) return this.adult.equals(other.adult);
+    if (this.child !== null && other.child !== null) return this.child.equals(other.child);
+    return false;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    if (this.child !== null && other.child !== null) return this.child.compareTo(other.child);
+    if (this.adult !== null && other.adult !== null) return this.adult.compareTo(other.adult);
+    return this.child !== null ? -1 : 1;
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+export {
+  ShoeSize
+};
+//# sourceMappingURL=shoe-size.js.map

package/dist/esm/product/shoe-size.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/shoe-size.ts"],
+  "sourcesContent": ["import { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { AdultShoeSize } from \"./adult-shoe-size.js\";\nimport { ChildShoeSize } from \"./child-shoe-size.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface ShoeSizeFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst ADULT_PREFIX_PATTERN = /^\\s*(?:adult|vuxen)\\s+/iu;\nconst CHILD_PREFIX_PATTERN = /^\\s*(?:child|barn)\\s+/iu;\nconst US_CHILD_HINT_PATTERN = /\\bUS\\s+[0-9]+(?:[.,][0-9]+)?\\s*[CY]\\b/iu;\n\n/**\n * Generic shoe size (`skostorlek`) wrapping either an {@link AdultShoeSize} or a\n * {@link ChildShoeSize}, chosen by parsing heuristics.\n *\n * An explicit `adult`/`vuxen` or `child`/`barn` prefix forces the matching parser. US sizes with\n * a `C` or `Y` suffix are read as children's first; otherwise adult is tried before child, so an\n * unprefixed EU 35\u201339 resolves as adult.\n */\nexport class ShoeSize {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Shoe Size\",\n    localizedName: \"Skostorlek\",\n    emoji: \"\uD83D\uDC5F\",\n    sources: Object.freeze([\n      \"https://www.iso.org/standard/83106.html\",\n      \"https://www.iso.org/standard/71594.html\",\n      \"https://en.wikipedia.org/wiki/Shoe_size\",\n    ]),\n  });\n\n  private readonly adult: AdultShoeSize | null;\n  private readonly child: ChildShoeSize | null;\n\n  private constructor(adult: AdultShoeSize | null, child: ChildShoeSize | null) {\n    this.adult = adult;\n    this.child = child;\n  }\n\n  /** `true` when this instance wraps an {@link AdultShoeSize}. */\n  get isAdult(): boolean {\n    return this.adult !== null;\n  }\n\n  /** `true` when this instance wraps a {@link ChildShoeSize}. */\n  get isChild(): boolean {\n    return this.child !== null;\n  }\n\n  /** Display form of the wrapped size, e.g. `EU 42` or `EU 28`. */\n  get value(): string {\n    return this.adult?.value ?? this.child!.value;\n  }\n\n  /** Returns the adult size when {@link isAdult}, otherwise `null`. */\n  asAdult(): AdultShoeSize | null {\n    return this.adult;\n  }\n\n  /** Returns the child size when {@link isChild}, otherwise `null`. */\n  asChild(): ChildShoeSize | null {\n    return this.child;\n  }\n\n  static tryParse(input: string | null | undefined): ShoeSize | null {\n    if (input == null || input.trim().length === 0) return null;\n\n    const text = sanitizeInput(input).trim();\n\n    const adultPrefix = ADULT_PREFIX_PATTERN.exec(text);\n    if (adultPrefix !== null) {\n      const adult = AdultShoeSize.tryParse(text.slice(adultPrefix[0].length).trim());\n      return adult === null ? null : new ShoeSize(adult, null);\n    }\n\n    const childPrefix = CHILD_PREFIX_PATTERN.exec(text);\n    if (childPrefix !== null) {\n      const child = ChildShoeSize.tryParse(text.slice(childPrefix[0].length).trim());\n      return child === null ? null : new ShoeSize(null, child);\n    }\n\n    if (US_CHILD_HINT_PATTERN.test(text)) {\n      const child = ChildShoeSize.tryParse(text);\n      if (child !== null) return new ShoeSize(null, child);\n\n      const adult = AdultShoeSize.tryParse(text);\n      return adult === null ? null : new ShoeSize(adult, null);\n    }\n\n    const adult = AdultShoeSize.tryParse(text);\n    if (adult !== null) return new ShoeSize(adult, null);\n\n    const child = ChildShoeSize.tryParse(text);\n    return child === null ? null : new ShoeSize(null, child);\n  }\n\n  static parse(input: string): ShoeSize {\n    const result = ShoeSize.tryParse(input);\n    if (result === null) throw new Error(\"Invalid shoe size.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return ShoeSize.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical EU display of the resolved kind, e.g. `EU 42` or `EU 28`. */\n  static format(input: string | null | undefined, options?: ShoeSizeFormatOptions): string | null {\n    const r = ShoeSize.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical EU display, the same as {@link format} for this wrapper. */\n  static normalize(\n    input: string | null | undefined,\n    options?: ShoeSizeFormatOptions,\n  ): string | null {\n    const r = ShoeSize.tryParse(input);\n    if (r !== null) return r.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && ShoeSize.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: ShoeSize | null | undefined): boolean {\n    if (other == null) return false;\n    if (this.adult !== null && other.adult !== null) return this.adult.equals(other.adult);\n    if (this.child !== null && other.child !== null) return this.child.equals(other.child);\n    return false;\n  }\n\n  compareTo(other: ShoeSize | null | undefined): number {\n    if (other == null) return 1;\n    if (this.child !== null && other.child !== null) return this.child.compareTo(other.child);\n    if (this.adult !== null && other.adult !== null) return this.adult.compareTo(other.adult);\n    return this.child !== null ? -1 : 1;\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: ShoeSizeFormatOptions,\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": ["adult", "child"]
+}

package/dist/esm/product/storage-capacity.js

@@ -0,0 +1,139 @@
+import { Decimal } from "../internal/decimal.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { tryParseNumberOnly } from "../internal/measurement-unit-parser.js";
+import { formatQuantityDecimal } from "../internal/quantity.js";
+import { DataSize } from "../measurement/data-size.js";
+import { DataSizeUnit } from "../measurement/data-size-unit.js";
+class StorageCapacity {
+  static typeInfo = Object.freeze({
+    englishName: "Storage Capacity",
+    localizedName: "Lagringskapacitet",
+    emoji: "\u{1F4BE}",
+    sources: Object.freeze([])
+  });
+  /** The underlying data size. */
+  size;
+  /** Display form preserving the parsed unit, e.g. `512 GB`. */
+  value;
+  constructor(size, displayValue) {
+    this.size = size;
+    this.value = displayValue ?? size.toString();
+  }
+  get bytes() {
+    return this.size.bytes;
+  }
+  get gigabytes() {
+    return this.size.gigabytes;
+  }
+  get terabytes() {
+    return this.size.terabytes;
+  }
+  /** Creates a capacity from a value and data size unit. The value must be positive. */
+  static create(value, unit) {
+    const amount = value instanceof Decimal ? value : decimalOf(value);
+    if (amount.compareTo(Decimal.zero) <= 0) throw new Error("Storage capacity must be positive.");
+    return new StorageCapacity(DataSize.create(amount, unit));
+  }
+  static fromMegabytes(value) {
+    return StorageCapacity.create(value, DataSizeUnit.Megabyte);
+  }
+  static fromGigabytes(value) {
+    return StorageCapacity.create(value, DataSizeUnit.Gigabyte);
+  }
+  static fromTerabytes(value) {
+    return StorageCapacity.create(value, DataSizeUnit.Terabyte);
+  }
+  static tryParse(input) {
+    if (input == null || input.trim().length === 0) return null;
+    const trimmed = sanitizeInput(input).trim();
+    const bare = tryParseNumberOnly(trimmed);
+    if (bare !== null) {
+      if (bare.compareTo(Decimal.zero) <= 0) return null;
+      return new StorageCapacity(DataSize.fromGigabytes(bare), `${formatQuantityDecimal(bare)} GB`);
+    }
+    const parsed = DataSize.tryParse(trimmed);
+    if (parsed === null || parsed.bytes <= 0) return null;
+    return new StorageCapacity(parsed);
+  }
+  static parse(input) {
+    const result = StorageCapacity.tryParse(input);
+    if (result === null) throw new Error("Invalid storage capacity.");
+    return result;
+  }
+  static isValid(input) {
+    return StorageCapacity.tryParse(input) !== null;
+  }
+  /** Returns the display form, e.g. `512 GB`. Returns `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = StorageCapacity.tryParse(input);
+    if (parsed !== null) {
+      if (options?.unit !== void 0 || options?.decimals !== void 0) {
+        return parsed.size.toStringInUnit(
+          options.unit ?? parsed.size.originalUnit,
+          options.decimals
+        );
+      }
+      return parsed.value;
+    }
+    return fallback(input, options);
+  }
+  /** Returns the value in bytes, e.g. `512000000000 B`. Returns `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = StorageCapacity.tryParse(input);
+    if (parsed !== null) return parsed.size.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && StorageCapacity.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.size.toNormalizedString();
+  }
+  toString() {
+    return this.value;
+  }
+  /** Returns the value in the most readable unit, e.g. `512 GB` rather than `512000000000 B`. */
+  toNaturalString(decimals) {
+    return this.size.toNaturalString(decimals);
+  }
+  plus(other) {
+    return new StorageCapacity(this.size.plus(other.size));
+  }
+  minus(other) {
+    return new StorageCapacity(this.size.minus(other.size));
+  }
+  times(factor) {
+    return new StorageCapacity(
+      this.size.times(factor instanceof Decimal ? factor : decimalOf(factor))
+    );
+  }
+  dividedBy(divisor) {
+    return new StorageCapacity(
+      this.size.dividedBy(divisor instanceof Decimal ? divisor : decimalOf(divisor))
+    );
+  }
+  negated() {
+    return new StorageCapacity(this.size.negated());
+  }
+  equals(other) {
+    return other != null && this.size.equals(other.size);
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.size.compareTo(other.size);
+  }
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function decimalOf(value) {
+  const parsed = Decimal.fromNumber(value);
+  if (parsed === null) throw new Error(`Value cannot be represented as a capacity: ${value}`);
+  return parsed;
+}
+export {
+  StorageCapacity
+};
+//# sourceMappingURL=storage-capacity.js.map

package/dist/esm/product/storage-capacity.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/storage-capacity.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { tryParseNumberOnly } from \"../internal/measurement-unit-parser.js\";\nimport { formatQuantityDecimal } from \"../internal/quantity.js\";\nimport { DataSize } from \"../measurement/data-size.js\";\nimport { DataSizeUnit } from \"../measurement/data-size-unit.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options for {@link StorageCapacity.format} and {@link StorageCapacity.normalize}. */\nexport interface StorageCapacityFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: DataSizeUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\n/**\n * Storage capacity for hard drives, SSDs and USB drives (`lagringskapacitet`), e.g. `512 GB`\n * or `1 TB`. A bare number is read as gigabytes.\n */\nexport class StorageCapacity {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Storage Capacity\",\n    localizedName: \"Lagringskapacitet\",\n    emoji: \"\uD83D\uDCBE\",\n    sources: Object.freeze([]),\n  });\n\n  /** The underlying data size. */\n  readonly size: DataSize;\n\n  /** Display form preserving the parsed unit, e.g. `512 GB`. */\n  readonly value: string;\n\n  private constructor(size: DataSize, displayValue?: string) {\n    this.size = size;\n    this.value = displayValue ?? size.toString();\n  }\n\n  get bytes(): number {\n    return this.size.bytes;\n  }\n\n  get gigabytes(): number {\n    return this.size.gigabytes;\n  }\n\n  get terabytes(): number {\n    return this.size.terabytes;\n  }\n\n  /** Creates a capacity from a value and data size unit. The value must be positive. */\n  static create(value: number | Decimal, unit: DataSizeUnit): StorageCapacity {\n    const amount = value instanceof Decimal ? value : decimalOf(value);\n    if (amount.compareTo(Decimal.zero) <= 0) throw new Error(\"Storage capacity must be positive.\");\n    return new StorageCapacity(DataSize.create(amount, unit));\n  }\n\n  static fromMegabytes(value: number | Decimal): StorageCapacity {\n    return StorageCapacity.create(value, DataSizeUnit.Megabyte);\n  }\n\n  static fromGigabytes(value: number | Decimal): StorageCapacity {\n    return StorageCapacity.create(value, DataSizeUnit.Gigabyte);\n  }\n\n  static fromTerabytes(value: number | Decimal): StorageCapacity {\n    return StorageCapacity.create(value, DataSizeUnit.Terabyte);\n  }\n\n  static tryParse(input: string | null | undefined): StorageCapacity | null {\n    if (input == null || input.trim().length === 0) return null;\n    const trimmed = sanitizeInput(input).trim();\n\n    const bare = tryParseNumberOnly(trimmed);\n    if (bare !== null) {\n      if (bare.compareTo(Decimal.zero) <= 0) return null;\n      return new StorageCapacity(DataSize.fromGigabytes(bare), `${formatQuantityDecimal(bare)} GB`);\n    }\n\n    const parsed = DataSize.tryParse(trimmed);\n    if (parsed === null || parsed.bytes <= 0) return null;\n    return new StorageCapacity(parsed);\n  }\n\n  static parse(input: string): StorageCapacity {\n    const result = StorageCapacity.tryParse(input);\n    if (result === null) throw new Error(\"Invalid storage capacity.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return StorageCapacity.tryParse(input) !== null;\n  }\n\n  /** Returns the display form, e.g. `512 GB`. Returns `null` when the input is invalid. */\n  static format(\n    input: string | null | undefined,\n    options?: StorageCapacityFormatOptions,\n  ): string | null {\n    const parsed = StorageCapacity.tryParse(input);\n    if (parsed !== null) {\n      if (options?.unit !== undefined || options?.decimals !== undefined) {\n        return parsed.size.toStringInUnit(\n          options.unit ?? parsed.size.originalUnit,\n          options.decimals,\n        );\n      }\n      return parsed.value;\n    }\n    return fallback(input, options);\n  }\n\n  /** Returns the value in bytes, e.g. `512000000000 B`. Returns `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: StorageCapacityFormatOptions,\n  ): string | null {\n    const parsed = StorageCapacity.tryParse(input);\n    if (parsed !== null) return parsed.size.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && StorageCapacity.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.size.toNormalizedString();\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  /** Returns the value in the most readable unit, e.g. `512 GB` rather than `512000000000 B`. */\n  toNaturalString(decimals?: number): string {\n    return this.size.toNaturalString(decimals);\n  }\n\n  plus(other: StorageCapacity): StorageCapacity {\n    return new StorageCapacity(this.size.plus(other.size));\n  }\n\n  minus(other: StorageCapacity): StorageCapacity {\n    return new StorageCapacity(this.size.minus(other.size));\n  }\n\n  times(factor: number | Decimal): StorageCapacity {\n    return new StorageCapacity(\n      this.size.times(factor instanceof Decimal ? factor : decimalOf(factor)),\n    );\n  }\n\n  dividedBy(divisor: number | Decimal): StorageCapacity {\n    return new StorageCapacity(\n      this.size.dividedBy(divisor instanceof Decimal ? divisor : decimalOf(divisor)),\n    );\n  }\n\n  negated(): StorageCapacity {\n    return new StorageCapacity(this.size.negated());\n  }\n\n  equals(other: StorageCapacity | null | undefined): boolean {\n    return other != null && this.size.equals(other.size);\n  }\n\n  compareTo(other: StorageCapacity | null | undefined): number {\n    if (other == null) return 1;\n    return this.size.compareTo(other.size);\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: StorageCapacityFormatOptions,\n): string | null {\n  if (options?.fallbackToTrimmedInputWhenInvalid !== true || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction decimalOf(value: number): Decimal {\n  const parsed = Decimal.fromNumber(value);\n  if (parsed === null) throw new Error(`Value cannot be represented as a capacity: ${value}`);\n  return parsed;\n}\n"],
+  "mappings": "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",
+  "names": []
+}