@itwin/core-backend 5.14.0-dev.8 → 5.15.0-dev.1

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

@@ -1,13 +1,44 @@
 /** @packageDocumentation
  * @module Elements
  */
-import { Id64String } from "@itwin/core-bentley";
+import { BeEvent, Id64String } from "@itwin/core-bentley";
 import { RelatedElement, TextBlock } from "@itwin/core-common";
+import { UnitSystemKey } from "@itwin/core-quantity";
+import { FormatSet } from "@itwin/ecschema-metadata";
 import { Element } from "../Element";
 import { IModelDb } from "../IModelDb";
 import { IModelElementCloneContext } from "../IModelElementCloneContext";
 import { ElementDrivesElement, OnDependencyArg } from "../Relationship";
 import { EditTxn } from "../EditTxn";
+/** Configures how `"quantity"` and `"coordinate"` [FieldRun]($common)s in an iModel are
+ * formatted. Passed to [[ElementDrivesTextAnnotation.registerFieldFormatting]].
+ * @beta
+ */
+export interface FieldFormattingArgs {
+    /** The iModel whose annotations this configuration formats. Its `schemaContext` supplies the
+     * KindOfQuantity presentation formats that every FormatSet falls back to.
+     */
+    iModel: IModelDb;
+    /** The FormatSet adopted for this iModel. It applies to every [FieldRun]($common) that does
+     * not name a different one via [QuantityFieldFormatOptions.formatSet]($common), and takes
+     * precedence over the schema's own presentation formats.
+     */
+    formatSet?: FormatSet;
+    /** Additional FormatSets addressable per-field, each paired with the id that
+     * [FieldRun]($common)s reference via [QuantityFieldFormatOptions.formatSet]($common).
+     * The id must be unique; if two entries share an id the last one wins. A field naming an id
+     * absent from this list falls back to [[formatSet]].
+     */
+    formatSets?: ReadonlyArray<{
+        id: string;
+        formatSet: FormatSet;
+    }>;
+    /** Unit system used to pick a KindOfQuantity's presentation format when the schema offers
+     * several. Defaults to [[formatSet]]'s own `unitSystem`, or `"metric"` when no FormatSet is
+     * adopted.
+     */
+    unitSystem?: UnitSystemKey;
+}
 /** Describes one of potentially many [TextBlock]($common)s hosted by an [[ITextAnnotation]].
  * For example, a [[TextAnnotation2d]] hosts only a single text block, but an element representing a table may
  * host one text block for each cell in the table, in which case it might use the combination of row and column
@@ -66,9 +97,7 @@ export declare class ElementDrivesTextAnnotation extends ElementDrivesElement {
      * update when the source element changes.
      */
     static isSupportedForIModel(iModel: IModelDb): boolean;
-    /** Examines all of the [FieldRun]($common)s within the specified [[ITextAnnotation]] and ensures that the appropriate
-     * `ElementDrivesTextAnnotation` relationships exist between the fields' source elements and this target element.
-     * It also deletes any stale relationships left over from fields that were deleted or whose source elements changed.
+    /** Ensures the `ElementDrivesTextAnnotation` relationships for the [FieldRun]($common)s in the specified annotation are up to date.
      * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use ElementDrivesTextAnnotation.updateFieldDependencies(txn, ...) instead.
      */
     static updateFieldDependencies(annotationElementId: Id64String, iModel: IModelDb): void;
