@itwin/imodel-transformer 2.0.0-dev.43 → 2.0.0-dev.44

package/lib/cjs/schema-processing/SchemaProcessingCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProcessingCoordinator.js","sourceRoot":"","sources":["../../../src/schema-processing/SchemaProcessingCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport * as path from \"node:path\";\nimport { ITwinError } from \"@itwin/core-bentley\";\nimport { ECSchemaXmlContext, IModelDb, IModelJsFs } from \"@itwin/core-backend\";\nimport { Schema, SchemaKey, SchemaLoader } from \"@itwin/ecschema-metadata\";\nimport { ExportSchemaResult, IModelExporter } from \"../IModelExporter\";\nimport {\n  IModelTransformerError,\n  IModelTransformerErrorScope,\n} from \"../IModelTransformerError\";\nimport {\n  ReadonlySchemaAccessor,\n  SchemaProcessingResult,\n  SchemaProcessingStrategy,\n} from \"./SchemaProcessingStrategy\";\n\ninterface SchemaProcessingCoordinatorArgs {\n  exporter: IModelExporter;\n  targetDb: IModelDb;\n  getSchemaExportDirectory: () => string;\n  shouldExportSchema: (schemaKey: SchemaKey) => Promise<boolean>;\n  serializeSourceSchema: (schema: Schema) => Promise<void | ExportSchemaResult>;\n}\n\n/** @internal */\nexport class SchemaProcessingCoordinator {\n  private readonly _longNamedSchemas = new Map<string, string>();\n\n  public constructor(private readonly _args: SchemaProcessingCoordinatorArgs) {}\n\n  public async process(strategy: SchemaProcessingStrategy): Promise<void> {\n    let processingFailure: unknown;\n    try {\n      IModelJsFs.mkdirSync(this._schemaExportDirectory);\n      this._longNamedSchemas.clear();\n\n      const sourceSchemas: Schema[] = [];\n      for await (const schema of this._args.exporter.enumerateSchemas()) {\n        sourceSchemas.push(schema);\n      }\n      const targetSchemaLoader = new SchemaLoader((name) =>\n        this._args.targetDb.getSchemaProps(name)\n      );\n      const targetSchemas: ReadonlySchemaAccessor = {\n        getSchema: async (schemaName) =>\n          targetSchemaLoader.tryGetSchema(schemaName),\n      };\n      const processedSchemas = await strategy.processSchemas({\n        sourceSchemas: orderSchemasByDependencies(sourceSchemas),\n        targetSchemas,\n        shouldExportSchema: this._args.shouldExportSchema,\n      });\n\n      for (const result of processedSchemas) {\n        await this.serializeSchema(result);\n      }\n      const exportedSchemaFiles = IModelJsFs.readdirSync(\n        this._schemaExportDirectory\n      );\n      if (exportedSchemaFiles.length > 0) {\n        await this._args.targetDb.importSchemas(\n          exportedSchemaFiles.map((fileName) =>\n            path.join(this._schemaExportDirectory, fileName)\n          ),\n          {\n            ecSchemaXmlContext:\n              this._longNamedSchemas.size > 0\n                ? this.createLongNameResolvingSchemaContext()\n                : undefined,\n          }\n        );\n      }\n    } catch (error: unknown) {\n      processingFailure = error;\n    }\n\n    let cleanupFailure: unknown;\n    try {\n      IModelJsFs.removeSync(this._schemaExportDirectory);\n    } catch (error: unknown) {\n      cleanupFailure = error;\n    } finally {\n      this._longNamedSchemas.clear();\n    }\n\n    if (processingFailure !== undefined && cleanupFailure !== undefined) {\n      throw new AggregateError(\n        [processingFailure, cleanupFailure],\n        \"Schema processing and cleanup failed\",\n        { cause: processingFailure }\n      );\n    }\n    // Preserve failures from custom strategies and upstream libraries exactly.\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    if (processingFailure !== undefined) throw processingFailure;\n    // eslint-disable-next-line @typescript-eslint/only-throw-error\n    if (cleanupFailure !== undefined) throw cleanupFailure;\n  }\n\n  public async serializeSourceSchema(\n    schema: Schema\n  ): Promise<ExportSchemaResult> {\n    const schemaFileName = this.getSchemaExportFileName(schema.name);\n    this._args.exporter.sourceDb.exportSchema({\n      schemaName: schema.name,\n      outputDirectory: this._schemaExportDirectory,\n      outputFileName: schemaFileName,\n    });\n    return {\n      schemaPath: path.join(this._schemaExportDirectory, schemaFileName),\n    };\n  }\n\n  private get _schemaExportDirectory(): string {\n    return this._args.getSchemaExportDirectory();\n  }\n\n  private async serializeSchema(result: SchemaProcessingResult): Promise<void> {\n    if (result.kind === \"source\") {\n      await this._args.serializeSourceSchema(result.schema);\n      return;\n    }\n\n    const schemaLocaters = await import(\"@itwin/ecschema-locaters\");\n    const schemaFileName = this.getSchemaExportFileName(result.schema.name);\n    const schemaXml = await schemaLocaters.SchemaXml.writeString(result.schema);\n    IModelJsFs.writeFileSync(\n      path.join(this._schemaExportDirectory, schemaFileName),\n      schemaXml\n    );\n  }\n\n  private getSchemaExportFileName(schemaName: string): string {\n    const extension = \".ecschema.xml\";\n    let schemaFileName = schemaName + extension;\n    const systemMaxPathSegmentSize = 255;\n    const windowsMaxPathLimit = 260;\n    if (\n      schemaFileName.length > systemMaxPathSegmentSize ||\n      path.join(this._schemaExportDirectory, schemaFileName).length >=\n        windowsMaxPathLimit\n    ) {\n      schemaFileName = `${schemaName.slice(0, 100)}${\n        this._longNamedSchemas.size\n      }${extension}`;\n      this._longNamedSchemas.set(schemaName, schemaFileName);\n    }\n    return schemaFileName;\n  }\n\n  private createLongNameResolvingSchemaContext(): ECSchemaXmlContext {\n    const context = new ECSchemaXmlContext();\n    context.setSchemaLocater((key) => {\n      const schemaFileName = this._longNamedSchemas.get(key.name);\n      return schemaFileName === undefined\n        ? undefined\n        : path.join(this._schemaExportDirectory, schemaFileName);\n    });\n    return context;\n  }\n}\n\ninterface SchemaDependencyCycleError extends ITwinError {\n  schemaNames: readonly string[];\n}\n\nfunction orderSchemasByDependencies(schemas: Schema[]): Schema[] {\n  const schemasByName = new Map(\n    schemas.map((schema) => [schema.name.toLowerCase(), schema])\n  );\n  const state = new Map<string, \"visiting\" | \"visited\">();\n  const orderedSchemas: Schema[] = [];\n  const stack: string[] = [];\n\n  const visit = (schema: Schema): void => {\n    const schemaName = schema.name.toLowerCase();\n    const currentState = state.get(schemaName);\n    if (currentState === \"visited\") return;\n    if (currentState === \"visiting\") {\n      const cycleStart = stack.indexOf(schemaName);\n      const schemaNames = stack.slice(cycleStart);\n      throw ITwinError.create<SchemaDependencyCycleError>({\n        message: `Schema dependency cycle detected: ${[\n          ...schemaNames,\n          schemaName,\n        ].join(\" -> \")}`,\n        iTwinErrorId: {\n          scope: IModelTransformerErrorScope,\n          key: IModelTransformerError.SchemaDependencyCycle,\n        },\n        schemaNames,\n      });\n    }\n\n    state.set(schemaName, \"visiting\");\n    stack.push(schemaName);\n    for (const reference of schema.references) {\n      const referencedSchema = schemasByName.get(reference.name.toLowerCase());\n      if (referencedSchema !== undefined) visit(referencedSchema);\n    }\n    stack.pop();\n    state.set(schemaName, \"visited\");\n    orderedSchemas.push(schema);\n  };\n\n  for (const schema of schemas) visit(schema);\n  return orderedSchemas;\n}\n"]}

