@itwin/core-quantity 5.10.0-dev.1 → 5.10.0-dev.4

package/lib/esm/ParserSpec.js.map

@@ -1 +1 @@
-{"version":3,"file":"ParserSpec.js","sourceRoot":"","sources":["../../src/ParserSpec.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Quantity\r\n */\r\n\r\nimport { Format } from \"./Formatter/Format\";\r\nimport { FormatType } from \"./Formatter/FormatEnums\";\r\nimport { AlternateUnitLabelsProvider, UnitConversionProps, UnitConversionSpec, UnitProps, UnitsProvider } from \"./Interfaces\";\r\nimport { Parser, QuantityParseResult } from \"./Parser\";\r\n\r\n/** A ParserSpec holds information needed to parse a string into a quantity synchronously.\r\n * @beta\r\n */\r\nexport class ParserSpec {\r\n  private _outUnit: UnitProps;\r\n  private _conversions: UnitConversionSpec[] = [];  // max four entries\r\n  private _format: Format;\r\n  protected _azimuthBaseConversion?: UnitConversionProps; // converts azimuth base unit to persistence unit\r\n  protected _revolutionConversion?: UnitConversionProps; // converts revolution unit to persistence unit\r\n\r\n  /** Constructor\r\n   *  @param outUnit     The name of a format specification.\r\n   *  @param format   Defines the output format for the quantity value.\r\n   *  @param conversions An array of conversion factors necessary to convert from an input unit to the units specified in the format..\r\n   */\r\n  constructor(outUnit: UnitProps, format: Format, conversions: UnitConversionSpec[]) {\r\n    this._outUnit = outUnit;\r\n    this._format = format;\r\n    this._conversions = conversions;\r\n  }\r\n\r\n  /** Returns an array of UnitConversionSpecs for each unit label that may be used in the input string. */\r\n  public get unitConversions(): UnitConversionSpec[] { return this._conversions; }\r\n  public get format(): Format { return this._format; }\r\n  public get outUnit(): UnitProps { return this._outUnit; }\r\n  public get azimuthBaseConversion(): UnitConversionProps | undefined { return this._azimuthBaseConversion; }\r\n  public get revolutionConversion(): UnitConversionProps | undefined { return this._revolutionConversion; }\r\n\r\n  /** Build conversion specs for ratio format with 2 composite units (numerator/denominator). */\r\n  private static async getRatioUnitConversions(units: ReadonlyArray<[UnitProps, string | undefined]>, unitsProvider: UnitsProvider, outUnit: UnitProps, altUnitLabelsProvider?: AlternateUnitLabelsProvider): Promise<UnitConversionSpec[]> {\r\n    const conversions: UnitConversionSpec[] = [];\r\n\r\n    const [numeratorUnit, numeratorLabel] = units[0];\r\n    const [denominatorUnit, denominatorLabel] = units[1];\r\n\r\n    // Compute ratio scale: how many numerator units per denominator unit (e.g., IN:FT = 12)\r\n    const denominatorToNumerator = await unitsProvider.getConversion(denominatorUnit, numeratorUnit);\r\n    const displayRatioScale = denominatorToNumerator.factor;\r\n\r\n    // Avoid double-scaling: if persistence unit already encodes the display ratio, use factor 1.\r\n    // Check by name heuristic (e.g., IN_PER_FT with ratioUnits [IN, FT] → no scaling needed)\r\n    const persistenceName = outUnit.name.toUpperCase();\r\n    const numName = numeratorUnit.name.toUpperCase().split(\".\").pop() ?? \"\";\r\n    const denName = denominatorUnit.name.toUpperCase().split(\".\").pop() ?? \"\";\r\n    // Split by word boundaries (underscores, dots) and check for exact token matches\r\n    const persistenceTokens = persistenceName.split(/[._]/);\r\n    const isPersistenceMatchingRatio = persistenceTokens.includes(numName) && persistenceTokens.includes(denName);\r\n    const ratioScaleFactor = isPersistenceMatchingRatio ? 1.0 : displayRatioScale;\r\n\r\n    // First conversion spec: effective ratio unit conversion\r\n    const ratioConversionSpec: UnitConversionSpec = {\r\n      name: `${numeratorUnit.name}_per_${denominatorUnit.name}`,\r\n      label: \"\",\r\n      system: numeratorUnit.system,\r\n      conversion: { factor: ratioScaleFactor, offset: 0.0 },\r\n    };\r\n    conversions.push(ratioConversionSpec);\r\n\r\n    // Numerator unit for label lookup\r\n    const numeratorSpec: UnitConversionSpec = {\r\n      name: numeratorUnit.name,\r\n      label: numeratorLabel?.length ? numeratorLabel : numeratorUnit.label,\r\n      system: numeratorUnit.system,\r\n      conversion: { factor: 1.0, offset: 0.0 },\r\n      parseLabels: altUnitLabelsProvider?.getAlternateUnitLabels(numeratorUnit),\r\n    };\r\n    conversions.push(numeratorSpec);\r\n\r\n    // Denominator unit for label lookup\r\n    const denominatorSpec: UnitConversionSpec = {\r\n      name: denominatorUnit.name,\r\n      label: denominatorLabel?.length ? denominatorLabel : denominatorUnit.label,\r\n      system: denominatorUnit.system,\r\n      conversion: { factor: 1.0, offset: 0.0 },\r\n      parseLabels: altUnitLabelsProvider?.getAlternateUnitLabels(denominatorUnit),\r\n    };\r\n    conversions.push(denominatorSpec);\r\n\r\n    return conversions;\r\n  }\r\n\r\n  /** Static async method to create a ParserSpec given the format and unit of the quantity that will be passed to the Parser. The input unit will\r\n   * be used to generate conversion information for each unit specified in the Format. This method is async due to the fact that the units provider must make\r\n   * async calls to lookup unit definitions.\r\n   *  @param format     The format specification.\r\n   *  @param unitsProvider The units provider is used to look up unit definitions and provide conversion information for converting between units.\r\n   *  @param outUnit The unit a value will be formatted to. This unit is often referred to as persistence unit.\r\n   */\r\n  public static async create(format: Format, unitsProvider: UnitsProvider, outUnit: UnitProps, altUnitLabelsProvider?: AlternateUnitLabelsProvider): Promise<ParserSpec> {\r\n    let conversions: UnitConversionSpec[];\r\n\r\n    // For ratio formats with 2 composite units, use private helper method\r\n    if (format.type === FormatType.Ratio && format.units && format.units.length === 2) {\r\n      conversions = await ParserSpec.getRatioUnitConversions(format.units, unitsProvider, outUnit, altUnitLabelsProvider);\r\n    } else {\r\n      conversions = await Parser.createUnitConversionSpecsForUnit(unitsProvider, outUnit, altUnitLabelsProvider);\r\n    }\r\n\r\n    const spec = new ParserSpec(outUnit, format, conversions);\r\n    if (format.azimuthBaseUnit !== undefined) {\r\n      if (outUnit !== undefined) {\r\n        spec._azimuthBaseConversion = await unitsProvider.getConversion(format.azimuthBaseUnit, outUnit);\r\n      } else {\r\n        spec._azimuthBaseConversion = { factor: 1.0, offset: 0.0 };\r\n      }\r\n    }\r\n    if (format.revolutionUnit !== undefined) {\r\n      if (outUnit !== undefined) {\r\n        spec._revolutionConversion = await unitsProvider.getConversion(format.revolutionUnit, outUnit);\r\n      } else {\r\n        spec._revolutionConversion = { factor: 1.0, offset: 0.0 };\r\n      }\r\n    }\r\n    return spec;\r\n  }\r\n\r\n  /** Do the parsing. Done this way to allow Custom Parser Specs to parse custom formatted strings into their quantities. */\r\n  public parseToQuantityValue(inString: string): QuantityParseResult {\r\n    return Parser.parseQuantityString(inString, this);\r\n  }\r\n}\r\n\r\n"]}
+{"version":3,"file":"ParserSpec.js","sourceRoot":"","sources":["../../src/ParserSpec.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { Logger } from \"@itwin/core-bentley\";\nimport { Format } from \"./Formatter/Format\";\nimport { FormatType } from \"./Formatter/FormatEnums\";\nimport { AlternateUnitLabelsProvider, UnitConversionProps, UnitConversionSpec, UnitProps, UnitsProvider } from \"./Interfaces\";\nimport { Parser, QuantityParseResult } from \"./Parser\";\nimport { QuantityLoggerCategory } from \"./QuantityLoggerCategory\";\n\n/** A ParserSpec holds information needed to parse a string into a quantity synchronously.\n * @beta\n */\nexport class ParserSpec {\n  private _outUnit: UnitProps;\n  private _conversions: UnitConversionSpec[] = [];  // max four entries\n  private _format: Format;\n  protected _azimuthBaseConversion?: UnitConversionProps; // converts azimuth base unit to persistence unit\n  protected _revolutionConversion?: UnitConversionProps; // converts revolution unit to persistence unit\n\n  /** Constructor\n   *  @param outUnit     The name of a format specification.\n   *  @param format   Defines the output format for the quantity value.\n   *  @param conversions An array of conversion factors necessary to convert from an input unit to the units specified in the format..\n   */\n  constructor(outUnit: UnitProps, format: Format, conversions: UnitConversionSpec[]) {\n    this._outUnit = outUnit;\n    this._format = format;\n    this._conversions = conversions;\n  }\n\n  /** Returns an array of UnitConversionSpecs for each unit label that may be used in the input string. */\n  public get unitConversions(): UnitConversionSpec[] { return this._conversions; }\n  public get format(): Format { return this._format; }\n  public get outUnit(): UnitProps { return this._outUnit; }\n  public get azimuthBaseConversion(): UnitConversionProps | undefined { return this._azimuthBaseConversion; }\n  public get revolutionConversion(): UnitConversionProps | undefined { return this._revolutionConversion; }\n\n  /** Build conversion specs for ratio format with 2 composite units (numerator/denominator). */\n  private static async getRatioUnitConversions(units: ReadonlyArray<[UnitProps, string | undefined]>, unitsProvider: UnitsProvider, outUnit: UnitProps, altUnitLabelsProvider?: AlternateUnitLabelsProvider): Promise<UnitConversionSpec[]> {\n    const conversions: UnitConversionSpec[] = [];\n\n    const [numeratorUnit, numeratorLabel] = units[0];\n    const [denominatorUnit, denominatorLabel] = units[1];\n\n    // Compute ratio scale: how many numerator units per denominator unit (e.g., IN:FT = 12)\n    const denominatorToNumerator = await unitsProvider.getConversion(denominatorUnit, numeratorUnit);\n    if (denominatorToNumerator.error) {\n      Logger.logWarning(QuantityLoggerCategory.Parsing, `Unit conversion from \"${denominatorUnit.name}\" to \"${numeratorUnit.name}\" could not be resolved.`);\n    }\n    const displayRatioScale = denominatorToNumerator.factor;\n\n    // Avoid double-scaling: if persistence unit already encodes the display ratio, use factor 1.\n    // Check by name heuristic (e.g., IN_PER_FT with ratioUnits [IN, FT] → no scaling needed)\n    const persistenceName = outUnit.name.toUpperCase();\n    const numName = numeratorUnit.name.toUpperCase().split(\".\").pop() ?? \"\";\n    const denName = denominatorUnit.name.toUpperCase().split(\".\").pop() ?? \"\";\n    // Split by word boundaries (underscores, dots) and check for exact token matches\n    const persistenceTokens = persistenceName.split(/[._]/);\n    const isPersistenceMatchingRatio = persistenceTokens.includes(numName) && persistenceTokens.includes(denName);\n    const ratioScaleFactor = isPersistenceMatchingRatio ? 1.0 : displayRatioScale;\n\n    // First conversion spec: effective ratio unit conversion\n    const ratioConversionSpec: UnitConversionSpec = {\n      name: `${numeratorUnit.name}_per_${denominatorUnit.name}`,\n      label: \"\",\n      system: numeratorUnit.system,\n      conversion: { factor: ratioScaleFactor, offset: 0.0 },\n    };\n    conversions.push(ratioConversionSpec);\n\n    // Numerator unit for label lookup\n    const numeratorSpec: UnitConversionSpec = {\n      name: numeratorUnit.name,\n      label: numeratorLabel?.length ? numeratorLabel : numeratorUnit.label,\n      system: numeratorUnit.system,\n      conversion: { factor: 1.0, offset: 0.0 },\n      parseLabels: altUnitLabelsProvider?.getAlternateUnitLabels(numeratorUnit),\n    };\n    conversions.push(numeratorSpec);\n\n    // Denominator unit for label lookup\n    const denominatorSpec: UnitConversionSpec = {\n      name: denominatorUnit.name,\n      label: denominatorLabel?.length ? denominatorLabel : denominatorUnit.label,\n      system: denominatorUnit.system,\n      conversion: { factor: 1.0, offset: 0.0 },\n      parseLabels: altUnitLabelsProvider?.getAlternateUnitLabels(denominatorUnit),\n    };\n    conversions.push(denominatorSpec);\n\n    return conversions;\n  }\n\n  /** Static async method to create a ParserSpec given the format and unit of the quantity that will be passed to the Parser. The input unit will\n   * be used to generate conversion information for each unit specified in the Format. This method is async due to the fact that the units provider must make\n   * async calls to lookup unit definitions.\n   *  @param format     The format specification.\n   *  @param unitsProvider The units provider is used to look up unit definitions and provide conversion information for converting between units.\n   *  @param outUnit The unit a value will be formatted to. This unit is often referred to as persistence unit.\n   */\n  public static async create(format: Format, unitsProvider: UnitsProvider, outUnit: UnitProps, altUnitLabelsProvider?: AlternateUnitLabelsProvider): Promise<ParserSpec> {\n    let conversions: UnitConversionSpec[];\n\n    // For ratio formats with 2 composite units, use private helper method\n    if (format.type === FormatType.Ratio && format.units && format.units.length === 2) {\n      conversions = await ParserSpec.getRatioUnitConversions(format.units, unitsProvider, outUnit, altUnitLabelsProvider);\n    } else {\n      conversions = await Parser.createUnitConversionSpecsForUnit(unitsProvider, outUnit, altUnitLabelsProvider);\n    }\n\n    const spec = new ParserSpec(outUnit, format, conversions);\n    if (format.azimuthBaseUnit !== undefined) {\n      if (outUnit !== undefined) {\n        const azimuthResult = await unitsProvider.getConversion(format.azimuthBaseUnit, outUnit);\n        if (azimuthResult.error) {\n          Logger.logWarning(QuantityLoggerCategory.Parsing, `Unit conversion from \"${format.azimuthBaseUnit.name}\" to \"${outUnit.name}\" could not be resolved.`);\n        }\n        spec._azimuthBaseConversion = azimuthResult;\n      } else {\n        spec._azimuthBaseConversion = { factor: 1.0, offset: 0.0 };\n      }\n    }\n    if (format.revolutionUnit !== undefined) {\n      if (outUnit !== undefined) {\n        const revolutionResult = await unitsProvider.getConversion(format.revolutionUnit, outUnit);\n        if (revolutionResult.error) {\n          Logger.logWarning(QuantityLoggerCategory.Parsing, `Unit conversion from \"${format.revolutionUnit.name}\" to \"${outUnit.name}\" could not be resolved.`);\n        }\n        spec._revolutionConversion = revolutionResult;\n      } else {\n        spec._revolutionConversion = { factor: 1.0, offset: 0.0 };\n      }\n    }\n    return spec;\n  }\n\n  /** Do the parsing. Done this way to allow Custom Parser Specs to parse custom formatted strings into their quantities. */\n  public parseToQuantityValue(inString: string): QuantityParseResult {\n    return Parser.parseQuantityString(inString, this);\n  }\n}\n\n"]}

