@itwin/core-frontend 5.13.0-dev.9 → 5.14.0-dev.2

package/CHANGELOG.md

@@ -1,6 +1,33 @@
 # Change Log - @itwin/core-frontend
 
-This log was last generated on Mon, 03 Aug 2026 12:28:16 GMT and should not be manually modified.
+This log was last generated on Tue, 25 Aug 2026 21:23:35 GMT and should not be manually modified.
+
+## 5.12.5
+Tue, 25 Aug 2026 21:22:08 GMT
+
+### Updates
+
+- Fix OPC point clouds whose CRS has no vertical datum displaying offset vertically by the geoid-ellipsoid separation: their heights are now treated as orthometric.
+
+## 5.12.4
+Tue, 18 Aug 2026 15:45:35 GMT
+
+_Version update only_
+
+## 5.12.3
+Mon, 17 Aug 2026 11:29:39 GMT
+
+_Version update only_
+
+## 5.12.2
+Mon, 10 Aug 2026 20:38:45 GMT
+
+_Version update only_
+
+## 5.12.1
+Mon, 10 Aug 2026 19:07:26 GMT
+
+_Version update only_
 
 ## 5.12.0
 Mon, 03 Aug 2026 12:25:49 GMT
@@ -14,6 +41,13 @@ Mon, 03 Aug 2026 12:25:49 GMT
 - Fix changeset not being updated and onChangesetChanged not being fired after BriefcaseConnection.pushChanges
 - Add filtering support to SchemaView and improve performance.
 
+## 5.11.4
+Tue, 25 Aug 2026 19:54:22 GMT
+
+### Updates
+
+- Fix OPC point clouds whose CRS has no vertical datum displaying offset vertically by the geoid-ellipsoid separation: their heights are now treated as orthometric.
+
 ## 5.11.3
 Wed, 15 Jul 2026 19:40:44 GMT
 

package/lib/cjs/BriefcaseTxns.d.ts

@@ -29,10 +29,19 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
     /** @internal */
     get briefcaseChannelName(): "itwinjs-core/txns";
     /** Event raised after Txn validation or changeset application to indicate the set of changed elements.
+     * Each [[TxnEntityChange]] exposes its class through `metadata.classFullName`. Use [[TxnEntityChanges.filter]] with `metadata.is` to match a class or one of its subclasses.
+     * @example
+     * ```ts
+     * iModel.txns.onElementsChanged.addListener((changes) => {
+     *   for (const change of changes.filter({ includeMetadata: (metadata) => metadata.is("BisCore:GeometricElement") }))
+     *     updateElement(change.id);
+     * });
+     * ```
      * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.
      */
     readonly onElementsChanged: BeEvent<(changes: TxnEntityChanges) => void>;
     /** Event raised after Txn validation or changeset application to indicate the set of changed models.
+     * Each [[TxnEntityChange]] exposes its class through `metadata.classFullName`. Use [[TxnEntityChanges.filter]] with `metadata.is` to match a class or one of its subclasses.
      * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.
      */
     readonly onModelsChanged: BeEvent<(changes: TxnEntityChanges) => void>;

package/lib/cjs/BriefcaseTxns.d.ts.map

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

package/lib/cjs/BriefcaseTxns.js

@@ -40,10 +40,19 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
         return core_common_1.ipcAppChannels.txns;
     }
     /** Event raised after Txn validation or changeset application to indicate the set of changed elements.
+     * Each [[TxnEntityChange]] exposes its class through `metadata.classFullName`. Use [[TxnEntityChanges.filter]] with `metadata.is` to match a class or one of its subclasses.
+     * @example
+     * ```ts
+     * iModel.txns.onElementsChanged.addListener((changes) => {
+     *   for (const change of changes.filter({ includeMetadata: (metadata) => metadata.is("BisCore:GeometricElement") }))
+     *     updateElement(change.id);
+     * });
+     * ```
      * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.
      */
     onElementsChanged = new core_bentley_1.BeEvent();
     /** Event raised after Txn validation or changeset application to indicate the set of changed models.
+     * Each [[TxnEntityChange]] exposes its class through `metadata.classFullName`. Use [[TxnEntityChanges.filter]] with `metadata.is` to match a class or one of its subclasses.
      * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.
      */
     onModelsChanged = new core_bentley_1.BeEvent();

package/lib/cjs/BriefcaseTxns.js.map

