@itwin/core-backend 5.2.0-dev.7 → 5.2.0

package/lib/cjs/annotations/TextAnnotationElement.js

@@ -7,30 +7,64 @@
  * @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, _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, iModel, modelId });
+    const textStyleResolver = new TextBlockLayout_1.TextStyleResolver({ textBlock, textStyleId: textStyleId ?? "", iModel });
     const layout = (0, TextBlockLayout_1.layoutTextBlock)({ iModel, textBlock, textStyleResolver });
     const builder = new core_common_1.ElementGeometry.Builder();
-    (0, TextAnnotationGeometry_1.appendTextAnnotationGeometry)({ layout, textStyleResolver, annotationProps: annotationProps ?? {}, builder, categoryId });
+    let scaleFactor = 1;
+    const element = iModel.elements.getElement(modelId);
+    if (element instanceof Element_1.Drawing)
+        scaleFactor = element.scaleFactor;
+    (0, TextAnnotationGeometry_1.appendTextAnnotationGeometry)({ layout, textStyleResolver, scaleFactor, annotationProps: annotationProps ?? {}, builder, categoryId });
     return { entryArray: builder.entries };
 }
 /** An element that displays textual content within a 2d model.
@@ -41,25 +75,32 @@ function getElementGeometryBuilderParams(iModel, modelId, _placementProps, strin
 class TextAnnotation2d extends Element_1.AnnotationElement2d /* implements ITextAnnotation */ {
     /** @internal */
     static get className() { return "TextAnnotation2d"; }
-    /** Optional string containing the data associated with the text annotation. */
-    _textAnnotationData;
+    /**
+     * The default [[AnnotationTextStyle]] used by the TextAnnotation2d.
+     * @beta
+     */
+    defaultTextStyle;
+    /** 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);
-        this._textAnnotationData = props.textAnnotationData;
+        if (props.defaultTextStyle) {
+            this.defaultTextStyle = new ElementDrivesTextAnnotation_1.TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);
+        }
+        this._textAnnotationProps = parseTextAnnotationData(props.textAnnotationData)?.data;
     }
     /** Creates a new instance of `TextAnnotation2d` from its JSON representation. */
     static fromJSON(props, iModel) {
@@ -68,76 +109,96 @@ 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);
+        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;
     }
     /** Creates a new `TextAnnotation2d` instance with the specified properties.
      * @param iModelDb The iModel.
-     * @param category The category ID for the annotation.
-     * @param model The model ID where the annotation will be placed.
-     * @param placement The placement properties for the annotation.
-     * @param textAnnotationData Optional [[TextAnnotation]] JSON representation used to create the `TextAnnotation2d`. Essentially an empty element if not provided.
-     * @param code Optional code for the element.
+     * @param arg The arguments for creating the TextAnnotation2d.
+     * @beta
      */
-    static create(iModelDb, category, model, placement, textAnnotationData, code) {
-        const props = {
+    static create(iModelDb, arg) {
+        const elementProps = {
             classFullName: this.classFullName,
-            textAnnotationData: JSON.stringify(textAnnotationData),
-            placement,
-            model,
-            category,
-            code: code ?? core_common_1.Code.createEmpty(),
+            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,
+            category: arg.category,
+            code: arg.code ?? core_common_1.Code.createEmpty(),
         };
-        return new this(props, iModelDb);
+        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);
     }
     /**
-     * Collects reference IDs used by this `TextAnnotation2d`.
+     * TextAnnotation2d custom HandledProps include 'textAnnotationData'.
      * @inheritdoc
+     * @internal
      */
-    collectReferenceIds(ids) {
-        super.collectReferenceIds(ids);
-        const annotation = this.getAnnotation();
-        if (!annotation) {
-            return;
+    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);
         }
-        if (annotation.textBlock.styleId)
-            ids.addElement(annotation.textBlock.styleId);
+        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() {
@@ -167,25 +228,32 @@ exports.TextAnnotation2d = TextAnnotation2d;
 class TextAnnotation3d extends Element_1.GraphicalElement3d /* implements ITextAnnotation */ {
     /** @internal */
     static get className() { return "TextAnnotation3d"; }
-    /** Optional string containing the data associated with the text annotation. */
-    _textAnnotationData;
+    /**
+     * The default [[AnnotationTextStyle]] used by the TextAnnotation3d.
+     * @beta
+     */
+    defaultTextStyle;
+    /** 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);
-        this._textAnnotationData = props.textAnnotationData;
+        if (props.defaultTextStyle) {
+            this.defaultTextStyle = new ElementDrivesTextAnnotation_1.TextAnnotationUsesTextStyleByDefault(props.defaultTextStyle.id);
+        }
+        this._textAnnotationProps = parseTextAnnotationData(props.textAnnotationData)?.data;
     }
     /** Creates a new instance of `TextAnnotation3d` from its JSON representation. */
     static fromJSON(props, iModel) {
@@ -198,71 +266,92 @@ 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);
+        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;
     }
     /** Creates a new `TextAnnotation3d` instance with the specified properties.
      * @param iModelDb The iModel.
-     * @param category The category ID for the annotation.
-     * @param model The model ID where the annotation will be placed.
-     * @param placement The placement properties for the annotation.
-     * @param textAnnotationData Optional [[TextAnnotation]] JSON representation used to create the `TextAnnotation3d`. Essentially an empty element if not provided.
-     * @param code Optional code for the element.
+     * @param arg The arguments for creating the TextAnnotation3d.
+     * @beta
      */
-    static create(iModelDb, category, model, placement, textAnnotationData, code) {
-        const props = {
+    static create(iModelDb, arg) {
+        const elementProps = {
             classFullName: this.classFullName,
-            textAnnotationData: JSON.stringify(textAnnotationData),
-            placement,
-            model,
-            category,
-            code: code ?? core_common_1.Code.createEmpty(),
+            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,
+            category: arg.category,
+            code: arg.code ?? core_common_1.Code.createEmpty(),
         };
-        return new this(props, iModelDb);
+        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);
     }
     /**
-     * Collects reference IDs used by this `TextAnnotation3d`.
+     * TextAnnotation3d custom HandledProps include 'textAnnotationData'.
      * @inheritdoc
+     * @internal
      */
-    collectReferenceIds(ids) {
-        super.collectReferenceIds(ids);
-        const annotation = this.getAnnotation();
-        if (!annotation) {
-            return;
+    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;
         }
-        if (annotation.textBlock.styleId)
-            ids.addElement(annotation.textBlock.styleId);
+        return inst;
     }
     /** @internal */
     getTextBlocks() {
@@ -301,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).
@@ -322,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.
@@ -330,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);
@@ -339,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);
     }
@@ -361,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. */
@@ -390,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;