package/lib/esm/Quantity.js.map

@@ -1 +1 @@
-{"version":3,"file":"Quantity.js","sourceRoot":"","sources":["../../src/Quantity.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Quantity\r\n */\r\n\r\nimport { QuantityError, QuantityStatus } from \"./Exception\";\r\nimport { QuantityProps, UnitConversionInvert, UnitConversionProps, UnitProps } from \"./Interfaces\";\r\n\r\n/**\r\n * Checks if two numbers are approximately equal within given relative tolerance.\r\n * @param a - The first number to compare.\r\n * @param b - The second number to compare.\r\n * @param tolerance - Tolerance, scales based on the input number values (multiplied by 1, abs(a) or abs(b), whichever is biggest).\r\n * @returns True if the numbers are approximately equal, false otherwise.\r\n * @internal\r\n */\r\nexport function almostEqual(a: number, b: number, tolerance: number = 2.2204460492503131e-16): boolean {\r\n  const absDiff = Math.abs(a - b);\r\n  const scaledTolerance = Math.max(1, Math.abs(a), Math.abs(b)) * tolerance;\r\n  return absDiff <= scaledTolerance;\r\n}\r\n\r\n/** The Quantity class is convenient container to specify both the magnitude and unit of a quantity. This class is commonly\r\n * returned as the result of parsing a string that represents a quantity.\r\n * @beta\r\n */\r\nexport class Quantity implements QuantityProps {\r\n  protected _magnitude: number = 0.0;\r\n  protected _unit: UnitProps;\r\n  protected _isValid: boolean = false;\r\n\r\n  public get unit(): UnitProps { return this._unit; }\r\n  public get magnitude(): number { return this._magnitude; }\r\n  public get isValid(): boolean { return this._isValid; }\r\n\r\n  /** Constructor. The Quantity will only be set as valid if a unit is specified.\r\n   *  @param unit     Defines the quantity's unit.\r\n   *  @param magnitude   Defines the magnitude of the quantity.\r\n   */\r\n  public constructor(unit?: UnitProps, magnitude?: number) {\r\n    if (undefined !== unit) {\r\n      this._unit = unit;\r\n      this._isValid = true;\r\n    } else {\r\n      this._unit = { name: \"unknown\", label: \"unknown\", phenomenon: \"unknown\", isValid: false, system: \"unknown\" };\r\n    }\r\n\r\n    if (undefined !== magnitude)\r\n      this._magnitude = magnitude;\r\n  }\r\n\r\n  /** Convert a Quantity to the specified unit given the UnitConversion.\r\n   *  @param toUnit   The new unit for the quantity.\r\n   *  @param conversion  Defines the information needed to convert the Quantity's magnitude from the current unit to another unit. This conversion info is usually\r\n   *                     returned from the UnitsProvider.\r\n   */\r\n  public convertTo(toUnit: UnitProps, conversion: UnitConversionProps): Quantity {\r\n    const newMagnitude = applyConversion(this.magnitude, conversion);\r\n    return new Quantity(toUnit, newMagnitude);\r\n  }\r\n}\r\n\r\nfunction invert(input: number): number {\r\n  if (almostZero(input)) // mimic the behavior of native here. We don't want to invert those very small values\r\n    throw new QuantityError(QuantityStatus.InvertingZero, \"Cannot invert zero value\");\r\n  return 1 / input;\r\n}\r\n\r\n/** Determines if a value is almost zero. (less than 1e-16)\r\n * @param value - The value to be checked.\r\n * @returns `true` if the value is almost zero, `false` otherwise.\r\n * @internal\r\n */\r\nexport function almostZero(value: number): boolean {\r\n  return almostEqual(value, 0.0);\r\n}\r\n\r\n/**\r\n * Applies a unit conversion to a given value.\r\n * @param value - The value to be converted.\r\n * @param props - The unit conversion properties.\r\n * @returns The converted value.\r\n * @internal\r\n */\r\nexport function applyConversion(value: number, props: UnitConversionProps): number {\r\n  let convertedValue = value;\r\n\r\n  // Apply pre-conversion inversion if specified\r\n  if (props.inversion === UnitConversionInvert.InvertPreConversion) {\r\n    convertedValue = invert(convertedValue);\r\n  }\r\n\r\n  // Apply the conversion factor and offset\r\n  convertedValue = (convertedValue * props.factor) + props.offset;\r\n\r\n  // Apply post-conversion inversion if specified\r\n  if (props.inversion === UnitConversionInvert.InvertPostConversion) {\r\n    convertedValue = invert(convertedValue);\r\n  }\r\n\r\n  return convertedValue;\r\n}\r\n"]}
+{"version":3,"file":"Quantity.js","sourceRoot":"","sources":["../../src/Quantity.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { QuantityError, QuantityStatus } from \"./Exception\";\nimport { QuantityProps, UnitConversionInvert, UnitConversionProps, UnitProps } from \"./Interfaces\";\n\n/**\n * Checks if two numbers are approximately equal within given relative tolerance.\n * @param a - The first number to compare.\n * @param b - The second number to compare.\n * @param tolerance - Tolerance, scales based on the input number values (multiplied by 1, abs(a) or abs(b), whichever is biggest).\n * @returns True if the numbers are approximately equal, false otherwise.\n * @internal\n */\nexport function almostEqual(a: number, b: number, tolerance: number = 2.2204460492503131e-16): boolean {\n  const absDiff = Math.abs(a - b);\n  const scaledTolerance = Math.max(1, Math.abs(a), Math.abs(b)) * tolerance;\n  return absDiff <= scaledTolerance;\n}\n\n/** The Quantity class is convenient container to specify both the magnitude and unit of a quantity. This class is commonly\n * returned as the result of parsing a string that represents a quantity.\n * @beta\n */\nexport class Quantity implements QuantityProps {\n  protected _magnitude: number = 0.0;\n  protected _unit: UnitProps;\n  protected _isValid: boolean = false;\n\n  public get unit(): UnitProps { return this._unit; }\n  public get magnitude(): number { return this._magnitude; }\n  public get isValid(): boolean { return this._isValid; }\n\n  /** Constructor. The Quantity will only be set as valid if a unit is specified.\n   *  @param unit     Defines the quantity's unit.\n   *  @param magnitude   Defines the magnitude of the quantity.\n   */\n  public constructor(unit?: UnitProps, magnitude?: number) {\n    if (undefined !== unit) {\n      this._unit = unit;\n      this._isValid = true;\n    } else {\n      this._unit = { name: \"unknown\", label: \"unknown\", phenomenon: \"unknown\", isValid: false, system: \"unknown\" };\n    }\n\n    if (undefined !== magnitude)\n      this._magnitude = magnitude;\n  }\n\n  /** Convert a Quantity to the specified unit given the UnitConversion.\n   *  @param toUnit   The new unit for the quantity.\n   *  @param conversion  Defines the information needed to convert the Quantity's magnitude from the current unit to another unit. This conversion info is usually\n   *                     returned from the UnitsProvider.\n   */\n  public convertTo(toUnit: UnitProps, conversion: UnitConversionProps): Quantity {\n    const newMagnitude = applyConversion(this.magnitude, conversion);\n    return new Quantity(toUnit, newMagnitude);\n  }\n}\n\nfunction invert(input: number): number {\n  if (almostZero(input)) // mimic the behavior of native here. We don't want to invert those very small values\n    throw new QuantityError(QuantityStatus.InvertingZero, \"Cannot invert zero value\");\n  return 1 / input;\n}\n\n/** Determines if a value is almost zero. (less than 1e-16)\n * @param value - The value to be checked.\n * @returns `true` if the value is almost zero, `false` otherwise.\n * @internal\n */\nexport function almostZero(value: number): boolean {\n  return almostEqual(value, 0.0);\n}\n\n/**\n * Applies a unit conversion to a given value.\n * @param value - The value to be converted.\n * @param props - The unit conversion properties.\n * @returns The converted value.\n * @internal\n */\nexport function applyConversion(value: number, props: UnitConversionProps): number {\n  let convertedValue = value;\n\n  // Apply pre-conversion inversion if specified\n  if (props.inversion === UnitConversionInvert.InvertPreConversion) {\n    convertedValue = invert(convertedValue);\n  }\n\n  // Apply the conversion factor and offset\n  convertedValue = (convertedValue * props.factor) + props.offset;\n\n  // Apply post-conversion inversion if specified\n  if (props.inversion === UnitConversionInvert.InvertPostConversion) {\n    convertedValue = invert(convertedValue);\n  }\n\n  return convertedValue;\n}\n"]}

