@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/cjs/measurement/rotational-speed-unit.js

@@ -0,0 +1,96 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var rotational_speed_unit_exports = {};
+__export(rotational_speed_unit_exports, {
+  RotationalSpeedUnit: () => RotationalSpeedUnit
+});
+module.exports = __toCommonJS(rotational_speed_unit_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_measurement_unit = require("../internal/measurement-unit.js");
+function factor(literal) {
+  const parsed = import_decimal.Decimal.parse(literal);
+  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);
+  return parsed;
+}
+class RotationalSpeedUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Rotational Speed Unit",
+    localizedName: "Varvtalsenhet",
+    emoji: "\u{1F504}",
+    sources: Object.freeze([])
+  });
+  static Rpm = new RotationalSpeedUnit({
+    symbol: "rpm",
+    englishName: "revolution per minute",
+    localizedName: "varv per minut",
+    pluralEnglish: "revolutions per minute",
+    pluralSwedish: "varv per minut",
+    toBaseUnitFactor: factor("1"),
+    aliases: ["RPM", "r/min", "rev/min", "varv/min", "v/min", "vpm"]
+  });
+  static Rps = new RotationalSpeedUnit({
+    symbol: "rps",
+    englishName: "revolution per second",
+    localizedName: "varv per sekund",
+    pluralEnglish: "revolutions per second",
+    pluralSwedish: "varv per sekund",
+    toBaseUnitFactor: factor("60"),
+    aliases: ["RPS", "r/s", "rev/s", "varv/s"]
+  });
+  static RadiansPerSecond = new RotationalSpeedUnit({
+    symbol: "rad/s",
+    englishName: "radian per second",
+    localizedName: "radian per sekund",
+    pluralEnglish: "radians per second",
+    pluralSwedish: "radianer per sekund",
+    toBaseUnitFactor: factor("9.5492965855137"),
+    aliases: ["rad/sec"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [RotationalSpeedUnit.Rpm, RotationalSpeedUnit.Rps, RotationalSpeedUnit.RadiansPerSecond],
+    RotationalSpeedUnit.Rpm,
+    []
+  );
+  static get all() {
+    return RotationalSpeedUnit.index.all;
+  }
+  /** The base unit: rpm. */
+  static get baseUnit() {
+    return RotationalSpeedUnit.index.baseUnit;
+  }
+  /** Empty — this dimension has no curated display scale in .NET either. */
+  static get naturalScale() {
+    return RotationalSpeedUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return RotationalSpeedUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = RotationalSpeedUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown rotational speed unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in rpm. */
+  static getNatural(baseValue) {
+    return RotationalSpeedUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=rotational-speed-unit.js.map

package/dist/cjs/measurement/rotational-speed-unit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/rotational-speed-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 rotational speed 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 RotationalSpeedUnit extends MeasurementUnit {\n  declare private readonly __rotationalSpeedUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Rotational Speed Unit\",\n    localizedName: \"Varvtalsenhet\",\n    emoji: \"\uD83D\uDD04\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Rpm = new RotationalSpeedUnit({\n    symbol: \"rpm\",\n    englishName: \"revolution per minute\",\n    localizedName: \"varv per minut\",\n    pluralEnglish: \"revolutions per minute\",\n    pluralSwedish: \"varv per minut\",\n    toBaseUnitFactor: factor(\"1\"),\n    aliases: [\"RPM\", \"r/min\", \"rev/min\", \"varv/min\", \"v/min\", \"vpm\"],\n  });\n\n  static readonly Rps = new RotationalSpeedUnit({\n    symbol: \"rps\",\n    englishName: \"revolution per second\",\n    localizedName: \"varv per sekund\",\n    pluralEnglish: \"revolutions per second\",\n    pluralSwedish: \"varv per sekund\",\n    toBaseUnitFactor: factor(\"60\"),\n    aliases: [\"RPS\", \"r/s\", \"rev/s\", \"varv/s\"],\n  });\n\n  static readonly RadiansPerSecond = new RotationalSpeedUnit({\n    symbol: \"rad/s\",\n    englishName: \"radian per second\",\n    localizedName: \"radian per sekund\",\n    pluralEnglish: \"radians per second\",\n    pluralSwedish: \"radianer per sekund\",\n    toBaseUnitFactor: factor(\"9.5492965855137\"),\n    aliases: [\"rad/sec\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<RotationalSpeedUnit> =\n    new MeasurementUnitIndex<RotationalSpeedUnit>(\n      [RotationalSpeedUnit.Rpm, RotationalSpeedUnit.Rps, RotationalSpeedUnit.RadiansPerSecond],\n      RotationalSpeedUnit.Rpm,\n      [],\n    );\n\n  static get all(): readonly RotationalSpeedUnit[] {\n    return RotationalSpeedUnit.index.all;\n  }\n\n  /** The base unit: rpm. */\n  static get baseUnit(): RotationalSpeedUnit {\n    return RotationalSpeedUnit.index.baseUnit;\n  }\n\n  /** Empty \u2014 this dimension has no curated display scale in .NET either. */\n  static get naturalScale(): readonly RotationalSpeedUnit[] {\n    return RotationalSpeedUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): RotationalSpeedUnit | null {\n    return RotationalSpeedUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): RotationalSpeedUnit {\n    const result = RotationalSpeedUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown rotational speed unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in rpm. */\n  static getNatural(baseValue: Decimal): RotationalSpeedUnit {\n    return RotationalSpeedUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAwB;AACxB,8BAAsD;AAGtD,SAAS,OAAO,SAA0B;AACxC,QAAM,SAAS,uBAAQ,MAAM,OAAO;AAEpC,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,8BAA8B,OAAO,EAAE;AAC5E,SAAO;AACT;AAOO,MAAM,4BAA4B,wCAAgB;AAAA,EAGvD,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EAC3B,CAAC;AAAA,EAED,OAAgB,MAAM,IAAI,oBAAoB;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,IAC5B,SAAS,CAAC,OAAO,SAAS,WAAW,YAAY,SAAS,KAAK;AAAA,EACjE,CAAC;AAAA,EAED,OAAgB,MAAM,IAAI,oBAAoB;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,IAAI;AAAA,IAC7B,SAAS,CAAC,OAAO,OAAO,SAAS,QAAQ;AAAA,EAC3C,CAAC;AAAA,EAED,OAAgB,mBAAmB,IAAI,oBAAoB;AAAA,IACzD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,iBAAiB;AAAA,IAC1C,SAAS,CAAC,SAAS;AAAA,EACrB,CAAC;AAAA;AAAA,EAGD,OAAgB,QACd,IAAI;AAAA,IACF,CAAC,oBAAoB,KAAK,oBAAoB,KAAK,oBAAoB,gBAAgB;AAAA,IACvF,oBAAoB;AAAA,IACpB,CAAC;AAAA,EACH;AAAA,EAEF,WAAW,MAAsC;AAC/C,WAAO,oBAAoB,MAAM;AAAA,EACnC;AAAA;AAAA,EAGA,WAAW,WAAgC;AACzC,WAAO,oBAAoB,MAAM;AAAA,EACnC;AAAA;AAAA,EAGA,WAAW,eAA+C;AACxD,WAAO,oBAAoB,MAAM;AAAA,EACnC;AAAA;AAAA,EAGA,OAAO,SAAS,OAA8D;AAC5E,WAAO,oBAAoB,MAAM,SAAS,KAAK;AAAA,EACjD;AAAA,EAEA,OAAO,MAAM,OAAoC;AAC/C,UAAM,SAAS,oBAAoB,SAAS,KAAK;AACjD,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,gCAAgC;AACrE,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,OAAO,WAAW,WAAyC;AACzD,WAAO,oBAAoB,MAAM,WAAW,SAAS;AAAA,EACvD;AACF;",
+  "names": []
+}

package/dist/cjs/measurement/rotational-speed.js

@@ -0,0 +1,152 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var rotational_speed_exports = {};
+__export(rotational_speed_exports, {
+  RotationalSpeed: () => RotationalSpeed,
+  maskRotationalSpeed: () => maskRotationalSpeed
+});
+module.exports = __toCommonJS(rotational_speed_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_measurement_unit_parser = require("../internal/measurement-unit-parser.js");
+var import_quantity = require("../internal/quantity.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+var import_rotational_speed_unit = require("./rotational-speed-unit.js");
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<!\w)(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:rpm|r/min|rev/min|varv/min|rps|r/s|rev/s|varv/s|rad/s(?:ec)?)\b`,
+  "giu"
+);
+class RotationalSpeed extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Rotational Speed",
+    localizedName: "Varvtal",
+    emoji: "\u{1F504}",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/Revolutions_per_minute",
+      "https://www.bipm.org/en/measurement-units/si-derived-units"
+    ])
+  });
+  get units() {
+    return import_rotational_speed_unit.RotationalSpeedUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new RotationalSpeed(baseValue, unit);
+  }
+  get rpm() {
+    return this.in(import_rotational_speed_unit.RotationalSpeedUnit.Rpm);
+  }
+  get rps() {
+    return this.in(import_rotational_speed_unit.RotationalSpeedUnit.Rps);
+  }
+  get radiansPerSecond() {
+    return this.in(import_rotational_speed_unit.RotationalSpeedUnit.RadiansPerSecond);
+  }
+  /** Creates a rotational speed from a value and unit. */
+  static create(value, unit) {
+    import_rotational_speed_unit.RotationalSpeedUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : RotationalSpeed.decimalOf(value);
+    return new RotationalSpeed(unit.toBase(amount), unit);
+  }
+  static fromRpm(value) {
+    return RotationalSpeed.create(value, import_rotational_speed_unit.RotationalSpeedUnit.Rpm);
+  }
+  static fromRps(value) {
+    return RotationalSpeed.create(value, import_rotational_speed_unit.RotationalSpeedUnit.Rps);
+  }
+  static fromRadiansPerSecond(value) {
+    return RotationalSpeed.create(value, import_rotational_speed_unit.RotationalSpeedUnit.RadiansPerSecond);
+  }
+  /** A bare number is read as rpm, the unit rotational speed is usually quoted in. */
+  static tryParse(input) {
+    const bare = (0, import_measurement_unit_parser.tryParseNumberOnly)(input);
+    if (bare !== null) return new RotationalSpeed(bare, import_rotational_speed_unit.RotationalSpeedUnit.Rpm);
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_rotational_speed_unit.RotationalSpeedUnit.index);
+    return parsed === null ? null : new RotationalSpeed(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = RotationalSpeed.tryParse(input);
+    if (result === null) throw new Error("Invalid rotational speed.");
+    return result;
+  }
+  static isValid(input) {
+    return RotationalSpeed.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = RotationalSpeed.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 RotationalSpeed.fallback(input, options);
+  }
+  /** The value in revolutions per minute, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = RotationalSpeed.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return RotationalSpeed.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && RotationalSpeed.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 = RotationalSpeed.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "RotationalSpeed",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskRotationalSpeed(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Low,
+          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 = import_decimal.Decimal.fromNumber(value);
+    if (parsed === null)
+      throw new Error(`Value cannot be represented as a rotational speed: ${value}`);
+    return parsed;
+  }
+}
+function maskRotationalSpeed(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=rotational-speed.js.map

package/dist/cjs/measurement/rotational-speed.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/rotational-speed.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport type { MeasurementUnitIndex } from \"../internal/measurement-unit.js\";\nimport { tryParseNumberOnly } from \"../internal/measurement-unit-parser.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 { RotationalSpeedUnit } from \"./rotational-speed-unit.js\";\n\n/** Options for {@link RotationalSpeed.format} and {@link RotationalSpeed.normalize}. */\nexport interface RotationalSpeedFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: RotationalSpeedUnit;\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*(?:rpm|r/min|rev/min|varv/min|rps|r/s|rev/s|varv/s|rad/s(?:ec)?)\\b`,\n  \"giu\",\n);\n\n/**\n * A rotational speed stored internally in revolutions per minute,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class RotationalSpeed extends Quantity<RotationalSpeedUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Rotational Speed\",\n    localizedName: \"Varvtal\",\n    emoji: \"\uD83D\uDD04\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/Revolutions_per_minute\",\n      \"https://www.bipm.org/en/measurement-units/si-derived-units\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<RotationalSpeedUnit> {\n    return RotationalSpeedUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: RotationalSpeedUnit): this {\n    return new RotationalSpeed(baseValue, unit) as this;\n  }\n\n  get rpm(): number {\n    return this.in(RotationalSpeedUnit.Rpm);\n  }\n  get rps(): number {\n    return this.in(RotationalSpeedUnit.Rps);\n  }\n  get radiansPerSecond(): number {\n    return this.in(RotationalSpeedUnit.RadiansPerSecond);\n  }\n\n  /** Creates a rotational speed from a value and unit. */\n  static create(value: number | Decimal, unit: RotationalSpeedUnit): RotationalSpeed {\n    RotationalSpeedUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : RotationalSpeed.decimalOf(value);\n    return new RotationalSpeed(unit.toBase(amount), unit);\n  }\n\n  static fromRpm(value: number | Decimal): RotationalSpeed {\n    return RotationalSpeed.create(value, RotationalSpeedUnit.Rpm);\n  }\n  static fromRps(value: number | Decimal): RotationalSpeed {\n    return RotationalSpeed.create(value, RotationalSpeedUnit.Rps);\n  }\n  static fromRadiansPerSecond(value: number | Decimal): RotationalSpeed {\n    return RotationalSpeed.create(value, RotationalSpeedUnit.RadiansPerSecond);\n  }\n\n  /** A bare number is read as rpm, the unit rotational speed is usually quoted in. */\n  static tryParse(input: string | null | undefined): RotationalSpeed | null {\n    const bare = tryParseNumberOnly(input);\n    if (bare !== null) return new RotationalSpeed(bare, RotationalSpeedUnit.Rpm);\n\n    const parsed = tryParseQuantity(input, RotationalSpeedUnit.index);\n    return parsed === null ? null : new RotationalSpeed(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): RotationalSpeed {\n    const result = RotationalSpeed.tryParse(input);\n    if (result === null) throw new Error(\"Invalid rotational speed.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return RotationalSpeed.tryParse(input) !== null;\n  }\n\n  /** Display form in the parsed unit, or `null` when the input is invalid. */\n  static format(\n    input: string | null | undefined,\n    options?: RotationalSpeedFormatOptions,\n  ): string | null {\n    const parsed = RotationalSpeed.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 RotationalSpeed.fallback(input, options);\n  }\n\n  /** The value in revolutions per minute, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: RotationalSpeedFormatOptions,\n  ): string | null {\n    const parsed = RotationalSpeed.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return RotationalSpeed.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && RotationalSpeed.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<RotationalSpeed>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<RotationalSpeed>[] = [];\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 = RotationalSpeed.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<RotationalSpeed>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"RotationalSpeed\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskRotationalSpeed(value),\n          confidence: TextMatchConfidence.Low,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  private static fallback(\n    input: string | null | undefined,\n    options?: RotationalSpeedFormatOptions,\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)\n      throw new Error(`Value cannot be represented as a rotational speed: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked rotational speed, e.g. `10 rpm` becomes `*** rpm`. */\nexport function maskRotationalSpeed(value: RotationalSpeed): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/measurement/sound-level.js

@@ -0,0 +1,185 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sound_level_exports = {};
+__export(sound_level_exports, {
+  SoundLevel: () => SoundLevel,
+  SoundWeighting: () => SoundWeighting,
+  maskSoundLevel: () => maskSoundLevel
+});
+module.exports = __toCommonJS(sound_level_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_input_sanitization = require("../internal/input-sanitization.js");
+var import_measurement_unit_parser = require("../internal/measurement-unit-parser.js");
+var import_text_candidate = require("../text-scanning/text-candidate.js");
+var import_text_candidate_category = require("../text-scanning/text-candidate-category.js");
+var import_text_match_confidence = require("../text-scanning/text-match-confidence.js");
+const SoundWeighting = {
+  /** No weighting: a flat response. */
+  Unweighted: 0,
+  /** A-weighting, which approximates human hearing sensitivity. */
+  A: 1,
+  /** B-weighting, an intermediate curve that is rarely used. */
+  B: 2,
+  /** C-weighting, flat across most audible frequencies. */
+  C: 3,
+  /** Z-weighting, zero weighting, flat from 10 Hz to 20 kHz. */
+  Z: 4
+};
+const UNIT_PATTERN = /^\s*(?<sign>[+-])?\s*(?<num>[0-9][0-9 .,]*[0-9]|[0-9])\s*(?<unit>dB\s*(?:\(\s*(?<w1>[ABCZabcz])\s*\)|(?<w2>[ABCZabcz]))?)?\s*$/iu;
+const SCAN_PATTERN = /(?<!\w)(?:[+-]\s*)?\d+[0-9 .,]*\s*dB(?:\s*\(\s*[ABCZabcz]\s*\)|[ABCZabcz])?\b/giu;
+const SUFFIXES = {
+  [SoundWeighting.Unweighted]: " dB",
+  [SoundWeighting.A]: " dB(A)",
+  [SoundWeighting.B]: " dB(B)",
+  [SoundWeighting.C]: " dB(C)",
+  [SoundWeighting.Z]: " dB(Z)"
+};
+const WEIGHTINGS = {
+  A: SoundWeighting.A,
+  B: SoundWeighting.B,
+  C: SoundWeighting.C,
+  Z: SoundWeighting.Z
+};
+class SoundLevel {
+  constructor(decibelsValue, weighting) {
+    this.decibelsValue = decibelsValue;
+    this.weighting = weighting;
+    this.value = `${decibelsValue.toTrimmedString()}${SUFFIXES[weighting]}`;
+  }
+  decibelsValue;
+  weighting;
+  static typeInfo = Object.freeze({
+    englishName: "Sound Level",
+    localizedName: "Ljudniv\xE5",
+    emoji: "\u{1F50A}",
+    sources: Object.freeze([
+      "https://en.wikipedia.org/wiki/A-weighting",
+      "https://www.iso.org/standard/17426.html"
+    ])
+  });
+  /** The display form, e.g. `69 dB(A)`. */
+  value;
+  /** The numeric decibel value, e.g. `69`. */
+  get decibels() {
+    return this.decibelsValue.toNumber();
+  }
+  /** Creates a sound level from a value and weighting. */
+  static create(value, weighting) {
+    return new SoundLevel(toDecimal(value), weighting);
+  }
+  /** Creates an unweighted sound level, e.g. `85 dB`. */
+  static fromDecibels(value) {
+    return new SoundLevel(toDecimal(value), SoundWeighting.Unweighted);
+  }
+  /** Creates an A-weighted sound level, e.g. `69 dB(A)`. */
+  static fromDecibelA(value) {
+    return new SoundLevel(toDecimal(value), SoundWeighting.A);
+  }
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (trimmed.length === 0) return null;
+    const match = UNIT_PATTERN.exec(trimmed);
+    const number = match?.groups?.["num"];
+    if (number === void 0) return null;
+    const parsed = (0, import_measurement_unit_parser.tryParseNumberOnly)(number);
+    if (parsed === null) return null;
+    const decibels = match?.groups?.["sign"] === "-" ? parsed.negated() : parsed;
+    const letter = match?.groups?.["w1"] ?? match?.groups?.["w2"];
+    const weighting = letter === void 0 ? SoundWeighting.Unweighted : WEIGHTINGS[letter.toUpperCase()] ?? SoundWeighting.Unweighted;
+    return new SoundLevel(decibels, weighting);
+  }
+  static parse(input) {
+    const result = SoundLevel.tryParse(input);
+    if (result === null) throw new Error("Invalid sound level.");
+    return result;
+  }
+  static isValid(input) {
+    return SoundLevel.tryParse(input) !== null;
+  }
+  /** Display form, e.g. `69 dB(A)`. */
+  static format(input, options) {
+    const parsed = SoundLevel.tryParse(input);
+    if (parsed !== null) return parsed.toString();
+    return fallback(input, options);
+  }
+  /** Canonical form, e.g. `69 dB(A)`. */
+  static normalize(input, options) {
+    const parsed = SoundLevel.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && SoundLevel.normalize(input) === input;
+  }
+  toNormalizedString() {
+    return this.value;
+  }
+  toString() {
+    return this.value;
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.decibelsValue.compareTo(other.decibelsValue);
+  }
+  equals(other) {
+    return other != null && this.decibelsValue.equals(other.decibelsValue) && this.weighting === other.weighting;
+  }
+  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 = SoundLevel.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new import_text_candidate.TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "SoundLevel",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskSoundLevel(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Low,
+          value
+        })
+      );
+    }
+    return out;
+  }
+}
+function maskSoundLevel(soundLevel) {
+  return `***${SUFFIXES[soundLevel.weighting]}`;
+}
+function toDecimal(value) {
+  if (value instanceof import_decimal.Decimal) return value;
+  const parsed = import_decimal.Decimal.fromNumber(value);
+  if (parsed === null) throw new Error(`Value cannot be represented as a sound level: ${value}`);
+  return parsed;
+}
+function fallback(input, options) {
+  if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+  if (input == null) return null;
+  const trimmed = input.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=sound-level.js.map

package/dist/cjs/measurement/sound-level.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/sound-level.ts"],
+  "sourcesContent": ["import { Decimal } from \"../internal/decimal.js\";\nimport { sanitizeInput } from \"../internal/input-sanitization.js\";\nimport { tryParseNumberOnly } from \"../internal/measurement-unit-parser.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\";\n\n/**\n * The frequency weighting curve applied to a sound measurement.\n */\nexport const SoundWeighting = {\n  /** No weighting: a flat response. */\n  Unweighted: 0,\n  /** A-weighting, which approximates human hearing sensitivity. */\n  A: 1,\n  /** B-weighting, an intermediate curve that is rarely used. */\n  B: 2,\n  /** C-weighting, flat across most audible frequencies. */\n  C: 3,\n  /** Z-weighting, zero weighting, flat from 10 Hz to 20 kHz. */\n  Z: 4,\n} as const;\n\nexport type SoundWeighting = (typeof SoundWeighting)[keyof typeof SoundWeighting];\n\n/** Options for {@link SoundLevel.format} and {@link SoundLevel.normalize}. */\nexport interface SoundLevelFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n}\n\nconst UNIT_PATTERN =\n  /^\\s*(?<sign>[+-])?\\s*(?<num>[0-9][0-9 .,]*[0-9]|[0-9])\\s*(?<unit>dB\\s*(?:\\(\\s*(?<w1>[ABCZabcz])\\s*\\)|(?<w2>[ABCZabcz]))?)?\\s*$/iu;\n\nconst SCAN_PATTERN =\n  /(?<!\\w)(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*dB(?:\\s*\\(\\s*[ABCZabcz]\\s*\\)|[ABCZabcz])?\\b/giu;\n\nconst SUFFIXES: Record<SoundWeighting, string> = {\n  [SoundWeighting.Unweighted]: \" dB\",\n  [SoundWeighting.A]: \" dB(A)\",\n  [SoundWeighting.B]: \" dB(B)\",\n  [SoundWeighting.C]: \" dB(C)\",\n  [SoundWeighting.Z]: \" dB(Z)\",\n};\n\nconst WEIGHTINGS: Record<string, SoundWeighting> = {\n  A: SoundWeighting.A,\n  B: SoundWeighting.B,\n  C: SoundWeighting.C,\n  Z: SoundWeighting.Z,\n};\n\n/**\n * A sound pressure level in decibels, optionally carrying a frequency\n * weighting \u2014 `85 dB`, `69 dB(A)`, `40 dBZ`.\n *\n * The decibel unit is missing from many inputs in practice, so a bare number is\n * accepted and read as unweighted decibels.\n */\nexport class SoundLevel {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Sound Level\",\n    localizedName: \"Ljudniv\u00E5\",\n    emoji: \"\uD83D\uDD0A\",\n    sources: Object.freeze([\n      \"https://en.wikipedia.org/wiki/A-weighting\",\n      \"https://www.iso.org/standard/17426.html\",\n    ]),\n  });\n\n  /** The display form, e.g. `69 dB(A)`. */\n  readonly value: string;\n\n  private constructor(\n    private readonly decibelsValue: Decimal,\n    /** The frequency weighting applied to this measurement. */\n    readonly weighting: SoundWeighting,\n  ) {\n    this.value = `${decibelsValue.toTrimmedString()}${SUFFIXES[weighting]}`;\n  }\n\n  /** The numeric decibel value, e.g. `69`. */\n  get decibels(): number {\n    return this.decibelsValue.toNumber();\n  }\n\n  /** Creates a sound level from a value and weighting. */\n  static create(value: number | Decimal, weighting: SoundWeighting): SoundLevel {\n    return new SoundLevel(toDecimal(value), weighting);\n  }\n\n  /** Creates an unweighted sound level, e.g. `85 dB`. */\n  static fromDecibels(value: number | Decimal): SoundLevel {\n    return new SoundLevel(toDecimal(value), SoundWeighting.Unweighted);\n  }\n\n  /** Creates an A-weighted sound level, e.g. `69 dB(A)`. */\n  static fromDecibelA(value: number | Decimal): SoundLevel {\n    return new SoundLevel(toDecimal(value), SoundWeighting.A);\n  }\n\n  static tryParse(input: string | null | undefined): SoundLevel | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0) return null;\n\n    const match = UNIT_PATTERN.exec(trimmed);\n    const number = match?.groups?.[\"num\"];\n    if (number === undefined) return null;\n\n    const parsed = tryParseNumberOnly(number);\n    if (parsed === null) return null;\n\n    const decibels = match?.groups?.[\"sign\"] === \"-\" ? parsed.negated() : parsed;\n    const letter = match?.groups?.[\"w1\"] ?? match?.groups?.[\"w2\"];\n    const weighting =\n      letter === undefined\n        ? SoundWeighting.Unweighted\n        : (WEIGHTINGS[letter.toUpperCase()] ?? SoundWeighting.Unweighted);\n\n    return new SoundLevel(decibels, weighting);\n  }\n\n  static parse(input: string): SoundLevel {\n    const result = SoundLevel.tryParse(input);\n    if (result === null) throw new Error(\"Invalid sound level.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return SoundLevel.tryParse(input) !== null;\n  }\n\n  /** Display form, e.g. `69 dB(A)`. */\n  static format(\n    input: string | null | undefined,\n    options?: SoundLevelFormatOptions,\n  ): string | null {\n    const parsed = SoundLevel.tryParse(input);\n    if (parsed !== null) return parsed.toString();\n    return fallback(input, options);\n  }\n\n  /** Canonical form, e.g. `69 dB(A)`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: SoundLevelFormatOptions,\n  ): string | null {\n    const parsed = SoundLevel.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 && SoundLevel.normalize(input) === input;\n  }\n\n  toNormalizedString(): string {\n    return this.value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n\n  compareTo(other: SoundLevel | null | undefined): number {\n    if (other == null) return 1;\n    return this.decibelsValue.compareTo(other.decibelsValue);\n  }\n\n  equals(other: SoundLevel | null | undefined): boolean {\n    return (\n      other != null &&\n      this.decibelsValue.equals(other.decibelsValue) &&\n      this.weighting === other.weighting\n    );\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<SoundLevel>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<SoundLevel>[] = [];\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 = SoundLevel.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<SoundLevel>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"SoundLevel\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskSoundLevel(value),\n          confidence: TextMatchConfidence.Low,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n}\n\n/** Returns a masked sound level, e.g. `69 dB(A)` becomes `*** dB(A)`. */\nexport function maskSoundLevel(soundLevel: SoundLevel): string {\n  return `***${SUFFIXES[soundLevel.weighting]}`;\n}\n\nfunction toDecimal(value: number | Decimal): Decimal {\n  if (value instanceof Decimal) return value;\n  const parsed = Decimal.fromNumber(value);\n  if (parsed === null) throw new Error(`Value cannot be represented as a sound level: ${value}`);\n  return parsed;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: SoundLevelFormatOptions,\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"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/measurement/speed-unit.js

@@ -0,0 +1,119 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var speed_unit_exports = {};
+__export(speed_unit_exports, {
+  SpeedUnit: () => SpeedUnit
+});
+module.exports = __toCommonJS(speed_unit_exports);
+var import_decimal = require("../internal/decimal.js");
+var import_measurement_unit = require("../internal/measurement-unit.js");
+function factor(literal) {
+  const parsed = import_decimal.Decimal.parse(literal);
+  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);
+  return parsed;
+}
+class SpeedUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Speed Unit",
+    localizedName: "Hastighetsenhet",
+    emoji: "\u{1F3CE}\uFE0F",
+    sources: Object.freeze([])
+  });
+  static MetersPerSecond = new SpeedUnit({
+    symbol: "m/s",
+    englishName: "meter per second",
+    localizedName: "meter per sekund",
+    pluralEnglish: "meters per second",
+    pluralSwedish: "meter per sekund",
+    toBaseUnitFactor: factor("1")
+  });
+  static KilometersPerHour = new SpeedUnit({
+    symbol: "km/h",
+    englishName: "kilometer per hour",
+    localizedName: "kilometer per timme",
+    pluralEnglish: "kilometers per hour",
+    pluralSwedish: "kilometer per timme",
+    toBaseUnitFactor: factor("0.2777777777777777777777777778"),
+    exactRatio: [factor("1000"), factor("3600")],
+    aliases: ["kmh", "km/t", "kph", "kilometre per hour", "kilometres per hour"]
+  });
+  static MilesPerHour = new SpeedUnit({
+    symbol: "mph",
+    englishName: "mile per hour",
+    localizedName: "miles per timme",
+    pluralEnglish: "miles per hour",
+    pluralSwedish: "miles per timme",
+    toBaseUnitFactor: factor("0.44704"),
+    aliases: ["miles per hour"]
+  });
+  static FeetPerSecond = new SpeedUnit({
+    symbol: "ft/s",
+    englishName: "foot per second",
+    localizedName: "fot per sekund",
+    pluralEnglish: "feet per second",
+    pluralSwedish: "fot per sekund",
+    toBaseUnitFactor: factor("0.3048")
+  });
+  static Knot = new SpeedUnit({
+    symbol: "kn",
+    englishName: "knot",
+    localizedName: "knop",
+    pluralEnglish: "knots",
+    pluralSwedish: "knop",
+    toBaseUnitFactor: factor("0.5144444444444444444444444444"),
+    aliases: ["knot", "knots", "knop", "kt"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [
+      SpeedUnit.MetersPerSecond,
+      SpeedUnit.KilometersPerHour,
+      SpeedUnit.MilesPerHour,
+      SpeedUnit.FeetPerSecond,
+      SpeedUnit.Knot
+    ],
+    SpeedUnit.MetersPerSecond,
+    []
+  );
+  static get all() {
+    return SpeedUnit.index.all;
+  }
+  /** The base unit: m/s. */
+  static get baseUnit() {
+    return SpeedUnit.index.baseUnit;
+  }
+  /** Empty — this dimension has no curated display scale in .NET either. */
+  static get naturalScale() {
+    return SpeedUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return SpeedUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = SpeedUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown speed unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in m/s. */
+  static getNatural(baseValue) {
+    return SpeedUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=speed-unit.js.map

package/dist/cjs/measurement/speed-unit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/speed-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 speed 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 SpeedUnit extends MeasurementUnit {\n  declare private readonly __speedUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Speed Unit\",\n    localizedName: \"Hastighetsenhet\",\n    emoji: \"\uD83C\uDFCE\uFE0F\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly MetersPerSecond = new SpeedUnit({\n    symbol: \"m/s\",\n    englishName: \"meter per second\",\n    localizedName: \"meter per sekund\",\n    pluralEnglish: \"meters per second\",\n    pluralSwedish: \"meter per sekund\",\n    toBaseUnitFactor: factor(\"1\"),\n  });\n\n  static readonly KilometersPerHour = new SpeedUnit({\n    symbol: \"km/h\",\n    englishName: \"kilometer per hour\",\n    localizedName: \"kilometer per timme\",\n    pluralEnglish: \"kilometers per hour\",\n    pluralSwedish: \"kilometer per timme\",\n    toBaseUnitFactor: factor(\"0.2777777777777777777777777778\"),\n    exactRatio: [factor(\"1000\"), factor(\"3600\")],\n    aliases: [\"kmh\", \"km/t\", \"kph\", \"kilometre per hour\", \"kilometres per hour\"],\n  });\n\n  static readonly MilesPerHour = new SpeedUnit({\n    symbol: \"mph\",\n    englishName: \"mile per hour\",\n    localizedName: \"miles per timme\",\n    pluralEnglish: \"miles per hour\",\n    pluralSwedish: \"miles per timme\",\n    toBaseUnitFactor: factor(\"0.44704\"),\n    aliases: [\"miles per hour\"],\n  });\n\n  static readonly FeetPerSecond = new SpeedUnit({\n    symbol: \"ft/s\",\n    englishName: \"foot per second\",\n    localizedName: \"fot per sekund\",\n    pluralEnglish: \"feet per second\",\n    pluralSwedish: \"fot per sekund\",\n    toBaseUnitFactor: factor(\"0.3048\"),\n  });\n\n  static readonly Knot = new SpeedUnit({\n    symbol: \"kn\",\n    englishName: \"knot\",\n    localizedName: \"knop\",\n    pluralEnglish: \"knots\",\n    pluralSwedish: \"knop\",\n    toBaseUnitFactor: factor(\"0.5144444444444444444444444444\"),\n    aliases: [\"knot\", \"knots\", \"knop\", \"kt\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<SpeedUnit> = new MeasurementUnitIndex<SpeedUnit>(\n    [\n      SpeedUnit.MetersPerSecond,\n      SpeedUnit.KilometersPerHour,\n      SpeedUnit.MilesPerHour,\n      SpeedUnit.FeetPerSecond,\n      SpeedUnit.Knot,\n    ],\n    SpeedUnit.MetersPerSecond,\n    [],\n  );\n\n  static get all(): readonly SpeedUnit[] {\n    return SpeedUnit.index.all;\n  }\n\n  /** The base unit: m/s. */\n  static get baseUnit(): SpeedUnit {\n    return SpeedUnit.index.baseUnit;\n  }\n\n  /** Empty \u2014 this dimension has no curated display scale in .NET either. */\n  static get naturalScale(): readonly SpeedUnit[] {\n    return SpeedUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): SpeedUnit | null {\n    return SpeedUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): SpeedUnit {\n    const result = SpeedUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown speed unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in m/s. */\n  static getNatural(baseValue: Decimal): SpeedUnit {\n    return SpeedUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAwB;AACxB,8BAAsD;AAGtD,SAAS,OAAO,SAA0B;AACxC,QAAM,SAAS,uBAAQ,MAAM,OAAO;AAEpC,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,8BAA8B,OAAO,EAAE;AAC5E,SAAO;AACT;AAOO,MAAM,kBAAkB,wCAAgB;AAAA,EAG7C,OAAgB,WAA8B,OAAO,OAAO;AAAA,IAC1D,aAAa;AAAA,IACb,eAAe;AAAA,IACf,OAAO;AAAA,IACP,SAAS,OAAO,OAAO,CAAC,CAAC;AAAA,EAC3B,CAAC;AAAA,EAED,OAAgB,kBAAkB,IAAI,UAAU;AAAA,IAC9C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,EAC9B,CAAC;AAAA,EAED,OAAgB,oBAAoB,IAAI,UAAU;AAAA,IAChD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,gCAAgC;AAAA,IACzD,YAAY,CAAC,OAAO,MAAM,GAAG,OAAO,MAAM,CAAC;AAAA,IAC3C,SAAS,CAAC,OAAO,QAAQ,OAAO,sBAAsB,qBAAqB;AAAA,EAC7E,CAAC;AAAA,EAED,OAAgB,eAAe,IAAI,UAAU;AAAA,IAC3C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,SAAS;AAAA,IAClC,SAAS,CAAC,gBAAgB;AAAA,EAC5B,CAAC;AAAA,EAED,OAAgB,gBAAgB,IAAI,UAAU;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,QAAQ;AAAA,EACnC,CAAC;AAAA,EAED,OAAgB,OAAO,IAAI,UAAU;AAAA,IACnC,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,gCAAgC;AAAA,IACzD,SAAS,CAAC,QAAQ,SAAS,QAAQ,IAAI;AAAA,EACzC,CAAC;AAAA;AAAA,EAGD,OAAgB,QAAyC,IAAI;AAAA,IAC3D;AAAA,MACE,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,IACV,CAAC;AAAA,EACH;AAAA,EAEA,WAAW,MAA4B;AACrC,WAAO,UAAU,MAAM;AAAA,EACzB;AAAA;AAAA,EAGA,WAAW,WAAsB;AAC/B,WAAO,UAAU,MAAM;AAAA,EACzB;AAAA;AAAA,EAGA,WAAW,eAAqC;AAC9C,WAAO,UAAU,MAAM;AAAA,EACzB;AAAA;AAAA,EAGA,OAAO,SAAS,OAAoD;AAClE,WAAO,UAAU,MAAM,SAAS,KAAK;AAAA,EACvC;AAAA,EAEA,OAAO,MAAM,OAA0B;AACrC,UAAM,SAAS,UAAU,SAAS,KAAK;AACvC,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,qBAAqB;AAC1D,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,OAAO,WAAW,WAA+B;AAC/C,WAAO,UAAU,MAAM,WAAW,SAAS;AAAA,EAC7C;AACF;",
+  "names": []
+}