package/lib/cjs/schema-processing/SchemaProcessingStrategy.d.ts

@@ -0,0 +1,59 @@
+/** @packageDocumentation
+ * @module iModels
+ */
+import { Schema, SchemaKey } from "@itwin/ecschema-metadata";
+/**
+ * The result of processing one schema.
+ * @beta
+ */
+export type SchemaProcessingResult = {
+    kind: "source";
+    schema: Schema;
+} | {
+    kind: "generated";
+    schema: Schema;
+};
+/** Read-only access to schemas already present in the target iModel.
+ * @beta
+ */
+export interface ReadonlySchemaAccessor {
+    /** Load a target schema by name, or return `undefined` when it is absent. */
+    getSchema(schemaName: string): Promise<Schema | undefined>;
+}
+/**
+ * Context supplied to a [[SchemaProcessingStrategy]].
+ * @beta
+ */
+export interface SchemaProcessingContext {
+    /** Source schemas in dependency order. */
+    readonly sourceSchemas: readonly Schema[];
+    /** Read-only access to schemas already present in the target. */
+    readonly targetSchemas: ReadonlySchemaAccessor;
+    /** The schema-selection hook used by the default transformer path. */
+    readonly shouldExportSchema: (schemaKey: SchemaKey) => Promise<boolean>;
+}
+/**
+ * Selects source schemas and produces definitions for import into a target iModel.
+ * @beta
+ */
+export interface SchemaProcessingStrategy {
+    /** Select source schemas and produce definitions for import into the target iModel. */
+    processSchemas(context: SchemaProcessingContext): Promise<SchemaProcessingResult[]>;
+}
+/**
+ * Options for [[IModelTransformer.processSchemas]].
+ * @beta
+ */
+export interface ProcessSchemasOptions {
+    /** Strategy used to select and process source schemas. */
+    strategy?: SchemaProcessingStrategy;
+}
+/**
+ * Selects source schemas that are absent from the target or have a newer version.
+ * @beta
+ */
+export declare class NewerVersionSchemaImportStrategy implements SchemaProcessingStrategy {
+    /** Select schemas that are absent from the target or have a newer version. */
+    processSchemas(context: SchemaProcessingContext): Promise<SchemaProcessingResult[]>;
+}
+//# sourceMappingURL=SchemaProcessingStrategy.d.ts.map

