@itwin/core-backend 3.4.0-dev.9 → 3.4.1

package/lib/cjs/Category.js

@@ -1,244 +1,244 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Categories
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpatialCategory = exports.DrawingCategory = exports.Category = exports.SubCategory = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-const Element_1 = require("./Element");
-const IModelDb_1 = require("./IModelDb");
-const NavigationRelationship_1 = require("./NavigationRelationship");
-/** Defines the appearance for graphics in Geometric elements
- * @public
- */
-class SubCategory extends Element_1.DefinitionElement {
-    /** @internal */
-    constructor(props, iModel) {
-        super(props, iModel);
-        this.appearance = new core_common_1.SubCategoryAppearance(props.appearance);
-        this.description = core_bentley_1.JsonUtils.asString(props.description);
-    }
-    /** @internal */
-    static get className() { return "SubCategory"; }
-    /** @internal */
-    toJSON() {
-        const val = super.toJSON();
-        val.appearance = this.appearance.toJSON();
-        if (this.description && this.description.length > 0)
-            val.description = this.description;
-        return val;
-    }
-    /** Get the SubCategory's name (its Code value). */
-    getSubCategoryName() { return this.code.value; }
-    /** Get the Id of the SubCategory. */
-    getSubCategoryId() { return this.id; }
-    /** Get the Id of this SubCategory's parent Category. */
-    getCategoryId() { return this.parent ? this.parent.id : core_bentley_1.Id64.invalid; }
-    /** Check if this is the default SubCategory of its parent Category. */
-    get isDefaultSubCategory() { return IModelDb_1.IModelDb.getDefaultSubCategoryId(this.getCategoryId()) === this.getSubCategoryId(); }
-    /** Create a Code for a SubCategory given a name that is meant to be unique within the scope of the specified parent Category.
-     * @param iModel  The IModel
-     * @param parentCategoryId The Id of the parent Category that owns the SubCategory and provides the scope for its name.
-     * @param codeValue The name of the SubCategory
-     */
-    static createCode(iModel, parentCategoryId, codeValue) {
-        const codeSpec = iModel.codeSpecs.getByName(core_common_1.BisCodeSpec.subCategory);
-        return new core_common_1.Code({ spec: codeSpec.id, scope: parentCategoryId, value: codeValue });
-    }
-    /** Create a new SubCategory
-     * @param iModelDb The iModel
-     * @param parentCategoryId Create the new SubCategory as a child of this [[Category]]
-     * @param name The name of the SubCategory
-     * @param appearance The appearance settings to use for this SubCategory
-     * @returns The newly constructed SubCategory element.
-     * @throws [[IModelError]] if unable to create the element.
-     */
-    static create(iModelDb, parentCategoryId, name, appearance) {
-        if (appearance instanceof core_common_1.SubCategoryAppearance)
-            appearance = appearance.toJSON();
-        const parentCategory = iModelDb.elements.getElement(parentCategoryId);
-        const subCategoryProps = {
-            classFullName: this.classFullName,
-            model: parentCategory.model,
-            parent: new NavigationRelationship_1.CategoryOwnsSubCategories(parentCategoryId),
-            code: this.createCode(iModelDb, parentCategoryId, name),
-            appearance,
-        };
-        return new SubCategory(subCategoryProps, iModelDb);
-    }
-    /** Insert a new SubCategory
-     * @param iModelDb Insert into this iModel
-     * @param parentCategoryId Insert the new SubCategory as a child of this Category
-     * @param name The name of the SubCategory
-     * @param appearance The appearance settings to use for this SubCategory
-     * @returns The Id of the newly inserted SubCategory element.
-     * @throws [[IModelError]] if unable to insert the element.
-     */
-    static insert(iModelDb, parentCategoryId, name, appearance) {
-        const subCategory = this.create(iModelDb, parentCategoryId, name, appearance);
-        return iModelDb.elements.insertElement(subCategory.toJSON());
-    }
-}
-exports.SubCategory = SubCategory;
-/** A Category element is the target of the `category` member of [[GeometricElement]].
- * @public
- */
-class Category extends Element_1.DefinitionElement {
-    /** @internal */
-    constructor(props, iModel) {
-        super(props, iModel);
-        this.rank = core_common_1.Rank.User;
-        this.rank = core_bentley_1.JsonUtils.asInt(props.rank);
-        this.description = core_bentley_1.JsonUtils.asString(props.description);
-    }
-    /** @internal */
-    static get className() { return "Category"; }
-    /** @internal */
-    toJSON() {
-        const val = super.toJSON();
-        val.rank = this.rank;
-        if (this.description && this.description.length > 0)
-            val.description = this.description;
-        return val;
-    }
-    /** Get the Id of the default SubCategory for this Category. */
-    myDefaultSubCategoryId() { return IModelDb_1.IModelDb.getDefaultSubCategoryId(this.id); }
-    /** Set the appearance of the default SubCategory for this Category */
-    setDefaultAppearance(props) {
-        if (props instanceof core_common_1.SubCategoryAppearance)
-            props = props.toJSON();
-        const subCat = this.iModel.elements.getElement(this.myDefaultSubCategoryId());
-        subCat.appearance = new core_common_1.SubCategoryAppearance(props);
-        this.iModel.elements.updateElement(subCat.toJSON());
-    }
-}
-exports.Category = Category;
-/** Categorizes 2d GeometricElements.
- * @public
- */
-class DrawingCategory extends Category {
-    /** @internal */
-    static get className() { return "DrawingCategory"; }
-    /** Construct a DrawingCategory
-     * @param opts  The properties of the new DrawingCategory
-     * @param iModel The IModelDb where the DrawingCategory may be inserted.
-     * @internal
-     */
-    constructor(opts, iModel) { super(opts, iModel); }
-    /** Get the name of the CodeSpec that is used by DrawingCategory objects. */
-    static getCodeSpecName() { return core_common_1.BisCodeSpec.drawingCategory; }
-    /** Looks up the CategoryId of a DrawingCategory by model and name */
-    static queryCategoryIdByName(iModel, scopeModelId, categoryName) {
-        const code = DrawingCategory.createCode(iModel, scopeModelId, categoryName);
-        return iModel.elements.queryElementIdByCode(code);
-    }
-    /** Create a Code for a DrawingCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.
-     * @param iModel  The IModel
-     * @param scopeModelId The Id of the DefinitionModel that contains the DrawingCategory and provides the scope for its name.
-     * @param codeValue The name of the category
-     * @return A drawing category Code
-     */
-    static createCode(iModel, scopeModelId, codeValue) {
-        const codeSpec = iModel.codeSpecs.getByName(DrawingCategory.getCodeSpecName());
-        return new core_common_1.Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });
-    }
-    /** Create a new DrawingCategory
-     * @param iModelDb The iModel
-     * @param definitionModelId The [[DefinitionModel]]
-     * @param name The name of the DrawingCategory
-     * @returns The newly constructed DrawingCategory element.
-     * @throws [[IModelError]] if unable to create the element.
-     */
-    static create(iModelDb, definitionModelId, name) {
-        const categoryProps = {
-            classFullName: this.classFullName,
-            model: definitionModelId,
-            code: this.createCode(iModelDb, definitionModelId, name),
-            isPrivate: false,
-        };
-        return new DrawingCategory(categoryProps, iModelDb);
-    }
-    /** Insert a new DrawingCategory
-     * @param iModelDb Insert into this iModel
-     * @param definitionModelId Insert the new DrawingCategory into this [[DefinitionModel]]
-     * @param name The name of the DrawingCategory
-     * @param defaultAppearance The appearance settings to use for the default SubCategory of this DrawingCategory
-     * @returns The Id of the newly inserted DrawingCategory element.
-     * @throws [[IModelError]] if unable to insert the element.
-     */
-    static insert(iModelDb, definitionModelId, name, defaultAppearance) {
-        const category = this.create(iModelDb, definitionModelId, name);
-        const elements = iModelDb.elements;
-        category.id = elements.insertElement(category.toJSON());
-        category.setDefaultAppearance(defaultAppearance);
-        return category.id;
-    }
-}
-exports.DrawingCategory = DrawingCategory;
-/** Categorizes SpatialElements. See [how to create a SpatialCategory]$(docs/learning/backend/CreateElements.md#SpatialCategory).
- * @public
- */
-class SpatialCategory extends Category {
-    /** @internal */
-    static get className() { return "SpatialCategory"; }
-    /** Construct a SpatialCategory
-     * @param opts  The properties of the new SpatialCategory
-     * @param iModel The IModelDb where the SpatialCategory may be inserted.
-     * @internal
-     */
-    constructor(opts, iModel) { super(opts, iModel); }
-    /** Get the name of the CodeSpec that is used by SpatialCategory objects. */
-    static getCodeSpecName() { return core_common_1.BisCodeSpec.spatialCategory; }
-    /** Looks up the CategoryId of a SpatialCategory by model and name */
-    static queryCategoryIdByName(iModel, scopeModelId, categoryName) {
-        const code = SpatialCategory.createCode(iModel, scopeModelId, categoryName);
-        return iModel.elements.queryElementIdByCode(code);
-    }
-    /** Create a Code for a SpatialCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.
-     * @param iModel  The IModel
-     * @param scopeModelId The Id of the DefinitionModel that contains the SpatialCategory and provides the scope for its name.
-     * @param codeValue The name of the category
-     * @return A spatial category Code
-     */
-    static createCode(iModel, scopeModelId, codeValue) {
-        const codeSpec = iModel.codeSpecs.getByName(SpatialCategory.getCodeSpecName());
-        return new core_common_1.Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });
-    }
-    /** Create a new SpatialCategory
-     * @param iModelDb The iModel
-     * @param definitionModelId The [[DefinitionModel]]
-     * @param name The name/CodeValue of the SpatialCategory
-     * @returns The newly constructed SpatialCategory element.
-     * @throws [[IModelError]] if unable to create the element.
-     */
-    static create(iModelDb, definitionModelId, name) {
-        const categoryProps = {
-            classFullName: this.classFullName,
-            model: definitionModelId,
-            code: this.createCode(iModelDb, definitionModelId, name),
-            isPrivate: false,
-        };
-        return new SpatialCategory(categoryProps, iModelDb);
-    }
-    /** Insert a new SpatialCategory
-     * @param iModelDb Insert into this iModel
-     * @param definitionModelId Insert the new SpatialCategory into this DefinitionModel
-     * @param name The name of the SpatialCategory
-     * @param defaultAppearance The appearance settings to use for the default SubCategory of this SpatialCategory
-     * @returns The Id of the newly inserted SpatialCategory element.
-     * @throws [[IModelError]] if unable to insert the element.
-     */
-    static insert(iModelDb, definitionModelId, name, defaultAppearance) {
-        const category = this.create(iModelDb, definitionModelId, name);
-        category.id = iModelDb.elements.insertElement(category.toJSON());
-        category.setDefaultAppearance(defaultAppearance);
-        return category.id;
-    }
-}
-exports.SpatialCategory = SpatialCategory;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Categories
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpatialCategory = exports.DrawingCategory = exports.Category = exports.SubCategory = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const Element_1 = require("./Element");
+const IModelDb_1 = require("./IModelDb");
+const NavigationRelationship_1 = require("./NavigationRelationship");
+/** Defines the appearance for graphics in Geometric elements
+ * @public
+ */
+class SubCategory extends Element_1.DefinitionElement {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this.appearance = new core_common_1.SubCategoryAppearance(props.appearance);
+        this.description = core_bentley_1.JsonUtils.asString(props.description);
+    }
+    /** @internal */
+    static get className() { return "SubCategory"; }
+    /** @internal */
+    toJSON() {
+        const val = super.toJSON();
+        val.appearance = this.appearance.toJSON();
+        if (this.description && this.description.length > 0)
+            val.description = this.description;
+        return val;
+    }
+    /** Get the SubCategory's name (its Code value). */
+    getSubCategoryName() { return this.code.value; }
+    /** Get the Id of the SubCategory. */
+    getSubCategoryId() { return this.id; }
+    /** Get the Id of this SubCategory's parent Category. */
+    getCategoryId() { return this.parent ? this.parent.id : core_bentley_1.Id64.invalid; }
+    /** Check if this is the default SubCategory of its parent Category. */
+    get isDefaultSubCategory() { return IModelDb_1.IModelDb.getDefaultSubCategoryId(this.getCategoryId()) === this.getSubCategoryId(); }
+    /** Create a Code for a SubCategory given a name that is meant to be unique within the scope of the specified parent Category.
+     * @param iModel  The IModel
+     * @param parentCategoryId The Id of the parent Category that owns the SubCategory and provides the scope for its name.
+     * @param codeValue The name of the SubCategory
+     */
+    static createCode(iModel, parentCategoryId, codeValue) {
+        const codeSpec = iModel.codeSpecs.getByName(core_common_1.BisCodeSpec.subCategory);
+        return new core_common_1.Code({ spec: codeSpec.id, scope: parentCategoryId, value: codeValue });
+    }
+    /** Create a new SubCategory
+     * @param iModelDb The iModel
+     * @param parentCategoryId Create the new SubCategory as a child of this [[Category]]
+     * @param name The name of the SubCategory
+     * @param appearance The appearance settings to use for this SubCategory
+     * @returns The newly constructed SubCategory element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb, parentCategoryId, name, appearance) {
+        if (appearance instanceof core_common_1.SubCategoryAppearance)
+            appearance = appearance.toJSON();
+        const parentCategory = iModelDb.elements.getElement(parentCategoryId);
+        const subCategoryProps = {
+            classFullName: this.classFullName,
+            model: parentCategory.model,
+            parent: new NavigationRelationship_1.CategoryOwnsSubCategories(parentCategoryId),
+            code: this.createCode(iModelDb, parentCategoryId, name),
+            appearance,
+        };
+        return new SubCategory(subCategoryProps, iModelDb);
+    }
+    /** Insert a new SubCategory
+     * @param iModelDb Insert into this iModel
+     * @param parentCategoryId Insert the new SubCategory as a child of this Category
+     * @param name The name of the SubCategory
+     * @param appearance The appearance settings to use for this SubCategory
+     * @returns The Id of the newly inserted SubCategory element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb, parentCategoryId, name, appearance) {
+        const subCategory = this.create(iModelDb, parentCategoryId, name, appearance);
+        return iModelDb.elements.insertElement(subCategory.toJSON());
+    }
+}
+exports.SubCategory = SubCategory;
+/** A Category element is the target of the `category` member of [[GeometricElement]].
+ * @public
+ */
+class Category extends Element_1.DefinitionElement {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this.rank = core_common_1.Rank.User;
+        this.rank = core_bentley_1.JsonUtils.asInt(props.rank);
+        this.description = core_bentley_1.JsonUtils.asString(props.description);
+    }
+    /** @internal */
+    static get className() { return "Category"; }
+    /** @internal */
+    toJSON() {
+        const val = super.toJSON();
+        val.rank = this.rank;
+        if (this.description && this.description.length > 0)
+            val.description = this.description;
+        return val;
+    }
+    /** Get the Id of the default SubCategory for this Category. */
+    myDefaultSubCategoryId() { return IModelDb_1.IModelDb.getDefaultSubCategoryId(this.id); }
+    /** Set the appearance of the default SubCategory for this Category */
+    setDefaultAppearance(props) {
+        if (props instanceof core_common_1.SubCategoryAppearance)
+            props = props.toJSON();
+        const subCat = this.iModel.elements.getElement(this.myDefaultSubCategoryId());
+        subCat.appearance = new core_common_1.SubCategoryAppearance(props);
+        this.iModel.elements.updateElement(subCat.toJSON());
+    }
+}
+exports.Category = Category;
+/** Categorizes 2d GeometricElements.
+ * @public
+ */
+class DrawingCategory extends Category {
+    /** @internal */
+    static get className() { return "DrawingCategory"; }
+    /** Construct a DrawingCategory
+     * @param opts  The properties of the new DrawingCategory
+     * @param iModel The IModelDb where the DrawingCategory may be inserted.
+     * @internal
+     */
+    constructor(opts, iModel) { super(opts, iModel); }
+    /** Get the name of the CodeSpec that is used by DrawingCategory objects. */
+    static getCodeSpecName() { return core_common_1.BisCodeSpec.drawingCategory; }
+    /** Looks up the CategoryId of a DrawingCategory by model and name */
+    static queryCategoryIdByName(iModel, scopeModelId, categoryName) {
+        const code = DrawingCategory.createCode(iModel, scopeModelId, categoryName);
+        return iModel.elements.queryElementIdByCode(code);
+    }
+    /** Create a Code for a DrawingCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     * @param iModel  The IModel
+     * @param scopeModelId The Id of the DefinitionModel that contains the DrawingCategory and provides the scope for its name.
+     * @param codeValue The name of the category
+     * @return A drawing category Code
+     */
+    static createCode(iModel, scopeModelId, codeValue) {
+        const codeSpec = iModel.codeSpecs.getByName(DrawingCategory.getCodeSpecName());
+        return new core_common_1.Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });
+    }
+    /** Create a new DrawingCategory
+     * @param iModelDb The iModel
+     * @param definitionModelId The [[DefinitionModel]]
+     * @param name The name of the DrawingCategory
+     * @returns The newly constructed DrawingCategory element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb, definitionModelId, name) {
+        const categoryProps = {
+            classFullName: this.classFullName,
+            model: definitionModelId,
+            code: this.createCode(iModelDb, definitionModelId, name),
+            isPrivate: false,
+        };
+        return new DrawingCategory(categoryProps, iModelDb);
+    }
+    /** Insert a new DrawingCategory
+     * @param iModelDb Insert into this iModel
+     * @param definitionModelId Insert the new DrawingCategory into this [[DefinitionModel]]
+     * @param name The name of the DrawingCategory
+     * @param defaultAppearance The appearance settings to use for the default SubCategory of this DrawingCategory
+     * @returns The Id of the newly inserted DrawingCategory element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb, definitionModelId, name, defaultAppearance) {
+        const category = this.create(iModelDb, definitionModelId, name);
+        const elements = iModelDb.elements;
+        category.id = elements.insertElement(category.toJSON());
+        category.setDefaultAppearance(defaultAppearance);
+        return category.id;
+    }
+}
+exports.DrawingCategory = DrawingCategory;
+/** Categorizes SpatialElements. See [how to create a SpatialCategory]$(docs/learning/backend/CreateElements.md#SpatialCategory).
+ * @public
+ */
+class SpatialCategory extends Category {
+    /** @internal */
+    static get className() { return "SpatialCategory"; }
+    /** Construct a SpatialCategory
+     * @param opts  The properties of the new SpatialCategory
+     * @param iModel The IModelDb where the SpatialCategory may be inserted.
+     * @internal
+     */
+    constructor(opts, iModel) { super(opts, iModel); }
+    /** Get the name of the CodeSpec that is used by SpatialCategory objects. */
+    static getCodeSpecName() { return core_common_1.BisCodeSpec.spatialCategory; }
+    /** Looks up the CategoryId of a SpatialCategory by model and name */
+    static queryCategoryIdByName(iModel, scopeModelId, categoryName) {
+        const code = SpatialCategory.createCode(iModel, scopeModelId, categoryName);
+        return iModel.elements.queryElementIdByCode(code);
+    }
+    /** Create a Code for a SpatialCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     * @param iModel  The IModel
+     * @param scopeModelId The Id of the DefinitionModel that contains the SpatialCategory and provides the scope for its name.
+     * @param codeValue The name of the category
+     * @return A spatial category Code
+     */
+    static createCode(iModel, scopeModelId, codeValue) {
+        const codeSpec = iModel.codeSpecs.getByName(SpatialCategory.getCodeSpecName());
+        return new core_common_1.Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });
+    }
+    /** Create a new SpatialCategory
+     * @param iModelDb The iModel
+     * @param definitionModelId The [[DefinitionModel]]
+     * @param name The name/CodeValue of the SpatialCategory
+     * @returns The newly constructed SpatialCategory element.
+     * @throws [[IModelError]] if unable to create the element.
+     */
+    static create(iModelDb, definitionModelId, name) {
+        const categoryProps = {
+            classFullName: this.classFullName,
+            model: definitionModelId,
+            code: this.createCode(iModelDb, definitionModelId, name),
+            isPrivate: false,
+        };
+        return new SpatialCategory(categoryProps, iModelDb);
+    }
+    /** Insert a new SpatialCategory
+     * @param iModelDb Insert into this iModel
+     * @param definitionModelId Insert the new SpatialCategory into this DefinitionModel
+     * @param name The name of the SpatialCategory
+     * @param defaultAppearance The appearance settings to use for the default SubCategory of this SpatialCategory
+     * @returns The Id of the newly inserted SpatialCategory element.
+     * @throws [[IModelError]] if unable to insert the element.
+     */
+    static insert(iModelDb, definitionModelId, name, defaultAppearance) {
+        const category = this.create(iModelDb, definitionModelId, name);
+        category.id = iModelDb.elements.insertElement(category.toJSON());
+        category.setDefaultAppearance(defaultAppearance);
+        return category.id;
+    }
+}
+exports.SpatialCategory = SpatialCategory;
 //# sourceMappingURL=Category.js.map

