@itwin/core-backend 5.2.0-dev.8 → 5.3.0-dev.1

package/lib/esm/internal/annotations/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../src/internal/annotations/fields.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\nimport { ECSqlValueType, FieldRun, RelationshipProps, TextBlock } from \"@itwin/core-common\";\nimport { IModelDb } from \"../../IModelDb\";\nimport { assert, DbResult, expectDefined, Id64String, Logger } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../../BackendLoggerCategory\";\nimport { XAndY, XYAndZ } from \"@itwin/core-geometry\";\nimport { isITextAnnotation } from \"../../annotations/ElementDrivesTextAnnotation\";\nimport { AnyClass, EntityClass, Property, StructArrayProperty } from \"@itwin/ecschema-metadata\";\n\n// A FieldPropertyPath must ultimately resolve to one of these primitive types.\nexport type FieldPrimitiveValue = boolean | number | string | Date | XAndY | XYAndZ | Uint8Array;\n\ninterface FieldStructValue { [key: string]: any }\n\n// An intermediate value obtained while evaluating a FieldPropertyPath.\ntype FieldValue = {\n  primitive: FieldPrimitiveValue;\n  struct?: never;\n  primitiveArray?: never;\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct: FieldStructValue;\n  primitiveArray?: never;\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct?: never;\n  primitiveArray: FieldPrimitiveValue[];\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct?: never;\n  primitiveArray?: never;\n  structArray: FieldStructValue[];\n}\n\n// Metadata associated with a FieldProperty, providing info needed for formatting like kind-of-quantity, extended type, etc.\n// That information can be obtained from the EC Property. For JSON fields, we will need to allow the user to specify it explicitly\n// (TBD because formatting is not yet implemented).\nexport interface FieldPropertyMetadata {\n  readonly property: Property;\n  // ###TODO probably want to know if it's a JSON property.\n}\n\n// The resolved primitive value of a field with metadata.\nexport interface FieldProperty {\n  value: FieldPrimitiveValue;\n  metadata: FieldPropertyMetadata;\n}\n\nexport interface UpdateFieldsContext {\n  readonly hostElementId: Id64String;\n\n  getProperty(field: FieldRun): FieldProperty | undefined\n}\n\n// Resolve the raw primitive value of the property that a field points to.\nfunction getFieldProperty(field: FieldRun, iModel: IModelDb): FieldProperty | undefined {\n  const host = field.propertyHost;\n  const schemaItem = iModel.schemaContext.getSchemaItemSync(host.schemaName, host.className);\n  if (!EntityClass.isEntityClass(schemaItem)) {\n    return undefined;\n  }\n\n  let ecClass: AnyClass = schemaItem;\n  const { propertyName, accessors } = field.propertyPath;\n  let ecProp = ecClass.getPropertySync(propertyName);\n  if (!ecProp) {\n    return undefined;\n  }\n\n  const isAspect = ecClass.isSync(\"ElementAspect\", \"BisCore\");\n  const where = ` WHERE ${isAspect ? \"Element.Id\" : \"ECInstanceId\"}=${host.elementId}`;\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  let curValue: FieldValue | undefined = iModel.withPreparedStatement(`SELECT ${propertyName} FROM ${host.schemaName}.${host.className} ${where}`, (stmt) => {\n    if (stmt.step() !== DbResult.BE_SQLITE_ROW) {\n      return undefined;\n    }\n\n    const rootValue = stmt.getValue(0);\n    if (undefined === rootValue || rootValue.isNull) {\n      return undefined;\n    }\n\n    switch (rootValue.columnInfo.getType()) {\n      case ECSqlValueType.Blob:\n        return { primitive: rootValue.getBlob() };\n      case ECSqlValueType.Boolean:\n        return { primitive: rootValue.getBoolean() };\n      case ECSqlValueType.DateTime:\n        return { primitive: rootValue.getDateTime() };\n      case ECSqlValueType.Double:\n        return { primitive: rootValue.getDouble() };\n      case ECSqlValueType.Guid:\n        return { primitive: rootValue.getGuid() };\n      case ECSqlValueType.Int:\n      case ECSqlValueType.Int64:\n        return { primitive: rootValue.getInteger() };\n      case ECSqlValueType.Point2d:\n        return { primitive: rootValue.getXAndY() };\n      case ECSqlValueType.Point3d:\n        return { primitive: rootValue.getXYAndZ() };\n      case ECSqlValueType.String:\n        return { primitive: rootValue.getString() };\n      case ECSqlValueType.Struct: {\n        ecProp = expectDefined(ecProp);\n        assert(ecProp.isStruct());\n        ecClass = ecProp.structClass;\n        return { struct: rootValue.getStruct() };\n      }\n      case ECSqlValueType.PrimitiveArray: {\n        return { primitiveArray: rootValue.getArray() };\n      }\n      case ECSqlValueType.StructArray: {\n        return { structArray: rootValue.getArray() };\n      }\n      // Unsupported:\n      // case ECSqlValueType.Geometry:\n      // case ECSqlValueType.Navigation:\n      // case ECSqlValueType.Id:\n    }\n\n    return undefined;\n  });\n\n  if (undefined === curValue) {\n    return undefined;\n  }\n\n  if (accessors) {\n    for (const accessor of accessors) {\n      if (undefined !== curValue.primitive) {\n        // Can't index into a primitive.\n        return undefined;\n      }\n\n      if (typeof accessor === \"number\") {\n        const array: FieldPrimitiveValue[] | FieldStructValue[] | undefined = curValue.primitiveArray ?? curValue.structArray;\n        if (!array) {\n          return undefined;\n        }\n\n        const index: number = accessor < 0 ? (array.length + accessor) : accessor;\n        const item: FieldPrimitiveValue | FieldStructValue = array[index];\n        if (undefined === item) {\n          return undefined;\n        } else if (curValue.primitiveArray) {\n          curValue = { primitive: curValue.primitiveArray[index] };\n        } else {\n          assert(undefined !== curValue.structArray);\n          assert(ecProp instanceof StructArrayProperty);\n\n          ecClass = ecProp.structClass;\n          curValue = { struct: curValue.structArray[index] };\n        }\n      } else {\n        if (undefined === curValue.struct) {\n          return undefined;\n        }\n\n        const item: any = curValue.struct[accessor];\n        if (undefined === item) {\n          return undefined;\n        }\n\n        ecProp = ecClass.getPropertySync(accessor);\n        if (!ecProp) {\n          return undefined;\n        }\n\n        if (ecProp.isArray()) {\n          curValue = ecProp.isStruct() ? { structArray: item } : { primitiveArray: item };\n        } else if (ecProp.isStruct()) {\n          ecClass = ecProp.structClass;\n          curValue = { struct: item };\n        } else if (ecProp.isPrimitive()) {\n          curValue = { primitive: item };\n        } else {\n          return undefined;\n        }\n      }\n    }\n  }\n\n  if (field.propertyPath.jsonAccessors) {\n    if (!ecProp.isPrimitive() || ecProp.isArray() || ecProp.extendedTypeName !== \"Json\" || typeof curValue.primitive !== \"string\") {\n      return undefined;\n    }\n\n    let json = JSON.parse(curValue.primitive);\n    for (const accessor of field.propertyPath.jsonAccessors) {\n      if (typeof accessor === \"number\") {\n        if (!Array.isArray(json)) {\n          return undefined;\n        }\n\n        json = json[accessor < 0 ? json.length + accessor : accessor];\n      } else {\n        if (typeof json !== \"object\" || json === null) {\n          return undefined;\n        }\n\n        json = json[accessor];\n      }\n    }\n\n    switch (typeof json) {\n      case \"string\":\n      case \"number\":\n      case \"boolean\":\n        curValue = { primitive: json };\n        break;\n      default:\n        return undefined;\n    }\n  }\n\n  // The ultimate result must be a primitive value.\n  if (undefined === curValue.primitive) {\n    return undefined;\n  }\n\n  return {\n    value: curValue.primitive,\n    metadata: { property: ecProp },\n  };\n}\n\nexport function createUpdateContext(hostElementId: string, iModel: IModelDb, deleted: boolean): UpdateFieldsContext {\n  return {\n    hostElementId,\n    getProperty: deleted ? () => undefined : (field) => getFieldProperty(field, iModel),\n  };\n}\n\n// Recompute the display value of a single field, return false if it couldn't be evaluated.\nexport function updateField(field: FieldRun, context: UpdateFieldsContext): boolean {\n  if (context.hostElementId !== field.propertyHost.elementId) {\n    return false;\n  }\n\n  let newContent: string | undefined;\n  try {\n    const prop = context.getProperty(field);\n    if (undefined !== prop) {\n      // ###TODO formatting etc.\n      // eslint-disable-next-line @typescript-eslint/no-base-to-string\n      newContent = prop.value.toString();\n    }\n  } catch (err) {\n    Logger.logException(BackendLoggerCategory.IModelDb, err);\n  }\n\n  newContent = newContent ?? FieldRun.invalidContentIndicator;\n  if (newContent === field.cachedContent) {\n    return false;\n  }\n\n  field.setCachedContent(newContent);\n  return true;\n}\n\n// Re-evaluates the display strings for all fields that target the element specified by `context` and returns the number\n// of fields whose display strings changed as a result.\nexport function updateFields(textBlock: TextBlock, context: UpdateFieldsContext): number {\n  let numUpdated = 0;\n  for (const paragraph of textBlock.paragraphs) {\n    for (const run of paragraph.runs) {\n      if (run.type === \"field\" && updateField(run, context)) {\n        ++numUpdated;\n      }\n    }\n  }\n\n  return numUpdated;\n}\n\n// Invoked by ElementDrivesTextAnnotation to update fields in target element when source element changes or is deleted.\nexport function updateElementFields(props: RelationshipProps, iModel: IModelDb, deleted: boolean): void {\n  try {\n    const target = iModel.elements.getElement(props.targetId);\n    if (isITextAnnotation(target)) {\n      const context = createUpdateContext(props.sourceId, iModel, deleted);\n      const updatedBlocks = [];\n      for (const block of target.getTextBlocks()) {\n        if (updateFields(block.textBlock, context)) {\n          updatedBlocks.push(block);\n        }\n      }\n\n      if (updatedBlocks.length > 0) {\n        target.updateTextBlocks(updatedBlocks);\n      }\n    }\n  } catch (err) {\n    Logger.logException(BackendLoggerCategory.IModelDb, err);\n  }\n}\n\n"]}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../src/internal/annotations/fields.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\nimport { ECSqlValueType, FieldPrimitiveValue, FieldPropertyType, FieldRun, FieldValue, formatFieldValue, RelationshipProps, TextBlock, traverseTextBlockComponent } from \"@itwin/core-common\";\nimport { IModelDb } from \"../../IModelDb\";\nimport { assert, DbResult, expectDefined, Id64String, Logger } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../../BackendLoggerCategory\";\nimport { isITextAnnotation } from \"../../annotations/ElementDrivesTextAnnotation\";\nimport { AnyClass, EntityClass, PrimitiveType, Property, PropertyType, StructArrayProperty } from \"@itwin/ecschema-metadata\";\n\ninterface FieldStructValue { [key: string]: any }\n\n// An intermediate value obtained while evaluating a FieldPropertyPath.\ntype FieldValueType = {\n  primitive: FieldPrimitiveValue;\n  struct?: never;\n  primitiveArray?: never;\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct: FieldStructValue;\n  primitiveArray?: never;\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct?: never;\n  primitiveArray: FieldPrimitiveValue[];\n  structArray?: never;\n} | {\n  primitive?: never;\n  struct?: never;\n  primitiveArray?: never;\n  structArray: FieldStructValue[];\n}\n\nexport interface UpdateFieldsContext {\n  readonly hostElementId: Id64String;\n\n  getProperty(field: FieldRun): FieldValue | undefined\n}\n\n// Resolve the raw primitive value of the property that a field points to.\nfunction getFieldPropertyValue(field: FieldRun, iModel: IModelDb): FieldValue | undefined {\n  const host = field.propertyHost;\n  const schemaItem = iModel.schemaContext.getSchemaItemSync(host.schemaName, host.className);\n  if (!EntityClass.isEntityClass(schemaItem)) {\n    return undefined;\n  }\n\n  let ecClass: AnyClass = schemaItem;\n  const { propertyName, accessors } = field.propertyPath;\n  let ecProp = ecClass.getPropertySync(propertyName);\n  if (!ecProp) {\n    return undefined;\n  }\n\n  const isAspect = ecClass.isSync(\"ElementAspect\", \"BisCore\");\n  const where = ` WHERE ${isAspect ? \"Element.Id\" : \"ECInstanceId\"}=${host.elementId}`;\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  let curValue: FieldValueType | undefined = iModel.withPreparedStatement(`SELECT ${propertyName} FROM ${host.schemaName}.${host.className} ${where}`, (stmt) => {\n    if (stmt.step() !== DbResult.BE_SQLITE_ROW) {\n      return undefined;\n    }\n\n    const rootValue = stmt.getValue(0);\n    if (undefined === rootValue || rootValue.isNull) {\n      return undefined;\n    }\n\n    switch (rootValue.columnInfo.getType()) {\n      case ECSqlValueType.Blob:\n        return { primitive: rootValue.getBlob() };\n      case ECSqlValueType.Boolean:\n        return { primitive: rootValue.getBoolean() };\n      case ECSqlValueType.DateTime:\n        return { primitive: new Date(rootValue.getDateTime()) };\n      case ECSqlValueType.Double:\n        return { primitive: rootValue.getDouble() };\n      case ECSqlValueType.Guid:\n        return { primitive: rootValue.getGuid() };\n      case ECSqlValueType.Int:\n      case ECSqlValueType.Int64:\n        return { primitive: rootValue.getInteger() };\n      case ECSqlValueType.Point2d:\n        return { primitive: rootValue.getXAndY() };\n      case ECSqlValueType.Point3d:\n        return { primitive: rootValue.getXYAndZ() };\n      case ECSqlValueType.String:\n        return { primitive: rootValue.getString() };\n      case ECSqlValueType.Struct: {\n        ecProp = expectDefined(ecProp);\n        assert(ecProp.isStruct());\n        ecClass = ecProp.structClass;\n        return { struct: rootValue.getStruct() };\n      }\n      case ECSqlValueType.PrimitiveArray: {\n        return { primitiveArray: rootValue.getArray() };\n      }\n      case ECSqlValueType.StructArray: {\n        return { structArray: rootValue.getArray() };\n      }\n      // Unsupported:\n      // case ECSqlValueType.Geometry:\n      // case ECSqlValueType.Navigation:\n      // case ECSqlValueType.Id:\n    }\n\n    return undefined;\n  });\n\n  if (undefined === curValue) {\n    return undefined;\n  }\n\n  if (accessors) {\n    for (const accessor of accessors) {\n      if (undefined !== curValue.primitive) {\n        // Can't index into a primitive.\n        return undefined;\n      }\n\n      if (typeof accessor === \"number\") {\n        const array: FieldPrimitiveValue[] | FieldStructValue[] | undefined = curValue.primitiveArray ?? curValue.structArray;\n        if (!array) {\n          return undefined;\n        }\n\n        const index: number = accessor < 0 ? (array.length + accessor) : accessor;\n        const item: FieldPrimitiveValue | FieldStructValue = array[index];\n        if (undefined === item) {\n          return undefined;\n        } else if (curValue.primitiveArray) {\n          curValue = { primitive: curValue.primitiveArray[index] };\n        } else {\n          assert(undefined !== curValue.structArray);\n          assert(ecProp instanceof StructArrayProperty);\n\n          ecClass = ecProp.structClass;\n          curValue = { struct: curValue.structArray[index] };\n        }\n      } else {\n        if (undefined === curValue.struct) {\n          return undefined;\n        }\n\n        const item: any = curValue.struct[accessor];\n        if (undefined === item) {\n          return undefined;\n        }\n\n        ecProp = ecClass.getPropertySync(accessor);\n        if (!ecProp) {\n          return undefined;\n        }\n\n        if (ecProp.isArray()) {\n          curValue = ecProp.isStruct() ? { structArray: item } : { primitiveArray: item };\n        } else if (ecProp.isStruct()) {\n          ecClass = ecProp.structClass;\n          curValue = { struct: item };\n        } else if (ecProp.isPrimitive()) {\n          curValue = { primitive: item };\n        } else {\n          return undefined;\n        }\n      }\n    }\n  }\n\n  const propertyType = determineFieldPropertyType(ecProp);\n  if(!propertyType) {\n    return undefined;\n  }\n\n  // The ultimate result must be a primitive value.\n  if (undefined === curValue.primitive) {\n    return undefined;\n  }\n\n  return { value: curValue.primitive, type: propertyType };\n}\n\nfunction determineFieldPropertyType(prop: Property): FieldPropertyType | undefined {\n  if (prop.isEnumeration()) {\n    switch (prop.propertyType) {\n      case PropertyType.Integer_Enumeration:\n        return \"int-enum\";\n      case PropertyType.String_Enumeration:\n        return \"string-enum\";\n      default:\n        return undefined;\n    }\n  }\n\n  if (prop.isPrimitive()) {\n    switch (prop.primitiveType) {\n      case PrimitiveType.Boolean:\n        return \"boolean\";\n      case PrimitiveType.String:\n        return prop.extendedTypeName === \"DateTime\" ? \"datetime\" : \"string\";\n      case PrimitiveType.DateTime:\n        return \"datetime\";\n      case PrimitiveType.Double:\n      case PrimitiveType.Long:\n        return \"quantity\";\n      case PrimitiveType.Point2d:\n      case PrimitiveType.Point3d:\n        return \"coordinate\";\n      case PrimitiveType.Binary:\n        return prop.extendedTypeName === \"BeGuid\" ? \"string\" : undefined;\n      case PrimitiveType.Integer:\n      case PrimitiveType.Long:\n        return \"string\";\n      default:\n        return undefined;\n    }\n  }\n\n  return undefined;\n}\n\nexport function createUpdateContext(hostElementId: string, iModel: IModelDb, deleted: boolean): UpdateFieldsContext {\n  return {\n    hostElementId,\n    getProperty: deleted ? () => undefined : (field) => getFieldPropertyValue(field, iModel),\n  };\n}\n\n// Recompute the display value of a single field, return false if it couldn't be evaluated.\nexport function updateField(field: FieldRun, context: UpdateFieldsContext): boolean {\n  if (context.hostElementId !== field.propertyHost.elementId) {\n    return false;\n  }\n\n  let newContent: string | undefined;\n  try {\n    const propValue = context.getProperty(field);\n    if (undefined !== propValue) {\n      newContent = formatFieldValue(propValue, field.formatOptions);\n    }\n  } catch (err) {\n    Logger.logException(BackendLoggerCategory.IModelDb, err);\n  }\n\n  newContent = newContent ?? FieldRun.invalidContentIndicator;\n  if (newContent === field.cachedContent) {\n    return false;\n  }\n\n  field.setCachedContent(newContent);\n  return true;\n}\n\n// Re-evaluates the display strings for all fields that target the element specified by `context` and returns the number\n// of fields whose display strings changed as a result.\nexport function updateFields(textBlock: TextBlock, context: UpdateFieldsContext): number {\n  let numUpdated = 0;\n  for (const { child } of traverseTextBlockComponent(textBlock)) {\n    if (child.type === \"field\" && updateField(child, context)) {\n      ++numUpdated;\n    }\n  }\n\n  return numUpdated;\n}\n\n// Invoked by ElementDrivesTextAnnotation to update fields in target element when source element changes or is deleted.\nexport function updateElementFields(props: RelationshipProps, iModel: IModelDb, deleted: boolean): void {\n  try {\n    const target = iModel.elements.getElement(props.targetId);\n    if (isITextAnnotation(target)) {\n      const context = createUpdateContext(props.sourceId, iModel, deleted);\n      const updatedBlocks = [];\n      for (const block of target.getTextBlocks()) {\n        if (updateFields(block.textBlock, context)) {\n          updatedBlocks.push(block);\n        }\n      }\n\n      if (updatedBlocks.length > 0) {\n        target.updateTextBlocks(updatedBlocks);\n      }\n    }\n  } catch (err) {\n    Logger.logException(BackendLoggerCategory.IModelDb, err);\n  }\n}\n\n"]}

