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

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":["/*---------------------------------------------------------------------------------------------\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  /** Logger category for quantity parsing operations. */\r\n  Parsing = \"core-quantity.Parsing\",\r\n}\r\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":["/*---------------------------------------------------------------------------------------------\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\r\n/** Current version of the serialization format for `SerializedUnitSchema`.\r\n *\r\n * This value is written into `Units.json` as the `version` field and checked at\r\n * parse time. Two version axes exist:\r\n *\r\n * - **Format version** (`SERIALIZED_UNIT_SCHEMA_VERSION` / `Units.json.version`): bump\r\n *   the major version when the shape of the `SerializedUnitSchema` interfaces changes\r\n *   incompatibly (e.g. renaming fields, removing required properties). Minor bumps for\r\n *   backward-compatible additions.\r\n *\r\n * - **Source provenance** (`sourceEcSchemaVersion` inside `Units.json`): records which\r\n *   version of the BIS Units EC schema the data was derived from (e.g. `\"01.00.09\"`).\r\n *   This is a traceability marker, not a runtime contract.\r\n *\r\n * @internal\r\n */\r\nexport const SERIALIZED_UNIT_SCHEMA_VERSION = \"01.00.00\";\r\n\r\n/** A serialized constant definition (e.g. `PI`, `MILLI`).\r\n * @internal\r\n */\r\nexport interface SerializedConstant {\r\n  readonly schemaItemType: \"Constant\";\r\n  readonly label?: string;\r\n  readonly description?: string;\r\n  /** The phenomenon this constant belongs to. */\r\n  readonly phenomenon: string;\r\n  /** The unit definition expression (e.g. `\"M*M\"`). */\r\n  readonly definition: string;\r\n  /** Numerator of the conversion factor to the SI base. */\r\n  readonly numerator?: number;\r\n  /** Denominator of the conversion factor to the SI base. */\r\n  readonly denominator?: number;\r\n}\r\n\r\n/** A serialized unit definition (e.g. `M`, `FT`, `CELSIUS`).\r\n * @internal\r\n */\r\nexport interface SerializedUnit {\r\n  readonly schemaItemType: \"Unit\";\r\n  readonly label?: string;\r\n  readonly description?: string;\r\n  readonly phenomenon: string;\r\n  readonly unitSystem: string;\r\n  /** The unit definition expression (e.g. `\"M*M\"`). */\r\n  readonly definition: string;\r\n  /** Numerator of the conversion factor to the SI base. */\r\n  readonly numerator?: number;\r\n  /** Denominator of the conversion factor to the SI base. */\r\n  readonly denominator?: number;\r\n  /** Additive offset for the conversion (e.g. temperature scales). */\r\n  readonly offset?: number;\r\n}\r\n\r\n/** A serialized inverted unit definition (e.g. `HORIZONTAL_PER_VERTICAL`).\r\n * @internal\r\n */\r\nexport interface SerializedInvertedUnit {\r\n  readonly schemaItemType: \"InvertedUnit\";\r\n  readonly label?: string;\r\n  readonly description?: string;\r\n  readonly invertsUnit: string;\r\n  readonly unitSystem: string;\r\n}\r\n\r\n/** A serialized unit system definition (e.g. `SI`, `METRIC`).\r\n * @internal\r\n */\r\nexport interface SerializedUnitSystem {\r\n  readonly schemaItemType: \"UnitSystem\";\r\n  readonly label?: string;\r\n  readonly description?: string;\r\n}\r\n\r\n/** A serialized phenomenon definition (e.g. `LENGTH`, `TEMPERATURE`).\r\n * @internal\r\n */\r\nexport interface SerializedPhenomenon {\r\n  readonly schemaItemType: \"Phenomenon\";\r\n  readonly label?: string;\r\n  readonly description?: string;\r\n  /** The phenomenon definition expression. */\r\n  readonly definition: string;\r\n}\r\n\r\n/** Discriminated union of all serialized schema item types.\r\n * @internal\r\n */\r\nexport type SerializedUnitItem = SerializedConstant | SerializedUnit | SerializedInvertedUnit | SerializedUnitSystem | SerializedPhenomenon;\r\n\r\n/** Versioned container for a serialized BIS unit schema. The `items` map is keyed by schema-item name (unqualified).\r\n * @internal\r\n */\r\nexport interface SerializedUnitSchema {\r\n  /** Serialization format version, matching `SERIALIZED_UNIT_SCHEMA_VERSION` (e.g. `\"01.00.00\"`). */\r\n  readonly version: string;\r\n  readonly name: string;\r\n  readonly alias: string;\r\n  /** EC schema version of the source BIS Units schema this data was derived from (e.g. `\"01.00.09\"`). */\r\n  readonly sourceEcSchemaVersion: string;\r\n  readonly items: { readonly [name: string]: SerializedUnitItem };\r\n}\r\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":["/*---------------------------------------------------------------------------------------------\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// Following https://github.com/dagrejs/graphlib/blob/master/lib/graph.js\r\n\r\n/**\r\n * Using generics for nodes - T represents Unit | Constant in our use case\r\n * @internal\r\n */\r\ninterface NodesMap<T> {\r\n  [node: string]: T;\r\n}\r\n\r\n/**\r\n * Describe edges based on its node endpoints (v, w)\r\n * @internal\r\n */\r\ninterface EdgeObjsMap {\r\n  [edge: string]: {\r\n    v: string;\r\n    w: string;\r\n  };\r\n}\r\n\r\n/**\r\n * Describe edges based on the exponent they carry\r\n * @internal\r\n */\r\ninterface EdgeLabelsMap {\r\n  [edge: string]: { exponent: number };\r\n}\r\n\r\n/**\r\n * List each node with outgoing edges in outer map; describe each node's outgoing edges in inner map\r\n * @internal\r\n */\r\ninterface OutEdgesMap {\r\n  [node: string]: {\r\n    [edges: string]: {\r\n      v: string;\r\n      w: string;\r\n    };\r\n  };\r\n}\r\n\r\n/** @internal */\r\nexport class UnitConversionGraph<T> {\r\n  private _edgeKeyDelim = \"\\x01\";\r\n  private _label = \"\";\r\n  private _nodeCount = 0;\r\n  private _edgeCount = 0;\r\n  private _nodes: NodesMap<T>;\r\n  private _edgeObjs: EdgeObjsMap;\r\n  private _edgeLabels: EdgeLabelsMap;\r\n  private _outEdges: OutEdgesMap;\r\n\r\n  constructor() {\r\n    this._nodes = {};\r\n    this._edgeObjs = {};\r\n    this._edgeLabels = {};\r\n    this._outEdges = {};\r\n  }\r\n\r\n  public setGraph = (label: string): UnitConversionGraph<T> => {\r\n    this._label = label;\r\n    return this;\r\n  };\r\n\r\n  public graph = () => {\r\n    return this._label;\r\n  };\r\n\r\n  public nodeCount = () => {\r\n    return this._nodeCount;\r\n  };\r\n\r\n  public nodes = () => {\r\n    return Object.keys(this._nodes);\r\n  };\r\n\r\n  public setNode = (nodeKey: string, nodeValue: T) => {\r\n    if (nodeKey in this._nodes) {\r\n      this._nodes[nodeKey] = nodeValue;\r\n      return;\r\n    }\r\n    this._nodes[nodeKey] = nodeValue;\r\n    this._outEdges[nodeKey] = {};\r\n    ++this._nodeCount;\r\n  };\r\n\r\n  public node = (nodeKey: string) => {\r\n    return this._nodes[nodeKey];\r\n  };\r\n\r\n  public hasNode = (nodeKey: string) => {\r\n    return nodeKey in this._nodes;\r\n  };\r\n\r\n  public edgeCount = () => {\r\n    return this._edgeCount;\r\n  };\r\n\r\n  public edges = () => {\r\n    return Object.values(this._edgeObjs);\r\n  };\r\n\r\n  public setEdge = (v: string, w: string, value: { exponent: number }) => {\r\n    const edgeId = v + this._edgeKeyDelim + w + this._edgeKeyDelim;\r\n    if (edgeId in this._edgeLabels) {\r\n      // Update exponent, specific to this graph's use case\r\n      this._edgeLabels[edgeId].exponent += value.exponent;\r\n      return;\r\n    }\r\n\r\n    this._edgeLabels[edgeId] = value;\r\n    const edgeObj = {\r\n      v,\r\n      w,\r\n    };\r\n    this._edgeObjs[edgeId] = edgeObj;\r\n    // setNode should have ran first, so this.outEdges[v] shouldn't be undefined\r\n    this._outEdges[v][edgeId] = edgeObj;\r\n    this._edgeCount++;\r\n  };\r\n\r\n  public edge = (v: string, w: string) => {\r\n    const edgeId = v + this._edgeKeyDelim + w + this._edgeKeyDelim;\r\n    return this._edgeLabels[edgeId];\r\n  };\r\n\r\n  public outEdges = (v: string) => {\r\n    const outV = this._outEdges[v];\r\n    const edges = Object.values(outV);\r\n    return edges;\r\n  };\r\n}\r\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":["/*---------------------------------------------------------------------------------------------\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\nconst expressionRgx = /^(([A-Z]\\w*:)?([A-Z]\\w*|\\[([A-Z]\\w*:)?[A-Z]\\w*\\])(\\(-?\\d+\\))?(\\*(?!$)|$))+$/i;\r\nconst tokenRgx = /(?:(\\[)?((?:[A-Z]\\w*:)?[A-Z]\\w*)\\]?)(?:\\((-?\\d+)\\))?/i;\r\nconst sp = \"*\";\r\n\r\n/** @internal */\r\nenum Tokens {\r\n  Bracket = 1,\r\n  Word = 2,\r\n  Exponent = 3,\r\n}\r\n\r\n/** @internal */\r\nexport interface DefinitionFragment {\r\n  name: string;\r\n  exponent: number;\r\n  constant: boolean;\r\n}\r\n\r\n/** @internal */\r\nexport function parseDefinition(definition: string): Map<string, DefinitionFragment> {\r\n  const unitMap: Map<string, DefinitionFragment> = new Map();\r\n\r\n  if (expressionRgx.test(definition)) {\r\n    for (const unit of definition.split(sp)) {\r\n      const tokens = unit.split(tokenRgx);\r\n      const name = tokens[Tokens.Word];\r\n      const exponent = tokens[Tokens.Exponent] ? Number(tokens[Tokens.Exponent]) : 1;\r\n      const constant = tokens[Tokens.Bracket] !== undefined;\r\n      if (unitMap.has(name)) {\r\n        const currentDefinition = unitMap.get(name);\r\n        if (currentDefinition)\r\n          unitMap.set(name, { ...currentDefinition, exponent: currentDefinition.exponent + exponent });\r\n      } else {\r\n        unitMap.set(name, { name, exponent, constant });\r\n      }\r\n    }\r\n\r\n    return unitMap;\r\n  } else {\r\n    throw new Error(\"Invalid definition expression.\");\r\n  }\r\n}\r\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

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnitConversion.js","sourceRoot":"","sources":["../../../src/UnitConversion/UnitConversion.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc1C;;;GAGG;AACH,MAAM,OAAO,cAAc;IACG;IAAsC;IAAlE,YAA4B,SAAiB,GAAG,EAAkB,SAAiB,GAAG;QAA1D,WAAM,GAAN,MAAM,CAAc;QAAkB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAE1F;;;;OAIG;IACI,QAAQ,CAAC,CAAS;QACvB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,OAAO,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IACzE,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAC,UAA0B;QACvC,OAAO,IAAI,cAAc,CACvB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,EAC/B,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CACpD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,UAA0B;QACxC,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;YACtE,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAElE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAa;QACxB,IAAI,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC;YACzB,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;aACjD,IAAI,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC;YAC9B,OAAO,IAAI,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEtC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;YAC/B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,GAAG,CAAC,CAAC;QAEvD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IAE9C;;;;OAIG;IACI,MAAM,CAAC,IAAI,CAAC,MAA4B;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9F,CAAC","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\nimport { almostEqual } from \"../Quantity\";\r\n\r\n/**\r\n * Structural interface satisfied by any object that carries a numerator/denominator\r\n * factor and an optional offset — for example, the EC `Unit` and `Constant` classes in\r\n * `@itwin/ecschema-metadata`.\r\n * @internal\r\n */\r\nexport interface UnitConversionSource {\r\n  readonly numerator: number;\r\n  readonly denominator: number;\r\n  readonly offset?: number;\r\n}\r\n\r\n/**\r\n * Class used for storing calculated conversion between two Units and converting values from one Unit to another.\r\n * @internal\r\n */\r\nexport class UnitConversion {\r\n  constructor(public readonly factor: number = 1.0, public readonly offset: number = 0.0) {}\r\n\r\n  /**\r\n   * Converts x using UnitConversion\r\n   * @param x Input magnitude to be converted\r\n   * @returns Output magnitude after conversion\r\n   */\r\n  public evaluate(x: number): number {\r\n    return this.factor * x + this.offset;\r\n  }\r\n\r\n  /**\r\n   * Used to invert source's UnitConversion so that it can be composed with target's UnitConversion cleanly\r\n   * @internal\r\n   */\r\n  public inverse(): UnitConversion {\r\n    const inverseFactor = 1.0 / this.factor;\r\n    return new UnitConversion(inverseFactor, -this.offset * inverseFactor);\r\n  }\r\n\r\n  /**\r\n   * Combines two UnitConversions\r\n   * Used to combine source's UnitConversion and target's UnitConversion for a final UnitConversion that can be evaluated\r\n   * @internal\r\n   */\r\n  public compose(conversion: UnitConversion): UnitConversion {\r\n    return new UnitConversion(\r\n      this.factor * conversion.factor,\r\n      conversion.factor * this.offset + conversion.offset,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Multiples two UnitConversions together to calculate factor during reducing\r\n   * @internal\r\n   */\r\n  public multiply(conversion: UnitConversion): UnitConversion {\r\n    if (almostEqual(conversion.offset, 0.0) && almostEqual(this.offset, 0.0))\r\n      return new UnitConversion(this.factor * conversion.factor, 0.0);\r\n\r\n    throw new Error(\"Cannot multiply two maps with non-zero offsets\");\r\n  }\r\n\r\n  /**\r\n   * Raise UnitConversion's factor with power exponent to calculate factor during reducing\r\n   * @internal\r\n   */\r\n  public raise(power: number): UnitConversion {\r\n    if (almostEqual(power, 1.0))\r\n      return new UnitConversion(this.factor, this.offset);\r\n    else if (almostEqual(power, 0.0))\r\n      return new UnitConversion(1.0, 0.0);\r\n\r\n    if (almostEqual(this.offset, 0.0))\r\n      return new UnitConversion(this.factor ** power, 0.0);\r\n\r\n    throw new Error(\"Cannot raise map with non-zero offset\");\r\n  }\r\n\r\n  /** @internal */\r\n  public static identity = new UnitConversion();\r\n\r\n  /**\r\n   * Returns UnitConversion with source's numerator and denominator in factor and source's offset in offset for reducing.\r\n   * Accepts any object that structurally satisfies `UnitConversionSource` (e.g. EC `Unit` or `Constant`).\r\n   * @internal\r\n   */\r\n  public static from(source: UnitConversionSource): UnitConversion {\r\n    const offset = source.offset ?? 0;\r\n    const hasOffset = !almostEqual(offset, 0.0);\r\n    return new UnitConversion(source.denominator / source.numerator, hasOffset ? -offset : 0.0);\r\n  }\r\n}\r\n"]}

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

@@ -0,0 +1,29 @@
+import { type SerializedUnitSchema } from "../SerializedUnitSchema";
+import { UnitConversion } from "./UnitConversion";
+/** Resolved unit entry containing the unit's name and its conversion to the base of its phenomenon.
+ * @internal
+ */
+export interface ResolvedUnit {
+    readonly name: string;
+    readonly label: string;
+    readonly phenomenon: string;
+    readonly unitSystem: string;
+    readonly conversion: UnitConversion;
+}
+/** Resolves every unit in a `SerializedUnitSchema` to a `UnitConversion` relative to its phenomenon's base unit.
+ * @internal
+ */
+export declare class UnitDefinitionResolver {
+    private readonly _schema;
+    private readonly _cache;
+    constructor(schema: SerializedUnitSchema);
+    /** Resolve all Unit items in the schema and return a map from item name to `ResolvedUnit`. */
+    resolveAll(): Map<string, ResolvedUnit>;
+    /** Resolve a single unit by unqualified name, returning its conversion to base. */
+    private _resolveUnit;
+    private _resolveConstant;
+    private _resolveUnitItem;
+    /** Parse and resolve a compound definition string like `[MILLI]*M` or `IN`. */
+    private _resolveDefinition;
+}
+//# sourceMappingURL=UnitDefinitionResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnitDefinitionResolver.d.ts","sourceRoot":"","sources":["../../../src/UnitConversion/UnitDefinitionResolver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgF,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAClJ,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEhD,MAAM,EAAE,oBAAoB;IAMxC,8FAA8F;IACvF,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAmB9C,mFAAmF;IACnF,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,gBAAgB;IAexB,+EAA+E;IAC/E,OAAO,CAAC,kBAAkB;CAc3B"}

package/lib/esm/UnitConversion/UnitDefinitionResolver.js

@@ -0,0 +1,98 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { SERIALIZED_UNIT_SCHEMA_VERSION } from "../SerializedUnitSchema";
+import { UnitConversion } from "./UnitConversion";
+import { parseDefinition } from "./Parser";
+import { stripAliasPrefix } from "./nameUtils";
+const MAX_RESOLUTION_DEPTH = 30;
+/** Resolves every unit in a `SerializedUnitSchema` to a `UnitConversion` relative to its phenomenon's base unit.
+ * @internal
+ */
+export class UnitDefinitionResolver {
+    _schema;
+    _cache = new Map();
+    constructor(schema) {
+        if (schema.version !== SERIALIZED_UNIT_SCHEMA_VERSION)
+            throw new Error(`Unsupported Units.json version "${schema.version}". Expected "${SERIALIZED_UNIT_SCHEMA_VERSION}".`);
+        this._schema = schema;
+    }
+    /** Resolve all Unit items in the schema and return a map from item name to `ResolvedUnit`. */
+    resolveAll() {
+        const result = new Map();
+        for (const [name, item] of Object.entries(this._schema.items)) {
+            if (item.schemaItemType === "Unit") {
+                const conversion = this._resolveUnit(name, 0);
+                result.set(name, {
+                    name,
+                    label: item.label ?? name,
+                    phenomenon: item.phenomenon,
+                    unitSystem: item.unitSystem,
+                    conversion,
+                });
+            }
+        }
+        return result;
+    }
+    /** Resolve a single unit by unqualified name, returning its conversion to base. */
+    _resolveUnit(name, depth) {
+        if (depth > MAX_RESOLUTION_DEPTH)
+            throw new Error(`Unit resolution depth exceeded ${MAX_RESOLUTION_DEPTH} for "${name}"`);
+        const cached = this._cache.get(name);
+        if (cached)
+            return cached;
+        const item = this._schema.items[name];
+        if (!item)
+            throw new Error(`Unknown schema item: "${name}"`);
+        let conversion;
+        if (item.schemaItemType === "Constant") {
+            conversion = this._resolveConstant(name, item, depth);
+        }
+        else if (item.schemaItemType === "Unit") {
+            conversion = this._resolveUnitItem(name, item, depth);
+        }
+        else {
+            throw new Error(`Cannot resolve item of type "${item.schemaItemType}": "${name}"`);
+        }
+        this._cache.set(name, conversion);
+        return conversion;
+    }
+    _resolveConstant(name, item, depth) {
+        // A constant is identity if its definition is its own name
+        if (item.definition === name)
+            return UnitConversion.identity;
+        const selfConv = UnitConversion.from({
+            numerator: item.numerator ?? 1,
+            denominator: item.denominator ?? 1,
+        });
+        const defConv = this._resolveDefinition(item.definition, depth + 1);
+        return defConv.compose(selfConv);
+    }
+    _resolveUnitItem(name, item, depth) {
+        // A unit is a base unit if its definition is its own name
+        if (item.definition === name)
+            return UnitConversion.identity;
+        const selfConv = UnitConversion.from({
+            numerator: item.numerator ?? 1,
+            denominator: item.denominator ?? 1,
+            offset: item.offset,
+        });
+        const defConv = this._resolveDefinition(item.definition, depth + 1);
+        return defConv.compose(selfConv);
+    }
+    /** Parse and resolve a compound definition string like `[MILLI]*M` or `IN`. */
+    _resolveDefinition(definition, depth) {
+        const fragments = parseDefinition(definition);
+        let result;
+        for (const [, fragment] of fragments) {
+            // Strip alias prefix if present (definitions in the schema use unqualified names)
+            const fragName = stripAliasPrefix(fragment.name);
+            const fragConv = this._resolveUnit(fragName, depth + 1);
+            const raised = fragConv.raise(fragment.exponent);
+            result = result ? result.multiply(raised) : raised;
+        }
+        return result ?? UnitConversion.identity;
+    }
+}
+//# sourceMappingURL=UnitDefinitionResolver.js.map