@itwin/core-backend 5.1.0-dev.60 → 5.1.0-dev.62

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

@@ -1 +1 @@
-{"version":3,"file":"LeaderGeometry.js","sourceRoot":"","sources":["../../../src/annotations/LeaderGeometry.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 ElementGeometry\n */\n\nimport { ColorDef, ElementGeometry, GeometryParams, TextAnnotationLeader, TextFrameStyleProps } from \"@itwin/core-common\";\nimport { CurveCurve, LineSegment3d, LineString3d, Loop, Path, Point3d, Transform, Vector3d } from \"@itwin/core-geometry\";\nimport { computeFrame } from \"./FrameGeometry\";\nimport { TextBlockLayout } from \"./TextBlockLayout\";\n\n/**\n * Constructs and appends leader lines and their terminators to the provided geometry builder for a text annotation.\n *\n * This function processes an array of `TextAnnotationLeader` objects, computes their attachment points\n * relative to a text frame (or a default rectangular frame if none is provided), and appends the leader\n * line and terminator geometry to the builder. It also applies color overrides if specified\n * in the leader's style overrides.\n *\n * @param builder - The geometry builder to which the leader geometries will be appended.\n * @param leaders - An array of leader properties.\n * @param layout - The layout information for the text block, including its range.\n * @param transform - The transform to apply to the frame and leader geometry.\n * @param params - The geometry parameters, such as color, to use for the leader lines.\n * @param frame - (Optional) The style properties for the text frame. If not provided or set to \"none\", a default rectangle is used.\n * @returns `true` if at least one leader with a terminator was successfully appended; otherwise, `false`.\n * @beta\n */\nexport function appendLeadersToBuilder(builder: ElementGeometry.Builder, leaders: TextAnnotationLeader[], layout: TextBlockLayout, transform: Transform, params: GeometryParams, frame?: TextFrameStyleProps): boolean {\n  let result = true;\n\n  // If there is no frame, use a rectangular frame to compute the attachmentPoints for leaders.\n  if (frame === undefined || frame.shape === \"none\") {\n    frame = { shape: \"rectangle\" }\n  }\n  if (frame.shape === undefined || frame.shape === \"none\") return false;\n  const frameCurve = computeFrame({ frame: frame.shape, range: layout.range, transform });\n\n  for (const leader of leaders) {\n    if (leader.styleOverrides?.leader?.color !== \"subcategory\" && leader.styleOverrides?.color !== \"subcategory\") {\n      const color = leader.styleOverrides?.leader?.color ?? leader.styleOverrides?.color;\n      params.lineColor = color ? ColorDef.fromJSON(color) : ColorDef.black;\n      result = result && builder.appendGeometryParamsChange(params);\n    }\n\n    const attachmentPoint = computeLeaderAttachmentPoint(leader, frameCurve, layout, transform);\n    if (!attachmentPoint) return false;\n\n    // Leader line geometry\n    const leaderLinePoints: Point3d[] = [];\n\n    leaderLinePoints.push(leader.startPoint)\n\n    leader.intermediatePoints?.forEach((point) => {\n      leaderLinePoints.push(point);\n    });\n\n    if (leader.styleOverrides?.leader?.wantElbow) {\n      const elbowLength = (leader.styleOverrides.leader.elbowLength ?? 1) * (leader.styleOverrides.lineHeight ?? 1)\n      const elbowDirection = computeElbowDirection(attachmentPoint, frameCurve, elbowLength);\n      if (elbowDirection)\n        leaderLinePoints.push(attachmentPoint.plusScaled(elbowDirection, elbowLength))\n    }\n\n    leaderLinePoints.push(attachmentPoint)\n\n    result = result && builder.appendGeometryQuery(LineString3d.create(leaderLinePoints));\n\n    // Terminator geometry\n    const terminatorDirection = Vector3d.createStartEnd(\n      leaderLinePoints[0], leaderLinePoints[1]\n    ).normalize();\n\n    const termY = terminatorDirection?.unitCrossProduct(Vector3d.unitZ());\n    if (!termY || !terminatorDirection) continue; // Assuming leaders without terminators is a valid case.\n    const terminatorHeight = (leader.styleOverrides?.leader?.terminatorHeightFactor ?? 1) * (leader.styleOverrides?.lineHeight ?? 1);\n    const terminatorWidth = (leader.styleOverrides?.leader?.terminatorWidthFactor ?? 1) * (leader.styleOverrides?.lineHeight ?? 1);\n    const basePoint = leader.startPoint.plusScaled(terminatorDirection, terminatorWidth);\n    const termPointA = basePoint.plusScaled(termY, terminatorHeight);\n    const termPointB = basePoint.plusScaled(termY.negate(), terminatorHeight);\n    result = result && builder.appendGeometryQuery(LineString3d.create([termPointA, leader.startPoint, termPointB]));\n\n  }\n  return result;\n}\n\n\n/**\n * Computes the direction vector for an \"elbow\" for leader based on the attachment point and a frame curve.\n * The elbow direction is determined by whether the attachment point is closer to the left or right side of the frame.\n * If the computed elbow would be tangent to the frame at the intersection, no elbow direction is returned.\n *\n * @param attachmentPoint - The point where the leader attaches.\n * @param frameCurve - The frame curve (either a Loop or Path) to which the leader is attached.\n * @param elbowLength - The length of the elbow segment to be created.\n * @returns The direction vector for the elbow, or `undefined` if the elbow would be tangent to the frame.\n * @beta\n */\nexport function computeElbowDirection(attachmentPoint: Point3d, frameCurve: Loop | Path, elbowLength: number): Vector3d | undefined {\n\n  let elbowDirection: Vector3d | undefined;\n  // Determine the direction based on the closest point's position relative to the frame\n  const isCloserToLeft = Math.abs(attachmentPoint.x - frameCurve.range().low.x) < Math.abs(attachmentPoint.x - frameCurve.range().high.x);\n\n  // Decide the direction: left (-X) or right (+X)\n  elbowDirection = isCloserToLeft ? Vector3d.unitX().negate() : Vector3d.unitX();\n\n  // Verify if the elbow is a tangent to the frame, if yes, do not create an elbow\n  const elbowPoint = attachmentPoint.plusScaled(elbowDirection, elbowLength);\n  const elbowLine = LineSegment3d.create(attachmentPoint, elbowPoint);\n  // Find intersection points between the elbow and the frame\n  const intersections = CurveCurve.intersectionXYZPairs(elbowLine, false, frameCurve, false);\n  // As the elbow will intersect the frame only at one point, we can safely use the first intersection\n  const intersection = intersections[0];\n  const curveFraction = intersection.detailB.fraction;\n  const derivative = intersection.detailB.curve?.fractionToPointAndDerivative(curveFraction);\n  const tangent = derivative?.direction.normalize();\n  const lineDirection = Vector3d.createStartEnd(elbowLine.point0Ref, elbowLine.point1Ref).normalize();\n  if (tangent && lineDirection) {\n    const dot = tangent.dotProduct(lineDirection);\n    // If the tangent and line direction are aligned (dot product close to 1 or -1), it's tangent\n    if (Math.abs(dot) > 0.999) {\n      elbowDirection = undefined;\n    }\n  }\n  return elbowDirection;\n}\n\n/**\n * Computes the attachment point for a leader line on a text annotation frame.\n *\n * The attachment point is determined based on the leader's attachment mode:\n * - `\"Nearest\"`: Finds the closest point on the frame curve to the leader's start point.\n * - `\"KeyPoint\"`: Uses a specific curve segment and fraction along that segment to determine the point.\n * - `\"TextPoint\"`: Calculates a point on the text layout (top/bottom, left/right) and projects it onto the frame curve.\n *\n * @param leader - The leader props.\n * @param frameCurve - The curve (Loop or Path) representing the annotation frame.\n * @param textLayout - The layout information for the text block.\n * @param transform - The transform applied to the text layout.\n * @returns The computed attachment point as a `Point3d`, or `undefined` if it cannot be determined.\n * @beta\n */\nexport function computeLeaderAttachmentPoint(\n  leader: TextAnnotationLeader,\n  frameCurve: Loop | Path,\n  textLayout: TextBlockLayout,\n  transform: Transform\n): Point3d | undefined {\n  let attachmentPoint: Point3d | undefined;\n\n  if (leader.attachment.mode === \"Nearest\") {\n    attachmentPoint = frameCurve.closestPoint(leader.startPoint)?.point;\n  } else if (leader.attachment.mode === \"KeyPoint\") {\n    const curves = frameCurve.collectCurvePrimitives(undefined, false, true);\n    const curveIndex = leader.attachment.curveIndex;\n    const fraction = leader.attachment.fraction;\n    if (curveIndex >= curves.length) {\n      // If the curveIndex is invalid, use the last curve\n      // This is a fallback to avoid out-of-bounds access\n      attachmentPoint = curves[curves.length - 1].fractionToPoint(fraction);\n    } else {\n      attachmentPoint = curves[curveIndex].fractionToPoint(fraction);\n    }\n  } else { // attachment.mode=\"TextPoint\"\n    let scaleDirection = transform.matrix.getColumn(0).negate(); // direction to draw a scaled line from text attachment point to find intersection point on frame\n    let lineIndex: number;\n    if (leader.attachment.position.includes(\"Top\")) {\n      lineIndex = 0\n    } else {\n      lineIndex = textLayout.lines.length - 1\n    }\n    const lineRange = textLayout.lines[lineIndex].range;\n    const lineOffset = textLayout.lines[lineIndex].offsetFromDocument;\n    const origin = transform.multiplyPoint3d(Point3d.fromJSON(lineOffset));\n    let attachmentPointOnText = origin.plusScaled(transform.matrix.getColumn(1), ((lineRange.yLength()) / 2));\n\n    if (leader.attachment.position.includes(\"Right\")) {\n      attachmentPointOnText = attachmentPointOnText.plusScaled(transform.matrix.getColumn(0), lineRange.xLength());\n      scaleDirection = scaleDirection.negate();\n    }\n    // Find the nearest intersection point on the frame to get the correct attachment point\n    // Extend the direction vector to create a target point far along the direction\n    const targetPoint = attachmentPointOnText.plusScaled(scaleDirection, 1e6); // Scale the direction vector to a large value\n    const intersectionLine = LineSegment3d.create(attachmentPointOnText, targetPoint);\n    const closestPointDetail = CurveCurve.intersectionXYZPairs(intersectionLine, false, frameCurve, false);\n    attachmentPoint = closestPointDetail[0]?.detailA.point;\n  }\n  return attachmentPoint;\n}"]}
+{"version":3,"file":"LeaderGeometry.js","sourceRoot":"","sources":["../../../src/annotations/LeaderGeometry.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 ElementGeometry\n */\n\nimport { ColorDef, ElementGeometry, GeometryParams, TextAnnotationLeader, TextFrameStyleProps, TextStyleColor } from \"@itwin/core-common\";\nimport { CurveCurve, LineSegment3d, LineString3d, Loop, Path, Point3d, Transform, Vector3d } from \"@itwin/core-geometry\";\nimport { computeFrame } from \"./FrameGeometry\";\nimport { TextBlockLayout, TextStyleResolver } from \"./TextBlockLayout\";\n\n/**\n * Constructs and appends leader lines and their terminators to the provided geometry builder for a text annotation.\n *\n * This function processes an array of `TextAnnotationLeader` objects, computes their attachment points\n * relative to a text frame (or a default rectangular frame if none is provided), and appends the leader\n * line and terminator geometry to the builder. It also applies color overrides if specified\n * in the leader's style overrides.\n *\n * @param builder - The geometry builder to which the leader geometries will be appended.\n * @param leaders - An array of leader properties.\n * @param layout - The layout information for the text block, including its range.\n * @param transform - The transform to apply to the frame and leader geometry.\n * @param params - The geometry parameters, such as color, to use for the leader lines.\n * @param frame - (Optional) The style properties for the text frame. If not provided or set to \"none\", a default rectangle is used.\n * @returns `true` if at least one leader with a terminator was successfully appended; otherwise, `false`.\n * @beta\n */\nexport function appendLeadersToBuilder(builder: ElementGeometry.Builder, leaders: TextAnnotationLeader[], layout: TextBlockLayout, transform: Transform, params: GeometryParams, textStyleResolver: TextStyleResolver): boolean {\n  let result = true;\n  const scaledLineHeight = textStyleResolver.blockSettings.lineHeight * textStyleResolver.scaleFactor;\n  let frame: TextFrameStyleProps | undefined = textStyleResolver.blockSettings.frame;\n\n  // If there is no frame, use a rectangular frame to compute the attachmentPoints for leaders.\n  if (frame === undefined || frame.shape === \"none\") {\n    frame = { shape: \"rectangle\" }\n  }\n  if (frame.shape === undefined || frame.shape === \"none\") return false;\n  const frameCurve = computeFrame({ frame: frame.shape, range: layout.range, transform });\n\n  for (const leader of leaders) {\n    const leaderStyle = textStyleResolver.resolveTextAnnotationLeaderSettings(leader);\n\n    let effectiveColor: TextStyleColor = \"subcategory\";\n\n    if (leaderStyle.leader.color === \"inherit\") {\n      effectiveColor = leaderStyle.color;\n    } else if (leaderStyle.leader.color !== \"subcategory\") {\n      effectiveColor = leaderStyle.leader.color;\n    }\n\n    if (effectiveColor !== \"subcategory\") {\n      params.lineColor = ColorDef.fromJSON(effectiveColor);\n      result = result && builder.appendGeometryParamsChange(params);\n    }\n\n    const attachmentPoint = computeLeaderAttachmentPoint(leader, frameCurve, layout, transform);\n    if (!attachmentPoint) return false;\n\n    // Leader line geometry\n    const leaderLinePoints: Point3d[] = [];\n\n    leaderLinePoints.push(leader.startPoint)\n\n    leader.intermediatePoints?.forEach((point) => {\n      leaderLinePoints.push(point);\n    });\n\n    if (leaderStyle.leader.wantElbow) {\n      const elbowLength = leaderStyle.leader.elbowLength * scaledLineHeight;\n      const elbowDirection = computeElbowDirection(attachmentPoint, frameCurve, elbowLength);\n      if (elbowDirection)\n        leaderLinePoints.push(attachmentPoint.plusScaled(elbowDirection, elbowLength))\n    }\n\n    leaderLinePoints.push(attachmentPoint)\n\n    result = result && builder.appendGeometryQuery(LineString3d.create(leaderLinePoints));\n\n    // Terminator geometry\n    const terminatorDirection = Vector3d.createStartEnd(\n      leaderLinePoints[0], leaderLinePoints[1]\n    ).normalize();\n\n    const termY = terminatorDirection?.unitCrossProduct(Vector3d.unitZ());\n    if (!termY || !terminatorDirection) continue; // Assuming leaders without terminators is a valid case.\n    const terminatorHeight = leaderStyle.leader.terminatorHeightFactor * scaledLineHeight;\n    const terminatorWidth = leaderStyle.leader.terminatorWidthFactor * scaledLineHeight;\n    const basePoint = leader.startPoint.plusScaled(terminatorDirection, terminatorWidth);\n    const termPointA = basePoint.plusScaled(termY, terminatorHeight);\n    const termPointB = basePoint.plusScaled(termY.negate(), terminatorHeight);\n    result = result && builder.appendGeometryQuery(LineString3d.create([termPointA, leader.startPoint, termPointB]));\n\n  }\n  return result;\n}\n\n\n/**\n * Computes the direction vector for an \"elbow\" for leader based on the attachment point and a frame curve.\n * The elbow direction is determined by whether the attachment point is closer to the left or right side of the frame.\n * If the computed elbow would be tangent to the frame at the intersection, no elbow direction is returned.\n *\n * @param attachmentPoint - The point where the leader attaches.\n * @param frameCurve - The frame curve (either a Loop or Path) to which the leader is attached.\n * @param elbowLength - The length of the elbow segment to be created.\n * @returns The direction vector for the elbow, or `undefined` if the elbow would be tangent to the frame.\n * @beta\n */\nexport function computeElbowDirection(attachmentPoint: Point3d, frameCurve: Loop | Path, elbowLength: number): Vector3d | undefined {\n\n  let elbowDirection: Vector3d | undefined;\n  // Determine the direction based on the closest point's position relative to the frame\n  const isCloserToLeft = Math.abs(attachmentPoint.x - frameCurve.range().low.x) < Math.abs(attachmentPoint.x - frameCurve.range().high.x);\n\n  // Decide the direction: left (-X) or right (+X)\n  elbowDirection = isCloserToLeft ? Vector3d.unitX().negate() : Vector3d.unitX();\n\n  // Verify if the elbow is a tangent to the frame, if yes, do not create an elbow\n  const elbowPoint = attachmentPoint.plusScaled(elbowDirection, elbowLength);\n  const elbowLine = LineSegment3d.create(attachmentPoint, elbowPoint);\n  // Find intersection points between the elbow and the frame\n  const intersections = CurveCurve.intersectionXYZPairs(elbowLine, false, frameCurve, false);\n  // As the elbow will intersect the frame only at one point, we can safely use the first intersection\n  const intersection = intersections[0];\n  const curveFraction = intersection.detailB.fraction;\n  const derivative = intersection.detailB.curve?.fractionToPointAndDerivative(curveFraction);\n  const tangent = derivative?.direction.normalize();\n  const lineDirection = Vector3d.createStartEnd(elbowLine.point0Ref, elbowLine.point1Ref).normalize();\n  if (tangent && lineDirection) {\n    const dot = tangent.dotProduct(lineDirection);\n    // If the tangent and line direction are aligned (dot product close to 1 or -1), it's tangent\n    if (Math.abs(dot) > 0.999) {\n      elbowDirection = undefined;\n    }\n  }\n  return elbowDirection;\n}\n\n/**\n * Computes the attachment point for a leader line on a text annotation frame.\n *\n * The attachment point is determined based on the leader's attachment mode:\n * - `\"Nearest\"`: Finds the closest point on the frame curve to the leader's start point.\n * - `\"KeyPoint\"`: Uses a specific curve segment and fraction along that segment to determine the point.\n * - `\"TextPoint\"`: Calculates a point on the text layout (top/bottom, left/right) and projects it onto the frame curve.\n *\n * @param leader - The leader props.\n * @param frameCurve - The curve (Loop or Path) representing the annotation frame.\n * @param textLayout - The layout information for the text block.\n * @param transform - The transform applied to the text layout.\n * @returns The computed attachment point as a `Point3d`, or `undefined` if it cannot be determined.\n * @beta\n */\nexport function computeLeaderAttachmentPoint(\n  leader: TextAnnotationLeader,\n  frameCurve: Loop | Path,\n  textLayout: TextBlockLayout,\n  transform: Transform\n): Point3d | undefined {\n  let attachmentPoint: Point3d | undefined;\n\n  if (leader.attachment.mode === \"Nearest\") {\n    attachmentPoint = frameCurve.closestPoint(leader.startPoint)?.point;\n  } else if (leader.attachment.mode === \"KeyPoint\") {\n    const curves = frameCurve.collectCurvePrimitives(undefined, false, true);\n    const curveIndex = leader.attachment.curveIndex;\n    const fraction = leader.attachment.fraction;\n    if (curveIndex >= curves.length) {\n      // If the curveIndex is invalid, use the last curve\n      // This is a fallback to avoid out-of-bounds access\n      attachmentPoint = curves[curves.length - 1].fractionToPoint(fraction);\n    } else {\n      attachmentPoint = curves[curveIndex].fractionToPoint(fraction);\n    }\n  } else { // attachment.mode=\"TextPoint\"\n    let scaleDirection = transform.matrix.getColumn(0).negate(); // direction to draw a scaled line from text attachment point to find intersection point on frame\n    let lineIndex: number;\n    if (leader.attachment.position.includes(\"Top\")) {\n      lineIndex = 0\n    } else {\n      lineIndex = textLayout.lines.length - 1\n    }\n    const lineRange = textLayout.lines[lineIndex].range;\n    const lineOffset = textLayout.lines[lineIndex].offsetFromDocument;\n    const origin = transform.multiplyPoint3d(Point3d.fromJSON(lineOffset));\n    let attachmentPointOnText = origin.plusScaled(transform.matrix.getColumn(1), ((lineRange.yLength()) / 2));\n\n    if (leader.attachment.position.includes(\"Right\")) {\n      attachmentPointOnText = attachmentPointOnText.plusScaled(transform.matrix.getColumn(0), lineRange.xLength());\n      scaleDirection = scaleDirection.negate();\n    }\n    // Find the nearest intersection point on the frame to get the correct attachment point\n    // Extend the direction vector to create a target point far along the direction\n    const targetPoint = attachmentPointOnText.plusScaled(scaleDirection, 1e6); // Scale the direction vector to a large value\n    const intersectionLine = LineSegment3d.create(attachmentPointOnText, targetPoint);\n    const closestPointDetail = CurveCurve.intersectionXYZPairs(intersectionLine, false, frameCurve, false);\n    attachmentPoint = closestPointDetail[0]?.detailA.point;\n  }\n  return attachmentPoint;\n}"]}

