@itwin/core-frontend 5.9.0-dev.8 → 5.10.0-dev.1

package/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Change Log - @itwin/core-frontend
 
-This log was last generated on Fri, 10 Apr 2026 13:03:16 GMT and should not be manually modified.
+This log was last generated on Thu, 23 Apr 2026 18:06:53 GMT and should not be manually modified.
+
+## 5.8.4
+Thu, 23 Apr 2026 18:05:14 GMT
+
+_Version update only_
+
+## 5.8.3
+Thu, 23 Apr 2026 14:52:42 GMT
+
+_Version update only_
+
+## 5.8.2
+Thu, 16 Apr 2026 11:05:01 GMT
+
+_Version update only_
 
 ## 5.8.1
 Fri, 10 Apr 2026 13:02:00 GMT

package/lib/cjs/BriefcaseTxns.d.ts

@@ -2,7 +2,7 @@
  * @module IModelConnection
  */
 import { BeEvent, IModelStatus } from "@itwin/core-bentley";
-import { ChangesetIdWithIndex, ChangesetIndexAndId, ChangesetProps, EcefLocationProps, GeographicCRSProps, ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, RootSubjectProps, TxnNotifications, TxnProps } from "@itwin/core-common";
+import { ChangesetIdWithIndex, ChangesetIndexAndId, ChangesetProps, EcefLocationProps, GeographicCRSProps, ModelIdAndGeometryGuid, NotifyEntitiesChangedArgs, ReinstateTxnArgs, ReverseTxnArgs, RootSubjectProps, TxnNotifications, TxnProps } from "@itwin/core-common";
 import { Range3dProps, XYZProps } from "@itwin/core-geometry";
 import { BriefcaseConnection } from "./BriefcaseConnection";
 import { NotificationHandler } from "./IpcApp";
@@ -161,6 +161,21 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
      * @see [[isUndoPossible]] to determine if any reversible operations exist.
      */
     reverseSingleTxn(): Promise<IModelStatus>;
+    /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for that operation.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,
+     * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    reverseSingleTxnAsync(args?: ReverseTxnArgs): Promise<void>;
     /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.
      * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
      *  be reinstated together when/if [[reinstateTxn]] is called.
@@ -170,12 +185,43 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
      * @note If numOperations is too large only the number of reversible operations are reversed.
      */
     reverseTxns(numOperations: number): Promise<IModelStatus>;
+    /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,
+     * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If numOperations is too large only the operations are reversible are reversed.
+     * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
+     *  be reinstated together when/if ReinstateTxn is called.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    reverseTxnsAsync(numOperations: number, args?: ReverseTxnArgs): Promise<void>;
     /** Reverse (undo) all changes back to the beginning of the session.
      * @see [[reinstateTxn]] to redo changes.
      * @see [[reverseSingleTxn]] to undo only the most recent operation.
      * @see [[isUndoPossible]] to determine if any reversible operations exist.
      */
     reverseAll(): Promise<IModelStatus>;
+    /** Reverse (undo) all operations back to the beginning of the session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    reverseAllTxnsAsync(args?: ReverseTxnArgs): Promise<void>;
     /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
      * may take multiple calls to this method to reinstate all reversed operations.
      * @returns Success if a reversed transaction was reinstated, error status otherwise.
@@ -184,6 +230,17 @@ export declare class BriefcaseTxns extends BriefcaseNotificationHandler implemen
      * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.
      */
     reinstateTxn(): Promise<IModelStatus>;
+    /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
+     * may take multiple calls to this method to reinstate all reversed operations. This method also
+     * re-acquires the locks that were abandoned when those operations were reversed.
+     * @beta
+     * @param args Optional arguments to control the behavior of the reinstate operation.
+     * @returns Success if a reversed transaction was reinstated, error status otherwise.
+     * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.
+     * @see [[isRedoPossible]] to determine if any reinstatable operations exist.
+     * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.
+     */
+    reinstateTxnAsync(args?: ReinstateTxnArgs): Promise<void>;
     /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed
      * and reopened.)
      * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used

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

@@ -215,6 +215,23 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reverseSingleTxn() {
         return this.reverseTxns(1);
     }
