@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/cjs/measurement/flow-rate.js

@@ -0,0 +1,162 @@
+"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 flow_rate_exports = {};
+__export(flow_rate_exports, {
+  FlowRate: () => FlowRate,
+  maskFlowRate: () => maskFlowRate
+});
+module.exports = __toCommonJS(flow_rate_exports);
+var import_decimal = require("../internal/decimal.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_flow_rate_unit = require("./flow-rate-unit.js");
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<![\p{L}\p{N}_])(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:m[³3]/(?:h|min|tim)|l/(?:s|min|h|timme)|gal/min|gpm)(?![\p{L}\p{N}_])`,
+  "giu"
+);
+class FlowRate extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Flow Rate",
+    localizedName: "Fl\xF6de",
+    emoji: "\u{1F30A}",
+    sources: Object.freeze(["https://en.wikipedia.org/wiki/Volumetric_flow_rate"])
+  });
+  get units() {
+    return import_flow_rate_unit.FlowRateUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new FlowRate(baseValue, unit);
+  }
+  get litersPerSecond() {
+    return this.in(import_flow_rate_unit.FlowRateUnit.LitersPerSecond);
+  }
+  get litersPerMinute() {
+    return this.in(import_flow_rate_unit.FlowRateUnit.LitersPerMinute);
+  }
+  get litersPerHour() {
+    return this.in(import_flow_rate_unit.FlowRateUnit.LitersPerHour);
+  }
+  get cubicMetersPerHour() {
+    return this.in(import_flow_rate_unit.FlowRateUnit.CubicMetersPerHour);
+  }
+  get cubicMetersPerMinute() {
+    return this.in(import_flow_rate_unit.FlowRateUnit.CubicMetersPerMinute);
+  }
+  get gallonsPerMinute() {
+    return this.in(import_flow_rate_unit.FlowRateUnit.GallonsPerMinute);
+  }
+  /** Creates a flow rate from a value and unit. */
+  static create(value, unit) {
+    import_flow_rate_unit.FlowRateUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : FlowRate.decimalOf(value);
+    return new FlowRate(unit.toBase(amount), unit);
+  }
+  static fromLitersPerSecond(value) {
+    return FlowRate.create(value, import_flow_rate_unit.FlowRateUnit.LitersPerSecond);
+  }
+  static fromLitersPerMinute(value) {
+    return FlowRate.create(value, import_flow_rate_unit.FlowRateUnit.LitersPerMinute);
+  }
+  static fromLitersPerHour(value) {
+    return FlowRate.create(value, import_flow_rate_unit.FlowRateUnit.LitersPerHour);
+  }
+  static fromCubicMetersPerHour(value) {
+    return FlowRate.create(value, import_flow_rate_unit.FlowRateUnit.CubicMetersPerHour);
+  }
+  static fromCubicMetersPerMinute(value) {
+    return FlowRate.create(value, import_flow_rate_unit.FlowRateUnit.CubicMetersPerMinute);
+  }
+  static fromGallonsPerMinute(value) {
+    return FlowRate.create(value, import_flow_rate_unit.FlowRateUnit.GallonsPerMinute);
+  }
+  static tryParse(input) {
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_flow_rate_unit.FlowRateUnit.index);
+    return parsed === null ? null : new FlowRate(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = FlowRate.tryParse(input);
+    if (result === null) throw new Error("Invalid flow rate.");
+    return result;
+  }
+  static isValid(input) {
+    return FlowRate.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = FlowRate.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 FlowRate.fallback(input, options);
+  }
+  /** The value in liters per minute, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = FlowRate.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return FlowRate.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && FlowRate.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 = FlowRate.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: "FlowRate",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskFlowRate(value),
+          confidence: import_text_match_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 = import_decimal.Decimal.fromNumber(value);
+    if (parsed === null) throw new Error(`Value cannot be represented as a flow rate: ${value}`);
+    return parsed;
+  }
+}
+function maskFlowRate(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=flow-rate.js.map

package/dist/cjs/measurement/flow-rate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/flow-rate.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 { FlowRateUnit } from \"./flow-rate-unit.js\";\n\n/** Options for {@link FlowRate.format} and {@link FlowRate.normalize}. */\nexport interface FlowRateFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: FlowRateUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<![\\p{L}\\p{N}_])(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:m[\u00B33]/(?:h|min|tim)|l/(?:s|min|h|timme)|gal/min|gpm)(?![\\p{L}\\p{N}_])`,\n  \"giu\",\n);\n\n/**\n * A flow rate stored internally in liters per minute,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class FlowRate extends Quantity<FlowRateUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Flow Rate\",\n    localizedName: \"Fl\u00F6de\",\n    emoji: \"\uD83C\uDF0A\",\n    sources: Object.freeze([\"https://en.wikipedia.org/wiki/Volumetric_flow_rate\"]),\n  });\n\n  protected get units(): MeasurementUnitIndex<FlowRateUnit> {\n    return FlowRateUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: FlowRateUnit): this {\n    return new FlowRate(baseValue, unit) as this;\n  }\n\n  get litersPerSecond(): number {\n    return this.in(FlowRateUnit.LitersPerSecond);\n  }\n  get litersPerMinute(): number {\n    return this.in(FlowRateUnit.LitersPerMinute);\n  }\n  get litersPerHour(): number {\n    return this.in(FlowRateUnit.LitersPerHour);\n  }\n  get cubicMetersPerHour(): number {\n    return this.in(FlowRateUnit.CubicMetersPerHour);\n  }\n  get cubicMetersPerMinute(): number {\n    return this.in(FlowRateUnit.CubicMetersPerMinute);\n  }\n  get gallonsPerMinute(): number {\n    return this.in(FlowRateUnit.GallonsPerMinute);\n  }\n\n  /** Creates a flow rate from a value and unit. */\n  static create(value: number | Decimal, unit: FlowRateUnit): FlowRate {\n    FlowRateUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : FlowRate.decimalOf(value);\n    return new FlowRate(unit.toBase(amount), unit);\n  }\n\n  static fromLitersPerSecond(value: number | Decimal): FlowRate {\n    return FlowRate.create(value, FlowRateUnit.LitersPerSecond);\n  }\n  static fromLitersPerMinute(value: number | Decimal): FlowRate {\n    return FlowRate.create(value, FlowRateUnit.LitersPerMinute);\n  }\n  static fromLitersPerHour(value: number | Decimal): FlowRate {\n    return FlowRate.create(value, FlowRateUnit.LitersPerHour);\n  }\n  static fromCubicMetersPerHour(value: number | Decimal): FlowRate {\n    return FlowRate.create(value, FlowRateUnit.CubicMetersPerHour);\n  }\n  static fromCubicMetersPerMinute(value: number | Decimal): FlowRate {\n    return FlowRate.create(value, FlowRateUnit.CubicMetersPerMinute);\n  }\n  static fromGallonsPerMinute(value: number | Decimal): FlowRate {\n    return FlowRate.create(value, FlowRateUnit.GallonsPerMinute);\n  }\n\n  static tryParse(input: string | null | undefined): FlowRate | null {\n    const parsed = tryParseQuantity(input, FlowRateUnit.index);\n    return parsed === null ? null : new FlowRate(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): FlowRate {\n    const result = FlowRate.tryParse(input);\n    if (result === null) throw new Error(\"Invalid flow rate.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return FlowRate.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?: FlowRateFormatOptions): string | null {\n    const parsed = FlowRate.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 FlowRate.fallback(input, options);\n  }\n\n  /** The value in liters per minute, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: FlowRateFormatOptions,\n  ): string | null {\n    const parsed = FlowRate.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return FlowRate.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && FlowRate.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<FlowRate>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<FlowRate>[] = [];\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 = FlowRate.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<FlowRate>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"FlowRate\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskFlowRate(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?: FlowRateFormatOptions,\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 flow rate: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked flow rate, e.g. `10 L/min` becomes `*** L/min`. */\nexport function maskFlowRate(value: FlowRate): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,132 @@
+"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 frequency_unit_exports = {};
+__export(frequency_unit_exports, {
+  FrequencyUnit: () => FrequencyUnit
+});
+module.exports = __toCommonJS(frequency_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 FrequencyUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Frequency Unit",
+    localizedName: "Frekvensenhet",
+    emoji: "\u{1F4E1}",
+    sources: Object.freeze([])
+  });
+  static Hertz = new FrequencyUnit({
+    symbol: "Hz",
+    englishName: "hertz",
+    localizedName: "hertz",
+    pluralEnglish: "hertz",
+    pluralSwedish: "hertz",
+    toBaseUnitFactor: factor("1")
+  });
+  static Kilohertz = new FrequencyUnit({
+    symbol: "kHz",
+    englishName: "kilohertz",
+    localizedName: "kilohertz",
+    pluralEnglish: "kilohertz",
+    pluralSwedish: "kilohertz",
+    toBaseUnitFactor: factor("1000")
+  });
+  static Megahertz = new FrequencyUnit({
+    symbol: "MHz",
+    englishName: "megahertz",
+    localizedName: "megahertz",
+    pluralEnglish: "megahertz",
+    pluralSwedish: "megahertz",
+    toBaseUnitFactor: factor("1000000")
+  });
+  static Gigahertz = new FrequencyUnit({
+    symbol: "GHz",
+    englishName: "gigahertz",
+    localizedName: "gigahertz",
+    pluralEnglish: "gigahertz",
+    pluralSwedish: "gigahertz",
+    toBaseUnitFactor: factor("1000000000")
+  });
+  static Terahertz = new FrequencyUnit({
+    symbol: "THz",
+    englishName: "terahertz",
+    localizedName: "terahertz",
+    pluralEnglish: "terahertz",
+    pluralSwedish: "terahertz",
+    toBaseUnitFactor: factor("1000000000000")
+  });
+  static RevolutionsPerMinute = new FrequencyUnit({
+    symbol: "rpm",
+    englishName: "revolution per minute",
+    localizedName: "varv per minut",
+    pluralEnglish: "revolutions per minute",
+    pluralSwedish: "varv per minut",
+    toBaseUnitFactor: factor("0.0166666666666666666666666667"),
+    exactRatio: [factor("1"), factor("60")],
+    aliases: ["RPM", "rev/min", "varv/min", "r/min"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [
+      FrequencyUnit.Hertz,
+      FrequencyUnit.Kilohertz,
+      FrequencyUnit.Megahertz,
+      FrequencyUnit.Gigahertz,
+      FrequencyUnit.Terahertz,
+      FrequencyUnit.RevolutionsPerMinute
+    ],
+    FrequencyUnit.Hertz,
+    [
+      FrequencyUnit.Hertz,
+      FrequencyUnit.Kilohertz,
+      FrequencyUnit.Megahertz,
+      FrequencyUnit.Gigahertz,
+      FrequencyUnit.Terahertz
+    ]
+  );
+  static get all() {
+    return FrequencyUnit.index.all;
+  }
+  /** The base unit: Hz. */
+  static get baseUnit() {
+    return FrequencyUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return FrequencyUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return FrequencyUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = FrequencyUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown frequency unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in Hz. */
+  static getNatural(baseValue) {
+    return FrequencyUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=frequency-unit.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/frequency-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 frequency 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 FrequencyUnit extends MeasurementUnit {\n  declare private readonly __frequencyUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Frequency Unit\",\n    localizedName: \"Frekvensenhet\",\n    emoji: \"\uD83D\uDCE1\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Hertz = new FrequencyUnit({\n    symbol: \"Hz\",\n    englishName: \"hertz\",\n    localizedName: \"hertz\",\n    pluralEnglish: \"hertz\",\n    pluralSwedish: \"hertz\",\n    toBaseUnitFactor: factor(\"1\"),\n  });\n\n  static readonly Kilohertz = new FrequencyUnit({\n    symbol: \"kHz\",\n    englishName: \"kilohertz\",\n    localizedName: \"kilohertz\",\n    pluralEnglish: \"kilohertz\",\n    pluralSwedish: \"kilohertz\",\n    toBaseUnitFactor: factor(\"1000\"),\n  });\n\n  static readonly Megahertz = new FrequencyUnit({\n    symbol: \"MHz\",\n    englishName: \"megahertz\",\n    localizedName: \"megahertz\",\n    pluralEnglish: \"megahertz\",\n    pluralSwedish: \"megahertz\",\n    toBaseUnitFactor: factor(\"1000000\"),\n  });\n\n  static readonly Gigahertz = new FrequencyUnit({\n    symbol: \"GHz\",\n    englishName: \"gigahertz\",\n    localizedName: \"gigahertz\",\n    pluralEnglish: \"gigahertz\",\n    pluralSwedish: \"gigahertz\",\n    toBaseUnitFactor: factor(\"1000000000\"),\n  });\n\n  static readonly Terahertz = new FrequencyUnit({\n    symbol: \"THz\",\n    englishName: \"terahertz\",\n    localizedName: \"terahertz\",\n    pluralEnglish: \"terahertz\",\n    pluralSwedish: \"terahertz\",\n    toBaseUnitFactor: factor(\"1000000000000\"),\n  });\n\n  static readonly RevolutionsPerMinute = new FrequencyUnit({\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(\"0.0166666666666666666666666667\"),\n    exactRatio: [factor(\"1\"), factor(\"60\")],\n    aliases: [\"RPM\", \"rev/min\", \"varv/min\", \"r/min\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<FrequencyUnit> =\n    new MeasurementUnitIndex<FrequencyUnit>(\n      [\n        FrequencyUnit.Hertz,\n        FrequencyUnit.Kilohertz,\n        FrequencyUnit.Megahertz,\n        FrequencyUnit.Gigahertz,\n        FrequencyUnit.Terahertz,\n        FrequencyUnit.RevolutionsPerMinute,\n      ],\n      FrequencyUnit.Hertz,\n      [\n        FrequencyUnit.Hertz,\n        FrequencyUnit.Kilohertz,\n        FrequencyUnit.Megahertz,\n        FrequencyUnit.Gigahertz,\n        FrequencyUnit.Terahertz,\n      ],\n    );\n\n  static get all(): readonly FrequencyUnit[] {\n    return FrequencyUnit.index.all;\n  }\n\n  /** The base unit: Hz. */\n  static get baseUnit(): FrequencyUnit {\n    return FrequencyUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly FrequencyUnit[] {\n    return FrequencyUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): FrequencyUnit | null {\n    return FrequencyUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): FrequencyUnit {\n    const result = FrequencyUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown frequency unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in Hz. */\n  static getNatural(baseValue: Decimal): FrequencyUnit {\n    return FrequencyUnit.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,sBAAsB,wCAAgB;AAAA,EAGjD,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,QAAQ,IAAI,cAAc;AAAA,IACxC,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,EAC9B,CAAC;AAAA,EAED,OAAgB,YAAY,IAAI,cAAc;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,MAAM;AAAA,EACjC,CAAC;AAAA,EAED,OAAgB,YAAY,IAAI,cAAc;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,SAAS;AAAA,EACpC,CAAC;AAAA,EAED,OAAgB,YAAY,IAAI,cAAc;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,YAAY;AAAA,EACvC,CAAC;AAAA,EAED,OAAgB,YAAY,IAAI,cAAc;AAAA,IAC5C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,eAAe;AAAA,EAC1C,CAAC;AAAA,EAED,OAAgB,uBAAuB,IAAI,cAAc;AAAA,IACvD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,gCAAgC;AAAA,IACzD,YAAY,CAAC,OAAO,GAAG,GAAG,OAAO,IAAI,CAAC;AAAA,IACtC,SAAS,CAAC,OAAO,WAAW,YAAY,OAAO;AAAA,EACjD,CAAC;AAAA;AAAA,EAGD,OAAgB,QACd,IAAI;AAAA,IACF;AAAA,MACE,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,IAChB;AAAA,IACA,cAAc;AAAA,IACd;AAAA,MACE,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EAEF,WAAW,MAAgC;AACzC,WAAO,cAAc,MAAM;AAAA,EAC7B;AAAA;AAAA,EAGA,WAAW,WAA0B;AACnC,WAAO,cAAc,MAAM;AAAA,EAC7B;AAAA;AAAA,EAGA,WAAW,eAAyC;AAClD,WAAO,cAAc,MAAM;AAAA,EAC7B;AAAA;AAAA,EAGA,OAAO,SAAS,OAAwD;AACtE,WAAO,cAAc,MAAM,SAAS,KAAK;AAAA,EAC3C;AAAA,EAEA,OAAO,MAAM,OAA8B;AACzC,UAAM,SAAS,cAAc,SAAS,KAAK;AAC3C,QAAI,WAAW,KAAM,OAAM,IAAI,MAAM,yBAAyB;AAC9D,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,OAAO,WAAW,WAAmC;AACnD,WAAO,cAAc,MAAM,WAAW,SAAS;AAAA,EACjD;AACF;",
+  "names": []
+}

package/dist/cjs/measurement/frequency.js

@@ -0,0 +1,165 @@
+"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 frequency_exports = {};
+__export(frequency_exports, {
+  Frequency: () => Frequency,
+  maskFrequency: () => maskFrequency
+});
+module.exports = __toCommonJS(frequency_exports);
+var import_decimal = require("../internal/decimal.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_frequency_unit = require("./frequency-unit.js");
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<![\p{L}\p{N}_])(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:THz|GHz|MHz|kHz|Hz|rpm|rev/min|varv/min|r/min)(?![\p{L}\p{N}_])`,
+  "giu"
+);
+class Frequency extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Frequency",
+    localizedName: "Frekvens",
+    emoji: "\u{1F4E1}",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-derived-units",
+      "https://en.wikipedia.org/wiki/Conversion_of_units"
+    ])
+  });
+  get units() {
+    return import_frequency_unit.FrequencyUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new Frequency(baseValue, unit);
+  }
+  get hertz() {
+    return this.in(import_frequency_unit.FrequencyUnit.Hertz);
+  }
+  get kilohertz() {
+    return this.in(import_frequency_unit.FrequencyUnit.Kilohertz);
+  }
+  get megahertz() {
+    return this.in(import_frequency_unit.FrequencyUnit.Megahertz);
+  }
+  get gigahertz() {
+    return this.in(import_frequency_unit.FrequencyUnit.Gigahertz);
+  }
+  get terahertz() {
+    return this.in(import_frequency_unit.FrequencyUnit.Terahertz);
+  }
+  get rpm() {
+    return this.in(import_frequency_unit.FrequencyUnit.RevolutionsPerMinute);
+  }
+  /** Creates a frequency from a value and unit. */
+  static create(value, unit) {
+    import_frequency_unit.FrequencyUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : Frequency.decimalOf(value);
+    return new Frequency(unit.toBase(amount), unit);
+  }
+  static fromHertz(value) {
+    return Frequency.create(value, import_frequency_unit.FrequencyUnit.Hertz);
+  }
+  static fromKilohertz(value) {
+    return Frequency.create(value, import_frequency_unit.FrequencyUnit.Kilohertz);
+  }
+  static fromMegahertz(value) {
+    return Frequency.create(value, import_frequency_unit.FrequencyUnit.Megahertz);
+  }
+  static fromGigahertz(value) {
+    return Frequency.create(value, import_frequency_unit.FrequencyUnit.Gigahertz);
+  }
+  static fromTerahertz(value) {
+    return Frequency.create(value, import_frequency_unit.FrequencyUnit.Terahertz);
+  }
+  static fromRpm(value) {
+    return Frequency.create(value, import_frequency_unit.FrequencyUnit.RevolutionsPerMinute);
+  }
+  static tryParse(input) {
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_frequency_unit.FrequencyUnit.index);
+    return parsed === null ? null : new Frequency(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = Frequency.tryParse(input);
+    if (result === null) throw new Error("Invalid frequency.");
+    return result;
+  }
+  static isValid(input) {
+    return Frequency.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = Frequency.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 Frequency.fallback(input, options);
+  }
+  /** The value in hertz, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = Frequency.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return Frequency.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Frequency.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 = Frequency.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: "Frequency",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskFrequency(value),
+          confidence: import_text_match_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 = import_decimal.Decimal.fromNumber(value);
+    if (parsed === null) throw new Error(`Value cannot be represented as a frequency: ${value}`);
+    return parsed;
+  }
+}
+function maskFrequency(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=frequency.js.map

package/dist/cjs/measurement/frequency.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/frequency.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 { FrequencyUnit } from \"./frequency-unit.js\";\n\n/** Options for {@link Frequency.format} and {@link Frequency.normalize}. */\nexport interface FrequencyFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: FrequencyUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst SCAN_PATTERN = new RegExp(\n  String.raw`(?<![\\p{L}\\p{N}_])(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*(?:THz|GHz|MHz|kHz|Hz|rpm|rev/min|varv/min|r/min)(?![\\p{L}\\p{N}_])`,\n  \"giu\",\n);\n\n/**\n * A frequency stored internally in hertz,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class Frequency extends Quantity<FrequencyUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Frequency\",\n    localizedName: \"Frekvens\",\n    emoji: \"\uD83D\uDCE1\",\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<FrequencyUnit> {\n    return FrequencyUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: FrequencyUnit): this {\n    return new Frequency(baseValue, unit) as this;\n  }\n\n  get hertz(): number {\n    return this.in(FrequencyUnit.Hertz);\n  }\n  get kilohertz(): number {\n    return this.in(FrequencyUnit.Kilohertz);\n  }\n  get megahertz(): number {\n    return this.in(FrequencyUnit.Megahertz);\n  }\n  get gigahertz(): number {\n    return this.in(FrequencyUnit.Gigahertz);\n  }\n  get terahertz(): number {\n    return this.in(FrequencyUnit.Terahertz);\n  }\n  get rpm(): number {\n    return this.in(FrequencyUnit.RevolutionsPerMinute);\n  }\n\n  /** Creates a frequency from a value and unit. */\n  static create(value: number | Decimal, unit: FrequencyUnit): Frequency {\n    FrequencyUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : Frequency.decimalOf(value);\n    return new Frequency(unit.toBase(amount), unit);\n  }\n\n  static fromHertz(value: number | Decimal): Frequency {\n    return Frequency.create(value, FrequencyUnit.Hertz);\n  }\n  static fromKilohertz(value: number | Decimal): Frequency {\n    return Frequency.create(value, FrequencyUnit.Kilohertz);\n  }\n  static fromMegahertz(value: number | Decimal): Frequency {\n    return Frequency.create(value, FrequencyUnit.Megahertz);\n  }\n  static fromGigahertz(value: number | Decimal): Frequency {\n    return Frequency.create(value, FrequencyUnit.Gigahertz);\n  }\n  static fromTerahertz(value: number | Decimal): Frequency {\n    return Frequency.create(value, FrequencyUnit.Terahertz);\n  }\n  static fromRpm(value: number | Decimal): Frequency {\n    return Frequency.create(value, FrequencyUnit.RevolutionsPerMinute);\n  }\n\n  static tryParse(input: string | null | undefined): Frequency | null {\n    const parsed = tryParseQuantity(input, FrequencyUnit.index);\n    return parsed === null ? null : new Frequency(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): Frequency {\n    const result = Frequency.tryParse(input);\n    if (result === null) throw new Error(\"Invalid frequency.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Frequency.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?: FrequencyFormatOptions): string | null {\n    const parsed = Frequency.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 Frequency.fallback(input, options);\n  }\n\n  /** The value in hertz, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: FrequencyFormatOptions,\n  ): string | null {\n    const parsed = Frequency.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return Frequency.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Frequency.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Frequency>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Frequency>[] = [];\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 = Frequency.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Frequency>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Frequency\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskFrequency(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?: FrequencyFormatOptions,\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 frequency: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked frequency, e.g. `10 Hz` becomes `*** Hz`. */\nexport function maskFrequency(value: Frequency): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}