@itwin/ecschema-editing 4.2.0-dev.9 → 4.3.0-dev.1

package/lib/cjs/Merging/ConstantMerger.d.ts

@@ -0,0 +1,12 @@
+import { Constant } from "@itwin/ecschema-metadata";
+import { SchemaItemChanges } from "../Validation/SchemaChanges";
+/**
+ * @internal
+ * @param target The constant the differences get merged into
+ * @param source The constant to compare
+ * @param changes Gets the @see SchemaItemChanges between the two constants.
+ * For example, if source constant has an attribute/property that it missing in
+ * target one, it would be listed in propertyValueChanges.
+ */
+export default function mergeConstant(target: Constant, source: Constant, changes: SchemaItemChanges): Promise<void>;
+//# sourceMappingURL=ConstantMerger.d.ts.map

package/lib/cjs/Merging/ConstantMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstantMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/ConstantMerger.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAA4E,MAAM,0BAA0B,CAAC;AAC9H,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIhE;;;;;;;GAOG;AACH,wBAA8B,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,iBAuCzG"}

package/lib/cjs/Merging/ConstantMerger.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const SchemaItemMerger_1 = require("./SchemaItemMerger");
+/**
+ * @internal
+ * @param target The constant the differences get merged into
+ * @param source The constant to compare
+ * @param changes Gets the @see SchemaItemChanges between the two constants.
+ * For example, if source constant has an attribute/property that it missing in
+ * target one, it would be listed in propertyValueChanges.
+ */
+async function mergeConstant(target, source, changes) {
+    const mutableConstant = target;
+    // Get referenced higher level phenomenon
+    const [refSchema, itemName] = await (0, SchemaItemMerger_1.getItemNameAndSchemaRef)(source, source.phenomenon.fullName);
+    await (0, SchemaItemMerger_1.mergeSchemaItemProperties)(mutableConstant, changes.propertyValueChanges, (item, propertyName, propertyValue) => {
+        switch (propertyName) {
+            case "definition": {
+                if (item.definition === "")
+                    return item.setDefinition(propertyValue);
+                throw Error(`Failed to merged, constant definition conflict: ${propertyValue} -> ${item.definition}`);
+            }
+            case "numerator": {
+                if (!item.hasNumerator)
+                    return item.setNumerator(propertyValue);
+                throw Error(`Failed to merged, constant numerator conflict: ${propertyValue} -> ${item.numerator}`);
+            }
+            case "denominator": {
+                if (!item.hasDenominator)
+                    return item.setDenominator(propertyValue);
+                throw Error(`Failed to merged, constant denominator conflict: ${propertyValue} -> ${item.denominator}`);
+            }
+            case "phenomenon": {
+                if (item.phenomenon === undefined) {
+                    // A lazy loaded phenomenon with the correct reference schema is needed, if reference schema is undefined then item schema.
+                    const schemaItemKey = new ecschema_metadata_1.SchemaItemKey(itemName, refSchema ? refSchema.schemaKey : target.schema.schemaKey);
+                    const lazyTargetPhenomenon = new ecschema_metadata_1.DelayedPromiseWithProps(schemaItemKey, async () => {
+                        const phenomenon = (await target.schema.context.getSchemaItem(schemaItemKey));
+                        // At this point, higher level phenomenon item should not be undefined
+                        if (phenomenon === undefined)
+                            throw Error(`Unable to locate phenomenon item in schema ${schemaItemKey.schemaName}`);
+                        return phenomenon;
+                    });
+                    return item.setPhenomenon(lazyTargetPhenomenon);
+                }
+            }
+        }
+    });
+}
+exports.default = mergeConstant;
+//# sourceMappingURL=ConstantMerger.js.map