package/lib/cjs/annotations/TextAnnotationElement.d.ts

@@ -1,9 +1,10 @@
 /** @packageDocumentation
  * @module Elements
  */
-import { TextAnnotation, TextAnnotation2dProps, TextAnnotation3dProps } from "@itwin/core-common";
+import { AnnotationTextStyleProps, Code, CodeProps, CodeScopeProps, EntityReferenceSet, Placement2dProps, Placement3dProps, TextAnnotation, TextAnnotation2dProps, TextAnnotation3dProps, TextAnnotationProps, TextStyleSettings, TextStyleSettingsProps } from "@itwin/core-common";
 import { IModelDb } from "../IModelDb";
-import { AnnotationElement2d, GraphicalElement3d } from "../Element";
+import { AnnotationElement2d, DefinitionElement, GraphicalElement3d, OnElementPropsArg } from "../Element";
+import { Id64String } from "@itwin/core-bentley";
 /** An element that displays textual content within a 2d model.
  * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.
  * @see [[setAnnotation]] to change the textual content.
@@ -12,18 +13,58 @@ import { AnnotationElement2d, GraphicalElement3d } from "../Element";
 export declare class TextAnnotation2d extends AnnotationElement2d {
     /** @internal */
     static get className(): string;
-    protected constructor(props: TextAnnotation2dProps, iModel: IModelDb);
-    static fromJSON(props: TextAnnotation2dProps, iModel: IModelDb): TextAnnotation2d;
-    toJSON(): TextAnnotation2dProps;
+    /** Optional string containing the data associated with the text annotation. */
+    private _textAnnotationData?;
     /** Extract the textual content, if present.
      * @see [[setAnnotation]] to change it.
      */
     getAnnotation(): TextAnnotation | undefined;
