@budiauktioner/buildi-primitives 0.1.1 → 0.2.0

package/dist/esm/measurement/electric-charge.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/electric-charge.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 { ElectricChargeUnit } from \"./electric-charge-unit.js\";\n\n/** Options for {@link ElectricCharge.format} and {@link ElectricCharge.normalize}. */\nexport interface ElectricChargeFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: ElectricChargeUnit;\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*(?:mAh|Ah|C)\\b`,\n  \"giu\",\n);\n\n/**\n * A electric charge stored internally in ampere-hours,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class ElectricCharge extends Quantity<ElectricChargeUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Electric Charge\",\n    localizedName: \"Elektrisk laddning\",\n    emoji: \"\uD83D\uDD0B\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-derived-units\",\n      \"https://en.wikipedia.org/wiki/Ampere-hour\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<ElectricChargeUnit> {\n    return ElectricChargeUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: ElectricChargeUnit): this {\n    return new ElectricCharge(baseValue, unit) as this;\n  }\n\n  get milliampereHours(): number {\n    return this.in(ElectricChargeUnit.MilliampereHour);\n  }\n  get ampereHours(): number {\n    return this.in(ElectricChargeUnit.AmpereHour);\n  }\n  get coulombs(): number {\n    return this.in(ElectricChargeUnit.Coulomb);\n  }\n\n  /** Creates a electric charge from a value and unit. */\n  static create(value: number | Decimal, unit: ElectricChargeUnit): ElectricCharge {\n    ElectricChargeUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : ElectricCharge.decimalOf(value);\n    return new ElectricCharge(unit.toBase(amount), unit);\n  }\n\n  static fromMilliampereHours(value: number | Decimal): ElectricCharge {\n    return ElectricCharge.create(value, ElectricChargeUnit.MilliampereHour);\n  }\n  static fromAmpereHours(value: number | Decimal): ElectricCharge {\n    return ElectricCharge.create(value, ElectricChargeUnit.AmpereHour);\n  }\n  static fromCoulombs(value: number | Decimal): ElectricCharge {\n    return ElectricCharge.create(value, ElectricChargeUnit.Coulomb);\n  }\n\n  static tryParse(input: string | null | undefined): ElectricCharge | null {\n    const parsed = tryParseQuantity(input, ElectricChargeUnit.index);\n    return parsed === null ? null : new ElectricCharge(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): ElectricCharge {\n    const result = ElectricCharge.tryParse(input);\n    if (result === null) throw new Error(\"Invalid electric charge.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return ElectricCharge.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?: ElectricChargeFormatOptions,\n  ): string | null {\n    const parsed = ElectricCharge.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 ElectricCharge.fallback(input, options);\n  }\n\n  /** The value in ampere-hours, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: ElectricChargeFormatOptions,\n  ): string | null {\n    const parsed = ElectricCharge.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return ElectricCharge.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && ElectricCharge.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<ElectricCharge>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<ElectricCharge>[] = [];\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 = ElectricCharge.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<ElectricCharge>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"ElectricCharge\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskElectricCharge(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?: ElectricChargeFormatOptions,\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 electric charge: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked electric charge, e.g. `10 Ah` becomes `*** Ah`. */\nexport function maskElectricCharge(value: ElectricCharge): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/measurement/electric-current-unit.js

@@ -0,0 +1,88 @@
+import { Decimal } from "../internal/decimal.js";
+import { MeasurementUnit, MeasurementUnitIndex } from "../internal/measurement-unit.js";
+function factor(literal) {
+  const parsed = Decimal.parse(literal);
+  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);
+  return parsed;
+}
+class ElectricCurrentUnit extends MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Electric Current Unit",
+    localizedName: "Str\xF6menhet",
+    emoji: "\u26A1",
+    sources: Object.freeze([])
+  });
+  static Microampere = new ElectricCurrentUnit({
+    symbol: "\xB5A",
+    englishName: "microampere",
+    localizedName: "mikroampere",
+    pluralEnglish: "microamperes",
+    pluralSwedish: "mikroampere",
+    toBaseUnitFactor: factor("0.000001"),
+    aliases: ["uA"]
+  });
+  static Milliampere = new ElectricCurrentUnit({
+    symbol: "mA",
+    englishName: "milliampere",
+    localizedName: "milliampere",
+    pluralEnglish: "milliamperes",
+    pluralSwedish: "milliampere",
+    toBaseUnitFactor: factor("0.001")
+  });
+  static Ampere = new ElectricCurrentUnit({
+    symbol: "A",
+    englishName: "ampere",
+    localizedName: "ampere",
+    pluralEnglish: "amperes",
+    pluralSwedish: "ampere",
+    toBaseUnitFactor: factor("1"),
+    aliases: ["amp", "amps"]
+  });
+  static Kiloampere = new ElectricCurrentUnit({
+    symbol: "kA",
+    englishName: "kiloampere",
+    localizedName: "kiloampere",
+    pluralEnglish: "kiloamperes",
+    pluralSwedish: "kiloampere",
+    toBaseUnitFactor: factor("1000")
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new MeasurementUnitIndex(
+    [
+      ElectricCurrentUnit.Microampere,
+      ElectricCurrentUnit.Milliampere,
+      ElectricCurrentUnit.Ampere,
+      ElectricCurrentUnit.Kiloampere
+    ],
+    ElectricCurrentUnit.Ampere,
+    [ElectricCurrentUnit.Milliampere, ElectricCurrentUnit.Ampere, ElectricCurrentUnit.Kiloampere]
+  );
+  static get all() {
+    return ElectricCurrentUnit.index.all;
+  }
+  /** The base unit: A. */
+  static get baseUnit() {
+    return ElectricCurrentUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return ElectricCurrentUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return ElectricCurrentUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = ElectricCurrentUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown electric current unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in A. */
+  static getNatural(baseValue) {
+    return ElectricCurrentUnit.index.getNatural(baseValue);
+  }
+}
+export {
+  ElectricCurrentUnit
+};
+//# sourceMappingURL=electric-current-unit.js.map

package/dist/esm/measurement/electric-current-unit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/electric-current-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 electric current 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 ElectricCurrentUnit extends MeasurementUnit {\n  declare private readonly __electricCurrentUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Electric Current Unit\",\n    localizedName: \"Str\u00F6menhet\",\n    emoji: \"\u26A1\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Microampere = new ElectricCurrentUnit({\n    symbol: \"\u00B5A\",\n    englishName: \"microampere\",\n    localizedName: \"mikroampere\",\n    pluralEnglish: \"microamperes\",\n    pluralSwedish: \"mikroampere\",\n    toBaseUnitFactor: factor(\"0.000001\"),\n    aliases: [\"uA\"],\n  });\n\n  static readonly Milliampere = new ElectricCurrentUnit({\n    symbol: \"mA\",\n    englishName: \"milliampere\",\n    localizedName: \"milliampere\",\n    pluralEnglish: \"milliamperes\",\n    pluralSwedish: \"milliampere\",\n    toBaseUnitFactor: factor(\"0.001\"),\n  });\n\n  static readonly Ampere = new ElectricCurrentUnit({\n    symbol: \"A\",\n    englishName: \"ampere\",\n    localizedName: \"ampere\",\n    pluralEnglish: \"amperes\",\n    pluralSwedish: \"ampere\",\n    toBaseUnitFactor: factor(\"1\"),\n    aliases: [\"amp\", \"amps\"],\n  });\n\n  static readonly Kiloampere = new ElectricCurrentUnit({\n    symbol: \"kA\",\n    englishName: \"kiloampere\",\n    localizedName: \"kiloampere\",\n    pluralEnglish: \"kiloamperes\",\n    pluralSwedish: \"kiloampere\",\n    toBaseUnitFactor: factor(\"1000\"),\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<ElectricCurrentUnit> =\n    new MeasurementUnitIndex<ElectricCurrentUnit>(\n      [\n        ElectricCurrentUnit.Microampere,\n        ElectricCurrentUnit.Milliampere,\n        ElectricCurrentUnit.Ampere,\n        ElectricCurrentUnit.Kiloampere,\n      ],\n      ElectricCurrentUnit.Ampere,\n      [ElectricCurrentUnit.Milliampere, ElectricCurrentUnit.Ampere, ElectricCurrentUnit.Kiloampere],\n    );\n\n  static get all(): readonly ElectricCurrentUnit[] {\n    return ElectricCurrentUnit.index.all;\n  }\n\n  /** The base unit: A. */\n  static get baseUnit(): ElectricCurrentUnit {\n    return ElectricCurrentUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly ElectricCurrentUnit[] {\n    return ElectricCurrentUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): ElectricCurrentUnit | null {\n    return ElectricCurrentUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): ElectricCurrentUnit {\n    const result = ElectricCurrentUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown electric current unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in A. */\n  static getNatural(baseValue: Decimal): ElectricCurrentUnit {\n    return ElectricCurrentUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AACxB,SAAS,iBAAiB,4BAA4B;AAGtD,SAAS,OAAO,SAA0B;AACxC,QAAM,SAAS,QAAQ,MAAM,OAAO;AAEpC,MAAI,WAAW,KAAM,OAAM,IAAI,MAAM,8BAA8B,OAAO,EAAE;AAC5E,SAAO;AACT;AAOO,MAAM,4BAA4B,gBAAgB;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,cAAc,IAAI,oBAAoB;AAAA,IACpD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,UAAU;AAAA,IACnC,SAAS,CAAC,IAAI;AAAA,EAChB,CAAC;AAAA,EAED,OAAgB,cAAc,IAAI,oBAAoB;AAAA,IACpD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,OAAO;AAAA,EAClC,CAAC;AAAA,EAED,OAAgB,SAAS,IAAI,oBAAoB;AAAA,IAC/C,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,GAAG;AAAA,IAC5B,SAAS,CAAC,OAAO,MAAM;AAAA,EACzB,CAAC;AAAA,EAED,OAAgB,aAAa,IAAI,oBAAoB;AAAA,IACnD,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,eAAe;AAAA,IACf,eAAe;AAAA,IACf,eAAe;AAAA,IACf,kBAAkB,OAAO,MAAM;AAAA,EACjC,CAAC;AAAA;AAAA,EAGD,OAAgB,QACd,IAAI;AAAA,IACF;AAAA,MACE,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,MACpB,oBAAoB;AAAA,IACtB;AAAA,IACA,oBAAoB;AAAA,IACpB,CAAC,oBAAoB,aAAa,oBAAoB,QAAQ,oBAAoB,UAAU;AAAA,EAC9F;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/esm/measurement/electric-current.js

@@ -0,0 +1,134 @@
+import { Decimal } from "../internal/decimal.js";
+import { Quantity, tryParseQuantity } from "../internal/quantity.js";
+import { TextCandidate } from "../text-scanning/text-candidate.js";
+import { TextCandidateCategory } from "../text-scanning/text-candidate-category.js";
+import { TextMatchConfidence } from "../text-scanning/text-match-confidence.js";
+import { ElectricCurrentUnit } from "./electric-current-unit.js";
+const SCAN_PATTERN = new RegExp(
+  String.raw`(?<!\w)(?:[+-]\s*)?\d+[0-9 .,]*\s*(?:µA|uA|mA|kA|A)\b`,
+  "giu"
+);
+class ElectricCurrent extends Quantity {
+  static typeInfo = Object.freeze({
+    englishName: "Electric Current",
+    localizedName: "Elektrisk str\xF6m",
+    emoji: "\u26A1",
+    sources: Object.freeze([
+      "https://www.bipm.org/en/measurement-units/si-base-units",
+      "https://en.wikipedia.org/wiki/Ampere"
+    ])
+  });
+  get units() {
+    return ElectricCurrentUnit.index;
+  }
+  withBaseValue(baseValue, unit) {
+    return new ElectricCurrent(baseValue, unit);
+  }
+  get microamperes() {
+    return this.in(ElectricCurrentUnit.Microampere);
+  }
+  get milliamperes() {
+    return this.in(ElectricCurrentUnit.Milliampere);
+  }
+  get amperes() {
+    return this.in(ElectricCurrentUnit.Ampere);
+  }
+  get kiloamperes() {
+    return this.in(ElectricCurrentUnit.Kiloampere);
+  }
+  /** Creates a electric current from a value and unit. */
+  static create(value, unit) {
+    ElectricCurrentUnit.index.assertOwns(unit);
+    const amount = value instanceof Decimal ? value : ElectricCurrent.decimalOf(value);
+    return new ElectricCurrent(unit.toBase(amount), unit);
+  }
+  static fromMicroamperes(value) {
+    return ElectricCurrent.create(value, ElectricCurrentUnit.Microampere);
+  }
+  static fromMilliamperes(value) {
+    return ElectricCurrent.create(value, ElectricCurrentUnit.Milliampere);
+  }
+  static fromAmperes(value) {
+    return ElectricCurrent.create(value, ElectricCurrentUnit.Ampere);
+  }
+  static fromKiloamperes(value) {
+    return ElectricCurrent.create(value, ElectricCurrentUnit.Kiloampere);
+  }
+  static tryParse(input) {
+    const parsed = tryParseQuantity(input, ElectricCurrentUnit.index);
+    return parsed === null ? null : new ElectricCurrent(parsed.baseValue, parsed.unit);
+  }
+  static parse(input) {
+    const result = ElectricCurrent.tryParse(input);
+    if (result === null) throw new Error("Invalid electric current.");
+    return result;
+  }
+  static isValid(input) {
+    return ElectricCurrent.tryParse(input) !== null;
+  }
+  /** Display form in the parsed unit, or `null` when the input is invalid. */
+  static format(input, options) {
+    const parsed = ElectricCurrent.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 ElectricCurrent.fallback(input, options);
+  }
+  /** The value in amperes, or `null` when the input is invalid. */
+  static normalize(input, options) {
+    const parsed = ElectricCurrent.tryParse(input);
+    if (parsed !== null) return parsed.toNormalizedString();
+    return ElectricCurrent.fallback(input, options);
+  }
+  static isNormalized(input) {
+    return input != null && ElectricCurrent.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 = ElectricCurrent.tryParse(match[0]);
+      if (value === null) continue;
+      out.push(
+        new TextCandidate({
+          startIndex: match.index,
+          length: match[0].length,
+          originalText: match[0],
+          typeName: "ElectricCurrent",
+          category: TextCandidateCategory.Measurement,
+          normalizedForm: value.toNormalizedString(),
+          formattedForm: value.toString(),
+          maskedForm: maskElectricCurrent(value),
+          confidence: TextMatchConfidence.Medium,
+          value
+        })
+      );
+    }
+    return out;
+  }
+  static fallback(input, options) {
+    if (options?.fallbackToTrimmedInputWhenInvalid !== true) return null;
+    if (input == null) return null;
+    const trimmed = input.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  static decimalOf(value) {
+    const parsed = Decimal.fromNumber(value);
+    if (parsed === null)
+      throw new Error(`Value cannot be represented as a electric current: ${value}`);
+    return parsed;
+  }
+}
+function maskElectricCurrent(value) {
+  return `*** ${value.originalUnit.symbol}`;
+}
+export {
+  ElectricCurrent,
+  maskElectricCurrent
+};
+//# sourceMappingURL=electric-current.js.map

package/dist/esm/measurement/electric-current.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/electric-current.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 { ElectricCurrentUnit } from \"./electric-current-unit.js\";\n\n/** Options for {@link ElectricCurrent.format} and {@link ElectricCurrent.normalize}. */\nexport interface ElectricCurrentFormatOptions {\n  fallbackToTrimmedInputWhenInvalid?: boolean;\n  /** Convert to this unit instead of preserving the parsed one. */\n  unit?: ElectricCurrentUnit;\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*(?:\u00B5A|uA|mA|kA|A)\\b`,\n  \"giu\",\n);\n\n/**\n * A electric current stored internally in amperes,\n * parsed from any supported unit and convertible between all of them.\n */\nexport class ElectricCurrent extends Quantity<ElectricCurrentUnit> {\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Electric Current\",\n    localizedName: \"Elektrisk str\u00F6m\",\n    emoji: \"\u26A1\",\n    sources: Object.freeze([\n      \"https://www.bipm.org/en/measurement-units/si-base-units\",\n      \"https://en.wikipedia.org/wiki/Ampere\",\n    ]),\n  });\n\n  protected get units(): MeasurementUnitIndex<ElectricCurrentUnit> {\n    return ElectricCurrentUnit.index;\n  }\n\n  protected withBaseValue(baseValue: Decimal, unit: ElectricCurrentUnit): this {\n    return new ElectricCurrent(baseValue, unit) as this;\n  }\n\n  get microamperes(): number {\n    return this.in(ElectricCurrentUnit.Microampere);\n  }\n  get milliamperes(): number {\n    return this.in(ElectricCurrentUnit.Milliampere);\n  }\n  get amperes(): number {\n    return this.in(ElectricCurrentUnit.Ampere);\n  }\n  get kiloamperes(): number {\n    return this.in(ElectricCurrentUnit.Kiloampere);\n  }\n\n  /** Creates a electric current from a value and unit. */\n  static create(value: number | Decimal, unit: ElectricCurrentUnit): ElectricCurrent {\n    ElectricCurrentUnit.index.assertOwns(unit);\n    const amount = value instanceof Decimal ? value : ElectricCurrent.decimalOf(value);\n    return new ElectricCurrent(unit.toBase(amount), unit);\n  }\n\n  static fromMicroamperes(value: number | Decimal): ElectricCurrent {\n    return ElectricCurrent.create(value, ElectricCurrentUnit.Microampere);\n  }\n  static fromMilliamperes(value: number | Decimal): ElectricCurrent {\n    return ElectricCurrent.create(value, ElectricCurrentUnit.Milliampere);\n  }\n  static fromAmperes(value: number | Decimal): ElectricCurrent {\n    return ElectricCurrent.create(value, ElectricCurrentUnit.Ampere);\n  }\n  static fromKiloamperes(value: number | Decimal): ElectricCurrent {\n    return ElectricCurrent.create(value, ElectricCurrentUnit.Kiloampere);\n  }\n\n  static tryParse(input: string | null | undefined): ElectricCurrent | null {\n    const parsed = tryParseQuantity(input, ElectricCurrentUnit.index);\n    return parsed === null ? null : new ElectricCurrent(parsed.baseValue, parsed.unit);\n  }\n\n  static parse(input: string): ElectricCurrent {\n    const result = ElectricCurrent.tryParse(input);\n    if (result === null) throw new Error(\"Invalid electric current.\");\n    return result;\n  }\n\n  static isValid(input: string | null | undefined): boolean {\n    return ElectricCurrent.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?: ElectricCurrentFormatOptions,\n  ): string | null {\n    const parsed = ElectricCurrent.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 ElectricCurrent.fallback(input, options);\n  }\n\n  /** The value in amperes, or `null` when the input is invalid. */\n  static normalize(\n    input: string | null | undefined,\n    options?: ElectricCurrentFormatOptions,\n  ): string | null {\n    const parsed = ElectricCurrent.tryParse(input);\n    if (parsed !== null) return parsed.toNormalizedString();\n    return ElectricCurrent.fallback(input, options);\n  }\n\n  static isNormalized(input: string | null | undefined): boolean {\n    return input != null && ElectricCurrent.normalize(input) === input;\n  }\n\n  static findCandidatesInText(text: string): readonly TextCandidate<ElectricCurrent>[] {\n    if (!text) return [];\n\n    const out: TextCandidate<ElectricCurrent>[] = [];\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 = ElectricCurrent.tryParse(match[0]);\n      if (value === null) continue;\n      out.push(\n        new TextCandidate<ElectricCurrent>({\n          startIndex: match.index,\n          length: match[0].length,\n          originalText: match[0],\n          typeName: \"ElectricCurrent\",\n          category: TextCandidateCategory.Measurement,\n          normalizedForm: value.toNormalizedString(),\n          formattedForm: value.toString(),\n          maskedForm: maskElectricCurrent(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?: ElectricCurrentFormatOptions,\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 electric current: ${value}`);\n    return parsed;\n  }\n}\n\n/** Returns a masked electric current, e.g. `10 A` becomes `*** A`. */\nexport function maskElectricCurrent(value: ElectricCurrent): string {\n  return `*** ${value.originalUnit.symbol}`;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,181 @@
+import { Decimal } from "../internal/decimal.js";
+import { MeasurementUnit, MeasurementUnitIndex } from "../internal/measurement-unit.js";
+function factor(literal) {
+  const parsed = Decimal.parse(literal);
+  if (parsed === null) throw new Error(`Invalid conversion factor: ${literal}`);
+  return parsed;
+}
+class EnergyUnit extends MeasurementUnit {
+  static typeInfo = Object.freeze({
+    englishName: "Energy Unit",
+    localizedName: "Energienhet",
+    emoji: "\u26A1",
+    sources: Object.freeze([])
+  });
+  static Joule = new EnergyUnit({
+    symbol: "J",
+    englishName: "joule",
+    localizedName: "joule",
+    pluralEnglish: "joules",
+    pluralSwedish: "joule",
+    toBaseUnitFactor: factor("1")
+  });
+  static Kilojoule = new EnergyUnit({
+    symbol: "kJ",
+    englishName: "kilojoule",
+    localizedName: "kilojoule",
+    pluralEnglish: "kilojoules",
+    pluralSwedish: "kilojoule",
+    toBaseUnitFactor: factor("1000")
+  });
+  static Megajoule = new EnergyUnit({
+    symbol: "MJ",
+    englishName: "megajoule",
+    localizedName: "megajoule",
+    pluralEnglish: "megajoules",
+    pluralSwedish: "megajoule",
+    toBaseUnitFactor: factor("1000000")
+  });
+  static Gigajoule = new EnergyUnit({
+    symbol: "GJ",
+    englishName: "gigajoule",
+    localizedName: "gigajoule",
+    pluralEnglish: "gigajoules",
+    pluralSwedish: "gigajoule",
+    toBaseUnitFactor: factor("1000000000")
+  });
+  static Terajoule = new EnergyUnit({
+    symbol: "TJ",
+    englishName: "terajoule",
+    localizedName: "terajoule",
+    pluralEnglish: "terajoules",
+    pluralSwedish: "terajoule",
+    toBaseUnitFactor: factor("1000000000000")
+  });
+  static WattHour = new EnergyUnit({
+    symbol: "Wh",
+    englishName: "watt-hour",
+    localizedName: "wattimme",
+    pluralEnglish: "watt-hours",
+    pluralSwedish: "wattimmar",
+    toBaseUnitFactor: factor("3600"),
+    aliases: ["watthour", "watthours", "watt hour", "watt hours"]
+  });
+  static KilowattHour = new EnergyUnit({
+    symbol: "kWh",
+    englishName: "kilowatt-hour",
+    localizedName: "kilowattimme",
+    pluralEnglish: "kilowatt-hours",
+    pluralSwedish: "kilowattimmar",
+    toBaseUnitFactor: factor("3600000"),
+    aliases: ["kilowatthour", "kilowatthours", "kilowatt hour", "kilowatt hours"]
+  });
+  static MegawattHour = new EnergyUnit({
+    symbol: "MWh",
+    englishName: "megawatt-hour",
+    localizedName: "megawattimme",
+    pluralEnglish: "megawatt-hours",
+    pluralSwedish: "megawattimmar",
+    toBaseUnitFactor: factor("3600000000"),
+    aliases: ["megawatthour", "megawatthours", "megawatt hour", "megawatt hours"]
+  });
+  static GigawattHour = new EnergyUnit({
+    symbol: "GWh",
+    englishName: "gigawatt-hour",
+    localizedName: "gigawattimme",
+    pluralEnglish: "gigawatt-hours",
+    pluralSwedish: "gigawattimmar",
+    toBaseUnitFactor: factor("3600000000000"),
+    aliases: ["gigawatthour", "gigawatthours", "gigawatt hour", "gigawatt hours"]
+  });
+  static TerawattHour = new EnergyUnit({
+    symbol: "TWh",
+    englishName: "terawatt-hour",
+    localizedName: "terawattimme",
+    pluralEnglish: "terawatt-hours",
+    pluralSwedish: "terawattimmar",
+    toBaseUnitFactor: factor("3600000000000000"),
+    aliases: ["terawatthour", "terawatthours", "terawatt hour", "terawatt hours"]
+  });
+  static Calorie = new EnergyUnit({
+    symbol: "cal",
+    englishName: "calorie",
+    localizedName: "kalori",
+    pluralEnglish: "calories",
+    pluralSwedish: "kalorier",
+    toBaseUnitFactor: factor("4.184"),
+    aliases: ["calorie", "calories"]
+  });
+  static Kilocalorie = new EnergyUnit({
+    symbol: "kcal",
+    englishName: "kilocalorie",
+    localizedName: "kilokalori",
+    pluralEnglish: "kilocalories",
+    pluralSwedish: "kilokalorier",
+    toBaseUnitFactor: factor("4184"),
+    aliases: ["kilocalorie", "kilocalories"]
+  });
+  static Btu = new EnergyUnit({
+    symbol: "BTU",
+    englishName: "British thermal unit",
+    localizedName: "BTU",
+    pluralEnglish: "British thermal units",
+    pluralSwedish: "BTU",
+    toBaseUnitFactor: factor("1055.05585262"),
+    aliases: ["btu", "Btu"]
+  });
+  /** @internal Shared lookup and natural-scale walk. */
+  static index = new MeasurementUnitIndex(
+    [
+      EnergyUnit.Joule,
+      EnergyUnit.Kilojoule,
+      EnergyUnit.Megajoule,
+      EnergyUnit.Gigajoule,
+      EnergyUnit.Terajoule,
+      EnergyUnit.WattHour,
+      EnergyUnit.KilowattHour,
+      EnergyUnit.MegawattHour,
+      EnergyUnit.GigawattHour,
+      EnergyUnit.TerawattHour,
+      EnergyUnit.Calorie,
+      EnergyUnit.Kilocalorie,
+      EnergyUnit.Btu
+    ],
+    EnergyUnit.Joule,
+    [
+      EnergyUnit.WattHour,
+      EnergyUnit.KilowattHour,
+      EnergyUnit.MegawattHour,
+      EnergyUnit.GigawattHour,
+      EnergyUnit.TerawattHour
+    ]
+  );
+  static get all() {
+    return EnergyUnit.index.all;
+  }
+  /** The base unit: J. */
+  static get baseUnit() {
+    return EnergyUnit.index.baseUnit;
+  }
+  /** Units ordered small to large, used to auto-scale display. */
+  static get naturalScale() {
+    return EnergyUnit.index.naturalScale;
+  }
+  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */
+  static tryParse(input) {
+    return EnergyUnit.index.tryParse(input);
+  }
+  static parse(input) {
+    const result = EnergyUnit.tryParse(input);
+    if (result === null) throw new Error("Unknown energy unit.");
+    return result;
+  }
+  /** Returns the most human-readable unit for a value in J. */
+  static getNatural(baseValue) {
+    return EnergyUnit.index.getNatural(baseValue);
+  }
+}
+export {
+  EnergyUnit
+};
+//# sourceMappingURL=energy-unit.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/energy-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 energy 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 EnergyUnit extends MeasurementUnit {\n  declare private readonly __energyUnitBrand: void;\n\n  static readonly typeInfo: PrimitiveTypeInfo = Object.freeze({\n    englishName: \"Energy Unit\",\n    localizedName: \"Energienhet\",\n    emoji: \"\u26A1\",\n    sources: Object.freeze([]),\n  });\n\n  static readonly Joule = new EnergyUnit({\n    symbol: \"J\",\n    englishName: \"joule\",\n    localizedName: \"joule\",\n    pluralEnglish: \"joules\",\n    pluralSwedish: \"joule\",\n    toBaseUnitFactor: factor(\"1\"),\n  });\n\n  static readonly Kilojoule = new EnergyUnit({\n    symbol: \"kJ\",\n    englishName: \"kilojoule\",\n    localizedName: \"kilojoule\",\n    pluralEnglish: \"kilojoules\",\n    pluralSwedish: \"kilojoule\",\n    toBaseUnitFactor: factor(\"1000\"),\n  });\n\n  static readonly Megajoule = new EnergyUnit({\n    symbol: \"MJ\",\n    englishName: \"megajoule\",\n    localizedName: \"megajoule\",\n    pluralEnglish: \"megajoules\",\n    pluralSwedish: \"megajoule\",\n    toBaseUnitFactor: factor(\"1000000\"),\n  });\n\n  static readonly Gigajoule = new EnergyUnit({\n    symbol: \"GJ\",\n    englishName: \"gigajoule\",\n    localizedName: \"gigajoule\",\n    pluralEnglish: \"gigajoules\",\n    pluralSwedish: \"gigajoule\",\n    toBaseUnitFactor: factor(\"1000000000\"),\n  });\n\n  static readonly Terajoule = new EnergyUnit({\n    symbol: \"TJ\",\n    englishName: \"terajoule\",\n    localizedName: \"terajoule\",\n    pluralEnglish: \"terajoules\",\n    pluralSwedish: \"terajoule\",\n    toBaseUnitFactor: factor(\"1000000000000\"),\n  });\n\n  static readonly WattHour = new EnergyUnit({\n    symbol: \"Wh\",\n    englishName: \"watt-hour\",\n    localizedName: \"wattimme\",\n    pluralEnglish: \"watt-hours\",\n    pluralSwedish: \"wattimmar\",\n    toBaseUnitFactor: factor(\"3600\"),\n    aliases: [\"watthour\", \"watthours\", \"watt hour\", \"watt hours\"],\n  });\n\n  static readonly KilowattHour = new EnergyUnit({\n    symbol: \"kWh\",\n    englishName: \"kilowatt-hour\",\n    localizedName: \"kilowattimme\",\n    pluralEnglish: \"kilowatt-hours\",\n    pluralSwedish: \"kilowattimmar\",\n    toBaseUnitFactor: factor(\"3600000\"),\n    aliases: [\"kilowatthour\", \"kilowatthours\", \"kilowatt hour\", \"kilowatt hours\"],\n  });\n\n  static readonly MegawattHour = new EnergyUnit({\n    symbol: \"MWh\",\n    englishName: \"megawatt-hour\",\n    localizedName: \"megawattimme\",\n    pluralEnglish: \"megawatt-hours\",\n    pluralSwedish: \"megawattimmar\",\n    toBaseUnitFactor: factor(\"3600000000\"),\n    aliases: [\"megawatthour\", \"megawatthours\", \"megawatt hour\", \"megawatt hours\"],\n  });\n\n  static readonly GigawattHour = new EnergyUnit({\n    symbol: \"GWh\",\n    englishName: \"gigawatt-hour\",\n    localizedName: \"gigawattimme\",\n    pluralEnglish: \"gigawatt-hours\",\n    pluralSwedish: \"gigawattimmar\",\n    toBaseUnitFactor: factor(\"3600000000000\"),\n    aliases: [\"gigawatthour\", \"gigawatthours\", \"gigawatt hour\", \"gigawatt hours\"],\n  });\n\n  static readonly TerawattHour = new EnergyUnit({\n    symbol: \"TWh\",\n    englishName: \"terawatt-hour\",\n    localizedName: \"terawattimme\",\n    pluralEnglish: \"terawatt-hours\",\n    pluralSwedish: \"terawattimmar\",\n    toBaseUnitFactor: factor(\"3600000000000000\"),\n    aliases: [\"terawatthour\", \"terawatthours\", \"terawatt hour\", \"terawatt hours\"],\n  });\n\n  static readonly Calorie = new EnergyUnit({\n    symbol: \"cal\",\n    englishName: \"calorie\",\n    localizedName: \"kalori\",\n    pluralEnglish: \"calories\",\n    pluralSwedish: \"kalorier\",\n    toBaseUnitFactor: factor(\"4.184\"),\n    aliases: [\"calorie\", \"calories\"],\n  });\n\n  static readonly Kilocalorie = new EnergyUnit({\n    symbol: \"kcal\",\n    englishName: \"kilocalorie\",\n    localizedName: \"kilokalori\",\n    pluralEnglish: \"kilocalories\",\n    pluralSwedish: \"kilokalorier\",\n    toBaseUnitFactor: factor(\"4184\"),\n    aliases: [\"kilocalorie\", \"kilocalories\"],\n  });\n\n  static readonly Btu = new EnergyUnit({\n    symbol: \"BTU\",\n    englishName: \"British thermal unit\",\n    localizedName: \"BTU\",\n    pluralEnglish: \"British thermal units\",\n    pluralSwedish: \"BTU\",\n    toBaseUnitFactor: factor(\"1055.05585262\"),\n    aliases: [\"btu\", \"Btu\"],\n  });\n\n  /** @internal Shared lookup and natural-scale walk. */\n  static readonly index: MeasurementUnitIndex<EnergyUnit> = new MeasurementUnitIndex<EnergyUnit>(\n    [\n      EnergyUnit.Joule,\n      EnergyUnit.Kilojoule,\n      EnergyUnit.Megajoule,\n      EnergyUnit.Gigajoule,\n      EnergyUnit.Terajoule,\n      EnergyUnit.WattHour,\n      EnergyUnit.KilowattHour,\n      EnergyUnit.MegawattHour,\n      EnergyUnit.GigawattHour,\n      EnergyUnit.TerawattHour,\n      EnergyUnit.Calorie,\n      EnergyUnit.Kilocalorie,\n      EnergyUnit.Btu,\n    ],\n    EnergyUnit.Joule,\n    [\n      EnergyUnit.WattHour,\n      EnergyUnit.KilowattHour,\n      EnergyUnit.MegawattHour,\n      EnergyUnit.GigawattHour,\n      EnergyUnit.TerawattHour,\n    ],\n  );\n\n  static get all(): readonly EnergyUnit[] {\n    return EnergyUnit.index.all;\n  }\n\n  /** The base unit: J. */\n  static get baseUnit(): EnergyUnit {\n    return EnergyUnit.index.baseUnit;\n  }\n\n  /** Units ordered small to large, used to auto-scale display. */\n  static get naturalScale(): readonly EnergyUnit[] {\n    return EnergyUnit.index.naturalScale;\n  }\n\n  /** Resolves a unit from a symbol, name, plural or alias, case-insensitively. */\n  static tryParse(input: string | null | undefined): EnergyUnit | null {\n    return EnergyUnit.index.tryParse(input);\n  }\n\n  static parse(input: string): EnergyUnit {\n    const result = EnergyUnit.tryParse(input);\n    if (result === null) throw new Error(\"Unknown energy unit.\");\n    return result;\n  }\n\n  /** Returns the most human-readable unit for a value in J. */\n  static getNatural(baseValue: Decimal): EnergyUnit {\n    return EnergyUnit.index.getNatural(baseValue);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}