package/lib/esm/test/AnnotationTestUtils.d.ts

@@ -1,15 +1,19 @@
-import { ElementGeometry, GeometryParams, TextBlock } from "@itwin/core-common";
+import { ElementGeometry, GeometryParams, TextBlock, TextString } from "@itwin/core-common";
 import { AnyCurvePrimitive } from "@itwin/core-geometry";
 import { ComputeRangesForTextLayoutArgs, FindFontId, FindTextStyle, TextBlockLayout, TextLayoutRanges } from "../core-backend";
+import { Id64String } from "@itwin/core-bentley";
 export declare function computeTextRangeAsStringLength(args: ComputeRangesForTextLayoutArgs): TextLayoutRanges;
 export declare function doLayout(textBlock: TextBlock, args?: {
+    textStyleId?: Id64String;
     findTextStyle?: FindTextStyle;
     findFontId?: FindFontId;
 }): TextBlockLayout;
 export declare class MockBuilder extends ElementGeometry.Builder {
     params: GeometryParams[];
     geometries: AnyCurvePrimitive[];
+    textStrings: TextString[];
     appendGeometryParamsChange(params: GeometryParams): boolean;
     appendGeometryQuery(geometry: AnyCurvePrimitive): boolean;
+    appendTextString(text: TextString): boolean;
 }
 //# sourceMappingURL=AnnotationTestUtils.d.ts.map