package/lib/cjs/Merging/ConstantMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstantMerger.js","sourceRoot":"","sources":["../../../src/Merging/ConstantMerger.ts"],"names":[],"mappings":";;AAAA;;;+FAG+F;AAC/F,gEAA8H;AAE9H,yDAAwF;AAGxF;;;;;;;GAOG;AACY,KAAK,UAAU,aAAa,CAAC,MAAgB,EAAE,MAAgB,EAAE,OAA0B;IACxG,MAAM,eAAe,GAAG,MAAyB,CAAC;IAElD,yCAAyC;IACzC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,IAAA,0CAAuB,EAAC,MAAM,EAAE,MAAM,CAAC,UAAW,CAAC,QAAQ,CAAC,CAAC;IAEjG,MAAM,IAAA,4CAAyB,EAAC,eAAe,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE;QACnH,QAAQ,YAAY,EAAE;YACpB,KAAK,YAAY,CAAC,CAAC;gBACjB,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE;oBACxB,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;gBAC3C,MAAM,KAAK,CAAC,mDAAmD,aAAa,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;aACvG;YACD,KAAK,WAAW,CAAC,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,YAAY;oBACpB,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC1C,MAAM,KAAK,CAAC,kDAAkD,aAAa,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;aACrG;YACD,KAAK,aAAa,CAAC,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,cAAc;oBACtB,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;gBAC5C,MAAM,KAAK,CAAC,oDAAoD,aAAa,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;aACzG;YACD,KAAK,YAAY,CAAC,CAAC;gBACjB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;oBACjC,2HAA2H;oBAC3H,MAAM,aAAa,GAAG,IAAI,iCAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAC7G,MAAM,oBAAoB,GAAyB,IAAI,2CAAuB,CAA4B,aAAa,EAAE,KAAK,IAAI,EAAE;wBAClI,MAAM,UAAU,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAa,aAAa,CAAC,CAAC,CAAC;wBAC1F,sEAAsE;wBACtE,IAAI,UAAU,KAAK,SAAS;4BAC1B,MAAM,KAAK,CAAC,8CAA8C,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC;wBACxF,OAAO,UAAU,CAAC;oBACpB,CAAC,CAAC,CAAC;oBACH,OAAO,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;iBACjD;aACF;SACF;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAvCD,gCAuCC","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 { Constant, DelayedPromiseWithProps, LazyLoadedPhenomenon, Phenomenon, SchemaItemKey } from \"@itwin/ecschema-metadata\";\r\nimport { SchemaItemChanges } from \"../Validation/SchemaChanges\";\r\nimport { getItemNameAndSchemaRef, mergeSchemaItemProperties } from \"./SchemaItemMerger\";\r\nimport { MutableConstant } from \"../Editing/Mutable/MutableConstant\";\r\n\r\n/**\r\n * @internal\r\n * @param target The constant the differences get merged into\r\n * @param source The constant to compare\r\n * @param changes Gets the @see SchemaItemChanges between the two constants.\r\n * For example, if source constant has an attribute/property that it missing in\r\n * target one, it would be listed in propertyValueChanges.\r\n */\r\nexport default async function mergeConstant(target: Constant, source: Constant, changes: SchemaItemChanges) {\r\n  const mutableConstant = target as MutableConstant;\r\n\r\n  // Get referenced higher level phenomenon\r\n  const [refSchema, itemName] = await getItemNameAndSchemaRef(source, source.phenomenon!.fullName);\r\n\r\n  await mergeSchemaItemProperties(mutableConstant, changes.propertyValueChanges, (item, propertyName, propertyValue) => {\r\n    switch (propertyName) {\r\n      case \"definition\": {\r\n        if (item.definition === \"\")\r\n          return item.setDefinition(propertyValue);\r\n        throw Error(`Failed to merged, constant definition conflict: ${propertyValue} -> ${item.definition}`);\r\n      }\r\n      case \"numerator\": {\r\n        if (!item.hasNumerator)\r\n          return item.setNumerator(propertyValue);\r\n        throw Error(`Failed to merged, constant numerator conflict: ${propertyValue} -> ${item.numerator}`);\r\n      }\r\n      case \"denominator\": {\r\n        if (!item.hasDenominator)\r\n          return item.setDenominator(propertyValue);\r\n        throw Error(`Failed to merged, constant denominator conflict: ${propertyValue} -> ${item.denominator}`);\r\n      }\r\n      case \"phenomenon\": {\r\n        if (item.phenomenon === undefined) {\r\n          // A lazy loaded phenomenon with the correct reference schema is needed, if reference schema is undefined then item schema.\r\n          const schemaItemKey = new SchemaItemKey(itemName, refSchema ? refSchema.schemaKey : target.schema.schemaKey);\r\n          const lazyTargetPhenomenon: LazyLoadedPhenomenon = new DelayedPromiseWithProps<SchemaItemKey, Phenomenon>(schemaItemKey, async () => {\r\n            const phenomenon = (await target.schema.context.getSchemaItem<Phenomenon>(schemaItemKey));\r\n            // At this point, higher level phenomenon item should not be undefined\r\n            if (phenomenon === undefined)\r\n              throw Error(`Unable to locate phenomenon item in schema ${schemaItemKey.schemaName}`);\r\n            return phenomenon;\r\n          });\r\n          return item.setPhenomenon(lazyTargetPhenomenon);\r\n        }\r\n      }\r\n    }\r\n  });\r\n}\r\n"]}

package/lib/cjs/Merging/EnumerationMerger.d.ts

@@ -0,0 +1,12 @@
+import { Enumeration } from "@itwin/ecschema-metadata";
+import { EnumerationChanges } from "../Validation/SchemaChanges";
+/**
+ * @param target The Enumeration the differences get merged into
+ * @param source The Enumeration to compare
+ * @param changes Gets the @see EnumerationChanges between the two Enumerations.
+ * For example, if source Enumeration has an attribute that is undefined in
+ * target one, it would be listed in propertyValueChanges.
+ * @internal
+ */
+export default function mergeEnumeration(target: Enumeration, source: Enumeration, changes: EnumerationChanges): Promise<void>;
+//# sourceMappingURL=EnumerationMerger.d.ts.map

package/lib/cjs/Merging/EnumerationMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnumerationMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/EnumerationMerger.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,WAAW,EAA6C,MAAM,0BAA0B,CAAC;AACjH,OAAO,EAAc,kBAAkB,EAAmB,MAAM,6BAA6B,CAAC;AAsB9F;;;;;;;GAOG;AACH,wBAA8B,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,iBA8CnH"}

