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

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":["/*---------------------------------------------------------------------------------------------\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*--------------------------------------------------------------------------------------------*/\nimport { almostEqual } from \"../Quantity\";\n\n/**\n * Structural interface satisfied by any object that carries a numerator/denominator\n * factor and an optional offset — for example, the EC `Unit` and `Constant` classes in\n * `@itwin/ecschema-metadata`.\n * @internal\n */\nexport interface UnitConversionSource {\n  readonly numerator: number;\n  readonly denominator: number;\n  readonly offset?: number;\n}\n\n/**\n * Class used for storing calculated conversion between two Units and converting values from one Unit to another.\n * @internal\n */\nexport class UnitConversion {\n  constructor(public readonly factor: number = 1.0, public readonly offset: number = 0.0) {}\n\n  /**\n   * Converts x using UnitConversion\n   * @param x Input magnitude to be converted\n   * @returns Output magnitude after conversion\n   */\n  public evaluate(x: number): number {\n    return this.factor * x + this.offset;\n  }\n\n  /**\n   * Used to invert source's UnitConversion so that it can be composed with target's UnitConversion cleanly\n   * @internal\n   */\n  public inverse(): UnitConversion {\n    const inverseFactor = 1.0 / this.factor;\n    return new UnitConversion(inverseFactor, -this.offset * inverseFactor);\n  }\n\n  /**\n   * Combines two UnitConversions\n   * Used to combine source's UnitConversion and target's UnitConversion for a final UnitConversion that can be evaluated\n   * @internal\n   */\n  public compose(conversion: UnitConversion): UnitConversion {\n    return new UnitConversion(\n      this.factor * conversion.factor,\n      conversion.factor * this.offset + conversion.offset,\n    );\n  }\n\n  /**\n   * Multiples two UnitConversions together to calculate factor during reducing\n   * @internal\n   */\n  public multiply(conversion: UnitConversion): UnitConversion {\n    if (almostEqual(conversion.offset, 0.0) && almostEqual(this.offset, 0.0))\n      return new UnitConversion(this.factor * conversion.factor, 0.0);\n\n    throw new Error(\"Cannot multiply two maps with non-zero offsets\");\n  }\n\n  /**\n   * Raise UnitConversion's factor with power exponent to calculate factor during reducing\n   * @internal\n   */\n  public raise(power: number): UnitConversion {\n    if (almostEqual(power, 1.0))\n      return new UnitConversion(this.factor, this.offset);\n    else if (almostEqual(power, 0.0))\n      return new UnitConversion(1.0, 0.0);\n\n    if (almostEqual(this.offset, 0.0))\n      return new UnitConversion(this.factor ** power, 0.0);\n\n    throw new Error(\"Cannot raise map with non-zero offset\");\n  }\n\n  /** @internal */\n  public static identity = new UnitConversion();\n\n  /**\n   * Returns UnitConversion with source's numerator and denominator in factor and source's offset in offset for reducing.\n   * Accepts any object that structurally satisfies `UnitConversionSource` (e.g. EC `Unit` or `Constant`).\n   * @internal\n   */\n  public static from(source: UnitConversionSource): UnitConversion {\n    const offset = source.offset ?? 0;\n    const hasOffset = !almostEqual(offset, 0.0);\n    return new UnitConversion(source.denominator / source.numerator, hasOffset ? -offset : 0.0);\n  }\n}\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

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