@@ -1 +1 @@
-{"version":3,"file":"BriefcaseTxns.js","sourceRoot":"","sources":["../../src/BriefcaseTxns.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 IModelConnection\r\n */\r\n\r\nimport { BeEvent, IModelStatus } from \"@itwin/core-bentley\";\r\nimport {\r\n  ChangesetIdWithIndex,\r\n  ChangesetIndexAndId, ChangesetProps, EcefLocation, EcefLocationProps, GeographicCRS, GeographicCRSProps, ipcAppChannels,\r\n  ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, RootSubjectProps, TxnNotifications,\r\n  TxnProps,\r\n} from \"@itwin/core-common\";\r\nimport { Point3d, Range3d, Range3dProps, XYZProps } from \"@itwin/core-geometry\";\r\nimport { BriefcaseConnection } from \"./BriefcaseConnection\";\r\nimport { IpcApp, NotificationHandler } from \"./IpcApp\";\r\nimport { EntityChanges, TxnEntityChanges } from \"./TxnEntityChanges\";\r\n\r\n/**\r\n * Base class for notification handlers for events from the backend that are specific to a [[BriefcaseConnection]].\r\n * @see [[BriefcaseTxns]].\r\n * @public\r\n */\r\nexport abstract class BriefcaseNotificationHandler extends NotificationHandler {\r\n  constructor(private _key: string) { super(); }\r\n  public abstract get briefcaseChannelName(): string;\r\n  public get channelName() { return `${this.briefcaseChannelName}/${this._key}`; }\r\n}\r\n\r\n/** Manages local changes to a [[BriefcaseConnection]] via [Txns]($docs/learning/InteractiveEditing.md).\r\n * @see [[BriefcaseConnection.txns]].\r\n * @see [TxnManager]($backend) for the backend counterpart.\r\n * @public\r\n */\r\nexport class BriefcaseTxns extends BriefcaseNotificationHandler implements TxnNotifications {\r\n  private readonly _iModel: BriefcaseConnection;\r\n  private _cleanup?: RemoveFunction;\r\n\r\n  /** @internal */\r\n  public get briefcaseChannelName() {\r\n    return ipcAppChannels.txns;\r\n  }\r\n\r\n  /** Event raised after Txn validation or changeset application to indicate the set of changed elements.\r\n   * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onElementsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\r\n\r\n  /** Event raised after Txn validation or changeset application to indicate the set of changed models.\r\n   * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onModelsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\r\n\r\n  /** Event raised after the geometry within one or more [[GeometricModelState]]s is modified by applying a changeset or validation of a transaction.\r\n   * A model's geometry can change as a result of:\r\n   *  - Insertion or deletion of a geometric element within the model; or\r\n   *  - Modification of an existing element's geometric properties; or\r\n   *  - An explicit request to flag it as changed via [IModelDb.Models.updateModel]($backend).\r\n   */\r\n  public readonly onModelGeometryChanged = new BeEvent<(changes: ReadonlyArray<ModelIdAndGeometryGuid>) => void>();\r\n\r\n  /** Event raised before a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], unless there are no changes to save.\r\n   * @see [[onCommitted]] for the event raised after the operation.\r\n   */\r\n  public readonly onCommit = new BeEvent<() => void>();\r\n\r\n  /** Event raised after a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], even if there were no changes to save.\r\n   * The event supplies the following information:\r\n   *  - `hasPendingTxns`: true if the briefcase has local changes not yet pushed to the server.\r\n   *  - `time`: the time at which changes were saved on the backend (obtained via `Date.now()`).\r\n   * @see [[onCommit]] for the event raised before the operation.\r\n   */\r\n  public readonly onCommitted = new BeEvent<(hasPendingTxns: boolean, time: number) => void>();\r\n\r\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\r\n   * @see [[onReplayedExternalTxns]] for the event raised after all such changes have been applied.\r\n   */\r\n  public readonly onReplayExternalTxns = new BeEvent<() => void>();\r\n\r\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\r\n   * @see [[onReplayExternalTxns]] for the event raised before the changes are applied.\r\n   */\r\n  public readonly onReplayedExternalTxns = new BeEvent<() => void>();\r\n\r\n  /** Event raised after a changeset has been applied to the briefcase.\r\n   * Changesets may be applied as a result of [[BriefcaseConnection.pullChanges]], or by undo/redo operations.\r\n   */\r\n  public readonly onChangesApplied = new BeEvent<() => void>();\r\n\r\n  /** Event raised before an undo/redo operation is performed.\r\n   * @see [[onAfterUndoRedo]] for the event raised after the operation.\r\n   */\r\n  public readonly onBeforeUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n\r\n  /** Event raised after an undo/redo operation is performed.\r\n   * @see [[onBeforeUndoRedo]] for the event raised before to the operation.\r\n   */\r\n  public readonly onAfterUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n\r\n  /** Event raised after changes are pulled and merged into the briefcase.\r\n   * @see [[BriefcaseConnection.pullAndMergeChanges]].\r\n   */\r\n  public readonly onChangesPulled = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\r\n\r\n  /** Event raised after the briefcase's local changes are pushed.\r\n   * @see [[BriefcaseConnection.pushChanges]].\r\n   */\r\n  public readonly onChangesPushed = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\r\n\r\n  /** Event raised before pull merge process begins.\r\n   * @alpha\r\n   */\r\n  public readonly onPullMergeBegin = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\r\n\r\n  /** Event raised before a rebase operation begins.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseBegin = new BeEvent<(txns: TxnProps[]) => void>();\r\n\r\n  /** Event raised before a transaction is rebased.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseTxnBegin = new BeEvent<(txnProps: TxnProps) => void>();\r\n\r\n  /**\r\n   * Event raised after a transaction is rebased.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseTxnEnd = new BeEvent<(txnProps: TxnProps) => void>();\r\n\r\n  /**\r\n   * Event raised after a rebase operation ends.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseEnd = new BeEvent<(txns: TxnProps[]) => void>();\r\n\r\n  /**\r\n   * Event raised after the pull merge process ends.\r\n   * @alpha\r\n   */\r\n  public readonly onPullMergeEnd = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\r\n\r\n  /** Event raised before incoming changes are applied.\r\n   * @alpha\r\n   */\r\n  public readonly onApplyIncomingChangesBegin = new BeEvent<(changesets: ChangesetProps[]) => void>();\r\n\r\n  /** Event raised after incoming changes are applied.\r\n   * @alpha\r\n   */\r\n  public readonly onApplyIncomingChangesEnd = new BeEvent<(changes: ChangesetProps[]) => void>();\r\n\r\n  /** Event raised before local changes are reversed.\r\n   * @alpha\r\n   */\r\n  public readonly onReverseLocalChangesBegin = new BeEvent<() => void>();\r\n\r\n  /** Event raised after local changes are reversed.\r\n   * @alpha\r\n   */\r\n  public readonly onReverseLocalChangesEnd = new BeEvent<(txns: TxnProps[]) => void>();\r\n\r\n  /** Event raised before downloading changesets begins.\r\n   * @alpha\r\n   */\r\n  public readonly onDownloadChangesetsBegin = new BeEvent<() => void>();\r\n\r\n  /** Event raised after downloading changesets ends.\r\n   * @alpha\r\n   */\r\n  public readonly onDownloadChangesetsEnd = new BeEvent<() => void>();\r\n\r\n  /** @internal */\r\n  public constructor(iModel: BriefcaseConnection) {\r\n    super(iModel.key);\r\n    this._iModel = iModel;\r\n    this._cleanup = this.registerImpl();\r\n  }\r\n\r\n  /** @internal */\r\n  public [Symbol.dispose](): void {\r\n    if (this._cleanup) {\r\n      this._cleanup();\r\n      this._cleanup = undefined;\r\n\r\n      this.onAfterUndoRedo.clear();\r\n      this.onApplyIncomingChangesBegin.clear();\r\n      this.onApplyIncomingChangesEnd.clear();\r\n      this.onBeforeUndoRedo.clear();\r\n      this.onChangesApplied.clear();\r\n      this.onChangesPulled.clear();\r\n      this.onChangesPushed.clear();\r\n      this.onCommit.clear();\r\n      this.onCommitted.clear();\r\n      this.onDownloadChangesetsBegin.clear();\r\n      this.onDownloadChangesetsEnd.clear();\r\n      this.onElementsChanged.clear();\r\n      this.onModelGeometryChanged.clear();\r\n      this.onModelsChanged.clear();\r\n      this.onPullMergeBegin.clear();\r\n      this.onPullMergeEnd.clear();\r\n      this.onRebaseBegin.clear();\r\n      this.onRebaseEnd.clear();\r\n      this.onRebaseTxnBegin.clear();\r\n      this.onRebaseTxnEnd.clear();\r\n      this.onReverseLocalChangesBegin.clear();\r\n      this.onReverseLocalChangesEnd.clear();\r\n    }\r\n  }\r\n\r\n  /** Query if the briefcase has any pending Txns waiting to be pushed. */\r\n  public async hasPendingTxns(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IpcApp.appFunctionIpc.hasPendingTxns(this._iModel.key);\r\n  }\r\n\r\n  /** Determine if any reversible (undoable) changes exist.\r\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\r\n   */\r\n  public async isUndoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IpcApp.appFunctionIpc.isUndoPossible(this._iModel.key);\r\n  }\r\n\r\n  /** Determine if any reinstatable (redoable) changes exist.\r\n   * @see [[reinstateTxn]] to redo changes.\r\n   */\r\n  public async isRedoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IpcApp.appFunctionIpc.isRedoPossible(this._iModel.key);\r\n  }\r\n\r\n  /** Get the description of the operation that would be reversed by calling [[reverseTxns]]`(1)`.\r\n   * This is useful for showing the operation that would be undone, for example in a menu.\r\n   */\r\n  public async getUndoString(): Promise<string> {\r\n    return IpcApp.appFunctionIpc.getUndoString(this._iModel.key);\r\n  }\r\n\r\n  /** Get a description of the operation that would be reinstated by calling [[reinstateTxn]].\r\n   * This is useful for showing the operation that would be redone, in a pull-down menu for example.\r\n   */\r\n  public async getRedoString(): Promise<string> {\r\n    return IpcApp.appFunctionIpc.getRedoString(this._iModel.key);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation.\r\n   * @see [[reinstateTxn]] to redo operations.\r\n   * @see [[reverseAll]] to undo all operations.\r\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\r\n   */\r\n  public async reverseSingleTxn(): Promise<IModelStatus> {\r\n    return this.reverseTxns(1);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also\r\n   * abandons the locks that were acquired for that operation.\r\n   * @beta\r\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\r\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\r\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\r\n   * with _both_ Txn 1 and Txn 2.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\r\n   * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If there are no reversible operations, this method does nothing and returns Success.\r\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\r\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\r\n   */\r\n  public async reverseSingleTxnAsync(args?: ReverseTxnArgs): Promise<void> {\r\n    await this.reverseTxnsAsync(1, args);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.\r\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\r\n   *  be reinstated together when/if [[reinstateTxn]] is called.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\r\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If numOperations is too large only the number of reversible operations are reversed.\r\n   */\r\n  public async reverseTxns(numOperations: number): Promise<IModelStatus> {\r\n    return IpcApp.appFunctionIpc.reverseTxns(this._iModel.key, numOperations);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also\r\n   * abandons the locks that were acquired for those operations.\r\n   * @beta\r\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\r\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\r\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\r\n   * with _both_ Txn 1 and Txn 2.\r\n   * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,\r\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If numOperations is too large only the operations are reversible are reversed.\r\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\r\n   *  be reinstated together when/if ReinstateTxn is called.\r\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\r\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\r\n   */\r\n  public async reverseTxnsAsync(numOperations: number, args?: ReverseTxnArgs): Promise<void> {\r\n    return IpcApp.appFunctionIpc.reverseTxnsAsync(this._iModel.key, numOperations, args);\r\n  }\r\n\r\n  /** Reverse (undo) all changes back to the beginning of the session.\r\n   * @see [[reinstateTxn]] to redo changes.\r\n   * @see [[reverseSingleTxn]] to undo only the most recent operation.\r\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\r\n   */\r\n  public async reverseAll(): Promise<IModelStatus> {\r\n    return IpcApp.appFunctionIpc.reverseAllTxn(this._iModel.key);\r\n  }\r\n\r\n  /** Reverse (undo) all operations back to the beginning of the session. By default, this method also\r\n   * abandons the locks that were acquired for those operations.\r\n   * @beta\r\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\r\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\r\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\r\n   * with _both_ Txn 1 and Txn 2.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note If there are no reversible operations, this method does nothing and returns Success.\r\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\r\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\r\n   */\r\n  public async reverseAllTxnsAsync(args?: ReverseTxnArgs): Promise<void> {\r\n    return IpcApp.appFunctionIpc.reverseAllTxnsAsync(this._iModel.key, args);\r\n  }\r\n\r\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\r\n   * may take multiple calls to this method to reinstate all reversed operations.\r\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\r\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\r\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\r\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\r\n   */\r\n  public async reinstateTxn(): Promise<IModelStatus> {\r\n    return IpcApp.appFunctionIpc.reinstateTxn(this._iModel.key);\r\n  }\r\n\r\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\r\n   * may take multiple calls to this method to reinstate all reversed operations. This method also\r\n   * re-acquires the locks that were abandoned when those operations were reversed.\r\n   * @beta\r\n   * @param args Optional arguments to control the behavior of the reinstate operation.\r\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\r\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\r\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\r\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\r\n   */\r\n  public async reinstateTxnAsync(args?: ReinstateTxnArgs): Promise<void> {\r\n    return IpcApp.appFunctionIpc.reinstateTxnAsync(this._iModel.key, args);\r\n  }\r\n\r\n  /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed\r\n   * and reopened.)\r\n   * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used\r\n   * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.\r\n   * Probably a good idea to alert the user it happened.\r\n   */\r\n  public async restartTxnSession(): Promise<void> {\r\n    await IpcApp.appFunctionIpc.restartTxnSession(this._iModel.key);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyElementsChanged(changed: NotifyEntitiesChangedArgs): void {\r\n    this.onElementsChanged.raiseEvent(new EntityChanges(changed));\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyModelsChanged(changed: NotifyEntitiesChangedArgs): void {\r\n    this.onModelsChanged.raiseEvent(new EntityChanges(changed));\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyGeometryGuidsChanged(changes: ModelIdAndGeometryGuid[]): void {\r\n    this.onModelGeometryChanged.raiseEvent(changes);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyCommit() {\r\n    this.onCommit.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyCommitted(hasPendingTxns: boolean, time: number) {\r\n    this.onCommitted.raiseEvent(hasPendingTxns, time);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyReplayExternalTxns() {\r\n    this.onReplayExternalTxns.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyReplayedExternalTxns() {\r\n    this.onReplayedExternalTxns.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyChangesApplied() {\r\n    this.onChangesApplied.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyBeforeUndoRedo(isUndo: boolean) {\r\n    this.onBeforeUndoRedo.raiseEvent(isUndo);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyAfterUndoRedo(isUndo: boolean) {\r\n    this.onAfterUndoRedo.raiseEvent(isUndo);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyPulledChanges(parentChangeset: ChangesetIndexAndId) {\r\n    this.onChangesPulled.raiseEvent(parentChangeset);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyPushedChanges(parentChangeset: ChangesetIndexAndId) {\r\n    this.onChangesPushed.raiseEvent(parentChangeset);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyIModelNameChanged(name: string) {\r\n    this._iModel.name = name;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyRootSubjectChanged(subject: RootSubjectProps) {\r\n    this._iModel.rootSubject = subject;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyProjectExtentsChanged(range: Range3dProps) {\r\n    this._iModel.projectExtents = Range3d.fromJSON(range);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyGlobalOriginChanged(origin: XYZProps) {\r\n    this._iModel.globalOrigin = Point3d.fromJSON(origin);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyEcefLocationChanged(ecef: EcefLocationProps | undefined) {\r\n    this._iModel.ecefLocation = ecef ? new EcefLocation(ecef) : undefined;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyGeographicCoordinateSystemChanged(gcs: GeographicCRSProps | undefined) {\r\n    this._iModel.geographicCoordinateSystem = gcs ? new GeographicCRS(gcs) : undefined;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyPullMergeBegin(changeset: ChangesetIdWithIndex) {\r\n    this.onPullMergeBegin.raiseEvent(changeset);\r\n  }\r\n  /** @internal */\r\n  public notifyPullMergeEnd(changeset: ChangesetIdWithIndex) {\r\n    this.onPullMergeEnd.raiseEvent(changeset);\r\n  }\r\n  /** @internal */\r\n  public notifyApplyIncomingChangesBegin(changes: ChangesetProps[]) {\r\n    this.onApplyIncomingChangesBegin.raiseEvent(changes);\r\n  }\r\n  /** @internal */\r\n  public notifyApplyIncomingChangesEnd(changes: ChangesetProps[]) {\r\n    this.onApplyIncomingChangesEnd.raiseEvent(changes);\r\n  }\r\n  /** @internal */\r\n  public notifyReverseLocalChangesBegin() {\r\n    this.onReverseLocalChangesBegin.raiseEvent();\r\n  }\r\n  /** @internal */\r\n  public notifyReverseLocalChangesEnd(txns: TxnProps[]) {\r\n    this.onReverseLocalChangesEnd.raiseEvent(txns);\r\n  }\r\n  /** @internal */\r\n  public notifyDownloadChangesetsBegin() {\r\n    this.onDownloadChangesetsBegin.raiseEvent();\r\n  }\r\n  /** @internal */\r\n  public notifyDownloadChangesetsEnd() {\r\n    this.onDownloadChangesetsEnd.raiseEvent();\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseBegin(txns: TxnProps[]) {\r\n    this.onRebaseBegin.raiseEvent(txns);\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseEnd(txns: TxnProps[]) {\r\n    this.onRebaseEnd.raiseEvent(txns);\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseTxnBegin(txn: TxnProps) {\r\n    this.onRebaseTxnBegin.raiseEvent(txn);\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseTxnEnd(txn: TxnProps) {\r\n    this.onRebaseTxnEnd.raiseEvent(txn);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"BriefcaseTxns.js","sourceRoot":"","sources":["../../src/BriefcaseTxns.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 IModelConnection\r\n */\r\n\r\nimport { BeEvent, IModelStatus } from \"@itwin/core-bentley\";\r\nimport {\r\n  ChangesetIdWithIndex,\r\n  ChangesetIndexAndId, ChangesetProps, EcefLocation, EcefLocationProps, GeographicCRS, GeographicCRSProps, ipcAppChannels,\r\n  ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, ReinstateTxnArgs, RemoveFunction, ReverseTxnArgs, RootSubjectProps, TxnNotifications,\r\n  TxnProps,\r\n} from \"@itwin/core-common\";\r\nimport { Point3d, Range3d, Range3dProps, XYZProps } from \"@itwin/core-geometry\";\r\nimport { BriefcaseConnection } from \"./BriefcaseConnection\";\r\nimport { IpcApp, NotificationHandler } from \"./IpcApp\";\r\nimport { EntityChanges, TxnEntityChanges } from \"./TxnEntityChanges\";\r\n\r\n/**\r\n * Base class for notification handlers for events from the backend that are specific to a [[BriefcaseConnection]].\r\n * @see [[BriefcaseTxns]].\r\n * @public\r\n */\r\nexport abstract class BriefcaseNotificationHandler extends NotificationHandler {\r\n  constructor(private _key: string) { super(); }\r\n  public abstract get briefcaseChannelName(): string;\r\n  public get channelName() { return `${this.briefcaseChannelName}/${this._key}`; }\r\n}\r\n\r\n/** Manages local changes to a [[BriefcaseConnection]] via [Txns]($docs/learning/InteractiveEditing.md).\r\n * @see [[BriefcaseConnection.txns]].\r\n * @see [TxnManager]($backend) for the backend counterpart.\r\n * @public\r\n */\r\nexport class BriefcaseTxns extends BriefcaseNotificationHandler implements TxnNotifications {\r\n  private readonly _iModel: BriefcaseConnection;\r\n  private _cleanup?: RemoveFunction;\r\n\r\n  /** @internal */\r\n  public get briefcaseChannelName() {\r\n    return ipcAppChannels.txns;\r\n  }\r\n\r\n  /** Event raised after Txn validation or changeset application to indicate the set of changed elements.\r\n   * Each [[TxnEntityChange]] exposes its class through `metadata.classFullName`. Use [[TxnEntityChanges.filter]] with `metadata.is` to match a class or one of its subclasses.\r\n   * @example\r\n   * ```ts\r\n   * iModel.txns.onElementsChanged.addListener((changes) => {\r\n   *   for (const change of changes.filter({ includeMetadata: (metadata) => metadata.is(\"BisCore:GeometricElement\") }))\r\n   *     updateElement(change.id);\r\n   * });\r\n   * ```\r\n   * @note If there are many changed elements in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onElementsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\r\n\r\n  /** Event raised after Txn validation or changeset application to indicate the set of changed models.\r\n   * Each [[TxnEntityChange]] exposes its class through `metadata.classFullName`. Use [[TxnEntityChanges.filter]] with `metadata.is` to match a class or one of its subclasses.\r\n   * @note If there are many changed models in a single Txn, the notifications are sent in batches so this event *may be called multiple times* per Txn.\r\n   */\r\n  public readonly onModelsChanged = new BeEvent<(changes: TxnEntityChanges) => void>();\r\n\r\n  /** Event raised after the geometry within one or more [[GeometricModelState]]s is modified by applying a changeset or validation of a transaction.\r\n   * A model's geometry can change as a result of:\r\n   *  - Insertion or deletion of a geometric element within the model; or\r\n   *  - Modification of an existing element's geometric properties; or\r\n   *  - An explicit request to flag it as changed via [IModelDb.Models.updateModel]($backend).\r\n   */\r\n  public readonly onModelGeometryChanged = new BeEvent<(changes: ReadonlyArray<ModelIdAndGeometryGuid>) => void>();\r\n\r\n  /** Event raised before a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], unless there are no changes to save.\r\n   * @see [[onCommitted]] for the event raised after the operation.\r\n   */\r\n  public readonly onCommit = new BeEvent<() => void>();\r\n\r\n  /** Event raised after a commit operation is performed. Initiated by a call to [[BriefcaseConnection.saveChanges]], even if there were no changes to save.\r\n   * The event supplies the following information:\r\n   *  - `hasPendingTxns`: true if the briefcase has local changes not yet pushed to the server.\r\n   *  - `time`: the time at which changes were saved on the backend (obtained via `Date.now()`).\r\n   * @see [[onCommit]] for the event raised before the operation.\r\n   */\r\n  public readonly onCommitted = new BeEvent<(hasPendingTxns: boolean, time: number) => void>();\r\n\r\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\r\n   * @see [[onReplayedExternalTxns]] for the event raised after all such changes have been applied.\r\n   */\r\n  public readonly onReplayExternalTxns = new BeEvent<() => void>();\r\n\r\n  /** Event raised for a read-only briefcase that was opened with the `watchForChanges` flag enabled when changes made by another connection are applied to the briefcase.\r\n   * @see [[onReplayExternalTxns]] for the event raised before the changes are applied.\r\n   */\r\n  public readonly onReplayedExternalTxns = new BeEvent<() => void>();\r\n\r\n  /** Event raised after a changeset has been applied to the briefcase.\r\n   * Changesets may be applied as a result of [[BriefcaseConnection.pullChanges]], or by undo/redo operations.\r\n   */\r\n  public readonly onChangesApplied = new BeEvent<() => void>();\r\n\r\n  /** Event raised before an undo/redo operation is performed.\r\n   * @see [[onAfterUndoRedo]] for the event raised after the operation.\r\n   */\r\n  public readonly onBeforeUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n\r\n  /** Event raised after an undo/redo operation is performed.\r\n   * @see [[onBeforeUndoRedo]] for the event raised before to the operation.\r\n   */\r\n  public readonly onAfterUndoRedo = new BeEvent<(isUndo: boolean) => void>();\r\n\r\n  /** Event raised after changes are pulled and merged into the briefcase.\r\n   * @see [[BriefcaseConnection.pullAndMergeChanges]].\r\n   */\r\n  public readonly onChangesPulled = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\r\n\r\n  /** Event raised after the briefcase's local changes are pushed.\r\n   * @see [[BriefcaseConnection.pushChanges]].\r\n   */\r\n  public readonly onChangesPushed = new BeEvent<(parentChangeset: ChangesetIndexAndId) => void>();\r\n\r\n  /** Event raised before pull merge process begins.\r\n   * @alpha\r\n   */\r\n  public readonly onPullMergeBegin = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\r\n\r\n  /** Event raised before a rebase operation begins.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseBegin = new BeEvent<(txns: TxnProps[]) => void>();\r\n\r\n  /** Event raised before a transaction is rebased.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseTxnBegin = new BeEvent<(txnProps: TxnProps) => void>();\r\n\r\n  /**\r\n   * Event raised after a transaction is rebased.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseTxnEnd = new BeEvent<(txnProps: TxnProps) => void>();\r\n\r\n  /**\r\n   * Event raised after a rebase operation ends.\r\n   * @alpha\r\n   */\r\n  public readonly onRebaseEnd = new BeEvent<(txns: TxnProps[]) => void>();\r\n\r\n  /**\r\n   * Event raised after the pull merge process ends.\r\n   * @alpha\r\n   */\r\n  public readonly onPullMergeEnd = new BeEvent<(changeset: ChangesetIdWithIndex) => void>();\r\n\r\n  /** Event raised before incoming changes are applied.\r\n   * @alpha\r\n   */\r\n  public readonly onApplyIncomingChangesBegin = new BeEvent<(changesets: ChangesetProps[]) => void>();\r\n\r\n  /** Event raised after incoming changes are applied.\r\n   * @alpha\r\n   */\r\n  public readonly onApplyIncomingChangesEnd = new BeEvent<(changes: ChangesetProps[]) => void>();\r\n\r\n  /** Event raised before local changes are reversed.\r\n   * @alpha\r\n   */\r\n  public readonly onReverseLocalChangesBegin = new BeEvent<() => void>();\r\n\r\n  /** Event raised after local changes are reversed.\r\n   * @alpha\r\n   */\r\n  public readonly onReverseLocalChangesEnd = new BeEvent<(txns: TxnProps[]) => void>();\r\n\r\n  /** Event raised before downloading changesets begins.\r\n   * @alpha\r\n   */\r\n  public readonly onDownloadChangesetsBegin = new BeEvent<() => void>();\r\n\r\n  /** Event raised after downloading changesets ends.\r\n   * @alpha\r\n   */\r\n  public readonly onDownloadChangesetsEnd = new BeEvent<() => void>();\r\n\r\n  /** @internal */\r\n  public constructor(iModel: BriefcaseConnection) {\r\n    super(iModel.key);\r\n    this._iModel = iModel;\r\n    this._cleanup = this.registerImpl();\r\n  }\r\n\r\n  /** @internal */\r\n  public [Symbol.dispose](): void {\r\n    if (this._cleanup) {\r\n      this._cleanup();\r\n      this._cleanup = undefined;\r\n\r\n      this.onAfterUndoRedo.clear();\r\n      this.onApplyIncomingChangesBegin.clear();\r\n      this.onApplyIncomingChangesEnd.clear();\r\n      this.onBeforeUndoRedo.clear();\r\n      this.onChangesApplied.clear();\r\n      this.onChangesPulled.clear();\r\n      this.onChangesPushed.clear();\r\n      this.onCommit.clear();\r\n      this.onCommitted.clear();\r\n      this.onDownloadChangesetsBegin.clear();\r\n      this.onDownloadChangesetsEnd.clear();\r\n      this.onElementsChanged.clear();\r\n      this.onModelGeometryChanged.clear();\r\n      this.onModelsChanged.clear();\r\n      this.onPullMergeBegin.clear();\r\n      this.onPullMergeEnd.clear();\r\n      this.onRebaseBegin.clear();\r\n      this.onRebaseEnd.clear();\r\n      this.onRebaseTxnBegin.clear();\r\n      this.onRebaseTxnEnd.clear();\r\n      this.onReverseLocalChangesBegin.clear();\r\n      this.onReverseLocalChangesEnd.clear();\r\n    }\r\n  }\r\n\r\n  /** Query if the briefcase has any pending Txns waiting to be pushed. */\r\n  public async hasPendingTxns(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IpcApp.appFunctionIpc.hasPendingTxns(this._iModel.key);\r\n  }\r\n\r\n  /** Determine if any reversible (undoable) changes exist.\r\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\r\n   */\r\n  public async isUndoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IpcApp.appFunctionIpc.isUndoPossible(this._iModel.key);\r\n  }\r\n\r\n  /** Determine if any reinstatable (redoable) changes exist.\r\n   * @see [[reinstateTxn]] to redo changes.\r\n   */\r\n  public async isRedoPossible(): Promise<boolean> { // eslint-disable-line @itwin/prefer-get\r\n    return IpcApp.appFunctionIpc.isRedoPossible(this._iModel.key);\r\n  }\r\n\r\n  /** Get the description of the operation that would be reversed by calling [[reverseTxns]]`(1)`.\r\n   * This is useful for showing the operation that would be undone, for example in a menu.\r\n   */\r\n  public async getUndoString(): Promise<string> {\r\n    return IpcApp.appFunctionIpc.getUndoString(this._iModel.key);\r\n  }\r\n\r\n  /** Get a description of the operation that would be reinstated by calling [[reinstateTxn]].\r\n   * This is useful for showing the operation that would be redone, in a pull-down menu for example.\r\n   */\r\n  public async getRedoString(): Promise<string> {\r\n    return IpcApp.appFunctionIpc.getRedoString(this._iModel.key);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation.\r\n   * @see [[reinstateTxn]] to redo operations.\r\n   * @see [[reverseAll]] to undo all operations.\r\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\r\n   */\r\n  public async reverseSingleTxn(): Promise<IModelStatus> {\r\n    return this.reverseTxns(1);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also\r\n   * abandons the locks that were acquired for that operation.\r\n   * @beta\r\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\r\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\r\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\r\n   * with _both_ Txn 1 and Txn 2.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\r\n   * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If there are no reversible operations, this method does nothing and returns Success.\r\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\r\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\r\n   */\r\n  public async reverseSingleTxnAsync(args?: ReverseTxnArgs): Promise<void> {\r\n    await this.reverseTxnsAsync(1, args);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.\r\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\r\n   *  be reinstated together when/if [[reinstateTxn]] is called.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,\r\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If numOperations is too large only the number of reversible operations are reversed.\r\n   */\r\n  public async reverseTxns(numOperations: number): Promise<IModelStatus> {\r\n    return IpcApp.appFunctionIpc.reverseTxns(this._iModel.key, numOperations);\r\n  }\r\n\r\n  /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also\r\n   * abandons the locks that were acquired for those operations.\r\n   * @beta\r\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\r\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\r\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\r\n   * with _both_ Txn 1 and Txn 2.\r\n   * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note The term \"operation\" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,\r\n   * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.\r\n   * @note If numOperations is too large only the operations are reversible are reversed.\r\n   * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will\r\n   *  be reinstated together when/if ReinstateTxn is called.\r\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\r\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\r\n   */\r\n  public async reverseTxnsAsync(numOperations: number, args?: ReverseTxnArgs): Promise<void> {\r\n    return IpcApp.appFunctionIpc.reverseTxnsAsync(this._iModel.key, numOperations, args);\r\n  }\r\n\r\n  /** Reverse (undo) all changes back to the beginning of the session.\r\n   * @see [[reinstateTxn]] to redo changes.\r\n   * @see [[reverseSingleTxn]] to undo only the most recent operation.\r\n   * @see [[isUndoPossible]] to determine if any reversible operations exist.\r\n   */\r\n  public async reverseAll(): Promise<IModelStatus> {\r\n    return IpcApp.appFunctionIpc.reverseAllTxn(this._iModel.key);\r\n  }\r\n\r\n  /** Reverse (undo) all operations back to the beginning of the session. By default, this method also\r\n   * abandons the locks that were acquired for those operations.\r\n   * @beta\r\n   * @note This method will also abandon locks associated with any later, reversed Txns, if they have not\r\n   * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning\r\n   * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated\r\n   * with _both_ Txn 1 and Txn 2.\r\n   * @note If there are any outstanding uncommitted changes, they are reversed.\r\n   * @note If there are no reversible operations, this method does nothing and returns Success.\r\n   * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.\r\n   * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.\r\n   */\r\n  public async reverseAllTxnsAsync(args?: ReverseTxnArgs): Promise<void> {\r\n    return IpcApp.appFunctionIpc.reverseAllTxnsAsync(this._iModel.key, args);\r\n  }\r\n\r\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\r\n   * may take multiple calls to this method to reinstate all reversed operations.\r\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\r\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\r\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\r\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\r\n   */\r\n  public async reinstateTxn(): Promise<IModelStatus> {\r\n    return IpcApp.appFunctionIpc.reinstateTxn(this._iModel.key);\r\n  }\r\n\r\n  /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it\r\n   * may take multiple calls to this method to reinstate all reversed operations. This method also\r\n   * re-acquires the locks that were abandoned when those operations were reversed.\r\n   * @beta\r\n   * @param args Optional arguments to control the behavior of the reinstate operation.\r\n   * @returns Success if a reversed transaction was reinstated, error status otherwise.\r\n   * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.\r\n   * @see [[isRedoPossible]] to determine if any reinstatable operations exist.\r\n   * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.\r\n   */\r\n  public async reinstateTxnAsync(args?: ReinstateTxnArgs): Promise<void> {\r\n    return IpcApp.appFunctionIpc.reinstateTxnAsync(this._iModel.key, args);\r\n  }\r\n\r\n  /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed\r\n   * and reopened.)\r\n   * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used\r\n   * under extreme circumstances where damage to the file or session could happen if the currently committed are reversed. Use sparingly and with care.\r\n   * Probably a good idea to alert the user it happened.\r\n   */\r\n  public async restartTxnSession(): Promise<void> {\r\n    await IpcApp.appFunctionIpc.restartTxnSession(this._iModel.key);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyElementsChanged(changed: NotifyEntitiesChangedArgs): void {\r\n    this.onElementsChanged.raiseEvent(new EntityChanges(changed));\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyModelsChanged(changed: NotifyEntitiesChangedArgs): void {\r\n    this.onModelsChanged.raiseEvent(new EntityChanges(changed));\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyGeometryGuidsChanged(changes: ModelIdAndGeometryGuid[]): void {\r\n    this.onModelGeometryChanged.raiseEvent(changes);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyCommit() {\r\n    this.onCommit.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyCommitted(hasPendingTxns: boolean, time: number) {\r\n    this.onCommitted.raiseEvent(hasPendingTxns, time);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyReplayExternalTxns() {\r\n    this.onReplayExternalTxns.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyReplayedExternalTxns() {\r\n    this.onReplayedExternalTxns.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyChangesApplied() {\r\n    this.onChangesApplied.raiseEvent();\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyBeforeUndoRedo(isUndo: boolean) {\r\n    this.onBeforeUndoRedo.raiseEvent(isUndo);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyAfterUndoRedo(isUndo: boolean) {\r\n    this.onAfterUndoRedo.raiseEvent(isUndo);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyPulledChanges(parentChangeset: ChangesetIndexAndId) {\r\n    this.onChangesPulled.raiseEvent(parentChangeset);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyPushedChanges(parentChangeset: ChangesetIndexAndId) {\r\n    this.onChangesPushed.raiseEvent(parentChangeset);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyIModelNameChanged(name: string) {\r\n    this._iModel.name = name;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyRootSubjectChanged(subject: RootSubjectProps) {\r\n    this._iModel.rootSubject = subject;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyProjectExtentsChanged(range: Range3dProps) {\r\n    this._iModel.projectExtents = Range3d.fromJSON(range);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyGlobalOriginChanged(origin: XYZProps) {\r\n    this._iModel.globalOrigin = Point3d.fromJSON(origin);\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyEcefLocationChanged(ecef: EcefLocationProps | undefined) {\r\n    this._iModel.ecefLocation = ecef ? new EcefLocation(ecef) : undefined;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyGeographicCoordinateSystemChanged(gcs: GeographicCRSProps | undefined) {\r\n    this._iModel.geographicCoordinateSystem = gcs ? new GeographicCRS(gcs) : undefined;\r\n  }\r\n\r\n  /** @internal */\r\n  public notifyPullMergeBegin(changeset: ChangesetIdWithIndex) {\r\n    this.onPullMergeBegin.raiseEvent(changeset);\r\n  }\r\n  /** @internal */\r\n  public notifyPullMergeEnd(changeset: ChangesetIdWithIndex) {\r\n    this.onPullMergeEnd.raiseEvent(changeset);\r\n  }\r\n  /** @internal */\r\n  public notifyApplyIncomingChangesBegin(changes: ChangesetProps[]) {\r\n    this.onApplyIncomingChangesBegin.raiseEvent(changes);\r\n  }\r\n  /** @internal */\r\n  public notifyApplyIncomingChangesEnd(changes: ChangesetProps[]) {\r\n    this.onApplyIncomingChangesEnd.raiseEvent(changes);\r\n  }\r\n  /** @internal */\r\n  public notifyReverseLocalChangesBegin() {\r\n    this.onReverseLocalChangesBegin.raiseEvent();\r\n  }\r\n  /** @internal */\r\n  public notifyReverseLocalChangesEnd(txns: TxnProps[]) {\r\n    this.onReverseLocalChangesEnd.raiseEvent(txns);\r\n  }\r\n  /** @internal */\r\n  public notifyDownloadChangesetsBegin() {\r\n    this.onDownloadChangesetsBegin.raiseEvent();\r\n  }\r\n  /** @internal */\r\n  public notifyDownloadChangesetsEnd() {\r\n    this.onDownloadChangesetsEnd.raiseEvent();\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseBegin(txns: TxnProps[]) {\r\n    this.onRebaseBegin.raiseEvent(txns);\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseEnd(txns: TxnProps[]) {\r\n    this.onRebaseEnd.raiseEvent(txns);\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseTxnBegin(txn: TxnProps) {\r\n    this.onRebaseTxnBegin.raiseEvent(txn);\r\n  }\r\n  /** @internal */\r\n  public notifyRebaseTxnEnd(txn: TxnProps) {\r\n    this.onRebaseTxnEnd.raiseEvent(txn);\r\n  }\r\n}\r\n"]}