package/lib/cjs/schema-processing/SchemaProcessingStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProcessingStrategy.d.ts","sourceRoot":"","sources":["../../../src/schema-processing/SchemaProcessingStrategy.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,sEAAsE;IACtE,QAAQ,CAAC,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,cAAc,CACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,wBAAwB,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,gCACX,YAAW,wBAAwB;IAEnC,8EAA8E;IACjE,cAAc,CACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,EAAE,CAAC;CASrC"}

package/lib/cjs/schema-processing/SchemaProcessingStrategy.js

@@ -0,0 +1,28 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module iModels
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewerVersionSchemaImportStrategy = void 0;
+/**
+ * Selects source schemas that are absent from the target or have a newer version.
+ * @beta
+ */
+class NewerVersionSchemaImportStrategy {
+    /** Select schemas that are absent from the target or have a newer version. */
+    async processSchemas(context) {
+        const results = [];
+        for (const schema of context.sourceSchemas) {
+            if (await context.shouldExportSchema(schema.schemaKey)) {
+                results.push({ kind: "source", schema });
+            }
+        }
+        return results;
+    }
+}
+exports.NewerVersionSchemaImportStrategy = NewerVersionSchemaImportStrategy;
+//# sourceMappingURL=SchemaProcessingStrategy.js.map

