@itwin/core-backend 5.12.0-dev.2 → 5.12.0-dev.5

package/lib/esm/test/TestUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAkB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,mCAAmC;AACnC,MAAM,OAAO,KAAK;IACR,MAAM,CAAS;IACf,MAAM,CAAO;IACrB,YAAY,KAAa;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEM,GAAG;QACR,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAC1B,OAAO,CAAqD;IAEpE;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,uBAAuB,EAAE,CAAC;IACrE,CAAC;IAEM,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO;YACf,OAAO;QAET,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,qGAAqG;IAC9F,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACZ,MAAM,CAAC,kBAAkB;QAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,GAAG,CAAC;IACtE,CAAC;IAEM,MAAM,CAAC,WAAW,CAAC,WAA+B,SAAS;QAChE,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC,CAAC,wCAAwC;QAC5D,CAAC;QACD,OAAO,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,mDAAmD;IACxG,CAAC;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAA4D;QAC3F,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACnD,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,GAAG,CAAC,kBAAkB,KAAK,KAAK,CAAC,CAAC,8EAA8E;QAChH,GAAG,CAAC,wBAAwB,KAAK,OAAO,CAAC;QACzC,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,iBAAiB;YACpB,SAAS,CAAC,oBAAoB,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,oBAAoB;QAChC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAC5C,EAAE,IAAI,EAAE,2BAA2B,EAAE,QAAQ,EAAE,gBAAgB,CAAC,WAAW,EAAE,EAC7E,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CACzD,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,eAAe;QACjC,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAEM,MAAM,CAAC,YAAY;QACxB,IAAI,SAAS,CAAC,kBAAkB,EAAE;YAChC,MAAM,CAAC,mBAAmB,EAAE,CAAC;;YAE7B,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,KAAe;QAC/C,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1F,CAAC;IAED,sDAAsD;IACtD,2DAA2D;IACpD,MAAM,CAAC,mBAAmB;QAC/B,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,mBAAmB;QAC/B,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,IAAI,EAAE;IAChB,SAAS,CAAC,YAAY,EAAE,CAAC;IACzB,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,KAAK,IAAI,EAAE;IACf,MAAM,SAAS,CAAC,eAAe,EAAE,CAAC;AACpC,CAAC,CAAC,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\nimport * as path from \"path\";\nimport { IModelJsNative, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nimport { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelHost, IModelHostOptions } from \"../IModelHost\";\nimport { IModelNative } from \"../internal/NativePlatform\";\nimport { GeoCoordConfig } from \"../GeoCoordConfig\";\nimport { SettingsPriority } from \"../workspace/Settings\";\n\n/** Class for simple test timing */\nexport class Timer {\n  private _label: string;\n  private _start: Date;\n  constructor(label: string) {\n    this._label = `\\t${label}`;\n    this._start = new Date();\n  }\n\n  public end() {\n    const stop = new Date();\n    const elapsed = stop.getTime() - this._start.getTime();\n    // eslint-disable-next-line no-console\n    console.log(`${this._label}: ${elapsed}ms`);\n  }\n}\n\n/**\n * Disables native code assertions from firing. This can be used by tests that intentionally\n * test failing operations. If those failing operations raise assertions in native code, the test\n * would fail unexpectedly in a debug build. In that case the native code assertions can be disabled with\n * this class.\n */\nexport class DisableNativeAssertions implements Disposable {\n  private _native: IModelJsNative.DisableNativeAssertions | undefined;\n\n  constructor() {\n    this._native = new IModelNative.platform.DisableNativeAssertions();\n  }\n\n  public [Symbol.dispose](): void {\n    if (!this._native)\n      return;\n\n    this._native.dispose();\n    this._native = undefined;\n  }\n\n  /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */\n  public dispose(): void {\n    this[Symbol.dispose]();\n  }\n}\n\nexport class TestUtils {\n  private static shouldLogToConsole(): boolean {\n    return process.env.ITWINJS_CORE_BACKEND_TEST_LOG_TO_CONSOLE === \"1\";\n  }\n\n  public static getCacheDir(fallback: string | undefined = undefined) {\n    if (ProcessDetector.isMobileAppBackend) {\n      return undefined; // Let the native side handle the cache.\n    }\n    return fallback ?? path.join(__dirname, \".cache\"); // Set the cache dir to be under the lib directory.\n  }\n\n  /** Handles the startup of IModelHost for unit tests.\n   * The provided config is used and will override any of the default values used in this method.\n   *\n   * The default includes:\n   * - cacheDir = path.join(__dirname, \".cache\")\n   * - allowSharedChannel = false;\n   *\n   * GCS (Geographic Coordinate System) workspace loading is disabled by default, since unit tests\n   * should not make network requests. Pass `loadGcsWorkspaces: true` for the rare test that genuinely\n   * needs GCS data (which then belongs in the integration suite). This flag is test-only and is not\n   * forwarded to `IModelHost.startup`.\n   */\n  public static async startBackend(config?: IModelHostOptions & { loadGcsWorkspaces?: boolean }): Promise<void> {\n    const { loadGcsWorkspaces, ...cfg } = config ?? {};\n    cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);\n    cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.\n    cfg.implicitWriteEnforcement ??= \"throw\";\n    await IModelHost.startup(cfg);\n    if (!loadGcsWorkspaces)\n      TestUtils.disableGcsWorkspaces();\n  }\n\n  /**\n   * Suppress loading of Geographic Coordinate System (GCS) workspaces from cloud containers (and the\n   * network requests they issue when iModels are opened) by overriding the existing GeoCoordConfig\n   * setting. Unit tests should not make network calls; tests that genuinely require GCS data belong\n   * in the integration suite. GCS workspaces load lazily on first iModel open, so overriding the\n   * setting any time after `IModelHost.startup` is sufficient.\n   */\n  public static disableGcsWorkspaces(): void {\n    IModelHost.appWorkspace.settings.addDictionary(\n      { name: \"test-gcs-disable-override\", priority: SettingsPriority.application },\n      { [GeoCoordConfig.settingName.disableWorkspaces]: true },\n    );\n  }\n\n  public static async shutdownBackend(): Promise<void> {\n    return IModelHost.shutdown();\n  }\n\n  public static setupLogging() {\n    if (TestUtils.shouldLogToConsole())\n      Logger.initializeToConsole();\n    else\n      Logger.initialize();\n    Logger.setLevelDefault(LogLevel.Error);\n  }\n\n  private static initDebugLogLevels(reset?: boolean) {\n    Logger.setLevelDefault(reset ? LogLevel.Error : LogLevel.Warning);\n    Logger.setLevel(BentleyLoggerCategory.Performance, reset ? LogLevel.Error : LogLevel.Info);\n    Logger.setLevel(BackendLoggerCategory.IModelDb, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.DgnCore, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.BeSQLite, reset ? LogLevel.Error : LogLevel.Trace);\n  }\n\n  // Setup typical programmatic log level overrides here\n  // Convenience method used to debug specific tests/fixtures\n  public static setupDebugLogLevels() {\n    TestUtils.initDebugLogLevels(false);\n  }\n\n  public static resetDebugLogLevels() {\n    TestUtils.initDebugLogLevels(true);\n  }\n}\n\n// The very first \"before\" run to initially setup the logging and initial backend.\nbefore(async () => {\n  TestUtils.setupLogging();\n  await TestUtils.startBackend();\n});\n\nafter(async () => {\n  await TestUtils.shutdownBackend();\n});\n\n"]}
+{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.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 \"path\";\nimport { IModelJsNative, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nimport { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelHost, IModelHostOptions } from \"../IModelHost\";\nimport { IModelNative } from \"../internal/NativePlatform\";\nimport { GeoCoordConfig } from \"../GeoCoordConfig\";\nimport { SettingsPriority } from \"../workspace/Settings\";\n\n/** Class for simple test timing */\nexport class Timer {\n  private _label: string;\n  private _start: Date;\n  constructor(label: string) {\n    this._label = `\\t${label}`;\n    this._start = new Date();\n  }\n\n  public end() {\n    const stop = new Date();\n    const elapsed = stop.getTime() - this._start.getTime();\n    // eslint-disable-next-line no-console\n    console.log(`${this._label}: ${elapsed}ms`);\n  }\n}\n\n/**\n * Disables native code assertions from firing. This can be used by tests that intentionally\n * test failing operations. If those failing operations raise assertions in native code, the test\n * would fail unexpectedly in a debug build. In that case the native code assertions can be disabled with\n * this class.\n */\nexport class DisableNativeAssertions implements Disposable {\n  private _native: IModelJsNative.DisableNativeAssertions | undefined;\n\n  constructor() {\n    this._native = new IModelNative.platform.DisableNativeAssertions();\n  }\n\n  public [Symbol.dispose](): void {\n    if (!this._native)\n      return;\n\n    this._native.dispose();\n    this._native = undefined;\n  }\n\n  /** @deprecated in 5.0 - might be removed in next major version. Use [Symbol.dispose] instead. */\n  public dispose(): void {\n    this[Symbol.dispose]();\n  }\n}\n\nexport class TestUtils {\n  private static shouldLogToConsole(): boolean {\n    return process.env.ITWINJS_CORE_BACKEND_TEST_LOG_TO_CONSOLE === \"1\";\n  }\n\n  public static getCacheDir(fallback: string | undefined = undefined) {\n    if (ProcessDetector.isMobileAppBackend) {\n      return undefined; // Let the native side handle the cache.\n    }\n    return fallback ?? path.join(__dirname, \".cache\"); // Set the cache dir to be under the lib directory.\n  }\n\n  /** Handles the startup of IModelHost for unit tests.\n   * The provided config is used and will override any of the default values used in this method.\n   *\n   * The default includes:\n   * - cacheDir = path.join(__dirname, \".cache\")\n   * - allowSharedChannel = false;\n   *\n   * GCS (Geographic Coordinate System) workspace loading is disabled by default, since unit tests\n   * should not make network requests. Pass `loadGcsWorkspaces: true` for the rare test that genuinely\n   * needs GCS data (which then belongs in the integration suite). This flag is test-only and is not\n   * forwarded to `IModelHost.startup`.\n   */\n  public static async startBackend(config?: IModelHostOptions & { loadGcsWorkspaces?: boolean }): Promise<void> {\n    const { loadGcsWorkspaces, ...cfg } = config ?? {};\n    cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);\n    cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.\n    cfg.implicitWriteEnforcement ??= \"throw\";\n    await IModelHost.startup(cfg);\n    if (!loadGcsWorkspaces)\n      TestUtils.disableGcsWorkspaces();\n  }\n\n  /**\n   * Suppress loading of Geographic Coordinate System (GCS) workspaces from cloud containers (and the\n   * network requests they issue when iModels are opened) by overriding the existing GeoCoordConfig\n   * setting. Unit tests should not make network calls; tests that genuinely require GCS data belong\n   * in the integration suite. GCS workspaces load lazily on first iModel open, so overriding the\n   * setting any time after `IModelHost.startup` is sufficient.\n   */\n  public static disableGcsWorkspaces(): void {\n    IModelHost.appWorkspace.settings.addDictionary(\n      { name: \"test-gcs-disable-override\", priority: SettingsPriority.application },\n      { [GeoCoordConfig.settingName.disableWorkspaces]: true },\n    );\n  }\n\n  public static async shutdownBackend(): Promise<void> {\n    return IModelHost.shutdown();\n  }\n\n  public static setupLogging() {\n    if (TestUtils.shouldLogToConsole())\n      Logger.initializeToConsole();\n    else\n      Logger.initialize();\n    Logger.setLevelDefault(LogLevel.Error);\n  }\n\n  private static initDebugLogLevels(reset?: boolean) {\n    Logger.setLevelDefault(reset ? LogLevel.Error : LogLevel.Warning);\n    Logger.setLevel(BentleyLoggerCategory.Performance, reset ? LogLevel.Error : LogLevel.Info);\n    Logger.setLevel(BackendLoggerCategory.IModelDb, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.DgnCore, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.BeSQLite, reset ? LogLevel.Error : LogLevel.Trace);\n  }\n\n  // Setup typical programmatic log level overrides here\n  // Convenience method used to debug specific tests/fixtures\n  public static setupDebugLogLevels() {\n    TestUtils.initDebugLogLevels(false);\n  }\n\n  public static resetDebugLogLevels() {\n    TestUtils.initDebugLogLevels(true);\n  }\n}\n\n// The very first \"before\" run to initially setup the logging and initial backend.\nbefore(async () => {\n  TestUtils.setupLogging();\n  await TestUtils.startBackend();\n});\n\nafter(async () => {\n  await TestUtils.shutdownBackend();\n});\n\n"]}