-    /** Change the textual content, updating the element's geometry and placement accordingly.
+    /** Change the textual content of the `TextAnnotation2d`.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
      */
     setAnnotation(annotation: TextAnnotation): void;
+    protected constructor(props: TextAnnotation2dProps, iModel: IModelDb);
+    /** Creates a new instance of `TextAnnotation2d` from its JSON representation. */
+    static fromJSON(props: TextAnnotation2dProps, iModel: IModelDb): TextAnnotation2d;
+    /**
+     * Converts the current `TextAnnotation2d` instance to its JSON representation.
+     * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.
+  
+     * @inheritdoc
+     */
+    toJSON(): TextAnnotation2dProps;
+    /** 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.
+     */
+    static create(iModelDb: IModelDb, category: Id64String, model: Id64String, placement: Placement2dProps, textAnnotationData?: TextAnnotationProps, code?: CodeProps): TextAnnotation2d;
+    /**
+     * Updates the geometry of the TextAnnotation2d on insert.
+     * @inheritdoc
+     * @beta
+     */
+    protected static onInsert(arg: OnElementPropsArg): void;
+    /**
+     * Updates the geometry of the TextAnnotation2d on update.
+     * @inheritdoc
+     * @beta
+     */
+    protected static onUpdate(arg: OnElementPropsArg): void;
+    /**
+     * 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.
+     */
+    protected static updateGeometry(iModelDb: IModelDb, props: TextAnnotation2dProps): void;
+    /**
+     * Collects reference IDs used by this `TextAnnotation2d`.
+     * @inheritdoc
+     */
+    protected collectReferenceIds(ids: EntityReferenceSet): void;
 }
 /** An element that displays textual content within a 3d model.
  * The text is stored as a [TextAnnotation]($common) from which the element's [geometry]($docs/learning/common/GeometryStream.md) and [Placement]($common) are computed.
@@ -33,17 +74,114 @@ export declare class TextAnnotation2d extends AnnotationElement2d {
 export declare class TextAnnotation3d extends GraphicalElement3d {
     /** @internal */
     static get className(): string;
