@itwin/core-backend 5.3.0-dev.2 → 5.3.0-dev.4

package/lib/cjs/annotations/TextAnnotationElement.js

@@ -7,25 +7,55 @@
  * @module Elements
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AnnotationTextStyle = exports.TextAnnotation3d = exports.TextAnnotation2d = void 0;
+exports.AnnotationTextStyle = exports.TEXT_STYLE_SETTINGS_JSON_VERSION = exports.TextAnnotation3d = exports.TextAnnotation2d = exports.TEXT_ANNOTATION_JSON_VERSION = void 0;
 const core_common_1 = require("@itwin/core-common");
 const Element_1 = require("../Element");
 const core_bentley_1 = require("@itwin/core-bentley");
 const TextBlockLayout_1 = require("./TextBlockLayout");
 const TextAnnotationGeometry_1 = require("./TextAnnotationGeometry");
 const ElementDrivesTextAnnotation_1 = require("./ElementDrivesTextAnnotation");
-function parseTextAnnotationData(json) {
-    if (!json)
-        return undefined;
+const semver = require("semver");
+/** The version of the JSON stored in `TextAnnotation2d/3dProps.textAnnotationData` used by the code.
+ * Uses the same semantics as [ECVersion]($ecschema-metadata).
+ * @internal
+*/
+exports.TEXT_ANNOTATION_JSON_VERSION = "1.0.0";
+function validateAndMigrateVersionedJSON(json, currentVersion, migrate) {
+    let parsed;
     try {
-        return JSON.parse(json);
+        parsed = JSON.parse(json);
     }
     catch {
         return undefined;
     }
+    const version = parsed.version;
+    if (typeof version !== "string" || !semver.valid(version))
+        throw new Error("JSON version is missing or invalid.");
+    if (typeof parsed.data !== "object" || parsed.data === null)
+        throw new Error("JSON data is missing or invalid.");
+    // Newer
+    if (semver.gt(version, currentVersion))
+        throw new Error(`JSON version ${parsed.version} is newer than supported version ${currentVersion}. Application update required to understand data.`);
+    // Older
+    if (semver.lt(version, currentVersion)) {
+        parsed.data = migrate(parsed);
+        parsed.version = currentVersion;
+    }
+    return parsed;
 }
-function getElementGeometryBuilderParams(iModel, modelId, _placementProps, stringifiedAnnotationProps, categoryId, textStyleId, _subCategory) {
-    const annotationProps = parseTextAnnotationData(stringifiedAnnotationProps);
+function migrateTextAnnotationData(oldData) {
+    if (oldData.version === exports.TEXT_ANNOTATION_JSON_VERSION)
+        return oldData.data;
+    // Place migration logic here.
+    throw new Error(`Migration for textAnnotationData from version ${oldData.version} to ${exports.TEXT_ANNOTATION_JSON_VERSION} failed.`);
+}
+/** Parses, validates, and potentially migrates the text annotation data from a JSON string. */
+function parseTextAnnotationData(json) {
+    if (!json)
+        return undefined;
+    return validateAndMigrateVersionedJSON(json, exports.TEXT_ANNOTATION_JSON_VERSION, migrateTextAnnotationData);
+}
+function getElementGeometryBuilderParams(iModel, modelId, categoryId, _placementProps, annotationProps, textStyleId, _subCategory) {
     const textBlock = core_common_1.TextAnnotation.fromJSON(annotationProps).textBlock;
     const textStyleResolver = new TextBlockLayout_1.TextStyleResolver({ textBlock, textStyleId: textStyleId ?? "", iModel });
     const layout = (0, TextBlockLayout_1.layoutTextBlock)({ iModel, textBlock, textStyleResolver });
@@ -50,28 +80,27 @@ class TextAnnotation2d extends Element_1.AnnotationElement2d /* implements IText
      * @beta
      */
     defaultTextStyle;
-    /** Optional string containing the data associated with the text annotation. */
-    _textAnnotationData;
+    /** The data associated with the text annotation. */
+    _textAnnotationProps;
     /** Extract the textual content, if present.
      * @see [[setAnnotation]] to change it.
      */
     getAnnotation() {
-        const textAnnotationProps = parseTextAnnotationData(this._textAnnotationData);
-        return textAnnotationProps ? core_common_1.TextAnnotation.fromJSON(textAnnotationProps) : undefined;
+        return this._textAnnotationProps ? core_common_1.TextAnnotation.fromJSON(this._textAnnotationProps) : undefined;
     }
     /** Change the textual content of the `TextAnnotation2d`.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
      */
     setAnnotation(annotation) {
-        this._textAnnotationData = annotation ? JSON.stringify(annotation.toJSON()) : undefined;
+        this._textAnnotationProps = annotation.toJSON();
     }
     constructor(props, iModel) {
         super(props, iModel);
         if (props.defaultTextStyle) {
             this.defaultTextStyle = new ElementDrivesTextAnnotation_1.TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);
         }
-        this._textAnnotationData = props.textAnnotationData;
+        this._textAnnotationProps = parseTextAnnotationData(props.textAnnotationData)?.data;
     }
     /** Creates a new instance of `TextAnnotation2d` from its JSON representation. */
     static fromJSON(props, iModel) {
@@ -80,14 +109,13 @@ class TextAnnotation2d extends Element_1.AnnotationElement2d /* implements IText
     /**
      * Converts the current `TextAnnotation2d` instance to its JSON representation.
      * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.
-  
      * @inheritdoc
      */
     toJSON() {
         const props = super.toJSON();
-        props.textAnnotationData = this._textAnnotationData;
-        if (this._textAnnotationData) {
-            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.placement, this._textAnnotationData, this.category, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);
+        props.textAnnotationData = this._textAnnotationProps ? JSON.stringify({ version: exports.TEXT_ANNOTATION_JSON_VERSION, data: this._textAnnotationProps }) : undefined;
+        if (this._textAnnotationProps) {
+            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.category, this.placement, this._textAnnotationProps, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);
         }
         return props;
     }
@@ -99,7 +127,7 @@ class TextAnnotation2d extends Element_1.AnnotationElement2d /* implements IText
     static create(iModelDb, arg) {
         const elementProps = {
             classFullName: this.classFullName,
-            textAnnotationData: JSON.stringify(arg.textAnnotationData),
+            textAnnotationData: arg.textAnnotationProps ? JSON.stringify({ version: exports.TEXT_ANNOTATION_JSON_VERSION, data: arg.textAnnotationProps }) : undefined,
             defaultTextStyle: arg.defaultTextStyleId ? new ElementDrivesTextAnnotation_1.TextAnnotationUsesTextStyleByDefault(arg.defaultTextStyleId).toJSON() : undefined,
             placement: arg.placement,
             model: arg.model,
@@ -109,32 +137,68 @@ class TextAnnotation2d extends Element_1.AnnotationElement2d /* implements IText
         return new this(elementProps, iModelDb);
     }
     /**
-     * Updates the geometry of the TextAnnotation2d on insert.
+     * Updates the geometry of the TextAnnotation2d on insert and validates version.
      * @inheritdoc
      * @beta
      */
     static onInsert(arg) {
         super.onInsert(arg);
-        this.updateGeometry(arg.iModel, arg.props);
+        this.validateVersionAndUpdateGeometry(arg);
     }
     /**
-     * Updates the geometry of the TextAnnotation2d on update.
+     * Updates the geometry of the TextAnnotation2d on update and validates version.
      * @inheritdoc
      * @beta
      */
     static onUpdate(arg) {
         super.onUpdate(arg);
-        this.updateGeometry(arg.iModel, arg.props);
+        this.validateVersionAndUpdateGeometry(arg);
     }
     /**
      * Populates the `elementGeometryBuilderParams` property in the [TextAnnotation2dProps]($common).
-     * It only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.
+     * Only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.
+     * Also, validates the version of the text annotation data and migrates it if necessary.
+     * @beta
      */
-    static updateGeometry(iModelDb, props) {
-        if (props.elementGeometryBuilderParams || !props.textAnnotationData) {
-            return;
+    static validateVersionAndUpdateGeometry(arg) {
+        const props = arg.props;
+        const textAnnotationData = parseTextAnnotationData(props.textAnnotationData);
+        if (!props.elementGeometryBuilderParams && textAnnotationData) {
+            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(arg.iModel, props.model, props.category, props.placement ?? core_common_1.Placement2d.fromJSON(), textAnnotationData.data, props.defaultTextStyle?.id);
         }
-        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(iModelDb, props.model, props.placement ?? core_common_1.Placement2d.fromJSON(), props.textAnnotationData, props.category, props.defaultTextStyle ? props.defaultTextStyle.id : undefined);
+    }
+    /**
+     * TextAnnotation2d custom HandledProps include 'textAnnotationData'.
+     * @inheritdoc
+     * @internal
+     */
+    static _customHandledProps = [
+        { propertyName: "textAnnotationData", source: "Class" },
+    ];
+    /**
+     * TextAnnotation2d deserializes 'textAnnotationData'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const textAnnotationData = parseTextAnnotationData(props.row.textAnnotationData);
+        if (textAnnotationData) {
+            elProps.textAnnotationData = JSON.stringify(textAnnotationData);
+        }
+        return elProps;
+    }
+    /**
+     * TextAnnotation2d serializes 'textAnnotationData'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        if (props.textAnnotationData !== undefined) {
+            inst.textAnnotationData = props.textAnnotationData;
+        }
+        return inst;
     }
     /** @internal */
     getTextBlocks() {
@@ -169,28 +233,27 @@ class TextAnnotation3d extends Element_1.GraphicalElement3d /* implements ITextA
      * @beta
      */
     defaultTextStyle;
-    /** Optional string containing the data associated with the text annotation. */
-    _textAnnotationData;
+    /** The data associated with the text annotation. */
+    _textAnnotationProps;
     /** Extract the textual content, if present.
      * @see [[setAnnotation]] to change it.
      */
     getAnnotation() {
-        const textAnnotationProps = parseTextAnnotationData(this._textAnnotationData);
-        return textAnnotationProps ? core_common_1.TextAnnotation.fromJSON(textAnnotationProps) : undefined;
+        return this._textAnnotationProps ? core_common_1.TextAnnotation.fromJSON(this._textAnnotationProps) : undefined;
     }
     /** Change the textual content of the `TextAnnotation3d`.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
      */
     setAnnotation(annotation) {
-        this._textAnnotationData = annotation ? JSON.stringify(annotation.toJSON()) : undefined;
+        this._textAnnotationProps = annotation.toJSON();
     }
     constructor(props, iModel) {
         super(props, iModel);
         if (props.defaultTextStyle) {
             this.defaultTextStyle = new ElementDrivesTextAnnotation_1.TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);
         }
-        this._textAnnotationData = props.textAnnotationData;
+        this._textAnnotationProps = parseTextAnnotationData(props.textAnnotationData)?.data;
     }
     /** Creates a new instance of `TextAnnotation3d` from its JSON representation. */
     static fromJSON(props, iModel) {
@@ -203,9 +266,9 @@ class TextAnnotation3d extends Element_1.GraphicalElement3d /* implements ITextA
      */
     toJSON() {
         const props = super.toJSON();
-        props.textAnnotationData = this._textAnnotationData;
-        if (this._textAnnotationData) {
-            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.placement, this._textAnnotationData, this.category, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);
+        props.textAnnotationData = this._textAnnotationProps ? JSON.stringify({ version: exports.TEXT_ANNOTATION_JSON_VERSION, data: this._textAnnotationProps }) : undefined;
+        if (this._textAnnotationProps) {
+            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.category, this.placement, this._textAnnotationProps, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);
         }
         return props;
     }
@@ -217,7 +280,7 @@ class TextAnnotation3d extends Element_1.GraphicalElement3d /* implements ITextA
     static create(iModelDb, arg) {
         const elementProps = {
             classFullName: this.classFullName,
-            textAnnotationData: JSON.stringify(arg.textAnnotationData),
+            textAnnotationData: arg.textAnnotationProps ? JSON.stringify({ version: exports.TEXT_ANNOTATION_JSON_VERSION, data: arg.textAnnotationProps }) : undefined,
             defaultTextStyle: arg.defaultTextStyleId ? new ElementDrivesTextAnnotation_1.TextAnnotationUsesTextStyleByDefault(arg.defaultTextStyleId).toJSON() : undefined,
             placement: arg.placement,
             model: arg.model,
@@ -227,32 +290,68 @@ class TextAnnotation3d extends Element_1.GraphicalElement3d /* implements ITextA
         return new this(elementProps, iModelDb);
     }
     /**
-     * Updates the geometry of the TextAnnotation3d on insert.
+     * Updates the geometry of the TextAnnotation3d on insert and validates version..
      * @inheritdoc
      * @beta
      */
     static onInsert(arg) {
         super.onInsert(arg);
-        this.updateGeometry(arg.iModel, arg.props);
+        this.validateVersionAndUpdateGeometry(arg);
     }
     /**
-     * Updates the geometry of the TextAnnotation3d on update.
+     * Updates the geometry of the TextAnnotation3d on update and validates version..
      * @inheritdoc
      * @beta
      */
     static onUpdate(arg) {
         super.onUpdate(arg);
-        this.updateGeometry(arg.iModel, arg.props);
+        this.validateVersionAndUpdateGeometry(arg);
     }
     /**
      * Populates the `elementGeometryBuilderParams` property in the [TextAnnotation3dProps]($common).
-     * It only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.
+     * Only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.
+     * Also, validates the version of the text annotation data and migrates it if necessary.
+     * @beta
      */
-    static updateGeometry(iModelDb, props) {
-        if (props.elementGeometryBuilderParams || !props.textAnnotationData) {
-            return;
+    static validateVersionAndUpdateGeometry(arg) {
+        const props = arg.props;
+        const textAnnotationData = parseTextAnnotationData(props.textAnnotationData);
+        if (!props.elementGeometryBuilderParams && textAnnotationData) {
+            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(arg.iModel, props.model, props.category, props.placement ?? core_common_1.Placement3d.fromJSON(), textAnnotationData.data, props.defaultTextStyle?.id);
         }
-        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(iModelDb, props.model, props.placement ?? core_common_1.Placement3d.fromJSON(), props.textAnnotationData, props.category, props.defaultTextStyle ? props.defaultTextStyle.id : undefined);
+    }
+    /**
+     * TextAnnotation3d custom HandledProps include 'textAnnotationData'.
+     * @inheritdoc
+     * @internal
+     */
+    static _customHandledProps = [
+        { propertyName: "textAnnotationData", source: "Class" },
+    ];
+    /**
+     * TextAnnotation3d deserializes 'textAnnotationData'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const textAnnotationData = parseTextAnnotationData(props.row.textAnnotationData);
+        if (textAnnotationData) {
+            elProps.textAnnotationData = JSON.stringify(textAnnotationData);
+        }
+        return elProps;
+    }
+    /**
+     * TextAnnotation3d serializes 'textAnnotationData'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        if (props.textAnnotationData !== undefined) {
+            inst.textAnnotationData = props.textAnnotationData;
+        }
+        return inst;
     }
     /** @internal */
     getTextBlocks() {
@@ -291,6 +390,17 @@ function updateTextBlocks(elem, textBlocks) {
     elem.setAnnotation(annotation);
     elem.update();
 }
+/** The version of the JSON stored in `AnnotationTextStyleProps.settings` used by the code.
+ * Uses the same semantics as [ECVersion]($ecschema-metadata).
+ * @internal
+*/
+exports.TEXT_STYLE_SETTINGS_JSON_VERSION = "1.0.0";
+function migrateTextStyleSettings(oldData) {
+    if (oldData.version === exports.TEXT_STYLE_SETTINGS_JSON_VERSION)
+        return oldData.data;
+    // Place migration logic here.
+    throw new Error(`Migration for settings from version ${oldData.version} to ${exports.TEXT_STYLE_SETTINGS_JSON_VERSION} failed.`);
+}
 /**
  * The definition element that holds text style information.
  * The style is stored as a [TextStyleSettings]($common).
@@ -312,7 +422,7 @@ class AnnotationTextStyle extends Element_1.DefinitionElement {
         super(props, iModel);
         this.description = props.description;
         const settingsProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);
-        this.settings = core_common_1.TextStyleSettings.fromJSON(settingsProps);
+        this.settings = core_common_1.TextStyleSettings.fromJSON(settingsProps?.data);
     }
     /**
      * Creates a Code for an `AnnotationTextStyle` given a name that is meant to be unique within the scope of the specified DefinitionModel.
@@ -320,6 +430,7 @@ class AnnotationTextStyle extends Element_1.DefinitionElement {
      * @param iModel - The IModelDb.
      * @param definitionModelId - The ID of the DefinitionModel that contains the AnnotationTextStyle and provides the scope for its name.
      * @param name - The AnnotationTextStyle name.
+     * @beta
      */
     static createCode(iModel, definitionModelId, name) {
         const codeSpec = iModel.codeSpecs.getByName(core_common_1.BisCodeSpec.annotationTextStyle);
@@ -329,18 +440,16 @@ class AnnotationTextStyle extends Element_1.DefinitionElement {
      * Creates a new instance of `AnnotationTextStyle` with the specified properties.
      *
      * @param iModelDb - The iModelDb.
-     * @param definitionModelId - The ID of the [[DefinitionModel]].
-     * @param name - The name to assign to the `AnnotationTextStyle`.
-     * @param settings - Optional text style settings used to create the `AnnotationTextStyle`. Default settings will be used if not provided.
-     * @param description - Optional description for the `AnnotationTextStyle`.
+     * @param arg - The arguments for creating the AnnotationTextStyle.
+     * @beta
      */
-    static create(iModelDb, definitionModelId, name, settings, description) {
+    static create(iModelDb, arg) {
         const props = {
             classFullName: this.classFullName,
-            model: definitionModelId,
-            code: this.createCode(iModelDb, definitionModelId, name).toJSON(),
-            description,
-            settings: JSON.stringify(settings),
+            model: arg.definitionModelId,
+            code: this.createCode(iModelDb, arg.definitionModelId, arg.name).toJSON(),
+            description: arg.description,
+            settings: arg.settings ? JSON.stringify({ version: exports.TEXT_STYLE_SETTINGS_JSON_VERSION, data: arg.settings }) : undefined,
         };
         return new this(props, iModelDb);
     }
@@ -351,7 +460,7 @@ class AnnotationTextStyle extends Element_1.DefinitionElement {
     toJSON() {
         const props = super.toJSON();
         props.description = this.description;
-        props.settings = JSON.stringify(this.settings.toJSON());
+        props.settings = JSON.stringify({ version: exports.TEXT_STYLE_SETTINGS_JSON_VERSION, data: this.settings.toJSON() });
         return props;
     }
     /** Creates a new instance of `AnnotationTextStyle` from its JSON representation. */
@@ -380,21 +489,50 @@ class AnnotationTextStyle extends Element_1.DefinitionElement {
         const settingProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);
         if (!settingProps)
             return;
-        const settings = core_common_1.TextStyleSettings.fromJSON(settingProps);
+        const settings = core_common_1.TextStyleSettings.fromJSON(settingProps.data);
         const errors = settings.getValidationErrors();
         if (errors.length > 0) {
             throw new Error(`Invalid AnnotationTextStyle settings: ${errors.join(", ")}`);
         }
     }
+    /**
+     * AnnotationTextStyle custom HandledProps include 'settings'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "settings", source: "Class" },
+    ];
+    /**
+     * AnnotationTextStyle deserializes 'settings'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const settings = this.parseTextStyleSettings(props.row.settings);
+        if (settings) {
+            elProps.settings = JSON.stringify(settings);
+        }
+        return elProps;
+    }
+    /**
+     * AnnotationTextStyle serializes 'settings'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        if (props.settings !== undefined) {
+            inst.settings = props.settings;
+        }
+        return inst;
+    }
+    /** Parses, validates, and potentially migrates the text style settings data from a JSON string. */
     static parseTextStyleSettings(json) {
         if (!json)
             return undefined;
-        try {
-            return JSON.parse(json);
-        }
-        catch {
-            return undefined;
-        }
+        return validateAndMigrateVersionedJSON(json, exports.TEXT_STYLE_SETTINGS_JSON_VERSION, migrateTextStyleSettings);
     }
 }
 exports.AnnotationTextStyle = AnnotationTextStyle;

package/lib/cjs/annotations/TextAnnotationElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotationElement.js","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationElement.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oDAAiX;AAEjX,wCAAoI;AACpI,sDAAyD;AACzD,uDAAuE;AACvE,qEAAwE;AACxE,+EAAkI;AAElI,SAAS,uBAAuB,CAAC,IAAwB;IACvD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,+BAA+B,CAAC,MAAgB,EAAE,OAAmB,EAAE,eAA+B,EAAE,0BAAkC,EAAE,UAAsB,EAAE,WAAwB,EAAE,YAAyB;IAC9N,MAAM,eAAe,GAAG,uBAAuB,CAAC,0BAA0B,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,4BAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC;IACrE,MAAM,iBAAiB,GAAG,IAAI,mCAAiB,CAAC,EAAC,SAAS,EAAE,WAAW,EAAE,WAAW,IAAI,EAAE,EAAE,MAAM,EAAC,CAAC,CAAC;IACrG,MAAM,MAAM,GAAG,IAAA,iCAAe,EAAC,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,IAAI,6BAAe,CAAC,OAAO,EAAE,CAAC;IAC9C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,OAAO,YAAY,iBAAO;QAC5B,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACpC,IAAA,qDAA4B,EAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAEtI,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AACzC,CAAC;AAsCD;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,6BAAmB,CAAC,gCAAgC;IACxF,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC7E;;;OAGG;IACI,gBAAgB,CAAwC;IAC/D,+EAA+E;IACvE,mBAAmB,CAAU;IAErC;;OAEG;IACI,aAAa;QAClB,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9E,OAAO,mBAAmB,CAAC,CAAC,CAAC,4BAAc,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,UAA0B;QAC7C,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAED,YAAsB,KAA4B,EAAE,MAAgB;QAClE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,IAAI,kEAAoC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACtD,CAAC;IAED,iFAAiF;IAC1E,MAAM,CAAC,QAAQ,CAAC,KAA4B,EAAE,MAAgB;QACnE,OAAO,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACa,MAAM;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACtD,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACpD,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,KAAK,CAAC,4BAA4B,GAAG,+BAA+B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvN,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,GAA+B;QACtE,MAAM,YAAY,GAA0B;YAC1C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC1D,gBAAgB,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,kEAAoC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;YAChI,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,kBAAI,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAU,QAAQ,CAAC,GAAsB;QACvD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAA8B,CAAC,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAU,QAAQ,CAAC,GAAsB;QACvD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAA8B,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACO,MAAM,CAAC,cAAc,CAAC,QAAkB,EAAE,KAA4B;QAC9E,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO;QACT,CAAC;QAED,KAAK,CAAC,4BAA4B,GAAG,+BAA+B,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,yBAAW,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnP,CAAC;IAED,gBAAgB;IACT,aAAa;QAClB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,gBAAgB;IACT,gBAAgB,CAAC,UAA4B;QAClD,OAAO,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,UAAU,CAAC,GAAmB;QACnD,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,yDAA2B,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,SAAS,CAAC,GAAmB;QAClD,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrB,yDAA2B,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;CACF;AA/HD,4CA+HC;AAED;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,4BAAkB,CAAC,gCAAgC;IACvF,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC7E;;;OAGG;IACI,gBAAgB,CAAwC;IAC/D,+EAA+E;IACvE,mBAAmB,CAAU;IAErC;;OAEG;IACI,aAAa;QAClB,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9E,OAAO,mBAAmB,CAAC,CAAC,CAAC,4BAAc,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,UAA0B;QAC7C,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAED,YAAsB,KAA4B,EAAE,MAAgB;QAClE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,IAAI,kEAAoC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACtD,CAAC;IAED,iFAAiF;IAC1E,MAAM,CAAC,QAAQ,CAAC,KAA4B,EAAE,MAAgB;QACnE,OAAO,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACa,MAAM;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAA2B,CAAC;QACtD,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACpD,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,KAAK,CAAC,4BAA4B,GAAG,+BAA+B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACvN,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,GAA+B;QACtE,MAAM,YAAY,GAA0B;YAC1C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC1D,gBAAgB,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,kEAAoC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;YAChI,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,kBAAI,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAU,QAAQ,CAAC,GAAsB;QACvD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAA8B,CAAC,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAU,QAAQ,CAAC,GAAsB;QACvD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAA8B,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACO,MAAM,CAAC,cAAc,CAAC,QAAkB,EAAE,KAA4B;QAC9E,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;YACpE,OAAO;QACT,CAAC;QAED,KAAK,CAAC,4BAA4B,GAAG,+BAA+B,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,yBAAW,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnP,CAAC;IAED,gBAAgB;IACT,aAAa;QAClB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,gBAAgB;IACT,gBAAgB,CAAC,UAA4B;QAClD,OAAO,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,UAAU,CAAC,GAAmB;QACnD,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,yDAA2B,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,SAAS,CAAC,GAAmB;QAClD,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrB,yDAA2B,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;CACF;AA9HD,4CA8HC;AAED,SAAS,aAAa,CAAC,IAAyC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACxC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAyC,EAAE,UAA4B;IAC/F,IAAA,qBAAM,EAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAChC,IAAA,qBAAM,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IAEvC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACxC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,oHAAoH;QACpH,iGAAiG;QACjG,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/C,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,2BAAiB;IACxD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,qBAAqB,CAAC,CAAC,CAAC;IAChF;;OAEG;IACI,WAAW,CAAU;IAC5B;;;OAGG;IACI,QAAQ,CAAoB;IAEnC,YAAsB,KAA+B,EAAE,MAAgB;QACrE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACrC,MAAM,aAAa,GAAG,mBAAmB,CAAC,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjF,IAAI,CAAC,QAAQ,GAAG,+BAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,iBAAiC,EAAE,IAAY;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,yBAAW,CAAC,mBAAmB,CAAC,CAAC;QACvF,OAAO,IAAI,kBAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,IAAY,EAAE,QAAiC,EAAE,WAAoB;QAC3I,MAAM,KAAK,GAA6B;YACtC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE;YACjE,WAAW;YACX,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;SACnC,CAAA;QACD,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACa,MAAM;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAA8B,CAAC;QACzD,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oFAAoF;IAC7E,MAAM,CAAC,QAAQ,CAAC,KAA+B,EAAE,MAAgB;QACtE,OAAO,IAAI,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAU,QAAQ,CAAC,GAAsB;QACvD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAiC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAU,QAAQ,CAAC,GAAsB;QACvD,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAiC,CAAC,CAAC;IAC/D,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,KAA+B;QAC7D,MAAM,YAAY,GAAG,mBAAmB,CAAC,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChF,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,MAAM,QAAQ,GAAG,+BAAiB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,sBAAsB,CAAC,IAAwB;QAC5D,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AA1GD,kDA0GC","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 Elements\n */\n\nimport { AnnotationTextStyleProps, BisCodeSpec, Code, CodeProps, CodeScopeProps, CodeSpec, ElementGeometry, ElementGeometryBuilderParams, Placement2d, Placement2dProps, Placement3d, Placement3dProps, PlacementProps, TextAnnotation, TextAnnotation2dProps, TextAnnotation3dProps, TextAnnotationProps, TextStyleSettings, TextStyleSettingsProps } from \"@itwin/core-common\";\nimport { IModelDb } from \"../IModelDb\";\nimport { AnnotationElement2d, DefinitionElement, Drawing, GraphicalElement3d, OnElementIdArg, OnElementPropsArg } from \"../Element\";\nimport { assert, Id64String } from \"@itwin/core-bentley\";\nimport { layoutTextBlock, TextStyleResolver } from \"./TextBlockLayout\";\nimport { appendTextAnnotationGeometry } from \"./TextAnnotationGeometry\";\nimport { ElementDrivesTextAnnotation, TextAnnotationUsesTextStyleByDefault, TextBlockAndId } from \"./ElementDrivesTextAnnotation\";\n\nfunction parseTextAnnotationData(json: string | undefined): TextAnnotationProps | undefined {\n  if (!json) return undefined;\n  try {\n    return JSON.parse(json);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction getElementGeometryBuilderParams(iModel: IModelDb, modelId: Id64String, _placementProps: PlacementProps, stringifiedAnnotationProps: string, categoryId: Id64String, textStyleId?: Id64String, _subCategory?: Id64String): ElementGeometryBuilderParams {\n  const annotationProps = parseTextAnnotationData(stringifiedAnnotationProps);\n  const textBlock = TextAnnotation.fromJSON(annotationProps).textBlock;\n  const textStyleResolver = new TextStyleResolver({textBlock, textStyleId: textStyleId ?? \"\", iModel});\n  const layout = layoutTextBlock({ iModel, textBlock, textStyleResolver });\n  const builder = new ElementGeometry.Builder();\n  let scaleFactor = 1;\n  const element = iModel.elements.getElement(modelId);\n  if (element instanceof Drawing)\n    scaleFactor = element.scaleFactor;\n  appendTextAnnotationGeometry({ layout, textStyleResolver, scaleFactor, annotationProps: annotationProps ?? {}, builder, categoryId });\n\n  return { entryArray: builder.entries };\n}\n\n/** Arguments supplied when creating a [[TextAnnotation2d]].\n * @beta\n */\nexport interface TextAnnotation2dCreateArgs {\n  /** The category ID for the annotation. */\n  category: Id64String;\n  /** The model ID where the annotation will be placed. */\n  model: Id64String;\n  /** The placement properties for the annotation. */\n  placement: Placement2dProps;\n  /** The default text style ID for the annotation. */\n  defaultTextStyleId?: Id64String;\n  /** Optional [[TextAnnotation]] JSON representation used to create the `TextAnnotation2d`. Essentially an empty element if not provided. */\n  textAnnotationData?: TextAnnotationProps;\n  /** Optional code for the element. */\n  code?: CodeProps;\n}\n\n/** Arguments supplied when creating a [[TextAnnotation3d]].\n * @beta\n */\nexport interface TextAnnotation3dCreateArgs {\n  /** The category ID for the annotation. */\n  category: Id64String;\n  /** The model ID where the annotation will be placed. */\n  model: Id64String;\n  /** The placement properties for the annotation. */\n  placement: Placement3dProps;\n  /** The default text style ID for the annotation. */\n  defaultTextStyleId?: Id64String;\n  /** Optional [[TextAnnotation]] JSON representation used to create the `TextAnnotation3d`. Essentially an empty element if not provided. */\n  textAnnotationData?: TextAnnotationProps;\n  /** Optional code for the element. */\n  code?: CodeProps;\n}\n\n/** An element that displays textual content within a 2d model.\n * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.\n * @see [[setAnnotation]] to change the textual content.\n * @public @preview\n */\nexport class TextAnnotation2d extends AnnotationElement2d /* implements ITextAnnotation */ {\n  /** @internal */\n  public static override get className(): string { return \"TextAnnotation2d\"; }\n  /**\n   * The default [[AnnotationTextStyle]] used by the TextAnnotation2d.\n   * @beta\n   */\n  public defaultTextStyle?: TextAnnotationUsesTextStyleByDefault;\n  /** Optional string containing the data associated with the text annotation. */\n  private _textAnnotationData?: string;\n\n  /** Extract the textual content, if present.\n   * @see [[setAnnotation]] to change it.\n   */\n  public getAnnotation(): TextAnnotation | undefined {\n    const textAnnotationProps = parseTextAnnotationData(this._textAnnotationData);\n    return textAnnotationProps ? TextAnnotation.fromJSON(textAnnotationProps) : undefined;\n  }\n\n  /** Change the textual content of the `TextAnnotation2d`.\n   * @see [[getAnnotation]] to extract the current annotation.\n   * @param annotation The new annotation\n   */\n  public setAnnotation(annotation: TextAnnotation) {\n    this._textAnnotationData = annotation ? JSON.stringify(annotation.toJSON()) : undefined;\n  }\n\n  protected constructor(props: TextAnnotation2dProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.defaultTextStyle) {\n      this.defaultTextStyle = new TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);\n    }\n    this._textAnnotationData = props.textAnnotationData;\n  }\n\n  /** Creates a new instance of `TextAnnotation2d` from its JSON representation. */\n  public static fromJSON(props: TextAnnotation2dProps, iModel: IModelDb): TextAnnotation2d {\n    return new TextAnnotation2d(props, iModel);\n  }\n\n  /**\n   * Converts the current `TextAnnotation2d` instance to its JSON representation.\n   * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.\n\n   * @inheritdoc\n   */\n  public override toJSON(): TextAnnotation2dProps {\n    const props = super.toJSON() as TextAnnotation2dProps;\n    props.textAnnotationData = this._textAnnotationData;\n    if (this._textAnnotationData) {\n      props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.placement, this._textAnnotationData, this.category, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);\n    }\n\n    return props;\n  }\n\n  /** Creates a new `TextAnnotation2d` instance with the specified properties.\n   * @param iModelDb The iModel.\n   * @param arg The arguments for creating the TextAnnotation2d.\n   * @beta\n   */\n  public static create(iModelDb: IModelDb, arg: TextAnnotation2dCreateArgs): TextAnnotation2d {\n    const elementProps: TextAnnotation2dProps = {\n      classFullName: this.classFullName,\n      textAnnotationData: JSON.stringify(arg.textAnnotationData),\n      defaultTextStyle: arg.defaultTextStyleId ? new TextAnnotationUsesTextStyleByDefault(arg.defaultTextStyleId).toJSON() : undefined,\n      placement: arg.placement,\n      model: arg.model,\n      category: arg.category,\n      code: arg.code ?? Code.createEmpty(),\n    };\n    return new this(elementProps, iModelDb);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation2d on insert.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onInsert(arg: OnElementPropsArg): void {\n    super.onInsert(arg);\n    this.updateGeometry(arg.iModel, arg.props as TextAnnotation2dProps);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation2d on update.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onUpdate(arg: OnElementPropsArg): void {\n    super.onUpdate(arg);\n    this.updateGeometry(arg.iModel, arg.props as TextAnnotation2dProps);\n  }\n\n  /**\n   * Populates the `elementGeometryBuilderParams` property in the [TextAnnotation2dProps]($common).\n   * It only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.\n   */\n  protected static updateGeometry(iModelDb: IModelDb, props: TextAnnotation2dProps): void {\n    if (props.elementGeometryBuilderParams || !props.textAnnotationData) {\n      return;\n    }\n\n    props.elementGeometryBuilderParams = getElementGeometryBuilderParams(iModelDb, props.model, props.placement ?? Placement2d.fromJSON(), props.textAnnotationData, props.category, props.defaultTextStyle ? props.defaultTextStyle.id : undefined);\n  }\n\n  /** @internal */\n  public getTextBlocks(): Iterable<TextBlockAndId> {\n    return getTextBlocks(this);\n  }\n\n  /** @internal */\n  public updateTextBlocks(textBlocks: TextBlockAndId[]): void {\n    return updateTextBlocks(this, textBlocks);\n  }\n\n  /** @internal */\n  public static override onInserted(arg: OnElementIdArg): void {\n    super.onInserted(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n\n  /** @internal */\n  public static override onUpdated(arg: OnElementIdArg): void {\n    super.onUpdated(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n}\n\n/** An element that displays textual content within a 3d model.\n * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.\n * @see [[setAnnotation]] to change the textual content.\n * @public @preview\n */\nexport class TextAnnotation3d extends GraphicalElement3d /* implements ITextAnnotation */ {\n  /** @internal */\n  public static override get className(): string { return \"TextAnnotation3d\"; }\n  /**\n   * The default [[AnnotationTextStyle]] used by the TextAnnotation3d.\n   * @beta\n   */\n  public defaultTextStyle?: TextAnnotationUsesTextStyleByDefault;\n  /** Optional string containing the data associated with the text annotation. */\n  private _textAnnotationData?: string;\n\n  /** Extract the textual content, if present.\n   * @see [[setAnnotation]] to change it.\n   */\n  public getAnnotation(): TextAnnotation | undefined {\n    const textAnnotationProps = parseTextAnnotationData(this._textAnnotationData);\n    return textAnnotationProps ? TextAnnotation.fromJSON(textAnnotationProps) : undefined;\n  }\n\n  /** Change the textual content of the `TextAnnotation3d`.\n   * @see [[getAnnotation]] to extract the current annotation.\n   * @param annotation The new annotation\n   */\n  public setAnnotation(annotation: TextAnnotation) {\n    this._textAnnotationData = annotation ? JSON.stringify(annotation.toJSON()) : undefined;\n  }\n\n  protected constructor(props: TextAnnotation3dProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.defaultTextStyle) {\n      this.defaultTextStyle = new TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);\n    }\n    this._textAnnotationData = props.textAnnotationData;\n  }\n\n  /** Creates a new instance of `TextAnnotation3d` from its JSON representation. */\n  public static fromJSON(props: TextAnnotation3dProps, iModel: IModelDb): TextAnnotation3d {\n    return new TextAnnotation3d(props, iModel);\n  }\n\n  /**\n   * Converts the current `TextAnnotation3d` instance to its JSON representation.\n   * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.\n   * @inheritdoc\n   */\n  public override toJSON(): TextAnnotation3dProps {\n    const props = super.toJSON() as TextAnnotation3dProps;\n    props.textAnnotationData = this._textAnnotationData;\n    if (this._textAnnotationData) {\n      props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.placement, this._textAnnotationData, this.category, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);\n    }\n\n    return props;\n  }\n\n  /** Creates a new `TextAnnotation3d` instance with the specified properties.\n   * @param iModelDb The iModel.\n   * @param arg The arguments for creating the TextAnnotation3d.\n   * @beta\n   */\n  public static create(iModelDb: IModelDb, arg: TextAnnotation3dCreateArgs): TextAnnotation3d {\n    const elementProps: TextAnnotation3dProps = {\n      classFullName: this.classFullName,\n      textAnnotationData: JSON.stringify(arg.textAnnotationData),\n      defaultTextStyle: arg.defaultTextStyleId ? new TextAnnotationUsesTextStyleByDefault(arg.defaultTextStyleId).toJSON() : undefined,\n      placement: arg.placement,\n      model: arg.model,\n      category: arg.category,\n      code: arg.code ?? Code.createEmpty(),\n    };\n    return new this(elementProps, iModelDb);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation3d on insert.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onInsert(arg: OnElementPropsArg): void {\n    super.onInsert(arg);\n    this.updateGeometry(arg.iModel, arg.props as TextAnnotation3dProps);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation3d on update.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onUpdate(arg: OnElementPropsArg): void {\n    super.onUpdate(arg);\n    this.updateGeometry(arg.iModel, arg.props as TextAnnotation3dProps);\n  }\n\n  /**\n   * Populates the `elementGeometryBuilderParams` property in the [TextAnnotation3dProps]($common).\n   * It only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.\n   */\n  protected static updateGeometry(iModelDb: IModelDb, props: TextAnnotation3dProps): void {\n    if (props.elementGeometryBuilderParams || !props.textAnnotationData) {\n      return;\n    }\n\n    props.elementGeometryBuilderParams = getElementGeometryBuilderParams(iModelDb, props.model, props.placement ?? Placement3d.fromJSON(), props.textAnnotationData, props.category, props.defaultTextStyle ? props.defaultTextStyle.id : undefined);\n  }\n\n  /** @internal */\n  public getTextBlocks(): Iterable<TextBlockAndId> {\n    return getTextBlocks(this);\n  }\n\n  /** @internal */\n  public updateTextBlocks(textBlocks: TextBlockAndId[]): void {\n    return updateTextBlocks(this, textBlocks);\n  }\n\n  /** @internal */\n  public static override onInserted(arg: OnElementIdArg): void {\n    super.onInserted(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n\n  /** @internal */\n  public static override onUpdated(arg: OnElementIdArg): void {\n    super.onUpdated(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n}\n\nfunction getTextBlocks(elem: TextAnnotation2d | TextAnnotation3d): Iterable<TextBlockAndId> {\n  const annotation = elem.getAnnotation();\n  return annotation ? [{ textBlock: annotation.textBlock, id: undefined }] : [];\n}\n\nfunction updateTextBlocks(elem: TextAnnotation2d | TextAnnotation3d, textBlocks: TextBlockAndId[]): void {\n  assert(textBlocks.length === 1);\n  assert(textBlocks[0].id === undefined);\n\n  const annotation = elem.getAnnotation();\n  if (!annotation) {\n    // We must obtain the TextBlockAndId from the element in the first place, so the only way we could end up here is if\n    // somebody removed the text annotation after we called getTextBlocks. That's gotta be a mistake.\n    throw new Error(\"Text annotation element has no text\");\n  }\n\n  annotation.textBlock = textBlocks[0].textBlock;\n\n  elem.setAnnotation(annotation);\n  elem.update();\n}\n\n/**\n * The definition element that holds text style information.\n * The style is stored as a [TextStyleSettings]($common).\n * @beta\n */\nexport class AnnotationTextStyle extends DefinitionElement {\n  /** @internal */\n  public static override get className(): string { return \"AnnotationTextStyle\"; }\n  /**\n   * Optional text describing the `AnnotationTextStyle`.\n   */\n  public description?: string;\n  /**\n   * The text style settings for the `AnnotationTextStyle`.\n   * @see [[TextStyleSettings]] for more information.\n   */\n  public settings: TextStyleSettings;\n\n  protected constructor(props: AnnotationTextStyleProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.description = props.description;\n    const settingsProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);\n    this.settings = TextStyleSettings.fromJSON(settingsProps);\n  }\n\n  /**\n   * Creates a Code for an `AnnotationTextStyle` given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   *\n   * @param iModel - The IModelDb.\n   * @param definitionModelId - The ID of the DefinitionModel that contains the AnnotationTextStyle and provides the scope for its name.\n   * @param name - The AnnotationTextStyle name.\n   */\n  public static createCode(iModel: IModelDb, definitionModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.annotationTextStyle);\n    return new Code({ spec: codeSpec.id, scope: definitionModelId, value: name });\n  }\n\n  /**\n   * Creates a new instance of `AnnotationTextStyle` with the specified properties.\n   *\n   * @param iModelDb - The iModelDb.\n   * @param definitionModelId - The ID of the [[DefinitionModel]].\n   * @param name - The name to assign to the `AnnotationTextStyle`.\n   * @param settings - Optional text style settings used to create the `AnnotationTextStyle`. Default settings will be used if not provided.\n   * @param description - Optional description for the `AnnotationTextStyle`.\n   */\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, settings?: TextStyleSettingsProps, description?: string) {\n    const props: AnnotationTextStyleProps = {\n      classFullName: this.classFullName,\n      model: definitionModelId,\n      code: this.createCode(iModelDb, definitionModelId, name).toJSON(),\n      description,\n      settings: JSON.stringify(settings),\n    }\n    return new this(props, iModelDb);\n  }\n\n  /**\n   * Converts the current `AnnotationTextStyle` instance to its JSON representation.\n   * @inheritdoc\n   */\n  public override toJSON(): AnnotationTextStyleProps {\n    const props = super.toJSON() as AnnotationTextStyleProps;\n    props.description = this.description;\n    props.settings = JSON.stringify(this.settings.toJSON());\n    return props;\n  }\n\n  /** Creates a new instance of `AnnotationTextStyle` from its JSON representation. */\n  public static fromJSON(props: AnnotationTextStyleProps, iModel: IModelDb): AnnotationTextStyle {\n    return new AnnotationTextStyle(props, iModel);\n  }\n\n  /**\n   * Validates that the AnnotationTextStyle's settings are valid before insert.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onInsert(arg: OnElementPropsArg): void {\n    super.onInsert(arg);\n    this.validateSettings(arg.props as AnnotationTextStyleProps);\n  }\n\n  /**\n   * Validates that the AnnotationTextStyle's settings are valid before update.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onUpdate(arg: OnElementPropsArg): void {\n    super.onUpdate(arg);\n    this.validateSettings(arg.props as AnnotationTextStyleProps);\n  }\n\n  private static validateSettings(props: AnnotationTextStyleProps): void {\n    const settingProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);\n    if (!settingProps) return;\n    const settings = TextStyleSettings.fromJSON(settingProps);\n    const errors = settings.getValidationErrors();\n    if (errors.length > 0) {\n      throw new Error(`Invalid AnnotationTextStyle settings: ${errors.join(\", \")}`);\n    }\n  }\n\n  private static parseTextStyleSettings(json: string | undefined): TextStyleSettingsProps | undefined {\n    if (!json) return undefined;\n    try {\n      return JSON.parse(json);\n    } catch {\n      return undefined;\n    }\n  }\n}\n\n\n"]}
+{"version":3,"file":"TextAnnotationElement.js","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationElement.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 Elements\n */\n\nimport { AnnotationTextStyleProps, BisCodeSpec, Code, CodeProps, CodeScopeProps, CodeSpec, ECVersionString, ElementGeometry, ElementGeometryBuilderParams, Placement2d, Placement2dProps, Placement3d, Placement3dProps, PlacementProps, TextAnnotation, TextAnnotation2dProps, TextAnnotation3dProps, TextAnnotationProps, TextStyleSettings, TextStyleSettingsProps, VersionedJSON } from \"@itwin/core-common\";\nimport { IModelDb } from \"../IModelDb\";\nimport { AnnotationElement2d, DefinitionElement, Drawing, GraphicalElement3d, OnElementIdArg, OnElementPropsArg } from \"../Element\";\nimport { assert, Id64String } from \"@itwin/core-bentley\";\nimport { layoutTextBlock, TextStyleResolver } from \"./TextBlockLayout\";\nimport { appendTextAnnotationGeometry } from \"./TextAnnotationGeometry\";\nimport { ElementDrivesTextAnnotation, TextAnnotationUsesTextStyleByDefault, TextBlockAndId } from \"./ElementDrivesTextAnnotation\";\nimport { CustomHandledProperty, DeserializeEntityArgs, ECSqlRow } from \"../Entity\";\nimport * as semver from \"semver\";\n\n/** The version of the JSON stored in `TextAnnotation2d/3dProps.textAnnotationData` used by the code.\n * Uses the same semantics as [ECVersion]($ecschema-metadata).\n * @internal\n*/\nexport const TEXT_ANNOTATION_JSON_VERSION = \"1.0.0\";\n\nfunction validateAndMigrateVersionedJSON<T>(\n  json: string,\n  currentVersion: ECVersionString,\n  migrate: (old: VersionedJSON<T>) => T\n): VersionedJSON<T> | undefined {\n  let parsed;\n  try {\n    parsed = JSON.parse(json) as VersionedJSON<T>;\n  } catch {\n    return undefined;\n  }\n\n  const version = parsed.version;\n  if (typeof version !== \"string\" || !semver.valid(version))\n    throw new Error(\"JSON version is missing or invalid.\");\n\n  if (typeof parsed.data !== \"object\" || parsed.data === null)\n    throw new Error(\"JSON data is missing or invalid.\");\n\n  // Newer\n  if (semver.gt(version, currentVersion))\n    throw new Error(`JSON version ${parsed.version} is newer than supported version ${currentVersion}. Application update required to understand data.`);\n\n  // Older\n  if (semver.lt(version, currentVersion)) {\n    parsed.data = migrate(parsed);\n    parsed.version = currentVersion;\n  }\n\n  return parsed;\n}\n\nfunction migrateTextAnnotationData(oldData: VersionedJSON<TextAnnotationProps>): TextAnnotationProps {\n  if (oldData.version === TEXT_ANNOTATION_JSON_VERSION) return oldData.data;\n\n  // Place migration logic here.\n\n  throw new Error(`Migration for textAnnotationData from version ${oldData.version} to ${TEXT_ANNOTATION_JSON_VERSION} failed.`);\n}\n\n/** Parses, validates, and potentially migrates the text annotation data from a JSON string. */\nfunction parseTextAnnotationData(json: string | undefined): VersionedJSON<TextAnnotationProps> | undefined {\n  if (!json) return undefined;\n\n  return validateAndMigrateVersionedJSON<TextAnnotationProps>(json, TEXT_ANNOTATION_JSON_VERSION, migrateTextAnnotationData);\n}\n\nfunction getElementGeometryBuilderParams(iModel: IModelDb, modelId: Id64String, categoryId: Id64String, _placementProps: PlacementProps, annotationProps?: TextAnnotationProps, textStyleId?: Id64String, _subCategory?: Id64String): ElementGeometryBuilderParams {\n  const textBlock = TextAnnotation.fromJSON(annotationProps).textBlock;\n  const textStyleResolver = new TextStyleResolver({textBlock, textStyleId: textStyleId ?? \"\", iModel});\n  const layout = layoutTextBlock({ iModel, textBlock, textStyleResolver });\n  const builder = new ElementGeometry.Builder();\n  let scaleFactor = 1;\n  const element = iModel.elements.getElement(modelId);\n  if (element instanceof Drawing)\n    scaleFactor = element.scaleFactor;\n  appendTextAnnotationGeometry({ layout, textStyleResolver, scaleFactor, annotationProps: annotationProps ?? {}, builder, categoryId });\n\n  return { entryArray: builder.entries };\n}\n\n/** Arguments supplied when creating a [[TextAnnotation2d]].\n * @beta\n */\nexport interface TextAnnotation2dCreateArgs {\n  /** The category ID for the annotation. */\n  category: Id64String;\n  /** The model ID where the annotation will be placed. */\n  model: Id64String;\n  /** The placement properties for the annotation. */\n  placement: Placement2dProps;\n  /** The default text style ID for the annotation. */\n  defaultTextStyleId?: Id64String;\n  /** Optional [[TextAnnotation]] JSON representation used to create the `TextAnnotation2d`. Essentially an empty element if not provided. */\n  textAnnotationProps?: TextAnnotationProps;\n  /** Optional code for the element. */\n  code?: CodeProps;\n}\n\n/** Arguments supplied when creating a [[TextAnnotation3d]].\n * @beta\n */\nexport interface TextAnnotation3dCreateArgs {\n  /** The category ID for the annotation. */\n  category: Id64String;\n  /** The model ID where the annotation will be placed. */\n  model: Id64String;\n  /** The placement properties for the annotation. */\n  placement: Placement3dProps;\n  /** The default text style ID for the annotation. */\n  defaultTextStyleId?: Id64String;\n  /** Optional [[TextAnnotation]] JSON representation used to create the `TextAnnotation3d`. Essentially an empty element if not provided. */\n  textAnnotationProps?: TextAnnotationProps;\n  /** Optional code for the element. */\n  code?: CodeProps;\n}\n\n/** An element that displays textual content within a 2d model.\n * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.\n * @see [[setAnnotation]] to change the textual content.\n * @public @preview\n */\nexport class TextAnnotation2d extends AnnotationElement2d /* implements ITextAnnotation */ {\n  /** @internal */\n  public static override get className(): string { return \"TextAnnotation2d\"; }\n  /**\n   * The default [[AnnotationTextStyle]] used by the TextAnnotation2d.\n   * @beta\n   */\n  public defaultTextStyle?: TextAnnotationUsesTextStyleByDefault;\n  /** The data associated with the text annotation. */\n  private _textAnnotationProps?: TextAnnotationProps;\n\n  /** Extract the textual content, if present.\n   * @see [[setAnnotation]] to change it.\n   */\n  public getAnnotation(): TextAnnotation | undefined {\n    return this._textAnnotationProps ? TextAnnotation.fromJSON(this._textAnnotationProps) : undefined;\n  }\n\n  /** Change the textual content of the `TextAnnotation2d`.\n   * @see [[getAnnotation]] to extract the current annotation.\n   * @param annotation The new annotation\n   */\n  public setAnnotation(annotation: TextAnnotation) {\n    this._textAnnotationProps = annotation.toJSON();\n  }\n\n  protected constructor(props: TextAnnotation2dProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.defaultTextStyle) {\n      this.defaultTextStyle = new TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);\n    }\n    this._textAnnotationProps = parseTextAnnotationData(props.textAnnotationData)?.data;\n  }\n\n  /** Creates a new instance of `TextAnnotation2d` from its JSON representation. */\n  public static fromJSON(props: TextAnnotation2dProps, iModel: IModelDb): TextAnnotation2d {\n    return new TextAnnotation2d(props, iModel);\n  }\n\n  /**\n   * Converts the current `TextAnnotation2d` instance to its JSON representation.\n   * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.\n   * @inheritdoc\n   */\n  public override toJSON(): TextAnnotation2dProps {\n    const props = super.toJSON() as TextAnnotation2dProps;\n    props.textAnnotationData = this._textAnnotationProps ? JSON.stringify({ version: TEXT_ANNOTATION_JSON_VERSION, data: this._textAnnotationProps }) : undefined;\n    if (this._textAnnotationProps) {\n      props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.category, this.placement, this._textAnnotationProps, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);\n    }\n\n    return props;\n  }\n\n  /** Creates a new `TextAnnotation2d` instance with the specified properties.\n   * @param iModelDb The iModel.\n   * @param arg The arguments for creating the TextAnnotation2d.\n   * @beta\n   */\n  public static create(iModelDb: IModelDb, arg: TextAnnotation2dCreateArgs): TextAnnotation2d {\n    const elementProps: TextAnnotation2dProps = {\n      classFullName: this.classFullName,\n      textAnnotationData: arg.textAnnotationProps ? JSON.stringify({ version: TEXT_ANNOTATION_JSON_VERSION, data: arg.textAnnotationProps }) : undefined,\n      defaultTextStyle: arg.defaultTextStyleId ? new TextAnnotationUsesTextStyleByDefault(arg.defaultTextStyleId).toJSON() : undefined,\n      placement: arg.placement,\n      model: arg.model,\n      category: arg.category,\n      code: arg.code ?? Code.createEmpty(),\n    };\n    return new this(elementProps, iModelDb);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation2d on insert and validates version.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onInsert(arg: OnElementPropsArg): void {\n    super.onInsert(arg);\n    this.validateVersionAndUpdateGeometry(arg);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation2d on update and validates version.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onUpdate(arg: OnElementPropsArg): void {\n    super.onUpdate(arg);\n    this.validateVersionAndUpdateGeometry(arg);\n  }\n\n  /**\n   * Populates the `elementGeometryBuilderParams` property in the [TextAnnotation2dProps]($common).\n   * Only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.\n   * Also, validates the version of the text annotation data and migrates it if necessary.\n   * @beta\n   */\n  protected static validateVersionAndUpdateGeometry(arg: OnElementPropsArg): void {\n    const props = arg.props as TextAnnotation2dProps;\n    const textAnnotationData = parseTextAnnotationData(props.textAnnotationData);\n    if (!props.elementGeometryBuilderParams && textAnnotationData) {\n      props.elementGeometryBuilderParams = getElementGeometryBuilderParams(arg.iModel, props.model, props.category, props.placement ?? Placement2d.fromJSON(), textAnnotationData.data, props.defaultTextStyle?.id);\n    }\n  }\n\n  /**\n   * TextAnnotation2d custom HandledProps include 'textAnnotationData'.\n   * @inheritdoc\n   * @internal\n   */\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\n    { propertyName: \"textAnnotationData\", source: \"Class\" },\n  ];\n\n  /**\n   * TextAnnotation2d deserializes 'textAnnotationData'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override deserialize(props: DeserializeEntityArgs): TextAnnotation2dProps {\n    const elProps = super.deserialize(props) as TextAnnotation2dProps;\n    const textAnnotationData = parseTextAnnotationData(props.row.textAnnotationData);\n    if (textAnnotationData) {\n      elProps.textAnnotationData = JSON.stringify(textAnnotationData);\n    }\n    return elProps;\n  }\n\n  /**\n   * TextAnnotation2d serializes 'textAnnotationData'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override serialize(props: TextAnnotation2dProps, iModel: IModelDb): ECSqlRow {\n    const inst = super.serialize(props, iModel);\n    if (props.textAnnotationData !== undefined) {\n      inst.textAnnotationData = props.textAnnotationData;\n    }\n    return inst;\n  }\n\n  /** @internal */\n  public getTextBlocks(): Iterable<TextBlockAndId> {\n    return getTextBlocks(this);\n  }\n\n  /** @internal */\n  public updateTextBlocks(textBlocks: TextBlockAndId[]): void {\n    return updateTextBlocks(this, textBlocks);\n  }\n\n  /** @internal */\n  public static override onInserted(arg: OnElementIdArg): void {\n    super.onInserted(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n\n  /** @internal */\n  public static override onUpdated(arg: OnElementIdArg): void {\n    super.onUpdated(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n}\n\n/** An element that displays textual content within a 3d model.\n * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.\n * @see [[setAnnotation]] to change the textual content.\n * @public @preview\n */\nexport class TextAnnotation3d extends GraphicalElement3d /* implements ITextAnnotation */ {\n  /** @internal */\n  public static override get className(): string { return \"TextAnnotation3d\"; }\n  /**\n   * The default [[AnnotationTextStyle]] used by the TextAnnotation3d.\n   * @beta\n   */\n  public defaultTextStyle?: TextAnnotationUsesTextStyleByDefault;\n  /** The data associated with the text annotation. */\n  private _textAnnotationProps?: TextAnnotationProps;\n\n  /** Extract the textual content, if present.\n   * @see [[setAnnotation]] to change it.\n   */\n  public getAnnotation(): TextAnnotation | undefined {\n    return this._textAnnotationProps ? TextAnnotation.fromJSON(this._textAnnotationProps) : undefined;\n  }\n\n  /** Change the textual content of the `TextAnnotation3d`.\n   * @see [[getAnnotation]] to extract the current annotation.\n   * @param annotation The new annotation\n   */\n  public setAnnotation(annotation: TextAnnotation) {\n    this._textAnnotationProps = annotation.toJSON();\n  }\n\n  protected constructor(props: TextAnnotation3dProps, iModel: IModelDb) {\n    super(props, iModel);\n    if (props.defaultTextStyle) {\n      this.defaultTextStyle = new TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);\n    }\n    this._textAnnotationProps = parseTextAnnotationData(props.textAnnotationData)?.data;\n  }\n\n  /** Creates a new instance of `TextAnnotation3d` from its JSON representation. */\n  public static fromJSON(props: TextAnnotation3dProps, iModel: IModelDb): TextAnnotation3d {\n    return new TextAnnotation3d(props, iModel);\n  }\n\n  /**\n   * Converts the current `TextAnnotation3d` instance to its JSON representation.\n   * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.\n   * @inheritdoc\n   */\n  public override toJSON(): TextAnnotation3dProps {\n    const props = super.toJSON() as TextAnnotation3dProps;\n    props.textAnnotationData = this._textAnnotationProps ? JSON.stringify({ version: TEXT_ANNOTATION_JSON_VERSION, data: this._textAnnotationProps }) : undefined;\n    if (this._textAnnotationProps) {\n      props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.category, this.placement, this._textAnnotationProps, this.defaultTextStyle ? this.defaultTextStyle.id : undefined);\n    }\n\n    return props;\n  }\n\n  /** Creates a new `TextAnnotation3d` instance with the specified properties.\n   * @param iModelDb The iModel.\n   * @param arg The arguments for creating the TextAnnotation3d.\n   * @beta\n   */\n  public static create(iModelDb: IModelDb, arg: TextAnnotation3dCreateArgs): TextAnnotation3d {\n    const elementProps: TextAnnotation3dProps = {\n      classFullName: this.classFullName,\n      textAnnotationData: arg.textAnnotationProps ? JSON.stringify({ version: TEXT_ANNOTATION_JSON_VERSION, data: arg.textAnnotationProps }) : undefined,\n      defaultTextStyle: arg.defaultTextStyleId ? new TextAnnotationUsesTextStyleByDefault(arg.defaultTextStyleId).toJSON() : undefined,\n      placement: arg.placement,\n      model: arg.model,\n      category: arg.category,\n      code: arg.code ?? Code.createEmpty(),\n    };\n    return new this(elementProps, iModelDb);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation3d on insert and validates version..\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onInsert(arg: OnElementPropsArg): void {\n    super.onInsert(arg);\n    this.validateVersionAndUpdateGeometry(arg);\n  }\n\n  /**\n   * Updates the geometry of the TextAnnotation3d on update and validates version..\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onUpdate(arg: OnElementPropsArg): void {\n    super.onUpdate(arg);\n    this.validateVersionAndUpdateGeometry(arg);\n  }\n\n  /**\n   * Populates the `elementGeometryBuilderParams` property in the [TextAnnotation3dProps]($common).\n   * Only does this if the `elementGeometryBuilderParams` is not already set and if there is actually a text annotation to produce geometry for.\n   * Also, validates the version of the text annotation data and migrates it if necessary.\n   * @beta\n   */\n  protected static validateVersionAndUpdateGeometry(arg: OnElementPropsArg): void {\n    const props = arg.props as TextAnnotation3dProps;\n    const textAnnotationData = parseTextAnnotationData(props.textAnnotationData);\n    if (!props.elementGeometryBuilderParams && textAnnotationData) {\n      props.elementGeometryBuilderParams = getElementGeometryBuilderParams(arg.iModel, props.model, props.category, props.placement ?? Placement3d.fromJSON(), textAnnotationData.data, props.defaultTextStyle?.id);\n    }\n  }\n\n  /**\n   * TextAnnotation3d custom HandledProps include 'textAnnotationData'.\n   * @inheritdoc\n   * @internal\n   */\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\n    { propertyName: \"textAnnotationData\", source: \"Class\" },\n  ];\n\n  /**\n   * TextAnnotation3d deserializes 'textAnnotationData'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override deserialize(props: DeserializeEntityArgs): TextAnnotation3dProps {\n    const elProps = super.deserialize(props) as TextAnnotation3dProps;\n    const textAnnotationData = parseTextAnnotationData(props.row.textAnnotationData);\n    if (textAnnotationData) {\n      elProps.textAnnotationData = JSON.stringify(textAnnotationData);\n    }\n    return elProps;\n  }\n\n  /**\n   * TextAnnotation3d serializes 'textAnnotationData'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override serialize(props: TextAnnotation3dProps, iModel: IModelDb): ECSqlRow {\n    const inst = super.serialize(props, iModel);\n    if (props.textAnnotationData !== undefined) {\n      inst.textAnnotationData = props.textAnnotationData;\n    }\n    return inst;\n  }\n\n  /** @internal */\n  public getTextBlocks(): Iterable<TextBlockAndId> {\n    return getTextBlocks(this);\n  }\n\n  /** @internal */\n  public updateTextBlocks(textBlocks: TextBlockAndId[]): void {\n    return updateTextBlocks(this, textBlocks);\n  }\n\n  /** @internal */\n  public static override onInserted(arg: OnElementIdArg): void {\n    super.onInserted(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n\n  /** @internal */\n  public static override onUpdated(arg: OnElementIdArg): void {\n    super.onUpdated(arg);\n    ElementDrivesTextAnnotation.updateFieldDependencies(arg.id, arg.iModel);\n  }\n}\n\nfunction getTextBlocks(elem: TextAnnotation2d | TextAnnotation3d): Iterable<TextBlockAndId> {\n  const annotation = elem.getAnnotation();\n  return annotation ? [{ textBlock: annotation.textBlock, id: undefined }] : [];\n}\n\nfunction updateTextBlocks(elem: TextAnnotation2d | TextAnnotation3d, textBlocks: TextBlockAndId[]): void {\n  assert(textBlocks.length === 1);\n  assert(textBlocks[0].id === undefined);\n\n  const annotation = elem.getAnnotation();\n  if (!annotation) {\n    // We must obtain the TextBlockAndId from the element in the first place, so the only way we could end up here is if\n    // somebody removed the text annotation after we called getTextBlocks. That's gotta be a mistake.\n    throw new Error(\"Text annotation element has no text\");\n  }\n\n  annotation.textBlock = textBlocks[0].textBlock;\n\n  elem.setAnnotation(annotation);\n  elem.update();\n}\n\n/** The version of the JSON stored in `AnnotationTextStyleProps.settings` used by the code.\n * Uses the same semantics as [ECVersion]($ecschema-metadata).\n * @internal\n*/\nexport const TEXT_STYLE_SETTINGS_JSON_VERSION = \"1.0.0\";\n\nfunction migrateTextStyleSettings(oldData: VersionedJSON<TextStyleSettingsProps>): TextStyleSettingsProps {\n  if (oldData.version === TEXT_STYLE_SETTINGS_JSON_VERSION) return oldData.data;\n\n  // Place migration logic here.\n\n  throw new Error(`Migration for settings from version ${oldData.version} to ${TEXT_STYLE_SETTINGS_JSON_VERSION} failed.`);\n}\n\n/** Arguments supplied when creating an [[AnnotationTextStyle]].\n * @beta\n */\nexport interface TextStyleCreateArgs {\n  /** The ID of the [[DefinitionModel]]. */\n  definitionModelId: Id64String;\n  /** The name to assign to the [[AnnotationTextStyle]]. */\n  name: string;\n  /** Optional text style settings used to create the [[AnnotationTextStyle]]. Default settings will be used if not provided. */\n  settings?: TextStyleSettingsProps;\n  /** Optional description for the [[AnnotationTextStyle]]. */\n  description?: string;\n}\n\n/**\n * The definition element that holds text style information.\n * The style is stored as a [TextStyleSettings]($common).\n * @beta\n */\nexport class AnnotationTextStyle extends DefinitionElement {\n  /** @internal */\n  public static override get className(): string { return \"AnnotationTextStyle\"; }\n  /**\n   * Optional text describing the `AnnotationTextStyle`.\n   */\n  public description?: string;\n  /**\n   * The text style settings for the `AnnotationTextStyle`.\n   * @see [[TextStyleSettings]] for more information.\n   */\n  public settings: TextStyleSettings;\n\n  protected constructor(props: AnnotationTextStyleProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.description = props.description;\n    const settingsProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);\n    this.settings = TextStyleSettings.fromJSON(settingsProps?.data);\n  }\n\n  /**\n   * Creates a Code for an `AnnotationTextStyle` given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   *\n   * @param iModel - The IModelDb.\n   * @param definitionModelId - The ID of the DefinitionModel that contains the AnnotationTextStyle and provides the scope for its name.\n   * @param name - The AnnotationTextStyle name.\n   * @beta\n   */\n  public static createCode(iModel: IModelDb, definitionModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.annotationTextStyle);\n    return new Code({ spec: codeSpec.id, scope: definitionModelId, value: name });\n  }\n\n  /**\n   * Creates a new instance of `AnnotationTextStyle` with the specified properties.\n   *\n   * @param iModelDb - The iModelDb.\n   * @param arg - The arguments for creating the AnnotationTextStyle.\n   * @beta\n   */\n  public static create(iModelDb: IModelDb, arg: TextStyleCreateArgs): AnnotationTextStyle {\n    const props: AnnotationTextStyleProps = {\n      classFullName: this.classFullName,\n      model: arg.definitionModelId,\n      code: this.createCode(iModelDb, arg.definitionModelId, arg.name).toJSON(),\n      description: arg.description,\n      settings: arg.settings ? JSON.stringify({version: TEXT_STYLE_SETTINGS_JSON_VERSION, data: arg.settings}) : undefined,\n    }\n    return new this(props, iModelDb);\n  }\n\n  /**\n   * Converts the current `AnnotationTextStyle` instance to its JSON representation.\n   * @inheritdoc\n   */\n  public override toJSON(): AnnotationTextStyleProps {\n    const props = super.toJSON() as AnnotationTextStyleProps;\n    props.description = this.description;\n    props.settings = JSON.stringify({version: TEXT_STYLE_SETTINGS_JSON_VERSION, data: this.settings.toJSON()});\n    return props;\n  }\n\n  /** Creates a new instance of `AnnotationTextStyle` from its JSON representation. */\n  public static fromJSON(props: AnnotationTextStyleProps, iModel: IModelDb): AnnotationTextStyle {\n    return new AnnotationTextStyle(props, iModel);\n  }\n\n  /**\n   * Validates that the AnnotationTextStyle's settings are valid before insert.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onInsert(arg: OnElementPropsArg): void {\n    super.onInsert(arg);\n    this.validateSettings(arg.props as AnnotationTextStyleProps);\n  }\n\n  /**\n   * Validates that the AnnotationTextStyle's settings are valid before update.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override onUpdate(arg: OnElementPropsArg): void {\n    super.onUpdate(arg);\n    this.validateSettings(arg.props as AnnotationTextStyleProps);\n  }\n\n  private static validateSettings(props: AnnotationTextStyleProps): void {\n    const settingProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);\n    if (!settingProps) return;\n    const settings = TextStyleSettings.fromJSON(settingProps.data);\n    const errors = settings.getValidationErrors();\n    if (errors.length > 0) {\n      throw new Error(`Invalid AnnotationTextStyle settings: ${errors.join(\", \")}`);\n    }\n  }\n\n  /**\n   * AnnotationTextStyle custom HandledProps include 'settings'.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\n    { propertyName: \"settings\", source: \"Class\" },\n  ];\n\n  /**\n   * AnnotationTextStyle deserializes 'settings'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override deserialize(props: DeserializeEntityArgs): AnnotationTextStyleProps {\n    const elProps = super.deserialize(props) as AnnotationTextStyleProps;\n    const settings = this.parseTextStyleSettings(props.row.settings);\n    if (settings) {\n      elProps.settings = JSON.stringify(settings);\n    }\n    return elProps;\n  }\n\n  /**\n   * AnnotationTextStyle serializes 'settings'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override serialize(props: AnnotationTextStyleProps, iModel: IModelDb): ECSqlRow {\n    const inst = super.serialize(props, iModel);\n    if (props.settings !== undefined) {\n      inst.settings = props.settings;\n    }\n    return inst;\n  }\n\n  /** Parses, validates, and potentially migrates the text style settings data from a JSON string. */\n  private static parseTextStyleSettings(json: string | undefined): VersionedJSON<TextStyleSettingsProps> | undefined {\n    if (!json) return undefined;\n    return validateAndMigrateVersionedJSON<TextStyleSettingsProps>(json, TEXT_STYLE_SETTINGS_JSON_VERSION, migrateTextStyleSettings);\n  }\n}"]}