package/lib/esm/test/standalone/SettingsSchemas.test.js

@@ -101,6 +101,12 @@ describe("SettingsSchemas", () => {
             expect(nested).to.not.have.property("extends");
             expect(nested?.required).to.have.members(["nestedReq"]);
             expect(nested?.properties).to.include.keys("nestedReq", "nestedBaseOnly", "nestedChildOnly");
+            const resolvedPreservingExtends = schemas.getResolvedSettingDef(`${prefix}/thing`, { preserveExtends: true });
+            expect(resolvedPreservingExtends.extends).to.equal(`${prefix}/baseThing`);
+            expect(resolvedPreservingExtends.properties?.overridden.type).to.equal("number");
+            const nestedPreservingExtends = resolvedPreservingExtends.properties?.nested;
+            expect(nestedPreservingExtends?.extends).to.equal(`${prefix}/nestedBase`);
+            expect(nestedPreservingExtends?.properties).to.include.keys("nestedReq", "nestedBaseOnly", "nestedChildOnly");
         }
         finally {
             schemas.removeGroup(prefix);

package/lib/esm/test/standalone/SettingsSchemas.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemas.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/SettingsSchemas.test.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 { expect } from \"chai\";\nimport { IModelTestUtils } from \"../IModelTestUtils\";\nimport { IModelHost } from \"../../IModelHost\";\nimport { TestUtils } from \"../TestUtils\";\n\ndescribe(\"SettingsSchemas\", () => {\n\n  // SettingsSchema tests change the state of the IModelHost object. They should always clear\n  // the current state before and after they run so they're not affected by, nor influence, other tests running in the same process.\n  const restartSession = async () => {\n    await IModelHost.shutdown();\n    await TestUtils.startBackend();\n  };\n  before(async () => {\n    await restartSession();\n  });\n  after(async () => {\n    await restartSession();\n  });\n\n  it(\"add groups\", async () => {\n    const schemas = IModelHost.settingsSchemas;\n    // can't add a group with no name\n    expect(() => schemas.addGroup({} as any)).throws(`has no \"schemaPrefix\" member`);\n\n    schemas.addGroup({\n      schemaPrefix: \"title-test\",\n      title: \"Title Test\",\n      description: \"schema with a user-facing title\",\n      settingDefs: {\n        setting: {\n          type: \"string\",\n        },\n      },\n    });\n    expect(schemas.groups.get(\"title-test\")?.title).equals(\"Title Test\");\n    expect(schemas.groups.get(\"title-test\")?.description).equals(\"schema with a user-facing title\");\n    expect(schemas.settingDefs.get(\"title-test/setting\")!.type).equals(\"string\");\n\n    schemas.addFile(IModelTestUtils.resolveAssetFile(\"TestSettings.schema.json\"));\n    expect(schemas.groups.get(\"testApp\")?.title).equals(\"Test App\");\n    expect(schemas.groups.get(\"testApp\")?.description).equals(\"the settings for test application 1\");\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.type).equals(\"string\");\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.default).equals(\"singleClick\");\n    expect(schemas.settingDefs.get(\"testApp/tree/blah\")!.default).equals(true);\n  });\n\n  it(\"resolveSchema resolves object extends chains recursively\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-object\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test object resolution\",\n      typeDefs: {\n        nestedBase: {\n          type: \"object\",\n          required: [\"nestedReq\"],\n          properties: {\n            nestedReq: { type: \"integer\" },\n            nestedBaseOnly: { type: \"string\" },\n          },\n        },\n        baseThing: {\n          type: \"object\",\n          required: [\"baseReq\"],\n          properties: {\n            baseReq: { type: \"string\" },\n            overridden: { type: \"string\" },\n            baseOnly: { type: \"number\" },\n            nested: {\n              type: \"object\",\n              extends: `${prefix}/nestedBase`,\n              properties: {\n                nestedChildOnly: { type: \"boolean\" },\n              },\n            },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/baseThing`,\n          required: [\"derivedReq\"],\n          properties: {\n            derivedReq: { type: \"boolean\" },\n            overridden: { type: \"number\" },\n          },\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\n      expect(resolved.type).to.equal(\"object\");\n      expect(resolved).to.not.have.property(\"extends\");\n      expect(resolved.required).to.have.members([\"baseReq\", \"derivedReq\"]);\n      expect(resolved.properties).to.include.keys(\"baseReq\", \"baseOnly\", \"derivedReq\", \"overridden\", \"nested\");\n      expect(resolved.properties?.overridden.type).to.equal(\"number\");\n      expect(resolved.properties?.baseOnly.type).to.equal(\"number\");\n\n      const nested = resolved.properties?.nested;\n      expect(nested?.type).to.equal(\"object\");\n      expect(nested).to.not.have.property(\"extends\");\n      expect(nested?.required).to.have.members([\"nestedReq\"]);\n      expect(nested?.properties).to.include.keys(\"nestedReq\", \"nestedBaseOnly\", \"nestedChildOnly\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema includes inherited properties from object typedefs\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-object-inherited-props\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test inherited object properties\",\n      typeDefs: {\n        baseThing: {\n          type: \"object\",\n          properties: {\n            inheritedName: { type: \"string\" },\n            inheritedEnabled: { type: \"boolean\" },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/baseThing`,\n          properties: {\n            localCount: { type: \"integer\" },\n          },\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\n      expect(resolved.properties).to.include.keys(\"inheritedName\", \"inheritedEnabled\", \"localCount\");\n      expect(resolved.properties?.inheritedName.type).to.equal(\"string\");\n      expect(resolved.properties?.inheritedEnabled.type).to.equal(\"boolean\");\n      expect(resolved.properties?.localCount.type).to.equal(\"integer\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema deduplicates required properties inherited from object typedefs\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-object-required\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test required property deduplication\",\n      typeDefs: {\n        baseThing: {\n          type: \"object\",\n          required: [\"sharedReq\", \"baseReq\"],\n          properties: {\n            sharedReq: { type: \"string\" },\n            baseReq: { type: \"boolean\" },\n            derivedReq: { type: \"integer\" },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/baseThing`,\n          required: [\"sharedReq\", \"derivedReq\"],\n          properties: {\n            sharedReq: { type: \"string\" },\n            derivedReq: { type: \"integer\" },\n          },\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\n      expect(resolved.required).to.have.members([\"sharedReq\", \"baseReq\", \"derivedReq\"]);\n      expect(resolved.required?.filter((name) => name === \"sharedReq\")).to.have.lengthOf(1);\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema resolves array items through extends\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-array\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test array resolution\",\n      typeDefs: {\n        stringList: {\n          type: \"array\",\n          combineArray: true,\n          minItems: 1,\n          description: \"base array typedef\",\n          items: { type: \"string\" },\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/stringList`,\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\n      expect(resolved.type).to.equal(\"array\");\n      expect(resolved).to.not.have.property(\"extends\");\n      expect(resolved.combineArray).to.equal(true);\n      expect(resolved.minItems).to.equal(1);\n      expect(resolved.description).to.equal(\"base array typedef\");\n      expect(resolved.items?.type).to.equal(\"string\");\n      expect(resolved.items).to.not.have.property(\"extends\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema lets derived array schema properties override inherited typedef properties\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-array-overrides\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test array override precedence\",\n      typeDefs: {\n        stringList: {\n          type: \"array\",\n          combineArray: true,\n          minItems: 1,\n          description: \"base array typedef\",\n          items: { type: \"string\" },\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/stringList`,\n          combineArray: false,\n          minItems: 3,\n          description: \"derived array schema\",\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\n      expect(resolved.combineArray).to.equal(false);\n      expect(resolved.minItems).to.equal(3);\n      expect(resolved.description).to.equal(\"derived array schema\");\n      expect(resolved.items?.type).to.equal(\"string\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema resolves array items through multi-level typedef inheritance\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-array-multilevel\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test multi-level array typedef inheritance\",\n      typeDefs: {\n        c: {\n          type: \"array\",\n          combineArray: true,\n          items: { type: \"string\" },\n        },\n        b: {\n          type: \"array\",\n          extends: `${prefix}/c`,\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/b`,\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\n      expect(resolved.combineArray).to.equal(true);\n      expect(resolved.items?.type).to.equal(\"string\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef returns a resolved setting schema by name\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-setting-schema\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test resolved setting schema lookup\",\n      typeDefs: {\n        stringList: {\n          type: \"array\",\n          combineArray: true,\n          items: { type: \"string\" },\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/stringList`,\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);\n      expect(resolved).to.not.be.undefined;\n      expect(resolved?.type).to.equal(\"array\");\n      expect(resolved).to.not.have.property(\"extends\");\n      expect(resolved?.combineArray).to.equal(true);\n      expect(resolved?.items?.type).to.equal(\"string\");\n      expect(schemas.getResolvedSettingDef(`${prefix}/missing`)).to.be.undefined;\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef resolves built-in workspace settings schemas\", () => {\n    const schemas = IModelHost.settingsSchemas;\n\n    const resolved = schemas.getResolvedSettingDef(\"itwin/core/workspace/settingsWorkspaces\");\n    expect(resolved).to.not.be.undefined;\n    expect(resolved?.type).to.equal(\"array\");\n    expect(resolved?.items?.type).to.equal(\"object\");\n    expect(resolved?.items).to.not.have.property(\"extends\");\n    expect(resolved?.items?.required).to.have.members([\"containerId\", \"baseUri\"]);\n    expect(resolved?.items?.properties).to.include.keys(\"dbName\", \"baseUri\", \"containerId\", \"storageType\", \"resourceName\", \"priority\");\n    expect(resolved?.items?.properties?.storageType.default).to.equal(\"azure\");\n  });\n\n  it(\"getResolvedSettingDef throws on circular typedef references\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-cycle\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test circular typedef resolution\",\n      typeDefs: {\n        a: {\n          type: \"object\",\n          extends: `${prefix}/b`,\n          properties: {\n            aOnly: { type: \"string\" },\n          },\n        },\n        b: {\n          type: \"object\",\n          extends: `${prefix}/a`,\n          properties: {\n            bOnly: { type: \"string\" },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/a`,\n        },\n      },\n    });\n\n    try {\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(\"circular typeDef reference detected\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef throws on nested recursive typedef references\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-nested-cycle\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test nested recursive typedef resolution\",\n      typeDefs: {\n        node: {\n          type: \"object\",\n          properties: {\n            child: {\n              type: \"object\",\n              extends: `${prefix}/node`,\n            },\n          },\n        },\n      },\n      settingDefs: {\n        root: {\n          type: \"object\",\n          extends: `${prefix}/node`,\n        },\n      },\n    });\n\n    try {\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/root`)).to.throw(\"circular typeDef reference detected\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef throws when an extends target cannot be found\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-missing-typedef\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test missing typedef resolution\",\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/missingType`,\n        },\n      },\n    });\n\n    try {\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(`typeDef ${prefix}/missingType does not exist`);\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n});\n"]}
+{"version":3,"file":"SettingsSchemas.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/SettingsSchemas.test.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 { expect } from \"chai\";\nimport { IModelTestUtils } from \"../IModelTestUtils\";\nimport { IModelHost } from \"../../IModelHost\";\nimport { TestUtils } from \"../TestUtils\";\n\ndescribe(\"SettingsSchemas\", () => {\n\n  // SettingsSchema tests change the state of the IModelHost object. They should always clear\n  // the current state before and after they run so they're not affected by, nor influence, other tests running in the same process.\n  const restartSession = async () => {\n    await IModelHost.shutdown();\n    await TestUtils.startBackend();\n  };\n  before(async () => {\n    await restartSession();\n  });\n  after(async () => {\n    await restartSession();\n  });\n\n  it(\"add groups\", async () => {\n    const schemas = IModelHost.settingsSchemas;\n    // can't add a group with no name\n    expect(() => schemas.addGroup({} as any)).throws(`has no \"schemaPrefix\" member`);\n\n    schemas.addGroup({\n      schemaPrefix: \"title-test\",\n      title: \"Title Test\",\n      description: \"schema with a user-facing title\",\n      settingDefs: {\n        setting: {\n          type: \"string\",\n        },\n      },\n    });\n    expect(schemas.groups.get(\"title-test\")?.title).equals(\"Title Test\");\n    expect(schemas.groups.get(\"title-test\")?.description).equals(\"schema with a user-facing title\");\n    expect(schemas.settingDefs.get(\"title-test/setting\")!.type).equals(\"string\");\n\n    schemas.addFile(IModelTestUtils.resolveAssetFile(\"TestSettings.schema.json\"));\n    expect(schemas.groups.get(\"testApp\")?.title).equals(\"Test App\");\n    expect(schemas.groups.get(\"testApp\")?.description).equals(\"the settings for test application 1\");\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.type).equals(\"string\");\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.default).equals(\"singleClick\");\n    expect(schemas.settingDefs.get(\"testApp/tree/blah\")!.default).equals(true);\n  });\n\n  it(\"resolveSchema resolves object extends chains recursively\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-object\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test object resolution\",\n      typeDefs: {\n        nestedBase: {\n          type: \"object\",\n          required: [\"nestedReq\"],\n          properties: {\n            nestedReq: { type: \"integer\" },\n            nestedBaseOnly: { type: \"string\" },\n          },\n        },\n        baseThing: {\n          type: \"object\",\n          required: [\"baseReq\"],\n          properties: {\n            baseReq: { type: \"string\" },\n            overridden: { type: \"string\" },\n            baseOnly: { type: \"number\" },\n            nested: {\n              type: \"object\",\n              extends: `${prefix}/nestedBase`,\n              properties: {\n                nestedChildOnly: { type: \"boolean\" },\n              },\n            },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/baseThing`,\n          required: [\"derivedReq\"],\n          properties: {\n            derivedReq: { type: \"boolean\" },\n            overridden: { type: \"number\" },\n          },\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\n      expect(resolved.type).to.equal(\"object\");\n      expect(resolved).to.not.have.property(\"extends\");\n      expect(resolved.required).to.have.members([\"baseReq\", \"derivedReq\"]);\n      expect(resolved.properties).to.include.keys(\"baseReq\", \"baseOnly\", \"derivedReq\", \"overridden\", \"nested\");\n      expect(resolved.properties?.overridden.type).to.equal(\"number\");\n      expect(resolved.properties?.baseOnly.type).to.equal(\"number\");\n\n      const nested = resolved.properties?.nested;\n      expect(nested?.type).to.equal(\"object\");\n      expect(nested).to.not.have.property(\"extends\");\n      expect(nested?.required).to.have.members([\"nestedReq\"]);\n      expect(nested?.properties).to.include.keys(\"nestedReq\", \"nestedBaseOnly\", \"nestedChildOnly\");\n\n      const resolvedPreservingExtends = schemas.getResolvedSettingDef(`${prefix}/thing`, { preserveExtends: true })!;\n      expect(resolvedPreservingExtends.extends).to.equal(`${prefix}/baseThing`);\n      expect(resolvedPreservingExtends.properties?.overridden.type).to.equal(\"number\");\n\n      const nestedPreservingExtends = resolvedPreservingExtends.properties?.nested;\n      expect(nestedPreservingExtends?.extends).to.equal(`${prefix}/nestedBase`);\n      expect(nestedPreservingExtends?.properties).to.include.keys(\"nestedReq\", \"nestedBaseOnly\", \"nestedChildOnly\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema includes inherited properties from object typedefs\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-object-inherited-props\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test inherited object properties\",\n      typeDefs: {\n        baseThing: {\n          type: \"object\",\n          properties: {\n            inheritedName: { type: \"string\" },\n            inheritedEnabled: { type: \"boolean\" },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/baseThing`,\n          properties: {\n            localCount: { type: \"integer\" },\n          },\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\n      expect(resolved.properties).to.include.keys(\"inheritedName\", \"inheritedEnabled\", \"localCount\");\n      expect(resolved.properties?.inheritedName.type).to.equal(\"string\");\n      expect(resolved.properties?.inheritedEnabled.type).to.equal(\"boolean\");\n      expect(resolved.properties?.localCount.type).to.equal(\"integer\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema deduplicates required properties inherited from object typedefs\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-object-required\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test required property deduplication\",\n      typeDefs: {\n        baseThing: {\n          type: \"object\",\n          required: [\"sharedReq\", \"baseReq\"],\n          properties: {\n            sharedReq: { type: \"string\" },\n            baseReq: { type: \"boolean\" },\n            derivedReq: { type: \"integer\" },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/baseThing`,\n          required: [\"sharedReq\", \"derivedReq\"],\n          properties: {\n            sharedReq: { type: \"string\" },\n            derivedReq: { type: \"integer\" },\n          },\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\n      expect(resolved.required).to.have.members([\"sharedReq\", \"baseReq\", \"derivedReq\"]);\n      expect(resolved.required?.filter((name) => name === \"sharedReq\")).to.have.lengthOf(1);\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema resolves array items through extends\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-array\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test array resolution\",\n      typeDefs: {\n        stringList: {\n          type: \"array\",\n          combineArray: true,\n          minItems: 1,\n          description: \"base array typedef\",\n          items: { type: \"string\" },\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/stringList`,\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\n      expect(resolved.type).to.equal(\"array\");\n      expect(resolved).to.not.have.property(\"extends\");\n      expect(resolved.combineArray).to.equal(true);\n      expect(resolved.minItems).to.equal(1);\n      expect(resolved.description).to.equal(\"base array typedef\");\n      expect(resolved.items?.type).to.equal(\"string\");\n      expect(resolved.items).to.not.have.property(\"extends\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema lets derived array schema properties override inherited typedef properties\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-array-overrides\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test array override precedence\",\n      typeDefs: {\n        stringList: {\n          type: \"array\",\n          combineArray: true,\n          minItems: 1,\n          description: \"base array typedef\",\n          items: { type: \"string\" },\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/stringList`,\n          combineArray: false,\n          minItems: 3,\n          description: \"derived array schema\",\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\n      expect(resolved.combineArray).to.equal(false);\n      expect(resolved.minItems).to.equal(3);\n      expect(resolved.description).to.equal(\"derived array schema\");\n      expect(resolved.items?.type).to.equal(\"string\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"resolveSchema resolves array items through multi-level typedef inheritance\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-array-multilevel\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test multi-level array typedef inheritance\",\n      typeDefs: {\n        c: {\n          type: \"array\",\n          combineArray: true,\n          items: { type: \"string\" },\n        },\n        b: {\n          type: \"array\",\n          extends: `${prefix}/c`,\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/b`,\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\n      expect(resolved.combineArray).to.equal(true);\n      expect(resolved.items?.type).to.equal(\"string\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef returns a resolved setting schema by name\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-setting-schema\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test resolved setting schema lookup\",\n      typeDefs: {\n        stringList: {\n          type: \"array\",\n          combineArray: true,\n          items: { type: \"string\" },\n        },\n      },\n      settingDefs: {\n        names: {\n          type: \"array\",\n          extends: `${prefix}/stringList`,\n        },\n      },\n    });\n\n    try {\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);\n      expect(resolved).to.not.be.undefined;\n      expect(resolved?.type).to.equal(\"array\");\n      expect(resolved).to.not.have.property(\"extends\");\n      expect(resolved?.combineArray).to.equal(true);\n      expect(resolved?.items?.type).to.equal(\"string\");\n      expect(schemas.getResolvedSettingDef(`${prefix}/missing`)).to.be.undefined;\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef resolves built-in workspace settings schemas\", () => {\n    const schemas = IModelHost.settingsSchemas;\n\n    const resolved = schemas.getResolvedSettingDef(\"itwin/core/workspace/settingsWorkspaces\");\n    expect(resolved).to.not.be.undefined;\n    expect(resolved?.type).to.equal(\"array\");\n    expect(resolved?.items?.type).to.equal(\"object\");\n    expect(resolved?.items).to.not.have.property(\"extends\");\n    expect(resolved?.items?.required).to.have.members([\"containerId\", \"baseUri\"]);\n    expect(resolved?.items?.properties).to.include.keys(\"dbName\", \"baseUri\", \"containerId\", \"storageType\", \"resourceName\", \"priority\");\n    expect(resolved?.items?.properties?.storageType.default).to.equal(\"azure\");\n  });\n\n  it(\"getResolvedSettingDef throws on circular typedef references\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-cycle\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test circular typedef resolution\",\n      typeDefs: {\n        a: {\n          type: \"object\",\n          extends: `${prefix}/b`,\n          properties: {\n            aOnly: { type: \"string\" },\n          },\n        },\n        b: {\n          type: \"object\",\n          extends: `${prefix}/a`,\n          properties: {\n            bOnly: { type: \"string\" },\n          },\n        },\n      },\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/a`,\n        },\n      },\n    });\n\n    try {\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(\"circular typeDef reference detected\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef throws on nested recursive typedef references\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-nested-cycle\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test nested recursive typedef resolution\",\n      typeDefs: {\n        node: {\n          type: \"object\",\n          properties: {\n            child: {\n              type: \"object\",\n              extends: `${prefix}/node`,\n            },\n          },\n        },\n      },\n      settingDefs: {\n        root: {\n          type: \"object\",\n          extends: `${prefix}/node`,\n        },\n      },\n    });\n\n    try {\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/root`)).to.throw(\"circular typeDef reference detected\");\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n  it(\"getResolvedSettingDef throws when an extends target cannot be found\", () => {\n    const schemas = IModelHost.settingsSchemas;\n    const prefix = \"resolve-schema-missing-typedef\";\n    schemas.removeGroup(prefix);\n    schemas.addGroup({\n      schemaPrefix: prefix,\n      description: \"schema used to test missing typedef resolution\",\n      settingDefs: {\n        thing: {\n          type: \"object\",\n          extends: `${prefix}/missingType`,\n        },\n      },\n    });\n\n    try {\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(`typeDef ${prefix}/missingType does not exist`);\n    } finally {\n      schemas.removeGroup(prefix);\n    }\n  });\n\n});\n"]}