package/lib/cjs/schema-processing/SchemaProcessingStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaProcessingStrategy.js","sourceRoot":"","sources":["../../../src/schema-processing/SchemaProcessingStrategy.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAqDH;;;GAGG;AACH,MAAa,gCAAgC;IAG3C,8EAA8E;IACvE,KAAK,CAAC,cAAc,CACzB,OAAgC;QAEhC,MAAM,OAAO,GAA6B,EAAE,CAAC;QAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3C,IAAI,MAAM,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAfD,4EAeC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { Schema, SchemaKey } from \"@itwin/ecschema-metadata\";\n\n/**\n * The result of processing one schema.\n * @beta\n */\nexport type SchemaProcessingResult =\n  | { kind: \"source\"; schema: Schema }\n  | { kind: \"generated\"; schema: Schema };\n\n/** Read-only access to schemas already present in the target iModel.\n * @beta\n */\nexport interface ReadonlySchemaAccessor {\n  /** Load a target schema by name, or return `undefined` when it is absent. */\n  getSchema(schemaName: string): Promise<Schema | undefined>;\n}\n\n/**\n * Context supplied to a [[SchemaProcessingStrategy]].\n * @beta\n */\nexport interface SchemaProcessingContext {\n  /** Source schemas in dependency order. */\n  readonly sourceSchemas: readonly Schema[];\n  /** Read-only access to schemas already present in the target. */\n  readonly targetSchemas: ReadonlySchemaAccessor;\n  /** The schema-selection hook used by the default transformer path. */\n  readonly shouldExportSchema: (schemaKey: SchemaKey) => Promise<boolean>;\n}\n\n/**\n * Selects source schemas and produces definitions for import into a target iModel.\n * @beta\n */\nexport interface SchemaProcessingStrategy {\n  /** Select source schemas and produce definitions for import into the target iModel. */\n  processSchemas(\n    context: SchemaProcessingContext\n  ): Promise<SchemaProcessingResult[]>;\n}\n\n/**\n * Options for [[IModelTransformer.processSchemas]].\n * @beta\n */\nexport interface ProcessSchemasOptions {\n  /** Strategy used to select and process source schemas. */\n  strategy?: SchemaProcessingStrategy;\n}\n\n/**\n * Selects source schemas that are absent from the target or have a newer version.\n * @beta\n */\nexport class NewerVersionSchemaImportStrategy\n  implements SchemaProcessingStrategy\n{\n  /** Select schemas that are absent from the target or have a newer version. */\n  public async processSchemas(\n    context: SchemaProcessingContext\n  ): Promise<SchemaProcessingResult[]> {\n    const results: SchemaProcessingResult[] = [];\n    for (const schema of context.sourceSchemas) {\n      if (await context.shouldExportSchema(schema.schemaKey)) {\n        results.push({ kind: \"source\", schema });\n      }\n    }\n    return results;\n  }\n}\n"]}

package/lib/cjs/schema-processing.d.ts

@@ -0,0 +1,7 @@
+/** @packageDocumentation
+ * Optional schema-processing strategies for `@itwin/imodel-transformer`.
+ * @module iModels
+ */
+export * from "./schema-processing/SchemaProcessingStrategy";
+export * from "./schema-processing/DynamicSchemaUnionStrategy";
+//# sourceMappingURL=schema-processing.d.ts.map

package/lib/cjs/schema-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-processing.d.ts","sourceRoot":"","sources":["../../src/schema-processing.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gDAAgD,CAAC"}

package/lib/cjs/schema-processing.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+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.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * Optional schema-processing strategies for `@itwin/imodel-transformer`.
+ * @module iModels
+ */
+__exportStar(require("./schema-processing/SchemaProcessingStrategy"), exports);
+__exportStar(require("./schema-processing/DynamicSchemaUnionStrategy"), exports);
+//# sourceMappingURL=schema-processing.js.map

package/lib/cjs/schema-processing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-processing.js","sourceRoot":"","sources":["../../src/schema-processing.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;gGAGgG;AAChG;;;GAGG;AACH,+EAA6D;AAC7D,iFAA+D","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * Optional schema-processing strategies for `@itwin/imodel-transformer`.\n * @module iModels\n */\nexport * from \"./schema-processing/SchemaProcessingStrategy\";\nexport * from \"./schema-processing/DynamicSchemaUnionStrategy\";\n"]}

