@itwin/core-quantity 5.10.0-dev.9 → 5.10.0

package/lib/esm/UnitConversions.js

@@ -0,0 +1,116 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Quantity
+ */
+import { QuantityError, QuantityStatus } from "./Exception";
+import { UnitConversionInvert } from "./Interfaces";
+import { basicUnitConversionData } from "./internal/BasicUnitConversions.generated";
+import { defaultPersistenceUnits } from "./internal/DefaultPersistenceUnits.generated";
+import { convertValueOrThrow } from "./internal/UnitConversionMath";
+const basicUnitConversionLookup = basicUnitConversionData;
+function getUnitEntryFields([phenomenon, factor, offset, invertsUnitName]) {
+    return { phenomenon, factor, offset, invertsUnitName };
+}
+function throwUnknownUnit(unitName) {
+    throw new QuantityError(QuantityStatus.UnknownUnit, `Unknown unit "${unitName}".`);
+}
+function getUnitEntry(unitName) {
+    if (!Object.prototype.hasOwnProperty.call(basicUnitConversionLookup, unitName))
+        return throwUnknownUnit(unitName);
+    return basicUnitConversionLookup[unitName];
+}
+/** Type guard verifying a string is a known canonical built-in unit name.
+ *
+ * Returns true only for unit names shipped in the bundled built-in canonical unit set.
+ * Use this at system boundaries (e.g. when ingesting unit names from JSON config,
+ * iModel metadata, user input, or other dynamic sources) before calling
+ * `UnitConversions.getConversion`, `convert`, or `isCompatible`. Narrows the input
+ * type to `UnitName` so subsequent calls type-check without casts.
+ *
+ * @beta
+ */
+export function isUnitName(value) {
+    return Object.prototype.hasOwnProperty.call(basicUnitConversionLookup, value);
+}
+function getComparableEntry(unit) {
+    const { invertsUnitName } = getUnitEntryFields(unit);
+    return invertsUnitName ? getUnitEntry(invertsUnitName) : unit;
+}
+function composeConversion(fromUnit, toUnit) {
+    const { factor: fromFactor, offset: fromOffset } = getUnitEntryFields(fromUnit);
+    const { factor: toFactor, offset: toOffset } = getUnitEntryFields(toUnit);
+    return {
+        factor: toFactor / fromFactor,
+        offset: toOffset - ((toFactor * fromOffset) / fromFactor),
+    };
+}
+function getConversion(fromUnit, toUnit) {
+    const from = getUnitEntry(fromUnit);
+    const to = getUnitEntry(toUnit);
+    const comparableFrom = getComparableEntry(from);
+    const comparableTo = getComparableEntry(to);
+    const fromFields = getUnitEntryFields(from);
+    const toFields = getUnitEntryFields(to);
+    const comparableFromFields = getUnitEntryFields(comparableFrom);
+    const comparableToFields = getUnitEntryFields(comparableTo);
+    if (comparableFromFields.phenomenon !== comparableToFields.phenomenon)
+        return { factor: 1.0, offset: 0.0, error: true };
+    if (fromFields.invertsUnitName && toFields.invertsUnitName)
+        return composeConversion(comparableFrom, comparableTo);
+    if (fromFields.invertsUnitName) {
+        return {
+            ...composeConversion(comparableFrom, to),
+            inversion: UnitConversionInvert.InvertPreConversion,
+        };
+    }
+    if (toFields.invertsUnitName) {
+        return {
+            ...composeConversion(from, comparableTo),
+            inversion: UnitConversionInvert.InvertPostConversion,
+        };
+    }
+    return composeConversion(from, to);
+}
+function convert(fromUnit, toUnit, value) {
+    const conversion = getConversion(fromUnit, toUnit);
+    if (conversion.error)
+        throw new QuantityError(QuantityStatus.InvalidUnitConversion, `Cannot convert value from "${fromUnit}" to "${toUnit}" using invalid conversion metadata.`);
+    return convertValueOrThrow(value, conversion);
+}
+function isCompatible(fromUnit, toUnit) {
+    const from = getComparableEntry(getUnitEntry(fromUnit));
+    const to = getComparableEntry(getUnitEntry(toUnit));
+    const { phenomenon: fromPhenomenon } = getUnitEntryFields(from);
+    const { phenomenon: toPhenomenon } = getUnitEntryFields(to);
+    return fromPhenomenon === toPhenomenon;
+}
+/** Returns the package's default built-in persistence unit for a supported bundled built-in phenomenon.
+ *
+ * This helper is intentionally limited to the built-in canonical unit set shipped with `@itwin/core-quantity`.
+ * `Phenomena.LENGTH_RATIO` is intentionally excluded because the bundled built-in unit set does not yet provide an agreed default for that phenomenon.
+ * For schema-defined, custom, or iModel-specific persistence units, use a `UnitsProvider`-based workflow instead.
+ *
+ * @beta
+ */
+export function getDefaultPersistenceUnit(phenomenon) {
+    return defaultPersistenceUnits[phenomenon];
+}
+/** One-stop unit conversion helpers for the built-in canonical unit set generated from `@bentley/units-schema`.
+ * This surface is synchronous and only supports built-in canonical unit names shipped with `core-quantity`.
+ * `getConversion(...)` returns `UnitConversionProps` and uses `error: true` as the compatibility sentinel for known-but-incompatible built-in units.
+ * `convert(...)` and `convertValue(...)` are the throwing application helpers to use when invalid conversion metadata should fail fast.
+ * `isCompatible(...)` is the explicit built-in compatibility check to use before applying a conversion when a non-throwing branch is preferred.
+ * For schema-defined, custom, or provider-resolved units outside that built-in set, use a `UnitsProvider`-based workflow instead.
+ * @beta
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const UnitConversions = {
+    getConversion,
+    convert,
+    convertValue: convertValueOrThrow,
+    isCompatible,
+};
+//# sourceMappingURL=UnitConversions.js.map

package/lib/esm/UnitConversions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnitConversions.js","sourceRoot":"","sources":["../../src/UnitConversions.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 { UnitConversionInvert, type UnitConversionProps } from \"./Interfaces\";\nimport { Phenomena, type PhenomenonName, type UnitName } from \"./generated/Units.generated\";\nimport { basicUnitConversionData } from \"./internal/BasicUnitConversions.generated\";\nimport { defaultPersistenceUnits } from \"./internal/DefaultPersistenceUnits.generated\";\nimport { convertValueOrThrow } from \"./internal/UnitConversionMath\";\n\ntype BasicUnitConversionEntry = readonly [\n  phenomenon: string,\n  factor: number,\n  offset: number,\n  invertsUnitName?: string,\n];\n\ninterface BasicUnitConversionFields {\n  readonly phenomenon: string;\n  readonly factor: number;\n  readonly offset: number;\n  readonly invertsUnitName?: string;\n}\n\nconst basicUnitConversionLookup: Record<string, BasicUnitConversionEntry> =\n  basicUnitConversionData satisfies Record<string, BasicUnitConversionEntry>;\n\nfunction getUnitEntryFields([phenomenon, factor, offset, invertsUnitName]: BasicUnitConversionEntry): BasicUnitConversionFields {\n  return { phenomenon, factor, offset, invertsUnitName };\n}\n\nfunction throwUnknownUnit(unitName: string): never {\n  throw new QuantityError(QuantityStatus.UnknownUnit, `Unknown unit \"${unitName}\".`);\n}\n\nfunction getUnitEntry(unitName: string): BasicUnitConversionEntry {\n  if (!Object.prototype.hasOwnProperty.call(basicUnitConversionLookup, unitName))\n    return throwUnknownUnit(unitName);\n\n  return basicUnitConversionLookup[unitName];\n}\n\n/** Type guard verifying a string is a known canonical built-in unit name.\n *\n * Returns true only for unit names shipped in the bundled built-in canonical unit set.\n * Use this at system boundaries (e.g. when ingesting unit names from JSON config,\n * iModel metadata, user input, or other dynamic sources) before calling\n * `UnitConversions.getConversion`, `convert`, or `isCompatible`. Narrows the input\n * type to `UnitName` so subsequent calls type-check without casts.\n *\n * @beta\n */\nexport function isUnitName(value: string): value is UnitName {\n  return Object.prototype.hasOwnProperty.call(basicUnitConversionLookup, value);\n}\n\nfunction getComparableEntry(unit: BasicUnitConversionEntry): BasicUnitConversionEntry {\n  const { invertsUnitName } = getUnitEntryFields(unit);\n  return invertsUnitName ? getUnitEntry(invertsUnitName) : unit;\n}\n\nfunction composeConversion(fromUnit: BasicUnitConversionEntry, toUnit: BasicUnitConversionEntry): UnitConversionProps {\n  const { factor: fromFactor, offset: fromOffset } = getUnitEntryFields(fromUnit);\n  const { factor: toFactor, offset: toOffset } = getUnitEntryFields(toUnit);\n\n  return {\n    factor: toFactor / fromFactor,\n    offset: toOffset - ((toFactor * fromOffset) / fromFactor),\n  };\n}\n\nfunction getConversion(fromUnit: UnitName, toUnit: UnitName): UnitConversionProps {\n  const from = getUnitEntry(fromUnit);\n  const to = getUnitEntry(toUnit);\n  const comparableFrom = getComparableEntry(from);\n  const comparableTo = getComparableEntry(to);\n  const fromFields = getUnitEntryFields(from);\n  const toFields = getUnitEntryFields(to);\n  const comparableFromFields = getUnitEntryFields(comparableFrom);\n  const comparableToFields = getUnitEntryFields(comparableTo);\n\n  if (comparableFromFields.phenomenon !== comparableToFields.phenomenon)\n    return { factor: 1.0, offset: 0.0, error: true };\n\n  if (fromFields.invertsUnitName && toFields.invertsUnitName)\n    return composeConversion(comparableFrom, comparableTo);\n\n  if (fromFields.invertsUnitName) {\n    return {\n      ...composeConversion(comparableFrom, to),\n      inversion: UnitConversionInvert.InvertPreConversion,\n    };\n  }\n\n  if (toFields.invertsUnitName) {\n    return {\n      ...composeConversion(from, comparableTo),\n      inversion: UnitConversionInvert.InvertPostConversion,\n    };\n  }\n\n  return composeConversion(from, to);\n}\n\nfunction convert(fromUnit: UnitName, toUnit: UnitName, value: number): number {\n  const conversion = getConversion(fromUnit, toUnit);\n  if (conversion.error)\n    throw new QuantityError(QuantityStatus.InvalidUnitConversion, `Cannot convert value from \"${fromUnit}\" to \"${toUnit}\" using invalid conversion metadata.`);\n\n  return convertValueOrThrow(value, conversion);\n}\n\nfunction isCompatible(fromUnit: UnitName, toUnit: UnitName): boolean {\n  const from = getComparableEntry(getUnitEntry(fromUnit));\n  const to = getComparableEntry(getUnitEntry(toUnit));\n  const { phenomenon: fromPhenomenon } = getUnitEntryFields(from);\n  const { phenomenon: toPhenomenon } = getUnitEntryFields(to);\n  return fromPhenomenon === toPhenomenon;\n}\n\n/** Returns the package's default built-in persistence unit for a supported bundled built-in phenomenon.\n *\n * This helper is intentionally limited to the built-in canonical unit set shipped with `@itwin/core-quantity`.\n * `Phenomena.LENGTH_RATIO` is intentionally excluded because the bundled built-in unit set does not yet provide an agreed default for that phenomenon.\n * For schema-defined, custom, or iModel-specific persistence units, use a `UnitsProvider`-based workflow instead.\n *\n * @beta\n */\nexport function getDefaultPersistenceUnit(\n  phenomenon: Exclude<PhenomenonName, typeof Phenomena.LENGTH_RATIO>,\n): UnitName {\n  return defaultPersistenceUnits[phenomenon];\n}\n\n/** One-stop unit conversion helpers for the built-in canonical unit set generated from `@bentley/units-schema`.\n * This surface is synchronous and only supports built-in canonical unit names shipped with `core-quantity`.\n * `getConversion(...)` returns `UnitConversionProps` and uses `error: true` as the compatibility sentinel for known-but-incompatible built-in units.\n * `convert(...)` and `convertValue(...)` are the throwing application helpers to use when invalid conversion metadata should fail fast.\n * `isCompatible(...)` is the explicit built-in compatibility check to use before applying a conversion when a non-throwing branch is preferred.\n * For schema-defined, custom, or provider-resolved units outside that built-in set, use a `UnitsProvider`-based workflow instead.\n * @beta\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const UnitConversions: {\n  readonly getConversion: (fromUnit: UnitName, toUnit: UnitName) => UnitConversionProps;\n  readonly convert: (fromUnit: UnitName, toUnit: UnitName, value: number) => number;\n  readonly convertValue: (value: number, conversion: UnitConversionProps) => number;\n  readonly isCompatible: (fromUnit: UnitName, toUnit: UnitName) => boolean;\n} = {\n  getConversion,\n  convert,\n  convertValue: convertValueOrThrow,\n  isCompatible,\n};\n"]}

package/lib/esm/assets/Units.json

@@ -1,6 +1,6 @@
 {
     "version": "01.00.00",
-    "sourceEcSchemaVersion": "01.00.09",
+    "sourceEcSchemaVersion": "01.00.10",
     "name": "Units",
     "alias": "u",
     "label": "Units",
@@ -400,6 +400,11 @@
             "label": "Angle",
             "definition": "ANGLE"
         },
+        "HORIZONTAL_DIRECTION": {
+            "schemaItemType": "Phenomenon",
+            "label": "Horizontal Direction",
+            "definition": "HORIZONTAL_DIRECTION"
+        },
         "SOLIDANGLE": {
             "schemaItemType": "Phenomenon",
             "label": "Solid Angle",
@@ -1284,6 +1289,58 @@
             "unitSystem": "Units.METRIC",
             "definition": "[TWO_PI]*RAD"
         },
+        "HORIZONTAL_DIR_ARC_DEG": {
+            "schemaItemType": "Unit",
+            "label": "°",
+            "description": "1/180",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.METRIC",
+            "definition": "[PI]*HORIZONTAL_DIR_RAD",
+            "denominator": 180
+        },
+        "HORIZONTAL_DIR_ARC_MINUTE": {
+            "schemaItemType": "Unit",
+            "label": "'",
+            "description": "1/60",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.METRIC",
+            "definition": "HORIZONTAL_DIR_ARC_DEG",
+            "denominator": 60
+        },
+        "HORIZONTAL_DIR_ARC_SECOND": {
+            "schemaItemType": "Unit",
+            "label": "''",
+            "description": "1/3600",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.METRIC",
+            "definition": "HORIZONTAL_DIR_ARC_DEG",
+            "denominator": 3600
+        },
+        "HORIZONTAL_DIR_GRAD": {
+            "schemaItemType": "Unit",
+            "label": "grad",
+            "description": "1/200",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.METRIC",
+            "definition": "[PI]*HORIZONTAL_DIR_RAD",
+            "denominator": 200
+        },
+        "HORIZONTAL_DIR_MILLIRAD": {
+            "schemaItemType": "Unit",
+            "label": "mrad",
+            "description": "1/1000",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.METRIC",
+            "definition": "[PI]*HORIZONTAL_DIR_RAD",
+            "denominator": 1000
+        },
+        "HORIZONTAL_DIR_REVOLUTION": {
+            "schemaItemType": "Unit",
+            "label": "r",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.METRIC",
+            "definition": "[TWO_PI]*HORIZONTAL_DIR_RAD"
+        },
         "SQ_M": {
             "schemaItemType": "Unit",
             "label": "m²",
@@ -3795,6 +3852,13 @@
             "unitSystem": "Units.METRIC",
             "definition": "[MEGA]*LITRE"
         },
+        "MILLILITRE": {
+            "schemaItemType": "Unit",
+            "label": "mL",
+            "phenomenon": "Units.VOLUME",
+            "unitSystem": "Units.METRIC",
+            "definition": "[MILLI]*LITRE"
+        },
         "MICROLITRE": {
             "schemaItemType": "Unit",
             "label": "µliter",
@@ -4061,6 +4125,13 @@
             "unitSystem": "Units.SI",
             "definition": "RAD"
         },
+        "HORIZONTAL_DIR_RAD": {
+            "schemaItemType": "Unit",
+            "label": "rad",
+            "phenomenon": "Units.HORIZONTAL_DIRECTION",
+            "unitSystem": "Units.SI",
+            "definition": "HORIZONTAL_DIR_RAD"
+        },
         "STERAD": {
             "schemaItemType": "Unit",
             "label": "sterad",

package/lib/esm/core-quantity.d.ts

@@ -5,6 +5,7 @@ export * from "./Interfaces";
 export * from "./Parser";
 export * from "./ParserSpec";
 export * from "./Quantity";
+export * from "./UnitConversions";
 export * from "./Unit";
 export * from "./Formatter/Format";
 export * from "./Formatter/FormatterSpec";
@@ -18,6 +19,7 @@ export * from "./UnitConversion/UnitDefinitionResolver";
 export * from "./SerializedUnitSchema";
 export { BasicUnitsProvider } from "./BasicUnitsProvider";
 export * from "./CompositeUnitsProvider";
+export * from "./generated/Units.generated";
 export * from "./internal/cross-package";
 /** @docs-package-description
  * The core-quantity package contains classes, interfaces, and definitions for formatting and parsing quantity values.
@@ -34,6 +36,10 @@ export * from "./internal/cross-package";
  * @docs-group-description CompositeUnitsProvider
  * Factory and composition utilities for layering multiple UnitsProviders.
  */
