@budiauktioner/buildi-primitives 0.1.0 → 0.2.0

package/dist/esm/measurement/volume.js

@@ -0,0 +1,175 @@
+import { Decimal } from "../internal/decimal.js";
+import { Quantity, tryParseQuantity } from "../internal/quantity.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { VolumeUnit } from "./volume-unit.js";
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<!\w)(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:kubikmeter|hektoliter|mikroliter|vätskeans|fluid\s+ounces?|fl\s*oz|gallons?|microliters?|milliliters?|centiliters?|deciliters?|hectoliters?|liters?|cubic\s+meters?|koppar|kopp|cups?|pints?|m³|m3|cbm|µL|µl|ul|ml|cl|dl|hL|hl|gal|pt|l)\b`,
+  "giu"
+);
+class Volume extends Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Volume",
+    localizedName: "Volym",
+    emoji: "\u{1F9EA}",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-derived-units",
+      "https://en.wikipedia.org/wiki/Conversion_of_units"
+    ])
+  });
+  get units() {
+    return VolumeUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new Volume(baseValue, unit);
+  }
+  get microliters() {
+    return this.in(VolumeUnit.Microliter);
+  }
+  get milliliters() {
+    return this.in(VolumeUnit.Milliliter);
+  }
+  get centiliters() {
+    return this.in(VolumeUnit.Centiliter);
+  }
+  get deciliters() {
+    return this.in(VolumeUnit.Deciliter);
+  }
+  get liters() {
+    return this.in(VolumeUnit.Liter);
+  }
+  get hectoliters() {
+    return this.in(VolumeUnit.Hectoliter);
+  }
+  get cubicMeters() {
+    return this.in(VolumeUnit.CubicMeter);
+  }
+  get gallons() {
+    return this.in(VolumeUnit.Gallon);
+  }
+  get pints() {
+    return this.in(VolumeUnit.Pint);
+  }
+  get fluidOunces() {
+    return this.in(VolumeUnit.FluidOunce);
+  }
+  get cups() {
+    return this.in(VolumeUnit.Cup);
+  }
+  /** Creates a volume from a value and unit. */
+  static create(value, unit) {
+    VolumeUnit.index.assertOwns(unit);
+    const amount = value instanceof Decimal ? value : Volume.decimalOf(value);
+    return new Volume(unit.toBase(amount), unit);
+  }
+  static fromMicroliters(value) {
+    return Volume.create(value, VolumeUnit.Microliter);
+  }
+  static fromMilliliters(value) {
+    return Volume.create(value, VolumeUnit.Milliliter);
+  }
+  static fromCentiliters(value) {
+    return Volume.create(value, VolumeUnit.Centiliter);
+  }
+  static fromDeciliters(value) {
+    return Volume.create(value, VolumeUnit.Deciliter);
+  }
+  static fromLiters(value) {
+    return Volume.create(value, VolumeUnit.Liter);
+  }
+  static fromHectoliters(value) {
+    return Volume.create(value, VolumeUnit.Hectoliter);
+  }
+  static fromCubicMeters(value) {
+    return Volume.create(value, VolumeUnit.CubicMeter);
+  }
+  static fromGallons(value) {
+    return Volume.create(value, VolumeUnit.Gallon);
+  }
+  static fromPints(value) {
+    return Volume.create(value, VolumeUnit.Pint);
+  }
+  static fromFluidOunces(value) {
+    return Volume.create(value, VolumeUnit.FluidOunce);
+  }
+  static fromCups(value) {
+    return Volume.create(value, VolumeUnit.Cup);
+  }
+  static tryParse(input) {
+    const parsed = tryParseQuantity(input, VolumeUnit.index);
+    return parsed === null ? null : new Volume(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = Volume.tryParse(input);
+    if (result === null) throw new Error("Invalid volume.");
+    return result;
+  }
+  static isValid(input) {
+    return Volume.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = Volume.tryParse(input);
+    if (parsed !== null) {
+      if (options?.unit !== void 0 || options?.decimals !== void 0) {
+        return parsed.toStringInUnit(options.unit ?? parsed.originalUnit, options.decimals);
+      }
+      return parsed.toString();
+    }
+    return Volume.fallback(input, options);
+  }
+  /** The value in liters, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = Volume.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return Volume.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Volume.normalize(input) === input;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const value = Volume.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Volume",
+          category: TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskVolume(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  static fallback(input, options) {
+    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+    if (input == null) return null;
+    const trimmed = input.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  static decimalOf(value) {
+    const parsed = Decimal.fromNumber(value);
+    if (parsed === null) throw new Error(`Value cannot be represented as a volume: ${value}`);
+    return parsed;
+  }
+}
+function maskVolume(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+export {
+  Volume,
+  maskVolume
+};
+//# sourceMappingURL=volume.js.map

package/dist/esm/measurement/volume.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/volume.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport type { MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport { Quantity, tryParseQuantity } from \"../internal/quantity.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { VolumeUnit } from \"./volume-unit.js\";\n\n/** Options for {@link Volume.format} and {@link Volume.normalize}. */\nexport interface VolumeFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: VolumeUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<!\\w)(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:kubikmeter|hektoliter|mikroliter|v\u00E4tskeans|fluid\\s+ounces?|fl\\s*oz|gallons?|microliters?|milliliters?|centiliters?|deciliters?|hectoliters?|liters?|cubic\\s+meters?|koppar|kopp|cups?|pints?|m\u00B3|m3|cbm|\u00B5L|\u00B5l|ul|ml|cl|dl|hL|hl|gal|pt|l)\\b`,\n  \"giu\",\n);\n\n/**\n * A volume stored internally in liters,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class Volume extends Quantity<VolumeUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Volume\",\n    localizedName: \"Volym\",\n    emoji: \"\uD83E\uDDEA\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-derived-units\",\n      \"https://en.wikipedia.org/wiki/Conversion_of_units\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<VolumeUnit> {\n    return VolumeUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: VolumeUnit): this {\n    return new Volume(baseValue, unit) as this;\n  }\n\n  get microliters(): number {\n    return this.in(VolumeUnit.Microliter);\n  }\n  get milliliters(): number {\n    return this.in(VolumeUnit.Milliliter);\n  }\n  get centiliters(): number {\n    return this.in(VolumeUnit.Centiliter);\n  }\n  get deciliters(): number {\n    return this.in(VolumeUnit.Deciliter);\n  }\n  get liters(): number {\n    return this.in(VolumeUnit.Liter);\n  }\n  get hectoliters(): number {\n    return this.in(VolumeUnit.Hectoliter);\n  }\n  get cubicMeters(): number {\n    return this.in(VolumeUnit.CubicMeter);\n  }\n  get gallons(): number {\n    return this.in(VolumeUnit.Gallon);\n  }\n  get pints(): number {\n    return this.in(VolumeUnit.Pint);\n  }\n  get fluidOunces(): number {\n    return this.in(VolumeUnit.FluidOunce);\n  }\n  get cups(): number {\n    return this.in(VolumeUnit.Cup);\n  }\n\n  /** Creates a volume from a value and unit. */\n  static create(value: number | Decimal, unit: VolumeUnit): Volume {\n    VolumeUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : Volume.decimalOf(value);\n    return new Volume(unit.toBase(amount), unit);\n  }\n\n  static fromMicroliters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Microliter);\n  }\n  static fromMilliliters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Milliliter);\n  }\n  static fromCentiliters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Centiliter);\n  }\n  static fromDeciliters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Deciliter);\n  }\n  static fromLiters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Liter);\n  }\n  static fromHectoliters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Hectoliter);\n  }\n  static fromCubicMeters(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.CubicMeter);\n  }\n  static fromGallons(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Gallon);\n  }\n  static fromPints(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Pint);\n  }\n  static fromFluidOunces(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.FluidOunce);\n  }\n  static fromCups(value: number | Decimal): Volume {\n    return Volume.create(value, VolumeUnit.Cup);\n  }\n\n  static tryParse(input: string | null | undefined): Volume | null {\n    const parsed = tryParseQuantity(input, VolumeUnit.index);\n    return parsed === null ? null : new Volume(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): Volume {\n    const result = Volume.tryParse(input);\n    if (result === null) throw new Error(\"Invalid volume.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Volume.tryParse(input) !== null;\n  }\n\n  /** Display form in the parsed unit, or `null` when the input is invalid. */\n  static format(input: string | null | undefined, options?: VolumeFormatOptions): string | null {\n    const parsed = Volume.tryParse(input);\n    if (parsed !== null) {\n      if (options?.unit !== undefined || options?.decimals !== undefined) {\n        return parsed.toStringInUnit(options.unit ?? parsed.originalUnit, options.decimals);\n      }\n      return parsed.toString();\n    }\n    return Volume.fallback(input, options);\n  }\n\n  /** The value in liters, or `null` when the input is invalid. */\n  static normalize(input: string | null | undefined, options?: VolumeFormatOptions): string | null {\n    const parsed = Volume.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return Volume.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Volume.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Volume>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Volume>[] = [];\n    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);\n    let match: RegExpExecArray | null;\n\n    while ((match = pattern.exec(text)) !== null) {\n      const value = Volume.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Volume>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Volume\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskVolume(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  private static fallback(\n    input: string | null | undefined,\n    options?: VolumeFormatOptions,\n  ): string | null {\n    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;\n    if (input == null) return null;\n    const trimmed = input.trim();\n    return trimmed.length > 0 ? trimmed : null;\n  }\n\n  private static decimalOf(value: number): Decimal {\n    const parsed = Decimal.fromNumber(value);\n    if (parsed === null) throw new Error(`Value cannot be represented as a volume: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked volume, e.g. `10 L` becomes `*** L`. */\nexport function maskVolume(value: Volume): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/measurement/weight-unit.js