@@ -78,10 +107,66 @@ export declare class ElementDrivesTextAnnotation extends ElementDrivesElement {
      */
     static updateFieldDependencies(txn: EditTxn, annotationElementId: Id64String): void;
     /** Recompute the display strings of all [FieldRun]($common)s in a [TextBlock]($common).
+     *
+     * `"quantity"` and `"coordinate"` fields are formatted through the FormatSets configured for
+     * `args.iModel` by [[registerFieldFormatting]], or otherwise through the format each
+     * KindOfQuantity's schema declares.
+     *
+     * A field whose format cannot be resolved falls back to `value.toString()` and is logged. A
+     * field whose property cannot be resolved, or whose format throws, is logged and rendered as
+     * [FieldRun.invalidContentIndicator]($common); one bad field does not abandon the rest of the
+     * block.
      * @returns the number of fields whose display strings were modified.
-     * @throws Error if evaluation of any field fails.
      */
     static evaluateFields(args: EvaluateFieldsArgs): number;
+    /** Configures how `"quantity"` and `"coordinate"` [FieldRun]($common)s in `args.iModel` are
+     * formatted by [[evaluateFields]] and by `TxnManager` field-update callbacks.
+     *
+     * Calling this is optional. An iModel with no registration formats every field using the
+     * presentation format its schema declares for the KindOfQuantity, in the metric unit system.
+     * Register to layer application [FormatSet]($ecschema-metadata)s over those schema defaults,
+     * or to select a different unit system. Formats resolve in this order:
+     *
+     *  1. The FormatSet named by the field's [QuantityFieldFormatOptions.formatSet]($common).
+     *  2. The FormatSet adopted for the iModel ([[FieldFormattingArgs.formatSet]]).
+     *  3. The KindOfQuantity's presentation format for [[FieldFormattingArgs.unitSystem]].
+     *  4. `value.toString()`, with a warning logged.
+     *
+     * Units resolve through the bundled BIS [BasicUnitsProvider]($core-quantity) only. A field
+     * whose persistence unit, or whose format's units, are defined solely by the iModel's own
+     * schemas falls to step 4.
+     *
+     * Pass the iModel-wide default as `formatSet` and any per-field alternatives as `formatSets`,
+     * keyed by the id that [FieldRun]($common)s name via
+     * [QuantityFieldFormatOptions.formatSet]($common):
+     *
+     * ```ts
+     * ElementDrivesTextAnnotation.registerFieldFormatting({
+     *   iModel,
+     *   formatSet: metricFormatSet,
+     *   formatSets: [{ id: imperialFormatSetId, formatSet: imperial }],
+     * });
+     * ```
+     *
+     * Each call replaces any prior registration for the same iModel; calling it with only
+     * `iModel` reverts to the schema defaults. Registering does not re-evaluate existing
+     * annotations; listen to [[onFieldFormattingChanged]] to do so. The registration lives as long
+     * as the `IModelDb` object and is released with it.
+     * @see [Quantity formatting for text annotation fields]($docs/learning/backend/TextAnnotationFields.md)
+     * @beta
+     */
+    static registerFieldFormatting(args: FieldFormattingArgs): void;
+    /** Raised after every [[registerFieldFormatting]] call, once the new configuration is in
+     * place, whether or not it differs from the previous one. Applications that cache formatted
+     * output, or that want to re-evaluate existing annotations against a newly adopted FormatSet,
+     * should listen here. A listener that throws does not undo the registration; its error is
+     * reported through [UnexpectedErrors]($bentley) rather than to the caller of
+     * `registerFieldFormatting`.
+     * @beta
+     */
+    static readonly onFieldFormattingChanged: BeEvent<(args: {
+        iModel: IModelDb;
+    }) => void>;
     /** When copying an [[ITextAnnotation]] from one iModel into another, remaps the element Ids in any [FieldPropertyHost]($common) within the cloned element
      * so that they refer to elements in the `context`'s target iModel, and sets any Ids that cannot be remapped to [Id64.invalid]($bentley).
      * Implementations of `ITextAnnotation` should invoke this function from their implementations of [[Element.onCloned]].

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

@@ -1 +1 @@
-{"version":3,"file":"ElementDrivesTextAnnotation.d.ts","sourceRoot":"","sources":["../../../src/annotations/ElementDrivesTextAnnotation.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAQ,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAe,cAAc,EAAE,SAAS,EAA8B,MAAM,oBAAoB,CAAC;AAExG,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,gIAAgI;IAChI,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAKD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,oCAAoC,CAAC;IACxD,sFAAsF;IACtF,aAAa,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC1C,mGAAmG;IACnG,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,eAAe,GAAG,OAAO,CAExF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,KAAK,EAAE,SAAS,CAAC;IACjB,oGAAoG;IACpG,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,qBAAa,2BAA4B,SAAQ,oBAAoB;IACnE,WAA2B,SAAS,IAAI,MAAM,CAA0C;IAExF,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAuE1C,gBAAgB;WACO,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAInE,gBAAgB;WACO,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAIzE;;;OAGG;WACW,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAI7D;;;;OAIG;WACW,uBAAuB,CAAC,mBAAmB,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI;IAE9F;;;OAGG;WACW,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,UAAU,GAAG,IAAI;IAU1F;;;OAGG;WACW,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM;IAI9D;;;OAGG;WACW,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI;CAwB5F;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,cAAc;IACtE,OAAc,aAAa,SAAkD;gBAC1D,qBAAqB,EAAE,UAAU,EAAE,YAAY,GAAE,MAA2D;CAGhI"}
+{"version":3,"file":"ElementDrivesTextAnnotation.d.ts","sourceRoot":"","sources":["../../../src/annotations/ElementDrivesTextAnnotation.ts"],"names":[],"mappings":"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"}

package/lib/cjs/annotations/ElementDrivesTextAnnotation.js

@@ -13,6 +13,7 @@ const core_bentley_1 = require("@itwin/core-bentley");
 const core_common_1 = require("@itwin/core-common");
 const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
 const fields_1 = require("../internal/annotations/fields");
+const fieldSpecs_1 = require("../internal/annotations/fieldSpecs");
 const Symbols_1 = require("../internal/Symbols");
 const Relationship_1 = require("../Relationship");
 const EditTxn_1 = require("../EditTxn");
@@ -114,12 +115,69 @@ class ElementDrivesTextAnnotation extends Relationship_1.ElementDrivesElement {
         this.updateFieldDependenciesImpl(arg2[Symbols_1._implicitTxn], arg1);
     }
     /** Recompute the display strings of all [FieldRun]($common)s in a [TextBlock]($common).
+     *
+     * `"quantity"` and `"coordinate"` fields are formatted through the FormatSets configured for
+     * `args.iModel` by [[registerFieldFormatting]], or otherwise through the format each
+     * KindOfQuantity's schema declares.
+     *
+     * A field whose format cannot be resolved falls back to `value.toString()` and is logged. A
+     * field whose property cannot be resolved, or whose format throws, is logged and rendered as
+     * [FieldRun.invalidContentIndicator]($common); one bad field does not abandon the rest of the
+     * block.
      * @returns the number of fields whose display strings were modified.
-     * @throws Error if evaluation of any field fails.
      */
     static evaluateFields(args) {
         return (0, fields_1.updateFields)(args.block, (0, fields_1.createUpdateContext)(undefined, args.iModel, false));
     }
+    /** Configures how `"quantity"` and `"coordinate"` [FieldRun]($common)s in `args.iModel` are
+     * formatted by [[evaluateFields]] and by `TxnManager` field-update callbacks.
+     *
+     * Calling this is optional. An iModel with no registration formats every field using the
+     * presentation format its schema declares for the KindOfQuantity, in the metric unit system.
+     * Register to layer application [FormatSet]($ecschema-metadata)s over those schema defaults,
+     * or to select a different unit system. Formats resolve in this order:
+     *
+     *  1. The FormatSet named by the field's [QuantityFieldFormatOptions.formatSet]($common).
+     *  2. The FormatSet adopted for the iModel ([[FieldFormattingArgs.formatSet]]).
+     *  3. The KindOfQuantity's presentation format for [[FieldFormattingArgs.unitSystem]].
+     *  4. `value.toString()`, with a warning logged.
+     *
+     * Units resolve through the bundled BIS [BasicUnitsProvider]($core-quantity) only. A field
+     * whose persistence unit, or whose format's units, are defined solely by the iModel's own
+     * schemas falls to step 4.
+     *
+     * Pass the iModel-wide default as `formatSet` and any per-field alternatives as `formatSets`,
+     * keyed by the id that [FieldRun]($common)s name via
+     * [QuantityFieldFormatOptions.formatSet]($common):
+     *
+     * ```ts
+     * ElementDrivesTextAnnotation.registerFieldFormatting({
+     *   iModel,
+     *   formatSet: metricFormatSet,
+     *   formatSets: [{ id: imperialFormatSetId, formatSet: imperial }],
+     * });
+     * ```
+     *
+     * Each call replaces any prior registration for the same iModel; calling it with only
+     * `iModel` reverts to the schema defaults. Registering does not re-evaluate existing
+     * annotations; listen to [[onFieldFormattingChanged]] to do so. The registration lives as long
+     * as the `IModelDb` object and is released with it.
+     * @see [Quantity formatting for text annotation fields]($docs/learning/backend/TextAnnotationFields.md)
+     * @beta
+     */
+    static registerFieldFormatting(args) {
+        (0, fieldSpecs_1.setFieldFormatting)(args.iModel, (0, fieldSpecs_1.createFieldFormatting)(args));
+        this.onFieldFormattingChanged.raiseEvent({ iModel: args.iModel });
+    }
+    /** Raised after every [[registerFieldFormatting]] call, once the new configuration is in
+     * place, whether or not it differs from the previous one. Applications that cache formatted
+     * output, or that want to re-evaluate existing annotations against a newly adopted FormatSet,
+     * should listen here. A listener that throws does not undo the registration; its error is
+     * reported through [UnexpectedErrors]($bentley) rather than to the caller of
+     * `registerFieldFormatting`.
+     * @beta
+     */
+    static onFieldFormattingChanged = new core_bentley_1.BeEvent();
     /** When copying an [[ITextAnnotation]] from one iModel into another, remaps the element Ids in any [FieldPropertyHost]($common) within the cloned element
      * so that they refer to elements in the `context`'s target iModel, and sets any Ids that cannot be remapped to [Id64.invalid]($bentley).
      * Implementations of `ITextAnnotation` should invoke this function from their implementations of [[Element.onCloned]].

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

@@ -1 +1 @@
-{"version":3,"file":"ElementDrivesTextAnnotation.js","sourceRoot":"","sources":["../../../src/annotations/ElementDrivesTextAnnotation.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Elements\r\n */\r\n\r\nimport { Id64, Id64String } from \"@itwin/core-bentley\";\r\nimport { QueryBinder, RelatedElement, TextBlock, traverseTextBlockComponent } from \"@itwin/core-common\";\r\nimport { ECVersion } from \"@itwin/ecschema-metadata\";\r\nimport { Element } from \"../Element\";\r\nimport { IModelDb } from \"../IModelDb\";\r\nimport { IModelElementCloneContext } from \"../IModelElementCloneContext\";\r\nimport { createUpdateContext, updateAllFields, updateElementFields, updateFields } from \"../internal/annotations/fields\";\r\nimport { _implicitTxn } from \"../internal/Symbols\";\r\nimport { ElementDrivesElement, OnDependencyArg } from \"../Relationship\";\r\nimport { EditTxn } from \"../EditTxn\";\r\n\r\n/** Describes one of potentially many [TextBlock]($common)s hosted by an [[ITextAnnotation]].\r\n * For example, a [[TextAnnotation2d]] hosts only a single text block, but an element representing a table may\r\n * host one text block for each cell in the table, in which case it might use the combination of row and column\r\n * as the [[id]] for each text block.\r\n * @beta\r\n */\r\nexport interface TextBlockAndId {\r\n  /** The text block. */\r\n  readonly textBlock: TextBlock;\r\n  /** An opaque identifier that allows the [[ITextAnnotation]] to discern which of its hosted text blocks is being referred to. */\r\n  readonly id: unknown;\r\n}\r\n\r\n// ElementDrivesTextAnnotation was introduced in this version of BisCore - iModels with earlier versions cannot support field dependencies.\r\nconst minBisCoreVersion = new ECVersion(1, 0, 22);\r\n\r\n/** Interface implemented by [[GeometricElement]] subclasses whose schemas declare them to implement the mix-in `BisCore:ITextAnnotation`.\r\n * Such elements may host any number of [TextBlock]($common)s. `ITextAnnotation` provides a uniform way to interact with text regardless of\r\n * the type of element to which it belongs.\r\n * @beta\r\n */\r\nexport interface ITextAnnotation {\r\n  /** The default [[AnnotationTextStyle]] used by the text annotation. */\r\n  defaultTextStyle?: TextAnnotationUsesTextStyleByDefault;\r\n  /** Obtain a collection of all of the [TextBlock]($common)s hosted by this element. */\r\n  getTextBlocks(): Iterable<TextBlockAndId>;\r\n  /** Update the element in-memory to replace the contents of the specified [TextBlock]($common)s. */\r\n  updateTextBlocks(textBlocks: TextBlockAndId[]): void;\r\n}\r\n\r\n/** Returns `true` if the specified `element` implements [[ITextAnnotation]].\r\n * @beta\r\n */\r\nexport function isITextAnnotation(element: Element): element is ITextAnnotation & Element {\r\n  return [\"getTextBlocks\", \"updateTextBlocks\"].every((x) => x in element && typeof (element as any)[x] === \"function\");\r\n}\r\n\r\n/** Arguments supplied to [[ElementDrivesTextAnnotation.evaluateFields]].\r\n * @beta\r\n */\r\nexport interface EvaluateFieldsArgs {\r\n  /** The text block whose fields are to be evaluated. */\r\n  block: TextBlock;\r\n  /** The iModel containing the elements supplying the display strings for the fields in [[block]]. */\r\n  iModel: IModelDb;\r\n}\r\n\r\n/** A relationship in which the source element hosts one or more properties that are displayed by a target [[ITextAnnotation]] element.\r\n * This relationship is used to automatically update the [FieldRun]($common)s contained in the target element when the source element is modified.\r\n * An [[ITextAnnotation]] element should invoke [[updateFieldDependencies]] from its [[Element.onInserted]] and [[Element.onUpdated]] functions to\r\n * establish or update the relationships required for the [FieldRun]($common)s it contains.\r\n * @note This relationship was introduced in version 01.00.22 of the BisCore schema. [FieldRun]($common)s created in iModels that have not been upgraded to\r\n * that version or newer will not automatically update. Use [[isSupportedForIModel]] to check.\r\n * @beta\r\n */\r\nexport class ElementDrivesTextAnnotation extends ElementDrivesElement {\r\n  public static override get className(): string { return \"ElementDrivesTextAnnotation\"; }\r\n\r\n  private static updateFieldDependenciesImpl(txn: EditTxn, annotationElementId: Id64String): void {\r\n    const iModel = txn.iModel;\r\n    const annotationElement = iModel.elements.tryGetElement<Element>(annotationElementId);\r\n    if (!annotationElement || !isITextAnnotation(annotationElement)) {\r\n      return;\r\n    }\r\n\r\n    // The native layer will allow us to insert relationships to invalid or non-existent source elements...errors will arise later. Prevent it.\r\n    function isValidSourceId(id: Id64String): boolean {\r\n      if (!Id64.isValidId64(id)) {\r\n        return false;\r\n      }\r\n\r\n      return iModel.withQueryReader(\"SELECT CodeValue FROM BisCore.Element WHERE ECInstanceId=?\", (reader): boolean => {\r\n        return reader.step();\r\n      }, new QueryBinder().bindId(1, id));\r\n    }\r\n\r\n    const sourceToRelationship = new Map<Id64String, Id64String | null>();\r\n    const blocks = annotationElement.getTextBlocks();\r\n\r\n    let haveFields = false;\r\n    for (const block of blocks) {\r\n      for (const { child } of traverseTextBlockComponent(block.textBlock)) {\r\n        if (child.type === \"field\") {\r\n          haveFields = true;\r\n          if (isValidSourceId(child.propertyHost.elementId)) {\r\n            sourceToRelationship.set(child.propertyHost.elementId, null);\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    if (haveFields) {\r\n      iModel.requireMinimumSchemaVersion(\"BisCore\", minBisCoreVersion, \"Text fields\");\r\n      updateAllFields(annotationElementId, txn);\r\n    }\r\n\r\n    const staleRelationships = new Set<Id64String>();\r\n    if (this.isSupportedForIModel(iModel)) {\r\n      annotationElement.iModel.withQueryReader(\r\n        \"SELECT ECInstanceId, SourceECInstanceId FROM BisCore.ElementDrivesTextAnnotation WHERE TargetECInstanceId=:targetId\",\r\n        (reader) => {\r\n          for (const row of reader) {\r\n            const relationshipId: Id64String = row[0];\r\n            const sourceId: Id64String = row[1];\r\n            if (sourceToRelationship.has(sourceId)) {\r\n              sourceToRelationship.set(sourceId, relationshipId);\r\n            } else {\r\n              staleRelationships.add(relationshipId);\r\n            }\r\n          }\r\n        },\r\n        new QueryBinder().bindId(\"targetId\", annotationElement.id),\r\n      );\r\n    }\r\n\r\n    for (const [sourceId, relationshipId] of sourceToRelationship) {\r\n      if (relationshipId === null) {\r\n        txn.insertRelationship(ElementDrivesTextAnnotation.create(annotationElement.iModel, sourceId, annotationElement.id).toJSON());\r\n      }\r\n    }\r\n\r\n    if (staleRelationships.size > 0) {\r\n      const staleRelationshipProps = Array.from(staleRelationships).map((relationshipId) =>\r\n        annotationElement.iModel.relationships.getInstanceProps(\"BisCore.ElementDrivesTextAnnotation\", relationshipId)\r\n      );\r\n      txn.deleteRelationships(staleRelationshipProps);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static override onRootChangedArg(arg: OnDependencyArg): void {\r\n    updateElementFields(arg.props, arg.indirectEditTxn, false);\r\n  }\r\n\r\n  /** @internal */\r\n  public static override onDeletedDependencyArg(arg: OnDependencyArg): void {\r\n    updateElementFields(arg.props, arg.indirectEditTxn, true);\r\n  }\r\n\r\n  /** Returns true if `iModel` contains a version of the BisCore schema new enough to support this relationship.\r\n   * If not, the schema should be updated before inserting any [FieldRun]($common)s, or those runs will not\r\n   * update when the source element changes.\r\n   */\r\n  public static isSupportedForIModel(iModel: IModelDb): boolean {\r\n    return iModel.meetsMinimumSchemaVersion(\"BisCore\", minBisCoreVersion);\r\n  }\r\n\r\n  /** Examines all of the [FieldRun]($common)s within the specified [[ITextAnnotation]] and ensures that the appropriate\r\n   * `ElementDrivesTextAnnotation` relationships exist between the fields' source elements and this target element.\r\n   * It also deletes any stale relationships left over from fields that were deleted or whose source elements changed.\r\n   * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use ElementDrivesTextAnnotation.updateFieldDependencies(txn, ...) instead.\r\n   */\r\n  public static updateFieldDependencies(annotationElementId: Id64String, iModel: IModelDb): void;\r\n\r\n  /** Examines all of the [FieldRun]($common)s within the specified [[ITextAnnotation]] and ensures that the appropriate\r\n   * `ElementDrivesTextAnnotation` relationships exist between the fields' source elements and this target element.\r\n   * It also deletes any stale relationships left over from fields that were deleted or whose source elements changed.\r\n   */\r\n  public static updateFieldDependencies(txn: EditTxn, annotationElementId: Id64String): void;\r\n  public static updateFieldDependencies(arg1: EditTxn | Id64String, arg2: Id64String | IModelDb): void {\r\n    if (arg1 instanceof EditTxn) {\r\n      this.updateFieldDependenciesImpl(arg1, arg2 as Id64String);\r\n      return;\r\n    }\r\n\r\n    this.updateFieldDependenciesImpl((arg2 as IModelDb)[_implicitTxn], arg1);\r\n  }\r\n\r\n  /** Recompute the display strings of all [FieldRun]($common)s in a [TextBlock]($common).\r\n   * @returns the number of fields whose display strings were modified.\r\n   * @throws Error if evaluation of any field fails.\r\n   */\r\n  public static evaluateFields(args: EvaluateFieldsArgs): number {\r\n    return updateFields(args.block, createUpdateContext(undefined, args.iModel, false))\r\n  }\r\n\r\n  /** When copying an [[ITextAnnotation]] from one iModel into another, remaps the element Ids in any [FieldPropertyHost]($common) within the cloned element\r\n   * so that they refer to elements in the `context`'s target iModel, and sets any Ids that cannot be remapped to [Id64.invalid]($bentley).\r\n   * Implementations of `ITextAnnotation` should invoke this function from their implementations of [[Element.onCloned]].\r\n   */\r\n  public static remapFields(clone: ITextAnnotation, context: IModelElementCloneContext): void {\r\n    if (!context.isBetweenIModels) {\r\n      return;\r\n    }\r\n\r\n    const updatedBlocks = [];\r\n    for (const block of clone.getTextBlocks()) {\r\n      let anyUpdated = false;\r\n      for (const { child } of traverseTextBlockComponent(block.textBlock)) {\r\n        if (child.type === \"field\") {\r\n          child.propertyHost.elementId = context.findTargetElementId(child.propertyHost.elementId);\r\n          anyUpdated = true;\r\n        }\r\n      }\r\n\r\n      if (anyUpdated) {\r\n        updatedBlocks.push(block);\r\n      }\r\n    }\r\n\r\n    if (updatedBlocks.length > 0) {\r\n      clone.updateTextBlocks(updatedBlocks);\r\n    }\r\n  }\r\n}\r\n\r\n/** Relationship indicating that the [[AnnotationTextStyle]] is being used as the default style for the [[ITextAnnotation]].\r\n * @beta\r\n */\r\nexport class TextAnnotationUsesTextStyleByDefault extends RelatedElement {\r\n  public static classFullName = \"BisCore:TextAnnotationUsesTextStyleByDefault\";\r\n  public constructor(annotationTextStyleId: Id64String, relClassName: string = TextAnnotationUsesTextStyleByDefault.classFullName) {\r\n    super({ id: annotationTextStyleId, relClassName });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ElementDrivesTextAnnotation.js","sourceRoot":"","sources":["../../../src/annotations/ElementDrivesTextAnnotation.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Elements\r\n */\r\n\r\nimport { BeEvent, Id64, Id64String } from \"@itwin/core-bentley\";\r\nimport { QueryBinder, RelatedElement, TextBlock, traverseTextBlockComponent } from \"@itwin/core-common\";\r\nimport { UnitSystemKey } from \"@itwin/core-quantity\";\r\nimport { ECVersion, FormatSet } from \"@itwin/ecschema-metadata\";\r\nimport { Element } from \"../Element\";\r\nimport { IModelDb } from \"../IModelDb\";\r\nimport { IModelElementCloneContext } from \"../IModelElementCloneContext\";\r\nimport { createUpdateContext, updateAllFields, updateElementFields, updateFields } from \"../internal/annotations/fields\";\r\nimport { createFieldFormatting, setFieldFormatting } from \"../internal/annotations/fieldSpecs\";\r\nimport { _implicitTxn } from \"../internal/Symbols\";\r\nimport { ElementDrivesElement, OnDependencyArg } from \"../Relationship\";\r\nimport { EditTxn } from \"../EditTxn\";\r\n\r\n/** Configures how `\"quantity\"` and `\"coordinate\"` [FieldRun]($common)s in an iModel are\r\n * formatted. Passed to [[ElementDrivesTextAnnotation.registerFieldFormatting]].\r\n * @beta\r\n */\r\nexport interface FieldFormattingArgs {\r\n  /** The iModel whose annotations this configuration formats. Its `schemaContext` supplies the\r\n   * KindOfQuantity presentation formats that every FormatSet falls back to.\r\n   */\r\n  iModel: IModelDb;\r\n  /** The FormatSet adopted for this iModel. It applies to every [FieldRun]($common) that does\r\n   * not name a different one via [QuantityFieldFormatOptions.formatSet]($common), and takes\r\n   * precedence over the schema's own presentation formats.\r\n   */\r\n  formatSet?: FormatSet;\r\n  /** Additional FormatSets addressable per-field, each paired with the id that\r\n   * [FieldRun]($common)s reference via [QuantityFieldFormatOptions.formatSet]($common).\r\n   * The id must be unique; if two entries share an id the last one wins. A field naming an id\r\n   * absent from this list falls back to [[formatSet]].\r\n   */\r\n  formatSets?: ReadonlyArray<{ id: string, formatSet: FormatSet }>;\r\n  /** Unit system used to pick a KindOfQuantity's presentation format when the schema offers\r\n   * several. Defaults to [[formatSet]]'s own `unitSystem`, or `\"metric\"` when no FormatSet is\r\n   * adopted.\r\n   */\r\n  unitSystem?: UnitSystemKey;\r\n}\r\n\r\n/** Describes one of potentially many [TextBlock]($common)s hosted by an [[ITextAnnotation]].\r\n * For example, a [[TextAnnotation2d]] hosts only a single text block, but an element representing a table may\r\n * host one text block for each cell in the table, in which case it might use the combination of row and column\r\n * as the [[id]] for each text block.\r\n * @beta\r\n */\r\nexport interface TextBlockAndId {\r\n  /** The text block. */\r\n  readonly textBlock: TextBlock;\r\n  /** An opaque identifier that allows the [[ITextAnnotation]] to discern which of its hosted text blocks is being referred to. */\r\n  readonly id: unknown;\r\n}\r\n\r\n// ElementDrivesTextAnnotation was introduced in this version of BisCore - iModels with earlier versions cannot support field dependencies.\r\nconst minBisCoreVersion = new ECVersion(1, 0, 22);\r\n\r\n/** Interface implemented by [[GeometricElement]] subclasses whose schemas declare them to implement the mix-in `BisCore:ITextAnnotation`.\r\n * Such elements may host any number of [TextBlock]($common)s. `ITextAnnotation` provides a uniform way to interact with text regardless of\r\n * the type of element to which it belongs.\r\n * @beta\r\n */\r\nexport interface ITextAnnotation {\r\n  /** The default [[AnnotationTextStyle]] used by the text annotation. */\r\n  defaultTextStyle?: TextAnnotationUsesTextStyleByDefault;\r\n  /** Obtain a collection of all of the [TextBlock]($common)s hosted by this element. */\r\n  getTextBlocks(): Iterable<TextBlockAndId>;\r\n  /** Update the element in-memory to replace the contents of the specified [TextBlock]($common)s. */\r\n  updateTextBlocks(textBlocks: TextBlockAndId[]): void;\r\n}\r\n\r\n/** Returns `true` if the specified `element` implements [[ITextAnnotation]].\r\n * @beta\r\n */\r\nexport function isITextAnnotation(element: Element): element is ITextAnnotation & Element {\r\n  return [\"getTextBlocks\", \"updateTextBlocks\"].every((x) => x in element && typeof (element as any)[x] === \"function\");\r\n}\r\n\r\n/** Arguments supplied to [[ElementDrivesTextAnnotation.evaluateFields]].\r\n * @beta\r\n */\r\nexport interface EvaluateFieldsArgs {\r\n  /** The text block whose fields are to be evaluated. */\r\n  block: TextBlock;\r\n  /** The iModel containing the elements supplying the display strings for the fields in [[block]]. */\r\n  iModel: IModelDb;\r\n}\r\n\r\n/** A relationship in which the source element hosts one or more properties that are displayed by a target [[ITextAnnotation]] element.\r\n * This relationship is used to automatically update the [FieldRun]($common)s contained in the target element when the source element is modified.\r\n * An [[ITextAnnotation]] element should invoke [[updateFieldDependencies]] from its [[Element.onInserted]] and [[Element.onUpdated]] functions to\r\n * establish or update the relationships required for the [FieldRun]($common)s it contains.\r\n * @note This relationship was introduced in version 01.00.22 of the BisCore schema. [FieldRun]($common)s created in iModels that have not been upgraded to\r\n * that version or newer will not automatically update. Use [[isSupportedForIModel]] to check.\r\n * @beta\r\n */\r\nexport class ElementDrivesTextAnnotation extends ElementDrivesElement {\r\n  public static override get className(): string { return \"ElementDrivesTextAnnotation\"; }\r\n\r\n  private static updateFieldDependenciesImpl(txn: EditTxn, annotationElementId: Id64String): void {\r\n    const iModel = txn.iModel;\r\n    const annotationElement = iModel.elements.tryGetElement<Element>(annotationElementId);\r\n    if (!annotationElement || !isITextAnnotation(annotationElement)) {\r\n      return;\r\n    }\r\n\r\n    // The native layer will allow us to insert relationships to invalid or non-existent source elements...errors will arise later. Prevent it.\r\n    function isValidSourceId(id: Id64String): boolean {\r\n      if (!Id64.isValidId64(id)) {\r\n        return false;\r\n      }\r\n\r\n      return iModel.withQueryReader(\"SELECT CodeValue FROM BisCore.Element WHERE ECInstanceId=?\", (reader): boolean => {\r\n        return reader.step();\r\n      }, new QueryBinder().bindId(1, id));\r\n    }\r\n\r\n    const sourceToRelationship = new Map<Id64String, Id64String | null>();\r\n    const blocks = annotationElement.getTextBlocks();\r\n\r\n    let haveFields = false;\r\n    for (const block of blocks) {\r\n      for (const { child } of traverseTextBlockComponent(block.textBlock)) {\r\n        if (child.type === \"field\") {\r\n          haveFields = true;\r\n          if (isValidSourceId(child.propertyHost.elementId)) {\r\n            sourceToRelationship.set(child.propertyHost.elementId, null);\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    if (haveFields) {\r\n      iModel.requireMinimumSchemaVersion(\"BisCore\", minBisCoreVersion, \"Text fields\");\r\n      updateAllFields(annotationElementId, txn);\r\n    }\r\n\r\n    const staleRelationships = new Set<Id64String>();\r\n    if (this.isSupportedForIModel(iModel)) {\r\n      annotationElement.iModel.withQueryReader(\r\n        \"SELECT ECInstanceId, SourceECInstanceId FROM BisCore.ElementDrivesTextAnnotation WHERE TargetECInstanceId=:targetId\",\r\n        (reader) => {\r\n          for (const row of reader) {\r\n            const relationshipId: Id64String = row[0];\r\n            const sourceId: Id64String = row[1];\r\n            if (sourceToRelationship.has(sourceId)) {\r\n              sourceToRelationship.set(sourceId, relationshipId);\r\n            } else {\r\n              staleRelationships.add(relationshipId);\r\n            }\r\n          }\r\n        },\r\n        new QueryBinder().bindId(\"targetId\", annotationElement.id),\r\n      );\r\n    }\r\n\r\n    for (const [sourceId, relationshipId] of sourceToRelationship) {\r\n      if (relationshipId === null) {\r\n        txn.insertRelationship(ElementDrivesTextAnnotation.create(annotationElement.iModel, sourceId, annotationElement.id).toJSON());\r\n      }\r\n    }\r\n\r\n    if (staleRelationships.size > 0) {\r\n      const staleRelationshipProps = Array.from(staleRelationships).map((relationshipId) =>\r\n        annotationElement.iModel.relationships.getInstanceProps(\"BisCore.ElementDrivesTextAnnotation\", relationshipId)\r\n      );\r\n      txn.deleteRelationships(staleRelationshipProps);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static override onRootChangedArg(arg: OnDependencyArg): void {\r\n    updateElementFields(arg.props, arg.indirectEditTxn, false);\r\n  }\r\n\r\n  /** @internal */\r\n  public static override onDeletedDependencyArg(arg: OnDependencyArg): void {\r\n    updateElementFields(arg.props, arg.indirectEditTxn, true);\r\n  }\r\n\r\n  /** Returns true if `iModel` contains a version of the BisCore schema new enough to support this relationship.\r\n   * If not, the schema should be updated before inserting any [FieldRun]($common)s, or those runs will not\r\n   * update when the source element changes.\r\n   */\r\n  public static isSupportedForIModel(iModel: IModelDb): boolean {\r\n    return iModel.meetsMinimumSchemaVersion(\"BisCore\", minBisCoreVersion);\r\n  }\r\n\r\n  /** Ensures the `ElementDrivesTextAnnotation` relationships for the [FieldRun]($common)s in the specified annotation are up to date.\r\n   * @deprecated in 5.9.0 - will not be removed until after 2027-05-04. Use ElementDrivesTextAnnotation.updateFieldDependencies(txn, ...) instead.\r\n   */\r\n  public static updateFieldDependencies(annotationElementId: Id64String, iModel: IModelDb): void;\r\n\r\n  /** Examines all of the [FieldRun]($common)s within the specified [[ITextAnnotation]] and ensures that the appropriate\r\n   * `ElementDrivesTextAnnotation` relationships exist between the fields' source elements and this target element.\r\n   * It also deletes any stale relationships left over from fields that were deleted or whose source elements changed.\r\n   */\r\n  public static updateFieldDependencies(txn: EditTxn, annotationElementId: Id64String): void;\r\n  public static updateFieldDependencies(arg1: EditTxn | Id64String, arg2: Id64String | IModelDb): void {\r\n    if (arg1 instanceof EditTxn) {\r\n      this.updateFieldDependenciesImpl(arg1, arg2 as Id64String);\r\n      return;\r\n    }\r\n\r\n    this.updateFieldDependenciesImpl((arg2 as IModelDb)[_implicitTxn], arg1);\r\n  }\r\n\r\n  /** Recompute the display strings of all [FieldRun]($common)s in a [TextBlock]($common).\r\n   *\r\n   * `\"quantity\"` and `\"coordinate\"` fields are formatted through the FormatSets configured for\r\n   * `args.iModel` by [[registerFieldFormatting]], or otherwise through the format each\r\n   * KindOfQuantity's schema declares.\r\n   *\r\n   * A field whose format cannot be resolved falls back to `value.toString()` and is logged. A\r\n   * field whose property cannot be resolved, or whose format throws, is logged and rendered as\r\n   * [FieldRun.invalidContentIndicator]($common); one bad field does not abandon the rest of the\r\n   * block.\r\n   * @returns the number of fields whose display strings were modified.\r\n   */\r\n  public static evaluateFields(args: EvaluateFieldsArgs): number {\r\n    return updateFields(args.block, createUpdateContext(undefined, args.iModel, false));\r\n  }\r\n\r\n  /** Configures how `\"quantity\"` and `\"coordinate\"` [FieldRun]($common)s in `args.iModel` are\r\n   * formatted by [[evaluateFields]] and by `TxnManager` field-update callbacks.\r\n   *\r\n   * Calling this is optional. An iModel with no registration formats every field using the\r\n   * presentation format its schema declares for the KindOfQuantity, in the metric unit system.\r\n   * Register to layer application [FormatSet]($ecschema-metadata)s over those schema defaults,\r\n   * or to select a different unit system. Formats resolve in this order:\r\n   *\r\n   *  1. The FormatSet named by the field's [QuantityFieldFormatOptions.formatSet]($common).\r\n   *  2. The FormatSet adopted for the iModel ([[FieldFormattingArgs.formatSet]]).\r\n   *  3. The KindOfQuantity's presentation format for [[FieldFormattingArgs.unitSystem]].\r\n   *  4. `value.toString()`, with a warning logged.\r\n   *\r\n   * Units resolve through the bundled BIS [BasicUnitsProvider]($core-quantity) only. A field\r\n   * whose persistence unit, or whose format's units, are defined solely by the iModel's own\r\n   * schemas falls to step 4.\r\n   *\r\n   * Pass the iModel-wide default as `formatSet` and any per-field alternatives as `formatSets`,\r\n   * keyed by the id that [FieldRun]($common)s name via\r\n   * [QuantityFieldFormatOptions.formatSet]($common):\r\n   *\r\n   * ```ts\r\n   * ElementDrivesTextAnnotation.registerFieldFormatting({\r\n   *   iModel,\r\n   *   formatSet: metricFormatSet,\r\n   *   formatSets: [{ id: imperialFormatSetId, formatSet: imperial }],\r\n   * });\r\n   * ```\r\n   *\r\n   * Each call replaces any prior registration for the same iModel; calling it with only\r\n   * `iModel` reverts to the schema defaults. Registering does not re-evaluate existing\r\n   * annotations; listen to [[onFieldFormattingChanged]] to do so. The registration lives as long\r\n   * as the `IModelDb` object and is released with it.\r\n   * @see [Quantity formatting for text annotation fields]($docs/learning/backend/TextAnnotationFields.md)\r\n   * @beta\r\n   */\r\n  public static registerFieldFormatting(args: FieldFormattingArgs): void {\r\n    setFieldFormatting(args.iModel, createFieldFormatting(args));\r\n    this.onFieldFormattingChanged.raiseEvent({ iModel: args.iModel });\r\n  }\r\n\r\n  /** Raised after every [[registerFieldFormatting]] call, once the new configuration is in\r\n   * place, whether or not it differs from the previous one. Applications that cache formatted\r\n   * output, or that want to re-evaluate existing annotations against a newly adopted FormatSet,\r\n   * should listen here. A listener that throws does not undo the registration; its error is\r\n   * reported through [UnexpectedErrors]($bentley) rather than to the caller of\r\n   * `registerFieldFormatting`.\r\n   * @beta\r\n   */\r\n  public static readonly onFieldFormattingChanged = new BeEvent<(args: { iModel: IModelDb }) => void>();\r\n\r\n  /** When copying an [[ITextAnnotation]] from one iModel into another, remaps the element Ids in any [FieldPropertyHost]($common) within the cloned element\r\n   * so that they refer to elements in the `context`'s target iModel, and sets any Ids that cannot be remapped to [Id64.invalid]($bentley).\r\n   * Implementations of `ITextAnnotation` should invoke this function from their implementations of [[Element.onCloned]].\r\n   */\r\n  public static remapFields(clone: ITextAnnotation, context: IModelElementCloneContext): void {\r\n    if (!context.isBetweenIModels) {\r\n      return;\r\n    }\r\n\r\n    const updatedBlocks = [];\r\n    for (const block of clone.getTextBlocks()) {\r\n      let anyUpdated = false;\r\n      for (const { child } of traverseTextBlockComponent(block.textBlock)) {\r\n        if (child.type === \"field\") {\r\n          child.propertyHost.elementId = context.findTargetElementId(child.propertyHost.elementId);\r\n          anyUpdated = true;\r\n        }\r\n      }\r\n\r\n      if (anyUpdated) {\r\n        updatedBlocks.push(block);\r\n      }\r\n    }\r\n\r\n    if (updatedBlocks.length > 0) {\r\n      clone.updateTextBlocks(updatedBlocks);\r\n    }\r\n  }\r\n}\r\n\r\n/** Relationship indicating that the [[AnnotationTextStyle]] is being used as the default style for the [[ITextAnnotation]].\r\n * @beta\r\n */\r\nexport class TextAnnotationUsesTextStyleByDefault extends RelatedElement {\r\n  public static classFullName = \"BisCore:TextAnnotationUsesTextStyleByDefault\";\r\n  public constructor(annotationTextStyleId: Id64String, relClassName: string = TextAnnotationUsesTextStyleByDefault.classFullName) {\r\n    super({ id: annotationTextStyleId, relClassName });\r\n  }\r\n}\r\n"]}