package/lib/esm/QuantityLoggerCategory.d.ts

@@ -9,6 +9,8 @@ export declare enum QuantityLoggerCategory {
     /** The root category for the core-quantity package. */
     Package = "core-quantity",
     /** Logger category for quantity formatting operations. */
-    Formatting = "core-quantity.Formatting"
+    Formatting = "core-quantity.Formatting",
+    /** Logger category for quantity parsing operations. */
+    Parsing = "core-quantity.Parsing"
 }
 //# sourceMappingURL=QuantityLoggerCategory.d.ts.map

package/lib/esm/QuantityLoggerCategory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QuantityLoggerCategory.d.ts","sourceRoot":"","sources":["../../src/QuantityLoggerCategory.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;GAGG;AACH,oBAAY,sBAAsB;IAChC,uDAAuD;IACvD,OAAO,kBAAkB;IACzB,0DAA0D;IAC1D,UAAU,6BAA6B;CACxC"}
+{"version":3,"file":"QuantityLoggerCategory.d.ts","sourceRoot":"","sources":["../../src/QuantityLoggerCategory.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;GAGG;AACH,oBAAY,sBAAsB;IAChC,uDAAuD;IACvD,OAAO,kBAAkB;IACzB,0DAA0D;IAC1D,UAAU,6BAA6B;IACvC,uDAAuD;IACvD,OAAO,0BAA0B;CAClC"}

package/lib/esm/QuantityLoggerCategory.js

@@ -15,5 +15,7 @@ export var QuantityLoggerCategory;
     QuantityLoggerCategory["Package"] = "core-quantity";
     /** Logger category for quantity formatting operations. */
     QuantityLoggerCategory["Formatting"] = "core-quantity.Formatting";
+    /** Logger category for quantity parsing operations. */
+    QuantityLoggerCategory["Parsing"] = "core-quantity.Parsing";
 })(QuantityLoggerCategory || (QuantityLoggerCategory = {}));
 //# sourceMappingURL=QuantityLoggerCategory.js.map