-    protected constructor(props: TextAnnotation3dProps, iModel: IModelDb);
-    static fromJSON(props: TextAnnotation3dProps, iModel: IModelDb): TextAnnotation3d;
-    toJSON(): TextAnnotation3dProps;
+    /** Optional string containing the data associated with the text annotation. */
+    private _textAnnotationData?;
     /** Extract the textual content, if present.
      * @see [[setAnnotation]] to change it.
      */
     getAnnotation(): TextAnnotation | undefined;
-    /** Change the textual content, updating the element's geometry and placement accordingly.
+    /** Change the textual content of the `TextAnnotation3d`.
      * @see [[getAnnotation]] to extract the current annotation.
      * @param annotation The new annotation
      */
     setAnnotation(annotation: TextAnnotation): void;
+    protected constructor(props: TextAnnotation3dProps, iModel: IModelDb);
+    /** Creates a new instance of `TextAnnotation3d` from its JSON representation. */
+    static fromJSON(props: TextAnnotation3dProps, iModel: IModelDb): TextAnnotation3d;
+    /**
+     * Converts the current `TextAnnotation3d` instance to its JSON representation.
+     * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.
+     * @inheritdoc
+     */
+    toJSON(): TextAnnotation3dProps;
+    /** 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.
+     */
+    static create(iModelDb: IModelDb, category: Id64String, model: Id64String, placement: Placement3dProps, textAnnotationData?: TextAnnotationProps, code?: CodeProps): TextAnnotation3d;
+    /**
+     * Updates the geometry of the TextAnnotation3d on insert.
+     * @inheritdoc
+     * @beta
+     */
+    protected static onInsert(arg: OnElementPropsArg): void;
+    /**
+     * Updates the geometry of the TextAnnotation3d on update.
+     * @inheritdoc
+     * @beta
+     */
+    protected static onUpdate(arg: OnElementPropsArg): void;
+    /**
+     * 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.
+     */
+    protected static updateGeometry(iModelDb: IModelDb, props: TextAnnotation3dProps): void;
+    /**
+     * Collects reference IDs used by this `TextAnnotation3d`.
+     * @inheritdoc
+     */
+    protected collectReferenceIds(ids: EntityReferenceSet): void;
+}
+/**
+ * The definition element that holds text style information.
+ * The style is stored as a [TextStyleSettings]($common).
+ * @beta
+ */
+export declare class AnnotationTextStyle extends DefinitionElement {
+    /** @internal */
+    static get className(): string;
+    /**
+     * Optional text describing the `AnnotationTextStyle`.
+     */
+    description?: string;
+    /**
+     * The text style settings for the `AnnotationTextStyle`.
+     * @see [[TextStyleSettings]] for more information.
+     */
+    settings: TextStyleSettings;
+    protected constructor(props: AnnotationTextStyleProps, iModel: IModelDb);
+    /**
+     * Creates a Code for an `AnnotationTextStyle` given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     *
+     * @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.
+     */
+    static createCode(iModel: IModelDb, definitionModelId: CodeScopeProps, name: string): Code;
+    /**
+     * 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`.
+     */
+    static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, settings?: TextStyleSettingsProps, description?: string): AnnotationTextStyle;
+    /**
+     * Converts the current `AnnotationTextStyle` instance to its JSON representation.
+     * @inheritdoc
+     */
+    toJSON(): AnnotationTextStyleProps;
+    /** Creates a new instance of `AnnotationTextStyle` from its JSON representation. */
+    static fromJSON(props: AnnotationTextStyleProps, iModel: IModelDb): AnnotationTextStyle;
+    /**
+     * Validates that the AnnotationTextStyle's settings are valid before insert.
+     * @inheritdoc
+     * @beta
+     */
+    protected static onInsert(arg: OnElementPropsArg): void;
+    /**
+     * Validates that the AnnotationTextStyle's settings are valid before update.
+     * @inheritdoc
+     * @beta
+     */
+    protected static onUpdate(arg: OnElementPropsArg): void;
+    private static validateSettings;
+    private static parseTextStyleSettings;
 }
 //# sourceMappingURL=TextAnnotationElement.d.ts.map