package/lib/cjs/internal/IntegrityCheck.d.ts

@@ -96,117 +96,174 @@ type IntegrityCheckResultRow<K extends IntegrityCheckKey> = IntegrityCheckResult
  * Return type for quick integrity check
  */
 export interface QuickIntegrityCheckResultRow {
+    /** Name of the integrity check. */
     check: string;
+    /** Whether the check passed. Quick checks do not include problem details. */
     passed: boolean;
+    /** Elapsed time for the check, in seconds. */
     elapsedSeconds: string;
 }
 /**
  * Return type for Check Data Columns integrity check
  */
 export interface CheckDataColumnsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** Mapped data table containing a missing column. */
     table: string;
+    /** Name of the missing nonvirtual physical column. */
     column: string;
 }
 /**
  * Return type for Check EC Profile integrity check
  */
 export interface CheckECProfileResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** Type of EC profile object, such as a table, index, or iModel trigger. */
     type: string;
+    /** Name of the EC profile object. */
     name: string;
+    /** Description of the missing or mismatching object definition. */
     issue: string;
 }
 /**
  * Return type for Check Navigation Class Ids integrity check
  */
 export interface CheckNavClassIdsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** ID of the source instance row containing the navigation property. */
     id: string;
+    /** Declaring or scanned class for the source row; rows from derived classes may be included. */
     class: string;