package/lib/cjs/Merging/EnumerationMerger.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const SchemaChanges_1 = require("../Validation/SchemaChanges");
+const SchemaItemMerger_1 = require("./SchemaItemMerger");
+/**
+ * @param target The Enumeration the differences get merged into
+ * @param source The Enumeration to compare
+ * @param changes Gets the @see EnumerationChanges between the two Enumerations.
+ * For example, if source Enumeration has an attribute that is undefined in
+ * target one, it would be listed in propertyValueChanges.
+ * @internal
+ */
+async function mergeEnumeration(target, source, changes) {
+    const mutableEnumeration = target;
+    await (0, SchemaItemMerger_1.mergeSchemaItemProperties)(mutableEnumeration, changes.propertyValueChanges, (item, propertyName, propertyValue) => {
+        switch (propertyName) {
+            case "isStrict": return item.setIsStrict(propertyValue);
+            case "type": {
+                const primitiveType = (0, ecschema_metadata_1.parsePrimitiveType)(propertyValue);
+                if (primitiveType && item.type !== primitiveType) {
+                    throw Error(`Merged enumeration ${item.name} types not equal: ${(0, ecschema_metadata_1.primitiveTypeToString)(item.type)} -> ${propertyValue}`);
+                }
+            }
+        }
+    });
+    for (const enumeratorChange of changes.enumeratorChanges.values()) {
+        if (enumeratorChange.enumeratorMissing?.changeType === SchemaChanges_1.ChangeType.Missing) {
+            const enumerator = source.getEnumeratorByName(enumeratorChange.ecTypeName);
+            if (enumerator === undefined) {
+                throw Error(`Enumerator '${enumeratorChange.ecTypeName}' not found in Enumeration ${source.fullName}`);
+            }
+            const result = mutableEnumeration.createEnumerator(enumerator.name, enumerator.value, enumerator.label, enumerator.description);
+            mutableEnumeration.addEnumerator(result);
+        }
+        else {
+            const targetEnumerator = target.getEnumeratorByName(enumeratorChange.ecTypeName);
+            if (targetEnumerator === undefined) {
+                throw Error(`Enumerator '${enumeratorChange.ecTypeName}' not found in Enumeration ${target.fullName}`);
+            }
+            const mutableEnumerator = targetEnumerator;
+            await mergeEnumeratorAttributes(mutableEnumerator, enumeratorChange.enumeratorDeltas, (enumerator, attributeName, deltaChange, attributeValue) => {
+                switch (attributeName) {
+                    case "label": {
+                        enumerator.label = attributeValue;
+                        return;
+                    }
+                    case "description": {
+                        enumerator.description = attributeValue;
+                        return;
+                    }
+                    case "value": {
+                        throw Error(`Failed to merge enumerator attribute, ${deltaChange} in ${enumerator.name}`);
+                    }
+                }
+            });
+        }
+    }
+}
+exports.default = mergeEnumeration;
+/**
+ * Similar logic to mergeSchemaItemProperties but for EnumeratorDelta, which has the differences starting at index 1,
+ * hence the .slice(1), this is the main difference between mergeSchemaItemProperties.
+ * @param targetEnumerator The enumerator the differences get merged into.
+ * @param changes Gets the @see EnumeratorDelta, the Enumerator delta array holds information about changes between two Enumerators.
+ * @param handler Defines the information needed to merge the attributes.
+ * @internal
+ */
+async function mergeEnumeratorAttributes(targetEnumerator, changes, handler) {
+    for (let index = 0, stepUp = true; index < changes.length; stepUp && index++, stepUp = true) {
+        const deltaChange = changes[index].toString(); // this will be useful for error message.
+        const [attributeName, attributeValue] = changes[index].diagnostic.messageArgs.slice(1); // messageArgs[0] seems to be an object, need to get to the next one, slice to start at index 1
+        if (handler(targetEnumerator, attributeName, deltaChange, attributeValue) === true) {
+            changes.splice(index, 1);
+            stepUp = false;
+        }
+    }
+}
+//# sourceMappingURL=EnumerationMerger.js.map

