@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/esm/product/aspect-ratio.js

@@ -0,0 +1,168 @@
+import { Decimal } from "../internal/decimal.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+const INTEGER_COLON_PATTERN = /^\s*(\d{1,3})\s*[:xX×/]\s*(\d{1,3})\s*$/u;
+const DECIMAL_PATTERN = /^\s*(\d+(?:[.,]\d+)?)\s*(?::\s*1)?\s*$/u;
+const WHITESPACE_PATTERN = /\s+/gu;
+const DECIMAL_TOLERANCE = Decimal.parse("0.02");
+class AspectRatio {
+  static typeInfo = Object.freeze({
+    englishName: "Aspect Ratio",
+    localizedName: "Bildformat",
+    emoji: "\u{1F5A5}\uFE0F",
+    sources: Object.freeze(["https://www.itu.int/rec/R-REC-BT.709"])
+  });
+  /** Canonical width:height form, e.g. `16:9`. */
+  value;
+  /** Width component, e.g. `16`. */
+  width;
+  /** Height component, e.g. `9`. */
+  height;
+  /** Common name when available, e.g. `Widescreen` for `16:9`; otherwise `null`. */
+  commonName;
+  constructor(value, width, height, commonName) {
+    this.value = value;
+    this.width = width;
+    this.height = height;
+    this.commonName = commonName;
+  }
+  static OneToOne = new AspectRatio("1:1", 1, 1, "Square");
+  static FourThree = new AspectRatio("4:3", 4, 3, "Standard");
+  static FiveFour = new AspectRatio("5:4", 5, 4, "Computer Standard");
+  static ThreeTwo = new AspectRatio("3:2", 3, 2, "Classic 35 mm");
+  static SixteenTen = new AspectRatio("16:10", 16, 10, "Widescreen Computer");
+  static SixteenNine = new AspectRatio("16:9", 16, 9, "Widescreen");
+  static EighteenNine = new AspectRatio("18:9", 18, 9, "Univisium");
+  static TwentyOneNine = new AspectRatio("21:9", 21, 9, "Ultrawide");
+  static ThirtyTwoNine = new AspectRatio("32:9", 32, 9, "Super Ultrawide");
+  static NineSixteen = new AspectRatio("9:16", 9, 16, "Vertical");
+  static NineEighteen = new AspectRatio("9:18", 9, 18, "Vertical Tall");
+  /** All 11 predefined ratios, in canonical order. */
+  static get all() {
+    return ALL;
+  }
+  /** Numeric ratio ({@link width} divided by {@link height}), e.g. `1.7777…`. */
+  get ratio() {
+    return Decimal.fromNumber(this.width).dividedBy(Decimal.fromNumber(this.height));
+  }
+  /**
+   * Resolves a ratio from a `width:height`, `width/height` or `width x height` form, or from a
+   * decimal ratio close enough to one of the canonical values.
+   */
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = sanitizeInput(input).trim();
+    if (trimmed.length === 0) return null;
+    const fromLookup = LOOKUP.get(normalizeLookupKey(trimmed));
+    if (fromLookup !== void 0) return fromLookup;
+    const integers = INTEGER_COLON_PATTERN.exec(trimmed);
+    if (integers !== null) {
+      const width = Number(integers[1]);
+      const height = Number(integers[2]);
+      if (width > 0 && height > 0) return reduceToCanonical(width, height);
+      return null;
+    }
+    const decimals = DECIMAL_PATTERN.exec(trimmed);
+    if (decimals !== null) {
+      const ratio = Decimal.parse(decimals[1].replace(",", "."));
+      if (ratio !== null && !ratio.isZero && !ratio.isNegative) return matchByDecimal(ratio);
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = AspectRatio.tryParse(input);
+    if (result === null) throw new Error("Invalid aspect ratio.");
+    return result;
+  }
+  static isValid(input) {
+    return AspectRatio.tryParse(input) !== null;
+  }
+  /** Returns the canonical width:height form, e.g. `16:9`. */
+  static format(input, options) {
+    const r = AspectRatio.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  /** Returns the canonical width:height form, e.g. `16:9`. */
+  static normalize(input, options) {
+    const r = AspectRatio.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && AspectRatio.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  equals(other) {
+    return other != null && this.width === other.width && this.height === other.height;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.ratio.compareTo(other.ratio);
+  }
+}
+const ALL = [
+  AspectRatio.OneToOne,
+  AspectRatio.FourThree,
+  AspectRatio.FiveFour,
+  AspectRatio.ThreeTwo,
+  AspectRatio.SixteenTen,
+  AspectRatio.SixteenNine,
+  AspectRatio.EighteenNine,
+  AspectRatio.TwentyOneNine,
+  AspectRatio.ThirtyTwoNine,
+  AspectRatio.NineSixteen,
+  AspectRatio.NineEighteen
+];
+function fallback(input, options) {
+  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeLookupKey(value) {
+  return value.trim().toLowerCase().replace(WHITESPACE_PATTERN, "");
+}
+function greatestCommonDivisor(a, b) {
+  let x = a;
+  let y = b;
+  while (y !== 0) [x, y] = [y, x % y];
+  return x;
+}
+function reduceToCanonical(width, height) {
+  const divisor = greatestCommonDivisor(width, height);
+  const w = width / divisor;
+  const h = height / divisor;
+  return ALL.find((r) => r.width === w && r.height === h) ?? null;
+}
+function matchByDecimal(ratio) {
+  let best = null;
+  let bestDifference = null;
+  for (const candidate of ALL) {
+    const difference = candidate.ratio.minus(ratio).abs();
+    if (bestDifference === null || difference.compareTo(bestDifference) < 0) {
+      bestDifference = difference;
+      best = candidate;
+    }
+  }
+  if (bestDifference === null || bestDifference.compareTo(DECIMAL_TOLERANCE) > 0) return null;
+  return best;
+}
+const LOOKUP = /* @__PURE__ */ new Map();
+for (const ratio of ALL) {
+  for (const key of [
+    ratio.value,
+    `${ratio.width}/${ratio.height}`,
+    `${ratio.width}x${ratio.height}`
+  ]) {
+    const folded = normalizeLookupKey(key);
+    if (folded.length > 0 && !LOOKUP.has(folded)) LOOKUP.set(folded, ratio);
+  }
+}
+export {
+  AspectRatio
+};
+//# sourceMappingURL=aspect-ratio.js.map

package/dist/esm/product/aspect-ratio.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/aspect-ratio.ts"],
+  "sourcesContent": ["import type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\n\n/** Options shared by the string-in, string-out helpers. */\nexport interface AspectRatioFormatOptions {\n  /** Return the trimmed original input instead of `null` when the input is invalid. */\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst INTEGER_COLON_PATTERN = /^\\s*(\\d{1,3})\\s*[:xX\u00D7/]\\s*(\\d{1,3})\\s*$/u;\nconst DECIMAL_PATTERN = /^\\s*(\\d+(?:[.,]\\d+)?)\\s*(?::\\s*1)?\\s*$/u;\nconst WHITESPACE_PATTERN = /\\s+/gu;\n\n/** Widest gap between a decimal input and a canonical ratio that still counts as a match. */\nconst DECIMAL_TOLERANCE = Decimal.parse(\"0.02\")!;\n\n/**\n * A display or image aspect ratio (`bildformat`) expressed as `width:height`, e.g. `16:9`,\n * `4:3`, `21:9`. Accepts colon, slash and `x`-separated forms, as well as decimal ratios such\n * as `1.78` or `1.78:1`. Decimal inputs snap to the closest known ratio within a small\n * tolerance, so `1.7777` and `16:9` do not become separate values.\n */\nexport class AspectRatio {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Aspect Ratio\",\n    localizedName: \"Bildformat\",\n    emoji: \"\uD83D\uDDA5\uFE0F\",\n    sources: Object.freeze([\"https://www.itu.int/rec/R-REC-BT.709\"]),\n  });\n\n  /** Canonical width:height form, e.g. `16:9`. */\n  readonly value: string;\n\n  /** Width component, e.g. `16`. */\n  readonly width: number;\n\n  /** Height component, e.g. `9`. */\n  readonly height: number;\n\n  /** Common name when available, e.g. `Widescreen` for `16:9`; otherwise `null`. */\n  readonly commonName: string | null;\n\n  private constructor(value: string, width: number, height: number, commonName: string | null) {\n    this.value = value;\n    this.width = width;\n    this.height = height;\n    this.commonName = commonName;\n  }\n\n  static readonly OneToOne = new AspectRatio(\"1:1\", 1, 1, \"Square\");\n  static readonly FourThree = new AspectRatio(\"4:3\", 4, 3, \"Standard\");\n  static readonly FiveFour = new AspectRatio(\"5:4\", 5, 4, \"Computer Standard\");\n  static readonly ThreeTwo = new AspectRatio(\"3:2\", 3, 2, \"Classic 35 mm\");\n  static readonly SixteenTen = new AspectRatio(\"16:10\", 16, 10, \"Widescreen Computer\");\n  static readonly SixteenNine = new AspectRatio(\"16:9\", 16, 9, \"Widescreen\");\n  static readonly EighteenNine = new AspectRatio(\"18:9\", 18, 9, \"Univisium\");\n  static readonly TwentyOneNine = new AspectRatio(\"21:9\", 21, 9, \"Ultrawide\");\n  static readonly ThirtyTwoNine = new AspectRatio(\"32:9\", 32, 9, \"Super Ultrawide\");\n  static readonly NineSixteen = new AspectRatio(\"9:16\", 9, 16, \"Vertical\");\n  static readonly NineEighteen = new AspectRatio(\"9:18\", 9, 18, \"Vertical Tall\");\n\n  /** All 11 predefined ratios, in canonical order. */\n  static get all(): readonly AspectRatio[] {\n    return ALL;\n  }\n\n  /** Numeric ratio ({@link width} divided by {@link height}), e.g. `1.7777\u2026`. */\n  get ratio(): Decimal {\n    return Decimal.fromNumber(this.width)!.dividedBy(Decimal.fromNumber(this.height)!);\n  }\n\n  /**\n   * Resolves a ratio from a `width:height`, `width/height` or `width x height` form, or from a\n   * decimal ratio close enough to one of the canonical values.\n   */\n  static tryParse(input: string | null | undefined): AspectRatio | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0) return null;\n\n    const fromLookup = LOOKUP.get(normalizeLookupKey(trimmed));\n    if (fromLookup !== undefined) return fromLookup;\n\n    const integers = INTEGER_COLON_PATTERN.exec(trimmed);\n    if (integers !== null) {\n      const width = Number(integers[1]);\n      const height = Number(integers[2]);\n      if (width > 0 && height > 0) return reduceToCanonical(width, height);\n      return null;\n    }\n\n    const decimals = DECIMAL_PATTERN.exec(trimmed);\n    if (decimals !== null) {\n      const ratio = Decimal.parse(decimals[1]!.replace(\",\", \".\"));\n      if (ratio !== null && !ratio.isZero && !ratio.isNegative) return matchByDecimal(ratio);\n    }\n\n    return null;\n  }\n\n  static parse(input: string): AspectRatio {\n    const result = AspectRatio.tryParse(input);\n    if (result === null) throw new Error(\"Invalid aspect ratio.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return AspectRatio.tryParse(input) !== null;\n  }\n\n  /** Returns the canonical width:height form, e.g. `16:9`. */\n  static format(\n    input: string | null | undefined,\n    options?: AspectRatioFormatOptions,\n  ): string | null {\n    const r = AspectRatio.tryParse(input);\n    if (r !== null) return r.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the canonical width:height form, e.g. `16:9`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: AspectRatioFormatOptions,\n  ): string | null {\n    const r = AspectRatio.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 && AspectRatio.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: AspectRatio | null | undefined): boolean {\n    return other != null && this.width === other.width && this.height === other.height;\n  }\n\n  compareTo(other: AspectRatio | null | undefined): number {\n    if (other == null) return 1;\n    return this.ratio.compareTo(other.ratio);\n  }\n}\n\nconst ALL: readonly AspectRatio[] = [\n  AspectRatio.OneToOne,\n  AspectRatio.FourThree,\n  AspectRatio.FiveFour,\n  AspectRatio.ThreeTwo,\n  AspectRatio.SixteenTen,\n  AspectRatio.SixteenNine,\n  AspectRatio.EighteenNine,\n  AspectRatio.TwentyOneNine,\n  AspectRatio.ThirtyTwoNine,\n  AspectRatio.NineSixteen,\n  AspectRatio.NineEighteen,\n];\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: AspectRatioFormatOptions,\n): string | null {\n  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;\n  const trimmed = input.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction normalizeLookupKey(value: string): string {\n  return value.trim().toLowerCase().replace(WHITESPACE_PATTERN, \"\");\n}\n\nfunction greatestCommonDivisor(a: number, b: number): number {\n  let x = a;\n  let y = b;\n  while (y !== 0) [x, y] = [y, x % y];\n  return x;\n}\n\nfunction reduceToCanonical(width: number, height: number): AspectRatio | null {\n  const divisor = greatestCommonDivisor(width, height);\n  const w = width / divisor;\n  const h = height / divisor;\n  return ALL.find((r) => r.width === w && r.height === h) ?? null;\n}\n\nfunction matchByDecimal(ratio: Decimal): AspectRatio | null {\n  let best: AspectRatio | null = null;\n  let bestDifference: Decimal | null = null;\n  for (const candidate of ALL) {\n    const difference = candidate.ratio.minus(ratio).abs();\n    if (bestDifference === null || difference.compareTo(bestDifference) < 0) {\n      bestDifference = difference;\n      best = candidate;\n    }\n  }\n  if (bestDifference === null || bestDifference.compareTo(DECIMAL_TOLERANCE) > 0) return null;\n  return best;\n}\n\nconst LOOKUP = new Map<string, AspectRatio>();\nfor (const ratio of ALL) {\n  for (const key of [\n    ratio.value,\n    `${ratio.width}/${ratio.height}`,\n    `${ratio.width}x${ratio.height}`,\n  ]) {\n    const folded = normalizeLookupKey(key);\n    if (folded.length > 0 && !LOOKUP.has(folded)) LOOKUP.set(folded, ratio);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/product/battery-capacity.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 { ElectricCharge } from "../measurement/electric-charge.js";
+import { Energy } from "../measurement/energy.js";
+class BatteryCapacity {
+  static typeInfo = Object.freeze({
+    englishName: "Battery Capacity",
+    localizedName: "Batterikapacitet",
+    emoji: "\u{1F50B}",
+    sources: Object.freeze([])
+  });
+  /** The charge, when parsed from charge units; `null` when parsed from energy units. */
+  charge;
+  /** The energy, when parsed from energy units; `null` when parsed from charge units. */
+  energy;
+  /** Display form preserving the parsed unit, e.g. `5000 mAh` or `50 Wh`. */
+  value;
+  constructor(charge, energy, displayValue) {
+    this.charge = charge;
+    this.energy = energy;
+    this.value = displayValue;
+  }
+  static ofCharge(charge, displayValue) {
+    return new BatteryCapacity(charge, null, displayValue ?? charge.toString());
+  }
+  static ofEnergy(energy, displayValue) {
+    return new BatteryCapacity(null, energy, displayValue ?? energy.toString());
+  }
+  /** Creates a capacity from milliampere-hours. The value must be positive. */
+  static fromMilliampereHours(value) {
+    return BatteryCapacity.ofCharge(ElectricCharge.fromMilliampereHours(positive(value)));
+  }
+  /** Creates a capacity from ampere-hours. The value must be positive. */
+  static fromAmpereHours(value) {
+    return BatteryCapacity.ofCharge(ElectricCharge.fromAmpereHours(positive(value)));
+  }
+  /** Creates a capacity from watt-hours. The value must be positive. */
+  static fromWattHours(value) {
+    return BatteryCapacity.ofEnergy(Energy.fromWattHours(positive(value)));
+  }
+  /** Creates a capacity from kilowatt-hours. The value must be positive. */
+  static fromKilowattHours(value) {
+    return BatteryCapacity.ofEnergy(Energy.fromKilowattHours(positive(value)));
+  }
+  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;
+      const display = `${formatQuantityDecimal(bare)} mAh`;
+      return BatteryCapacity.ofCharge(ElectricCharge.parse(display), display);
+    }
+    const charge = ElectricCharge.tryParse(trimmed);
+    if (charge !== null) {
+      if (charge.ampereHours <= 0) return null;
+      return BatteryCapacity.ofCharge(charge);
+    }
+    const energy = Energy.tryParse(trimmed);
+    if (energy !== null) {
+      if (energy.joules <= 0) return null;
+      return BatteryCapacity.ofEnergy(energy);
+    }
+    return null;
+  }
+  static parse(input) {
+    const result = BatteryCapacity.tryParse(input);
+    if (result === null) throw new Error("Invalid battery capacity.");
+    return result;
+  }
+  static isValid(input) {
+    return BatteryCapacity.tryParse(input) !== null;
+  }
+  /** Returns the display form, e.g. `5000 mAh` or `50 Wh`. Returns `null` when invalid. */
+  static format(input, options) {
+    const parsed = BatteryCapacity.tryParse(input);
+    if (parsed !== null) return parsed.value;
+    return fallback(input, options);
+  }
+  /** Returns the value in base units, e.g. `18000 C` or `180000 J`. Returns `null` when invalid. */
+  static normalize(input, options) {
+    const parsed = BatteryCapacity.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && BatteryCapacity.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.charge !== null ? this.charge.toNormalizedString() : this.energy.toNormalizedString();
+  }
+  toString() {
+    return this.value;
+  }
+  /** Returns the value in the most readable unit, e.g. `5000 mAh` or `50 Wh`. */
+  toNaturalString(decimals) {
+    return this.charge !== null ? this.charge.toNaturalString(decimals) : this.energy.toNaturalString(decimals);
+  }
+  /** Adding a charge-based capacity to an energy-based one throws, as the two do not convert. */
+  plus(other) {
+    if (this.charge !== null && other.charge !== null) {
+      return BatteryCapacity.ofCharge(this.charge.plus(other.charge));
+    }
+    if (this.energy !== null && other.energy !== null) {
+      return BatteryCapacity.ofEnergy(this.energy.plus(other.energy));
+    }
+    throw new Error("Cannot combine charge-based and energy-based battery capacities.");
+  }
+  minus(other) {
+    if (this.charge !== null && other.charge !== null) {
+      return BatteryCapacity.ofCharge(this.charge.minus(other.charge));
+    }
+    if (this.energy !== null && other.energy !== null) {
+      return BatteryCapacity.ofEnergy(this.energy.minus(other.energy));
+    }
+    throw new Error("Cannot combine charge-based and energy-based battery capacities.");
+  }
+  times(factor) {
+    const amount = factor instanceof Decimal ? factor : decimalOf(factor);
+    return this.charge !== null ? BatteryCapacity.ofCharge(this.charge.times(amount)) : BatteryCapacity.ofEnergy(this.energy.times(amount));
+  }
+  dividedBy(divisor) {
+    const amount = divisor instanceof Decimal ? divisor : decimalOf(divisor);
+    return this.charge !== null ? BatteryCapacity.ofCharge(this.charge.dividedBy(amount)) : BatteryCapacity.ofEnergy(this.energy.dividedBy(amount));
+  }
+  negated() {
+    return this.charge !== null ? BatteryCapacity.ofCharge(this.charge.negated()) : BatteryCapacity.ofEnergy(this.energy.negated());
+  }
+  /** Capacities of different kinds are never equal, even when they describe the same battery. */
+  equals(other) {
+    if (other == null) return false;
+    if (this.charge !== null && other.charge !== null) return this.charge.equals(other.charge);
+    if (this.energy !== null && other.energy !== null) return this.energy.equals(other.energy);
+    return false;
+  }
+  /** Orders by normalized string, which keeps charge and energy values apart. */
+  compareTo(other) {
+    if (other == null) return 1;
+    const a = this.toNormalizedString();
+    const b = other.toNormalizedString();
+    return a < b ? -1 : a > b ? 1 : 0;
+  }
+}
+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;
+}
+function positive(value) {
+  const amount = value instanceof Decimal ? value : decimalOf(value);
+  if (amount.compareTo(Decimal.zero) <= 0) throw new Error("Battery capacity must be positive.");
+  return amount;
+}
+export {
+  BatteryCapacity
+};
+//# sourceMappingURL=battery-capacity.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/product/battery-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 { ElectricCharge } from \"../measurement/electric-charge.js\";\nimport { Energy } from \"../measurement/energy.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\n/** Options for {@link BatteryCapacity.format} and {@link BatteryCapacity.normalize}. */\nexport interface BatteryCapacityFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\n/**\n * Battery capacity (`batterikapacitet`) expressed either as charge (`5000 mAh`, `5 Ah`) or as\n * energy (`50 Wh`, `75 kWh`). A bare number is read as milliampere-hours. Which of the two a\n * value carries depends on the unit it was parsed from, and the two never mix.\n */\nexport class BatteryCapacity {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Battery Capacity\",\n    localizedName: \"Batterikapacitet\",\n    emoji: \"\uD83D\uDD0B\",\n    sources: Object.freeze([]),\n  });\n\n  /** The charge, when parsed from charge units; `null` when parsed from energy units. */\n  readonly charge: ElectricCharge | null;\n\n  /** The energy, when parsed from energy units; `null` when parsed from charge units. */\n  readonly energy: Energy | null;\n\n  /** Display form preserving the parsed unit, e.g. `5000 mAh` or `50 Wh`. */\n  readonly value: string;\n\n  private constructor(charge: ElectricCharge | null, energy: Energy | null, displayValue: string) {\n    this.charge = charge;\n    this.energy = energy;\n    this.value = displayValue;\n  }\n\n  private static ofCharge(charge: ElectricCharge, displayValue?: string): BatteryCapacity {\n    return new BatteryCapacity(charge, null, displayValue ?? charge.toString());\n  }\n\n  private static ofEnergy(energy: Energy, displayValue?: string): BatteryCapacity {\n    return new BatteryCapacity(null, energy, displayValue ?? energy.toString());\n  }\n\n  /** Creates a capacity from milliampere-hours. The value must be positive. */\n  static fromMilliampereHours(value: number | Decimal): BatteryCapacity {\n    return BatteryCapacity.ofCharge(ElectricCharge.fromMilliampereHours(positive(value)));\n  }\n\n  /** Creates a capacity from ampere-hours. The value must be positive. */\n  static fromAmpereHours(value: number | Decimal): BatteryCapacity {\n    return BatteryCapacity.ofCharge(ElectricCharge.fromAmpereHours(positive(value)));\n  }\n\n  /** Creates a capacity from watt-hours. The value must be positive. */\n  static fromWattHours(value: number | Decimal): BatteryCapacity {\n    return BatteryCapacity.ofEnergy(Energy.fromWattHours(positive(value)));\n  }\n\n  /** Creates a capacity from kilowatt-hours. The value must be positive. */\n  static fromKilowattHours(value: number | Decimal): BatteryCapacity {\n    return BatteryCapacity.ofEnergy(Energy.fromKilowattHours(positive(value)));\n  }\n\n  static tryParse(input: string | null | undefined): BatteryCapacity | 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      const display = `${formatQuantityDecimal(bare)} mAh`;\n      return BatteryCapacity.ofCharge(ElectricCharge.parse(display), display);\n    }\n\n    const charge = ElectricCharge.tryParse(trimmed);\n    if (charge !== null) {\n      if (charge.ampereHours <= 0) return null;\n      return BatteryCapacity.ofCharge(charge);\n    }\n\n    const energy = Energy.tryParse(trimmed);\n    if (energy !== null) {\n      if (energy.joules <= 0) return null;\n      return BatteryCapacity.ofEnergy(energy);\n    }\n\n    return null;\n  }\n\n  static parse(input: string): BatteryCapacity {\n    const result = BatteryCapacity.tryParse(input);\n    if (result === null) throw new Error(\"Invalid battery capacity.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return BatteryCapacity.tryParse(input) !== null;\n  }\n\n  /** Returns the display form, e.g. `5000 mAh` or `50 Wh`. Returns `null` when invalid. */\n  static format(\n    input: string | null | undefined,\n    options?: BatteryCapacityFormatOptions,\n  ): string | null {\n    const parsed = BatteryCapacity.tryParse(input);\n    if (parsed !== null) return parsed.value;\n    return fallback(input, options);\n  }\n\n  /** Returns the value in base units, e.g. `18000 C` or `180000 J`. Returns `null` when invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: BatteryCapacityFormatOptions,\n  ): string | null {\n    const parsed = BatteryCapacity.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && BatteryCapacity.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.charge !== null\n      ? this.charge.toNormalizedString()\n      : this.energy!.toNormalizedString();\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  /** Returns the value in the most readable unit, e.g. `5000 mAh` or `50 Wh`. */\n  toNaturalString(decimals?: number): string {\n    return this.charge !== null\n      ? this.charge.toNaturalString(decimals)\n      : this.energy!.toNaturalString(decimals);\n  }\n\n  /** Adding a charge-based capacity to an energy-based one throws, as the two do not convert. */\n  plus(other: BatteryCapacity): BatteryCapacity {\n    if (this.charge !== null && other.charge !== null) {\n      return BatteryCapacity.ofCharge(this.charge.plus(other.charge));\n    }\n    if (this.energy !== null && other.energy !== null) {\n      return BatteryCapacity.ofEnergy(this.energy.plus(other.energy));\n    }\n    throw new Error(\"Cannot combine charge-based and energy-based battery capacities.\");\n  }\n\n  minus(other: BatteryCapacity): BatteryCapacity {\n    if (this.charge !== null && other.charge !== null) {\n      return BatteryCapacity.ofCharge(this.charge.minus(other.charge));\n    }\n    if (this.energy !== null && other.energy !== null) {\n      return BatteryCapacity.ofEnergy(this.energy.minus(other.energy));\n    }\n    throw new Error(\"Cannot combine charge-based and energy-based battery capacities.\");\n  }\n\n  times(factor: number | Decimal): BatteryCapacity {\n    const amount = factor instanceof Decimal ? factor : decimalOf(factor);\n    return this.charge !== null\n      ? BatteryCapacity.ofCharge(this.charge.times(amount))\n      : BatteryCapacity.ofEnergy(this.energy!.times(amount));\n  }\n\n  dividedBy(divisor: number | Decimal): BatteryCapacity {\n    const amount = divisor instanceof Decimal ? divisor : decimalOf(divisor);\n    return this.charge !== null\n      ? BatteryCapacity.ofCharge(this.charge.dividedBy(amount))\n      : BatteryCapacity.ofEnergy(this.energy!.dividedBy(amount));\n  }\n\n  negated(): BatteryCapacity {\n    return this.charge !== null\n      ? BatteryCapacity.ofCharge(this.charge.negated())\n      : BatteryCapacity.ofEnergy(this.energy!.negated());\n  }\n\n  /** Capacities of different kinds are never equal, even when they describe the same battery. */\n  equals(other: BatteryCapacity | null | undefined): boolean {\n    if (other == null) return false;\n    if (this.charge !== null && other.charge !== null) return this.charge.equals(other.charge);\n    if (this.energy !== null && other.energy !== null) return this.energy.equals(other.energy);\n    return false;\n  }\n\n  /** Orders by normalized string, which keeps charge and energy values apart. */\n  compareTo(other: BatteryCapacity | null | undefined): number {\n    if (other == null) return 1;\n    const a = this.toNormalizedString();\n    const b = other.toNormalizedString();\n    return a < b ? -1 : a > b ? 1 : 0;\n  }\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: BatteryCapacityFormatOptions,\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\nfunction positive(value: number | Decimal): Decimal {\n  const amount = value instanceof Decimal ? value : decimalOf(value);\n  if (amount.compareTo(Decimal.zero) <= 0) throw new Error(\"Battery capacity must be positive.\");\n  return amount;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/product/battery-chemistry.js

@@ -0,0 +1,239 @@
+import { PrimitivesDefaults } from "../primitives-defaults.js";
+import { foldOrdinalIgnoreCase } from "../internal/case-folding.js";
+import { sanitizeInput } from "../internal/input-sanitization.js";
+import { Decimal } from "../internal/decimal.js";
+class BatteryChemistry {
+  static typeInfo = Object.freeze({
+    englishName: "Battery Chemistry",
+    localizedName: "Batterikemi",
+    emoji: "\u{1F50B}",
+    sources: Object.freeze(["https://www.iec.ch/"])
+  });
+  value;
+  englishName;
+  localizedName;
+  isRechargeable;
+  nominalCellVoltageV;
+  /** @internal Position in the canonical .NET ordering, used by {@link compareTo}. */
+  rank;
+  constructor(def) {
+    this.value = def.value;
+    this.englishName = def.englishName;
+    this.localizedName = def.localizedName;
+    this.isRechargeable = def.isRechargeable;
+    this.nominalCellVoltageV = def.nominalCellVoltageV;
+    this.rank = def.rank;
+  }
+  static LithiumIon = new BatteryChemistry({
+    value: "Li-ion",
+    englishName: "Lithium-ion",
+    localizedName: "Litium-jon",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("3.7"),
+    rank: 4
+  });
+  static LiFePO4 = new BatteryChemistry({
+    value: "LiFePO4",
+    englishName: "Lithium iron phosphate",
+    localizedName: "Litiumj\xE4rnfosfat",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("3.2"),
+    rank: 5
+  });
+  static LithiumPolymer = new BatteryChemistry({
+    value: "LiPo",
+    englishName: "Lithium polymer",
+    localizedName: "Litium-polymer",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("3.7"),
+    rank: 6
+  });
+  static LithiumTitanate = new BatteryChemistry({
+    value: "LTO",
+    englishName: "Lithium titanate",
+    localizedName: "Litium-titanat",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("2.4"),
+    rank: 3
+  });
+  static NickelMetalHydride = new BatteryChemistry({
+    value: "NiMH",
+    englishName: "Nickel-metal hydride",
+    localizedName: "Nickel-metallhydrid",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("1.2"),
+    rank: 8
+  });
+  static NickelCadmium = new BatteryChemistry({
+    value: "NiCd",
+    englishName: "Nickel-cadmium",
+    localizedName: "Nickel-kadmium",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("1.2"),
+    rank: 7
+  });
+  static FloodedLeadAcid = new BatteryChemistry({
+    value: "Pb-Acid",
+    englishName: "Flooded lead-acid",
+    localizedName: "Blybatteri (flytande syra)",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("2.0"),
+    rank: 9
+  });
+  static AbsorbedGlassMat = new BatteryChemistry({
+    value: "AGM",
+    englishName: "Absorbed Glass Mat",
+    localizedName: "AGM-batteri",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("2.0"),
+    rank: 0
+  });
+  static GelLeadAcid = new BatteryChemistry({
+    value: "Gel",
+    englishName: "Gel lead-acid",
+    localizedName: "Gelbatteri",
+    isRechargeable: true,
+    nominalCellVoltageV: Decimal.parse("2.0"),
+    rank: 2
+  });
+  static Alkaline = new BatteryChemistry({
+    value: "Alkaline",
+    englishName: "Alkaline",
+    localizedName: "Alkaliskt",
+    isRechargeable: false,
+    nominalCellVoltageV: Decimal.parse("1.5"),
+    rank: 1
+  });
+  static ZincCarbon = new BatteryChemistry({
+    value: "Zinc-carbon",
+    englishName: "Zinc-carbon",
+    localizedName: "Zinkkol",
+    isRechargeable: false,
+    nominalCellVoltageV: Decimal.parse("1.5"),
+    rank: 10
+  });
+  /** All 11 values, in canonical order. */
+  static get all() {
+    return ALL;
+  }
+  /** Name in the language selected by {@link PrimitivesDefaults.uiCulture}. */
+  get displayName() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+  }
+  /** Resolves a value from its canonical name, localized name, code or any known alias. */
+  static tryParse(input) {
+    if (input == null) return null;
+    const key = normalizeLookupKey(sanitizeInput(input).trim());
+    if (key.length === 0) return null;
+    return LOOKUP.get(key) ?? null;
+  }
+  static parse(input) {
+    const result = BatteryChemistry.tryParse(input);
+    if (result === null) throw new Error(`Invalid battery chemistry.`);
+    return result;
+  }
+  static isValid(input) {
+    return BatteryChemistry.tryParse(input) !== null;
+  }
+  static format(input, options) {
+    const r = BatteryChemistry.tryParse(input);
+    if (r !== null)
+      return PrimitivesDefaults.useLocalizedDisplayNames ? r.localizedName : r.englishName;
+    return fallback(input, options);
+  }
+  static normalize(input, options) {
+    const r = BatteryChemistry.tryParse(input);
+    if (r !== null) return r.value;
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && BatteryChemistry.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return PrimitivesDefaults.useLocalizedDisplayNames ? this.localizedName : this.englishName;
+  }
+  toDisplayString() {
+    return this.displayName;
+  }
+  toEnglishString() {
+    return this.englishName;
+  }
+  toLocalString() {
+    return this.localizedName;
+  }
+  equals(other) {
+    return other != null && this.value === other.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.rank < other.rank ? -1 : this.rank > other.rank ? 1 : 0;
+  }
+}
+const ALL = [
+  BatteryChemistry.LithiumIon,
+  BatteryChemistry.LiFePO4,
+  BatteryChemistry.LithiumPolymer,
+  BatteryChemistry.LithiumTitanate,
+  BatteryChemistry.NickelMetalHydride,
+  BatteryChemistry.NickelCadmium,
+  BatteryChemistry.FloodedLeadAcid,
+  BatteryChemistry.AbsorbedGlassMat,
+  BatteryChemistry.GelLeadAcid,
+  BatteryChemistry.Alkaline,
+  BatteryChemistry.ZincCarbon
+];
+function fallback(input, options) {
+  if (!options?.fallbackToTrimmedInputWhenInvalid || input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+const KEY_PATTERN = /[\s\-_]+/g;
+function normalizeLookupKey(value) {
+  let folded = value.trim().toLowerCase();
+  folded = folded.replaceAll("\xE5", "a").replaceAll("\xE4", "a").replaceAll("\xF6", "o");
+  folded = folded.replace(KEY_PATTERN, "");
+  return foldOrdinalIgnoreCase(folded);
+}
+const ALIASES = [
+  [BatteryChemistry.LithiumIon, ["liion", "lithiumion", "litiumion", "litiumjon"]],
+  [BatteryChemistry.LiFePO4, ["lfp", "lifepo4", "lithiumironphosphate", "litiumjarnfosfat"]],
+  [BatteryChemistry.LithiumPolymer, ["lipo", "lipoly", "lithiumpolymer", "litiumpolymer"]],
+  [BatteryChemistry.LithiumTitanate, ["lithiumtitanate", "litiumtitanat", "lto"]],
+  [BatteryChemistry.NickelMetalHydride, ["nickelmetalhydride", "nickelmetallhydrid", "nimh"]],
+  [BatteryChemistry.NickelCadmium, ["nicd", "nickelcadmium", "nickelkadmium"]],
+  [
+    BatteryChemistry.FloodedLeadAcid,
+    [
+      "bly",
+      "blybatteri",
+      "blybatteri(flytandesyra)",
+      "floodedleadacid",
+      "leadacid",
+      "pb",
+      "pbacid",
+      "vatcell",
+      "wetcell"
+    ]
+  ],
+  [
+    BatteryChemistry.AbsorbedGlassMat,
+    ["absorbedglassmat", "absorbentglassmat", "agm", "agmbatteri"]
+  ],
+  [BatteryChemistry.GelLeadAcid, ["gel", "gelbatteri", "gelcell", "gelleadacid"]],
+  [BatteryChemistry.Alkaline, ["alkaline", "alkalisk", "alkaliskt"]],
+  [BatteryChemistry.ZincCarbon, ["zinccarbon", "zinkkol"]]
+];
+const LOOKUP = /* @__PURE__ */ new Map();
+for (const [value, keys] of ALIASES) {
+  for (const key of keys) {
+    const folded = foldOrdinalIgnoreCase(key);
+    if (!LOOKUP.has(folded)) LOOKUP.set(folded, value);
+  }
+}
+export {
+  BatteryChemistry
+};
+//# sourceMappingURL=battery-chemistry.js.map