package/lib/cjs/annotations/TextAnnotationElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotationElement.d.ts","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationElement.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAiE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAuB,MAAM,oBAAoB,CAAC;AACtL,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAcrE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,gBAAgB;IAChB,WAA2B,SAAS,IAAI,MAAM,CAA+B;IAC7E,SAAS,aAAa,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ;WAEtD,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,GAAG,gBAAgB;IAIxE,MAAM,IAAI,qBAAqB;IAO/C;;OAEG;IACI,aAAa,IAAI,cAAc,GAAG,SAAS;IAKlD;;;OAGG;IACI,aAAa,CAAC,UAAU,EAAE,cAAc;CAGhD;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD,gBAAgB;IAChB,WAA2B,SAAS,IAAI,MAAM,CAA+B;IAC7E,SAAS,aAAa,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ;WAEtD,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,GAAG,gBAAgB;IAIxE,MAAM,IAAI,qBAAqB;IAO/C;;OAEG;IACI,aAAa,IAAI,cAAc,GAAG,SAAS;IAKlD;;;OAGG;IACI,aAAa,CAAC,UAAU,EAAE,cAAc;CAGhD"}
+{"version":3,"file":"TextAnnotationElement.d.ts","sourceRoot":"","sources":["../../../src/annotations/TextAnnotationElement.ts"],"names":[],"mappings":"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"}