+/**
+ * @docs-group-description Units.generated
+ * Generated built-in canonical unit, phenomenon, and unit-system identifiers.
+ */
 /**
  * @docs-group-description Logging
  * Logger categories used by this package.

package/lib/esm/core-quantity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-quantity.d.ts","sourceRoot":"","sources":["../../src/core-quantity.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAEzC;;GAEG;AAEH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG"}
+{"version":3,"file":"core-quantity.d.ts","sourceRoot":"","sources":["../../src/core-quantity.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AAEzC;;GAEG;AAEH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG"}

package/lib/esm/core-quantity.js

@@ -9,6 +9,7 @@ export * from "./Interfaces";
 export * from "./Parser";
 export * from "./ParserSpec";
 export * from "./Quantity";
+export * from "./UnitConversions";
 export * from "./Unit";
 export * from "./Formatter/Format";
 export * from "./Formatter/FormatterSpec";
@@ -22,6 +23,7 @@ export * from "./UnitConversion/UnitDefinitionResolver";
 export * from "./SerializedUnitSchema";
 export { BasicUnitsProvider } from "./BasicUnitsProvider";
 export * from "./CompositeUnitsProvider";
+export * from "./generated/Units.generated";
 export * from "./internal/cross-package";
 /** @docs-package-description
  * The core-quantity package contains classes, interfaces, and definitions for formatting and parsing quantity values.
@@ -38,6 +40,10 @@ export * from "./internal/cross-package";
  * @docs-group-description CompositeUnitsProvider
  * Factory and composition utilities for layering multiple UnitsProviders.
  */