package/package.json

@@ -1,9 +1,29 @@
 {
   "name": "@itwin/imodel-transformer",
-  "version": "2.0.0-dev.43",
+  "version": "2.0.0-dev.44",
   "description": "API for exporting an iModel's parts and also importing them into another iModel",
   "main": "lib/cjs/imodel-transformer.js",
-  "typings": "lib/cjs/imodel-transformer",
+  "typings": "lib/cjs/imodel-transformer.d.ts",
+  "typesVersions": {
+    "*": {
+      "schema-processing": [
+        "lib/cjs/schema-processing.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/cjs/imodel-transformer.d.ts",
+      "require": "./lib/cjs/imodel-transformer.js",
+      "default": "./lib/cjs/imodel-transformer.js"
+    },
+    "./schema-processing": {
+      "types": "./lib/cjs/schema-processing.d.ts",
+      "require": "./lib/cjs/schema-processing.js",
+      "default": "./lib/cjs/schema-processing.js"
+    },
+    "./package.json": "./package.json"
+  },
   "license": "MIT",
   "engines": {
     "node": "^22.12.0 || ^24.18.0"
@@ -18,7 +38,9 @@
     "docs:reference": "cross-env RUSHSTACK_FILE_ERROR_BASE_FOLDER='../..' betools docs --includes=../../build/docs/extract --json=../../build/docs/reference/imodel-transformer/file.json --tsIndexFile=imodel-transformer.ts --onlyJson",
     "docs:extract": "betools extract --fileExt=ts --extractFrom=./src/test --recursive --out=../../build/docs/extract",
     "cover": "vitest run --coverage",
-    "extract-api": "betools extract-api --entry=imodel-transformer --apiReportFolder=../../common/api --apiReportTempFolder=../../common/api/temp --apiSummaryFolder=../../common/api/summary",
+    "extract-api": "npm run -s extract-api:root && npm run -s extract-api:schema-processing",
+    "extract-api:root": "betools extract-api --entry=imodel-transformer --apiReportFolder=../../common/api --apiReportTempFolder=../../common/api/temp --apiSummaryFolder=../../common/api/summary",
+    "extract-api:schema-processing": "betools extract-api --entry=schema-processing --apiReportFolder=../../common/api --apiReportTempFolder=../../common/api/temp --apiSummaryFolder=../../common/api/summary",
     "lint": "eslint -f visualstudio --quiet \"./src/**/*.ts\" 1>&2",
     "lint:no-tests": "eslint -f visualstudio --quiet \"./src/*.ts\" 1>&2",
     "lint:fix": "eslint --fix -f visualstudio --quiet \"./src/**/*.ts\" 1>&2",
@@ -57,8 +79,18 @@
     "@itwin/core-common": "^5.9.1",
     "@itwin/core-geometry": "^5.9.1",
     "@itwin/core-quantity": "^5.9.1",
+    "@itwin/ecschema-editing": "^5.9.1",
+    "@itwin/ecschema-locaters": "^5.9.1",
     "@itwin/ecschema-metadata": "^5.9.1"
   },
+  "peerDependenciesMeta": {
+    "@itwin/ecschema-editing": {
+      "optional": true
+    },
+    "@itwin/ecschema-locaters": {
+      "optional": true
+    }
+  },
   "//devDependencies": [
     "NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install",
     "NOTE: All tools used by scripts in this package must be listed as devDependencies"
@@ -70,7 +102,8 @@
     "@itwin/core-common": "^5.10.3",
     "@itwin/core-geometry": "^5.10.3",
     "@itwin/core-quantity": "^5.10.3",
-    "@itwin/ecschema-locaters": "^5.9.1",
+    "@itwin/ecschema-editing": "5.10.3",
+    "@itwin/ecschema-locaters": "5.10.3",
     "@itwin/ecschema-metadata": "^5.10.3",
     "@itwin/eslint-plugin": "^5.2.1",
     "@itwin/imodel-transformer-test-utils": "0.0.0",