package/lib/esm/workspace/SettingsSchemas.d.ts

@@ -79,6 +79,21 @@ export interface SettingGroupSchema {
     /** A description of this group suitable for displaying to a user. */
     readonly description: string;
 }
+/** Options controlling how [[SettingsSchemas.getResolvedSettingDef]] resolves a [[SettingSchema]].
+ * @beta
+ */
+export interface GetResolvedSettingDefOptions {
+    /** When `true`, the `extends` property is retained on resolved schemas that originally
+     * declared it. By default (`false`) it is stripped after resolution, because the inherited
+     * properties have already been merged into the output schema.
+     *
+     * Set to `true` when the caller needs to inspect schema inheritance - for example, when
+     * building a schema editor that shows which base type a setting definition inherits from.
+     *
+     * @defaultValue false
+     */
+    readonly preserveExtends?: boolean;
+}
 /**
  * The registry of available [[SettingGroupSchema]]s.
  * The registry is used for editing Settings files and for finding default values for settings.
@@ -140,13 +155,24 @@ export interface SettingsSchemas {
     /**
      * Looks up a setting schema in [[settingDefs]] and returns its resolved form.
      * Resolution uses the [[typeDefs]] currently registered with this [[SettingsSchemas]] instance.
+     * By default, `extends` metadata is removed from the resolved schema. Pass [[GetResolvedSettingDefOptions.preserveExtends]]
+     * to preserve `extends` members on resolved schemas that originally declared them.
      * @returns The resolved schema for `settingName`, or `undefined` if no schema has been registered for that setting.
      * @throws Error if a registered setting schema cannot be resolved because a referenced type definition is missing or circular.
-     * @example
+     * @example Default - `extends` is stripped after resolution:
      * ```ts
      * const resolved = IModelHost.settingsSchemas.getResolvedSettingDef("app/font");
+     * // resolved.extends === undefined
+     * ```
+     * @example Preserving `extends` for tooling (e.g. a schema editor):
+     * ```ts
+     * const resolved = IModelHost.settingsSchemas.getResolvedSettingDef(
+     *   "app/font",
+     *   { preserveExtends: true },
+     * );
+     * // resolved.extends === "app/baseFont"  (if originally declared)
      * ```
      */