package/lib/cjs/Merging/EnumerationMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnumerationMerger.js","sourceRoot":"","sources":["../../../src/Merging/EnumerationMerger.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 { AnyEnumerator, Enumeration, parsePrimitiveType, primitiveTypeToString } from \"@itwin/ecschema-metadata\";\r\nimport { ChangeType, EnumerationChanges, EnumeratorDelta } from \"../Validation/SchemaChanges\";\r\nimport { mergeSchemaItemProperties } from \"./SchemaItemMerger\";\r\nimport { MutableEnumeration } from \"../Editing/Mutable/MutableEnumeration\";\r\n\r\n/**\r\n * @internal\r\n * @param item Type Enumerator, the Enumerator the differences get merged into.\r\n * @param attributeName Name of the Enumerator attribute that changed.\r\n * @param deltaChange Provides information about the changes in Enumerator attributes.\r\n * @param attributeValue The value that gets merged into the Enumerator attribute.\r\n */\r\ntype EnumeratorAttributeChanged<TEnumerator extends AnyEnumerator> = (item: TEnumerator, attributeName: string, deltaChange: string, attributeValue: any) => void | boolean;\r\n\r\n/**\r\n * Simple interface to extend access Enumerator attributes\r\n * and allow editing.\r\n */\r\ninterface MutableEnumerator extends AnyEnumerator {\r\n  label?: string;\r\n  description?: string;\r\n}\r\n\r\n/**\r\n * @param target The Enumeration the differences get merged into\r\n * @param source The Enumeration to compare\r\n * @param changes Gets the @see EnumerationChanges between the two Enumerations.\r\n * For example, if source Enumeration has an attribute that is undefined in\r\n * target one, it would be listed in propertyValueChanges.\r\n * @internal\r\n */\r\nexport default async function mergeEnumeration(target: Enumeration, source: Enumeration, changes: EnumerationChanges) {\r\n  const mutableEnumeration = target as MutableEnumeration;\r\n\r\n  await mergeSchemaItemProperties(mutableEnumeration, changes.propertyValueChanges, (item, propertyName, propertyValue) => {\r\n    switch (propertyName) {\r\n      case \"isStrict\": return item.setIsStrict(propertyValue);\r\n      case \"type\": {\r\n        const primitiveType = parsePrimitiveType(propertyValue);\r\n        if (primitiveType && item.type !== primitiveType) {\r\n          throw Error(`Merged enumeration ${item.name} types not equal: ${primitiveTypeToString(item.type!)} -> ${propertyValue}`);\r\n        }\r\n      }\r\n    }\r\n  });\r\n\r\n  for (const enumeratorChange of changes.enumeratorChanges.values()) {\r\n    if (enumeratorChange.enumeratorMissing?.changeType === ChangeType.Missing) {\r\n      const enumerator = source.getEnumeratorByName(enumeratorChange.ecTypeName);\r\n      if (enumerator === undefined) {\r\n        throw Error(`Enumerator '${enumeratorChange.ecTypeName}' not found in Enumeration ${source.fullName}`);\r\n      }\r\n      const result = mutableEnumeration.createEnumerator(enumerator.name, enumerator.value, enumerator.label, enumerator.description);\r\n      mutableEnumeration.addEnumerator(result);\r\n    } else {\r\n      const targetEnumerator = target.getEnumeratorByName(enumeratorChange.ecTypeName);\r\n      if (targetEnumerator === undefined) {\r\n        throw Error(`Enumerator '${enumeratorChange.ecTypeName}' not found in Enumeration ${target.fullName}`);\r\n      }\r\n      const mutableEnumerator = targetEnumerator as MutableEnumerator;\r\n      await mergeEnumeratorAttributes(mutableEnumerator, enumeratorChange.enumeratorDeltas, (enumerator, attributeName, deltaChange, attributeValue) => {\r\n        switch (attributeName) {\r\n          case \"label\": {\r\n            enumerator.label = attributeValue;\r\n            return;\r\n          }\r\n          case \"description\": {\r\n            enumerator.description = attributeValue;\r\n            return;\r\n          }\r\n          case \"value\": {\r\n            throw Error(`Failed to merge enumerator attribute, ${deltaChange} in ${enumerator.name}`);\r\n          }\r\n        }\r\n      });\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Similar logic to mergeSchemaItemProperties but for EnumeratorDelta, which has the differences starting at index 1,\r\n * hence the .slice(1), this is the main difference between mergeSchemaItemProperties.\r\n * @param targetEnumerator The enumerator the differences get merged into.\r\n * @param changes Gets the @see EnumeratorDelta, the Enumerator delta array holds information about changes between two Enumerators.\r\n * @param handler Defines the information needed to merge the attributes.\r\n * @internal\r\n */\r\nasync function mergeEnumeratorAttributes<T extends AnyEnumerator>(targetEnumerator: T, changes: EnumeratorDelta[], handler: EnumeratorAttributeChanged<T>) {\r\n  for (let index = 0, stepUp = true; index < changes.length; stepUp && index++, stepUp = true) {\r\n    const deltaChange = changes[index].toString(); // this will be useful for error message.\r\n    const [attributeName, attributeValue] = changes[index].diagnostic.messageArgs!.slice(1); // messageArgs[0] seems to be an object, need to get to the next one, slice to start at index 1\r\n    if (handler(targetEnumerator, attributeName, deltaChange, attributeValue) === true) {\r\n      changes.splice(index, 1);\r\n      stepUp = false;\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/Merging/PhenomenonMerger.d.ts

@@ -0,0 +1,7 @@
+import { Phenomenon } from "@itwin/ecschema-metadata";
+import { SchemaItemChanges } from "../Validation/SchemaChanges";
+/**
+ * @internal
+ */
+export default function mergePhenomenon(target: Phenomenon, source: Phenomenon, _changes?: SchemaItemChanges): Promise<void>;
+//# sourceMappingURL=PhenomenonMerger.d.ts.map

package/lib/cjs/Merging/PhenomenonMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhenomenonMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/PhenomenonMerger.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;GAEG;AACH,wBAA8B,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,iBAAiB,iBAQjH"}

package/lib/cjs/Merging/PhenomenonMerger.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @internal
+ */
+async function mergePhenomenon(target, source, _changes) {
+    const mutablePhenomenon = target;
+    if (mutablePhenomenon.definition === "") {
+        await mutablePhenomenon.setDefinition(source.definition);
+    }
+    else {
+        throw Error(`Failed to merge schemas, definition attribute conflict: ${source.definition} -> ${target.definition}`);
+    }
+}
+exports.default = mergePhenomenon;
+//# sourceMappingURL=PhenomenonMerger.js.map

package/lib/cjs/Merging/PhenomenonMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhenomenonMerger.js","sourceRoot":"","sources":["../../../src/Merging/PhenomenonMerger.ts"],"names":[],"mappings":";;AAQA;;GAEG;AACY,KAAK,UAAU,eAAe,CAAC,MAAkB,EAAE,MAAkB,EAAE,QAA4B;IAChH,MAAM,iBAAiB,GAAG,MAA2B,CAAC;IAEtD,IAAG,iBAAiB,CAAC,UAAU,KAAK,EAAE,EAAC;QACrC,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;KAC1D;SAAI;QACH,MAAM,KAAK,CAAC,2DAA2D,MAAM,CAAC,UAAU,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;KACrH;AACH,CAAC;AARD,kCAQC","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 { Phenomenon } from \"@itwin/ecschema-metadata\";\r\nimport { SchemaItemChanges } from \"../Validation/SchemaChanges\";\r\nimport { MutablePhenomenon } from \"../Editing/Mutable/MutablePhenomenon\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport default async function mergePhenomenon(target: Phenomenon, source: Phenomenon, _changes?: SchemaItemChanges) {\r\n  const mutablePhenomenon = target as MutablePhenomenon;\r\n\r\n  if(mutablePhenomenon.definition === \"\"){\r\n    await mutablePhenomenon.setDefinition(source.definition);\r\n  }else{\r\n    throw Error(`Failed to merge schemas, definition attribute conflict: ${source.definition} -> ${target.definition}`);\r\n  }\r\n}\r\n"]}

package/lib/cjs/Merging/PropertyCategoryMerger.d.ts