package/lib/cjs/EmphasizeElements.d.ts

@@ -32,7 +32,10 @@ export declare class EmphasizeElements implements FeatureOverrideProvider {
         color: ColorDef;
     };
     /** Establish a default appearance to apply to elements without overrides. If changing the default appearance
-     * without also calling overrideElements, an explicit refresh must be requested for the change to take effect.
+     * without also calling emphasizeElements/overrideElements, an explicit refresh must be requested for the change to take effect.
+     * @note Setting this to `undefined` to undo [[emphasizeElements]] or [[isolateElements]] leaves the always-drawn/isolated
+     * element IDs in place but invisible to [[getEmphasizedElements]], [[getEmphasizedIsolatedElements]], and [[clearEmphasizedElements]].
+     * Prefer [[clearEmphasizedElements]] or [[clearEmphasizedIsolatedElements]] to undo emphasis, which clear both together.
      * @see [[Viewport.setFeatureOverrideProviderChanged]]
      */
     get defaultAppearance(): FeatureAppearance | undefined;

package/lib/cjs/EmphasizeElements.d.ts.map

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

package/lib/cjs/EmphasizeElements.js

@@ -26,11 +26,11 @@ class EmphasizeElements {
      * @see [[Viewport.addFeatureOverrideProvider]]
      */
     addFeatureOverrides(overrides, vp) {
+        // Apply regardless of whether there are any emphasized/overridden elements for independent de-emphasis...
+        if (undefined !== this._defaultAppearance)
+            overrides.setDefaultOverrides(this._defaultAppearance);
         const emphasizedElements = this.getEmphasizedElements(vp);
         if (undefined !== emphasizedElements) {
-            if (this._defaultAppearance !== undefined) {
-                overrides.setDefaultOverrides(this._defaultAppearance);
-            }
             const appearance = this.wantEmphasis ? this._emphasizedAppearance : core_common_1.FeatureAppearance.defaults;
             // Avoid creating a new object per-element inside the loop
             const args = { elementId: "", appearance };
@@ -46,8 +46,6 @@ class EmphasizeElements {
         }
         const overriddenElements = this.getOverriddenElements();
         if (undefined !== overriddenElements) {
-            if (undefined !== this._defaultAppearance)
-                overrides.setDefaultOverrides(this._defaultAppearance);
             // Avoid creating a new object per-element inside the loop
             const args = { elementId: "", appearance: core_common_1.FeatureAppearance.defaults };
             for (const [key, ids] of overriddenElements) {
@@ -114,7 +112,10 @@ class EmphasizeElements {
         return { overrideType, color };
     }
     /** Establish a default appearance to apply to elements without overrides. If changing the default appearance
-     * without also calling overrideElements, an explicit refresh must be requested for the change to take effect.
+     * without also calling emphasizeElements/overrideElements, an explicit refresh must be requested for the change to take effect.
+     * @note Setting this to `undefined` to undo [[emphasizeElements]] or [[isolateElements]] leaves the always-drawn/isolated
+     * element IDs in place but invisible to [[getEmphasizedElements]], [[getEmphasizedIsolatedElements]], and [[clearEmphasizedElements]].
+     * Prefer [[clearEmphasizedElements]] or [[clearEmphasizedIsolatedElements]] to undo emphasis, which clear both together.
      * @see [[Viewport.setFeatureOverrideProviderChanged]]
      */
     get defaultAppearance() { return this._defaultAppearance; }
@@ -473,7 +474,9 @@ class EmphasizeElements {
         return true;
     }
     /** @return true if provider is currently overriding the display of any elements. */
-    isActive(vp) { return (undefined !== this.getNeverDrawnElements(vp) || undefined !== this.getAlwaysDrawnElements(vp) || undefined !== this.getOverriddenElements()); }
+    isActive(vp) {
+        return undefined !== this._defaultAppearance || undefined !== this.getNeverDrawnElements(vp) || undefined !== this.getAlwaysDrawnElements(vp) || undefined !== this.getOverriddenElements();
+    }
     /** Serialize to JSON representation.
      * @see [[EmphasizeElements.fromJSON]]
      */
@@ -519,8 +522,12 @@ class EmphasizeElements {
             changed = true;
         if (undefined !== props.alwaysDrawnExclusiveEmphasized)
             this._emphasizeIsolated = new Set(props.alwaysDrawnExclusiveEmphasized); // changed status determined by setAlwaysDrawnElements...
-        if (undefined !== props.defaultAppearance)
-            this.defaultAppearance = core_common_1.FeatureAppearance.fromJSON(props.defaultAppearance); // changed status determined by setAlwaysDrawnElements or overrideElements...
+        if (undefined !== props.defaultAppearance) {
+            const defaultAppearance = core_common_1.FeatureAppearance.fromJSON(props.defaultAppearance);
+            if (undefined === this._defaultAppearance || !this._defaultAppearance.equals(defaultAppearance))
+                changed = true;
+            this.defaultAppearance = defaultAppearance;
+        }
         if (props.unanimatedAppearance)
             this.unanimatedAppearance = core_common_1.FeatureAppearance.fromJSON(props.unanimatedAppearance);
         if (undefined !== props.appearanceOverride) {

package/lib/cjs/EmphasizeElements.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmphasizeElements.js","sourceRoot":"","sources":["../../src/EmphasizeElements.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 Rendering\r\n */\r\n\r\nimport { Id64, Id64Arg, Id64Set } from \"@itwin/core-bentley\";\r\nimport { AppearanceOverrideProps, ColorDef, EmphasizeElementsProps, FeatureAppearance, FeatureOverrideType, RgbColor } from \"@itwin/core-common\";\r\nimport { FeatureSymbology } from \"./render/FeatureSymbology\";\r\nimport { FeatureOverrideProvider } from \"./FeatureOverrideProvider\";\r\nimport { Viewport } from \"./Viewport\";\r\n\r\n/** An implementation of [[FeatureOverrideProvider]] for emphasizing selected elements through simple color/transparency appearance overrides.\r\n * @public\r\n * @extensions\r\n */\r\nexport class EmphasizeElements implements FeatureOverrideProvider {\r\n  private _defaultAppearance?: FeatureAppearance;\r\n  private _unanimatedAppearance?: FeatureAppearance;\r\n  private _emphasizeIsolated?: Id64Set;\r\n  private _overrideAppearance?: Map<number, Id64Set>;\r\n  private readonly _emphasizedAppearance = FeatureAppearance.fromJSON({ emphasized: true });\r\n\r\n  /** If true, all overridden and emphasized elements will also have the \"emphasis\" effect applied to them. This causes them to be hilited using the current [[Viewport.emphasisSettings]]. */\r\n  public wantEmphasis = false;\r\n\r\n  /** Establish active feature overrides to emphasize elements and apply color/transparency overrides.\r\n   * @see [[Viewport.addFeatureOverrideProvider]]\r\n   */\r\n  public addFeatureOverrides(overrides: FeatureSymbology.Overrides, vp: Viewport): void {\r\n    const emphasizedElements = this.getEmphasizedElements(vp);\r\n    if (undefined !== emphasizedElements) {\r\n      if (this._defaultAppearance !== undefined) {\r\n        overrides.setDefaultOverrides(this._defaultAppearance);\r\n      }\r\n      const appearance = this.wantEmphasis ? this._emphasizedAppearance : FeatureAppearance.defaults;\r\n\r\n      // Avoid creating a new object per-element inside the loop\r\n      const args = { elementId: \"\", appearance };\r\n      for (const elementId of emphasizedElements) {\r\n        args.elementId = elementId;\r\n        overrides.override(args);\r\n      }\r\n\r\n      // Do not apply animation overrides to de-emphasized elements.\r\n      overrides.ignoreAnimationOverrides((args) => {\r\n        const id = Id64.fromUint32Pair(args.elementId.lower, args.elementId.upper);\r\n        return !emphasizedElements.has(id);\r\n      });\r\n    }\r\n\r\n    const overriddenElements = this.getOverriddenElements();\r\n    if (undefined !== overriddenElements) {\r\n      if (undefined !== this._defaultAppearance)\r\n        overrides.setDefaultOverrides(this._defaultAppearance);\r\n\r\n      // Avoid creating a new object per-element inside the loop\r\n      const args = { elementId: \"\", appearance: FeatureAppearance.defaults };\r\n      for (const [key, ids] of overriddenElements) {\r\n        args.appearance = this.createAppearanceFromKey(key);\r\n        for (const elementId of ids) {\r\n          args.elementId = elementId;\r\n          overrides.override(args);\r\n        }\r\n      }\r\n    }\r\n\r\n    if (this._unanimatedAppearance) {\r\n      if (this._unanimatedAppearance.isFullyTransparent)\r\n        overrides.neverDrawnAnimationNodes.add(0);\r\n      else\r\n        overrides.animationNodeOverrides.set(0, this._unanimatedAppearance);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  protected createAppearanceFromKey(key: number): FeatureAppearance {\r\n    let transparency: number | undefined;\r\n    let rgb: RgbColor | undefined;\r\n\r\n    if (key < 0) {\r\n      transparency = Math.abs(key);\r\n    } else {\r\n      const color = ColorDef.fromJSON(key);\r\n      rgb = RgbColor.fromColorDef(color);\r\n      if (0 !== color.getAlpha()) // Fully transparent signifies to use color only...\r\n        transparency = color.getTransparency() / 255;\r\n    }\r\n\r\n    const emphasized = this.wantEmphasis ? true : undefined;\r\n    return FeatureAppearance.fromJSON({ rgb, transparency, emphasized });\r\n  }\r\n\r\n  /** Get override key from color and override type */\r\n  public createOverrideKey(color: ColorDef, override: FeatureOverrideType): number | undefined {\r\n    const colorValues = color.colors;\r\n    switch (override) {\r\n      case FeatureOverrideType.ColorAndAlpha:\r\n        return 255 === colorValues.t ? undefined : color.tbgr; // Hiding elements should be done using neverDrawn, not transparency...\r\n      case FeatureOverrideType.ColorOnly:\r\n        return ColorDef.from(colorValues.r, colorValues.g, colorValues.b, 255).tbgr;\r\n      case FeatureOverrideType.AlphaOnly:\r\n        return -(colorValues.t / 255);\r\n    }\r\n  }\r\n\r\n  /** Get color and override type for the given key. */\r\n  public getOverrideFromKey(key: number): { overrideType: FeatureOverrideType, color: ColorDef } {\r\n    let overrideType;\r\n    let color;\r\n\r\n    if (key < 0) {\r\n      color = ColorDef.from(0, 0, 0, 255 * Math.abs(key));\r\n      overrideType = FeatureOverrideType.AlphaOnly;\r\n    } else {\r\n      color = ColorDef.fromJSON(key);\r\n      if (0 === color.getAlpha()) {\r\n        color = color.withAlpha(255);\r\n        overrideType = FeatureOverrideType.ColorOnly;\r\n      } else {\r\n        overrideType = FeatureOverrideType.ColorAndAlpha;\r\n      }\r\n    }\r\n\r\n    return { overrideType, color };\r\n  }\r\n\r\n  /** Establish a default appearance to apply to elements without overrides. If changing the default appearance\r\n   * without also calling overrideElements, an explicit refresh must be requested for the change to take effect.\r\n   * @see [[Viewport.setFeatureOverrideProviderChanged]]\r\n   */\r\n  public get defaultAppearance(): FeatureAppearance | undefined { return this._defaultAppearance; }\r\n  public set defaultAppearance(appearance: FeatureAppearance | undefined) { this._defaultAppearance = appearance; }\r\n\r\n  /** Establish a default appearance to apply to elements that are not animated by the view's [RenderSchedule.Script]($common).\r\n   * @note If this is the only change made to EmphasizeElements, you must call [[Viewport.setFeatureOverrideProviderChanged]] for\r\n   * the change to take immediate effect.\r\n   * @see [[createDefaultAppearance]] to create an appearance suitable for de-emphasizing the non-animated elements.\r\n   */\r\n  public get unanimatedAppearance(): FeatureAppearance | undefined {\r\n    return this._unanimatedAppearance;\r\n  }\r\n  public set unanimatedAppearance(appearance: FeatureAppearance | undefined) {\r\n    this._unanimatedAppearance = appearance;\r\n  }\r\n\r\n  /** Create default appearance to use for emphasizeElements when not supplied by caller. */\r\n  public createDefaultAppearance(): FeatureAppearance {\r\n    return FeatureAppearance.fromJSON({\r\n      rgb: new RgbColor(0xe4, 0xe4, 0xe4),\r\n      transparency: 0.8,\r\n      nonLocatable: true,\r\n    });\r\n  }\r\n\r\n  /** Get the IDs of the currently never drawn elements. */\r\n  public getNeverDrawnElements(vp: Viewport): Id64Set | undefined {\r\n    return (undefined !== vp.neverDrawn && 0 !== vp.neverDrawn.size ? vp.neverDrawn : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently always drawn elements. */\r\n  public getAlwaysDrawnElements(vp: Viewport): Id64Set | undefined {\r\n    return (undefined !== vp.alwaysDrawn && 0 !== vp.alwaysDrawn.size ? vp.alwaysDrawn : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently hidden elements. */\r\n  public getHiddenElements(vp: Viewport): Id64Set | undefined {\r\n    return this.getNeverDrawnElements(vp);\r\n  }\r\n\r\n  /** Get the IDs of the currently isolated elements. */\r\n  public getIsolatedElements(vp: Viewport): Id64Set | undefined {\r\n    return (vp.isAlwaysDrawnExclusive ? this.getAlwaysDrawnElements(vp) : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently emphasized isolated elements. */\r\n  public getEmphasizedIsolatedElements(): Id64Set | undefined {\r\n    return (undefined !== this._defaultAppearance && undefined !== this._emphasizeIsolated && 0 !== this._emphasizeIsolated.size ? this._emphasizeIsolated : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently emphasized elements. */\r\n  public getEmphasizedElements(vp: Viewport): Id64Set | undefined {\r\n    return (undefined !== this.getEmphasizedIsolatedElements() ? this._emphasizeIsolated : (undefined !== this._defaultAppearance && !vp.isAlwaysDrawnExclusive ? this.getAlwaysDrawnElements(vp) : undefined));\r\n  }\r\n\r\n  /** Get the map of current elements with color/transparency overrides. */\r\n  public getOverriddenElements(): Map<number, Id64Set> | undefined {\r\n    return (undefined !== this._overrideAppearance && 0 !== this._overrideAppearance.size ? this._overrideAppearance : undefined);\r\n  }\r\n\r\n  /** Get the IDs of current elements with the specified color/transparency override. */\r\n  public getOverriddenElementsByKey(key: number): Id64Set | undefined {\r\n    return (undefined !== this._overrideAppearance ? this._overrideAppearance.get(key) : undefined);\r\n  }\r\n\r\n  /** Clear never drawn elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearNeverDrawnElements(vp: Viewport): boolean {\r\n    if (undefined === this.getNeverDrawnElements(vp))\r\n      return false;\r\n    vp.clearNeverDrawn();\r\n    return true;\r\n  }\r\n\r\n  /** Clear always drawn elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearAlwaysDrawnElements(vp: Viewport): boolean {\r\n    if (undefined === this.getAlwaysDrawnElements(vp))\r\n      return false;\r\n    vp.clearAlwaysDrawn();\r\n    return true;\r\n  }\r\n\r\n  /** Clear hidden elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearHiddenElements(vp: Viewport): boolean {\r\n    return this.clearNeverDrawnElements(vp);\r\n  }\r\n\r\n  /** Clear isolated elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearIsolatedElements(vp: Viewport): boolean {\r\n    if (undefined === this.getIsolatedElements(vp))\r\n      return false;\r\n    if (this.clearEmphasizedIsolatedElements(vp, true))\r\n      return true;\r\n    return this.clearAlwaysDrawnElements(vp);\r\n  }\r\n\r\n  /** Clear emphasized elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearEmphasizedElements(vp: Viewport): boolean {\r\n    if (undefined === this.getEmphasizedElements(vp))\r\n      return false;\r\n\r\n    if (this.clearEmphasizedIsolatedElements(vp, false))\r\n      return true;\r\n\r\n    if (!this.clearAlwaysDrawnElements(vp))\r\n      return false;\r\n\r\n    this._defaultAppearance = undefined;\r\n    return true;\r\n  }\r\n\r\n  /** Clear emphasized isolated elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearEmphasizedIsolatedElements(vp: Viewport, setToAlwaysDrawn: boolean): boolean {\r\n    const emphasizedIsolated = this.getEmphasizedIsolatedElements();\r\n    this._emphasizeIsolated = undefined; // Always clear in case default appearance was unset...\r\n    if (undefined === emphasizedIsolated)\r\n      return false;\r\n\r\n    if (setToAlwaysDrawn && this.setAlwaysDrawnElements(emphasizedIsolated, vp, false))\r\n      return true;\r\n\r\n    this._defaultAppearance = undefined;\r\n    vp.setFeatureOverrideProviderChanged();\r\n    return true;\r\n  }\r\n\r\n  /** Clear color/transparency overrides from elements. Removes all overrides when keyOrIds isn't supplied.\r\n   * @param keyOrIds Specify a key value from [[EmphasizeElements.getOverriddenElements]] or [[EmphasizeElements.createOverrideKey]]\r\n   * to remove a single color/transparency override for the corresponding elements or specify the IDs of elements to\r\n   * remove any color/transparency override from.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearOverriddenElements(vp: Viewport, keyOrIds?: number | Id64Arg): boolean {\r\n    if (undefined === this._overrideAppearance)\r\n      return false;\r\n\r\n    if (undefined !== keyOrIds) {\r\n      if (typeof keyOrIds === \"number\") {\r\n        if (!this._overrideAppearance.delete(keyOrIds))\r\n          return false;\r\n      } else {\r\n        let changed = false;\r\n\r\n        for (const [otherKey, otherIds] of this._overrideAppearance) {\r\n          const oldSize = otherIds.size;\r\n          for (const id of Id64.iterable(keyOrIds))\r\n            otherIds.delete(id);\r\n\r\n          if (oldSize !== otherIds.size)\r\n            changed = true;\r\n\r\n          if (0 === otherIds.size)\r\n            this._overrideAppearance.delete(otherKey);\r\n        }\r\n\r\n        if (!changed)\r\n          return false;\r\n      }\r\n    } else {\r\n      this._overrideAppearance = undefined;\r\n    }\r\n    vp.setFeatureOverrideProviderChanged();\r\n    return true;\r\n  }\r\n\r\n  /** @internal */\r\n  protected updateIdSet(ids: Id64Arg, replace: boolean, existingIds?: Id64Set): Id64Set | undefined {\r\n    const newIds = new Set<string>();\r\n    for (const id of Id64.iterable(ids))\r\n      newIds.add(id);\r\n\r\n    if (0 === newIds.size)\r\n      return undefined;\r\n\r\n    const oldSize = (!replace && undefined !== existingIds ? existingIds.size : 0);\r\n    if (0 !== oldSize && undefined !== existingIds)\r\n      for (const id of existingIds)\r\n        newIds.add(id);\r\n\r\n    if (oldSize === newIds.size)\r\n      return undefined;\r\n\r\n    return newIds;\r\n  }\r\n\r\n  /** Set the element IDs to be never drawn.\r\n   * @param ids The IDs of the elements to never draw.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently hidden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.neverDrawn]]\r\n   * @internal\r\n   */\r\n  public setNeverDrawnElements(ids: Id64Arg, vp: Viewport, replace: boolean = true): boolean {\r\n    const hiddenIds = this.updateIdSet(ids, replace, vp.neverDrawn);\r\n    if (undefined === hiddenIds)\r\n      return false;\r\n    vp.setNeverDrawn(hiddenIds);\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be always drawn.\r\n   * @param ids The IDs of the elements to always draw.\r\n   * @param vp The viewport.\r\n   * @param exclusive If true, *only* the specified elements will be drawn.\r\n   * @param replace true to replace currently always drawn elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   * @internal\r\n   */\r\n  public setAlwaysDrawnElements(ids: Id64Arg, vp: Viewport, exclusive: boolean = true, replace: boolean = true): boolean {\r\n    const visibleIds = this.updateIdSet(ids, replace, vp.alwaysDrawn);\r\n    if (undefined === visibleIds)\r\n      return false;\r\n    vp.setAlwaysDrawn(visibleIds, exclusive);\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be never drawn.\r\n   * @param ids The IDs of the elements to never draw.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently hidden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.neverDrawn]]\r\n   */\r\n  public hideElements(ids: Id64Arg, vp: Viewport, replace: boolean = false): boolean {\r\n    return this.setNeverDrawnElements(ids, vp, replace);\r\n  }\r\n\r\n  /** Set the currently selected elements to be never drawn.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently hidden elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.neverDrawn]]\r\n   */\r\n  public hideSelectedElements(vp: Viewport, replace: boolean = false, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.hideElements(selection.elements, vp, replace))\r\n      return false;\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be always drawn exclusively.\r\n   * @param ids The IDs of the elements to always draw.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently isolated elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public isolateElements(ids: Id64Arg, vp: Viewport, replace: boolean = true): boolean {\r\n    const wasEmphasized = (undefined !== this.getEmphasizedElements(vp));\r\n    if (!this.setAlwaysDrawnElements(ids, vp, true, replace))\r\n      return false;\r\n\r\n    if (wasEmphasized)\r\n      this._defaultAppearance = this._emphasizeIsolated = undefined; // Don't clear defaultAppearance unless it was established by emphasize...\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Set the currently selected elements to be always drawn exclusively.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently isolated elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public isolateSelectedElements(vp: Viewport, replace: boolean = true, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.isolateElements(selection.elements, vp, replace))\r\n      return false;\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be always drawn normally with all other elements in the view overridden to draw using a default appearance.\r\n   * @param ids The IDs of the elements to always draw.\r\n   * @param vp The viewport.\r\n   * @param defaultAppearance Optional default appearance, uses non-locatable transparent grey if not specified.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public emphasizeElements(ids: Id64Arg, vp: Viewport, defaultAppearance?: FeatureAppearance, replace: boolean = true): boolean {\r\n    if (undefined !== this.getIsolatedElements(vp)) {\r\n      const emphasizeIds = this.updateIdSet(ids, replace, this._emphasizeIsolated);\r\n      if (undefined === emphasizeIds)\r\n        return false;\r\n\r\n      this._emphasizeIsolated = emphasizeIds;\r\n      vp.setFeatureOverrideProviderChanged();\r\n    } else {\r\n      if (!this.setAlwaysDrawnElements(ids, vp, false, replace))\r\n        return false;\r\n\r\n      this._emphasizeIsolated = undefined;\r\n    }\r\n\r\n    this._defaultAppearance = (undefined === defaultAppearance ? this.createDefaultAppearance() : defaultAppearance);\r\n    return true;\r\n  }\r\n\r\n  /** Set the currently selected elements to be always drawn normally with all other elements in the view overridden to draw using a default appearance.\r\n   * @param vp The viewport.\r\n   * @param defaultAppearance Optional default appearance, uses transparent grey if not specified.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public emphasizeSelectedElements(vp: Viewport, defaultAppearance?: FeatureAppearance, replace: boolean = true, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.emphasizeElements(selection.elements, vp, defaultAppearance, replace))\r\n      return false;\r\n\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to display with a color/transparency override.\r\n   * @param ids The IDs of the elements.\r\n   * @param vp The viewport.\r\n   * @param color ColorDef to specify override rgb and alpha.\r\n   * @param override Whether to use color and alpha, only color, or only alpha from the supplied ColorDef.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.addFeatureOverrideProvider]]\r\n   */\r\n  public overrideElements(ids: Id64Arg, vp: Viewport, color: ColorDef, override: FeatureOverrideType = FeatureOverrideType.ColorOnly, replace: boolean = false): boolean {\r\n    const ovrKey = this.createOverrideKey(color, override);\r\n    if (undefined === ovrKey)\r\n      return false;\r\n\r\n    const overrideIds = new Set<string>();\r\n    for (const id of Id64.iterable(ids))\r\n      overrideIds.add(id);\r\n\r\n    if (0 === overrideIds.size)\r\n      return false;\r\n\r\n    const existingIds = (!replace ? this.getOverriddenElementsByKey(ovrKey) : undefined);\r\n    const oldSize = (undefined !== existingIds ? existingIds.size : 0);\r\n    if (0 !== oldSize && undefined !== existingIds)\r\n      for (const id of existingIds)\r\n        overrideIds.add(id);\r\n\r\n    if (oldSize === overrideIds.size)\r\n      return false;\r\n\r\n    if (undefined === this._overrideAppearance) {\r\n      this._overrideAppearance = new Map<number, Id64Set>();\r\n    } else {\r\n      for (const [key, otherIds] of this._overrideAppearance) {\r\n        if (key === ovrKey) // Make sure these ids are unique to this color/transparency key...\r\n          continue;\r\n\r\n        for (const id of Id64.iterable(ids))\r\n          otherIds.delete(id);\r\n\r\n        if (0 !== otherIds.size)\r\n          continue;\r\n\r\n        this._overrideAppearance.delete(key);\r\n      }\r\n    }\r\n\r\n    this._overrideAppearance.set(ovrKey, overrideIds);\r\n    vp.setFeatureOverrideProviderChanged();\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Set the currently selected elements to display with a color/transparency override.\r\n   * @param vp The viewport.\r\n   * @param color ColorDef to specify override rgb and alpha.\r\n   * @param override Whether to use color and alpha, only color, or only alpha from the supplied ColorDef.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.addFeatureOverrideProvider]]\r\n   */\r\n  public overrideSelectedElements(vp: Viewport, color: ColorDef, override: FeatureOverrideType = FeatureOverrideType.ColorOnly, replace: boolean = false, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.overrideElements(selection.elements, vp, color, override, replace))\r\n      return false;\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n    return true;\r\n  }\r\n\r\n  /** @return true if provider is currently overriding the display of any elements. */\r\n  public isActive(vp: Viewport): boolean { return (undefined !== this.getNeverDrawnElements(vp) || undefined !== this.getAlwaysDrawnElements(vp) || undefined !== this.getOverriddenElements()); }\r\n\r\n  /** Serialize to JSON representation.\r\n   * @see [[EmphasizeElements.fromJSON]]\r\n   */\r\n  public toJSON(vp: Viewport): EmphasizeElementsProps {\r\n    const props: EmphasizeElementsProps = {};\r\n    const neverDrawn = this.getNeverDrawnElements(vp);\r\n    if (undefined !== neverDrawn)\r\n      props.neverDrawn = [...neverDrawn];\r\n\r\n    const alwaysDrawn = this.getAlwaysDrawnElements(vp);\r\n    if (undefined !== alwaysDrawn)\r\n      props.alwaysDrawn = [...alwaysDrawn];\r\n\r\n    if (vp.isAlwaysDrawnExclusive)\r\n      props.isAlwaysDrawnExclusive = true; // isolate\r\n\r\n    const alwaysDrawnExclusiveEmphasized = this.getEmphasizedIsolatedElements();\r\n    if (undefined !== alwaysDrawnExclusiveEmphasized)\r\n      props.alwaysDrawnExclusiveEmphasized = [...alwaysDrawnExclusiveEmphasized];\r\n\r\n    if (undefined !== this.defaultAppearance)\r\n      props.defaultAppearance = this.defaultAppearance; // emphasize (or specifically set for override)\r\n\r\n    if (this.unanimatedAppearance)\r\n      props.unanimatedAppearance = this.unanimatedAppearance;\r\n\r\n    const overriddenElements = this.getOverriddenElements();\r\n    if (undefined !== overriddenElements) {\r\n      const appearanceOverride: AppearanceOverrideProps[] = [];\r\n      for (const [key, ovrIds] of overriddenElements) {\r\n        const { color, overrideType } = { ...this.getOverrideFromKey(key) };\r\n        const ids = [...ovrIds];\r\n        appearanceOverride.push({ overrideType, color: color.toJSON(), ids });\r\n      }\r\n\r\n      props.appearanceOverride = appearanceOverride;\r\n    }\r\n\r\n    if (this.wantEmphasis)\r\n      props.wantEmphasis = true;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Initialize from JSON representation.\r\n   * @see [[EmphasizeElements.toJSON]]\r\n   */\r\n  public fromJSON(props: EmphasizeElementsProps, vp: Viewport): boolean {\r\n    let changed = false;\r\n    if (undefined !== props.neverDrawn && this.setNeverDrawnElements(new Set<string>(props.neverDrawn), vp, true))\r\n      changed = true;\r\n\r\n    if (undefined !== props.alwaysDrawn && this.setAlwaysDrawnElements(new Set<string>(props.alwaysDrawn), vp, undefined !== props.isAlwaysDrawnExclusive && props.isAlwaysDrawnExclusive))\r\n      changed = true;\r\n\r\n    if (undefined !== props.alwaysDrawnExclusiveEmphasized)\r\n      this._emphasizeIsolated = new Set<string>(props.alwaysDrawnExclusiveEmphasized); // changed status determined by setAlwaysDrawnElements...\r\n\r\n    if (undefined !== props.defaultAppearance)\r\n      this.defaultAppearance = FeatureAppearance.fromJSON(props.defaultAppearance); // changed status determined by setAlwaysDrawnElements or overrideElements...\r\n\r\n    if (props.unanimatedAppearance)\r\n      this.unanimatedAppearance = FeatureAppearance.fromJSON(props.unanimatedAppearance);\r\n\r\n    if (undefined !== props.appearanceOverride) {\r\n      for (const ovrApp of props.appearanceOverride) {\r\n        if (undefined === ovrApp.ids)\r\n          continue;\r\n\r\n        if (this.overrideElements(new Set<string>(ovrApp.ids), vp, ColorDef.fromJSON(ovrApp.color), ovrApp.overrideType, true))\r\n          changed = true;\r\n      }\r\n    }\r\n\r\n    const wantEmphasis = true === props.wantEmphasis;\r\n    if (wantEmphasis !== this.wantEmphasis) {\r\n      this.wantEmphasis = wantEmphasis;\r\n      changed = true;\r\n    }\r\n\r\n    return changed;\r\n  }\r\n\r\n  /** Return the EmphasizeElements provider currently registered with the specified Viewport, if one is already registered. */\r\n  public static get(vp: Viewport): EmphasizeElements | undefined {\r\n    return vp.findFeatureOverrideProviderOfType<EmphasizeElements>(EmphasizeElements);\r\n  }\r\n\r\n  /** Return the EmphasizeElements provider currently registered with the specified Viewport, or register a new one and return it. */\r\n  public static getOrCreate(vp: Viewport): EmphasizeElements {\r\n    let provider = this.get(vp);\r\n    if (!provider) {\r\n      provider = new EmphasizeElements();\r\n      vp.addFeatureOverrideProvider(provider);\r\n    }\r\n\r\n    return provider;\r\n  }\r\n\r\n  /** Drop the EmphasizeElements provider currently registered with the specified Viewport, if any is registered. */\r\n  public static clear(vp: Viewport, inactiveOnly: boolean = false) {\r\n    const provider = this.get(vp);\r\n\r\n    if (undefined === provider || (inactiveOnly && provider.isActive(vp)))\r\n      return;\r\n\r\n    vp.clearNeverDrawn();\r\n    vp.clearAlwaysDrawn();\r\n    vp.dropFeatureOverrideProvider(provider);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"EmphasizeElements.js","sourceRoot":"","sources":["../../src/EmphasizeElements.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 Rendering\r\n */\r\n\r\nimport { Id64, Id64Arg, Id64Set } from \"@itwin/core-bentley\";\r\nimport { AppearanceOverrideProps, ColorDef, EmphasizeElementsProps, FeatureAppearance, FeatureOverrideType, RgbColor } from \"@itwin/core-common\";\r\nimport { FeatureSymbology } from \"./render/FeatureSymbology\";\r\nimport { FeatureOverrideProvider } from \"./FeatureOverrideProvider\";\r\nimport { Viewport } from \"./Viewport\";\r\n\r\n/** An implementation of [[FeatureOverrideProvider]] for emphasizing selected elements through simple color/transparency appearance overrides.\r\n * @public\r\n * @extensions\r\n */\r\nexport class EmphasizeElements implements FeatureOverrideProvider {\r\n  private _defaultAppearance?: FeatureAppearance;\r\n  private _unanimatedAppearance?: FeatureAppearance;\r\n  private _emphasizeIsolated?: Id64Set;\r\n  private _overrideAppearance?: Map<number, Id64Set>;\r\n  private readonly _emphasizedAppearance = FeatureAppearance.fromJSON({ emphasized: true });\r\n\r\n  /** If true, all overridden and emphasized elements will also have the \"emphasis\" effect applied to them. This causes them to be hilited using the current [[Viewport.emphasisSettings]]. */\r\n  public wantEmphasis = false;\r\n\r\n  /** Establish active feature overrides to emphasize elements and apply color/transparency overrides.\r\n   * @see [[Viewport.addFeatureOverrideProvider]]\r\n   */\r\n  public addFeatureOverrides(overrides: FeatureSymbology.Overrides, vp: Viewport): void {\r\n    // Apply regardless of whether there are any emphasized/overridden elements for independent de-emphasis...\r\n    if (undefined !== this._defaultAppearance)\r\n      overrides.setDefaultOverrides(this._defaultAppearance);\r\n\r\n    const emphasizedElements = this.getEmphasizedElements(vp);\r\n    if (undefined !== emphasizedElements) {\r\n      const appearance = this.wantEmphasis ? this._emphasizedAppearance : FeatureAppearance.defaults;\r\n\r\n      // Avoid creating a new object per-element inside the loop\r\n      const args = { elementId: \"\", appearance };\r\n      for (const elementId of emphasizedElements) {\r\n        args.elementId = elementId;\r\n        overrides.override(args);\r\n      }\r\n\r\n      // Do not apply animation overrides to de-emphasized elements.\r\n      overrides.ignoreAnimationOverrides((args) => {\r\n        const id = Id64.fromUint32Pair(args.elementId.lower, args.elementId.upper);\r\n        return !emphasizedElements.has(id);\r\n      });\r\n    }\r\n\r\n    const overriddenElements = this.getOverriddenElements();\r\n    if (undefined !== overriddenElements) {\r\n      // Avoid creating a new object per-element inside the loop\r\n      const args = { elementId: \"\", appearance: FeatureAppearance.defaults };\r\n      for (const [key, ids] of overriddenElements) {\r\n        args.appearance = this.createAppearanceFromKey(key);\r\n        for (const elementId of ids) {\r\n          args.elementId = elementId;\r\n          overrides.override(args);\r\n        }\r\n      }\r\n    }\r\n\r\n    if (this._unanimatedAppearance) {\r\n      if (this._unanimatedAppearance.isFullyTransparent)\r\n        overrides.neverDrawnAnimationNodes.add(0);\r\n      else\r\n        overrides.animationNodeOverrides.set(0, this._unanimatedAppearance);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  protected createAppearanceFromKey(key: number): FeatureAppearance {\r\n    let transparency: number | undefined;\r\n    let rgb: RgbColor | undefined;\r\n\r\n    if (key < 0) {\r\n      transparency = Math.abs(key);\r\n    } else {\r\n      const color = ColorDef.fromJSON(key);\r\n      rgb = RgbColor.fromColorDef(color);\r\n      if (0 !== color.getAlpha()) // Fully transparent signifies to use color only...\r\n        transparency = color.getTransparency() / 255;\r\n    }\r\n\r\n    const emphasized = this.wantEmphasis ? true : undefined;\r\n    return FeatureAppearance.fromJSON({ rgb, transparency, emphasized });\r\n  }\r\n\r\n  /** Get override key from color and override type */\r\n  public createOverrideKey(color: ColorDef, override: FeatureOverrideType): number | undefined {\r\n    const colorValues = color.colors;\r\n    switch (override) {\r\n      case FeatureOverrideType.ColorAndAlpha:\r\n        return 255 === colorValues.t ? undefined : color.tbgr; // Hiding elements should be done using neverDrawn, not transparency...\r\n      case FeatureOverrideType.ColorOnly:\r\n        return ColorDef.from(colorValues.r, colorValues.g, colorValues.b, 255).tbgr;\r\n      case FeatureOverrideType.AlphaOnly:\r\n        return -(colorValues.t / 255);\r\n    }\r\n  }\r\n\r\n  /** Get color and override type for the given key. */\r\n  public getOverrideFromKey(key: number): { overrideType: FeatureOverrideType, color: ColorDef } {\r\n    let overrideType;\r\n    let color;\r\n\r\n    if (key < 0) {\r\n      color = ColorDef.from(0, 0, 0, 255 * Math.abs(key));\r\n      overrideType = FeatureOverrideType.AlphaOnly;\r\n    } else {\r\n      color = ColorDef.fromJSON(key);\r\n      if (0 === color.getAlpha()) {\r\n        color = color.withAlpha(255);\r\n        overrideType = FeatureOverrideType.ColorOnly;\r\n      } else {\r\n        overrideType = FeatureOverrideType.ColorAndAlpha;\r\n      }\r\n    }\r\n\r\n    return { overrideType, color };\r\n  }\r\n\r\n  /** Establish a default appearance to apply to elements without overrides. If changing the default appearance\r\n   * without also calling emphasizeElements/overrideElements, an explicit refresh must be requested for the change to take effect.\r\n   * @note Setting this to `undefined` to undo [[emphasizeElements]] or [[isolateElements]] leaves the always-drawn/isolated\r\n   * element IDs in place but invisible to [[getEmphasizedElements]], [[getEmphasizedIsolatedElements]], and [[clearEmphasizedElements]].\r\n   * Prefer [[clearEmphasizedElements]] or [[clearEmphasizedIsolatedElements]] to undo emphasis, which clear both together.\r\n   * @see [[Viewport.setFeatureOverrideProviderChanged]]\r\n   */\r\n  public get defaultAppearance(): FeatureAppearance | undefined { return this._defaultAppearance; }\r\n  public set defaultAppearance(appearance: FeatureAppearance | undefined) { this._defaultAppearance = appearance; }\r\n\r\n  /** Establish a default appearance to apply to elements that are not animated by the view's [RenderSchedule.Script]($common).\r\n   * @note If this is the only change made to EmphasizeElements, you must call [[Viewport.setFeatureOverrideProviderChanged]] for\r\n   * the change to take immediate effect.\r\n   * @see [[createDefaultAppearance]] to create an appearance suitable for de-emphasizing the non-animated elements.\r\n   */\r\n  public get unanimatedAppearance(): FeatureAppearance | undefined {\r\n    return this._unanimatedAppearance;\r\n  }\r\n  public set unanimatedAppearance(appearance: FeatureAppearance | undefined) {\r\n    this._unanimatedAppearance = appearance;\r\n  }\r\n\r\n  /** Create default appearance to use for emphasizeElements when not supplied by caller. */\r\n  public createDefaultAppearance(): FeatureAppearance {\r\n    return FeatureAppearance.fromJSON({\r\n      rgb: new RgbColor(0xe4, 0xe4, 0xe4),\r\n      transparency: 0.8,\r\n      nonLocatable: true,\r\n    });\r\n  }\r\n\r\n  /** Get the IDs of the currently never drawn elements. */\r\n  public getNeverDrawnElements(vp: Viewport): Id64Set | undefined {\r\n    return (undefined !== vp.neverDrawn && 0 !== vp.neverDrawn.size ? vp.neverDrawn : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently always drawn elements. */\r\n  public getAlwaysDrawnElements(vp: Viewport): Id64Set | undefined {\r\n    return (undefined !== vp.alwaysDrawn && 0 !== vp.alwaysDrawn.size ? vp.alwaysDrawn : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently hidden elements. */\r\n  public getHiddenElements(vp: Viewport): Id64Set | undefined {\r\n    return this.getNeverDrawnElements(vp);\r\n  }\r\n\r\n  /** Get the IDs of the currently isolated elements. */\r\n  public getIsolatedElements(vp: Viewport): Id64Set | undefined {\r\n    return (vp.isAlwaysDrawnExclusive ? this.getAlwaysDrawnElements(vp) : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently emphasized isolated elements. */\r\n  public getEmphasizedIsolatedElements(): Id64Set | undefined {\r\n    return (undefined !== this._defaultAppearance && undefined !== this._emphasizeIsolated && 0 !== this._emphasizeIsolated.size ? this._emphasizeIsolated : undefined);\r\n  }\r\n\r\n  /** Get the IDs of the currently emphasized elements. */\r\n  public getEmphasizedElements(vp: Viewport): Id64Set | undefined {\r\n    return (undefined !== this.getEmphasizedIsolatedElements() ? this._emphasizeIsolated : (undefined !== this._defaultAppearance && !vp.isAlwaysDrawnExclusive ? this.getAlwaysDrawnElements(vp) : undefined));\r\n  }\r\n\r\n  /** Get the map of current elements with color/transparency overrides. */\r\n  public getOverriddenElements(): Map<number, Id64Set> | undefined {\r\n    return (undefined !== this._overrideAppearance && 0 !== this._overrideAppearance.size ? this._overrideAppearance : undefined);\r\n  }\r\n\r\n  /** Get the IDs of current elements with the specified color/transparency override. */\r\n  public getOverriddenElementsByKey(key: number): Id64Set | undefined {\r\n    return (undefined !== this._overrideAppearance ? this._overrideAppearance.get(key) : undefined);\r\n  }\r\n\r\n  /** Clear never drawn elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearNeverDrawnElements(vp: Viewport): boolean {\r\n    if (undefined === this.getNeverDrawnElements(vp))\r\n      return false;\r\n    vp.clearNeverDrawn();\r\n    return true;\r\n  }\r\n\r\n  /** Clear always drawn elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearAlwaysDrawnElements(vp: Viewport): boolean {\r\n    if (undefined === this.getAlwaysDrawnElements(vp))\r\n      return false;\r\n    vp.clearAlwaysDrawn();\r\n    return true;\r\n  }\r\n\r\n  /** Clear hidden elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearHiddenElements(vp: Viewport): boolean {\r\n    return this.clearNeverDrawnElements(vp);\r\n  }\r\n\r\n  /** Clear isolated elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearIsolatedElements(vp: Viewport): boolean {\r\n    if (undefined === this.getIsolatedElements(vp))\r\n      return false;\r\n    if (this.clearEmphasizedIsolatedElements(vp, true))\r\n      return true;\r\n    return this.clearAlwaysDrawnElements(vp);\r\n  }\r\n\r\n  /** Clear emphasized elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearEmphasizedElements(vp: Viewport): boolean {\r\n    if (undefined === this.getEmphasizedElements(vp))\r\n      return false;\r\n\r\n    if (this.clearEmphasizedIsolatedElements(vp, false))\r\n      return true;\r\n\r\n    if (!this.clearAlwaysDrawnElements(vp))\r\n      return false;\r\n\r\n    this._defaultAppearance = undefined;\r\n    return true;\r\n  }\r\n\r\n  /** Clear emphasized isolated elements.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearEmphasizedIsolatedElements(vp: Viewport, setToAlwaysDrawn: boolean): boolean {\r\n    const emphasizedIsolated = this.getEmphasizedIsolatedElements();\r\n    this._emphasizeIsolated = undefined; // Always clear in case default appearance was unset...\r\n    if (undefined === emphasizedIsolated)\r\n      return false;\r\n\r\n    if (setToAlwaysDrawn && this.setAlwaysDrawnElements(emphasizedIsolated, vp, false))\r\n      return true;\r\n\r\n    this._defaultAppearance = undefined;\r\n    vp.setFeatureOverrideProviderChanged();\r\n    return true;\r\n  }\r\n\r\n  /** Clear color/transparency overrides from elements. Removes all overrides when keyOrIds isn't supplied.\r\n   * @param keyOrIds Specify a key value from [[EmphasizeElements.getOverriddenElements]] or [[EmphasizeElements.createOverrideKey]]\r\n   * to remove a single color/transparency override for the corresponding elements or specify the IDs of elements to\r\n   * remove any color/transparency override from.\r\n   * @return false if nothing to clear.\r\n   */\r\n  public clearOverriddenElements(vp: Viewport, keyOrIds?: number | Id64Arg): boolean {\r\n    if (undefined === this._overrideAppearance)\r\n      return false;\r\n\r\n    if (undefined !== keyOrIds) {\r\n      if (typeof keyOrIds === \"number\") {\r\n        if (!this._overrideAppearance.delete(keyOrIds))\r\n          return false;\r\n      } else {\r\n        let changed = false;\r\n\r\n        for (const [otherKey, otherIds] of this._overrideAppearance) {\r\n          const oldSize = otherIds.size;\r\n          for (const id of Id64.iterable(keyOrIds))\r\n            otherIds.delete(id);\r\n\r\n          if (oldSize !== otherIds.size)\r\n            changed = true;\r\n\r\n          if (0 === otherIds.size)\r\n            this._overrideAppearance.delete(otherKey);\r\n        }\r\n\r\n        if (!changed)\r\n          return false;\r\n      }\r\n    } else {\r\n      this._overrideAppearance = undefined;\r\n    }\r\n    vp.setFeatureOverrideProviderChanged();\r\n    return true;\r\n  }\r\n\r\n  /** @internal */\r\n  protected updateIdSet(ids: Id64Arg, replace: boolean, existingIds?: Id64Set): Id64Set | undefined {\r\n    const newIds = new Set<string>();\r\n    for (const id of Id64.iterable(ids))\r\n      newIds.add(id);\r\n\r\n    if (0 === newIds.size)\r\n      return undefined;\r\n\r\n    const oldSize = (!replace && undefined !== existingIds ? existingIds.size : 0);\r\n    if (0 !== oldSize && undefined !== existingIds)\r\n      for (const id of existingIds)\r\n        newIds.add(id);\r\n\r\n    if (oldSize === newIds.size)\r\n      return undefined;\r\n\r\n    return newIds;\r\n  }\r\n\r\n  /** Set the element IDs to be never drawn.\r\n   * @param ids The IDs of the elements to never draw.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently hidden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.neverDrawn]]\r\n   * @internal\r\n   */\r\n  public setNeverDrawnElements(ids: Id64Arg, vp: Viewport, replace: boolean = true): boolean {\r\n    const hiddenIds = this.updateIdSet(ids, replace, vp.neverDrawn);\r\n    if (undefined === hiddenIds)\r\n      return false;\r\n    vp.setNeverDrawn(hiddenIds);\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be always drawn.\r\n   * @param ids The IDs of the elements to always draw.\r\n   * @param vp The viewport.\r\n   * @param exclusive If true, *only* the specified elements will be drawn.\r\n   * @param replace true to replace currently always drawn elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   * @internal\r\n   */\r\n  public setAlwaysDrawnElements(ids: Id64Arg, vp: Viewport, exclusive: boolean = true, replace: boolean = true): boolean {\r\n    const visibleIds = this.updateIdSet(ids, replace, vp.alwaysDrawn);\r\n    if (undefined === visibleIds)\r\n      return false;\r\n    vp.setAlwaysDrawn(visibleIds, exclusive);\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be never drawn.\r\n   * @param ids The IDs of the elements to never draw.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently hidden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.neverDrawn]]\r\n   */\r\n  public hideElements(ids: Id64Arg, vp: Viewport, replace: boolean = false): boolean {\r\n    return this.setNeverDrawnElements(ids, vp, replace);\r\n  }\r\n\r\n  /** Set the currently selected elements to be never drawn.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently hidden elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.neverDrawn]]\r\n   */\r\n  public hideSelectedElements(vp: Viewport, replace: boolean = false, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.hideElements(selection.elements, vp, replace))\r\n      return false;\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be always drawn exclusively.\r\n   * @param ids The IDs of the elements to always draw.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently isolated elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public isolateElements(ids: Id64Arg, vp: Viewport, replace: boolean = true): boolean {\r\n    const wasEmphasized = (undefined !== this.getEmphasizedElements(vp));\r\n    if (!this.setAlwaysDrawnElements(ids, vp, true, replace))\r\n      return false;\r\n\r\n    if (wasEmphasized)\r\n      this._defaultAppearance = this._emphasizeIsolated = undefined; // Don't clear defaultAppearance unless it was established by emphasize...\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Set the currently selected elements to be always drawn exclusively.\r\n   * @param vp The viewport.\r\n   * @param replace true to replace currently isolated elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public isolateSelectedElements(vp: Viewport, replace: boolean = true, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.isolateElements(selection.elements, vp, replace))\r\n      return false;\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to be always drawn normally with all other elements in the view overridden to draw using a default appearance.\r\n   * @param ids The IDs of the elements to always draw.\r\n   * @param vp The viewport.\r\n   * @param defaultAppearance Optional default appearance, uses non-locatable transparent grey if not specified.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public emphasizeElements(ids: Id64Arg, vp: Viewport, defaultAppearance?: FeatureAppearance, replace: boolean = true): boolean {\r\n    if (undefined !== this.getIsolatedElements(vp)) {\r\n      const emphasizeIds = this.updateIdSet(ids, replace, this._emphasizeIsolated);\r\n      if (undefined === emphasizeIds)\r\n        return false;\r\n\r\n      this._emphasizeIsolated = emphasizeIds;\r\n      vp.setFeatureOverrideProviderChanged();\r\n    } else {\r\n      if (!this.setAlwaysDrawnElements(ids, vp, false, replace))\r\n        return false;\r\n\r\n      this._emphasizeIsolated = undefined;\r\n    }\r\n\r\n    this._defaultAppearance = (undefined === defaultAppearance ? this.createDefaultAppearance() : defaultAppearance);\r\n    return true;\r\n  }\r\n\r\n  /** Set the currently selected elements to be always drawn normally with all other elements in the view overridden to draw using a default appearance.\r\n   * @param vp The viewport.\r\n   * @param defaultAppearance Optional default appearance, uses transparent grey if not specified.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.alwaysDrawn]]\r\n   * @see [[Viewport.isAlwaysDrawnExclusive]]\r\n   */\r\n  public emphasizeSelectedElements(vp: Viewport, defaultAppearance?: FeatureAppearance, replace: boolean = true, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.emphasizeElements(selection.elements, vp, defaultAppearance, replace))\r\n      return false;\r\n\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Set the element IDs to display with a color/transparency override.\r\n   * @param ids The IDs of the elements.\r\n   * @param vp The viewport.\r\n   * @param color ColorDef to specify override rgb and alpha.\r\n   * @param override Whether to use color and alpha, only color, or only alpha from the supplied ColorDef.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.addFeatureOverrideProvider]]\r\n   */\r\n  public overrideElements(ids: Id64Arg, vp: Viewport, color: ColorDef, override: FeatureOverrideType = FeatureOverrideType.ColorOnly, replace: boolean = false): boolean {\r\n    const ovrKey = this.createOverrideKey(color, override);\r\n    if (undefined === ovrKey)\r\n      return false;\r\n\r\n    const overrideIds = new Set<string>();\r\n    for (const id of Id64.iterable(ids))\r\n      overrideIds.add(id);\r\n\r\n    if (0 === overrideIds.size)\r\n      return false;\r\n\r\n    const existingIds = (!replace ? this.getOverriddenElementsByKey(ovrKey) : undefined);\r\n    const oldSize = (undefined !== existingIds ? existingIds.size : 0);\r\n    if (0 !== oldSize && undefined !== existingIds)\r\n      for (const id of existingIds)\r\n        overrideIds.add(id);\r\n\r\n    if (oldSize === overrideIds.size)\r\n      return false;\r\n\r\n    if (undefined === this._overrideAppearance) {\r\n      this._overrideAppearance = new Map<number, Id64Set>();\r\n    } else {\r\n      for (const [key, otherIds] of this._overrideAppearance) {\r\n        if (key === ovrKey) // Make sure these ids are unique to this color/transparency key...\r\n          continue;\r\n\r\n        for (const id of Id64.iterable(ids))\r\n          otherIds.delete(id);\r\n\r\n        if (0 !== otherIds.size)\r\n          continue;\r\n\r\n        this._overrideAppearance.delete(key);\r\n      }\r\n    }\r\n\r\n    this._overrideAppearance.set(ovrKey, overrideIds);\r\n    vp.setFeatureOverrideProviderChanged();\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Set the currently selected elements to display with a color/transparency override.\r\n   * @param vp The viewport.\r\n   * @param color ColorDef to specify override rgb and alpha.\r\n   * @param override Whether to use color and alpha, only color, or only alpha from the supplied ColorDef.\r\n   * @param replace true to replace currently overridden elements (if any) or false to add to the existing set.\r\n   * @param clearSelection true to clear current selection after setting appearance override, false to leave selected.\r\n   * @return true if overrides were changed.\r\n   * @see [[Viewport.addFeatureOverrideProvider]]\r\n   */\r\n  public overrideSelectedElements(vp: Viewport, color: ColorDef, override: FeatureOverrideType = FeatureOverrideType.ColorOnly, replace: boolean = false, clearSelection: boolean = true): boolean {\r\n    const selection = vp.view.iModel.selectionSet;\r\n    if (!selection.isActive || !this.overrideElements(selection.elements, vp, color, override, replace))\r\n      return false;\r\n    if (clearSelection)\r\n      selection.emptyAll();\r\n    return true;\r\n  }\r\n\r\n  /** @return true if provider is currently overriding the display of any elements. */\r\n  public isActive(vp: Viewport): boolean {\r\n    return undefined !== this._defaultAppearance || undefined !== this.getNeverDrawnElements(vp) || undefined !== this.getAlwaysDrawnElements(vp) || undefined !== this.getOverriddenElements();\r\n  }\r\n\r\n  /** Serialize to JSON representation.\r\n   * @see [[EmphasizeElements.fromJSON]]\r\n   */\r\n  public toJSON(vp: Viewport): EmphasizeElementsProps {\r\n    const props: EmphasizeElementsProps = {};\r\n    const neverDrawn = this.getNeverDrawnElements(vp);\r\n    if (undefined !== neverDrawn)\r\n      props.neverDrawn = [...neverDrawn];\r\n\r\n    const alwaysDrawn = this.getAlwaysDrawnElements(vp);\r\n    if (undefined !== alwaysDrawn)\r\n      props.alwaysDrawn = [...alwaysDrawn];\r\n\r\n    if (vp.isAlwaysDrawnExclusive)\r\n      props.isAlwaysDrawnExclusive = true; // isolate\r\n\r\n    const alwaysDrawnExclusiveEmphasized = this.getEmphasizedIsolatedElements();\r\n    if (undefined !== alwaysDrawnExclusiveEmphasized)\r\n      props.alwaysDrawnExclusiveEmphasized = [...alwaysDrawnExclusiveEmphasized];\r\n\r\n    if (undefined !== this.defaultAppearance)\r\n      props.defaultAppearance = this.defaultAppearance; // emphasize (or specifically set for override)\r\n\r\n    if (this.unanimatedAppearance)\r\n      props.unanimatedAppearance = this.unanimatedAppearance;\r\n\r\n    const overriddenElements = this.getOverriddenElements();\r\n    if (undefined !== overriddenElements) {\r\n      const appearanceOverride: AppearanceOverrideProps[] = [];\r\n      for (const [key, ovrIds] of overriddenElements) {\r\n        const { color, overrideType } = { ...this.getOverrideFromKey(key) };\r\n        const ids = [...ovrIds];\r\n        appearanceOverride.push({ overrideType, color: color.toJSON(), ids });\r\n      }\r\n\r\n      props.appearanceOverride = appearanceOverride;\r\n    }\r\n\r\n    if (this.wantEmphasis)\r\n      props.wantEmphasis = true;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Initialize from JSON representation.\r\n   * @see [[EmphasizeElements.toJSON]]\r\n   */\r\n  public fromJSON(props: EmphasizeElementsProps, vp: Viewport): boolean {\r\n    let changed = false;\r\n    if (undefined !== props.neverDrawn && this.setNeverDrawnElements(new Set<string>(props.neverDrawn), vp, true))\r\n      changed = true;\r\n\r\n    if (undefined !== props.alwaysDrawn && this.setAlwaysDrawnElements(new Set<string>(props.alwaysDrawn), vp, undefined !== props.isAlwaysDrawnExclusive && props.isAlwaysDrawnExclusive))\r\n      changed = true;\r\n\r\n    if (undefined !== props.alwaysDrawnExclusiveEmphasized)\r\n      this._emphasizeIsolated = new Set<string>(props.alwaysDrawnExclusiveEmphasized); // changed status determined by setAlwaysDrawnElements...\r\n\r\n    if (undefined !== props.defaultAppearance) {\r\n      const defaultAppearance = FeatureAppearance.fromJSON(props.defaultAppearance);\r\n      if (undefined === this._defaultAppearance || !this._defaultAppearance.equals(defaultAppearance))\r\n        changed = true;\r\n      this.defaultAppearance = defaultAppearance;\r\n    }\r\n\r\n    if (props.unanimatedAppearance)\r\n      this.unanimatedAppearance = FeatureAppearance.fromJSON(props.unanimatedAppearance);\r\n\r\n    if (undefined !== props.appearanceOverride) {\r\n      for (const ovrApp of props.appearanceOverride) {\r\n        if (undefined === ovrApp.ids)\r\n          continue;\r\n\r\n        if (this.overrideElements(new Set<string>(ovrApp.ids), vp, ColorDef.fromJSON(ovrApp.color), ovrApp.overrideType, true))\r\n          changed = true;\r\n      }\r\n    }\r\n\r\n    const wantEmphasis = true === props.wantEmphasis;\r\n    if (wantEmphasis !== this.wantEmphasis) {\r\n      this.wantEmphasis = wantEmphasis;\r\n      changed = true;\r\n    }\r\n\r\n    return changed;\r\n  }\r\n\r\n  /** Return the EmphasizeElements provider currently registered with the specified Viewport, if one is already registered. */\r\n  public static get(vp: Viewport): EmphasizeElements | undefined {\r\n    return vp.findFeatureOverrideProviderOfType<EmphasizeElements>(EmphasizeElements);\r\n  }\r\n\r\n  /** Return the EmphasizeElements provider currently registered with the specified Viewport, or register a new one and return it. */\r\n  public static getOrCreate(vp: Viewport): EmphasizeElements {\r\n    let provider = this.get(vp);\r\n    if (!provider) {\r\n      provider = new EmphasizeElements();\r\n      vp.addFeatureOverrideProvider(provider);\r\n    }\r\n\r\n    return provider;\r\n  }\r\n\r\n  /** Drop the EmphasizeElements provider currently registered with the specified Viewport, if any is registered. */\r\n  public static clear(vp: Viewport, inactiveOnly: boolean = false) {\r\n    const provider = this.get(vp);\r\n\r\n    if (undefined === provider || (inactiveOnly && provider.isActive(vp)))\r\n      return;\r\n\r\n    vp.clearNeverDrawn();\r\n    vp.clearAlwaysDrawn();\r\n    vp.dropFeatureOverrideProvider(provider);\r\n  }\r\n}\r\n"]}

package/lib/cjs/IModelApp.d.ts

@@ -396,8 +396,18 @@ export declare class IModelApp {
         iconSrc?: string | HTMLImageElement;
         /** The width of the icon, if `iconSrc` is a string. Default is 64. */
         iconWidth?: number;
-        /** A *notice* string to be shown on the logo card. May include HTML.  */
+        /** A *notice* string to be shown on the logo card. May include HTML.
+         * @note Never pass untrusted (e.g., server-provided) text here — string notices are parsed as HTML. Use [[noticeLines]] instead.
+         */
         notice?: string | HTMLElement;
+        /** Lines composing the *notice* shown on the logo card, separated by line breaks and styled like [[notice]].
+         * Strings are rendered as plain text — never parsed as HTML — making this the safe choice for untrusted
+         * (e.g., server-provided) content such as copyright attributions; supply an `HTMLElement` for a line requiring markup.
+         * This option is intended for any caller — including applications and map-layer format extensions — that needs to
+         * display text it does not fully control; prefer it over [[notice]] unless you require raw HTML for your own trusted content.
+         * Ignored if [[notice]] is defined.
+         */
+        noticeLines?: Array<string | HTMLElement>;
     }): HTMLTableRowElement;
     /** Make the logo card for the library itself. This card gets placed at the top of the stack.
      *  @internal