@budiauktioner/buildi-primitives 0.1.1 → 0.2.1

package/dist/cjs/measurement/percentage.js

@@ -0,0 +1,212 @@
+"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 percentage_exports = {};
+__export(percentage_exports, {
+  Percentage: () => Percentage,
+  maskPercentage: () => maskPercentage
+});
+module.exports = __toCommonJS(percentage_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 ZERO = import_decimal.Decimal.parse("0");
+const ONE = import_decimal.Decimal.parse("1");
+const HUNDRED = import_decimal.Decimal.parse("100");
+const MAX_INPUT_LENGTH = 100;
+const WORD_SUFFIX_PATTERN = /^(?<sign>[+-])?\s*(?<number>[0-9][0-9 .,]*[0-9]|[0-9])\s+(?:procent|percent)\s*$/iu;
+const SCAN_PATTERN = /(?<![\p{L}\p{N}_])(?:[+-]\s*)?\d+[0-9 .,]*\s*%/gu;
+class Percentage {
+  constructor(fraction) {
+    this.fraction = fraction;
+  }
+  fraction;
+  static typeInfo = Object.freeze({
+    englishName: "Percentage",
+    localizedName: "Procent",
+    emoji: "\u{1F4CA}",
+    sources: Object.freeze(["https://www.bipm.org/en/publications/si-brochure"])
+  });
+  /** The value as a fraction from 0 to 1, e.g. `0.85` for 85%. */
+  get value() {
+    return this.fraction.toNumber();
+  }
+  /** The value on a 0–100 scale, e.g. `85` for 85%. */
+  get percent() {
+    return this.fraction.times(HUNDRED).toNumber();
+  }
+  /** Creates a percentage from a 0–1 fraction, e.g. `0.85` for 85%. */
+  static fromDecimal(value) {
+    return new Percentage(checkedFraction(toDecimal(value)));
+  }
+  /** Creates a percentage from a 0–100 value, e.g. `85` for 85%. */
+  static fromPercent(percent) {
+    const raw = toDecimal(percent);
+    if (raw.compareTo(ZERO) < 0 || raw.compareTo(HUNDRED) > 0) {
+      throw new Error("Percent must be in the range 0 to 100 inclusive.");
+    }
+    return new Percentage(raw.dividedBy(HUNDRED));
+  }
+  /** Creates a percentage from a 0–100 value; the same as {@link fromPercent}. */
+  static create(percent) {
+    return Percentage.fromPercent(percent);
+  }
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = (0, import_input_sanitization.sanitizeInput)(input).trim();
+    if (trimmed.length === 0 || trimmed.length > MAX_INPUT_LENGTH) return null;
+    let raw;
+    let isPercentScale = false;
+    if (trimmed.endsWith("%")) {
+      raw = (0, import_measurement_unit_parser.tryParseNumberOnly)(trimmed.slice(0, -1).trimEnd());
+      isPercentScale = true;
+    } else {
+      const match = WORD_SUFFIX_PATTERN.exec(trimmed);
+      if (match?.groups?.["number"] !== void 0) {
+        const sign = match.groups["sign"] ?? "";
+        raw = (0, import_measurement_unit_parser.tryParseNumberOnly)(sign + match.groups["number"]);
+        isPercentScale = true;
+      } else {
+        raw = (0, import_measurement_unit_parser.tryParseNumberOnly)(trimmed);
+      }
+    }
+    if (raw === null) return null;
+    if (isPercentScale) {
+      if (raw.compareTo(ZERO) < 0 || raw.compareTo(HUNDRED) > 0) return null;
+      return new Percentage(raw.dividedBy(HUNDRED));
+    }
+    if (raw.compareTo(ZERO) < 0) return null;
+    if (raw.compareTo(ONE) <= 0) return new Percentage(raw);
+    if (raw.compareTo(HUNDRED) <= 0) return new Percentage(raw.dividedBy(HUNDRED));
+    return null;
+  }
+  static parse(input) {
+    const result = Percentage.tryParse(input);
+    if (result === null) throw new Error("Invalid percentage.");
+    return result;
+  }
+  static isValid(input) {
+    return Percentage.tryParse(input) !== null;
+  }
+  /** Display form with a percent sign, e.g. `85%`. */
+  static format(input, options) {
+    const parsed = Percentage.tryParse(input);
+    if (parsed !== null) {
+      return options?.decimals !== void 0 ? formatPercent(parsed.fraction, options.decimals) : parsed.toString();
+    }
+    return fallback(input, options);
+  }
+  /** The fraction as an invariant decimal string, e.g. `0.85`. */
+  static normalize(input, options) {
+    const parsed = Percentage.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Percentage.normalize(input) === input;
+  }
+  /** The fraction, e.g. `0.85`. */
+  toNormalizedString() {
+    return this.fraction.toTrimmedString();
+  }
+  /** The value with a percent sign, e.g. `85%`. */
+  toString() {
+    return formatPercent(this.fraction);
+  }
+  plus(other) {
+    return new Percentage(checkedFraction(this.fraction.plus(other.fraction)));
+  }
+  minus(other) {
+    return new Percentage(checkedFraction(this.fraction.minus(other.fraction)));
+  }
+  times(factor) {
+    return new Percentage(checkedFraction(this.fraction.times(toDecimal(factor))));
+  }
+  dividedBy(divisor) {
+    return new Percentage(checkedFraction(this.fraction.dividedBy(toDecimal(divisor))));
+  }
+  compareTo(other) {
+    if (other == null) return 1;
+    return this.fraction.compareTo(other.fraction);
+  }
+  equals(other) {
+    return other != null && this.fraction.equals(other.fraction);
+  }
+  isLessThan(other) {
+    return this.compareTo(other) < 0;
+  }
+  isGreaterThan(other) {
+    return this.compareTo(other) > 0;
+  }
+  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 = Percentage.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: "Percentage",
+          category: import_text_candidate_category.TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskPercentage(value),
+          confidence: import_text_match_confidence.TextMatchConfidence.Low,
+          value
+        })
+      );
+    }
+    return out;
+  }
+}
+function maskPercentage(percentage) {
+  void percentage;
+  return "***%";
+}
+function formatPercent(fraction, decimals) {
+  const percent = fraction.times(HUNDRED);
+  const rounded = decimals === void 0 ? percent : percent.round(decimals, "away-from-zero");
+  return `${rounded.toTrimmedString()}%`;
+}
+function checkedFraction(fraction) {
+  if (fraction.compareTo(ZERO) < 0 || fraction.compareTo(ONE) > 0) {
+    throw new Error("The operation produced a percentage outside the range 0% to 100%.");
+  }
+  return fraction;
+}
+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 percentage: ${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=percentage.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/percentage.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/** Options for {@link Percentage.format} and {@link Percentage.normalize}. */\nexport interface PercentageFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst ZERO = Decimal.parse(\"0\")!;\nconst ONE = Decimal.parse(\"1\")!;\nconst HUNDRED = Decimal.parse(\"100\")!;\nconst MAX_INPUT_LENGTH = 100;\n\nconst WORD_SUFFIX_PATTERN =\n  /^(?<sign>[+-])?\\s*(?<number>[0-9][0-9 .,]*[0-9]|[0-9])\\s+(?:procent|percent)\\s*$/iu;\n\nconst SCAN_PATTERN = /(?<![\\p{L}\\p{N}_])(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*%/gu;\n\n/**\n * A proportion from 0 to 100 percent, held internally as a fraction from 0 to\n * 1.\n *\n * Input without a percent sign is read on whichever scale fits: `0.85` is a\n * fraction, `85` is a percentage, and anything above 100 is rejected. With a\n * sign or the word `procent` / `percent` the percentage scale is explicit.\n */\nexport class Percentage {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Percentage\",\n    localizedName: \"Procent\",\n    emoji: \"\uD83D\uDCCA\",\n    sources: Object.freeze([\"https://www.bipm.org/en/publications/si-brochure\"]),\n  });\n\n  private constructor(private readonly fraction: Decimal) {}\n\n  /** The value as a fraction from 0 to 1, e.g. `0.85` for 85%. */\n  get value(): number {\n    return this.fraction.toNumber();\n  }\n\n  /** The value on a 0\u2013100 scale, e.g. `85` for 85%. */\n  get percent(): number {\n    return this.fraction.times(HUNDRED).toNumber();\n  }\n\n  /** Creates a percentage from a 0\u20131 fraction, e.g. `0.85` for 85%. */\n  static fromDecimal(value: number | Decimal): Percentage {\n    return new Percentage(checkedFraction(toDecimal(value)));\n  }\n\n  /** Creates a percentage from a 0\u2013100 value, e.g. `85` for 85%. */\n  static fromPercent(percent: number | Decimal): Percentage {\n    const raw = toDecimal(percent);\n    if (raw.compareTo(ZERO) < 0 || raw.compareTo(HUNDRED) > 0) {\n      throw new Error(\"Percent must be in the range 0 to 100 inclusive.\");\n    }\n    return new Percentage(raw.dividedBy(HUNDRED));\n  }\n\n  /** Creates a percentage from a 0\u2013100 value; the same as {@link fromPercent}. */\n  static create(percent: number | Decimal): Percentage {\n    return Percentage.fromPercent(percent);\n  }\n\n  static tryParse(input: string | null | undefined): Percentage | null {\n    if (input == null) return null;\n\n    const trimmed = sanitizeInput(input).trim();\n    if (trimmed.length === 0 || trimmed.length > MAX_INPUT_LENGTH) return null;\n\n    let raw: Decimal | null;\n    let isPercentScale = false;\n\n    if (trimmed.endsWith(\"%\")) {\n      raw = tryParseNumberOnly(trimmed.slice(0, -1).trimEnd());\n      isPercentScale = true;\n    } else {\n      const match = WORD_SUFFIX_PATTERN.exec(trimmed);\n      if (match?.groups?.[\"number\"] !== undefined) {\n        const sign = match.groups[\"sign\"] ?? \"\";\n        raw = tryParseNumberOnly(sign + match.groups[\"number\"]);\n        isPercentScale = true;\n      } else {\n        raw = tryParseNumberOnly(trimmed);\n      }\n    }\n\n    if (raw === null) return null;\n\n    if (isPercentScale) {\n      if (raw.compareTo(ZERO) < 0 || raw.compareTo(HUNDRED) > 0) return null;\n      return new Percentage(raw.dividedBy(HUNDRED));\n    }\n\n    if (raw.compareTo(ZERO) < 0) return null;\n    if (raw.compareTo(ONE) <= 0) return new Percentage(raw);\n    if (raw.compareTo(HUNDRED) <= 0) return new Percentage(raw.dividedBy(HUNDRED));\n    return null;\n  }\n\n  static parse(input: string): Percentage {\n    const result = Percentage.tryParse(input);\n    if (result === null) throw new Error(\"Invalid percentage.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Percentage.tryParse(input) !== null;\n  }\n\n  /** Display form with a percent sign, e.g. `85%`. */\n  static format(\n    input: string | null | undefined,\n    options?: PercentageFormatOptions,\n  ): string | null {\n    const parsed = Percentage.tryParse(input);\n    if (parsed !== null) {\n      return options?.decimals !== undefined\n        ? formatPercent(parsed.fraction, options.decimals)\n        : parsed.toString();\n    }\n    return fallback(input, options);\n  }\n\n  /** The fraction as an invariant decimal string, e.g. `0.85`. */\n  static normalize(\n    input: string | null | undefined,\n    options?: PercentageFormatOptions,\n  ): string | null {\n    const parsed = Percentage.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 && Percentage.normalize(input) === input;\n  }\n\n  /** The fraction, e.g. `0.85`. */\n  toNormalizedString(): string {\n    return this.fraction.toTrimmedString();\n  }\n\n  /** The value with a percent sign, e.g. `85%`. */\n  toString(): string {\n    return formatPercent(this.fraction);\n  }\n\n  plus(other: Percentage): Percentage {\n    return new Percentage(checkedFraction(this.fraction.plus(other.fraction)));\n  }\n\n  minus(other: Percentage): Percentage {\n    return new Percentage(checkedFraction(this.fraction.minus(other.fraction)));\n  }\n\n  times(factor: number | Decimal): Percentage {\n    return new Percentage(checkedFraction(this.fraction.times(toDecimal(factor))));\n  }\n\n  dividedBy(divisor: number | Decimal): Percentage {\n    return new Percentage(checkedFraction(this.fraction.dividedBy(toDecimal(divisor))));\n  }\n\n  compareTo(other: Percentage | null | undefined): number {\n    if (other == null) return 1;\n    return this.fraction.compareTo(other.fraction);\n  }\n\n  equals(other: Percentage | null | undefined): boolean {\n    return other != null && this.fraction.equals(other.fraction);\n  }\n\n  isLessThan(other: Percentage): boolean {\n    return this.compareTo(other) < 0;\n  }\n\n  isGreaterThan(other: Percentage): boolean {\n    return this.compareTo(other) > 0;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Percentage>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Percentage>[] = [];\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 = Percentage.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<Percentage>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"Percentage\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskPercentage(value),\n          confidence: TextMatchConfidence.Low,\n          value,\n        }),\n      );\n    }\n\n    return out;\n  }\n}\n\n/** Returns a masked percentage, e.g. `85%` becomes `***%`. */\nexport function maskPercentage(percentage: Percentage): string {\n  void percentage;\n  return \"***%\";\n}\n\nfunction formatPercent(fraction: Decimal, decimals?: number): string {\n  const percent = fraction.times(HUNDRED);\n  const rounded = decimals === undefined ? percent : percent.round(decimals, \"away-from-zero\");\n  return `${rounded.toTrimmedString()}%`;\n}\n\nfunction checkedFraction(fraction: Decimal): Decimal {\n  if (fraction.compareTo(ZERO) < 0 || fraction.compareTo(ONE) > 0) {\n    throw new Error(\"The operation produced a percentage outside the range 0% to 100%.\");\n  }\n  return fraction;\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 percentage: ${value}`);\n  return parsed;\n}\n\nfunction fallback(\n  input: string | null | undefined,\n  options?: PercentageFormatOptions,\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/power-unit.js

@@ -0,0 +1,155 @@
+"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 power_unit_exports = {};
+__export(power_unit_exports, {
+  PowerUnit: () => PowerUnit
+});
+module.exports = __toCommonJS(power_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 PowerUnit extends import_measurement_unit.MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Power Unit",
+    localizedName: "Effektenhet",
+    emoji: "\u{1F4A1}",
+    sources: Object.freeze([])
+  });
+  static Microwatt = new PowerUnit({
+    symbol: "\xB5W",
+    englishName: "microwatt",
+    localizedName: "mikrowatt",
+    pluralEnglish: "microwatts",
+    pluralSwedish: "mikrowatt",
+    toBaseUnitFactor: factor("0.000001"),
+    aliases: ["uW"]
+  });
+  static Milliwatt = new PowerUnit({
+    symbol: "mW",
+    englishName: "milliwatt",
+    localizedName: "milliwatt",
+    pluralEnglish: "milliwatts",
+    pluralSwedish: "milliwatt",
+    toBaseUnitFactor: factor("0.001")
+  });
+  static Watt = new PowerUnit({
+    symbol: "W",
+    englishName: "watt",
+    localizedName: "watt",
+    pluralEnglish: "watts",
+    pluralSwedish: "watt",
+    toBaseUnitFactor: factor("1")
+  });
+  static Kilowatt = new PowerUnit({
+    symbol: "kW",
+    englishName: "kilowatt",
+    localizedName: "kilowatt",
+    pluralEnglish: "kilowatts",
+    pluralSwedish: "kilowatt",
+    toBaseUnitFactor: factor("1000")
+  });
+  static Megawatt = new PowerUnit({
+    symbol: "MW",
+    englishName: "megawatt",
+    localizedName: "megawatt",
+    pluralEnglish: "megawatts",
+    pluralSwedish: "megawatt",
+    toBaseUnitFactor: factor("1000000")
+  });
+  static Gigawatt = new PowerUnit({
+    symbol: "GW",
+    englishName: "gigawatt",
+    localizedName: "gigawatt",
+    pluralEnglish: "gigawatts",
+    pluralSwedish: "gigawatt",
+    toBaseUnitFactor: factor("1000000000")
+  });
+  static Terawatt = new PowerUnit({
+    symbol: "TW",
+    englishName: "terawatt",
+    localizedName: "terawatt",
+    pluralEnglish: "terawatts",
+    pluralSwedish: "terawatt",
+    toBaseUnitFactor: factor("1000000000000")
+  });
+  static Horsepower = new PowerUnit({
+    symbol: "HP",
+    englishName: "horsepower",
+    localizedName: "h\xE4stkraft",
+    pluralEnglish: "horsepower",
+    pluralSwedish: "h\xE4stkrafter",
+    toBaseUnitFactor: factor("745.69987158227022"),
+    aliases: ["hp", "horsepower", "hk", "h\xE4stkraft", "h\xE4stkrafter"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new import_measurement_unit.MeasurementUnitIndex(
+    [
+      PowerUnit.Microwatt,
+      PowerUnit.Milliwatt,
+      PowerUnit.Watt,
+      PowerUnit.Kilowatt,
+      PowerUnit.Megawatt,
+      PowerUnit.Gigawatt,
+      PowerUnit.Terawatt,
+      PowerUnit.Horsepower
+    ],
+    PowerUnit.Watt,
+    [PowerUnit.Watt, PowerUnit.Kilowatt, PowerUnit.Megawatt, PowerUnit.Gigawatt],
+    [PowerUnit.Milliwatt, PowerUnit.Megawatt]
+  );
+  static get all() {
+    return PowerUnit.index.all;
+  }
+  /** The base unit: W. */
+  static get baseUnit() {
+    return PowerUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return PowerUnit.index.naturalScale;
+  }
+  /**
+   * Resolves a unit from a symbol, name, plural or alias, case-insensitively —
+   * except for `mW` and `MW`, which differ by a factor of a billion and are
+   * therefore the one case-sensitive pair.
+   */
+  static tryParse(input) {
+    if (input == null) return null;
+    const trimmed = input.trim();
+    if (trimmed.length === 2 && (trimmed[1] === "W" || trimmed[1] === "w")) {
+      if (trimmed[0] === "m") return PowerUnit.Milliwatt;
+      if (trimmed[0] === "M") return PowerUnit.Megawatt;
+    }
+    return PowerUnit.index.tryParse(trimmed);
+  }
+  static parse(input) {
+    const result = PowerUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown power unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in W. */
+  static getNatural(baseValue) {
+    return PowerUnit.index.getNatural(baseValue);
+  }
+}
+//# sourceMappingURL=power-unit.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/power-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 power 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 PowerUnit extends MeasurementUnit {\n  declare private readonly __powerUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Power Unit\",\n    localizedName: \"Effektenhet\",\n    emoji: \"\uD83D\uDCA1\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Microwatt = new PowerUnit({\n    symbol: \"\u00B5W\",\n    englishName: \"microwatt\",\n    localizedName: \"mikrowatt\",\n    pluralEnglish: \"microwatts\",\n    pluralSwedish: \"mikrowatt\",\n    toBaseUnitFactor: factor(\"0.000001\"),\n    aliases: [\"uW\"],\n  });\n\n  static readonly Milliwatt = new PowerUnit({\n    symbol: \"mW\",\n    englishName: \"milliwatt\",\n    localizedName: \"milliwatt\",\n    pluralEnglish: \"milliwatts\",\n    pluralSwedish: \"milliwatt\",\n    toBaseUnitFactor: factor(\"0.001\"),\n  });\n\n  static readonly Watt = new PowerUnit({\n    symbol: \"W\",\n    englishName: \"watt\",\n    localizedName: \"watt\",\n    pluralEnglish: \"watts\",\n    pluralSwedish: \"watt\",\n    toBaseUnitFactor: factor(\"1\"),\n  });\n\n  static readonly Kilowatt = new PowerUnit({\n    symbol: \"kW\",\n    englishName: \"kilowatt\",\n    localizedName: \"kilowatt\",\n    pluralEnglish: \"kilowatts\",\n    pluralSwedish: \"kilowatt\",\n    toBaseUnitFactor: factor(\"1000\"),\n  });\n\n  static readonly Megawatt = new PowerUnit({\n    symbol: \"MW\",\n    englishName: \"megawatt\",\n    localizedName: \"megawatt\",\n    pluralEnglish: \"megawatts\",\n    pluralSwedish: \"megawatt\",\n    toBaseUnitFactor: factor(\"1000000\"),\n  });\n\n  static readonly Gigawatt = new PowerUnit({\n    symbol: \"GW\",\n    englishName: \"gigawatt\",\n    localizedName: \"gigawatt\",\n    pluralEnglish: \"gigawatts\",\n    pluralSwedish: \"gigawatt\",\n    toBaseUnitFactor: factor(\"1000000000\"),\n  });\n\n  static readonly Terawatt = new PowerUnit({\n    symbol: \"TW\",\n    englishName: \"terawatt\",\n    localizedName: \"terawatt\",\n    pluralEnglish: \"terawatts\",\n    pluralSwedish: \"terawatt\",\n    toBaseUnitFactor: factor(\"1000000000000\"),\n  });\n\n  static readonly Horsepower = new PowerUnit({\n    symbol: \"HP\",\n    englishName: \"horsepower\",\n    localizedName: \"h\u00E4stkraft\",\n    pluralEnglish: \"horsepower\",\n    pluralSwedish: \"h\u00E4stkrafter\",\n    toBaseUnitFactor: factor(\"745.69987158227022\"),\n    aliases: [\"hp\", \"horsepower\", \"hk\", \"h\u00E4stkraft\", \"h\u00E4stkrafter\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<PowerUnit> = new MeasurementUnitIndex<PowerUnit>(\n    [\n      PowerUnit.Microwatt,\n      PowerUnit.Milliwatt,\n      PowerUnit.Watt,\n      PowerUnit.Kilowatt,\n      PowerUnit.Megawatt,\n      PowerUnit.Gigawatt,\n      PowerUnit.Terawatt,\n      PowerUnit.Horsepower,\n    ],\n    PowerUnit.Watt,\n    [PowerUnit.Watt, PowerUnit.Kilowatt, PowerUnit.Megawatt, PowerUnit.Gigawatt],\n    [PowerUnit.Milliwatt, PowerUnit.Megawatt],\n  );\n\n  static get all(): readonly PowerUnit[] {\n    return PowerUnit.index.all;\n  }\n\n  /** The base unit: W. */\n  static get baseUnit(): PowerUnit {\n    return PowerUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly PowerUnit[] {\n    return PowerUnit.index.naturalScale;\n  }\n\n  /**\n   * Resolves a unit from a symbol, name, plural or alias, case-insensitively \u2014\n   * except for `mW` and `MW`, which differ by a factor of a billion and are\n   * therefore the one case-sensitive pair.\n   */\n  static tryParse(input: string | null | undefined): PowerUnit | null {\n    if (input == null) return null;\n    const trimmed = input.trim();\n\n    if (trimmed.length === 2 && (trimmed[1] === \"W\" || trimmed[1] === \"w\")) {\n      if (trimmed[0] === \"m\") return PowerUnit.Milliwatt;\n      if (trimmed[0] === \"M\") return PowerUnit.Megawatt;\n    }\n\n    return PowerUnit.index.tryParse(trimmed);\n  }\n\n  static parse(input: string): PowerUnit {\n    const result = PowerUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown power unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in W. */\n  static getNatural(baseValue: Decimal): PowerUnit {\n    return PowerUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/measurement/power.js

@@ -0,0 +1,188 @@
+"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 power_exports = {};
+__export(power_exports, {
+  Power: () => Power,
+  maskPower: () => maskPower
+});
+module.exports = __toCommonJS(power_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_power_unit = require("./power-unit.js");
+const VALUE_PREFIX = String.raw`(?<![\p{L}\p{N}_])(?:[+-]\s*)?\d+[0-9 .,]*\s*`;
+const UNIT_SUFFIX = String.raw`(?![\p{L}\p{N}_])`;
+const CASE_SENSITIVE_PATTERN = new RegExp(
+  String.raw`${VALUE_PREFIX}(?:µW|uW|mW|MW|TW)${UNIT_SUFFIX}`,
+  "gu"
+);
+const CASE_INSENSITIVE_PATTERN = new RegExp(
+  String.raw`${VALUE_PREFIX}(?:kW|GW|W|hp|horsepower|hästkraft|hästkrafter|microwatt|mikrowatt|milliwatt|megawatt|gigawatt|terawatt|kilowatt|watt)${UNIT_SUFFIX}`,
+  "giu"
+);
+class Power extends import_quantity.Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Power",
+    localizedName: "Effekt",
+    emoji: "\u{1F4A1}",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-derived-units",
+      "https://en.wikipedia.org/wiki/Horsepower"
+    ])
+  });
+  get units() {
+    return import_power_unit.PowerUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new Power(baseValue, unit);
+  }
+  get microwatts() {
+    return this.in(import_power_unit.PowerUnit.Microwatt);
+  }
+  get milliwatts() {
+    return this.in(import_power_unit.PowerUnit.Milliwatt);
+  }
+  get watts() {
+    return this.in(import_power_unit.PowerUnit.Watt);
+  }
+  get kilowatts() {
+    return this.in(import_power_unit.PowerUnit.Kilowatt);
+  }
+  get megawatts() {
+    return this.in(import_power_unit.PowerUnit.Megawatt);
+  }
+  get gigawatts() {
+    return this.in(import_power_unit.PowerUnit.Gigawatt);
+  }
+  get terawatts() {
+    return this.in(import_power_unit.PowerUnit.Terawatt);
+  }
+  get horsepower() {
+    return this.in(import_power_unit.PowerUnit.Horsepower);
+  }
+  /** Creates a power from a value and unit. */
+  static create(value, unit) {
+    import_power_unit.PowerUnit.index.assertOwns(unit);
+    const amount = value instanceof import_decimal.Decimal ? value : Power.decimalOf(value);
+    return new Power(unit.toBase(amount), unit);
+  }
+  static fromMicrowatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Microwatt);
+  }
+  static fromMilliwatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Milliwatt);
+  }
+  static fromWatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Watt);
+  }
+  static fromKilowatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Kilowatt);
+  }
+  static fromMegawatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Megawatt);
+  }
+  static fromGigawatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Gigawatt);
+  }
+  static fromTerawatts(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Terawatt);
+  }
+  static fromHorsepower(value) {
+    return Power.create(value, import_power_unit.PowerUnit.Horsepower);
+  }
+  static tryParse(input) {
+    const parsed = (0, import_quantity.tryParseQuantity)(input, import_power_unit.PowerUnit.index, import_power_unit.PowerUnit.tryParse);
+    return parsed === null ? null : new Power(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = Power.tryParse(input);
+    if (result === null) throw new Error("Invalid power.");
+    return result;
+  }
+  static isValid(input) {
+    return Power.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = Power.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 Power.fallback(input, options);
+  }
+  /** The value in watts, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = Power.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return Power.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && Power.normalize(input) === input;
+  }
+  static findCandidatesInText(text) {
+    if (!text) return [];
+    const out = [];
+    for (const pattern of [CASE_SENSITIVE_PATTERN, CASE_INSENSITIVE_PATTERN]) {
+      const scanner = new RegExp(pattern.source, pattern.flags);
+      let match;
+      while ((match = scanner.exec(text)) !== null) {
+        const start = match.index;
+        const end = start + match[0].length;
+        if (out.some((c) => start < c.endIndex && c.startIndex < end)) continue;
+        const value = Power.tryParse(match[0]);
+        if (value === null) continue;
+        out.push(
+          new import_text_candidate.TextCandidate({
+            startIndex: start,
+            length: match[0].length,
+            originalText: match[0],
+            typeName: "Power",
+            category: import_text_candidate_category.TextCandidateCategory.Measurement,
+            normalizedForm: value.toNormalizedString(),
+            formattedForm: value.toString(),
+            maskedForm: maskPower(value),
+            confidence: import_text_match_confidence.TextMatchConfidence.Medium,
+            value
+          })
+        );
+      }
+    }
+    return out.sort((a, b) => a.startIndex - b.startIndex);
+  }
+  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 power: ${value}`);
+    return parsed;
+  }
+}
+function maskPower(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+//# sourceMappingURL=power.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/power.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 { PowerUnit } from \"./power-unit.js\";\n\n/** Options for {@link Power.format} and {@link Power.normalize}. */\nexport interface PowerFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: PowerUnit;\n  /** Round to this many fractional digits, away from zero. */\n  decimals?: number;\n}\n\nconst VALUE_PREFIX = String.raw`(?<![\\p{L}\\p{N}_])(?:[+-]\\s*)?\\d+[0-9 .,]*\\s*`;\nconst UNIT_SUFFIX = String.raw`(?![\\p{L}\\p{N}_])`;\n\n/**\n * Milliwatt and megawatt differ only by case, so their symbols must be matched\n * case-sensitively. Everything else may be written either way.\n *\n * .NET expresses this as one pattern with a scoped `(?i:...)` group. JavaScript\n * has no scoped flags, so the two halves are separate patterns and\n * {@link Power.findCandidatesInText} merges their results.\n */\nconst CASE_SENSITIVE_PATTERN = new RegExp(\n  String.raw`${VALUE_PREFIX}(?:\u00B5W|uW|mW|MW|TW)${UNIT_SUFFIX}`,\n  \"gu\",\n);\n\nconst CASE_INSENSITIVE_PATTERN = new RegExp(\n  String.raw`${VALUE_PREFIX}(?:kW|GW|W|hp|horsepower|h\u00E4stkraft|h\u00E4stkrafter|microwatt|mikrowatt|milliwatt|megawatt|gigawatt|terawatt|kilowatt|watt)${UNIT_SUFFIX}`,\n  \"giu\",\n);\n\n/**\n * A power stored internally in watts,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class Power extends Quantity<PowerUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Power\",\n    localizedName: \"Effekt\",\n    emoji: \"\uD83D\uDCA1\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-derived-units\",\n      \"https://en.wikipedia.org/wiki/Horsepower\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<PowerUnit> {\n    return PowerUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: PowerUnit): this {\n    return new Power(baseValue, unit) as this;\n  }\n\n  get microwatts(): number {\n    return this.in(PowerUnit.Microwatt);\n  }\n  get milliwatts(): number {\n    return this.in(PowerUnit.Milliwatt);\n  }\n  get watts(): number {\n    return this.in(PowerUnit.Watt);\n  }\n  get kilowatts(): number {\n    return this.in(PowerUnit.Kilowatt);\n  }\n  get megawatts(): number {\n    return this.in(PowerUnit.Megawatt);\n  }\n  get gigawatts(): number {\n    return this.in(PowerUnit.Gigawatt);\n  }\n  get terawatts(): number {\n    return this.in(PowerUnit.Terawatt);\n  }\n  get horsepower(): number {\n    return this.in(PowerUnit.Horsepower);\n  }\n\n  /** Creates a power from a value and unit. */\n  static create(value: number | Decimal, unit: PowerUnit): Power {\n    PowerUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : Power.decimalOf(value);\n    return new Power(unit.toBase(amount), unit);\n  }\n\n  static fromMicrowatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Microwatt);\n  }\n  static fromMilliwatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Milliwatt);\n  }\n  static fromWatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Watt);\n  }\n  static fromKilowatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Kilowatt);\n  }\n  static fromMegawatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Megawatt);\n  }\n  static fromGigawatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Gigawatt);\n  }\n  static fromTerawatts(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Terawatt);\n  }\n  static fromHorsepower(value: number | Decimal): Power {\n    return Power.create(value, PowerUnit.Horsepower);\n  }\n\n  static tryParse(input: string | null | undefined): Power | null {\n    const parsed = tryParseQuantity(input, PowerUnit.index, PowerUnit.tryParse);\n    return parsed === null ? null : new Power(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): Power {\n    const result = Power.tryParse(input);\n    if (result === null) throw new Error(\"Invalid power.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return Power.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?: PowerFormatOptions): string | null {\n    const parsed = Power.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 Power.fallback(input, options);\n  }\n\n  /** The value in watts, or `null` when the input is invalid. */\n  static normalize(input: string | null | undefined, options?: PowerFormatOptions): string | null {\n    const parsed = Power.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return Power.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && Power.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<Power>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<Power>[] = [];\n\n    // The case-sensitive symbols run first so that `mW` and `MW` win over the\n    // looser `W`, mirroring the alternation order in the .NET pattern.\n    for (const pattern of [CASE_SENSITIVE_PATTERN, CASE_INSENSITIVE_PATTERN]) {\n      const scanner = new RegExp(pattern.source, pattern.flags);\n      let match: RegExpExecArray | null;\n\n      while ((match = scanner.exec(text)) !== null) {\n        const start = match.index;\n        const end = start + match[0].length;\n        if (out.some((c) => start < c.endIndex && c.startIndex < end)) continue;\n\n        const value = Power.tryParse(match[0]);\n        if (value === null) continue;\n        out.push(\n          new TextCandidate<Power>({\n            startIndex: start,\n            length: match[0].length,\n            originalText: match[0],\n            typeName: \"Power\",\n            category: TextCandidateCategory.Measurement,\n            normalizedForm: value.toNormalizedString(),\n            formattedForm: value.toString(),\n            maskedForm: maskPower(value),\n            confidence: TextMatchConfidence.Medium,\n            value,\n          }),\n        );\n      }\n    }\n\n    return out.sort((a, b) => a.startIndex - b.startIndex);\n  }\n\n  private static fallback(\n    input: string | null | undefined,\n    options?: PowerFormatOptions,\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 power: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked power, e.g. `10 W` becomes `*** W`. */\nexport function maskPower(value: Power): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}