@itwin/core-backend 5.1.0-dev.9 → 5.2.0-dev.2

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

@@ -16,7 +16,7 @@ export declare class DisableNativeAssertions implements Disposable {
     private _native;
     constructor();
     [Symbol.dispose](): void;
-    /** @deprecated in 5.0 Use [Symbol.dispose] instead. */
+    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */
     dispose(): void;
 }
 export declare class TestUtils {

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

@@ -1 +1 @@
-{"version":3,"file":"TestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG9D,mCAAmC;AACnC,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAO;gBACT,KAAK,EAAE,MAAM;IAKlB,GAAG;CAMX;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,OAAO,CAAC,OAAO,CAAqD;;IAM7D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAQ/B,uDAAuD;IAChD,OAAO,IAAI,IAAI;CAGvB;AAED,qBAAa,SAAS;WACN,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAG,SAAqB;IAOlE;;;;;;OAMG;WACiB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;WAOvD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;WAItC,YAAY;IAK1B,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAUnB,mBAAmB;WAInB,mBAAmB;CAGlC"}
+{"version":3,"file":"TestUtils.d.ts","sourceRoot":"","sources":["../../../src/test/TestUtils.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG9D,mCAAmC;AACnC,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAO;gBACT,KAAK,EAAE,MAAM;IAKlB,GAAG;CAMX;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,OAAO,CAAC,OAAO,CAAqD;;IAM7D,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAQ/B,qGAAqG;IAC9F,OAAO,IAAI,IAAI;CAGvB;AAED,qBAAa,SAAS;WACN,WAAW,CAAC,QAAQ,GAAE,MAAM,GAAG,SAAqB;IAOlE;;;;;;OAMG;WACiB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;WAOvD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;WAItC,YAAY;IAK1B,OAAO,CAAC,MAAM,CAAC,kBAAkB;WAUnB,mBAAmB;WAInB,mBAAmB;CAGlC"}

package/lib/esm/test/TestUtils.js

@@ -40,7 +40,7 @@ export class DisableNativeAssertions {
         this._native.dispose();
         this._native = undefined;
     }
-    /** @deprecated in 5.0 Use [Symbol.dispose] instead. */
+    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */
     dispose() {
         this[Symbol.dispose]();
     }

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

@@ -1 +1 @@
-{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.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 * as path from \"path\";\nimport { IModelJsNative, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nimport { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelHost, IModelHostOptions } from \"../IModelHost\";\nimport { IModelNative } from \"../internal/NativePlatform\";\n\n/** Class for simple test timing */\nexport class Timer {\n  private _label: string;\n  private _start: Date;\n  constructor(label: string) {\n    this._label = `\\t${label}`;\n    this._start = new Date();\n  }\n\n  public end() {\n    const stop = new Date();\n    const elapsed = stop.getTime() - this._start.getTime();\n    // eslint-disable-next-line no-console\n    console.log(`${this._label}: ${elapsed}ms`);\n  }\n}\n\n/**\n * Disables native code assertions from firing. This can be used by tests that intentionally\n * test failing operations. If those failing operations raise assertions in native code, the test\n * would fail unexpectedly in a debug build. In that case the native code assertions can be disabled with\n * this class.\n */\nexport class DisableNativeAssertions implements Disposable {\n  private _native: IModelJsNative.DisableNativeAssertions | undefined;\n\n  constructor() {\n    this._native = new IModelNative.platform.DisableNativeAssertions();\n  }\n\n  public [Symbol.dispose](): void {\n    if (!this._native)\n      return;\n\n    this._native.dispose();\n    this._native = undefined;\n  }\n\n  /** @deprecated in 5.0 Use [Symbol.dispose] instead. */\n  public dispose(): void {\n    this[Symbol.dispose]();\n  }\n}\n\nexport class TestUtils {\n  public static getCacheDir(fallback: string | undefined = undefined) {\n    if (ProcessDetector.isMobileAppBackend) {\n      return undefined; // Let the native side handle the cache.\n    }\n    return fallback ?? path.join(__dirname, \".cache\"); // Set the cache dir to be under the lib directory.\n  }\n\n  /** Handles the startup of IModelHost.\n   * The provided config is used and will override any of the default values used in this method.\n   *\n   * The default includes:\n   * - cacheDir = path.join(__dirname, \".cache\")\n   * - allowSharedChannel = false;\n   */\n  public static async startBackend(config?: IModelHostOptions): Promise<void> {\n    const cfg = config ?? {};\n    cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);\n    cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.\n    await IModelHost.startup(cfg);\n  }\n\n  public static async shutdownBackend(): Promise<void> {\n    return IModelHost.shutdown();\n  }\n\n  public static setupLogging() {\n    Logger.initializeToConsole();\n    Logger.setLevelDefault(LogLevel.Error);\n  }\n\n  private static initDebugLogLevels(reset?: boolean) {\n    Logger.setLevelDefault(reset ? LogLevel.Error : LogLevel.Warning);\n    Logger.setLevel(BentleyLoggerCategory.Performance, reset ? LogLevel.Error : LogLevel.Info);\n    Logger.setLevel(BackendLoggerCategory.IModelDb, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.DgnCore, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.BeSQLite, reset ? LogLevel.Error : LogLevel.Trace);\n  }\n\n  // Setup typical programmatic log level overrides here\n  // Convenience method used to debug specific tests/fixtures\n  public static setupDebugLogLevels() {\n    TestUtils.initDebugLogLevels(false);\n  }\n\n  public static resetDebugLogLevels() {\n    TestUtils.initDebugLogLevels(true);\n  }\n}\n\n// The very first \"before\" run to initially setup the logging and initial backend.\nbefore(async () => {\n  TestUtils.setupLogging();\n  await TestUtils.startBackend();\n});\n\nafter(async () => {\n  await TestUtils.shutdownBackend();\n});\n\n"]}
+{"version":3,"file":"TestUtils.js","sourceRoot":"","sources":["../../../src/test/TestUtils.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 * as path from \"path\";\nimport { IModelJsNative, NativeLoggerCategory } from \"@bentley/imodeljs-native\";\nimport { BentleyLoggerCategory, Logger, LogLevel, ProcessDetector } from \"@itwin/core-bentley\";\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\nimport { IModelHost, IModelHostOptions } from \"../IModelHost\";\nimport { IModelNative } from \"../internal/NativePlatform\";\n\n/** Class for simple test timing */\nexport class Timer {\n  private _label: string;\n  private _start: Date;\n  constructor(label: string) {\n    this._label = `\\t${label}`;\n    this._start = new Date();\n  }\n\n  public end() {\n    const stop = new Date();\n    const elapsed = stop.getTime() - this._start.getTime();\n    // eslint-disable-next-line no-console\n    console.log(`${this._label}: ${elapsed}ms`);\n  }\n}\n\n/**\n * Disables native code assertions from firing. This can be used by tests that intentionally\n * test failing operations. If those failing operations raise assertions in native code, the test\n * would fail unexpectedly in a debug build. In that case the native code assertions can be disabled with\n * this class.\n */\nexport class DisableNativeAssertions implements Disposable {\n  private _native: IModelJsNative.DisableNativeAssertions | undefined;\n\n  constructor() {\n    this._native = new IModelNative.platform.DisableNativeAssertions();\n  }\n\n  public [Symbol.dispose](): void {\n    if (!this._native)\n      return;\n\n    this._native.dispose();\n    this._native = undefined;\n  }\n\n  /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [Symbol.dispose] instead. */\n  public dispose(): void {\n    this[Symbol.dispose]();\n  }\n}\n\nexport class TestUtils {\n  public static getCacheDir(fallback: string | undefined = undefined) {\n    if (ProcessDetector.isMobileAppBackend) {\n      return undefined; // Let the native side handle the cache.\n    }\n    return fallback ?? path.join(__dirname, \".cache\"); // Set the cache dir to be under the lib directory.\n  }\n\n  /** Handles the startup of IModelHost.\n   * The provided config is used and will override any of the default values used in this method.\n   *\n   * The default includes:\n   * - cacheDir = path.join(__dirname, \".cache\")\n   * - allowSharedChannel = false;\n   */\n  public static async startBackend(config?: IModelHostOptions): Promise<void> {\n    const cfg = config ?? {};\n    cfg.cacheDir = TestUtils.getCacheDir(cfg.cacheDir);\n    cfg.allowSharedChannel ??= false; // Override default to test shared channel enforcement. Remove in version 5.0.\n    await IModelHost.startup(cfg);\n  }\n\n  public static async shutdownBackend(): Promise<void> {\n    return IModelHost.shutdown();\n  }\n\n  public static setupLogging() {\n    Logger.initializeToConsole();\n    Logger.setLevelDefault(LogLevel.Error);\n  }\n\n  private static initDebugLogLevels(reset?: boolean) {\n    Logger.setLevelDefault(reset ? LogLevel.Error : LogLevel.Warning);\n    Logger.setLevel(BentleyLoggerCategory.Performance, reset ? LogLevel.Error : LogLevel.Info);\n    Logger.setLevel(BackendLoggerCategory.IModelDb, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.DgnCore, reset ? LogLevel.Error : LogLevel.Trace);\n    Logger.setLevel(NativeLoggerCategory.BeSQLite, reset ? LogLevel.Error : LogLevel.Trace);\n  }\n\n  // Setup typical programmatic log level overrides here\n  // Convenience method used to debug specific tests/fixtures\n  public static setupDebugLogLevels() {\n    TestUtils.initDebugLogLevels(false);\n  }\n\n  public static resetDebugLogLevels() {\n    TestUtils.initDebugLogLevels(true);\n  }\n}\n\n// The very first \"before\" run to initially setup the logging and initial backend.\nbefore(async () => {\n  TestUtils.setupLogging();\n  await TestUtils.startBackend();\n});\n\nafter(async () => {\n  await TestUtils.shutdownBackend();\n});\n\n"]}

package/lib/esm/test/annotations/Fields.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Fields.test.d.ts.map

package/lib/esm/test/annotations/Fields.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fields.test.d.ts","sourceRoot":"","sources":["../../../../src/test/annotations/Fields.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,576 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { expect } from "chai";
+import { Code, FieldRun, SubCategoryAppearance, TextAnnotation, TextBlock, TextRun } from "@itwin/core-common";
+import { StandaloneDb } from "../../IModelDb";
+import { IModelTestUtils } from "../IModelTestUtils";
+import { createUpdateContext, updateField, updateFields } from "../../internal/annotations/fields";
+import { DbResult, Id64 } 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";
+describe("updateField", () => {
+    const mockElementId = "0x1";
+    const mockPath = {
+        propertyName: "mockProperty",
+        accessors: [0, "nestedProperty"],
+    };
+    const mockCachedContent = "cachedContent";
+    const mockUpdatedContent = "updatedContent";
+    const createMockContext = (elementId, propertyValue) => ({
+        hostElementId: elementId,
+        getProperty: (field) => {
+            const propertyPath = field.propertyPath;
+            if (propertyPath.propertyName === "mockProperty" &&
+                propertyPath.accessors?.[0] === 0 &&
+                propertyPath.accessors?.[1] === "nestedProperty" &&
+                propertyValue !== undefined) {
+                return { value: propertyValue, metadata: {} };
+            }
+            return undefined;
+        },
+    });
+    it("does nothing if hostElementId does not match", () => {
+        const fieldRun = FieldRun.create({
+            propertyHost: { elementId: mockElementId, schemaName: "TestSchema", className: "TestClass" },
+            propertyPath: mockPath,
+            cachedContent: mockCachedContent,
+        });
+        const context = createMockContext("0x2", mockUpdatedContent);
+        const result = updateField(fieldRun, context);
+        expect(result).to.be.false;
+        expect(fieldRun.cachedContent).to.equal(mockCachedContent);
+    });
+    it("produces invalid content indicator if property value is undefined", () => {
+        const fieldRun = FieldRun.create({
+            propertyHost: { elementId: mockElementId, schemaName: "TestSchema", className: "TestClass" },
+            propertyPath: mockPath,
+            cachedContent: mockCachedContent,
+        });
+        const context = createMockContext(mockElementId);
+        const result = updateField(fieldRun, context);
+        expect(result).to.be.true;
+        expect(fieldRun.cachedContent).to.equal(FieldRun.invalidContentIndicator);
+    });
+    it("returns false if cached content matches new content", () => {
+        const fieldRun = FieldRun.create({
+            propertyHost: { elementId: mockElementId, schemaName: "TestSchema", className: "TestClass" },
+            propertyPath: mockPath,
+            cachedContent: mockCachedContent,
+        });
+        const context = createMockContext(mockElementId, mockCachedContent);
+        const result = updateField(fieldRun, context);
+        expect(result).to.be.false;
+        expect(fieldRun.cachedContent).to.equal(mockCachedContent);
+    });
+    it("returns true and updates cached content if new content is different", () => {
+        const fieldRun = FieldRun.create({
+            propertyHost: { elementId: mockElementId, schemaName: "TestSchema", className: "TestClass" },
+            propertyPath: mockPath,
+            cachedContent: mockCachedContent,
+        });
+        const context = createMockContext(mockElementId, mockUpdatedContent);
+        const result = updateField(fieldRun, context);
+        expect(result).to.be.true;
+        expect(fieldRun.cachedContent).to.equal(mockUpdatedContent);
+    });
+    it("resolves to invalid content indicator if an exception occurs", () => {
+        const fieldRun = FieldRun.create({
+            propertyHost: { elementId: mockElementId, schemaName: "TestSchema", className: "TestClass" },
+            propertyPath: mockPath,
+            cachedContent: mockCachedContent,
+        });
+        const context = {
+            hostElementId: mockElementId,
+            getProperty: () => {
+                throw new Error("Test exception");
+            },
+        };
+        const result = updateField(fieldRun, context);
+        expect(result).to.be.true;
+        expect(fieldRun.cachedContent).to.equal(FieldRun.invalidContentIndicator);
+    });
+});
+const fieldsSchemaXml = `
+<?xml version="1.0" encoding="UTF-8"?>
+<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"/>
+
+  <ECStructClass typeName="InnerStruct" modifier="None">
+    <ECProperty propertyName="bool" typeName="boolean"/>
+    <ECArrayProperty propertyName="doubles" typeName="double" minOccurs="0" maxOccurs="unbounded"/>
+  </ECStructClass>
+
+  <ECStructClass typeName="OuterStruct" modifier="None">
+    <ECStructProperty propertyName="innerStruct" typeName="InnerStruct"/>
+    <ECStructArrayProperty propertyName="innerStructs" typeName="InnerStruct" minOccurs="0" maxOccurs="unbounded"/>
+  </ECStructClass>
+
+  <ECEntityClass typeName="TestElement" modifier="None">
+    <BaseClass>bis:PhysicalElement</BaseClass>
+    <ECProperty propertyName="intProp" typeName="int"/>
+    <ECProperty propertyName="point" typeName="point3d"/>
+    <ECProperty propertyName="maybeNull" typeName="int"/>
+    <ECArrayProperty propertyName="strings" typeName="string" minOccurs="0" maxOccurs="unbounded"/>
+    <ECStructProperty propertyName="outerStruct" typeName="OuterStruct"/>
+    <ECStructArrayProperty propertyName="outerStructs" typeName="OuterStruct" minOccurs="0" maxOccurs="unbounded"/>
+  </ECEntityClass>
+
+  <ECEntityClass typeName="TestAspect" modifier="None">
+    <BaseClass>bis:ElementUniqueAspect</BaseClass>
+    <ECProperty propertyName="aspectProp" typeName="int"/>
+  </ECEntityClass>
+</ECSchema>
+`;
+class TestElement extends PhysicalElement {
+    static get className() { return "TestElement"; }
+}
+class TestAspect extends ElementUniqueAspect {
+    static get className() { return "TestAspect"; }
+}
+class FieldsSchema extends Schema {
+    static get schemaName() { return "Fields"; }
+}
+async function registerTestSchema(iModel) {
+    if (!Schemas.getRegisteredSchema("Fields")) {
+        Schemas.registerSchema(FieldsSchema);
+        ClassRegistry.register(TestElement, FieldsSchema);
+        ClassRegistry.register(TestAspect, FieldsSchema);
+    }
+    await iModel.importSchemaStrings([fieldsSchemaXml]);
+    iModel.saveChanges();
+}
+describe("Field evaluation", () => {
+    let imodel;
+    let model;
+    let category;
+    let sourceElementId;
+    before(async () => {
+        const iModelPath = IModelTestUtils.prepareOutputFile("UpdateFieldsContext", "test.bim");
+        imodel = StandaloneDb.createEmpty(iModelPath, { rootSubject: { name: "UpdateFieldsContext" }, allowEdit: JSON.stringify({ txns: true }) });
+        await registerTestSchema(imodel);
+        model = IModelTestUtils.createAndInsertPhysicalPartitionAndModel(imodel, Code.createEmpty(), true)[1];
+        category = SpatialCategory.insert(imodel, StandaloneDb.dictionaryId, "UpdateFieldsContextCategory", new SubCategoryAppearance());
+        sourceElementId = insertTestElement();
+        await imodel.fonts.embedFontFile({
+            file: FontFile.createFromTrueTypeFileName(IModelTestUtils.resolveFontFile("Karla-Regular.ttf"))
+        });
+    });
+    after(() => {
+        imodel.close();
+    });
+    function insertTestElement() {
+        const props = {
+            classFullName: "Fields:TestElement",
+            model,
+            category,
+            code: Code.createEmpty(),
+            intProp: 100,
+            point: { x: 1, y: 2, z: 3 },
+            strings: ["a", "b", `"name": "c"`],
+            outerStruct: {
+                innerStruct: { bool: false, doubles: [1, 2, 3] },
+                innerStructs: [{ bool: true, doubles: [] }, { bool: false, doubles: [5, 4, 3, 2, 1] }],
+            },
+            outerStructs: [{
+                    innerStruct: { bool: true, doubles: [10, 9] },
+                    innerStructs: [{ bool: false, doubles: [5] }],
+                }],
+            placement: {
+                origin: new Point3d(1, 2, 0),
+                angles: new YawPitchRollAngles(),
+            },
+            jsonProperties: {
+                stringProp: "abc",
+                ints: [10, 11, 12, 13],
+                zoo: {
+                    address: {
+                        zipcode: 12345,
+                    },
+                    birds: [
+                        { name: "duck", sound: "quack" },
+                        { name: "hawk", sound: "scree!" },
+                    ],
+                },
+            },
+        };
+        const id = imodel.elements.insertElement(props);
+        const aspectProps = {
+            classFullName: TestAspect.classFullName,
+            aspectProp: 999,
+            element: new ElementOwnsUniqueAspect(id),
+        };
+        imodel.elements.insertAspect(aspectProps);
+        imodel.saveChanges();
+        return id;
+    }
+    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);
+        }
+        it("returns a primitive property value", () => {
+            expectValue(100, { propertyName: "intProp" }, sourceElementId);
+        });
+        it("treats points as primitive values", () => {
+            expectValue({ x: 1, y: 2, z: 3 }, { propertyName: "point" }, sourceElementId);
+            expectValue(undefined, { propertyName: "point", accessors: ["x"] }, sourceElementId);
+        });
+        it("returns a primitive array value", () => {
+            expectValue("a", { propertyName: "strings", accessors: [0] }, sourceElementId);
+            expectValue("b", { propertyName: "strings", accessors: [1] }, sourceElementId);
+            expectValue(`"name": "c"`, { propertyName: "strings", accessors: [2] }, sourceElementId);
+        });
+        it("supports negative array indices", () => {
+            expectValue("a", { propertyName: "strings", accessors: [-3] }, sourceElementId);
+            expectValue("b", { propertyName: "strings", accessors: [-2] }, sourceElementId);
+            expectValue(`"name": "c"`, { propertyName: "strings", accessors: [-1] }, sourceElementId);
+        });
+        it("returns undefined if the dependency was deleted", () => {
+            expectValue(undefined, { propertyName: "intProp" }, sourceElementId, true);
+        });
+        it("returns undefined if the host element does not exist", () => {
+            expectValue(undefined, { propertyName: "intProp" }, "0xbaadf00d");
+        });
+        it("returns undefined if the host element is not of the specified class or a subclass thereof", () => {
+            expectValue(undefined, { propertyName: "origin" }, { schemaName: "BisCore", className: "GeometricElement2d", elementId: sourceElementId });
+        });
+        it("returns undefined if an access string is specified for a non-object property", () => {
+            expectValue(undefined, { propertyName: "intProp", accessors: ["property"] }, sourceElementId);
+        });
+        it("returns undefined if the specified property does not exist", () => {
+            expectValue(undefined, { propertyName: "nonExistentProperty" }, sourceElementId);
+        });
+        it("returns undefined if the specified property is null", () => {
+            expectValue(undefined, { propertyName: "maybeNull" }, sourceElementId);
+        });
+        it("returns undefined if an array index is specified for a non-array property", () => {
+            expectValue(undefined, { propertyName: "intProp", accessors: [0] }, sourceElementId);
+        });
+        it("returns undefined if an array index is out of bounds", () => {
+            for (const index of [3, 4, -4, -5]) {
+                expectValue(undefined, { propertyName: "strings", accessors: [index] }, sourceElementId);
+            }
+        });
+        it("returns undefined for a non-primitive value", () => {
+            expectValue(undefined, { propertyName: "strings" }, sourceElementId);
+            expectValue(undefined, { propertyName: "outerStruct" }, sourceElementId);
+            expectValue(undefined, { propertyName: "outerStruct", accessors: ["innerStruct"] }, sourceElementId);
+            expectValue(undefined, { propertyName: "outerStructs" }, sourceElementId);
+            expectValue(undefined, { propertyName: "outerStructs", accessors: [0] }, sourceElementId);
+            expectValue(undefined, { propertyName: "outerStructs", accessors: [0, "innerStruct"] }, sourceElementId);
+        });
+        it("returns arbitrarily-nested properties of structs and struct arrays", () => {
+            expectValue(false, { propertyName: "outerStruct", accessors: ["innerStruct", "bool"] }, sourceElementId);
+            for (const index of [0, 1, 2]) {
+                expectValue(index + 1, { propertyName: "outerStruct", accessors: ["innerStruct", "doubles", index] }, sourceElementId);
+                expectValue(3 - index, { propertyName: "outerStruct", accessors: ["innerStruct", "doubles", -1 - index] }, sourceElementId);
+            }
+            expectValue(9, { propertyName: "outerStructs", accessors: [0, "innerStruct", "doubles", 1] }, sourceElementId);
+            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" });
+        });
+    });
+    describe("updateFields", () => {
+        it("recomputes cached content", () => {
+            const textBlock = TextBlock.create({ styleId: "0x123" });
+            const fieldRun = FieldRun.create({
+                propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
+                propertyPath: { propertyName: "intProp" },
+                cachedContent: "oldValue",
+            });
+            textBlock.appendRun(fieldRun);
+            const context = createUpdateContext(sourceElementId, imodel, false);
+            const updatedCount = updateFields(textBlock, context);
+            expect(updatedCount).to.equal(1);
+            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 fieldRun = FieldRun.create({
+                propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
+                propertyPath: { propertyName: "intProp" },
+                cachedContent: "100",
+            });
+            textBlock.appendRun(fieldRun);
+            const context = createUpdateContext(sourceElementId, imodel, false);
+            const updatedCount = updateFields(textBlock, context);
+            expect(updatedCount).to.equal(0);
+            expect(fieldRun.cachedContent).to.equal("100");
+        });
+        it("returns the number of fields updated", () => {
+            const textBlock = TextBlock.create({ styleId: "0x123" });
+            const fieldRun1 = FieldRun.create({
+                propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
+                propertyPath: { propertyName: "intProp" },
+                cachedContent: "100",
+            });
+            const fieldRun2 = FieldRun.create({
+                propertyHost: { elementId: sourceElementId, schemaName: "Fields", className: "TestElement" },
+                propertyPath: { propertyName: "strings", accessors: [0] },
+                cachedContent: "oldValue",
+            });
+            textBlock.appendRun(fieldRun1);
+            textBlock.appendRun(fieldRun2);
+            const context = createUpdateContext(sourceElementId, imodel, false);
+            const updatedCount = updateFields(textBlock, context);
+            expect(updatedCount).to.equal(1);
+            expect(fieldRun1.cachedContent).to.equal("100");
+            expect(fieldRun2.cachedContent).to.equal("a");
+        });
+    });
+    function insertAnnotationElement(textBlock) {
+        const elem = TextAnnotation3d.fromJSON({
+            model,
+            category,
+            code: Code.createEmpty(),
+            placement: {
+                origin: { x: 0, y: 0, z: 0 },
+                angles: YawPitchRollAngles.createDegrees(0, 0, 0).toJSON(),
+            },
+            classFullName: TextAnnotation3d.classFullName,
+        }, imodel);
+        if (textBlock) {
+            const annotation = TextAnnotation.fromJSON({ textBlock: textBlock.toJSON() });
+            elem.setAnnotation(annotation);
+        }
+        return elem.insert();
+    }
+    describe("ElementDrivesTextAnnotation", () => {
+        function expectNumRelationships(expected, targetId) {
+            const where = targetId ? ` WHERE TargetECInstanceId=${targetId}` : "";
+            const ecsql = `SELECT COUNT(*) FROM BisCore.ElementDrivesTextAnnotation ${where}`;
+            // eslint-disable-next-line @typescript-eslint/no-deprecated
+            imodel.withPreparedStatement(ecsql, (stmt) => {
+                expect(stmt.step()).to.equal(DbResult.BE_SQLITE_ROW);
+                expect(stmt.getValue(0).getInteger()).to.equal(expected);
+            });
+        }
+        it("can be inserted", () => {
+            expectNumRelationships(0);
+            const targetId = insertAnnotationElement(undefined);
+            expect(targetId).not.to.equal(Id64.invalid);
+            const target = imodel.elements.getElement(targetId);
+            expect(target.classFullName).to.equal("BisCore:TextAnnotation3d");
+            expect(target).instanceof(TextAnnotation3d);
+            const targetAnno = imodel.elements.getElement(targetId);
+            expect(targetAnno).instanceof(TextAnnotation3d);
+            const rel = ElementDrivesTextAnnotation.create(imodel, sourceElementId, targetId);
+            const relId = rel.insert();
+            expect(relId).not.to.equal(Id64.invalid);
+            expectNumRelationships(1);
+            const relationship = imodel.relationships.getInstance("BisCore:ElementDrivesTextAnnotation", relId);
+            expect(relationship.sourceId).to.equal(sourceElementId);
+            expect(relationship.targetId).to.equal(targetId);
+        });
+        function createField(propertyHost, cachedContent, propertyName = "intProp", accessors, jsonAccessors) {
+            if (typeof propertyHost === "string") {
+                propertyHost = { schemaName: "Fields", className: "TestElement", elementId: propertyHost };
+            }
+            return FieldRun.create({
+                styleOverrides: { fontName: "Karla" },
+                propertyHost,
+                cachedContent,
+                propertyPath: { propertyName, accessors, jsonAccessors },
+            });
+        }
+        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" });
+                block.appendRun(createField(source1, "1"));
+                const targetId = insertAnnotationElement(block);
+                imodel.saveChanges();
+                expectNumRelationships(1, targetId);
+                const source2 = insertTestElement();
+                const target = imodel.elements.getElement(targetId);
+                const anno = target.getAnnotation();
+                anno.textBlock.appendRun(createField(source2, "2a"));
+                target.setAnnotation(anno);
+                target.update();
+                imodel.saveChanges();
+                expectNumRelationships(2, targetId);
+                anno.textBlock.appendRun(createField(source2, "2b"));
+                target.setAnnotation(anno);
+                target.update();
+                imodel.saveChanges();
+                expectNumRelationships(2, targetId);
+                const source3 = insertTestElement();
+                anno.textBlock.appendRun(createField(source3, "3"));
+                target.setAnnotation(anno);
+                target.update();
+                imodel.saveChanges();
+                expectNumRelationships(3, targetId);
+            });
+            it("deletes stale relationships", () => {
+                const sourceA = insertTestElement();
+                const sourceB = insertTestElement();
+                const block = TextBlock.create({ styleId: "0x123" });
+                block.appendRun(createField(sourceA, "A"));
+                block.appendRun(createField(sourceB, "B"));
+                const targetId = insertAnnotationElement(block);
+                imodel.saveChanges();
+                expectNumRelationships(2, targetId);
+                expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).not.to.be.undefined;
+                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();
+                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.appendRun(createField(sourceA, "A2"));
+                target.setAnnotation(anno);
+                target.update();
+                imodel.saveChanges();
+                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.appendRun(TextRun.create({
+                    styleOverrides: { fontName: "Karla" },
+                    content: "not a field",
+                }));
+                target.setAnnotation(anno);
+                target.update();
+                imodel.saveChanges();
+                expectNumRelationships(0, targetId);
+                expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceA })).to.be.undefined;
+                expect(imodel.relationships.tryGetInstance(ElementDrivesTextAnnotation.classFullName, { targetId, sourceId: sourceB })).to.be.undefined;
+            });
+            it("ignores invalid source element Ids", () => {
+                const source = insertTestElement();
+                const block = TextBlock.create({ styleId: "0x123" });
+                block.appendRun(createField(Id64.invalid, "invalid"));
+                block.appendRun(createField("0xbaadf00d", "non-existent"));
+                block.appendRun(createField(source, "valid"));
+                const targetId = insertAnnotationElement(block);
+                imodel.saveChanges();
+                expectNumRelationships(1, targetId);
+            });
+        });
+        function expectText(expected, elemId) {
+            const elem = imodel.elements.getElement(elemId);
+            const anno = elem.getAnnotation();
+            const actual = anno.textBlock.stringify();
+            expect(actual).to.equal(expected);
+        }
+        it("updates fields when source element is modified or deleted", () => {
+            const sourceId = insertTestElement();
+            const block = TextBlock.create({ styleId: "0x123" });
+            block.appendRun(createField(sourceId, "old value"));
+            ;
+            const targetId = insertAnnotationElement(block);
+            imodel.saveChanges();
+            const target = imodel.elements.getElement(targetId);
+            expect(target.getAnnotation()).not.to.be.undefined;
+            expectText("100", targetId);
+            let source = imodel.elements.getElement(sourceId);
+            source.intProp = 50;
+            source.update();
+            expectText("100", targetId);
+            imodel.saveChanges();
+            source = imodel.elements.getElement(sourceId);
+            expect(source.intProp).to.equal(50);
+            expectText("50", targetId);
+            imodel.elements.deleteElement(sourceId);
+            expectText("50", targetId);
+            imodel.saveChanges();
+            expectText(FieldRun.invalidContentIndicator, targetId);
+        });
+        it("updates fields when source element aspect is modified, deleted, or recreated", () => {
+            const sourceId = insertTestElement();
+            const block = TextBlock.create({ styleId: "0x123" });
+            block.appendRun(createField({ elementId: sourceId, schemaName: "Fields", className: "TestAspect" }, "", "aspectProp"));
+            const targetId = insertAnnotationElement(block);
+            imodel.saveChanges();
+            expectText("999", targetId);
+            const aspects = imodel.elements.getAspects(sourceId, "Fields:TestAspect");
+            expect(aspects.length).to.equal(1);
+            const aspect = aspects[0];
+            expect(aspect.aspectProp).to.equal(999);
+            aspect.aspectProp = 12345;
+            imodel.elements.updateAspect(aspect.toJSON());
+            imodel.saveChanges();
+            expectText("12345", targetId);
+            imodel.elements.deleteAspect([aspect.id]);
+            imodel.saveChanges();
+            expectText(FieldRun.invalidContentIndicator, targetId);
+            const newAspect = {
+                element: new ElementOwnsUniqueAspect(sourceId),
+                classFullName: TestAspect.classFullName,
+                aspectProp: 42,
+            };
+            imodel.elements.insertAspect(newAspect);
+            imodel.saveChanges();
+            expectText("42", targetId);
+        });
+        it("updates only fields for specific modified element", () => {
+            const sourceA = insertTestElement();
+            const sourceB = insertTestElement();
+            const block = TextBlock.create({ styleId: "0x123" });
+            block.appendRun(createField(sourceA, "A"));
+            block.appendRun(createField(sourceB, "B"));
+            const targetId = insertAnnotationElement(block);
+            imodel.saveChanges();
+            expectText("100100", targetId);
+            const sourceElem = imodel.elements.getElement(sourceB);
+            sourceElem.intProp = 123;
+            sourceElem.update();
+            imodel.saveChanges();
+            expectText("100123", targetId);
+        });
+        it("supports complex property paths", () => {
+            const sourceId = insertTestElement();
+            const block = TextBlock.create({ styleId: "0x123" });
+            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);
+            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);
+        });
+    });
+});
+//# sourceMappingURL=Fields.test.js.map