-    getResolvedSettingDef(settingName: SettingName): SettingSchema | undefined;
+    getResolvedSettingDef(settingName: SettingName, options?: GetResolvedSettingDefOptions): SettingSchema | undefined;
 }
 //# sourceMappingURL=SettingsSchemas.d.ts.map

package/lib/esm/workspace/SettingsSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemas.d.ts","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;;;IAQI;AACJ,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,UAAU,CAAC;IACzD,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAAA;KAAE,CAAC;IAC7D;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;IAoBI;AACJ,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;KAAE,CAAC;IACrE,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;KAAE,CAAC;IAClE,sJAAsJ;IACtJ,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AAEH;;;;;;;;;;;;;;IAcI;AACJ,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAE9C,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEzD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAE9D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAE3D,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAE9C;;;;;;;OAOG;IACH,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,CAAC;IAE1D;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAEzE,uFAAuF;IACvF,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,kFAAkF;IAClF,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAEvC,oFAAoF;IACpF,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE1C,+GAA+G;IAC/G,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;;;;;;OASG;IACH,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;CAE5E"}
+{"version":3,"file":"SettingsSchemas.d.ts","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":"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"}

package/lib/esm/workspace/SettingsSchemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,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/** @packageDocumentation\n * @module Workspace\n */\n\nimport { BeEvent, JSONSchema, JSONSchemaTypeName } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { _implementationProhibited } from \"../internal/Symbols\";\nimport { SettingName } from \"./Settings\";\n\n/** Metadata describing a single [[Setting]] as part of a [[SettingGroupSchema]].\n  * Every setting has a [[type]], which can be one of the following:\n  * - A primitive type like `string` or `number`;\n  * - An object containing any number of named properties, each with their own types; or\n  * - An array of elements, all of the same type.\n  * This metadata is used to validate setting values against the schema, and to enable user interfaces by which\n  * users can view and modify their settings.\n  * @beta\n  */\nexport interface SettingSchema extends Readonly<JSONSchema> {\n  /** For arrays only, the metadata describing every element in the array. */\n  readonly items?: SettingSchema;\n  /** The name of the [[Setting]]'s data type. */\n  readonly type: JSONSchemaTypeName;\n  /** For objects and arrays only, the name of a [[SettingSchema]] that provides a base definition for this type.\n   * The name is expected to refer to a type definition registered with [[SettingsSchema.typeDefs]].\n   * Therefore, it must be the full name, including the [[SettingGroupSchema.schemaPrefix]].\n   */\n  readonly extends?: string;\n  /** For objects only, the name and metadata of each of the object's properties. */\n  readonly properties?: { [name: SettingName]: SettingSchema };\n  /** For arrays only, specifies how [[SettingsDictionary.getArray]] resolves the value of the setting.\n   * By default, like other types of settings, the setting uses the value of the setting from the highest-priority dictionary.\n   * If `combineArray` is `true`, then the value of the setting is computed by combining the elements of every array from every dictionary,\n   * ordered by priority and eliminating duplicate elements.\n   * Two elements are considered duplicates of one another if [[Setting.areEqual]] returns `true`.\n   */\n  readonly combineArray?: boolean;\n}\n\n/** Metadata describing a group of related [[SettingSchema]]s. You can register setting schema groups via [[SettingsSchemas.addGroup]] and\n  * remove them via [[SettingsSchemas.removeGroup]].\n  *\n  * All of the settings share the same [[schemaPrefix]], which must be unique amongst all other groups.\n  * The prefix is a stable identifier combined with the name of each [[SettingSchema]] in the group to form the fully-qualified name used to refer\n  * to the setting outside of the group, e.g., when accessing [[SettingsSchemas.settingDefs]] or in [[SettingSchema.extends]].\n  * In the following example, the fully-qualified name of the setting named \"metric\" is \"format/units/metric\".\n  *\n  * ```json\n  *  {\n  *    \"schemaPrefix\": \"format/units\",\n  *    \"settingDefs\": {\n  *      \"metric\": { \"type\": \"boolean\" }\n  *    }\n  *  }\n  * ```\n  *\n  * A group can also define [[SettingSchema]]s that, rather than describing actual [[Setting]]s, instead describe types that can be extended by [[Setting]]s via\n  * [[SettingSchema.extends]]. A [[SettingSchema]] can refer to type definitions defined in its own group or any other group.\n  * @beta\n  */\nexport interface SettingGroupSchema {\n  /** Uniquely identifies this group amongst all other groups.\n   * The prefix can use forward-slashes to define logical subgroups - for example, two related groups with the prefixes \"units/metric\" and \"units/imperial\".\n   *\n   * @note Schema prefixes beginning with \"itwin\" are reserved for use by iTwin.js.\n   */\n  readonly schemaPrefix: string;\n  /** A title of this group suitable for displaying to a user. */\n  readonly title?: string;\n  /** Metadata for each [[Setting]] in this group. */\n  readonly settingDefs?: { [name: string]: SettingSchema | undefined };\n  /** Metadata for types that can be extended by other [[Setting]]s via [[SettingSchema.extends]]. */\n  readonly typeDefs?: { [name: string]: SettingSchema | undefined };\n  /** An integer used when displaying a list of schemas in a user interface, to sort schemas with a lower `order` before those with a `higher` order. */\n  readonly order?: number;\n  /** A description of this group suitable for displaying to a user. */\n  readonly description: string;\n}\n\n/**\n * The registry of available [[SettingGroupSchema]]s.\n * The registry is used for editing Settings files and for finding default values for settings.\n * @beta\n */\n\n/** The registry of metadata describing groups of [[SettingSchema]]s available to the current session.\n  * The schemas are used to look up the default values of [[Setting]]s, validate that their values are of the type dictated by the schema, and\n  * query metadata like [[SettingsSchema.combineArray]] that modify their behavior.\n  * They can also be used to drive a user interface that enables end users to edit [[Settings]].\n  *\n  * When [[IModelHost.startup]] is invoked at the beginning of a session, schemas delivered with the application - like those describing\n  * [[Workspace]]s - are automatically loaded.\n  * The application can manually register additional schemas using methods like [[addGroup]], [[addFile]], [[addDirectory]], and [[addJson]].\n  * When [[IModelHost.shutdown]] is invoked at the end of a session, all registered schemas are unregistered.\n  *\n  * See the [learning article]($docs/learning/backend/Workspace) for a detailed overiew and examples.\n  *\n  * @see [[IModelHost.settingsSchemas]] to access the registry for the current session.\n  * @beta\n  */\nexport interface SettingsSchemas {\n  /** @internal */\n  readonly [_implementationProhibited]: unknown;\n\n  /** The map of each registered [[SettingGroupSchema]], accessed by its [[SettingGroupSchema.schemaPrefix]]. */\n  readonly groups: ReadonlyMap<string, SettingGroupSchema>;\n\n  /** The map of each individual registered [[SettingSchema]] defining a [[Setting]], accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).\n   * Schemas in this map may include an [[SettingSchema.extends]] property referring to a registered type definition.\n   * Use [[resolveSchema]] to obtain the fully expanded schema.\n   */\n  readonly settingDefs: ReadonlyMap<SettingName, SettingSchema>;\n\n  /** The map of each individual registered [[SettingSchema]] defining a type that can be extended by other [[SettingSchema]]s via [[SettingSchema.extends]],\n   * accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).\n   */\n  readonly typeDefs: ReadonlyMap<SettingName, SettingSchema>;\n\n  /** An event raised whenever schemas are added or removed. */\n  readonly onSchemaChanged: BeEvent<() => void>;\n\n  /**\n   * Ensure that the setting value supplied is valid according to its [[SettingSchema]].\n   * If no schema has been registered for the setting, no validation is performed.\n   * @param value The value of the setting to validate against the schema.\n   * @param settingName The fully-qualified setting name.\n   * @returns `value` if `value` matches the schema corresponding to `settingName`, or if no such schema has been registered.\n   * @throws Error if `value` is invalid according to the schema.\n   */\n  validateSetting<T>(value: T, settingName: SettingName): T;\n\n  /** Register one or more [[SettingGroupSchema]]s.\n   * If a group with the same [[SettingGroupSchema.prefix]] was previously registered, it will be replaced.\n   * Each [[SettingSchema]] in the group will be added to [[settingDefs]] or [[typeDefs]].\n   */\n  addGroup(settingsGroup: SettingGroupSchema | SettingGroupSchema[]): void;\n\n  /** Invokes [[addGroup]] for a [[SettingGroupSchema]] supplied as stringified json5. */\n  addJson(settingSchema: string): void;\n\n  /** Invokes [[addGroup]] for a json5 file containiner a [[SettingGroupSchema]]. */\n  addFile(fileName: LocalFileName): void;\n\n  /** Invokes [[addFile]] for every json and json5 file in the specified directory. */\n  addDirectory(dirName: LocalDirName): void;\n\n  /** Unregisters all [[settingDefs]] and [[typeDefs]] with the specified [[SettingGroupSchema.schemaPrefix]]. */\n  removeGroup(schemaPrefix: string): void;\n\n  /**\n   * Looks up a setting schema in [[settingDefs]] and returns its resolved form.\n   * Resolution uses the [[typeDefs]] currently registered with this [[SettingsSchemas]] instance.\n   * @returns The resolved schema for `settingName`, or `undefined` if no schema has been registered for that setting.\n   * @throws Error if a registered setting schema cannot be resolved because a referenced type definition is missing or circular.\n   * @example\n   * ```ts\n   * const resolved = IModelHost.settingsSchemas.getResolvedSettingDef(\"app/font\");\n   * ```\n   */\n  getResolvedSettingDef(settingName: SettingName): SettingSchema | undefined;\n\n}\n"]}
+{"version":3,"file":"SettingsSchemas.js","sourceRoot":"","sources":["../../../src/workspace/SettingsSchemas.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,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/** @packageDocumentation\n * @module Workspace\n */\n\nimport { BeEvent, JSONSchema, JSONSchemaTypeName } from \"@itwin/core-bentley\";\nimport { LocalDirName, LocalFileName } from \"@itwin/core-common\";\nimport { _implementationProhibited } from \"../internal/Symbols\";\nimport { SettingName } from \"./Settings\";\n\n/** Metadata describing a single [[Setting]] as part of a [[SettingGroupSchema]].\n  * Every setting has a [[type]], which can be one of the following:\n  * - A primitive type like `string` or `number`;\n  * - An object containing any number of named properties, each with their own types; or\n  * - An array of elements, all of the same type.\n  * This metadata is used to validate setting values against the schema, and to enable user interfaces by which\n  * users can view and modify their settings.\n  * @beta\n  */\nexport interface SettingSchema extends Readonly<JSONSchema> {\n  /** For arrays only, the metadata describing every element in the array. */\n  readonly items?: SettingSchema;\n  /** The name of the [[Setting]]'s data type. */\n  readonly type: JSONSchemaTypeName;\n  /** For objects and arrays only, the name of a [[SettingSchema]] that provides a base definition for this type.\n   * The name is expected to refer to a type definition registered with [[SettingsSchema.typeDefs]].\n   * Therefore, it must be the full name, including the [[SettingGroupSchema.schemaPrefix]].\n   */\n  readonly extends?: string;\n  /** For objects only, the name and metadata of each of the object's properties. */\n  readonly properties?: { [name: SettingName]: SettingSchema };\n  /** For arrays only, specifies how [[SettingsDictionary.getArray]] resolves the value of the setting.\n   * By default, like other types of settings, the setting uses the value of the setting from the highest-priority dictionary.\n   * If `combineArray` is `true`, then the value of the setting is computed by combining the elements of every array from every dictionary,\n   * ordered by priority and eliminating duplicate elements.\n   * Two elements are considered duplicates of one another if [[Setting.areEqual]] returns `true`.\n   */\n  readonly combineArray?: boolean;\n}\n\n/** Metadata describing a group of related [[SettingSchema]]s. You can register setting schema groups via [[SettingsSchemas.addGroup]] and\n  * remove them via [[SettingsSchemas.removeGroup]].\n  *\n  * All of the settings share the same [[schemaPrefix]], which must be unique amongst all other groups.\n  * The prefix is a stable identifier combined with the name of each [[SettingSchema]] in the group to form the fully-qualified name used to refer\n  * to the setting outside of the group, e.g., when accessing [[SettingsSchemas.settingDefs]] or in [[SettingSchema.extends]].\n  * In the following example, the fully-qualified name of the setting named \"metric\" is \"format/units/metric\".\n  *\n  * ```json\n  *  {\n  *    \"schemaPrefix\": \"format/units\",\n  *    \"settingDefs\": {\n  *      \"metric\": { \"type\": \"boolean\" }\n  *    }\n  *  }\n  * ```\n  *\n  * A group can also define [[SettingSchema]]s that, rather than describing actual [[Setting]]s, instead describe types that can be extended by [[Setting]]s via\n  * [[SettingSchema.extends]]. A [[SettingSchema]] can refer to type definitions defined in its own group or any other group.\n  * @beta\n  */\nexport interface SettingGroupSchema {\n  /** Uniquely identifies this group amongst all other groups.\n   * The prefix can use forward-slashes to define logical subgroups - for example, two related groups with the prefixes \"units/metric\" and \"units/imperial\".\n   *\n   * @note Schema prefixes beginning with \"itwin\" are reserved for use by iTwin.js.\n   */\n  readonly schemaPrefix: string;\n  /** A title of this group suitable for displaying to a user. */\n  readonly title?: string;\n  /** Metadata for each [[Setting]] in this group. */\n  readonly settingDefs?: { [name: string]: SettingSchema | undefined };\n  /** Metadata for types that can be extended by other [[Setting]]s via [[SettingSchema.extends]]. */\n  readonly typeDefs?: { [name: string]: SettingSchema | undefined };\n  /** An integer used when displaying a list of schemas in a user interface, to sort schemas with a lower `order` before those with a `higher` order. */\n  readonly order?: number;\n  /** A description of this group suitable for displaying to a user. */\n  readonly description: string;\n}\n\n/** Options controlling how [[SettingsSchemas.getResolvedSettingDef]] resolves a [[SettingSchema]].\n * @beta\n */\nexport interface GetResolvedSettingDefOptions {\n  /** When `true`, the `extends` property is retained on resolved schemas that originally\n   * declared it. By default (`false`) it is stripped after resolution, because the inherited\n   * properties have already been merged into the output schema.\n   *\n   * Set to `true` when the caller needs to inspect schema inheritance - for example, when\n   * building a schema editor that shows which base type a setting definition inherits from.\n   *\n   * @defaultValue false\n   */\n  readonly preserveExtends?: boolean;\n}\n\n/**\n * The registry of available [[SettingGroupSchema]]s.\n * The registry is used for editing Settings files and for finding default values for settings.\n * @beta\n */\n\n/** The registry of metadata describing groups of [[SettingSchema]]s available to the current session.\n  * The schemas are used to look up the default values of [[Setting]]s, validate that their values are of the type dictated by the schema, and\n  * query metadata like [[SettingsSchema.combineArray]] that modify their behavior.\n  * They can also be used to drive a user interface that enables end users to edit [[Settings]].\n  *\n  * When [[IModelHost.startup]] is invoked at the beginning of a session, schemas delivered with the application - like those describing\n  * [[Workspace]]s - are automatically loaded.\n  * The application can manually register additional schemas using methods like [[addGroup]], [[addFile]], [[addDirectory]], and [[addJson]].\n  * When [[IModelHost.shutdown]] is invoked at the end of a session, all registered schemas are unregistered.\n  *\n  * See the [learning article]($docs/learning/backend/Workspace) for a detailed overiew and examples.\n  *\n  * @see [[IModelHost.settingsSchemas]] to access the registry for the current session.\n  * @beta\n  */\nexport interface SettingsSchemas {\n  /** @internal */\n  readonly [_implementationProhibited]: unknown;\n\n  /** The map of each registered [[SettingGroupSchema]], accessed by its [[SettingGroupSchema.schemaPrefix]]. */\n  readonly groups: ReadonlyMap<string, SettingGroupSchema>;\n\n  /** The map of each individual registered [[SettingSchema]] defining a [[Setting]], accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).\n   * Schemas in this map may include an [[SettingSchema.extends]] property referring to a registered type definition.\n   * Use [[resolveSchema]] to obtain the fully expanded schema.\n   */\n  readonly settingDefs: ReadonlyMap<SettingName, SettingSchema>;\n\n  /** The map of each individual registered [[SettingSchema]] defining a type that can be extended by other [[SettingSchema]]s via [[SettingSchema.extends]],\n   * accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).\n   */\n  readonly typeDefs: ReadonlyMap<SettingName, SettingSchema>;\n\n  /** An event raised whenever schemas are added or removed. */\n  readonly onSchemaChanged: BeEvent<() => void>;\n\n  /**\n   * Ensure that the setting value supplied is valid according to its [[SettingSchema]].\n   * If no schema has been registered for the setting, no validation is performed.\n   * @param value The value of the setting to validate against the schema.\n   * @param settingName The fully-qualified setting name.\n   * @returns `value` if `value` matches the schema corresponding to `settingName`, or if no such schema has been registered.\n   * @throws Error if `value` is invalid according to the schema.\n   */\n  validateSetting<T>(value: T, settingName: SettingName): T;\n\n  /** Register one or more [[SettingGroupSchema]]s.\n   * If a group with the same [[SettingGroupSchema.prefix]] was previously registered, it will be replaced.\n   * Each [[SettingSchema]] in the group will be added to [[settingDefs]] or [[typeDefs]].\n   */\n  addGroup(settingsGroup: SettingGroupSchema | SettingGroupSchema[]): void;\n\n  /** Invokes [[addGroup]] for a [[SettingGroupSchema]] supplied as stringified json5. */\n  addJson(settingSchema: string): void;\n\n  /** Invokes [[addGroup]] for a json5 file containiner a [[SettingGroupSchema]]. */\n  addFile(fileName: LocalFileName): void;\n\n  /** Invokes [[addFile]] for every json and json5 file in the specified directory. */\n  addDirectory(dirName: LocalDirName): void;\n\n  /** Unregisters all [[settingDefs]] and [[typeDefs]] with the specified [[SettingGroupSchema.schemaPrefix]]. */\n  removeGroup(schemaPrefix: string): void;\n\n  /**\n   * Looks up a setting schema in [[settingDefs]] and returns its resolved form.\n   * Resolution uses the [[typeDefs]] currently registered with this [[SettingsSchemas]] instance.\n   * By default, `extends` metadata is removed from the resolved schema. Pass [[GetResolvedSettingDefOptions.preserveExtends]]\n   * to preserve `extends` members on resolved schemas that originally declared them.\n   * @returns The resolved schema for `settingName`, or `undefined` if no schema has been registered for that setting.\n   * @throws Error if a registered setting schema cannot be resolved because a referenced type definition is missing or circular.\n   * @example Default - `extends` is stripped after resolution:\n   * ```ts\n   * const resolved = IModelHost.settingsSchemas.getResolvedSettingDef(\"app/font\");\n   * // resolved.extends === undefined\n   * ```\n   * @example Preserving `extends` for tooling (e.g. a schema editor):\n   * ```ts\n   * const resolved = IModelHost.settingsSchemas.getResolvedSettingDef(\n   *   \"app/font\",\n   *   { preserveExtends: true },\n   * );\n   * // resolved.extends === \"app/baseFont\"  (if originally declared)\n   * ```\n   */\n  getResolvedSettingDef(settingName: SettingName, options?: GetResolvedSettingDefOptions): SettingSchema | undefined;\n\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/core-backend",
-  "version": "5.12.0-dev.2",
+  "version": "5.12.0-dev.5",
   "description": "iTwin.js backend components",
   "main": "lib/cjs/core-backend.js",
   "module": "lib/esm/core-backend.js",
@@ -27,10 +27,10 @@
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1.0.4",
-    "@itwin/core-bentley": "5.12.0-dev.2",
-    "@itwin/core-common": "5.12.0-dev.2",
-    "@itwin/ecschema-metadata": "5.12.0-dev.2",
-    "@itwin/core-geometry": "5.12.0-dev.2"
+    "@itwin/core-bentley": "5.12.0-dev.5",
+    "@itwin/core-common": "5.12.0-dev.5",
+    "@itwin/core-geometry": "5.12.0-dev.5",
+    "@itwin/ecschema-metadata": "5.12.0-dev.5"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {
@@ -77,17 +77,17 @@
     "marked": "^14.1.3",
     "sql-formatter": "^15.4.6",
     "webpack": "^5.97.1",
-    "@itwin/core-bentley": "5.12.0-dev.2",
-    "@itwin/build-tools": "5.12.0-dev.2",
-    "@itwin/ecschema-metadata": "5.12.0-dev.2",
-    "@itwin/core-common": "5.12.0-dev.2",
-    "@itwin/ecschema-locaters": "5.12.0-dev.2",
-    "@itwin/core-geometry": "5.12.0-dev.2",
-    "@itwin/ecsql-common": "5.12.0-dev.2",
-    "internal-tools": "3.0.0-dev.69"
+    "@itwin/build-tools": "5.12.0-dev.5",
+    "@itwin/core-geometry": "5.12.0-dev.5",
+    "@itwin/core-common": "5.12.0-dev.5",
+    "@itwin/ecsql-common": "5.12.0-dev.5",
+    "@itwin/ecschema-locaters": "5.12.0-dev.5",
+    "@itwin/core-bentley": "5.12.0-dev.5",
+    "internal-tools": "3.0.0-dev.69",
+    "@itwin/ecschema-metadata": "5.12.0-dev.5"
   },
   "dependencies": {
-    "@bentley/imodeljs-native": "5.12.0",
+    "@bentley/imodeljs-native": "5.12.2",
     "@itwin/object-storage-azure": "^3.0.4",
     "@azure/storage-blob": "^12.28.0",
     "form-data": "^4.0.6",