@@ -0,0 +1,7 @@
+import { PropertyCategory } from "@itwin/ecschema-metadata";
+import { SchemaItemChanges } from "../Validation/SchemaChanges";
+/**
+ * @internal
+ */
+export default function mergePropertyCategory(target: PropertyCategory, _source: PropertyCategory, changes: SchemaItemChanges): Promise<void>;
+//# sourceMappingURL=PropertyCategoryMerger.d.ts.map

package/lib/cjs/Merging/PropertyCategoryMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyCategoryMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/PropertyCategoryMerger.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;GAEG;AACH,wBAA8B,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,iBAOlI"}

package/lib/cjs/Merging/PropertyCategoryMerger.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const SchemaItemMerger_1 = require("./SchemaItemMerger");
+/**
+ * @internal
+ */
+async function mergePropertyCategory(target, _source, changes) {
+    const mutablePropertyCategory = target;
+    await (0, SchemaItemMerger_1.mergeSchemaItemProperties)(mutablePropertyCategory, changes.propertyValueChanges, (item, propertyName, propertyValue) => {
+        switch (propertyName) {
+            case "priority": return item.setPriority(propertyValue);
+        }
+    });
+}
+exports.default = mergePropertyCategory;
+//# sourceMappingURL=PropertyCategoryMerger.js.map

package/lib/cjs/Merging/PropertyCategoryMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyCategoryMerger.js","sourceRoot":"","sources":["../../../src/Merging/PropertyCategoryMerger.ts"],"names":[],"mappings":";;AAOA,yDAA+D;AAE/D;;GAEG;AACY,KAAK,UAAU,qBAAqB,CAAC,MAAwB,EAAE,OAAyB,EAAE,OAA0B;IACjI,MAAM,uBAAuB,GAAG,MAAiC,CAAC;IAClE,MAAM,IAAA,4CAAyB,EAAC,uBAAuB,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE;QAC3H,QAAO,YAAY,EAAE;YACnB,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;SACzD;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAPD,wCAOC","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 { PropertyCategory } from \"@itwin/ecschema-metadata\";\r\nimport { MutablePropertyCategory } from \"../Editing/Mutable/MutablePropertyCategory\";\r\nimport { SchemaItemChanges } from \"../Validation/SchemaChanges\";\r\nimport { mergeSchemaItemProperties } from \"./SchemaItemMerger\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport default async function mergePropertyCategory(target: PropertyCategory, _source: PropertyCategory, changes: SchemaItemChanges) {\r\n  const mutablePropertyCategory = target as MutablePropertyCategory;\r\n  await mergeSchemaItemProperties(mutablePropertyCategory, changes.propertyValueChanges, (item, propertyName, propertyValue) => {\r\n    switch(propertyName) {\r\n      case \"priority\": return item.setPriority(propertyValue);\r\n    }\r\n  });\r\n}\r\n"]}

package/lib/cjs/Merging/SchemaItemFactory.d.ts

@@ -0,0 +1,8 @@
+import { Schema, SchemaItem } from "@itwin/ecschema-metadata";
+/**
+ * @internal
+ */
+export declare namespace SchemaItemFactory {
+    function create(targetSchema: Schema, template: SchemaItem): Promise<SchemaItem>;
+}
+//# sourceMappingURL=SchemaItemFactory.d.ts.map

package/lib/cjs/Merging/SchemaItemFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaItemFactory.d.ts","sourceRoot":"","sources":["../../../src/Merging/SchemaItemFactory.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0F,MAAM,EAAE,UAAU,EAA2B,MAAM,0BAA0B,CAAC;AAE/K;;GAEG;AACH,yBAAiB,iBAAiB,CAAC;IAEjC,SAAsB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB5F;CAKF"}

package/lib/cjs/Merging/SchemaItemFactory.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaItemFactory = void 0;
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+/**
+ * @internal
+ */
+var SchemaItemFactory;
+(function (SchemaItemFactory) {
+    async function create(targetSchema, template) {
+        if (is(template, ecschema_metadata_1.Enumeration))
+            return new ecschema_metadata_1.Enumeration(targetSchema, template.name, template.type);
+        if (is(template, ecschema_metadata_1.EntityClass))
+            return new ecschema_metadata_1.EntityClass(targetSchema, template.name, template.modifier);
+        if (is(template, ecschema_metadata_1.StructClass))
+            return new ecschema_metadata_1.StructClass(targetSchema, template.name, template.modifier);
+        if (is(template, ecschema_metadata_1.CustomAttributeClass))
+            return new ecschema_metadata_1.CustomAttributeClass(targetSchema, template.name, template.modifier);
+        if (is(template, ecschema_metadata_1.PropertyCategory))
+            return new ecschema_metadata_1.PropertyCategory(targetSchema, template.name);
+        if (is(template, ecschema_metadata_1.Phenomenon))
+            return new ecschema_metadata_1.Phenomenon(targetSchema, template.name);
+        if (is(template, ecschema_metadata_1.Constant))
+            return new ecschema_metadata_1.Constant(targetSchema, template.name);
+        if (is(template, ecschema_metadata_1.UnitSystem))
+            return new ecschema_metadata_1.UnitSystem(targetSchema, template.name);
+        throw new Error(`Unsupported Schema Item Type: ${template.constructor.name}`);
+    }
+    SchemaItemFactory.create = create;
+    function is(item, type) {
+        return item instanceof type;
+    }
+})(SchemaItemFactory = exports.SchemaItemFactory || (exports.SchemaItemFactory = {}));
+//# sourceMappingURL=SchemaItemFactory.js.map

