@itwin/core-backend 5.10.0-dev.16 → 5.10.0-dev.19

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

@@ -43,5 +43,387 @@ describe("SettingsSchemas", () => {
         expect(schemas.settingDefs.get("testApp/list/openMode").default).equals("singleClick");
         expect(schemas.settingDefs.get("testApp/tree/blah").default).equals(true);
     });
+    it("resolveSchema resolves object extends chains recursively", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-object";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test object resolution",
+            typeDefs: {
+                nestedBase: {
+                    type: "object",
+                    required: ["nestedReq"],
+                    properties: {
+                        nestedReq: { type: "integer" },
+                        nestedBaseOnly: { type: "string" },
+                    },
+                },
+                baseThing: {
+                    type: "object",
+                    required: ["baseReq"],
+                    properties: {
+                        baseReq: { type: "string" },
+                        overridden: { type: "string" },
+                        baseOnly: { type: "number" },
+                        nested: {
+                            type: "object",
+                            extends: `${prefix}/nestedBase`,
+                            properties: {
+                                nestedChildOnly: { type: "boolean" },
+                            },
+                        },
+                    },
+                },
+            },
+            settingDefs: {
+                thing: {
+                    type: "object",
+                    extends: `${prefix}/baseThing`,
+                    required: ["derivedReq"],
+                    properties: {
+                        derivedReq: { type: "boolean" },
+                        overridden: { type: "number" },
+                    },
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`);
+            expect(resolved.type).to.equal("object");
+            expect(resolved).to.not.have.property("extends");
+            expect(resolved.required).to.have.members(["baseReq", "derivedReq"]);
+            expect(resolved.properties).to.include.keys("baseReq", "baseOnly", "derivedReq", "overridden", "nested");
+            expect(resolved.properties?.overridden.type).to.equal("number");
+            expect(resolved.properties?.baseOnly.type).to.equal("number");
+            const nested = resolved.properties?.nested;
+            expect(nested?.type).to.equal("object");
+            expect(nested).to.not.have.property("extends");
+            expect(nested?.required).to.have.members(["nestedReq"]);
+            expect(nested?.properties).to.include.keys("nestedReq", "nestedBaseOnly", "nestedChildOnly");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("resolveSchema includes inherited properties from object typedefs", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-object-inherited-props";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test inherited object properties",
+            typeDefs: {
+                baseThing: {
+                    type: "object",
+                    properties: {
+                        inheritedName: { type: "string" },
+                        inheritedEnabled: { type: "boolean" },
+                    },
+                },
+            },
+            settingDefs: {
+                thing: {
+                    type: "object",
+                    extends: `${prefix}/baseThing`,
+                    properties: {
+                        localCount: { type: "integer" },
+                    },
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`);
+            expect(resolved.properties).to.include.keys("inheritedName", "inheritedEnabled", "localCount");
+            expect(resolved.properties?.inheritedName.type).to.equal("string");
+            expect(resolved.properties?.inheritedEnabled.type).to.equal("boolean");
+            expect(resolved.properties?.localCount.type).to.equal("integer");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("resolveSchema deduplicates required properties inherited from object typedefs", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-object-required";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test required property deduplication",
+            typeDefs: {
+                baseThing: {
+                    type: "object",
+                    required: ["sharedReq", "baseReq"],
+                    properties: {
+                        sharedReq: { type: "string" },
+                        baseReq: { type: "boolean" },
+                        derivedReq: { type: "integer" },
+                    },
+                },
+            },
+            settingDefs: {
+                thing: {
+                    type: "object",
+                    extends: `${prefix}/baseThing`,
+                    required: ["sharedReq", "derivedReq"],
+                    properties: {
+                        sharedReq: { type: "string" },
+                        derivedReq: { type: "integer" },
+                    },
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`);
+            expect(resolved.required).to.have.members(["sharedReq", "baseReq", "derivedReq"]);
+            expect(resolved.required?.filter((name) => name === "sharedReq")).to.have.lengthOf(1);
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("resolveSchema resolves array items through extends", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-array";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test array resolution",
+            typeDefs: {
+                stringList: {
+                    type: "array",
+                    combineArray: true,
+                    minItems: 1,
+                    description: "base array typedef",
+                    items: { type: "string" },
+                },
+            },
+            settingDefs: {
+                names: {
+                    type: "array",
+                    extends: `${prefix}/stringList`,
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);
+            expect(resolved.type).to.equal("array");
+            expect(resolved).to.not.have.property("extends");
+            expect(resolved.combineArray).to.equal(true);
+            expect(resolved.minItems).to.equal(1);
+            expect(resolved.description).to.equal("base array typedef");
+            expect(resolved.items?.type).to.equal("string");
+            expect(resolved.items).to.not.have.property("extends");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("resolveSchema lets derived array schema properties override inherited typedef properties", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-array-overrides";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test array override precedence",
+            typeDefs: {
+                stringList: {
+                    type: "array",
+                    combineArray: true,
+                    minItems: 1,
+                    description: "base array typedef",
+                    items: { type: "string" },
+                },
+            },
+            settingDefs: {
+                names: {
+                    type: "array",
+                    extends: `${prefix}/stringList`,
+                    combineArray: false,
+                    minItems: 3,
+                    description: "derived array schema",
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);
+            expect(resolved.combineArray).to.equal(false);
+            expect(resolved.minItems).to.equal(3);
+            expect(resolved.description).to.equal("derived array schema");
+            expect(resolved.items?.type).to.equal("string");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("resolveSchema resolves array items through multi-level typedef inheritance", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-array-multilevel";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test multi-level array typedef inheritance",
+            typeDefs: {
+                c: {
+                    type: "array",
+                    combineArray: true,
+                    items: { type: "string" },
+                },
+                b: {
+                    type: "array",
+                    extends: `${prefix}/c`,
+                },
+            },
+            settingDefs: {
+                names: {
+                    type: "array",
+                    extends: `${prefix}/b`,
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);
+            expect(resolved.combineArray).to.equal(true);
+            expect(resolved.items?.type).to.equal("string");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("getResolvedSettingDef returns a resolved setting schema by name", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-setting-schema";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test resolved setting schema lookup",
+            typeDefs: {
+                stringList: {
+                    type: "array",
+                    combineArray: true,
+                    items: { type: "string" },
+                },
+            },
+            settingDefs: {
+                names: {
+                    type: "array",
+                    extends: `${prefix}/stringList`,
+                },
+            },
+        });
+        try {
+            const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);
+            expect(resolved).to.not.be.undefined;
+            expect(resolved?.type).to.equal("array");
+            expect(resolved).to.not.have.property("extends");
+            expect(resolved?.combineArray).to.equal(true);
+            expect(resolved?.items?.type).to.equal("string");
+            expect(schemas.getResolvedSettingDef(`${prefix}/missing`)).to.be.undefined;
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("getResolvedSettingDef resolves built-in workspace settings schemas", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const resolved = schemas.getResolvedSettingDef("itwin/core/workspace/settingsWorkspaces");
+        expect(resolved).to.not.be.undefined;
+        expect(resolved?.type).to.equal("array");
+        expect(resolved?.items?.type).to.equal("object");
+        expect(resolved?.items).to.not.have.property("extends");
+        expect(resolved?.items?.required).to.have.members(["containerId", "baseUri"]);
+        expect(resolved?.items?.properties).to.include.keys("dbName", "baseUri", "containerId", "storageType", "resourceName", "priority");
+        expect(resolved?.items?.properties?.storageType.default).to.equal("azure");
+    });
+    it("getResolvedSettingDef throws on circular typedef references", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-cycle";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test circular typedef resolution",
+            typeDefs: {
+                a: {
+                    type: "object",
+                    extends: `${prefix}/b`,
+                    properties: {
+                        aOnly: { type: "string" },
+                    },
+                },
+                b: {
+                    type: "object",
+                    extends: `${prefix}/a`,
+                    properties: {
+                        bOnly: { type: "string" },
+                    },
+                },
+            },
+            settingDefs: {
+                thing: {
+                    type: "object",
+                    extends: `${prefix}/a`,
+                },
+            },
+        });
+        try {
+            expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw("circular typeDef reference detected");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("getResolvedSettingDef throws on nested recursive typedef references", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-nested-cycle";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test nested recursive typedef resolution",
+            typeDefs: {
+                node: {
+                    type: "object",
+                    properties: {
+                        child: {
+                            type: "object",
+                            extends: `${prefix}/node`,
+                        },
+                    },
+                },
+            },
+            settingDefs: {
+                root: {
+                    type: "object",
+                    extends: `${prefix}/node`,
+                },
+            },
+        });
+        try {
+            expect(() => schemas.getResolvedSettingDef(`${prefix}/root`)).to.throw("circular typeDef reference detected");
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
+    it("getResolvedSettingDef throws when an extends target cannot be found", () => {
+        const schemas = IModelHost.settingsSchemas;
+        const prefix = "resolve-schema-missing-typedef";
+        schemas.removeGroup(prefix);
+        schemas.addGroup({
+            schemaPrefix: prefix,
+            description: "schema used to test missing typedef resolution",
+            settingDefs: {
+                thing: {
+                    type: "object",
+                    extends: `${prefix}/missingType`,
+                },
+            },
+        });
+        try {
+            expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(`typeDef ${prefix}/missingType does not exist`);
+        }
+        finally {
+            schemas.removeGroup(prefix);
+        }
+    });
 });
 //# sourceMappingURL=SettingsSchemas.test.js.map

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":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAE/B,2FAA2F;IAC3F,kIAAkI;IAClI,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;IACjC,CAAC,CAAC;IACF,MAAM,CAAC,KAAK,IAAI,EAAE;QAChB,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;QAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC;QAC3C,iCAAiC;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAS,CAAC,CAAC,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC;QAEjF,OAAO,CAAC,QAAQ,CAAC;YACf,YAAY,EAAE,YAAY;YAC1B,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,iCAAiC;YAC9C,WAAW,EAAE;gBACX,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;iBACf;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACrE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAChG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE7E,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,0BAA0B,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;QACjG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,uBAAuB,CAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChF,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,uBAAuB,CAAE,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACxF,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAE,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AAEL,CAAC,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { expect } from \"chai\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\nimport { IModelHost } from \"../../IModelHost\";\r\nimport { TestUtils } from \"../TestUtils\";\r\n\r\ndescribe(\"SettingsSchemas\", () => {\r\n\r\n  // SettingsSchema tests change the state of the IModelHost object. They should always clear\r\n  // the current state before and after they run so they're not affected by, nor influence, other tests running in the same process.\r\n  const restartSession = async () => {\r\n    await IModelHost.shutdown();\r\n    await TestUtils.startBackend();\r\n  };\r\n  before(async () => {\r\n    await restartSession();\r\n  });\r\n  after(async () => {\r\n    await restartSession();\r\n  });\r\n\r\n  it(\"add groups\", async () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    // can't add a group with no name\r\n    expect(() => schemas.addGroup({} as any)).throws(`has no \"schemaPrefix\" member`);\r\n\r\n    schemas.addGroup({\r\n      schemaPrefix: \"title-test\",\r\n      title: \"Title Test\",\r\n      description: \"schema with a user-facing title\",\r\n      settingDefs: {\r\n        setting: {\r\n          type: \"string\",\r\n        },\r\n      },\r\n    });\r\n    expect(schemas.groups.get(\"title-test\")?.title).equals(\"Title Test\");\r\n    expect(schemas.groups.get(\"title-test\")?.description).equals(\"schema with a user-facing title\");\r\n    expect(schemas.settingDefs.get(\"title-test/setting\")!.type).equals(\"string\");\r\n\r\n    schemas.addFile(IModelTestUtils.resolveAssetFile(\"TestSettings.schema.json\"));\r\n    expect(schemas.groups.get(\"testApp\")?.title).equals(\"Test App\");\r\n    expect(schemas.groups.get(\"testApp\")?.description).equals(\"the settings for test application 1\");\r\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.type).equals(\"string\");\r\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.default).equals(\"singleClick\");\r\n    expect(schemas.settingDefs.get(\"testApp/tree/blah\")!.default).equals(true);\r\n  });\r\n\r\n});\r\n"]}
+{"version":3,"file":"SettingsSchemas.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/SettingsSchemas.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { expect } from \"chai\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\nimport { IModelHost } from \"../../IModelHost\";\r\nimport { TestUtils } from \"../TestUtils\";\r\n\r\ndescribe(\"SettingsSchemas\", () => {\r\n\r\n  // SettingsSchema tests change the state of the IModelHost object. They should always clear\r\n  // the current state before and after they run so they're not affected by, nor influence, other tests running in the same process.\r\n  const restartSession = async () => {\r\n    await IModelHost.shutdown();\r\n    await TestUtils.startBackend();\r\n  };\r\n  before(async () => {\r\n    await restartSession();\r\n  });\r\n  after(async () => {\r\n    await restartSession();\r\n  });\r\n\r\n  it(\"add groups\", async () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    // can't add a group with no name\r\n    expect(() => schemas.addGroup({} as any)).throws(`has no \"schemaPrefix\" member`);\r\n\r\n    schemas.addGroup({\r\n      schemaPrefix: \"title-test\",\r\n      title: \"Title Test\",\r\n      description: \"schema with a user-facing title\",\r\n      settingDefs: {\r\n        setting: {\r\n          type: \"string\",\r\n        },\r\n      },\r\n    });\r\n    expect(schemas.groups.get(\"title-test\")?.title).equals(\"Title Test\");\r\n    expect(schemas.groups.get(\"title-test\")?.description).equals(\"schema with a user-facing title\");\r\n    expect(schemas.settingDefs.get(\"title-test/setting\")!.type).equals(\"string\");\r\n\r\n    schemas.addFile(IModelTestUtils.resolveAssetFile(\"TestSettings.schema.json\"));\r\n    expect(schemas.groups.get(\"testApp\")?.title).equals(\"Test App\");\r\n    expect(schemas.groups.get(\"testApp\")?.description).equals(\"the settings for test application 1\");\r\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.type).equals(\"string\");\r\n    expect(schemas.settingDefs.get(\"testApp/list/openMode\")!.default).equals(\"singleClick\");\r\n    expect(schemas.settingDefs.get(\"testApp/tree/blah\")!.default).equals(true);\r\n  });\r\n\r\n  it(\"resolveSchema resolves object extends chains recursively\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-object\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test object resolution\",\r\n      typeDefs: {\r\n        nestedBase: {\r\n          type: \"object\",\r\n          required: [\"nestedReq\"],\r\n          properties: {\r\n            nestedReq: { type: \"integer\" },\r\n            nestedBaseOnly: { type: \"string\" },\r\n          },\r\n        },\r\n        baseThing: {\r\n          type: \"object\",\r\n          required: [\"baseReq\"],\r\n          properties: {\r\n            baseReq: { type: \"string\" },\r\n            overridden: { type: \"string\" },\r\n            baseOnly: { type: \"number\" },\r\n            nested: {\r\n              type: \"object\",\r\n              extends: `${prefix}/nestedBase`,\r\n              properties: {\r\n                nestedChildOnly: { type: \"boolean\" },\r\n              },\r\n            },\r\n          },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        thing: {\r\n          type: \"object\",\r\n          extends: `${prefix}/baseThing`,\r\n          required: [\"derivedReq\"],\r\n          properties: {\r\n            derivedReq: { type: \"boolean\" },\r\n            overridden: { type: \"number\" },\r\n          },\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\r\n      expect(resolved.type).to.equal(\"object\");\r\n      expect(resolved).to.not.have.property(\"extends\");\r\n      expect(resolved.required).to.have.members([\"baseReq\", \"derivedReq\"]);\r\n      expect(resolved.properties).to.include.keys(\"baseReq\", \"baseOnly\", \"derivedReq\", \"overridden\", \"nested\");\r\n      expect(resolved.properties?.overridden.type).to.equal(\"number\");\r\n      expect(resolved.properties?.baseOnly.type).to.equal(\"number\");\r\n\r\n      const nested = resolved.properties?.nested;\r\n      expect(nested?.type).to.equal(\"object\");\r\n      expect(nested).to.not.have.property(\"extends\");\r\n      expect(nested?.required).to.have.members([\"nestedReq\"]);\r\n      expect(nested?.properties).to.include.keys(\"nestedReq\", \"nestedBaseOnly\", \"nestedChildOnly\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"resolveSchema includes inherited properties from object typedefs\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-object-inherited-props\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test inherited object properties\",\r\n      typeDefs: {\r\n        baseThing: {\r\n          type: \"object\",\r\n          properties: {\r\n            inheritedName: { type: \"string\" },\r\n            inheritedEnabled: { type: \"boolean\" },\r\n          },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        thing: {\r\n          type: \"object\",\r\n          extends: `${prefix}/baseThing`,\r\n          properties: {\r\n            localCount: { type: \"integer\" },\r\n          },\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\r\n      expect(resolved.properties).to.include.keys(\"inheritedName\", \"inheritedEnabled\", \"localCount\");\r\n      expect(resolved.properties?.inheritedName.type).to.equal(\"string\");\r\n      expect(resolved.properties?.inheritedEnabled.type).to.equal(\"boolean\");\r\n      expect(resolved.properties?.localCount.type).to.equal(\"integer\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"resolveSchema deduplicates required properties inherited from object typedefs\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-object-required\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test required property deduplication\",\r\n      typeDefs: {\r\n        baseThing: {\r\n          type: \"object\",\r\n          required: [\"sharedReq\", \"baseReq\"],\r\n          properties: {\r\n            sharedReq: { type: \"string\" },\r\n            baseReq: { type: \"boolean\" },\r\n            derivedReq: { type: \"integer\" },\r\n          },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        thing: {\r\n          type: \"object\",\r\n          extends: `${prefix}/baseThing`,\r\n          required: [\"sharedReq\", \"derivedReq\"],\r\n          properties: {\r\n            sharedReq: { type: \"string\" },\r\n            derivedReq: { type: \"integer\" },\r\n          },\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/thing`)!;\r\n      expect(resolved.required).to.have.members([\"sharedReq\", \"baseReq\", \"derivedReq\"]);\r\n      expect(resolved.required?.filter((name) => name === \"sharedReq\")).to.have.lengthOf(1);\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"resolveSchema resolves array items through extends\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-array\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test array resolution\",\r\n      typeDefs: {\r\n        stringList: {\r\n          type: \"array\",\r\n          combineArray: true,\r\n          minItems: 1,\r\n          description: \"base array typedef\",\r\n          items: { type: \"string\" },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        names: {\r\n          type: \"array\",\r\n          extends: `${prefix}/stringList`,\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\r\n      expect(resolved.type).to.equal(\"array\");\r\n      expect(resolved).to.not.have.property(\"extends\");\r\n      expect(resolved.combineArray).to.equal(true);\r\n      expect(resolved.minItems).to.equal(1);\r\n      expect(resolved.description).to.equal(\"base array typedef\");\r\n      expect(resolved.items?.type).to.equal(\"string\");\r\n      expect(resolved.items).to.not.have.property(\"extends\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"resolveSchema lets derived array schema properties override inherited typedef properties\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-array-overrides\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test array override precedence\",\r\n      typeDefs: {\r\n        stringList: {\r\n          type: \"array\",\r\n          combineArray: true,\r\n          minItems: 1,\r\n          description: \"base array typedef\",\r\n          items: { type: \"string\" },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        names: {\r\n          type: \"array\",\r\n          extends: `${prefix}/stringList`,\r\n          combineArray: false,\r\n          minItems: 3,\r\n          description: \"derived array schema\",\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\r\n      expect(resolved.combineArray).to.equal(false);\r\n      expect(resolved.minItems).to.equal(3);\r\n      expect(resolved.description).to.equal(\"derived array schema\");\r\n      expect(resolved.items?.type).to.equal(\"string\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"resolveSchema resolves array items through multi-level typedef inheritance\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-array-multilevel\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test multi-level array typedef inheritance\",\r\n      typeDefs: {\r\n        c: {\r\n          type: \"array\",\r\n          combineArray: true,\r\n          items: { type: \"string\" },\r\n        },\r\n        b: {\r\n          type: \"array\",\r\n          extends: `${prefix}/c`,\r\n        },\r\n      },\r\n      settingDefs: {\r\n        names: {\r\n          type: \"array\",\r\n          extends: `${prefix}/b`,\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`)!;\r\n      expect(resolved.combineArray).to.equal(true);\r\n      expect(resolved.items?.type).to.equal(\"string\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"getResolvedSettingDef returns a resolved setting schema by name\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-setting-schema\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test resolved setting schema lookup\",\r\n      typeDefs: {\r\n        stringList: {\r\n          type: \"array\",\r\n          combineArray: true,\r\n          items: { type: \"string\" },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        names: {\r\n          type: \"array\",\r\n          extends: `${prefix}/stringList`,\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      const resolved = schemas.getResolvedSettingDef(`${prefix}/names`);\r\n      expect(resolved).to.not.be.undefined;\r\n      expect(resolved?.type).to.equal(\"array\");\r\n      expect(resolved).to.not.have.property(\"extends\");\r\n      expect(resolved?.combineArray).to.equal(true);\r\n      expect(resolved?.items?.type).to.equal(\"string\");\r\n      expect(schemas.getResolvedSettingDef(`${prefix}/missing`)).to.be.undefined;\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"getResolvedSettingDef resolves built-in workspace settings schemas\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n\r\n    const resolved = schemas.getResolvedSettingDef(\"itwin/core/workspace/settingsWorkspaces\");\r\n    expect(resolved).to.not.be.undefined;\r\n    expect(resolved?.type).to.equal(\"array\");\r\n    expect(resolved?.items?.type).to.equal(\"object\");\r\n    expect(resolved?.items).to.not.have.property(\"extends\");\r\n    expect(resolved?.items?.required).to.have.members([\"containerId\", \"baseUri\"]);\r\n    expect(resolved?.items?.properties).to.include.keys(\"dbName\", \"baseUri\", \"containerId\", \"storageType\", \"resourceName\", \"priority\");\r\n    expect(resolved?.items?.properties?.storageType.default).to.equal(\"azure\");\r\n  });\r\n\r\n  it(\"getResolvedSettingDef throws on circular typedef references\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-cycle\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test circular typedef resolution\",\r\n      typeDefs: {\r\n        a: {\r\n          type: \"object\",\r\n          extends: `${prefix}/b`,\r\n          properties: {\r\n            aOnly: { type: \"string\" },\r\n          },\r\n        },\r\n        b: {\r\n          type: \"object\",\r\n          extends: `${prefix}/a`,\r\n          properties: {\r\n            bOnly: { type: \"string\" },\r\n          },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        thing: {\r\n          type: \"object\",\r\n          extends: `${prefix}/a`,\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(\"circular typeDef reference detected\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"getResolvedSettingDef throws on nested recursive typedef references\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-nested-cycle\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test nested recursive typedef resolution\",\r\n      typeDefs: {\r\n        node: {\r\n          type: \"object\",\r\n          properties: {\r\n            child: {\r\n              type: \"object\",\r\n              extends: `${prefix}/node`,\r\n            },\r\n          },\r\n        },\r\n      },\r\n      settingDefs: {\r\n        root: {\r\n          type: \"object\",\r\n          extends: `${prefix}/node`,\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/root`)).to.throw(\"circular typeDef reference detected\");\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n  it(\"getResolvedSettingDef throws when an extends target cannot be found\", () => {\r\n    const schemas = IModelHost.settingsSchemas;\r\n    const prefix = \"resolve-schema-missing-typedef\";\r\n    schemas.removeGroup(prefix);\r\n    schemas.addGroup({\r\n      schemaPrefix: prefix,\r\n      description: \"schema used to test missing typedef resolution\",\r\n      settingDefs: {\r\n        thing: {\r\n          type: \"object\",\r\n          extends: `${prefix}/missingType`,\r\n        },\r\n      },\r\n    });\r\n\r\n    try {\r\n      expect(() => schemas.getResolvedSettingDef(`${prefix}/thing`)).to.throw(`typeDef ${prefix}/missingType does not exist`);\r\n    } finally {\r\n      schemas.removeGroup(prefix);\r\n    }\r\n  });\r\n\r\n});\r\n"]}

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

@@ -104,7 +104,10 @@ export interface SettingsSchemas {
     readonly [_implementationProhibited]: unknown;
     /** The map of each registered [[SettingGroupSchema]], accessed by its [[SettingGroupSchema.schemaPrefix]]. */
     readonly groups: ReadonlyMap<string, SettingGroupSchema>;
-    /** The map of each individual registered [[SettingSchema]] defining a [[Setting]], accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]). */
+    /** The map of each individual registered [[SettingSchema]] defining a [[Setting]], accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).
+     * Schemas in this map may include an [[SettingSchema.extends]] property referring to a registered type definition.
+     * Use [[resolveSchema]] to obtain the fully expanded schema.
+     */
     readonly settingDefs: ReadonlyMap<SettingName, SettingSchema>;
     /** The map of each individual registered [[SettingSchema]] defining a type that can be extended by other [[SettingSchema]]s via [[SettingSchema.extends]],
      * accessed by its fully-qualified name (including its [[SettingGroupSchema.schemaPrefix]]).
@@ -134,5 +137,16 @@ export interface SettingsSchemas {
     addDirectory(dirName: LocalDirName): void;
     /** Unregisters all [[settingDefs]] and [[typeDefs]] with the specified [[SettingGroupSchema.schemaPrefix]]. */
     removeGroup(schemaPrefix: string): void;
+    /**
+     * Looks up a setting schema in [[settingDefs]] and returns its resolved form.
+     * Resolution uses the [[typeDefs]] currently registered with this [[SettingsSchemas]] instance.
+     * @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
+     * ```ts
+     * const resolved = IModelHost.settingsSchemas.getResolvedSettingDef("app/font");
+     * ```
+     */
+    getResolvedSettingDef(settingName: SettingName): 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,gLAAgL;IAChL,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;CACzC"}
+{"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"}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/core-backend",
-  "version": "5.10.0-dev.16",
+  "version": "5.10.0-dev.19",
   "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.10.0-dev.16",
-    "@itwin/core-common": "5.10.0-dev.16",
-    "@itwin/core-geometry": "5.10.0-dev.16",
-    "@itwin/ecschema-metadata": "5.10.0-dev.16"
+    "@itwin/core-bentley": "5.10.0-dev.19",
+    "@itwin/core-geometry": "5.10.0-dev.19",
+    "@itwin/core-common": "5.10.0-dev.19",
+    "@itwin/ecschema-metadata": "5.10.0-dev.19"
   },
   "peerDependenciesMeta": {
     "@opentelemetry/api": {
@@ -77,17 +77,17 @@
     "marked": "^14.1.3",
     "sql-formatter": "^15.4.6",
     "webpack": "^5.97.1",
-    "@itwin/ecschema-locaters": "5.10.0-dev.16",
-    "@itwin/core-common": "5.10.0-dev.16",
-    "@itwin/ecsql-common": "5.10.0-dev.16",
-    "@itwin/core-bentley": "5.10.0-dev.16",
-    "@itwin/build-tools": "5.10.0-dev.16",
-    "@itwin/ecschema-metadata": "5.10.0-dev.16",
-    "@itwin/core-geometry": "5.10.0-dev.16",
-    "internal-tools": "3.0.0-dev.69"
+    "@itwin/build-tools": "5.10.0-dev.19",
+    "@itwin/core-bentley": "5.10.0-dev.19",
+    "@itwin/core-geometry": "5.10.0-dev.19",
+    "@itwin/ecschema-locaters": "5.10.0-dev.19",
+    "@itwin/core-common": "5.10.0-dev.19",
+    "@itwin/ecschema-metadata": "5.10.0-dev.19",
+    "internal-tools": "3.0.0-dev.69",
+    "@itwin/ecsql-common": "5.10.0-dev.19"
   },
   "dependencies": {
-    "@bentley/imodeljs-native": "5.10.22",
+    "@bentley/imodeljs-native": "5.10.27",
     "@itwin/object-storage-azure": "^3.0.4",
     "@azure/storage-blob": "^12.28.0",
     "form-data": "^4.0.4",