package/lib/esm/QuantityLoggerCategory.js.map

@@ -1 +1 @@
-{"version":3,"file":"QuantityLoggerCategory.js","sourceRoot":"","sources":["../../src/QuantityLoggerCategory.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,uDAAuD;IACvD,mDAAyB,CAAA;IACzB,0DAA0D;IAC1D,iEAAuC,CAAA;AACzC,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Logging\r\n */\r\n\r\n/** Logger categories used by the `@itwin/core-quantity` package.\r\n * @see [Logger]($bentley)\r\n * @beta\r\n */\r\nexport enum QuantityLoggerCategory {\r\n  /** The root category for the core-quantity package. */\r\n  Package = \"core-quantity\",\r\n  /** Logger category for quantity formatting operations. */\r\n  Formatting = \"core-quantity.Formatting\",\r\n}\r\n"]}
+{"version":3,"file":"QuantityLoggerCategory.js","sourceRoot":"","sources":["../../src/QuantityLoggerCategory.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAChC,uDAAuD;IACvD,mDAAyB,CAAA;IACzB,0DAA0D;IAC1D,iEAAuC,CAAA;IACvC,uDAAuD;IACvD,2DAAiC,CAAA;AACnC,CAAC,EAPW,sBAAsB,KAAtB,sBAAsB,QAOjC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Logging\n */\n\n/** Logger categories used by the `@itwin/core-quantity` package.\n * @see [Logger]($bentley)\n * @beta\n */\nexport enum QuantityLoggerCategory {\n  /** The root category for the core-quantity package. */\n  Package = \"core-quantity\",\n  /** Logger category for quantity formatting operations. */\n  Formatting = \"core-quantity.Formatting\",\n  /** Logger category for quantity parsing operations. */\n  Parsing = \"core-quantity.Parsing\",\n}\n"]}

package/lib/esm/SerializedUnitSchema.d.ts

@@ -0,0 +1,98 @@
+/** Current version of the serialization format for `SerializedUnitSchema`.
+ *
+ * This value is written into `Units.json` as the `version` field and checked at
+ * parse time. Two version axes exist:
+ *
+ * - **Format version** (`SERIALIZED_UNIT_SCHEMA_VERSION` / `Units.json.version`): bump
+ *   the major version when the shape of the `SerializedUnitSchema` interfaces changes
+ *   incompatibly (e.g. renaming fields, removing required properties). Minor bumps for
+ *   backward-compatible additions.
+ *
+ * - **Source provenance** (`sourceEcSchemaVersion` inside `Units.json`): records which
+ *   version of the BIS Units EC schema the data was derived from (e.g. `"01.00.09"`).
+ *   This is a traceability marker, not a runtime contract.
+ *
+ * @internal
+ */
+export declare const SERIALIZED_UNIT_SCHEMA_VERSION = "01.00.00";
+/** A serialized constant definition (e.g. `PI`, `MILLI`).
+ * @internal
+ */
+export interface SerializedConstant {
+    readonly schemaItemType: "Constant";
+    readonly label?: string;
+    readonly description?: string;
+    /** The phenomenon this constant belongs to. */
+    readonly phenomenon: string;
+    /** The unit definition expression (e.g. `"M*M"`). */
+    readonly definition: string;
+    /** Numerator of the conversion factor to the SI base. */
+    readonly numerator?: number;
+    /** Denominator of the conversion factor to the SI base. */
+    readonly denominator?: number;
+}
+/** A serialized unit definition (e.g. `M`, `FT`, `CELSIUS`).
+ * @internal
+ */
+export interface SerializedUnit {
+    readonly schemaItemType: "Unit";
+    readonly label?: string;
+    readonly description?: string;
+    readonly phenomenon: string;
+    readonly unitSystem: string;
+    /** The unit definition expression (e.g. `"M*M"`). */
+    readonly definition: string;
+    /** Numerator of the conversion factor to the SI base. */
+    readonly numerator?: number;
+    /** Denominator of the conversion factor to the SI base. */
+    readonly denominator?: number;
+    /** Additive offset for the conversion (e.g. temperature scales). */
+    readonly offset?: number;
+}
+/** A serialized inverted unit definition (e.g. `HORIZONTAL_PER_VERTICAL`).
+ * @internal
+ */
+export interface SerializedInvertedUnit {
+    readonly schemaItemType: "InvertedUnit";
+    readonly label?: string;
+    readonly description?: string;
+    readonly invertsUnit: string;
+    readonly unitSystem: string;
+}
+/** A serialized unit system definition (e.g. `SI`, `METRIC`).
+ * @internal
+ */
+export interface SerializedUnitSystem {
+    readonly schemaItemType: "UnitSystem";
+    readonly label?: string;
+    readonly description?: string;
+}
+/** A serialized phenomenon definition (e.g. `LENGTH`, `TEMPERATURE`).
+ * @internal
+ */
+export interface SerializedPhenomenon {
+    readonly schemaItemType: "Phenomenon";
+    readonly label?: string;
+    readonly description?: string;
+    /** The phenomenon definition expression. */
+    readonly definition: string;
+}
+/** Discriminated union of all serialized schema item types.
+ * @internal
+ */
+export type SerializedUnitItem = SerializedConstant | SerializedUnit | SerializedInvertedUnit | SerializedUnitSystem | SerializedPhenomenon;
+/** Versioned container for a serialized BIS unit schema. The `items` map is keyed by schema-item name (unqualified).
+ * @internal
+ */
+export interface SerializedUnitSchema {
+    /** Serialization format version, matching `SERIALIZED_UNIT_SCHEMA_VERSION` (e.g. `"01.00.00"`). */
+    readonly version: string;
+    readonly name: string;
+    readonly alias: string;
+    /** EC schema version of the source BIS Units schema this data was derived from (e.g. `"01.00.09"`). */
+    readonly sourceEcSchemaVersion: string;
+    readonly items: {
+        readonly [name: string]: SerializedUnitItem;
+    };
+}
+//# sourceMappingURL=SerializedUnitSchema.d.ts.map