package/lib/cjs/Merging/SchemaItemFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaItemFactory.js","sourceRoot":"","sources":["../../../src/Merging/SchemaItemFactory.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F,gEAA+K;AAE/K;;GAEG;AACH,IAAiB,iBAAiB,CA2BjC;AA3BD,WAAiB,iBAAiB;IAEzB,KAAK,UAAU,MAAM,CAAC,YAAoB,EAAE,QAAoB;QACrE,IAAI,EAAE,CAAC,QAAQ,EAAE,+BAAW,CAAC;YAC3B,OAAO,IAAI,+BAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,EAAE,CAAC,QAAQ,EAAE,+BAAW,CAAC;YAC3B,OAAO,IAAI,+BAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,EAAE,CAAC,QAAQ,EAAE,+BAAW,CAAC;YAC3B,OAAO,IAAI,+BAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,EAAE,CAAC,QAAQ,EAAE,wCAAoB,CAAC;YACpC,OAAO,IAAI,wCAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClF,IAAG,EAAE,CAAC,QAAQ,EAAE,oCAAgB,CAAC;YAC/B,OAAO,IAAI,oCAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,EAAE,CAAC,QAAQ,EAAE,8BAAU,CAAC;YAC1B,OAAO,IAAI,8BAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,EAAE,CAAC,QAAQ,EAAE,4BAAQ,CAAC;YACxB,OAAO,IAAI,4BAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,QAAQ,EAAE,8BAAU,CAAC;YAC1B,OAAO,IAAI,8BAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAErD,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhF,CAAC;IApBqB,wBAAM,SAoB3B,CAAA;IAED,SAAS,EAAE,CAAuB,IAAgB,EAAE,IAA6B;QAC/E,OAAO,IAAI,YAAY,IAAI,CAAC;IAC9B,CAAC;AACH,CAAC,EA3BgB,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QA2BjC","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 { Constant, CustomAttributeClass, EntityClass, Enumeration, Phenomenon, PropertyCategory, Schema, SchemaItem, StructClass, UnitSystem } from \"@itwin/ecschema-metadata\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport namespace SchemaItemFactory {\r\n\r\n  export async function create(targetSchema: Schema, template: SchemaItem): Promise<SchemaItem> {\r\n    if (is(template, Enumeration))\r\n      return new Enumeration(targetSchema, template.name, template.type);\r\n    if (is(template, EntityClass))\r\n      return new EntityClass(targetSchema, template.name, template.modifier);\r\n    if (is(template, StructClass))\r\n      return new StructClass(targetSchema, template.name, template.modifier);\r\n    if (is(template, CustomAttributeClass))\r\n      return new CustomAttributeClass(targetSchema, template.name, template.modifier);\r\n    if(is(template, PropertyCategory))\r\n      return new PropertyCategory(targetSchema, template.name);\r\n    if (is(template, Phenomenon))\r\n      return new Phenomenon(targetSchema, template.name);\r\n    if (is(template, Constant))\r\n      return new Constant(targetSchema, template.name);\r\n    if (is(template, UnitSystem))\r\n      return new UnitSystem(targetSchema, template.name);\r\n\r\n    throw new Error(`Unsupported Schema Item Type: ${template.constructor.name}`);\r\n\r\n  }\r\n\r\n  function is<T extends SchemaItem>(item: SchemaItem, type: new (...args: any) => T ): item is T {\r\n    return item instanceof type;\r\n  }\r\n}\r\n"]}

package/lib/cjs/Merging/SchemaItemMerger.d.ts

@@ -0,0 +1,31 @@
+import { Schema, SchemaItem } from "@itwin/ecschema-metadata";
+import { PropertyValueChange, SchemaItemChanges } from "../Validation/SchemaChanges";
+import { SchemaMergeContext } from "./SchemaMerger";
+type SchemaItemMergeFn<TChange extends SchemaItemChanges, TItem extends SchemaItem> = (target: TItem, source: TItem, change: TChange, context: SchemaMergeContext) => Promise<void>;
+type PropertyChangedFn<TItem extends SchemaItem> = (item: TItem, propertyName: string, propertyValue: any) => void | boolean;
+/**
+ * Merges schema items from the source in the target schema. This method applies for all schema items
+ * and handles the basic processing such as create-if-not-exists or name collisions or base property setting.
+ * @param context           The current merge context
+ * @param schemaItemChanges The schema items to be merged
+ * @param mergeFn           Merge function for complex merging.
+ * @internal
+ */
+export default function mergeSchemaItems<TChange extends SchemaItemChanges, TItem extends SchemaItem>(context: SchemaMergeContext, schemaItemChanges: Iterable<TChange>, mergeFn?: SchemaItemMergeFn<TChange, TItem>): Promise<void>;
+/**
+ * Performs the specified action for each property in the given PropertyValueChange array.
+ * @param targetItem  The target item
+ * @param changes     The array with PropertyValueChanges
+ * @param handler     The callback that gets invoked vor every change.
+ * @internal
+ */
+export declare function mergeSchemaItemProperties<T extends SchemaItem>(targetItem: T, changes: PropertyValueChange[], handler: PropertyChangedFn<T>): Promise<void>;
+/**
+ * @param source The schema item the reference gets copied from
+ * @param itemFullName Parsing through item full name give us the schema reference name and the item name, these values are needed to create a new schema item key.
+ * @returns Item referenced schema and item name.
+ * @internal
+ */
+export declare function getItemNameAndSchemaRef(source: SchemaItem, itemFullName: string): Promise<[Schema | undefined, string]>;
+export {};
+//# sourceMappingURL=SchemaItemMerger.d.ts.map