package/lib/cjs/annotations/TextAnnotationElement.js

@@ -7,16 +7,28 @@
  * @module Elements
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextAnnotation3d = exports.TextAnnotation2d = void 0;
+exports.AnnotationTextStyle = exports.TextAnnotation3d = exports.TextAnnotation2d = void 0;
 const core_common_1 = require("@itwin/core-common");
 const Element_1 = require("../Element");
 const TextBlockLayout_1 = require("./TextBlockLayout");
 const TextAnnotationGeometry_1 = require("./TextAnnotationGeometry");
-function getElementGeometryBuilderParams(iModel, _placementProps, annotationProps, categoryId, _subCategory) {
+function parseTextAnnotationData(json) {
+    if (!json)
+        return undefined;
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return undefined;
+    }
+}
+function getElementGeometryBuilderParams(iModel, modelId, _placementProps, stringifiedAnnotationProps, categoryId, _subCategory) {
+    const annotationProps = parseTextAnnotationData(stringifiedAnnotationProps);
     const textBlock = core_common_1.TextAnnotation.fromJSON(annotationProps).textBlock;
-    const layout = (0, TextBlockLayout_1.layoutTextBlock)({ iModel, textBlock });
+    const textStyleResolver = new TextBlockLayout_1.TextStyleResolver({ textBlock, iModel, modelId });
+    const layout = (0, TextBlockLayout_1.layoutTextBlock)({ iModel, textBlock, textStyleResolver });
     const builder = new core_common_1.ElementGeometry.Builder();
-    (0, TextAnnotationGeometry_1.appendTextAnnotationGeometry)({ layout, annotationProps, builder, categoryId });
+    (0, TextAnnotationGeometry_1.appendTextAnnotationGeometry)({ layout, textStyleResolver, annotationProps: annotationProps ?? {}, builder, categoryId });
     return { entryArray: builder.entries };
 }
 /** An element that displays textual content within a 2d model.
@@ -27,28 +39,103 @@ function getElementGeometryBuilderParams(iModel, _placementProps, annotationProp
 class TextAnnotation2d extends Element_1.AnnotationElement2d {
     /** @internal */
     static get className() { return "TextAnnotation2d"; }