+    /** Name of the navigation property. */
     property: string;
+    /** ID of the referenced instance stored by the navigation property. */
     navId: string;
+    /** Relationship class ID stored by the navigation property, not the target instance class ID. */
     navClassId: string;
 }
 /**
  * Return type for Check Navigation Ids integrity check
  */
 export interface CheckNavIdsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** ID of the source instance row containing the navigation property. */
     id: string;
+    /** Declaring or scanned class for the source row; rows from derived classes may be included. */
     class: string;
+    /** Name of the navigation property. */
     property: string;
+    /** ID of the referenced instance stored by the navigation property. */
     navId: string;
+    /** Class queried for the referenced row: the first relationship constraint class in the navigation direction, including derived classes. */
     primaryClass: string;
 }
 /**
  * Return type for Check Link Table Foreign Key Class Ids integrity check
  */
 export interface CheckLinkTableFkClassIdsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** ID of the relationship row containing the foreign key. */
     id: string;
+    /** Link-table relationship class. */
     relationship: string;
+    /** Endpoint class-ID property: SourceECClassId or TargetECClassId. */
     property: string;
+    /** Source or target endpoint instance ID stored in the link table. */
     keyId: string;
+    /** Source or target endpoint class ID; the check verifies that the class exists. */
     keyClassId: string;
 }
 /**
  * Return type for Check Link Table Foreign Key Ids integrity check
  */
 export interface CheckLinkTableFkIdsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** ID of the relationship row containing the foreign key. */
     id: string;