package/lib/esm/SerializedUnitSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializedUnitSchema.d.ts","sourceRoot":"","sources":["../../src/SerializedUnitSchema.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,cAAc,GAAG,sBAAsB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAE5I;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uGAAuG;IACvG,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAA;KAAE,CAAC;CACjE"}

package/lib/esm/SerializedUnitSchema.js

@@ -0,0 +1,22 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** Current version of the serialization format for `SerializedUnitSchema`.
+ *
+ * This value is written into `Units.json` as the `version` field and checked at
+ * parse time. Two version axes exist:
+ *
+ * - **Format version** (`SERIALIZED_UNIT_SCHEMA_VERSION` / `Units.json.version`): bump
+ *   the major version when the shape of the `SerializedUnitSchema` interfaces changes
+ *   incompatibly (e.g. renaming fields, removing required properties). Minor bumps for
+ *   backward-compatible additions.
+ *
+ * - **Source provenance** (`sourceEcSchemaVersion` inside `Units.json`): records which
+ *   version of the BIS Units EC schema the data was derived from (e.g. `"01.00.09"`).
+ *   This is a traceability marker, not a runtime contract.
+ *
+ * @internal
+ */
+export const SERIALIZED_UNIT_SCHEMA_VERSION = "01.00.00";
+//# sourceMappingURL=SerializedUnitSchema.js.map

package/lib/esm/SerializedUnitSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializedUnitSchema.js","sourceRoot":"","sources":["../../src/SerializedUnitSchema.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,UAAU,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** Current version of the serialization format for `SerializedUnitSchema`.\n *\n * This value is written into `Units.json` as the `version` field and checked at\n * parse time. Two version axes exist:\n *\n * - **Format version** (`SERIALIZED_UNIT_SCHEMA_VERSION` / `Units.json.version`): bump\n *   the major version when the shape of the `SerializedUnitSchema` interfaces changes\n *   incompatibly (e.g. renaming fields, removing required properties). Minor bumps for\n *   backward-compatible additions.\n *\n * - **Source provenance** (`sourceEcSchemaVersion` inside `Units.json`): records which\n *   version of the BIS Units EC schema the data was derived from (e.g. `\"01.00.09\"`).\n *   This is a traceability marker, not a runtime contract.\n *\n * @internal\n */\nexport const SERIALIZED_UNIT_SCHEMA_VERSION = \"01.00.00\";\n\n/** A serialized constant definition (e.g. `PI`, `MILLI`).\n * @internal\n */\nexport interface SerializedConstant {\n  readonly schemaItemType: \"Constant\";\n  readonly label?: string;\n  readonly description?: string;\n  /** The phenomenon this constant belongs to. */\n  readonly phenomenon: string;\n  /** The unit definition expression (e.g. `\"M*M\"`). */\n  readonly definition: string;\n  /** Numerator of the conversion factor to the SI base. */\n  readonly numerator?: number;\n  /** Denominator of the conversion factor to the SI base. */\n  readonly denominator?: number;\n}\n\n/** A serialized unit definition (e.g. `M`, `FT`, `CELSIUS`).\n * @internal\n */\nexport interface SerializedUnit {\n  readonly schemaItemType: \"Unit\";\n  readonly label?: string;\n  readonly description?: string;\n  readonly phenomenon: string;\n  readonly unitSystem: string;\n  /** The unit definition expression (e.g. `\"M*M\"`). */\n  readonly definition: string;\n  /** Numerator of the conversion factor to the SI base. */\n  readonly numerator?: number;\n  /** Denominator of the conversion factor to the SI base. */\n  readonly denominator?: number;\n  /** Additive offset for the conversion (e.g. temperature scales). */\n  readonly offset?: number;\n}\n\n/** A serialized inverted unit definition (e.g. `HORIZONTAL_PER_VERTICAL`).\n * @internal\n */\nexport interface SerializedInvertedUnit {\n  readonly schemaItemType: \"InvertedUnit\";\n  readonly label?: string;\n  readonly description?: string;\n  readonly invertsUnit: string;\n  readonly unitSystem: string;\n}\n\n/** A serialized unit system definition (e.g. `SI`, `METRIC`).\n * @internal\n */\nexport interface SerializedUnitSystem {\n  readonly schemaItemType: \"UnitSystem\";\n  readonly label?: string;\n  readonly description?: string;\n}\n\n/** A serialized phenomenon definition (e.g. `LENGTH`, `TEMPERATURE`).\n * @internal\n */\nexport interface SerializedPhenomenon {\n  readonly schemaItemType: \"Phenomenon\";\n  readonly label?: string;\n  readonly description?: string;\n  /** The phenomenon definition expression. */\n  readonly definition: string;\n}\n\n/** Discriminated union of all serialized schema item types.\n * @internal\n */\nexport type SerializedUnitItem = SerializedConstant | SerializedUnit | SerializedInvertedUnit | SerializedUnitSystem | SerializedPhenomenon;\n\n/** Versioned container for a serialized BIS unit schema. The `items` map is keyed by schema-item name (unqualified).\n * @internal\n */\nexport interface SerializedUnitSchema {\n  /** Serialization format version, matching `SERIALIZED_UNIT_SCHEMA_VERSION` (e.g. `\"01.00.00\"`). */\n  readonly version: string;\n  readonly name: string;\n  readonly alias: string;\n  /** EC schema version of the source BIS Units schema this data was derived from (e.g. `\"01.00.09\"`). */\n  readonly sourceEcSchemaVersion: string;\n  readonly items: { readonly [name: string]: SerializedUnitItem };\n}\n"]}

package/lib/esm/Unit.js.map

