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

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnitDefinitionResolver.js","sourceRoot":"","sources":["../../../src/UnitConversion/UnitDefinitionResolver.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\nimport { SERIALIZED_UNIT_SCHEMA_VERSION, type SerializedConstant, type SerializedUnit, type SerializedUnitSchema } from \"../SerializedUnitSchema\";\r\nimport { UnitConversion } from \"./UnitConversion\";\r\nimport { parseDefinition } from \"./Parser\";\r\nimport { stripAliasPrefix } from \"./nameUtils\";\r\n\r\nconst MAX_RESOLUTION_DEPTH = 30;\r\n\r\n/** Resolved unit entry containing the unit's name and its conversion to the base of its phenomenon.\r\n * @internal\r\n */\r\nexport interface ResolvedUnit {\r\n  readonly name: string;\r\n  readonly label: string;\r\n  readonly phenomenon: string;\r\n  readonly unitSystem: string;\r\n  readonly conversion: UnitConversion;\r\n}\r\n\r\n/** Resolves every unit in a `SerializedUnitSchema` to a `UnitConversion` relative to its phenomenon's base unit.\r\n * @internal\r\n */\r\nexport class UnitDefinitionResolver {\r\n  private readonly _schema: SerializedUnitSchema;\r\n  private readonly _cache = new Map<string, UnitConversion>();\r\n\r\n  constructor(schema: SerializedUnitSchema) {\r\n    if (schema.version !== SERIALIZED_UNIT_SCHEMA_VERSION)\r\n      throw new Error(`Unsupported Units.json version \"${schema.version}\". Expected \"${SERIALIZED_UNIT_SCHEMA_VERSION}\".`);\r\n    this._schema = schema;\r\n  }\r\n\r\n  /** Resolve all Unit items in the schema and return a map from item name to `ResolvedUnit`. */\r\n  public resolveAll(): Map<string, ResolvedUnit> {\r\n    const result = new Map<string, ResolvedUnit>();\r\n\r\n    for (const [name, item] of Object.entries(this._schema.items)) {\r\n      if (item.schemaItemType === \"Unit\") {\r\n        const conversion = this._resolveUnit(name, 0);\r\n        result.set(name, {\r\n          name,\r\n          label: item.label ?? name,\r\n          phenomenon: item.phenomenon,\r\n          unitSystem: item.unitSystem,\r\n          conversion,\r\n        });\r\n      }\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  /** Resolve a single unit by unqualified name, returning its conversion to base. */\r\n  private _resolveUnit(name: string, depth: number): UnitConversion {\r\n    if (depth > MAX_RESOLUTION_DEPTH)\r\n      throw new Error(`Unit resolution depth exceeded ${MAX_RESOLUTION_DEPTH} for \"${name}\"`);\r\n\r\n    const cached = this._cache.get(name);\r\n    if (cached)\r\n      return cached;\r\n\r\n    const item = this._schema.items[name];\r\n    if (!item)\r\n      throw new Error(`Unknown schema item: \"${name}\"`);\r\n\r\n    let conversion: UnitConversion;\r\n\r\n    if (item.schemaItemType === \"Constant\") {\r\n      conversion = this._resolveConstant(name, item, depth);\r\n    } else if (item.schemaItemType === \"Unit\") {\r\n      conversion = this._resolveUnitItem(name, item, depth);\r\n    } else {\r\n      throw new Error(`Cannot resolve item of type \"${item.schemaItemType}\": \"${name}\"`);\r\n    }\r\n\r\n    this._cache.set(name, conversion);\r\n    return conversion;\r\n  }\r\n\r\n  private _resolveConstant(name: string, item: SerializedConstant, depth: number): UnitConversion {\r\n    // A constant is identity if its definition is its own name\r\n    if (item.definition === name)\r\n      return UnitConversion.identity;\r\n\r\n    const selfConv = UnitConversion.from({\r\n      numerator: item.numerator ?? 1,\r\n      denominator: item.denominator ?? 1,\r\n    });\r\n\r\n    const defConv = this._resolveDefinition(item.definition, depth + 1);\r\n    return defConv.compose(selfConv);\r\n  }\r\n\r\n  private _resolveUnitItem(name: string, item: SerializedUnit, depth: number): UnitConversion {\r\n    // A unit is a base unit if its definition is its own name\r\n    if (item.definition === name)\r\n      return UnitConversion.identity;\r\n\r\n    const selfConv = UnitConversion.from({\r\n      numerator: item.numerator ?? 1,\r\n      denominator: item.denominator ?? 1,\r\n      offset: item.offset,\r\n    });\r\n\r\n    const defConv = this._resolveDefinition(item.definition, depth + 1);\r\n    return defConv.compose(selfConv);\r\n  }\r\n\r\n  /** Parse and resolve a compound definition string like `[MILLI]*M` or `IN`. */\r\n  private _resolveDefinition(definition: string, depth: number): UnitConversion {\r\n    const fragments = parseDefinition(definition);\r\n    let result: UnitConversion | undefined;\r\n\r\n    for (const [, fragment] of fragments) {\r\n      // Strip alias prefix if present (definitions in the schema use unqualified names)\r\n      const fragName = stripAliasPrefix(fragment.name);\r\n      const fragConv = this._resolveUnit(fragName, depth + 1);\r\n      const raised = fragConv.raise(fragment.exponent);\r\n      result = result ? result.multiply(raised) : raised;\r\n    }\r\n\r\n    return result ?? UnitConversion.identity;\r\n  }\r\n}\r\n"]}

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