+    /** Link-table relationship class. */
     relationship: string;
+    /** Endpoint instance-ID property: SourceECInstanceId or TargetECInstanceId. */
     property: string;
+    /** Source or target endpoint instance ID stored in the link table. */
     keyId: string;
+    /** Class queried for the referenced endpoint row: the first endpoint constraint class, including derived classes. */
     primaryClass: string;
 }
 /**
  * Return type for Check Class Ids integrity check
  */
 export interface CheckClassIdsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** Declaring or scanned class for the row; rows from derived classes may be included. */
     class: string;
+    /** ECInstanceId for primary/joined results, or the physical RowId for overflow results. */
     id: string;
+    /** Persisted ECClassId value with no matching class definition. */
     classId: string;
+    /** Check category: "primary", "joined", or "overflow". */
     type: string;
 }
 /**
  * Return type for Check Data Schema integrity check
  */
 export interface CheckDataSchemaResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** Type of missing mapped schema object, such as a table or index. */
     type: string;
+    /** Name of the missing mapped schema object. */
     name: string;
 }
 /**
  * Return type for Check Schema Load integrity check
  */
 export interface CheckSchemaLoadResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** Name of the schema that the schema manager could not load. */
     schema: string;
 }
 /**
  * Return type for Check Missing Child Rows integrity check
  */
 export interface CheckMissingChildRowsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** Class used to identify the checked rows: "BisCore:Element". */
     class: string;