+    /** Reverse (undo) the most recent operation to this briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for that operation.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [TxnManager.beginMultiTxnOperation]($backend). So,
+     * even though this method reverses only one operation, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    async reverseSingleTxnAsync(args) {
+        await this.reverseTxnsAsync(1, args);
+    }
     /** Reverse (undo) the most recent operation(s) to the briefcase in the current session.
      * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
      *  be reinstated together when/if [[reinstateTxn]] is called.
@@ -226,6 +243,26 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reverseTxns(numOperations) {
         return IpcApp_1.IpcApp.appFunctionIpc.reverseTxns(this._iModel.key, numOperations);
     }
+    /** Reverse (undo) the most recent operation(s) to the briefcase in the current session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If you do not want to abandon any locks, set [ReverseTxnArgs.retainLocks]($common) to true.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note The term "operation" is used rather than Txn, since multiple Txns can be grouped together via [[beginMultiTxnOperation]]. So,
+     * even if numOperations is 1, multiple Txns may be reversed if they were grouped together when they were made.
+     * @note If numOperations is too large only the operations are reversible are reversed.
+     * @param numOperations the number of operations to reverse. If this is greater than 1, the entire set of operations will
+     *  be reinstated together when/if ReinstateTxn is called.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    async reverseTxnsAsync(numOperations, args) {
+        return IpcApp_1.IpcApp.appFunctionIpc.reverseTxnsAsync(this._iModel.key, numOperations, args);
+    }
     /** Reverse (undo) all changes back to the beginning of the session.
      * @see [[reinstateTxn]] to redo changes.
      * @see [[reverseSingleTxn]] to undo only the most recent operation.
@@ -234,6 +271,21 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reverseAll() {
         return IpcApp_1.IpcApp.appFunctionIpc.reverseAllTxn(this._iModel.key);
     }
+    /** Reverse (undo) all operations back to the beginning of the session. By default, this method also
+     * abandons the locks that were acquired for those operations.
+     * @beta
+     * @note This method will also abandon locks associated with any later, reversed Txns, if they have not
+     * already been abandoned. For example, if a call to [[reverseTxns]] reverses Txn 2 without abandoning
+     * its locks, and then this method is called to reverse Txn 1, it will abandon the locks associated
+     * with _both_ Txn 1 and Txn 2.
+     * @note If there are any outstanding uncommitted changes, they are reversed.
+     * @note If there are no reversible operations, this method does nothing and returns Success.
+     * @param args Optional arguments to control the behavior of the reverse operation, such as whether to retain locks.
+     * @returns A Promise that resolves to success if the transactions were reversed, or rejects with an IModelError otherwise.
+     */
+    async reverseAllTxnsAsync(args) {
+        return IpcApp_1.IpcApp.appFunctionIpc.reverseAllTxnsAsync(this._iModel.key, args);
+    }
     /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
      * may take multiple calls to this method to reinstate all reversed operations.
      * @returns Success if a reversed transaction was reinstated, error status otherwise.