@@ -1 +1 @@
-{"version":3,"file":"Unit.js","sourceRoot":"","sources":["../../src/Unit.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,SAAS;IACb,IAAI,GAAG,EAAE,CAAC;IACV,KAAK,GAAG,EAAE,CAAC;IACX,UAAU,GAAG,EAAE,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAW,SAAS,CAAC;IAElC,YAAY,IAAY,EAAE,KAAa,EAAE,UAAkB,EAAE,MAAe;QAC1E,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,MAAM;gBACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,OAAO;IACX,IAAI,GAAG,EAAE,CAAC;IACV,KAAK,GAAG,EAAE,CAAC;IACX,UAAU,GAAG,EAAE,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,SAAS,CAAC;CAC3B","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Quantity\r\n */\r\n\r\nimport { UnitProps } from \"./Interfaces\";\r\n\r\n/** This class provides basic implementation of UnitProps interface.\r\n * @beta\r\n */\r\nexport class BasicUnit implements UnitProps {\r\n  public name = \"\";\r\n  public label = \"\";\r\n  public phenomenon = \"\";\r\n  public isValid = false;\r\n  public system: string = \"unknown\";\r\n\r\n  constructor(name: string, label: string, phenomenon: string, system?: string) {\r\n    if (name && name.length > 0 && label && label.length > 0 && phenomenon && phenomenon.length > 0) {\r\n      this.name = name;\r\n      this.label = label;\r\n      this.phenomenon = phenomenon;\r\n      this.isValid = true;\r\n      if (system)\r\n        this.system = system;\r\n    }\r\n  }\r\n}\r\n\r\n/** This class is a convenience class that can be returned when a valid Unit cannot be determined.\r\n * @beta\r\n */\r\nexport class BadUnit implements UnitProps {\r\n  public name = \"\";\r\n  public label = \"\";\r\n  public phenomenon = \"\";\r\n  public isValid = false;\r\n  public system = \"unknown\";\r\n}\r\n"]}
+{"version":3,"file":"Unit.js","sourceRoot":"","sources":["../../src/Unit.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH;;GAEG;AACH,MAAM,OAAO,SAAS;IACb,IAAI,GAAG,EAAE,CAAC;IACV,KAAK,GAAG,EAAE,CAAC;IACX,UAAU,GAAG,EAAE,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAW,SAAS,CAAC;IAElC,YAAY,IAAY,EAAE,KAAa,EAAE,UAAkB,EAAE,MAAe;QAC1E,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,MAAM;gBACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,OAAO;IACX,IAAI,GAAG,EAAE,CAAC;IACV,KAAK,GAAG,EAAE,CAAC;IACX,UAAU,GAAG,EAAE,CAAC;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,SAAS,CAAC;CAC3B","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { UnitProps } from \"./Interfaces\";\n\n/** This class provides basic implementation of UnitProps interface.\n * @beta\n */\nexport class BasicUnit implements UnitProps {\n  public name = \"\";\n  public label = \"\";\n  public phenomenon = \"\";\n  public isValid = false;\n  public system: string = \"unknown\";\n\n  constructor(name: string, label: string, phenomenon: string, system?: string) {\n    if (name && name.length > 0 && label && label.length > 0 && phenomenon && phenomenon.length > 0) {\n      this.name = name;\n      this.label = label;\n      this.phenomenon = phenomenon;\n      this.isValid = true;\n      if (system)\n        this.system = system;\n    }\n  }\n}\n\n/** This class is a convenience class that can be returned when a valid Unit cannot be determined.\n * @beta\n */\nexport class BadUnit implements UnitProps {\n  public name = \"\";\n  public label = \"\";\n  public phenomenon = \"\";\n  public isValid = false;\n  public system = \"unknown\";\n}\n"]}

package/lib/esm/UnitConversion/Graph.d.ts

@@ -0,0 +1,35 @@
+/** @internal */
+export declare class UnitConversionGraph<T> {
+    private _edgeKeyDelim;
+    private _label;
+    private _nodeCount;
+    private _edgeCount;
+    private _nodes;
+    private _edgeObjs;
+    private _edgeLabels;
+    private _outEdges;
+    constructor();
+    setGraph: (label: string) => UnitConversionGraph<T>;
+    graph: () => string;
+    nodeCount: () => number;
+    nodes: () => string[];
+    setNode: (nodeKey: string, nodeValue: T) => void;
+    node: (nodeKey: string) => T;
+    hasNode: (nodeKey: string) => boolean;
+    edgeCount: () => number;
+    edges: () => {
+        v: string;
+        w: string;
+    }[];
+    setEdge: (v: string, w: string, value: {
+        exponent: number;
+    }) => void;
+    edge: (v: string, w: string) => {
+        exponent: number;
+    };
+    outEdges: (v: string) => {
+        v: string;
+        w: string;
+    }[];
+}
+//# sourceMappingURL=Graph.d.ts.map

package/lib/esm/UnitConversion/Graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../../src/UnitConversion/Graph.ts"],"names":[],"mappings":"AA8CA,gBAAgB;AAChB,qBAAa,mBAAmB,CAAC,CAAC;IAChC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAc;;IASxB,QAAQ,UAAW,MAAM,KAAG,mBAAmB,CAAC,CAAC,CAAC,CAGvD;IAEK,KAAK,eAEV;IAEK,SAAS,eAEd;IAEK,KAAK,iBAEV;IAEK,OAAO,YAAa,MAAM,aAAa,CAAC,UAQ7C;IAEK,IAAI,YAAa,MAAM,OAE5B;IAEK,OAAO,YAAa,MAAM,aAE/B;IAEK,SAAS,eAEd;IAEK,KAAK;WAnFP,MAAM;WACN,MAAM;QAoFT;IAEK,OAAO,MAAO,MAAM,KAAK,MAAM,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,UAiBjE;IAEK,IAAI,MAAO,MAAM,KAAK,MAAM;kBAhGP,MAAM;MAmGhC;IAEK,QAAQ,MAAO,MAAM;WA3FrB,MAAM;WACN,MAAM;QA8FX;CACH"}

package/lib/esm/UnitConversion/Graph.js

@@ -0,0 +1,83 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+// Following https://github.com/dagrejs/graphlib/blob/master/lib/graph.js
+/** @internal */
+export class UnitConversionGraph {
+    _edgeKeyDelim = "\x01";
+    _label = "";
+    _nodeCount = 0;
+    _edgeCount = 0;
+    _nodes;
+    _edgeObjs;
+    _edgeLabels;
+    _outEdges;
+    constructor() {
+        this._nodes = {};
+        this._edgeObjs = {};
+        this._edgeLabels = {};
+        this._outEdges = {};
+    }
+    setGraph = (label) => {
+        this._label = label;
+        return this;
+    };
+    graph = () => {
+        return this._label;
+    };
+    nodeCount = () => {
+        return this._nodeCount;
+    };
+    nodes = () => {
+        return Object.keys(this._nodes);
+    };
+    setNode = (nodeKey, nodeValue) => {
+        if (nodeKey in this._nodes) {
+            this._nodes[nodeKey] = nodeValue;
+            return;
+        }
+        this._nodes[nodeKey] = nodeValue;
+        this._outEdges[nodeKey] = {};
+        ++this._nodeCount;
+    };
+    node = (nodeKey) => {
+        return this._nodes[nodeKey];
+    };
+    hasNode = (nodeKey) => {
+        return nodeKey in this._nodes;
+    };
+    edgeCount = () => {
+        return this._edgeCount;
+    };
+    edges = () => {
+        return Object.values(this._edgeObjs);
+    };
+    setEdge = (v, w, value) => {
+        const edgeId = v + this._edgeKeyDelim + w + this._edgeKeyDelim;
+        if (edgeId in this._edgeLabels) {
+            // Update exponent, specific to this graph's use case
+            this._edgeLabels[edgeId].exponent += value.exponent;
+            return;
+        }
+        this._edgeLabels[edgeId] = value;
+        const edgeObj = {
+            v,
+            w,
+        };
+        this._edgeObjs[edgeId] = edgeObj;
+        // setNode should have ran first, so this.outEdges[v] shouldn't be undefined
+        this._outEdges[v][edgeId] = edgeObj;
+        this._edgeCount++;
+    };
+    edge = (v, w) => {
+        const edgeId = v + this._edgeKeyDelim + w + this._edgeKeyDelim;
+        return this._edgeLabels[edgeId];
+    };
+    outEdges = (v) => {
+        const outV = this._outEdges[v];
+        const edges = Object.values(outV);
+        return edges;
+    };
+}
+//# sourceMappingURL=Graph.js.map