package/lib/esm/test/AnnotationTestUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnnotationTestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/AnnotationTestUtils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAW,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,8BAA8B,EAAE,UAAU,EAAE,aAAa,EAAmB,eAAe,EAAE,gBAAgB,EAAqB,MAAM,iBAAiB,CAAC;AAGnK,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,8BAA8B,GAAG,gBAAgB,CAGrG;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;IACpD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,GAAG,eAAe,CAgBlB;AAGD,qBAAa,WAAY,SAAQ,eAAe,CAAC,OAAO;IAC/C,MAAM,EAAE,cAAc,EAAE,CAAM;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAM;IAC5B,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAI3D,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;CAI1E"}
+{"version":3,"file":"AnnotationTestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/AnnotationTestUtils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAqB,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAW,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,8BAA8B,EAAE,UAAU,EAAE,aAAa,EAAmB,eAAe,EAAE,gBAAgB,EAAqB,MAAM,iBAAiB,CAAC;AACnK,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,8BAA8B,GAAG,gBAAgB,CAGrG;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;IACpD,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,GAAG,eAAe,CAgBlB;AAGD,qBAAa,WAAY,SAAQ,eAAe,CAAC,OAAO;IAC/C,MAAM,EAAE,cAAc,EAAE,CAAM;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAM;IACrC,WAAW,EAAE,UAAU,EAAE,CAAK;IAErB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO;IAI3D,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAKzD,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;CAK5D"}