@@ -244,6 +296,19 @@ class BriefcaseTxns extends BriefcaseNotificationHandler {
     async reinstateTxn() {
         return IpcApp_1.IpcApp.appFunctionIpc.reinstateTxn(this._iModel.key);
     }
+    /** Reinstate (redo) the most recently reversed transaction. Since at any time multiple transactions can be reversed, it
+     * may take multiple calls to this method to reinstate all reversed operations. This method also
+     * re-acquires the locks that were abandoned when those operations were reversed.
+     * @beta
+     * @param args Optional arguments to control the behavior of the reinstate operation.
+     * @returns Success if a reversed transaction was reinstated, error status otherwise.
+     * @note If there are any outstanding uncommitted changes, they are canceled before the Txn is reinstated.
+     * @see [[isRedoPossible]] to determine if any reinstatable operations exist.
+     * @see [[reverseSingleTxn]] or [[reverseAll]] to undo changes.
+     */
+    async reinstateTxnAsync(args) {
+        return IpcApp_1.IpcApp.appFunctionIpc.reinstateTxnAsync(this._iModel.key, args);
+    }
     /** Restart the current TxnManager session. This causes all Txns in the current session to no longer be undoable (as if the file was closed
      * and reopened.)
      * @note This can be quite disconcerting to the user expecting to be able to undo previously made changes. It should only be used

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, RemoveFunction, 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(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) 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  /** 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  /** 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   * @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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"PerModelCategoryVisibility.d.ts","sourceRoot":"","sources":["../../src/PerModelCategoryVisibility.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAkB,IAAI,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;GAQG;AACH,yBAAiB,0BAA0B,CAAC;IAC1C,uEAAuE;IACvE,KAAY,QAAQ;QAClB,wIAAwI;QACxI,IAAI,IAAA;QACJ,gDAAgD;QAChD,IAAI,IAAA;QACJ,kDAAkD;QAClD,IAAI,IAAA;KACL;IAED,uFAAuF;IACvF,UAAiB,aAAa;QAC5B,2EAA2E;QAC3E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;QAC7B,gFAAgF;QAChF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,mEAAmE;QACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B;IAED;;OAEG;IACH,UAAiB,SAAS;QACxB,uFAAuF;QACvF,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC;QACnE,mFAAmF;QACnF,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC/E;;WAEG;QACH,YAAY,CAAC,0BAA0B,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5F,oGAAoG;QACpG,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACzC,wDAAwD;QACxD,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjD,mFAAmF;QACnF,YAAY,CAAC,EAAE,EAAE,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;KAC1F;IAED;;;MAGE;IACF,UAAiB,KAAK;QACpB,wDAAwD;QACxD,OAAO,EAAE,MAAM,CAAC;QAChB,uGAAuG;QACvG,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClC,gEAAgE;QAChE,WAAW,EAAE,0BAA0B,CAAC,QAAQ,CAAC;KAClD;IAED,SAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,0BAA0B,CAAC,SAAS,CAExF;CACF"}
+{"version":3,"file":"PerModelCategoryVisibility.d.ts","sourceRoot":"","sources":["../../src/PerModelCategoryVisibility.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;GAQG;AACH,yBAAiB,0BAA0B,CAAC;IAC1C,uEAAuE;IACvE,KAAY,QAAQ;QAClB,wIAAwI;QACxI,IAAI,IAAA;QACJ,gDAAgD;QAChD,IAAI,IAAA;QACJ,kDAAkD;QAClD,IAAI,IAAA;KACL;IAED,uFAAuF;IACvF,UAAiB,aAAa;QAC5B,2EAA2E;QAC3E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;QAC7B,gFAAgF;QAChF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;QAChC,mEAAmE;QACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAC3B;IAED;;OAEG;IACH,UAAiB,SAAS;QACxB,uFAAuF;QACvF,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC;QACnE,mFAAmF;QACnF,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC/E;;WAEG;QACH,YAAY,CAAC,0BAA0B,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5F,oGAAoG;QACpG,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACzC,wDAAwD;QACxD,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjD,mFAAmF;QACnF,YAAY,CAAC,EAAE,EAAE,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;KAC1F;IAED;;;MAGE;IACF,UAAiB,KAAK;QACpB,wDAAwD;QACxD,OAAO,EAAE,MAAM,CAAC;QAChB,uGAAuG;QACvG,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClC,gEAAgE;QAChE,WAAW,EAAE,0BAA0B,CAAC,QAAQ,CAAC;KAClD;IAED,SAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,0BAA0B,CAAC,SAAS,CAExF;CACF"}

package/lib/cjs/PerModelCategoryVisibility.js

@@ -35,41 +35,77 @@ var PerModelCategoryVisibility;
     }
     PerModelCategoryVisibility.createOverrides = createOverrides;
 })(PerModelCategoryVisibility || (exports.PerModelCategoryVisibility = PerModelCategoryVisibility = {}));
-class PerModelCategoryVisibilityOverride {
-    modelId;
-    categoryId;
-    visible;
-    constructor(modelId, categoryId, visible) {
-        this.modelId = modelId;
-        this.categoryId = categoryId;
-        this.visible = visible;
-    }
-    reset(modelId, categoryId, visible) {
-        this.modelId = modelId;
-        this.categoryId = categoryId;
-        this.visible = visible;
-    }
-}
-function compareCategoryOverrides(lhs, rhs) {
-    const cmp = (0, core_bentley_1.compareStrings)(lhs.modelId, rhs.modelId);
-    return 0 === cmp ? (0, core_bentley_1.compareStrings)(lhs.categoryId, rhs.categoryId) : cmp;
-}
 /** The Viewport-specific implementation of PerModelCategoryVisibility.Overrides. */
-class PerModelCategoryVisibilityOverrides extends core_bentley_1.SortedArray {
-    _scratch = new PerModelCategoryVisibilityOverride("0", "0", false);
+class PerModelCategoryVisibilityOverrides {
+    _map = new Map();
+    /** Flat set of all override entries, providing O(1) iteration via [Symbol.iterator]. Kept in sync with `_map`. */
+    _set = new Set();
     _vp;
     constructor(vp) {
-        super(compareCategoryOverrides);
         this._vp = vp;
     }
+    [Symbol.iterator]() {
+        return this._set[Symbol.iterator]();
+    }
     getOverride(modelId, categoryId) {
-        this._scratch.reset(modelId, categoryId, false);
-        const ovr = this.findEqual(this._scratch);
+        const ovr = this._map.get(modelId)?.get(categoryId);
         if (undefined !== ovr)
             return ovr.visible ? PerModelCategoryVisibility.Override.Show : PerModelCategoryVisibility.Override.Hide;
         else
             return PerModelCategoryVisibility.Override.None;
     }
+    getModelEntry({ modelId, override }) {
+        let modelEntry = this._map.get(modelId);
+        if (modelEntry) {
+            return modelEntry;
+        }
+        if (override === PerModelCategoryVisibility.Override.None) {
+            return undefined;
+        }
+        modelEntry = new Map();
+        this._map.set(modelId, modelEntry);
+        return modelEntry;
+    }
+    addOrRemoveOverrideEntry({ modelEntry, categoryId, modelId, override }) {
+        const overrideEntry = modelEntry.get(categoryId);
+        if (override === PerModelCategoryVisibility.Override.None) {
+            if (overrideEntry === undefined) {
+                return false;
+            }
+            this._set.delete(overrideEntry);
+            modelEntry.delete(categoryId);
+            return true;
+        }
+        const visible = override === PerModelCategoryVisibility.Override.Show;
+        if (overrideEntry === undefined) {
+            const ovr = { modelId, categoryId, visible };
+            modelEntry.set(categoryId, ovr);
+            this._set.add(ovr);
+            return true;
+        }
+        if (overrideEntry.visible !== visible) {
+            overrideEntry.visible = visible;
+            return true;
+        }
+        return false;
+    }
+    applyOverride(modelId, categoryIds, override, catIdsToLoad) {
+        const modelEntry = this.getModelEntry({ modelId, override });
+        let changed = false;
+        if (!modelEntry)
+            return changed;
+        for (const categoryId of categoryIds) {
+            if (this.addOrRemoveOverrideEntry({ modelEntry, categoryId, modelId, override })) {
+                changed = true;
+                if (catIdsToLoad && override !== PerModelCategoryVisibility.Override.None)
+                    catIdsToLoad.push(categoryId);
+            }
+        }
+        if (modelEntry.size === 0) {
+            this._map.delete(modelId);
+        }
+        return changed;
+    }
     /**
      * set the overrides for multiple perModelCategoryVisibility props, loading categoryIds from the iModel if necessary.
      * @see [[PerModelCategoryVisibility]]
@@ -84,19 +120,11 @@ class PerModelCategoryVisibilityOverrides extends core_bentley_1.SortedArray {
         const catIdsToLoad = [];
         const iModelToUse = iModel ? iModel : this._vp.iModel;
         for (const override of perModelCategoryVisibility) {
-            const modelId = override.modelId;
             // The caller may pass a single categoryId as a string, if we don't convert this to an array we will iterate
             // over each individual character of that string, which is not the desired behavior.
             const categoryIds = typeof override.categoryIds === "string" ? [override.categoryIds] : override.categoryIds;
-            const visOverride = override.visOverride;
-            for (const categoryId of categoryIds) {
-                if (this.findAndUpdateOverrideInArray(modelId, categoryId, visOverride)) {
-                    anyChanged = true;
-                    if (PerModelCategoryVisibility.Override.None !== visOverride) {
-                        catIdsToLoad.push(categoryId);
-                    }
-                }
-            }
+            if (this.applyOverride(override.modelId, categoryIds, override.visOverride, catIdsToLoad))
+                anyChanged = true;
         }
         if (anyChanged) {
             this._vp.setViewedCategoriesPerModelChanged();
@@ -104,44 +132,17 @@ class PerModelCategoryVisibilityOverrides extends core_bentley_1.SortedArray {
                 this._vp.subcategories.push(iModelToUse.subcategories, catIdsToLoad, () => this._vp.setViewedCategoriesPerModelChanged());
             }
         }
-        return;
-    }
-    /** Find and update the override in the array of overrides. If override not found, adds it to the array.
-     *  If the array was changed, returns true. */
-    findAndUpdateOverrideInArray(modelId, categoryId, override) {
-        const ovr = this._scratch;
-        ovr.reset(modelId, categoryId, false);
-        let changed = false;
-        const index = this.indexOf(ovr);
-        if (-1 === index) {
-            if (PerModelCategoryVisibility.Override.None !== override) {
-                this.insert(new PerModelCategoryVisibilityOverride(modelId, categoryId, PerModelCategoryVisibility.Override.Show === override));
-                changed = true;
-            }
-        }
-        else {
-            if (PerModelCategoryVisibility.Override.None === override) {
-                this._array.splice(index, 1);
-                changed = true;
-            }
-            else if (this._array[index].visible !== (PerModelCategoryVisibility.Override.Show === override)) {
-                this._array[index].visible = (PerModelCategoryVisibility.Override.Show === override);
-                changed = true;
-            }
-        }
-        return changed;
     }
     setOverride(modelIds, categoryIds, override) {
+        const categoryIdIterable = core_bentley_1.Id64.iterable(categoryIds);
         let changed = false;
         for (const modelId of core_bentley_1.Id64.iterable(modelIds)) {
-            for (const categoryId of core_bentley_1.Id64.iterable(categoryIds)) {
-                if (this.findAndUpdateOverrideInArray(modelId, categoryId, override))
-                    changed = true;
-            }
+            if (this.applyOverride(modelId, categoryIdIterable, override))
+                changed = true;
         }
         if (changed) {
             this._vp.setViewedCategoriesPerModelChanged();
-            if (PerModelCategoryVisibility.Override.None !== override) {
+            if (override !== PerModelCategoryVisibility.Override.None) {
                 // Ensure subcategories loaded.
                 this._vp.subcategories.push(this._vp.iModel.subcategories, categoryIds, () => this._vp.setViewedCategoriesPerModelChanged());
             }
@@ -149,30 +150,32 @@ class PerModelCategoryVisibilityOverrides extends core_bentley_1.SortedArray {
     }
     clearOverrides(modelIds) {
         if (undefined === modelIds) {
-            if (0 < this.length) {
-                this.clear();
+            if (this._map.size > 0) {
+                this._map.clear();
+                this._set.clear();
                 this._vp.setViewedCategoriesPerModelChanged();
             }
             return;
         }
-        for (let i = 0; i < this.length;) {
-            const ovr = this._array[i];
-            let removed = false;
-            for (const modelId of core_bentley_1.Id64.iterable(modelIds)) {
-                if (modelId === ovr.modelId) {
-                    this._array.splice(i, 1);
-                    this._vp.setViewedCategoriesPerModelChanged();
-                    removed = true;
-                    break;
-                }
+        let changed = false;
+        for (const modelId of core_bentley_1.Id64.iterable(modelIds)) {
+            const modelEntry = this._map.get(modelId);
+            if (!modelEntry) {
+                continue;
+            }
+            changed = true;
+            for (const overrideEntry of modelEntry.values()) {
+                this._set.delete(overrideEntry);
             }
-            if (!removed)
-                ++i;
+            this._map.delete(modelId);
+        }
+        if (changed) {
+            this._vp.setViewedCategoriesPerModelChanged();
         }
     }
     addOverrides(fs, ovrs) {
         const cache = this._vp.iModel.subcategories;
-        for (const ovr of this._array) {
+        for (const ovr of this._set) {
             const subcats = cache.getSubCategories(ovr.categoryId);
             if (undefined === subcats)
                 continue;
@@ -182,7 +185,6 @@ class PerModelCategoryVisibilityOverrides extends core_bentley_1.SortedArray {
             /* if (!this._vp.view.viewsModel(ovr.modelId))
               continue; */
             // ###TODO: Avoid recomputing upper and lower portions of modelId if modelId repeated.
-            // (Array is sorted first by modelId).
             // Also avoid computing if no effective overrides.
             const modelLo = core_bentley_1.Id64.getLowerUint32(ovr.modelId);
             const modelHi = core_bentley_1.Id64.getUpperUint32(ovr.modelId);