@@ -0,0 +1,138 @@
+import { Decimal } from "../internal/decimal.js";
+import { MeasurementUnit, MeasurementUnitIndex } from "../internal/measurement-unit.js";
+function factor(literal) {
+  const parsed = Decimal.parse(literal);
+  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);
+  return parsed;
+}
+class WeightUnit extends MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Weight Unit",
+    localizedName: "Viktenhet",
+    emoji: "\u2696\uFE0F",
+    sources: Object.freeze([])
+  });
+  static Microgram = new WeightUnit({
+    symbol: "\xB5g",
+    englishName: "microgram",
+    localizedName: "mikrogram",
+    pluralEnglish: "micrograms",
+    pluralSwedish: "mikrogram",
+    toBaseUnitFactor: factor("0.000000001"),
+    aliases: ["ug"]
+  });
+  static Milligram = new WeightUnit({
+    symbol: "mg",
+    englishName: "milligram",
+    localizedName: "milligram",
+    pluralEnglish: "milligrams",
+    pluralSwedish: "milligram",
+    toBaseUnitFactor: factor("0.000001")
+  });
+  static Gram = new WeightUnit({
+    symbol: "g",
+    englishName: "gram",
+    localizedName: "gram",
+    pluralEnglish: "grams",
+    pluralSwedish: "gram",
+    toBaseUnitFactor: factor("0.001")
+  });
+  static Hectogram = new WeightUnit({
+    symbol: "hg",
+    englishName: "hectogram",
+    localizedName: "hektogram",
+    pluralEnglish: "hectograms",
+    pluralSwedish: "hektogram",
+    toBaseUnitFactor: factor("0.1"),
+    aliases: ["hekto"]
+  });
+  static Kilogram = new WeightUnit({
+    symbol: "kg",
+    englishName: "kilogram",
+    localizedName: "kilogram",
+    pluralEnglish: "kilograms",
+    pluralSwedish: "kilogram",
+    toBaseUnitFactor: factor("1"),
+    aliases: ["kilo", "kilos"]
+  });
+  static MetricTon = new WeightUnit({
+    symbol: "t",
+    englishName: "metric ton",
+    localizedName: "ton",
+    pluralEnglish: "metric tons",
+    pluralSwedish: "ton",
+    toBaseUnitFactor: factor("1000"),
+    aliases: ["ton", "tonne", "tonnes", "metric ton", "metric tons"]
+  });
+  static Pound = new WeightUnit({
+    symbol: "lb",
+    englishName: "pound",
+    localizedName: "pund",
+    pluralEnglish: "pounds",
+    pluralSwedish: "pund",
+    toBaseUnitFactor: factor("0.45359237"),
+    aliases: ["pound", "pounds", "lbs"]
+  });
+  static Ounce = new WeightUnit({
+    symbol: "oz",
+    englishName: "ounce",
+    localizedName: "uns",
+    pluralEnglish: "ounces",
+    pluralSwedish: "uns",
+    toBaseUnitFactor: factor("0.028349523125"),
+    aliases: ["ounce", "ounces"]
+  });
+  static Stone = new WeightUnit({
+    symbol: "st",
+    englishName: "stone",
+    localizedName: "stone",
+    pluralEnglish: "stones",
+    pluralSwedish: "stone",
+    toBaseUnitFactor: factor("6.35029318"),
+    aliases: ["stone", "stones"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new MeasurementUnitIndex(
+    [
+      WeightUnit.Microgram,
+      WeightUnit.Milligram,
+      WeightUnit.Gram,
+      WeightUnit.Hectogram,
+      WeightUnit.Kilogram,
+      WeightUnit.MetricTon,
+      WeightUnit.Pound,
+      WeightUnit.Ounce,
+      WeightUnit.Stone
+    ],
+    WeightUnit.Kilogram,
+    [WeightUnit.Milligram, WeightUnit.Gram, WeightUnit.Kilogram, WeightUnit.MetricTon]
+  );
+  static get all() {
+    return WeightUnit.index.all;
+  }
+  /** The base unit: kg. */
+  static get baseUnit() {
+    return WeightUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return WeightUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return WeightUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = WeightUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown weight unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in kg. */
+  static getNatural(baseValue) {
+    return WeightUnit.index.getNatural(baseValue);
+  }
+}
+export {
+  WeightUnit
+};
+//# sourceMappingURL=weight-unit.js.map

package/dist/esm/measurement/weight-unit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/weight-unit.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { MeasurementUnit, MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\n\nfunction factor(literal: string): Decimal {\n  const parsed = Decimal.parse(literal);\n  /* c8 ignore next */\n  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);\n  return parsed;\n}\n\n/**\n * A unit of weight identified by its symbol.\n * Each unit carries English and Swedish names, singular and plural forms, and an\n * exact conversion factor to the base unit.\n */\nexport class WeightUnit extends MeasurementUnit {\n  declare private readonly __weightUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Weight Unit\",\n    localizedName: \"Viktenhet\",\n    emoji: \"\u2696\uFE0F\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Microgram = new WeightUnit({\n    symbol: \"\u00B5g\",\n    englishName: \"microgram\",\n    localizedName: \"mikrogram\",\n    pluralEnglish: \"micrograms\",\n    pluralSwedish: \"mikrogram\",\n    toBaseUnitFactor: factor(\"0.000000001\"),\n    aliases: [\"ug\"],\n  });\n\n  static readonly Milligram = new WeightUnit({\n    symbol: \"mg\",\n    englishName: \"milligram\",\n    localizedName: \"milligram\",\n    pluralEnglish: \"milligrams\",\n    pluralSwedish: \"milligram\",\n    toBaseUnitFactor: factor(\"0.000001\"),\n  });\n\n  static readonly Gram = new WeightUnit({\n    symbol: \"g\",\n    englishName: \"gram\",\n    localizedName: \"gram\",\n    pluralEnglish: \"grams\",\n    pluralSwedish: \"gram\",\n    toBaseUnitFactor: factor(\"0.001\"),\n  });\n\n  static readonly Hectogram = new WeightUnit({\n    symbol: \"hg\",\n    englishName: \"hectogram\",\n    localizedName: \"hektogram\",\n    pluralEnglish: \"hectograms\",\n    pluralSwedish: \"hektogram\",\n    toBaseUnitFactor: factor(\"0.1\"),\n    aliases: [\"hekto\"],\n  });\n\n  static readonly Kilogram = new WeightUnit({\n    symbol: \"kg\",\n    englishName: \"kilogram\",\n    localizedName: \"kilogram\",\n    pluralEnglish: \"kilograms\",\n    pluralSwedish: \"kilogram\",\n    toBaseUnitFactor: factor(\"1\"),\n    aliases: [\"kilo\", \"kilos\"],\n  });\n\n  static readonly MetricTon = new WeightUnit({\n    symbol: \"t\",\n    englishName: \"metric ton\",\n    localizedName: \"ton\",\n    pluralEnglish: \"metric tons\",\n    pluralSwedish: \"ton\",\n    toBaseUnitFactor: factor(\"1000\"),\n    aliases: [\"ton\", \"tonne\", \"tonnes\", \"metric ton\", \"metric tons\"],\n  });\n\n  static readonly Pound = new WeightUnit({\n    symbol: \"lb\",\n    englishName: \"pound\",\n    localizedName: \"pund\",\n    pluralEnglish: \"pounds\",\n    pluralSwedish: \"pund\",\n    toBaseUnitFactor: factor(\"0.45359237\"),\n    aliases: [\"pound\", \"pounds\", \"lbs\"],\n  });\n\n  static readonly Ounce = new WeightUnit({\n    symbol: \"oz\",\n    englishName: \"ounce\",\n    localizedName: \"uns\",\n    pluralEnglish: \"ounces\",\n    pluralSwedish: \"uns\",\n    toBaseUnitFactor: factor(\"0.028349523125\"),\n    aliases: [\"ounce\", \"ounces\"],\n  });\n\n  static readonly Stone = new WeightUnit({\n    symbol: \"st\",\n    englishName: \"stone\",\n    localizedName: \"stone\",\n    pluralEnglish: \"stones\",\n    pluralSwedish: \"stone\",\n    toBaseUnitFactor: factor(\"6.35029318\"),\n    aliases: [\"stone\", \"stones\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<WeightUnit> = new MeasurementUnitIndex<WeightUnit>(\n    [\n      WeightUnit.Microgram,\n      WeightUnit.Milligram,\n      WeightUnit.Gram,\n      WeightUnit.Hectogram,\n      WeightUnit.Kilogram,\n      WeightUnit.MetricTon,\n      WeightUnit.Pound,\n      WeightUnit.Ounce,\n      WeightUnit.Stone,\n    ],\n    WeightUnit.Kilogram,\n    [WeightUnit.Milligram, WeightUnit.Gram, WeightUnit.Kilogram, WeightUnit.MetricTon],\n  );\n\n  static get all(): readonly WeightUnit[] {\n    return WeightUnit.index.all;\n  }\n\n  /** The base unit: kg. */\n  static get baseUnit(): WeightUnit {\n    return WeightUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly WeightUnit[] {\n    return WeightUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): WeightUnit | null {\n    return WeightUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): WeightUnit {\n    const result = WeightUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown weight unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in kg. */\n  static getNatural(baseValue: Decimal): WeightUnit {\n    return WeightUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/measurement/weight.js

@@ -0,0 +1,163 @@
+import { Decimal } from "../internal/decimal.js";
+import { Quantity, tryParseQuantity } from "../internal/quantity.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { WeightUnit } from "./weight-unit.js";
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<!\w)(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:metric\s+ton|microgram|milligram|hectogram|hektogram|kilogram|gram|tonne|ton|ounces|ounce|pounds|pound|stones|stone|hekto|lbs|lb|µg|ug|mg|hg|kg|g|oz|st|t|pund|uns)\b`,
+  "giu"
+);
+class Weight extends Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Weight",
+    localizedName: "Vikt",
+    emoji: "\u2696\uFE0F",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-base-units",
+      "https://en.wikipedia.org/wiki/Conversion_of_units"
+    ])
+  });
+  get units() {
+    return WeightUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new Weight(baseValue, unit);
+  }
+  get micrograms() {
+    return this.in(WeightUnit.Microgram);
+  }
+  get milligrams() {
+    return this.in(WeightUnit.Milligram);
+  }
+  get grams() {
+    return this.in(WeightUnit.Gram);
+  }
+  get hectograms() {
+    return this.in(WeightUnit.Hectogram);
+  }
+  get kilograms() {
+    return this.in(WeightUnit.Kilogram);
+  }
+  get metricTons() {
+    return this.in(WeightUnit.MetricTon);
+  }
+  get pounds() {
+    return this.in(WeightUnit.Pound);
+  }
+  get ounces() {
+    return this.in(WeightUnit.Ounce);
+  }
+  get stones() {
+    return this.in(WeightUnit.Stone);
+  }
+  /** Creates a weight from a value and unit. */
+  static create(value, unit) {
+    WeightUnit.index.assertOwns(unit);
+    const amount = value instanceof Decimal ? value : Weight.decimalOf(value);
+    return new Weight(unit.toBase(amount), unit);
+  }
+  static fromMicrograms(value) {
+    return Weight.create(value, WeightUnit.Microgram);
+  }
+  static fromMilligrams(value) {
+    return Weight.create(value, WeightUnit.Milligram);
+  }
+  static fromGrams(value) {
+    return Weight.create(value, WeightUnit.Gram);
+  }
+  static fromHectograms(value) {
+    return Weight.create(value, WeightUnit.Hectogram);
+  }
+  static fromKilograms(value) {
+    return Weight.create(value, WeightUnit.Kilogram);
+  }
+  static fromMetricTons(value) {
+    return Weight.create(value, WeightUnit.MetricTon);
+  }
+  static fromPounds(value) {
+    return Weight.create(value, WeightUnit.Pound);
+  }
+  static fromOunces(value) {
+    return Weight.create(value, WeightUnit.Ounce);
+  }
+  static fromStones(value) {
+    return Weight.create(value, WeightUnit.Stone);
+  }
+  static tryParse(input) {
+    const parsed = tryParseQuantity(input, WeightUnit.index);
+    return parsed === null ? null : new Weight(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = Weight.tryParse(input);
+    if (result === null) throw new Error("Invalid weight.");
+    return result;
+  }
+  static isValid(input) {
+    return Weight.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = Weight.tryParse(input);
+    if (parsed !== null) {
+      if (options?.unit !== void 0 || options?.decimals !== void 0) {
+        return parsed.toStringInUnit(options.unit ?? parsed.originalUnit, options.decimals);
+      }
+      return parsed.toString();
+    }
+    return Weight.fallback(input, options);
+  }
+  /** The value in kilograms, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = Weight.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return Weight.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Weight.normalize(input) === input;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      const value = Weight.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "Weight",
+          category: TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskWeight(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  static fallback(input, options) {
+    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+    if (input == null) return null;
+    const trimmed = input.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  static decimalOf(value) {
+    const parsed = Decimal.fromNumber(value);
+    if (parsed === null) throw new Error(`Value cannot be represented as a weight: ${value}`);
+    return parsed;
+  }
+}
+function maskWeight(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+export {
+  Weight,
+  maskWeight
+};
+//# sourceMappingURL=weight.js.map

package/dist/esm/measurement/weight.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/weight.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport type { MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport { Quantity, tryParseQuantity } from \"../internal/quantity.js\";\nimport type { PrimitiveTypeInfo } from \"../primitive-type-info.js\";\nimport { TextCandidate } from \"../text-scanning/text-candidate.js\";\nimport { TextCandidateCategory } from \"../text-scanning/text-candidate-category.js\";\nimport { TextMatchConfidence } from \"../text-scanning/text-match-confidence.js\";\nimport { WeightUnit } from \"./weight-unit.js\";\n\n/** Options for {@link Weight.format} and {@link Weight.normalize}. */\nexport interface WeightFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: WeightUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<!\\w)(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:metric\\s+ton|microgram|milligram|hectogram|hektogram|kilogram|gram|tonne|ton|ounces|ounce|pounds|pound|stones|stone|hekto|lbs|lb|\u00B5g|ug|mg|hg|kg|g|oz|st|t|pund|uns)\\b`,\n  \"giu\",\n);\n\n/**\n * A weight stored internally in kilograms,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class Weight extends Quantity<WeightUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Weight\",\n    localizedName: \"Vikt\",\n    emoji: \"\u2696\uFE0F\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-base-units\",\n      \"https://en.wikipedia.org/wiki/Conversion_of_units\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<WeightUnit> {\n    return WeightUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: WeightUnit): this {\n    return new Weight(baseValue, unit) as this;\n  }\n\n  get micrograms(): number {\n    return this.in(WeightUnit.Microgram);\n  }\n  get milligrams(): number {\n    return this.in(WeightUnit.Milligram);\n  }\n  get grams(): number {\n    return this.in(WeightUnit.Gram);\n  }\n  get hectograms(): number {\n    return this.in(WeightUnit.Hectogram);\n  }\n  get kilograms(): number {\n    return this.in(WeightUnit.Kilogram);\n  }\n  get metricTons(): number {\n    return this.in(WeightUnit.MetricTon);\n  }\n  get pounds(): number {\n    return this.in(WeightUnit.Pound);\n  }\n  get ounces(): number {\n    return this.in(WeightUnit.Ounce);\n  }\n  get stones(): number {\n    return this.in(WeightUnit.Stone);\n  }\n\n  /** Creates a weight from a value and unit. */\n  static create(value: number | Decimal, unit: WeightUnit): Weight {\n    WeightUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : Weight.decimalOf(value);\n    return new Weight(unit.toBase(amount), unit);\n  }\n\n  static fromMicrograms(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Microgram);\n  }\n  static fromMilligrams(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Milligram);\n  }\n  static fromGrams(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Gram);\n  }\n  static fromHectograms(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Hectogram);\n  }\n  static fromKilograms(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Kilogram);\n  }\n  static fromMetricTons(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.MetricTon);\n  }\n  static fromPounds(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Pound);\n  }\n  static fromOunces(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Ounce);\n  }\n  static fromStones(value: number | Decimal): Weight {\n    return Weight.create(value, WeightUnit.Stone);\n  }\n\n  static tryParse(input: string | null | undefined): Weight | null {\n    const parsed = tryParseQuantity(input, WeightUnit.index);\n    return parsed === null ? null : new Weight(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): Weight {\n    const result = Weight.tryParse(input);\n    if (result === null) throw new Error(\"Invalid weight.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Weight.tryParse(input) !== null;\n  }\n\n  /** Display form in the parsed unit, or `null` when the input is invalid. */\n  static format(input: string | null | undefined, options?: WeightFormatOptions): string | null {\n    const parsed = Weight.tryParse(input);\n    if (parsed !== null) {\n      if (options?.unit !== undefined || options?.decimals !== undefined) {\n        return parsed.toStringInUnit(options.unit ?? parsed.originalUnit, options.decimals);\n      }\n      return parsed.toString();\n    }\n    return Weight.fallback(input, options);\n  }\n\n  /** The value in kilograms, or `null` when the input is invalid. */\n  static normalize(input: string | null | undefined, options?: WeightFormatOptions): string | null {\n    const parsed = Weight.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return Weight.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Weight.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Weight>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Weight>[] = [];\n    const pattern = new RegExp(SCAN_PATTERN.source, SCAN_PATTERN.flags);\n    let match: RegExpExecArray | null;\n\n    while ((match = pattern.exec(text)) !== null) {\n      const value = Weight.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Weight>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Weight\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskWeight(value),\n          confidence: TextMatchConfidence.Medium,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  private static fallback(\n    input: string | null | undefined,\n    options?: WeightFormatOptions,\n  ): string | null {\n    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;\n    if (input == null) return null;\n    const trimmed = input.trim();\n    return trimmed.length > 0 ? trimmed : null;\n  }\n\n  private static decimalOf(value: number): Decimal {\n    const parsed = Decimal.fromNumber(value);\n    if (parsed === null) throw new Error(`Value cannot be represented as a weight: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked weight, e.g. `10 kg` becomes `*** kg`. */\nexport function maskWeight(value: Weight): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}