+/**
+ * @docs-group-description Units.generated
+ * Generated built-in canonical unit, phenomenon, and unit-system identifiers.
+ */
 /**
  * @docs-group-description Logging
  * Logger categories used by this package.

package/lib/esm/core-quantity.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-quantity.js","sourceRoot":"","sources":["../../src/core-quantity.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AAEzC;;GAEG;AAEH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG","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*--------------------------------------------------------------------------------------------*/\nexport * from \"./Constants\";\nexport * from \"./Exception\";\nexport * from \"./FormatSpecHandle\";\nexport * from \"./Interfaces\";\nexport * from \"./Parser\";\nexport * from \"./ParserSpec\";\nexport * from \"./Quantity\";\nexport * from \"./Unit\";\nexport * from \"./Formatter/Format\";\nexport * from \"./Formatter/FormatterSpec\";\nexport * from \"./Formatter/FormatEnums\";\nexport * from \"./Formatter/Formatter\";\nexport * from \"./Formatter/FormattingReadyCollector\";\nexport * from \"./Formatter/Interfaces\";\nexport * from \"./QuantityLoggerCategory\";\n\nexport * from \"./UnitConversion/UnitConversion\";\nexport * from \"./UnitConversion/UnitDefinitionResolver\";\nexport * from \"./SerializedUnitSchema\";\nexport { BasicUnitsProvider } from \"./BasicUnitsProvider\";\nexport * from \"./CompositeUnitsProvider\";\nexport * from \"./internal/cross-package\";\n\n/** @docs-package-description\n * The core-quantity package contains classes, interfaces, and definitions for formatting and parsing quantity values.\n */\n\n/**\n * @docs-group-description Quantity\n * Classes, Interfaces, and definitions used to format and parse quantity values.\n */\n/**\n * @docs-group-description BasicUnitsProvider\n * A UnitsProvider backed by the bundled BIS Units schema JSON asset.\n */\n/**\n * @docs-group-description CompositeUnitsProvider\n * Factory and composition utilities for layering multiple UnitsProviders.\n */\n/**\n * @docs-group-description Logging\n * Logger categories used by this package.\n */\n"]}
+{"version":3,"file":"core-quantity.js","sourceRoot":"","sources":["../../src/core-quantity.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AAEzC;;GAEG;AAEH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG;AACH;;;GAGG","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*--------------------------------------------------------------------------------------------*/\nexport * from \"./Constants\";\nexport * from \"./Exception\";\nexport * from \"./FormatSpecHandle\";\nexport * from \"./Interfaces\";\nexport * from \"./Parser\";\nexport * from \"./ParserSpec\";\nexport * from \"./Quantity\";\nexport * from \"./UnitConversions\";\nexport * from \"./Unit\";\nexport * from \"./Formatter/Format\";\nexport * from \"./Formatter/FormatterSpec\";\nexport * from \"./Formatter/FormatEnums\";\nexport * from \"./Formatter/Formatter\";\nexport * from \"./Formatter/FormattingReadyCollector\";\nexport * from \"./Formatter/Interfaces\";\nexport * from \"./QuantityLoggerCategory\";\n\nexport * from \"./UnitConversion/UnitConversion\";\nexport * from \"./UnitConversion/UnitDefinitionResolver\";\nexport * from \"./SerializedUnitSchema\";\nexport { BasicUnitsProvider } from \"./BasicUnitsProvider\";\nexport * from \"./CompositeUnitsProvider\";\nexport * from \"./generated/Units.generated\";\nexport * from \"./internal/cross-package\";\n\n/** @docs-package-description\n * The core-quantity package contains classes, interfaces, and definitions for formatting and parsing quantity values.\n */\n\n/**\n * @docs-group-description Quantity\n * Classes, Interfaces, and definitions used to format and parse quantity values.\n */\n/**\n * @docs-group-description BasicUnitsProvider\n * A UnitsProvider backed by the bundled BIS Units schema JSON asset.\n */\n/**\n * @docs-group-description CompositeUnitsProvider\n * Factory and composition utilities for layering multiple UnitsProviders.\n */\n/**\n * @docs-group-description Units.generated\n * Generated built-in canonical unit, phenomenon, and unit-system identifiers.\n */\n/**\n * @docs-group-description Logging\n * Logger categories used by this package.\n */\n"]}