package/lib/esm/UnitConversion/Graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Graph.js","sourceRoot":"","sources":["../../../src/UnitConversion/Graph.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n// Following https://github.com/dagrejs/graphlib/blob/master/lib/graph.js\n\n/**\n * Using generics for nodes - T represents Unit | Constant in our use case\n * @internal\n */\ninterface NodesMap<T> {\n  [node: string]: T;\n}\n\n/**\n * Describe edges based on its node endpoints (v, w)\n * @internal\n */\ninterface EdgeObjsMap {\n  [edge: string]: {\n    v: string;\n    w: string;\n  };\n}\n\n/**\n * Describe edges based on the exponent they carry\n * @internal\n */\ninterface EdgeLabelsMap {\n  [edge: string]: { exponent: number };\n}\n\n/**\n * List each node with outgoing edges in outer map; describe each node's outgoing edges in inner map\n * @internal\n */\ninterface OutEdgesMap {\n  [node: string]: {\n    [edges: string]: {\n      v: string;\n      w: string;\n    };\n  };\n}\n\n/** @internal */\nexport class UnitConversionGraph<T> {\n  private _edgeKeyDelim = \"\\x01\";\n  private _label = \"\";\n  private _nodeCount = 0;\n  private _edgeCount = 0;\n  private _nodes: NodesMap<T>;\n  private _edgeObjs: EdgeObjsMap;\n  private _edgeLabels: EdgeLabelsMap;\n  private _outEdges: OutEdgesMap;\n\n  constructor() {\n    this._nodes = {};\n    this._edgeObjs = {};\n    this._edgeLabels = {};\n    this._outEdges = {};\n  }\n\n  public setGraph = (label: string): UnitConversionGraph<T> => {\n    this._label = label;\n    return this;\n  };\n\n  public graph = () => {\n    return this._label;\n  };\n\n  public nodeCount = () => {\n    return this._nodeCount;\n  };\n\n  public nodes = () => {\n    return Object.keys(this._nodes);\n  };\n\n  public setNode = (nodeKey: string, nodeValue: T) => {\n    if (nodeKey in this._nodes) {\n      this._nodes[nodeKey] = nodeValue;\n      return;\n    }\n    this._nodes[nodeKey] = nodeValue;\n    this._outEdges[nodeKey] = {};\n    ++this._nodeCount;\n  };\n\n  public node = (nodeKey: string) => {\n    return this._nodes[nodeKey];\n  };\n\n  public hasNode = (nodeKey: string) => {\n    return nodeKey in this._nodes;\n  };\n\n  public edgeCount = () => {\n    return this._edgeCount;\n  };\n\n  public edges = () => {\n    return Object.values(this._edgeObjs);\n  };\n\n  public setEdge = (v: string, w: string, value: { exponent: number }) => {\n    const edgeId = v + this._edgeKeyDelim + w + this._edgeKeyDelim;\n    if (edgeId in this._edgeLabels) {\n      // Update exponent, specific to this graph's use case\n      this._edgeLabels[edgeId].exponent += value.exponent;\n      return;\n    }\n\n    this._edgeLabels[edgeId] = value;\n    const edgeObj = {\n      v,\n      w,\n    };\n    this._edgeObjs[edgeId] = edgeObj;\n    // setNode should have ran first, so this.outEdges[v] shouldn't be undefined\n    this._outEdges[v][edgeId] = edgeObj;\n    this._edgeCount++;\n  };\n\n  public edge = (v: string, w: string) => {\n    const edgeId = v + this._edgeKeyDelim + w + this._edgeKeyDelim;\n    return this._edgeLabels[edgeId];\n  };\n\n  public outEdges = (v: string) => {\n    const outV = this._outEdges[v];\n    const edges = Object.values(outV);\n    return edges;\n  };\n}\n"]}

package/lib/esm/UnitConversion/Parser.d.ts

@@ -0,0 +1,9 @@
+/** @internal */
+export interface DefinitionFragment {
+    name: string;
+    exponent: number;
+    constant: boolean;
+}
+/** @internal */
+export declare function parseDefinition(definition: string): Map<string, DefinitionFragment>;
+//# sourceMappingURL=Parser.d.ts.map

package/lib/esm/UnitConversion/Parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Parser.d.ts","sourceRoot":"","sources":["../../../src/UnitConversion/Parser.ts"],"names":[],"mappings":"AAeA,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAsBnF"}

package/lib/esm/UnitConversion/Parser.js

@@ -0,0 +1,39 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const expressionRgx = /^(([A-Z]\w*:)?([A-Z]\w*|\[([A-Z]\w*:)?[A-Z]\w*\])(\(-?\d+\))?(\*(?!$)|$))+$/i;
+const tokenRgx = /(?:(\[)?((?:[A-Z]\w*:)?[A-Z]\w*)\]?)(?:\((-?\d+)\))?/i;
+const sp = "*";
+/** @internal */
+var Tokens;
+(function (Tokens) {
+    Tokens[Tokens["Bracket"] = 1] = "Bracket";
+    Tokens[Tokens["Word"] = 2] = "Word";
+    Tokens[Tokens["Exponent"] = 3] = "Exponent";
+})(Tokens || (Tokens = {}));
+/** @internal */
+export function parseDefinition(definition) {
+    const unitMap = new Map();
+    if (expressionRgx.test(definition)) {
+        for (const unit of definition.split(sp)) {
+            const tokens = unit.split(tokenRgx);
+            const name = tokens[Tokens.Word];
+            const exponent = tokens[Tokens.Exponent] ? Number(tokens[Tokens.Exponent]) : 1;
+            const constant = tokens[Tokens.Bracket] !== undefined;
+            if (unitMap.has(name)) {
+                const currentDefinition = unitMap.get(name);
+                if (currentDefinition)
+                    unitMap.set(name, { ...currentDefinition, exponent: currentDefinition.exponent + exponent });
+            }
+            else {
+                unitMap.set(name, { name, exponent, constant });
+            }
+        }
+        return unitMap;
+    }
+    else {
+        throw new Error("Invalid definition expression.");
+    }
+}
+//# sourceMappingURL=Parser.js.map