package/lib/esm/test/AnnotationTestUtils.js

@@ -12,8 +12,8 @@ export function computeTextRangeAsStringLength(args) {
 export function doLayout(textBlock, args) {
     const textStyleResolver = new TextStyleResolver({
         textBlock,
+        textStyleId: args?.textStyleId ?? "",
         iModel: {},
-        modelId: undefined,
         findTextStyle: args?.findTextStyle ?? (() => TextStyleSettings.defaults)
     });
     const layout = layoutTextBlock({
@@ -29,6 +29,7 @@ export function doLayout(textBlock, args) {
 export class MockBuilder extends ElementGeometry.Builder {
     params = [];
     geometries = [];
+    textStrings = [];
     appendGeometryParamsChange(params) {
         this.params.push(params.clone());
         return super.appendGeometryParamsChange(params);
@@ -37,5 +38,9 @@ export class MockBuilder extends ElementGeometry.Builder {
         this.geometries.push(geometry);
         return super.appendGeometryQuery(geometry);
     }
+    appendTextString(text) {
+        this.textStrings.push(text);
+        return super.appendTextString(text);
+    }
 }
 //# sourceMappingURL=AnnotationTestUtils.js.map

package/lib/esm/test/AnnotationTestUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"AnnotationTestUtils.js","sourceRoot":"","sources":["../../../src/test/AnnotationTestUtils.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,eAAe,EAA6B,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAqB,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAA6D,eAAe,EAAqC,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGnK,MAAM,UAAU,8BAA8B,CAAC,IAAoC;IACjF,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,SAAoB,EAAE,IAG9C;IACC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;QAC9C,SAAS;QACT,MAAM,EAAE,EAAS;QACjB,OAAO,EAAE,SAAS;QAClB,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;KACzE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,SAAS;QACT,MAAM,EAAE,EAAS;QACjB,iBAAiB;QACjB,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzC,gBAAgB,EAAE,8BAA8B;KACjD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wFAAwF;AACxF,MAAM,OAAO,WAAY,SAAQ,eAAe,CAAC,OAAO;IAC/C,MAAM,GAAqB,EAAE,CAAC;IAC9B,UAAU,GAAwB,EAAE,CAAC;IAC5B,0BAA0B,CAAC,MAAsB;QAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACe,mBAAmB,CAAC,QAA2B;QAC7D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF","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\nimport { ElementGeometry, GeometryParams, TextBlock, TextStyleSettings } from \"@itwin/core-common\";\nimport { AnyCurvePrimitive, Range2d } from \"@itwin/core-geometry\";\nimport { ComputeRangesForTextLayoutArgs, FindFontId, FindTextStyle, layoutTextBlock, TextBlockLayout, TextLayoutRanges, TextStyleResolver } from \"../core-backend\";\n\n\nexport function computeTextRangeAsStringLength(args: ComputeRangesForTextLayoutArgs): TextLayoutRanges {\n  const range = new Range2d(0, 0, args.chars.length, args.lineHeight);\n  return { layout: range, justification: range };\n}\n\nexport function doLayout(textBlock: TextBlock, args?: {\n  findTextStyle?: FindTextStyle;\n  findFontId?: FindFontId;\n}): TextBlockLayout {\n  const textStyleResolver = new TextStyleResolver({\n    textBlock,\n    iModel: {} as any,\n    modelId: undefined,\n    findTextStyle: args?.findTextStyle ?? (() => TextStyleSettings.defaults)\n  });\n  const layout = layoutTextBlock({\n    textBlock,\n    iModel: {} as any,\n    textStyleResolver,\n    findFontId: args?.findFontId ?? (() => 0),\n    computeTextRange: computeTextRangeAsStringLength,\n  });\n\n  return layout;\n}\n\n// Extending this because the ElementGeometry.Builder.entries attribute is hard to parse\nexport class MockBuilder extends ElementGeometry.Builder {\n  public params: GeometryParams[] = [];\n  public geometries: AnyCurvePrimitive[] = [];\n  public override appendGeometryParamsChange(params: GeometryParams): boolean {\n    this.params.push(params.clone());\n    return super.appendGeometryParamsChange(params);\n  }\n  public override appendGeometryQuery(geometry: AnyCurvePrimitive): boolean {\n    this.geometries.push(geometry);\n    return super.appendGeometryQuery(geometry);\n  }\n}"]}
+{"version":3,"file":"AnnotationTestUtils.js","sourceRoot":"","sources":["../../../src/test/AnnotationTestUtils.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,OAAO,EAAE,eAAe,EAAyC,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAqB,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAA6D,eAAe,EAAqC,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAInK,MAAM,UAAU,8BAA8B,CAAC,IAAoC;IACjF,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,SAAoB,EAAE,IAI9C;IACC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC;QAC9C,SAAS;QACT,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE;QACpC,MAAM,EAAE,EAAS;QACjB,aAAa,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;KACzE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,SAAS;QACT,MAAM,EAAE,EAAS;QACjB,iBAAiB;QACjB,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzC,gBAAgB,EAAE,8BAA8B;KACjD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wFAAwF;AACxF,MAAM,OAAO,WAAY,SAAQ,eAAe,CAAC,OAAO;IAC/C,MAAM,GAAqB,EAAE,CAAC;IAC9B,UAAU,GAAwB,EAAE,CAAC;IACrC,WAAW,GAAiB,EAAE,CAAA;IAErB,0BAA0B,CAAC,MAAsB;QAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACe,mBAAmB,CAAC,QAA2B;QAC7D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAEe,gBAAgB,CAAC,IAAgB;QAC/C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;CAEF","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\nimport { ElementGeometry, GeometryParams, TextBlock, TextString, TextStyleSettings } from \"@itwin/core-common\";\nimport { AnyCurvePrimitive, Range2d } from \"@itwin/core-geometry\";\nimport { ComputeRangesForTextLayoutArgs, FindFontId, FindTextStyle, layoutTextBlock, TextBlockLayout, TextLayoutRanges, TextStyleResolver } from \"../core-backend\";\nimport { Id64String } from \"@itwin/core-bentley\";\n\n\nexport function computeTextRangeAsStringLength(args: ComputeRangesForTextLayoutArgs): TextLayoutRanges {\n  const range = new Range2d(0, 0, args.chars.length, args.lineHeight);\n  return { layout: range, justification: range };\n}\n\nexport function doLayout(textBlock: TextBlock, args?: {\n  textStyleId?: Id64String,\n  findTextStyle?: FindTextStyle;\n  findFontId?: FindFontId;\n}): TextBlockLayout {\n  const textStyleResolver = new TextStyleResolver({\n    textBlock,\n    textStyleId: args?.textStyleId ?? \"\",\n    iModel: {} as any,\n    findTextStyle: args?.findTextStyle ?? (() => TextStyleSettings.defaults)\n  });\n  const layout = layoutTextBlock({\n    textBlock,\n    iModel: {} as any,\n    textStyleResolver,\n    findFontId: args?.findFontId ?? (() => 0),\n    computeTextRange: computeTextRangeAsStringLength,\n  });\n\n  return layout;\n}\n\n// Extending this because the ElementGeometry.Builder.entries attribute is hard to parse\nexport class MockBuilder extends ElementGeometry.Builder {\n  public params: GeometryParams[] = [];\n  public geometries: AnyCurvePrimitive[] = [];\n  public textStrings: TextString[] = []\n\n  public override appendGeometryParamsChange(params: GeometryParams): boolean {\n    this.params.push(params.clone());\n    return super.appendGeometryParamsChange(params);\n  }\n  public override appendGeometryQuery(geometry: AnyCurvePrimitive): boolean {\n    this.geometries.push(geometry);\n    return super.appendGeometryQuery(geometry);\n  }\n\n  public override appendTextString(text: TextString): boolean {\n    this.textStrings.push(text);\n    return super.appendTextString(text);\n  }\n\n}"]}

package/lib/esm/test/annotations/Fields.test.js

@@ -7,14 +7,20 @@ import { Code, FieldRun, SubCategoryAppearance, TextAnnotation, TextBlock, TextR
 import { StandaloneDb } from "../../IModelDb";
 import { IModelTestUtils } from "../IModelTestUtils";
 import { createUpdateContext, updateField, updateFields } from "../../internal/annotations/fields";
-import { DbResult, Id64 } from "@itwin/core-bentley";
+import { DbResult, Id64, ProcessDetector } from "@itwin/core-bentley";
 import { SpatialCategory } from "../../Category";
 import { Point3d, YawPitchRollAngles } from "@itwin/core-geometry";
 import { Schema, Schemas } from "../../Schema";
 import { ClassRegistry } from "../../ClassRegistry";
 import { PhysicalElement } from "../../Element";
 import { ElementOwnsUniqueAspect, ElementUniqueAspect, FontFile, TextAnnotation3d } from "../../core-backend";
-import { ElementDrivesTextAnnotation } from "../../annotations/ElementDrivesTextAnnotation";
+import { ElementDrivesTextAnnotation, TextAnnotationUsesTextStyleByDefault } from "../../annotations/ElementDrivesTextAnnotation";
+function isIntlSupported() {
+    // Node in the mobile add-on does not include Intl, so this test fails. Right now, mobile
+    // users are not expected to do any editing, but long term we will attempt to find a better
+    // solution.
+    return !ProcessDetector.isMobileAppBackend;
+}
 describe("updateField", () => {
     const mockElementId = "0x1";
     const mockPath = {
@@ -31,7 +37,7 @@ describe("updateField", () => {
                 propertyPath.accessors?.[0] === 0 &&
                 propertyPath.accessors?.[1] === "nestedProperty" &&
                 propertyValue !== undefined) {
-                return { value: propertyValue, metadata: {} };
+                return { value: propertyValue, type: "string" };
             }
             return undefined;
         },
@@ -102,6 +108,11 @@ const fieldsSchemaXml = `
 <ECSchema schemaName="Fields" alias="ts" version="01.00.00" xmlns="http://www.bentley.com/schemas/Bentley.ECXML.3.2">
   <ECSchemaReference name="BisCore" version="01.00.04" alias="bis"/>
 
+  <ECEnumeration typeName="IntEnum" backingTypeName="int">
+    <ECEnumerator name="one" displayLabel="One" value="1" />
+    <ECEnumerator name="two" displayLabel="Two" value="2"/>
+  </ECEnumeration>
+
   <ECStructClass typeName="InnerStruct" modifier="None">
     <ECProperty propertyName="bool" typeName="boolean"/>
     <ECArrayProperty propertyName="doubles" typeName="double" minOccurs="0" maxOccurs="unbounded"/>
@@ -117,9 +128,11 @@ const fieldsSchemaXml = `
     <ECProperty propertyName="intProp" typeName="int"/>
     <ECProperty propertyName="point" typeName="point3d"/>
     <ECProperty propertyName="maybeNull" typeName="int"/>
+    <ECProperty propertyName="datetime" typeName="dateTime"/>
     <ECArrayProperty propertyName="strings" typeName="string" minOccurs="0" maxOccurs="unbounded"/>
     <ECStructProperty propertyName="outerStruct" typeName="OuterStruct"/>
     <ECStructArrayProperty propertyName="outerStructs" typeName="OuterStruct" minOccurs="0" maxOccurs="unbounded"/>
+    <ECProperty propertyName="intEnum" typeName="IntEnum"/>
   </ECEntityClass>
 
   <ECEntityClass typeName="TestAspect" modifier="None">
@@ -174,6 +187,8 @@ describe("Field evaluation", () => {
             intProp: 100,
             point: { x: 1, y: 2, z: 3 },
             strings: ["a", "b", `"name": "c"`],
+            datetime: new Date("2025-08-28T13:45:30.123Z"),
+            intEnum: 1,
             outerStruct: {
                 innerStruct: { bool: false, doubles: [1, 2, 3] },
                 innerStructs: [{ bool: true, doubles: [] }, { bool: false, doubles: [5, 4, 3, 2, 1] }],
@@ -189,6 +204,7 @@ describe("Field evaluation", () => {
             jsonProperties: {
                 stringProp: "abc",
                 ints: [10, 11, 12, 13],
+                bool: true,
                 zoo: {
                     address: {
                         zipcode: 12345,
@@ -210,22 +226,27 @@ describe("Field evaluation", () => {
         imodel.saveChanges();
         return id;
     }
+    function evaluateField(propertyPath, propertyHost, deletedDependency = false) {
+        if (typeof propertyHost === "string") {
+            propertyHost = { schemaName: "Fields", className: "TestElement", elementId: propertyHost };
+        }
+        const field = FieldRun.create({
+            propertyPath,
+            propertyHost,
+        });
+        const context = createUpdateContext(propertyHost.elementId, imodel, deletedDependency);
+        return context.getProperty(field);
+    }
     describe("getProperty", () => {
         function expectValue(expected, propertyPath, propertyHost, deletedDependency = false) {
-            if (typeof propertyHost === "string") {
-                propertyHost = { schemaName: "Fields", className: "TestElement", elementId: propertyHost };
-            }
-            const field = FieldRun.create({
-                propertyPath,
-                propertyHost,
-            });
-            const context = createUpdateContext(propertyHost.elementId, imodel, deletedDependency);
-            const actual = context.getProperty(field);
-            expect(actual?.value).to.deep.equal(expected);
+            expect(evaluateField(propertyPath, propertyHost, deletedDependency)?.value).to.deep.equal(expected);
         }
         it("returns a primitive property value", () => {
             expectValue(100, { propertyName: "intProp" }, sourceElementId);
         });
+        it("returns an integer enum property value", () => {
+            expectValue(1, { propertyName: "intEnum" }, sourceElementId);
+        });
         it("treats points as primitive values", () => {
             expectValue({ x: 1, y: 2, z: 3 }, { propertyName: "point" }, sourceElementId);
             expectValue(undefined, { propertyName: "point", accessors: ["x"] }, sourceElementId);
@@ -284,28 +305,62 @@ describe("Field evaluation", () => {
             expectValue(false, { propertyName: "outerStructs", accessors: [0, "innerStructs", -1, "bool"] }, sourceElementId);
             expectValue(5, { propertyName: "outerStructs", accessors: [0, "innerStructs", 0, "doubles", 0] }, sourceElementId);
         });
-        it("returns arbitrarily-nested JSON properties", () => {
-            expectValue("abc", { propertyName: "jsonProperties", jsonAccessors: ["stringProp"] }, sourceElementId);
-            expectValue(10, { propertyName: "jsonProperties", jsonAccessors: ["ints", 0] }, sourceElementId);
-            expectValue(13, { propertyName: "jsonProperties", jsonAccessors: ["ints", 3] }, sourceElementId);
-            expectValue(13, { propertyName: "jsonProperties", jsonAccessors: ["ints", -1] }, sourceElementId);
-            expectValue(11, { propertyName: "jsonProperties", jsonAccessors: ["ints", -3] }, sourceElementId);
-            expectValue(12345, { propertyName: "jsonProperties", jsonAccessors: ["zoo", "address", "zipcode"] }, sourceElementId);
-            expectValue("scree!", { propertyName: "jsonProperties", jsonAccessors: ["zoo", "birds", 1, "sound"] }, sourceElementId);
-        });
-        it("returns undefined if JSON accessors applied to non-JSON property", () => {
-            expectValue(undefined, { propertyName: "int", jsonAccessors: ["whatever"] }, sourceElementId);
-            expectValue(undefined, { propertyName: "strings", accessors: [2, "name"] }, sourceElementId);
-            expectValue(undefined, { propertyName: "outerStruct", accessors: ["innerStruct"], jsonAccessors: ["bool"] }, sourceElementId);
-        });
         it("returns the value of a property of an aspect", () => {
             expect(imodel.elements.getAspects(sourceElementId, "Fields:TestAspect").length).to.equal(1);
             expectValue(999, { propertyName: "aspectProp" }, { elementId: sourceElementId, schemaName: "Fields", className: "TestAspect" });
         });
+        it("should fail to evaluate if prop type does not match", () => {
+            const fieldRun = FieldRun.create({
+                propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
+                propertyPath: { propertyName: "string", accessors: [0] },
+                cachedContent: "oldValue",
+                formatOptions: {
+                    case: "upper",
+                    prefix: "Value: ",
+                    suffix: "!"
+                }
+            });
+            const context = createUpdateContext(sourceElementId, imodel, false);
+            const updated = updateField(fieldRun, context);
+            expect(updated).to.be.true;
+            expect(fieldRun.cachedContent).to.equal(FieldRun.invalidContentIndicator);
+        });
+        function getPropertyType(propertyHost, propertyPath) {
+            if (typeof propertyPath === "string") {
+                propertyPath = { propertyName: propertyPath };
+            }
+            return evaluateField(propertyPath, propertyHost)?.type;
+        }
+        it("deduces type for primitive properties", () => {
+            const propertyHost = { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" };
+            expect(getPropertyType(propertyHost, "intProp")).to.equal("string");
+            expect(getPropertyType(propertyHost, "point")).to.equal("coordinate");
+            expect(getPropertyType(propertyHost, { propertyName: "strings", accessors: [0] })).to.equal("string");
+            expect(getPropertyType(propertyHost, "intEnum")).to.equal("int-enum");
+            expect(getPropertyType(propertyHost, { propertyName: "outerStruct", accessors: ["innerStruct", "doubles", 0] })).to.equal("quantity");
+            expect(getPropertyType(propertyHost, { propertyName: "outerStruct", accessors: ["innerStruct", "bool"] })).to.equal("boolean");
+            propertyHost.schemaName = "BisCore";
+            propertyHost.className = "GeometricElement3d";
+            expect(getPropertyType(propertyHost, "LastMod")).to.equal("datetime");
+            expect(getPropertyType(propertyHost, "FederationGuid")).to.equal("string");
+        });
+        it("returns undefined for non-primitive properties", () => {
+            const propertyHost = { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" };
+            expect(getPropertyType(propertyHost, "outerStruct")).to.equal(undefined);
+            expect(getPropertyType(propertyHost, "outerStructs")).to.equal(undefined);
+        });
+        it("returns undefined for invalid property paths", () => {
+            const propertyHost = { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" };
+            expect(getPropertyType(propertyHost, "unknownPropertyName")).to.be.undefined;
+        });
+        it("should return undefined for unsupported primitive types", () => {
+            const host = { elementId: sourceElementId, schemaName: "BisCore", className: "GeometricElement3d" };
+            expect(getPropertyType(host, "GeometryStream")).to.be.undefined;
+        });
     });
     describe("updateFields", () => {
         it("recomputes cached content", () => {
-            const textBlock = TextBlock.create({ styleId: "0x123" });
+            const textBlock = TextBlock.create();
             const fieldRun = FieldRun.create({
                 propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
                 propertyPath: { propertyName: "intProp" },
@@ -318,7 +373,7 @@ describe("Field evaluation", () => {
             expect(fieldRun.cachedContent).to.equal("100"); // `intProp` value from the test element
         });
         it("does not update a field if recomputed content matches cached content", () => {
-            const textBlock = TextBlock.create({ styleId: "0x123" });
+            const textBlock = TextBlock.create();
             const fieldRun = FieldRun.create({
                 propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
                 propertyPath: { propertyName: "intProp" },
@@ -331,7 +386,7 @@ describe("Field evaluation", () => {
             expect(fieldRun.cachedContent).to.equal("100");
         });
         it("returns the number of fields updated", () => {
-            const textBlock = TextBlock.create({ styleId: "0x123" });
+            const textBlock = TextBlock.create();
             const fieldRun1 = FieldRun.create({
                 propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
                 propertyPath: { propertyName: "intProp" },
@@ -361,6 +416,7 @@ describe("Field evaluation", () => {
                 angles: YawPitchRollAngles.createDegrees(0, 0, 0).toJSON(),
             },
             classFullName: TextAnnotation3d.classFullName,
+            defaultTextStyle: new TextAnnotationUsesTextStyleByDefault("0x123").toJSON(),
         }, imodel);
         if (textBlock) {
             const annotation = TextAnnotation.fromJSON({ textBlock: textBlock.toJSON() });
@@ -395,7 +451,7 @@ describe("Field evaluation", () => {
             expect(relationship.sourceId).to.equal(sourceElementId);
             expect(relationship.targetId).to.equal(targetId);
         });
-        function createField(propertyHost, cachedContent, propertyName = "intProp", accessors, jsonAccessors) {
+        function createField(propertyHost, cachedContent, propertyName = "intProp", accessors) {
             if (typeof propertyHost === "string") {
                 propertyHost = { schemaName: "Fields", className: "TestElement", elementId: propertyHost };
             }
@@ -403,13 +459,13 @@ describe("Field evaluation", () => {
                 styleOverrides: { fontName: "Karla" },
                 propertyHost,
                 cachedContent,
-                propertyPath: { propertyName, accessors, jsonAccessors },
+                propertyPath: { propertyName, accessors },
             });
         }
         describe("updateFieldDependencies", () => {
             it("creates exactly one relationship for each unique source element on insert and update", () => {
                 const source1 = insertTestElement();
-                const block = TextBlock.create({ styleId: "0x123" });
+                const block = TextBlock.create();
                 block.appendRun(createField(source1, "1"));
                 const targetId = insertAnnotationElement(block);
                 imodel.saveChanges();
@@ -437,7 +493,7 @@ describe("Field evaluation", () => {
             it("deletes stale relationships", () => {
                 const sourceA = insertTestElement();
                 const sourceB = insertTestElement();
-                const block = TextBlock.create({ styleId: "0x123" });
+                const block = TextBlock.create();
                 block.appendRun(createField(sourceA, "A"));
                 block.appendRun(createField(sourceB, "B"));
                 const targetId = insertAnnotationElement(block);
@@ -447,14 +503,16 @@ describe("Field evaluation", () => {
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).not.to.be.undefined;
                 const target = imodel.elements.getElement(targetId);
                 const anno = target.getAnnotation();
-                anno.textBlock.paragraphs[0].runs.shift();
+                // Remove the sourceA FieldRun from the first paragraph.
+                const p1 = anno.textBlock.children[0];
+                p1.children.shift();
                 target.setAnnotation(anno);
                 target.update();
                 imodel.saveChanges();
                 expectNumRelationships(1, targetId);
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).to.be.undefined;
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).not.to.be.undefined;
-                anno.textBlock.paragraphs.length = 0;
+                anno.textBlock.children.length = 0;
                 anno.textBlock.appendRun(createField(sourceA, "A2"));
                 target.setAnnotation(anno);
                 target.update();
@@ -462,7 +520,7 @@ describe("Field evaluation", () => {
                 expectNumRelationships(1, targetId);
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).not.to.be.undefined;
                 expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).to.be.undefined;
-                anno.textBlock.paragraphs.length = 0;
+                anno.textBlock.children.length = 0;
                 anno.textBlock.appendRun(TextRun.create({
                     styleOverrides: { fontName: "Karla" },
                     content: "not a field",
@@ -476,7 +534,7 @@ describe("Field evaluation", () => {
             });
             it("ignores invalid source element Ids", () => {
                 const source = insertTestElement();
-                const block = TextBlock.create({ styleId: "0x123" });
+                const block = TextBlock.create();
                 block.appendRun(createField(Id64.invalid, "invalid"));
                 block.appendRun(createField("0xbaadf00d", "non-existent"));
                 block.appendRun(createField(source, "valid"));
@@ -491,9 +549,19 @@ describe("Field evaluation", () => {
             const actual = anno.textBlock.stringify();
             expect(actual).to.equal(expected);
         }
+        it("evaluates cachedContent when annotation element is inserted", () => {
+            const sourceId = insertTestElement();
+            const block = TextBlock.create();
+            block.appendRun(createField(sourceId, "initial cached content"));
+            expect(block.stringify()).to.equal("initial cached content");
+            const targetId = insertAnnotationElement(block);
+            imodel.saveChanges();
+            const target = imodel.elements.getElement(targetId);
+            expect(target.getAnnotation().textBlock.stringify()).to.equal("100");
+        });
         it("updates fields when source element is modified or deleted", () => {
             const sourceId = insertTestElement();
-            const block = TextBlock.create({ styleId: "0x123" });
+            const block = TextBlock.create();
             block.appendRun(createField(sourceId, "old value"));
             ;
             const targetId = insertAnnotationElement(block);
@@ -516,7 +584,7 @@ describe("Field evaluation", () => {
         });
         it("updates fields when source element aspect is modified, deleted, or recreated", () => {
             const sourceId = insertTestElement();
-            const block = TextBlock.create({ styleId: "0x123" });
+            const block = TextBlock.create();
             block.appendRun(createField({ elementId: sourceId, schemaName: "Fields", className: "TestAspect" }, "", "aspectProp"));
             const targetId = insertAnnotationElement(block);
             imodel.saveChanges();
@@ -544,7 +612,7 @@ describe("Field evaluation", () => {
         it("updates only fields for specific modified element", () => {
             const sourceA = insertTestElement();
             const sourceB = insertTestElement();
-            const block = TextBlock.create({ styleId: "0x123" });
+            const block = TextBlock.create();
             block.appendRun(createField(sourceA, "A"));
             block.appendRun(createField(sourceB, "B"));
             const targetId = insertAnnotationElement(block);
@@ -558,18 +626,67 @@ describe("Field evaluation", () => {
         });
         it("supports complex property paths", () => {
             const sourceId = insertTestElement();
-            const block = TextBlock.create({ styleId: "0x123" });
+            const block = TextBlock.create();
             block.appendRun(createField(sourceId, "", "outerStruct", ["innerStructs", 1, "doubles", -2]));
-            block.appendRun(createField(sourceId, "", "jsonProperties", undefined, ["zoo", "birds", 0, "name"]));
             const targetId = insertAnnotationElement(block);
             imodel.saveChanges();
-            expectText("2duck", targetId);
+            expectText("2", targetId);
             const source = imodel.elements.getElement(sourceId);
             source.outerStruct.innerStructs[1].doubles[3] = 12.5;
-            source.jsonProperties.zoo.birds[0].name = "parrot";
             source.update();
             imodel.saveChanges();
-            expectText("12.5parrot", targetId);
+            expectText("12.5", targetId);
+        });
+    });
+    describe("Format Validation", () => {
+        it("validates formatting options for string property type", () => {
+            // Create a FieldRun with string property type and some format options
+            const fieldRun = FieldRun.create({
+                propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
+                propertyPath: { propertyName: "strings", accessors: [0] },
+                cachedContent: "oldValue",
+                formatOptions: {
+                    case: "upper",
+                    prefix: "Value: ",
+                    suffix: "!"
+                }
+            });
+            // Context returns a string value for the property
+            const context = {
+                hostElementId: sourceElementId,
+                getProperty: () => { return { value: "abc", type: "string" }; },
+            };
+            // Update the field and check the result
+            const updated = updateField(fieldRun, context);
+            // The formatted value should be uppercased and have prefix/suffix applied
+            expect(updated).to.be.true;
+            expect(fieldRun.cachedContent).to.equal("Value: ABC!");
+        });
+        it("validates formatting options for datetime objects", function () {
+            if (!isIntlSupported()) {
+                this.skip();
+            }
+            const propertyHost = { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" };
+            const fieldRun = FieldRun.create({
+                propertyHost,
+                propertyPath: { propertyName: "datetime" },
+                cachedContent: "oldval",
+                formatOptions: {
+                    dateTime: {
+                        formatOptions: {
+                            month: "short",
+                            day: "2-digit",
+                            year: "numeric",
+                            timeZone: "UTC"
+                        },
+                        locale: "en-US",
+                    },
+                },
+            });
+            const context = createUpdateContext(sourceElementId, imodel, false);
+            const updated = updateField(fieldRun, context);
+            expect(updated).to.be.true;
+            expect(fieldRun.cachedContent).to.equal("Aug 28, 2025");
         });
     });
 });