@@ -0,0 +1,11 @@
+/** Strips alias prefix from a schema item reference.
+ * `"u:FT"` → `"FT"`, `"FT"` → `"FT"`.
+ * @internal
+ */
+export declare function stripAliasPrefix(raw: string): string;
+/** Normalizes a schema item reference to fully-qualified `SchemaName.ItemName` format.
+ * Handles: already qualified (`"Units.FT"`), alias-qualified (`"u:FT"`), unqualified (`"FT"`).
+ * @internal
+ */
+export declare function qualifyItemName(raw: string, schemaName: string): string;
+//# sourceMappingURL=nameUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nameUtils.d.ts","sourceRoot":"","sources":["../../../src/UnitConversion/nameUtils.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIvE"}

package/lib/esm/UnitConversion/nameUtils.js

@@ -0,0 +1,21 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** Strips alias prefix from a schema item reference.
+ * `"u:FT"` → `"FT"`, `"FT"` → `"FT"`.
+ * @internal
+ */
+export function stripAliasPrefix(raw) {
+    return raw.includes(":") ? raw.split(":")[1] : raw;
+}
+/** Normalizes a schema item reference to fully-qualified `SchemaName.ItemName` format.
+ * Handles: already qualified (`"Units.FT"`), alias-qualified (`"u:FT"`), unqualified (`"FT"`).
+ * @internal
+ */
+export function qualifyItemName(raw, schemaName) {
+    if (raw.includes("."))
+        return raw;
+    return `${schemaName}.${stripAliasPrefix(raw)}`;
+}
+//# sourceMappingURL=nameUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nameUtils.js","sourceRoot":"","sources":["../../../src/UnitConversion/nameUtils.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,UAAkB;IAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,OAAO,GAAG,UAAU,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAClD,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/** Strips alias prefix from a schema item reference.\r\n * `\"u:FT\"` → `\"FT\"`, `\"FT\"` → `\"FT\"`.\r\n * @internal\r\n */\r\nexport function stripAliasPrefix(raw: string): string {\r\n  return raw.includes(\":\") ? raw.split(\":\")[1] : raw;\r\n}\r\n\r\n/** Normalizes a schema item reference to fully-qualified `SchemaName.ItemName` format.\r\n * Handles: already qualified (`\"Units.FT\"`), alias-qualified (`\"u:FT\"`), unqualified (`\"FT\"`).\r\n * @internal\r\n */\r\nexport function qualifyItemName(raw: string, schemaName: string): string {\r\n  if (raw.includes(\".\"))\r\n    return raw;\r\n  return `${schemaName}.${stripAliasPrefix(raw)}`;\r\n}\r\n"]}