package/lib/esm/UnitConversion/Parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Parser.js","sourceRoot":"","sources":["../../../src/UnitConversion/Parser.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F,MAAM,aAAa,GAAG,8EAA8E,CAAC;AACrG,MAAM,QAAQ,GAAG,uDAAuD,CAAC;AACzE,MAAM,EAAE,GAAG,GAAG,CAAC;AAEf,gBAAgB;AAChB,IAAK,MAIJ;AAJD,WAAK,MAAM;IACT,yCAAW,CAAA;IACX,mCAAQ,CAAA;IACR,2CAAY,CAAA;AACd,CAAC,EAJI,MAAM,KAAN,MAAM,QAIV;AASD,gBAAgB;AAChB,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,MAAM,OAAO,GAAoC,IAAI,GAAG,EAAE,CAAC;IAE3D,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;YACtD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,iBAAiB;oBACnB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,CAAC;YACjG,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\nconst expressionRgx = /^(([A-Z]\\w*:)?([A-Z]\\w*|\\[([A-Z]\\w*:)?[A-Z]\\w*\\])(\\(-?\\d+\\))?(\\*(?!$)|$))+$/i;\nconst tokenRgx = /(?:(\\[)?((?:[A-Z]\\w*:)?[A-Z]\\w*)\\]?)(?:\\((-?\\d+)\\))?/i;\nconst sp = \"*\";\n\n/** @internal */\nenum Tokens {\n  Bracket = 1,\n  Word = 2,\n  Exponent = 3,\n}\n\n/** @internal */\nexport interface DefinitionFragment {\n  name: string;\n  exponent: number;\n  constant: boolean;\n}\n\n/** @internal */\nexport function parseDefinition(definition: string): Map<string, DefinitionFragment> {\n  const unitMap: Map<string, DefinitionFragment> = new Map();\n\n  if (expressionRgx.test(definition)) {\n    for (const unit of definition.split(sp)) {\n      const tokens = unit.split(tokenRgx);\n      const name = tokens[Tokens.Word];\n      const exponent = tokens[Tokens.Exponent] ? Number(tokens[Tokens.Exponent]) : 1;\n      const constant = tokens[Tokens.Bracket] !== undefined;\n      if (unitMap.has(name)) {\n        const currentDefinition = unitMap.get(name);\n        if (currentDefinition)\n          unitMap.set(name, { ...currentDefinition, exponent: currentDefinition.exponent + exponent });\n      } else {\n        unitMap.set(name, { name, exponent, constant });\n      }\n    }\n\n    return unitMap;\n  } else {\n    throw new Error(\"Invalid definition expression.\");\n  }\n}\n"]}

package/lib/esm/UnitConversion/UnitConversion.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Structural interface satisfied by any object that carries a numerator/denominator
+ * factor and an optional offset — for example, the EC `Unit` and `Constant` classes in
+ * `@itwin/ecschema-metadata`.
+ * @internal
+ */
+export interface UnitConversionSource {
+    readonly numerator: number;
+    readonly denominator: number;
+    readonly offset?: number;
+}
+/**
+ * Class used for storing calculated conversion between two Units and converting values from one Unit to another.
+ * @internal
+ */
+export declare class UnitConversion {
+    readonly factor: number;
+    readonly offset: number;
+    constructor(factor?: number, offset?: number);
+    /**
+     * Converts x using UnitConversion
+     * @param x Input magnitude to be converted
+     * @returns Output magnitude after conversion
+     */
+    evaluate(x: number): number;
+    /**
+     * Used to invert source's UnitConversion so that it can be composed with target's UnitConversion cleanly
+     * @internal
+     */
+    inverse(): UnitConversion;
+    /**
+     * Combines two UnitConversions
+     * Used to combine source's UnitConversion and target's UnitConversion for a final UnitConversion that can be evaluated
+     * @internal
+     */
+    compose(conversion: UnitConversion): UnitConversion;
+    /**
+     * Multiples two UnitConversions together to calculate factor during reducing
+     * @internal
+     */
+    multiply(conversion: UnitConversion): UnitConversion;
+    /**
+     * Raise UnitConversion's factor with power exponent to calculate factor during reducing
+     * @internal
+     */
+    raise(power: number): UnitConversion;
+    /** @internal */
+    static identity: UnitConversion;
+    /**
+     * Returns UnitConversion with source's numerator and denominator in factor and source's offset in offset for reducing.
+     * Accepts any object that structurally satisfies `UnitConversionSource` (e.g. EC `Unit` or `Constant`).
+     * @internal
+     */
+    static from(source: UnitConversionSource): UnitConversion;
+}
+//# sourceMappingURL=UnitConversion.d.ts.map

package/lib/esm/UnitConversion/UnitConversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnitConversion.d.ts","sourceRoot":"","sources":["../../../src/UnitConversion/UnitConversion.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,cAAc;aACG,MAAM,EAAE,MAAM;aAAwB,MAAM,EAAE,MAAM;gBAApD,MAAM,GAAE,MAAY,EAAkB,MAAM,GAAE,MAAY;IAEtF;;;;OAIG;IACI,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlC;;;OAGG;IACI,OAAO,IAAI,cAAc;IAKhC;;;;OAIG;IACI,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc;IAO1D;;;OAGG;IACI,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc;IAO3D;;;OAGG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAY3C,gBAAgB;IAChB,OAAc,QAAQ,iBAAwB;IAE9C;;;;OAIG;WACW,IAAI,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc;CAKjE"}

package/lib/esm/UnitConversion/UnitConversion.js

@@ -0,0 +1,76 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { almostEqual } from "../Quantity";
+/**
+ * Class used for storing calculated conversion between two Units and converting values from one Unit to another.
+ * @internal
+ */
+export class UnitConversion {
+    factor;
+    offset;
+    constructor(factor = 1.0, offset = 0.0) {
+        this.factor = factor;
+        this.offset = offset;
+    }
+    /**
+     * Converts x using UnitConversion
+     * @param x Input magnitude to be converted
+     * @returns Output magnitude after conversion
+     */
+    evaluate(x) {
+        return this.factor * x + this.offset;
+    }
+    /**
+     * Used to invert source's UnitConversion so that it can be composed with target's UnitConversion cleanly
+     * @internal
+     */
+    inverse() {
+        const inverseFactor = 1.0 / this.factor;
+        return new UnitConversion(inverseFactor, -this.offset * inverseFactor);
+    }
+    /**
+     * Combines two UnitConversions
+     * Used to combine source's UnitConversion and target's UnitConversion for a final UnitConversion that can be evaluated
+     * @internal
+     */
+    compose(conversion) {
+        return new UnitConversion(this.factor * conversion.factor, conversion.factor * this.offset + conversion.offset);
+    }
+    /**
+     * Multiples two UnitConversions together to calculate factor during reducing
+     * @internal
+     */
+    multiply(conversion) {
+        if (almostEqual(conversion.offset, 0.0) && almostEqual(this.offset, 0.0))
+            return new UnitConversion(this.factor * conversion.factor, 0.0);
+        throw new Error("Cannot multiply two maps with non-zero offsets");
+    }
+    /**
+     * Raise UnitConversion's factor with power exponent to calculate factor during reducing
+     * @internal
+     */
+    raise(power) {
+        if (almostEqual(power, 1.0))
+            return new UnitConversion(this.factor, this.offset);
+        else if (almostEqual(power, 0.0))
+            return new UnitConversion(1.0, 0.0);
+        if (almostEqual(this.offset, 0.0))
+            return new UnitConversion(this.factor ** power, 0.0);
+        throw new Error("Cannot raise map with non-zero offset");
+    }
+    /** @internal */
+    static identity = new UnitConversion();
+    /**
+     * Returns UnitConversion with source's numerator and denominator in factor and source's offset in offset for reducing.
+     * Accepts any object that structurally satisfies `UnitConversionSource` (e.g. EC `Unit` or `Constant`).
+     * @internal
+     */
+    static from(source) {
+        const offset = source.offset ?? 0;
+        const hasOffset = !almostEqual(offset, 0.0);
+        return new UnitConversion(source.denominator / source.numerator, hasOffset ? -offset : 0.0);
+    }
+}
+//# sourceMappingURL=UnitConversion.js.map