-    constructor(props, iModel) { super(props, iModel); }
+    /** Optional string containing the data associated with the text annotation. */
+    _textAnnotationData;
+    /** 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;
+    }
+    /** 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;
+    }
+    constructor(props, iModel) {
+        super(props, iModel);
+        this._textAnnotationData = props.textAnnotationData;
+    }
+    /** Creates a new instance of `TextAnnotation2d` from its JSON representation. */
     static fromJSON(props, iModel) {
         return new TextAnnotation2d(props, iModel);
     }
+    /**
+     * 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.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.placement, this.jsonProperties.annotation, this.category);
+        props.textAnnotationData = this._textAnnotationData;
+        if (this._textAnnotationData) {
+            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.placement, this._textAnnotationData, this.category);
+        }
         return props;
     }
-    /** Extract the textual content, if present.
-     * @see [[setAnnotation]] to change it.
+    /** 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.
      */
-    getAnnotation() {
-        const json = this.jsonProperties.annotation;
-        return json ? core_common_1.TextAnnotation.fromJSON(json) : undefined;
+    static create(iModelDb, category, model, placement, textAnnotationData, code) {
+        const props = {
+            classFullName: this.classFullName,
+            textAnnotationData: JSON.stringify(textAnnotationData),
+            placement,
+            model,
+            category,
+            code: code ?? core_common_1.Code.createEmpty(),
+        };
+        return new this(props, iModelDb);
     }
-    /** Change the textual content, updating the element's geometry and placement accordingly.
-     * @see [[getAnnotation]] to extract the current annotation.
-     * @param annotation The new annotation
+    /**
+     * Updates the geometry of the TextAnnotation2d on insert.
+     * @inheritdoc
+     * @beta
      */
-    setAnnotation(annotation) {
-        this.jsonProperties.annotation = annotation.toJSON();
+    static onInsert(arg) {
+        super.onInsert(arg);
+        this.updateGeometry(arg.iModel, arg.props);
+    }
+    /**
+     * Updates the geometry of the TextAnnotation2d on update.
+     * @inheritdoc
+     * @beta
+     */
+    static onUpdate(arg) {
+        super.onUpdate(arg);
+        this.updateGeometry(arg.iModel, arg.props);
+    }
+    /**
+     * 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.
+     */
+    static updateGeometry(iModelDb, props) {
+        if (props.elementGeometryBuilderParams || !props.textAnnotationData) {
+            return;
+        }
+        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(iModelDb, props.model, props.placement ?? core_common_1.Placement2d.fromJSON(), props.textAnnotationData, props.category);
+    }
+    /**
+     * Collects reference IDs used by this `TextAnnotation2d`.
+     * @inheritdoc
+     */
+    collectReferenceIds(ids) {
+        super.collectReferenceIds(ids);
+        const annotation = this.getAnnotation();
+        if (!annotation) {
+            return;
+        }
+        if (annotation.textBlock.styleId)
+            ids.addElement(annotation.textBlock.styleId);
     }
 }
 exports.TextAnnotation2d = TextAnnotation2d;
@@ -60,29 +147,210 @@ exports.TextAnnotation2d = TextAnnotation2d;
 class TextAnnotation3d extends Element_1.GraphicalElement3d {
     /** @internal */
     static get className() { return "TextAnnotation3d"; }
-    constructor(props, iModel) { super(props, iModel); }
+    /** Optional string containing the data associated with the text annotation. */
+    _textAnnotationData;
+    /** 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;
+    }
+    /** 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;
+    }
+    constructor(props, iModel) {
+        super(props, iModel);
+        this._textAnnotationData = props.textAnnotationData;
+    }
+    /** Creates a new instance of `TextAnnotation3d` from its JSON representation. */
     static fromJSON(props, iModel) {
         return new TextAnnotation3d(props, iModel);
     }
+    /**
+     * Converts the current `TextAnnotation3d` instance to its JSON representation.
+     * It also computes the `elementGeometryBuilderParams` property used to create the GeometryStream.
+     * @inheritdoc
+     */
     toJSON() {
         const props = super.toJSON();
-        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.placement, this.jsonProperties.annotation, this.category);
+        props.textAnnotationData = this._textAnnotationData;
+        if (this._textAnnotationData) {
+            props.elementGeometryBuilderParams = getElementGeometryBuilderParams(this.iModel, this.model, this.placement, this._textAnnotationData, this.category);
+        }
         return props;
     }
-    /** Extract the textual content, if present.
-     * @see [[setAnnotation]] to change it.
+    /** 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.
      */
-    getAnnotation() {
-        const json = this.jsonProperties.annotation;
-        return json ? core_common_1.TextAnnotation.fromJSON(json) : undefined;
+    static create(iModelDb, category, model, placement, textAnnotationData, code) {
+        const props = {
+            classFullName: this.classFullName,
+            textAnnotationData: JSON.stringify(textAnnotationData),
+            placement,
+            model,
+            category,
+            code: code ?? core_common_1.Code.createEmpty(),
+        };
+        return new this(props, iModelDb);
     }
-    /** Change the textual content, updating the element's geometry and placement accordingly.
-     * @see [[getAnnotation]] to extract the current annotation.
-     * @param annotation The new annotation
+    /**
+     * Updates the geometry of the TextAnnotation3d on insert.
+     * @inheritdoc
+     * @beta
      */
-    setAnnotation(annotation) {
-        this.jsonProperties.annotation = annotation.toJSON();
+    static onInsert(arg) {
+        super.onInsert(arg);
+        this.updateGeometry(arg.iModel, arg.props);
+    }
+    /**
+     * Updates the geometry of the TextAnnotation3d on update.
+     * @inheritdoc
+     * @beta
+     */
+    static onUpdate(arg) {
+        super.onUpdate(arg);
+        this.updateGeometry(arg.iModel, arg.props);
+    }
+    /**
+     * 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.
+     */
+    static updateGeometry(iModelDb, props) {
+        if (props.elementGeometryBuilderParams || !props.textAnnotationData) {
+            return;
+        }
+        props.elementGeometryBuilderParams = getElementGeometryBuilderParams(iModelDb, props.model, props.placement ?? core_common_1.Placement3d.fromJSON(), props.textAnnotationData, props.category);
+    }
+    /**
+     * Collects reference IDs used by this `TextAnnotation3d`.
+     * @inheritdoc
+     */
+    collectReferenceIds(ids) {
+        super.collectReferenceIds(ids);
+        const annotation = this.getAnnotation();
+        if (!annotation) {
+            return;
+        }
+        if (annotation.textBlock.styleId)
+            ids.addElement(annotation.textBlock.styleId);
     }
 }
 exports.TextAnnotation3d = TextAnnotation3d;
+/**
+ * The definition element that holds text style information.
+ * The style is stored as a [TextStyleSettings]($common).
+ * @beta
+ */
+class AnnotationTextStyle extends Element_1.DefinitionElement {
+    /** @internal */
+    static get className() { return "AnnotationTextStyle"; }
+    /**
+     * Optional text describing the `AnnotationTextStyle`.
+     */
+    description;
+    /**
+     * The text style settings for the `AnnotationTextStyle`.
+     * @see [[TextStyleSettings]] for more information.
+     */
+    settings;
+    constructor(props, iModel) {
+        super(props, iModel);
+        this.description = props.description;
+        const settingsProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);
+        this.settings = core_common_1.TextStyleSettings.fromJSON(settingsProps);
+    }
+    /**
+     * Creates a Code for an `AnnotationTextStyle` given a name that is meant to be unique within the scope of the specified DefinitionModel.
+     *
+     * @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.
+     */
+    static createCode(iModel, definitionModelId, name) {
+        const codeSpec = iModel.codeSpecs.getByName(core_common_1.BisCodeSpec.annotationTextStyle);
+        return new core_common_1.Code({ spec: codeSpec.id, scope: definitionModelId, value: name });
+    }
+    /**
+     * 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`.
+     */
+    static create(iModelDb, definitionModelId, name, settings, description) {
+        const props = {
+            classFullName: this.classFullName,
+            model: definitionModelId,
+            code: this.createCode(iModelDb, definitionModelId, name).toJSON(),
+            description,
+            settings: JSON.stringify(settings),
+        };
+        return new this(props, iModelDb);
+    }
+    /**
+     * Converts the current `AnnotationTextStyle` instance to its JSON representation.
+     * @inheritdoc
+     */
+    toJSON() {
+        const props = super.toJSON();
+        props.description = this.description;
+        props.settings = JSON.stringify(this.settings.toJSON());
+        return props;
+    }
+    /** Creates a new instance of `AnnotationTextStyle` from its JSON representation. */
+    static fromJSON(props, iModel) {
+        return new AnnotationTextStyle(props, iModel);
+    }
+    /**
+     * Validates that the AnnotationTextStyle's settings are valid before insert.
+     * @inheritdoc
+     * @beta
+     */
+    static onInsert(arg) {
+        super.onInsert(arg);
+        this.validateSettings(arg.props);
+    }
+    /**
+     * Validates that the AnnotationTextStyle's settings are valid before update.
+     * @inheritdoc
+     * @beta
+     */
+    static onUpdate(arg) {
+        super.onUpdate(arg);
+        this.validateSettings(arg.props);
+    }
+    static validateSettings(props) {
+        const settingProps = AnnotationTextStyle.parseTextStyleSettings(props.settings);
+        if (!settingProps)
+            return;
+        const settings = core_common_1.TextStyleSettings.fromJSON(settingProps);
+        const errors = settings.getValidationErrors();
+        if (errors.length > 0) {
+            throw new Error(`Invalid AnnotationTextStyle settings: ${errors.join(", ")}`);
+        }
+    }
+    static parseTextStyleSettings(json) {
+        if (!json)
+            return undefined;
+        try {
+            return JSON.parse(json);
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+exports.AnnotationTextStyle = AnnotationTextStyle;
 //# sourceMappingURL=TextAnnotationElement.js.map