package/lib/cjs/Merging/SchemaItemMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaItemMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/SchemaItemMerger.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAc,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,KAAK,iBAAiB,CAAC,OAAO,SAAS,iBAAiB,EAAE,KAAK,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACpL,KAAK,iBAAiB,CAAC,KAAK,SAAS,UAAU,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC;AAO7H;;;;;;;GAOG;AACH,wBAA8B,gBAAgB,CAAC,OAAO,SAAS,iBAAiB,EAAE,KAAK,SAAS,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,iBA6CzN;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,SAAS,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,iBAQjJ;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC,CAI7H"}

package/lib/cjs/Merging/SchemaItemMerger.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getItemNameAndSchemaRef = exports.mergeSchemaItemProperties = void 0;
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const SchemaChanges_1 = require("../Validation/SchemaChanges");
+const SchemaItemFactory_1 = require("./SchemaItemFactory");
+class MutableSchemaItem extends ecschema_metadata_1.SchemaItem {
+}
+/**
+ * Merges schema items from the source in the target schema. This method applies for all schema items
+ * and handles the basic processing such as create-if-not-exists or name collisions or base property setting.
+ * @param context           The current merge context
+ * @param schemaItemChanges The schema items to be merged
+ * @param mergeFn           Merge function for complex merging.
+ * @internal
+ */
+async function mergeSchemaItems(context, schemaItemChanges, mergeFn) {
+    for (const change of schemaItemChanges) {
+        // Gets the source and the target item. The target item could be undefined at that point.
+        const sourceItem = (await context.sourceSchema.getItem(change.ecTypeName));
+        let targetItem = await context.targetSchema.getItem(change.ecTypeName);
+        // In case the schema item does not exists in the target schema, an instance for
+        // this schema item is created. It's properties get set by the merger then.
+        if (change.schemaItemMissing?.changeType === SchemaChanges_1.ChangeType.Missing) {
+            // Check for name to make sure there is no collision for items with the same name
+            // but different type.
+            if (targetItem !== undefined) {
+                throw new Error(`Schema ${context.targetSchema.name} already contains a Schema Item ${change.ecTypeName}.`);
+            }
+            // TODO: Think about renaming the Schema Item. This could be controlled though a flag.
+            const createdItem = await SchemaItemFactory_1.SchemaItemFactory.create(context.targetSchema, sourceItem);
+            context.targetSchema.addItem(targetItem = createdItem);
+        }
+        if (targetItem === undefined) {
+            throw new Error("Invalid state, targetItem must not be undefined at that point.");
+        }
+        // Sets the Schema items base properties...
+        await mergeSchemaItemProperties(targetItem, change.propertyValueChanges, (item, propertyName, propertyValue) => {
+            const mutableSchemaItem = item;
+            switch (propertyName) {
+                case "label":
+                    mutableSchemaItem.setDisplayLabel(propertyValue);
+                    return true;
+                case "description":
+                    mutableSchemaItem.setDescription(propertyValue);
+                    return true;
+                case "schemaItemType":
+                    return true;
+            }
+            return;
+        });
+        if (mergeFn)
+            await mergeFn(targetItem, sourceItem, change, context);
+    }
+}
+exports.default = mergeSchemaItems;
+/**
+ * Performs the specified action for each property in the given PropertyValueChange array.
+ * @param targetItem  The target item
+ * @param changes     The array with PropertyValueChanges
+ * @param handler     The callback that gets invoked vor every change.
+ * @internal
+ */
+async function mergeSchemaItemProperties(targetItem, changes, handler) {
+    for (let index = 0, increment = true; index < changes.length; increment && index++, increment = true) {
+        const [propertyName, propertyValue] = changes[index].diagnostic.messageArgs;
+        if (handler(targetItem, propertyName, propertyValue) === true) {
+            changes.splice(index, 1);
+            increment = false;
+        }
+    }
+}
+exports.mergeSchemaItemProperties = mergeSchemaItemProperties;
+/**
+ * @param source The schema item the reference gets copied from
+ * @param itemFullName Parsing through item full name give us the schema reference name and the item name, these values are needed to create a new schema item key.
+ * @returns Item referenced schema and item name.
+ * @internal
+ */
+async function getItemNameAndSchemaRef(source, itemFullName) {
+    const [schemaName, itemName] = ecschema_metadata_1.SchemaItem.parseFullName(itemFullName);
+    const refSchema = await source.schema.getReference(schemaName);
+    return [refSchema, itemName];
+}
+exports.getItemNameAndSchemaRef = getItemNameAndSchemaRef;
+//# sourceMappingURL=SchemaItemMerger.js.map