package/lib/cjs/Category.js.map

@@ -1 +1 @@
-{"version":3,"file":"Category.js","sourceRoot":"","sources":["../../src/Category.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/** @packageDocumentation\r\n * @module Categories\r\n */\r\n\r\nimport { Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  BisCodeSpec, CategoryProps, Code, CodeScopeProps, CodeSpec, ElementProps, Rank, SubCategoryAppearance, SubCategoryProps,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { CategoryOwnsSubCategories } from \"./NavigationRelationship\";\r\n\r\n/** Defines the appearance for graphics in Geometric elements\r\n * @public\r\n */\r\nexport class SubCategory extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SubCategory\"; }\r\n  /** The Appearance parameters for this SubCategory */\r\n  public appearance: SubCategoryAppearance;\r\n  /** Optional description of this SubCategory. */\r\n  public description?: string;\r\n\r\n  /** @internal */\r\n  public constructor(props: SubCategoryProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.appearance = new SubCategoryAppearance(props.appearance);\r\n    this.description = JsonUtils.asString(props.description);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): SubCategoryProps {\r\n    const val = super.toJSON() as SubCategoryProps;\r\n    val.appearance = this.appearance.toJSON();\r\n    if (this.description && this.description.length > 0)\r\n      val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Get the SubCategory's name (its Code value). */\r\n  public getSubCategoryName(): string { return this.code.value; }\r\n  /** Get the Id of the SubCategory. */\r\n  public getSubCategoryId(): Id64String { return this.id; }\r\n  /** Get the Id of this SubCategory's parent Category. */\r\n  public getCategoryId(): Id64String { return this.parent ? this.parent.id : Id64.invalid; }\r\n  /** Check if this is the default SubCategory of its parent Category. */\r\n  public get isDefaultSubCategory(): boolean { return IModelDb.getDefaultSubCategoryId(this.getCategoryId()) === this.getSubCategoryId(); }\r\n\r\n  /** Create a Code for a SubCategory given a name that is meant to be unique within the scope of the specified parent Category.\r\n   * @param iModel  The IModel\r\n   * @param parentCategoryId The Id of the parent Category that owns the SubCategory and provides the scope for its name.\r\n   * @param codeValue The name of the SubCategory\r\n   */\r\n  public static createCode(iModel: IModelDb, parentCategoryId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.subCategory);\r\n    return new Code({ spec: codeSpec.id, scope: parentCategoryId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new SubCategory\r\n   * @param iModelDb The iModel\r\n   * @param parentCategoryId Create the new SubCategory as a child of this [[Category]]\r\n   * @param name The name of the SubCategory\r\n   * @param appearance The appearance settings to use for this SubCategory\r\n   * @returns The newly constructed SubCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): SubCategory {\r\n    if (appearance instanceof SubCategoryAppearance)\r\n      appearance = appearance.toJSON();\r\n\r\n    const parentCategory = iModelDb.elements.getElement<Category>(parentCategoryId);\r\n    const subCategoryProps: SubCategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: parentCategory.model,\r\n      parent: new CategoryOwnsSubCategories(parentCategoryId),\r\n      code: this.createCode(iModelDb, parentCategoryId, name),\r\n      appearance,\r\n    };\r\n    return new SubCategory(subCategoryProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a new SubCategory\r\n   * @param iModelDb Insert into this iModel\r\n   * @param parentCategoryId Insert the new SubCategory as a child of this Category\r\n   * @param name The name of the SubCategory\r\n   * @param appearance The appearance settings to use for this SubCategory\r\n   * @returns The Id of the newly inserted SubCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const subCategory = this.create(iModelDb, parentCategoryId, name, appearance);\r\n    return iModelDb.elements.insertElement(subCategory.toJSON());\r\n  }\r\n}\r\n\r\n/** A Category element is the target of the `category` member of [[GeometricElement]].\r\n * @public\r\n */\r\nexport class Category extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"Category\"; }\r\n  public rank: Rank = Rank.User;\r\n  public description?: string;\r\n\r\n  /** @internal */\r\n  public constructor(props: CategoryProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.rank = JsonUtils.asInt(props.rank);\r\n    this.description = JsonUtils.asString(props.description);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): CategoryProps {\r\n    const val = super.toJSON() as CategoryProps;\r\n    val.rank = this.rank;\r\n    if (this.description && this.description.length > 0)\r\n      val.description = this.description;\r\n    return val;\r\n  }\r\n\r\n  /** Get the Id of the default SubCategory for this Category. */\r\n  public myDefaultSubCategoryId(): Id64String { return IModelDb.getDefaultSubCategoryId(this.id); }\r\n\r\n  /** Set the appearance of the default SubCategory for this Category */\r\n  public setDefaultAppearance(props: SubCategoryAppearance.Props | SubCategoryAppearance): void {\r\n    if (props instanceof SubCategoryAppearance)\r\n      props = props.toJSON();\r\n\r\n    const subCat = this.iModel.elements.getElement<SubCategory>(this.myDefaultSubCategoryId());\r\n    subCat.appearance = new SubCategoryAppearance(props);\r\n    this.iModel.elements.updateElement(subCat.toJSON());\r\n  }\r\n}\r\n\r\n/** Categorizes 2d GeometricElements.\r\n * @public\r\n */\r\nexport class DrawingCategory extends Category {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DrawingCategory\"; }\r\n\r\n  /** Construct a DrawingCategory\r\n   * @param opts  The properties of the new DrawingCategory\r\n   * @param iModel The IModelDb where the DrawingCategory may be inserted.\r\n   * @internal\r\n   */\r\n  public constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\r\n\r\n  /** Get the name of the CodeSpec that is used by DrawingCategory objects. */\r\n  public static getCodeSpecName(): string { return BisCodeSpec.drawingCategory; }\r\n\r\n  /** Looks up the CategoryId of a DrawingCategory by model and name */\r\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\r\n    const code: Code = DrawingCategory.createCode(iModel, scopeModelId, categoryName);\r\n    return iModel.elements.queryElementIdByCode(code);\r\n  }\r\n\r\n  /** Create a Code for a DrawingCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModel\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the DrawingCategory and provides the scope for its name.\r\n   * @param codeValue The name of the category\r\n   * @return A drawing category Code\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(DrawingCategory.getCodeSpecName());\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new DrawingCategory\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the DrawingCategory\r\n   * @returns The newly constructed DrawingCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): DrawingCategory {\r\n    const categoryProps: CategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      isPrivate: false,\r\n    };\r\n    return new DrawingCategory(categoryProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a new DrawingCategory\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DrawingCategory into this [[DefinitionModel]]\r\n   * @param name The name of the DrawingCategory\r\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this DrawingCategory\r\n   * @returns The Id of the newly inserted DrawingCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const category = this.create(iModelDb, definitionModelId, name);\r\n    const elements = iModelDb.elements;\r\n    category.id = elements.insertElement(category.toJSON());\r\n    category.setDefaultAppearance(defaultAppearance);\r\n    return category.id;\r\n  }\r\n}\r\n\r\n/** Categorizes SpatialElements. See [how to create a SpatialCategory]$(docs/learning/backend/CreateElements.md#SpatialCategory).\r\n * @public\r\n */\r\nexport class SpatialCategory extends Category {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialCategory\"; }\r\n  /** Construct a SpatialCategory\r\n   * @param opts  The properties of the new SpatialCategory\r\n   * @param iModel The IModelDb where the SpatialCategory may be inserted.\r\n   * @internal\r\n   */\r\n  public constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\r\n\r\n  /** Get the name of the CodeSpec that is used by SpatialCategory objects. */\r\n  public static getCodeSpecName(): string { return BisCodeSpec.spatialCategory; }\r\n\r\n  /** Looks up the CategoryId of a SpatialCategory by model and name */\r\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\r\n    const code: Code = SpatialCategory.createCode(iModel, scopeModelId, categoryName);\r\n    return iModel.elements.queryElementIdByCode(code);\r\n  }\r\n\r\n  /** Create a Code for a SpatialCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModel\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the SpatialCategory and provides the scope for its name.\r\n   * @param codeValue The name of the category\r\n   * @return A spatial category Code\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(SpatialCategory.getCodeSpecName());\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /** Create a new SpatialCategory\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the SpatialCategory\r\n   * @returns The newly constructed SpatialCategory element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): SpatialCategory {\r\n    const categoryProps: CategoryProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      isPrivate: false,\r\n    };\r\n    return new SpatialCategory(categoryProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a new SpatialCategory\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new SpatialCategory into this DefinitionModel\r\n   * @param name The name of the SpatialCategory\r\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this SpatialCategory\r\n   * @returns The Id of the newly inserted SpatialCategory element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\r\n    const category = this.create(iModelDb, definitionModelId, name);\r\n    category.id = iModelDb.elements.insertElement(category.toJSON());\r\n    category.setDefaultAppearance(defaultAppearance);\r\n    return category.id;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Category.js","sourceRoot":"","sources":["../../src/Category.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/** @packageDocumentation\n * @module Categories\n */\n\nimport { Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\nimport {\n  BisCodeSpec, CategoryProps, Code, CodeScopeProps, CodeSpec, ElementProps, Rank, SubCategoryAppearance, SubCategoryProps,\n} from \"@itwin/core-common\";\nimport { DefinitionElement } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\nimport { CategoryOwnsSubCategories } from \"./NavigationRelationship\";\n\n/** Defines the appearance for graphics in Geometric elements\n * @public\n */\nexport class SubCategory extends DefinitionElement {\n  /** @internal */\n  public static override get className(): string { return \"SubCategory\"; }\n  /** The Appearance parameters for this SubCategory */\n  public appearance: SubCategoryAppearance;\n  /** Optional description of this SubCategory. */\n  public description?: string;\n\n  /** @internal */\n  public constructor(props: SubCategoryProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.appearance = new SubCategoryAppearance(props.appearance);\n    this.description = JsonUtils.asString(props.description);\n  }\n\n  /** @internal */\n  public override toJSON(): SubCategoryProps {\n    const val = super.toJSON() as SubCategoryProps;\n    val.appearance = this.appearance.toJSON();\n    if (this.description && this.description.length > 0)\n      val.description = this.description;\n    return val;\n  }\n\n  /** Get the SubCategory's name (its Code value). */\n  public getSubCategoryName(): string { return this.code.value; }\n  /** Get the Id of the SubCategory. */\n  public getSubCategoryId(): Id64String { return this.id; }\n  /** Get the Id of this SubCategory's parent Category. */\n  public getCategoryId(): Id64String { return this.parent ? this.parent.id : Id64.invalid; }\n  /** Check if this is the default SubCategory of its parent Category. */\n  public get isDefaultSubCategory(): boolean { return IModelDb.getDefaultSubCategoryId(this.getCategoryId()) === this.getSubCategoryId(); }\n\n  /** Create a Code for a SubCategory given a name that is meant to be unique within the scope of the specified parent Category.\n   * @param iModel  The IModel\n   * @param parentCategoryId The Id of the parent Category that owns the SubCategory and provides the scope for its name.\n   * @param codeValue The name of the SubCategory\n   */\n  public static createCode(iModel: IModelDb, parentCategoryId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.subCategory);\n    return new Code({ spec: codeSpec.id, scope: parentCategoryId, value: codeValue });\n  }\n\n  /** Create a new SubCategory\n   * @param iModelDb The iModel\n   * @param parentCategoryId Create the new SubCategory as a child of this [[Category]]\n   * @param name The name of the SubCategory\n   * @param appearance The appearance settings to use for this SubCategory\n   * @returns The newly constructed SubCategory element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): SubCategory {\n    if (appearance instanceof SubCategoryAppearance)\n      appearance = appearance.toJSON();\n\n    const parentCategory = iModelDb.elements.getElement<Category>(parentCategoryId);\n    const subCategoryProps: SubCategoryProps = {\n      classFullName: this.classFullName,\n      model: parentCategory.model,\n      parent: new CategoryOwnsSubCategories(parentCategoryId),\n      code: this.createCode(iModelDb, parentCategoryId, name),\n      appearance,\n    };\n    return new SubCategory(subCategoryProps, iModelDb);\n  }\n\n  /** Insert a new SubCategory\n   * @param iModelDb Insert into this iModel\n   * @param parentCategoryId Insert the new SubCategory as a child of this Category\n   * @param name The name of the SubCategory\n   * @param appearance The appearance settings to use for this SubCategory\n   * @returns The Id of the newly inserted SubCategory element.\n   * @throws [[IModelError]] if unable to insert the element.\n   */\n  public static insert(iModelDb: IModelDb, parentCategoryId: Id64String, name: string, appearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\n    const subCategory = this.create(iModelDb, parentCategoryId, name, appearance);\n    return iModelDb.elements.insertElement(subCategory.toJSON());\n  }\n}\n\n/** A Category element is the target of the `category` member of [[GeometricElement]].\n * @public\n */\nexport class Category extends DefinitionElement {\n  /** @internal */\n  public static override get className(): string { return \"Category\"; }\n  public rank: Rank = Rank.User;\n  public description?: string;\n\n  /** @internal */\n  public constructor(props: CategoryProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.rank = JsonUtils.asInt(props.rank);\n    this.description = JsonUtils.asString(props.description);\n  }\n\n  /** @internal */\n  public override toJSON(): CategoryProps {\n    const val = super.toJSON() as CategoryProps;\n    val.rank = this.rank;\n    if (this.description && this.description.length > 0)\n      val.description = this.description;\n    return val;\n  }\n\n  /** Get the Id of the default SubCategory for this Category. */\n  public myDefaultSubCategoryId(): Id64String { return IModelDb.getDefaultSubCategoryId(this.id); }\n\n  /** Set the appearance of the default SubCategory for this Category */\n  public setDefaultAppearance(props: SubCategoryAppearance.Props | SubCategoryAppearance): void {\n    if (props instanceof SubCategoryAppearance)\n      props = props.toJSON();\n\n    const subCat = this.iModel.elements.getElement<SubCategory>(this.myDefaultSubCategoryId());\n    subCat.appearance = new SubCategoryAppearance(props);\n    this.iModel.elements.updateElement(subCat.toJSON());\n  }\n}\n\n/** Categorizes 2d GeometricElements.\n * @public\n */\nexport class DrawingCategory extends Category {\n  /** @internal */\n  public static override get className(): string { return \"DrawingCategory\"; }\n\n  /** Construct a DrawingCategory\n   * @param opts  The properties of the new DrawingCategory\n   * @param iModel The IModelDb where the DrawingCategory may be inserted.\n   * @internal\n   */\n  public constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\n\n  /** Get the name of the CodeSpec that is used by DrawingCategory objects. */\n  public static getCodeSpecName(): string { return BisCodeSpec.drawingCategory; }\n\n  /** Looks up the CategoryId of a DrawingCategory by model and name */\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\n    const code: Code = DrawingCategory.createCode(iModel, scopeModelId, categoryName);\n    return iModel.elements.queryElementIdByCode(code);\n  }\n\n  /** Create a Code for a DrawingCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModel\n   * @param scopeModelId The Id of the DefinitionModel that contains the DrawingCategory and provides the scope for its name.\n   * @param codeValue The name of the category\n   * @return A drawing category Code\n   */\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(DrawingCategory.getCodeSpecName());\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\n  }\n\n  /** Create a new DrawingCategory\n   * @param iModelDb The iModel\n   * @param definitionModelId The [[DefinitionModel]]\n   * @param name The name of the DrawingCategory\n   * @returns The newly constructed DrawingCategory element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): DrawingCategory {\n    const categoryProps: CategoryProps = {\n      classFullName: this.classFullName,\n      model: definitionModelId,\n      code: this.createCode(iModelDb, definitionModelId, name),\n      isPrivate: false,\n    };\n    return new DrawingCategory(categoryProps, iModelDb);\n  }\n\n  /** Insert a new DrawingCategory\n   * @param iModelDb Insert into this iModel\n   * @param definitionModelId Insert the new DrawingCategory into this [[DefinitionModel]]\n   * @param name The name of the DrawingCategory\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this DrawingCategory\n   * @returns The Id of the newly inserted DrawingCategory element.\n   * @throws [[IModelError]] if unable to insert the element.\n   */\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\n    const category = this.create(iModelDb, definitionModelId, name);\n    const elements = iModelDb.elements;\n    category.id = elements.insertElement(category.toJSON());\n    category.setDefaultAppearance(defaultAppearance);\n    return category.id;\n  }\n}\n\n/** Categorizes SpatialElements. See [how to create a SpatialCategory]$(docs/learning/backend/CreateElements.md#SpatialCategory).\n * @public\n */\nexport class SpatialCategory extends Category {\n  /** @internal */\n  public static override get className(): string { return \"SpatialCategory\"; }\n  /** Construct a SpatialCategory\n   * @param opts  The properties of the new SpatialCategory\n   * @param iModel The IModelDb where the SpatialCategory may be inserted.\n   * @internal\n   */\n  public constructor(opts: ElementProps, iModel: IModelDb) { super(opts, iModel); }\n\n  /** Get the name of the CodeSpec that is used by SpatialCategory objects. */\n  public static getCodeSpecName(): string { return BisCodeSpec.spatialCategory; }\n\n  /** Looks up the CategoryId of a SpatialCategory by model and name */\n  public static queryCategoryIdByName(iModel: IModelDb, scopeModelId: Id64String, categoryName: string): Id64String | undefined {\n    const code: Code = SpatialCategory.createCode(iModel, scopeModelId, categoryName);\n    return iModel.elements.queryElementIdByCode(code);\n  }\n\n  /** Create a Code for a SpatialCategory given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModel\n   * @param scopeModelId The Id of the DefinitionModel that contains the SpatialCategory and provides the scope for its name.\n   * @param codeValue The name of the category\n   * @return A spatial category Code\n   */\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(SpatialCategory.getCodeSpecName());\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\n  }\n\n  /** Create a new SpatialCategory\n   * @param iModelDb The iModel\n   * @param definitionModelId The [[DefinitionModel]]\n   * @param name The name/CodeValue of the SpatialCategory\n   * @returns The newly constructed SpatialCategory element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string): SpatialCategory {\n    const categoryProps: CategoryProps = {\n      classFullName: this.classFullName,\n      model: definitionModelId,\n      code: this.createCode(iModelDb, definitionModelId, name),\n      isPrivate: false,\n    };\n    return new SpatialCategory(categoryProps, iModelDb);\n  }\n\n  /** Insert a new SpatialCategory\n   * @param iModelDb Insert into this iModel\n   * @param definitionModelId Insert the new SpatialCategory into this DefinitionModel\n   * @param name The name of the SpatialCategory\n   * @param defaultAppearance The appearance settings to use for the default SubCategory of this SpatialCategory\n   * @returns The Id of the newly inserted SpatialCategory element.\n   * @throws [[IModelError]] if unable to insert the element.\n   */\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, defaultAppearance: SubCategoryAppearance.Props | SubCategoryAppearance): Id64String {\n    const category = this.create(iModelDb, definitionModelId, name);\n    category.id = iModelDb.elements.insertElement(category.toJSON());\n    category.setDefaultAppearance(defaultAppearance);\n    return category.id;\n  }\n}\n"]}