+    /** ID of the existing bis_Element row missing a required child row. */
     id: string;
+    /** Persisted ECClassId of the existing element row. */
     classId: string;
+    /** Comma-separated names of all child tables checked for the row, not only tables with a missing child row. */
     missingRowInTables: string;
 }
 /**
  * Return type for Check Diverged Property Maps integrity check
  */
 export interface CheckDivergedPropMapsResultRow {
+    /** Sequential result row number. */
     sno: number;
+    /** ID of the derived class whose inherited property map diverges. */
     derivedClassId: Id64String;
+    /** Name of the derived class whose inherited property map diverges. */
     derivedClassName: string;
+    /** ID of the base class whose mapping was compared with the derived class. */
     baseClassId: Id64String;
+    /** Name of the base class whose mapping was compared with the derived class. */
     baseClassName: string;
+    /** Access path of the inherited property with different column mappings. */
     propertyName: string;
+    /** Base class mapping, formatted as table.column. */
     baseColumn: string;
+    /** Derived class mapping, formatted as table.column. */
     divergedColumn: string;
 }
 /**

package/lib/cjs/internal/IntegrityCheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IntegrityCheck.d.ts","sourceRoot":"","sources":["../../../src/internal/IntegrityCheck.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IntegrityCheck.d.ts","sourceRoot":"","sources":["../../../src/internal/IntegrityCheck.ts"],"names":[],"mappings":"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"}