package/lib/cjs/Merging/SchemaItemMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaItemMerger.js","sourceRoot":"","sources":["../../../src/Merging/SchemaItemMerger.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 { Schema, SchemaItem } from \"@itwin/ecschema-metadata\";\r\nimport { ChangeType, PropertyValueChange, SchemaItemChanges } from \"../Validation/SchemaChanges\";\r\nimport { MutableSchema } from \"../Editing/Mutable/MutableSchema\";\r\nimport { SchemaItemFactory } from \"./SchemaItemFactory\";\r\nimport { SchemaMergeContext } from \"./SchemaMerger\";\r\n\r\ntype SchemaItemMergeFn<TChange extends SchemaItemChanges, TItem extends SchemaItem> = (target: TItem, source: TItem, change: TChange, context: SchemaMergeContext) => Promise<void>;\r\ntype PropertyChangedFn<TItem extends SchemaItem> = (item: TItem, propertyName: string, propertyValue: any) => void | boolean;\r\n\r\nabstract class MutableSchemaItem extends SchemaItem{\r\n  public abstract override setDisplayLabel(displayLabel: string): void;\r\n  public abstract override setDescription(description: string): void;\r\n}\r\n\r\n/**\r\n * Merges schema items from the source in the target schema. This method applies for all schema items\r\n * and handles the basic processing such as create-if-not-exists or name collisions or base property setting.\r\n * @param context           The current merge context\r\n * @param schemaItemChanges The schema items to be merged\r\n * @param mergeFn           Merge function for complex merging.\r\n * @internal\r\n */\r\nexport default async function mergeSchemaItems<TChange extends SchemaItemChanges, TItem extends SchemaItem>(context: SchemaMergeContext, schemaItemChanges: Iterable<TChange>, mergeFn?: SchemaItemMergeFn<TChange, TItem>) {\r\n  for(const change of schemaItemChanges) {\r\n\r\n    // Gets the source and the target item. The target item could be undefined at that point.\r\n    const sourceItem = (await context.sourceSchema.getItem<TItem>(change.ecTypeName))!;\r\n    let targetItem = await context.targetSchema.getItem<TItem>(change.ecTypeName);\r\n\r\n    // In case the schema item does not exists in the target schema, an instance for\r\n    // this schema item is created. It's properties get set by the merger then.\r\n    if(change.schemaItemMissing?.changeType === ChangeType.Missing) {\r\n      // Check for name to make sure there is no collision for items with the same name\r\n      // but different type.\r\n      if(targetItem !== undefined) {\r\n        throw new Error(`Schema ${context.targetSchema.name} already contains a Schema Item ${change.ecTypeName}.`);\r\n      }\r\n\r\n      // TODO: Think about renaming the Schema Item. This could be controlled though a flag.\r\n\r\n      const createdItem = await SchemaItemFactory.create(context.targetSchema, sourceItem) as TItem;\r\n      (context.targetSchema as MutableSchema).addItem(targetItem = createdItem);\r\n    }\r\n\r\n    if(targetItem === undefined) {\r\n      throw new Error(\"Invalid state, targetItem must not be undefined at that point.\");\r\n    }\r\n\r\n    // Sets the Schema items base properties...\r\n    await mergeSchemaItemProperties(targetItem, change.propertyValueChanges, (item, propertyName, propertyValue) => {\r\n      const mutableSchemaItem = item as unknown as MutableSchemaItem;\r\n      switch(propertyName) {\r\n        case \"label\":\r\n          mutableSchemaItem.setDisplayLabel(propertyValue);\r\n          return true;\r\n        case \"description\":\r\n          mutableSchemaItem.setDescription(propertyValue);\r\n          return true;\r\n        case \"schemaItemType\":\r\n          return true;\r\n      }\r\n      return;\r\n    });\r\n\r\n    if (mergeFn)\r\n      await mergeFn(targetItem, sourceItem, change, context);\r\n  }\r\n}\r\n\r\n/**\r\n * Performs the specified action for each property in the given PropertyValueChange array.\r\n * @param targetItem  The target item\r\n * @param changes     The array with PropertyValueChanges\r\n * @param handler     The callback that gets invoked vor every change.\r\n * @internal\r\n */\r\nexport async function mergeSchemaItemProperties<T extends SchemaItem>(targetItem: T, changes: PropertyValueChange[], handler: PropertyChangedFn<T>) {\r\n  for(let index = 0, increment = true; index < changes.length; increment && index++, increment = true) {\r\n    const [propertyName, propertyValue] = changes[index].diagnostic.messageArgs!;\r\n    if(handler(targetItem, propertyName, propertyValue) === true) {\r\n      changes.splice(index, 1);\r\n      increment = false;\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * @param source The schema item the reference gets copied from\r\n * @param itemFullName Parsing through item full name give us the schema reference name and the item name, these values are needed to create a new schema item key.\r\n * @returns Item referenced schema and item name.\r\n * @internal\r\n */\r\nexport async function getItemNameAndSchemaRef(source: SchemaItem, itemFullName: string): Promise<[Schema | undefined, string]> {\r\n  const [schemaName, itemName] = SchemaItem.parseFullName(itemFullName);\r\n  const refSchema = await source.schema.getReference(schemaName);\r\n  return [refSchema, itemName];\r\n}\r\n"]}

package/lib/cjs/Merging/SchemaMerger.d.ts

@@ -0,0 +1,36 @@
+/** @packageDocumentation
+ * @module Merging
+ */
+import { Schema } from "@itwin/ecschema-metadata";
+/**
+ * Defines the context of a Schema merging run.
+ * @beta
+ */
+export interface SchemaMergeContext {
+    readonly targetSchema: Schema;
+    readonly sourceSchema: Schema;
+}
+/**
+ * Class to merge two schemas together.
+ * @see [[merge]] to merge the schemas.
+ * @beta
+ */
+export declare class SchemaMerger {
+    /**
+     * Gets the @see SchemaChanges between the two given Schemas from perspective of the source
+     * to the target schema. For example if source contains a class which does not exists in the
+     * target one, it would be listed as missing.
+     * @param targetSchema  The schema the differences gets merged into.
+     * @param sourceSchema  The schema to compare.
+     * @returns             An instance of @see SchemaChanges between the two schemas.
+     */
+    private getSchemaChanges;
+    /**
+     * Copy the SchemaItems of the source schemas to the target schema.
+     * @param targetSchema  The schema the SchemaItems gets merged to.
+     * @param sourceSchema  The schema the SchemaItems gets copied from.
+     * @returns             The merged target schema.
+     */
+    merge(targetSchema: Schema, sourceSchema: Schema): Promise<Schema>;
+}
+//# sourceMappingURL=SchemaMerger.d.ts.map

package/lib/cjs/Merging/SchemaMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/SchemaMerger.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAkB,MAAM,0BAA0B,CAAC;AAalE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB;;;;;;;OAOG;YACW,gBAAgB;IAa9B;;;;;OAKG;IACU,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAmChF"}