@itwin/presentation-frontend 5.0.0-dev.9 → 5.0.0-dev.90

package/lib/cjs/presentation-frontend/selection/SelectionHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionHandler.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHandler.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 UnifiedSelection\r\n */\r\n\r\nimport { DisposableList, IDisposable } from \"@itwin/core-bentley\";\r\nimport { IModelConnection } from \"@itwin/core-frontend\";\r\nimport { Keys, KeySet } from \"@itwin/presentation-common\";\r\nimport { ISelectionProvider } from \"./ISelectionProvider\";\r\nimport { SelectionChangeEventArgs, SelectionChangesListener } from \"./SelectionChangeEvent\";\r\nimport { SelectionManager } from \"./SelectionManager\";\r\n\r\n/**\r\n * Properties for creating a `SelectionHandler` instance.\r\n * @public\r\n */\r\nexport interface SelectionHandlerProps {\r\n  /** SelectionManager used to store overall selection. */\r\n  manager: SelectionManager;\r\n  /** iModel connection the selection changes will be associated with. */\r\n  imodel: IModelConnection;\r\n  /**\r\n   * Name of the selection handler. This is an identifier of what caused the\r\n   * selection to change, set as `SelectionChangeEventArgs.source` when firing\r\n   * selection change events. `SelectionHandler.shouldHandle` uses `name` to filter\r\n   * events that it doesn't need to handle.\r\n   */\r\n  name: string;\r\n  /**\r\n   * ID of presentation ruleset used by the component using this handler. The ID is set as\r\n   * `SelectionChangeEventArgs.rulesetId` when making selection changes and event\r\n   * listeners can use or ignore this information.\r\n   */\r\n  rulesetId?: string;\r\n  /** Callback function called when selection changes. */\r\n  onSelect?: SelectionChangesListener;\r\n}\r\n\r\n/**\r\n * A class that handles selection changes and helps to change\r\n * internal the selection state.\r\n *\r\n * @public\r\n */\r\nexport class SelectionHandler implements IDisposable {\r\n  private _inSelect: boolean;\r\n  private _disposables: DisposableList;\r\n\r\n  /** Selection manager used by this handler to manage selection */\r\n  public readonly manager: SelectionManager;\r\n  /** Name that's used as `SelectionChangeEventArgs.source` when making selection changes */\r\n  public name: string;\r\n  /** iModel whose selection is being handled */\r\n  public imodel: IModelConnection;\r\n  /**\r\n   * Id of a ruleset selection changes will be associated with.\r\n   * @see `SelectionHandlerProps.rulesetId`\r\n   */\r\n  public rulesetId?: string;\r\n  /** Callback function called when selection changes */\r\n  public onSelect?: SelectionChangesListener;\r\n\r\n  /**\r\n   * Constructor.\r\n   */\r\n  constructor(props: SelectionHandlerProps) {\r\n    this._inSelect = false;\r\n    this.manager = props.manager;\r\n    this._disposables = new DisposableList();\r\n    this.name = props.name;\r\n    this.rulesetId = props.rulesetId;\r\n    this.imodel = props.imodel;\r\n    this.onSelect = props.onSelect;\r\n    this._disposables.add(this.manager.selectionChange.addListener(this.onSelectionChanged));\r\n  }\r\n\r\n  /**\r\n   * Destructor. Must be called before disposing this object to make sure it cleans\r\n   * up correctly.\r\n   */\r\n  public dispose(): void {\r\n    this._disposables.dispose();\r\n  }\r\n\r\n  /**\r\n   * Called when the selection changes. Handles this callback by first checking whether\r\n   * the event should be handled at all (using the `shouldHandle` method) and then calling `onSelect`\r\n   */\r\n  protected onSelectionChanged = (evt: SelectionChangeEventArgs, provider: ISelectionProvider): void => {\r\n    if (!this.onSelect || !this.shouldHandle(evt)) {\r\n      return;\r\n    }\r\n\r\n    this._inSelect = true;\r\n    this.onSelect(evt, provider);\r\n    this._inSelect = false;\r\n  };\r\n\r\n  /** Called to check whether the event should be handled by this handler */\r\n  protected shouldHandle(evt: SelectionChangeEventArgs): boolean {\r\n    if (this.name === evt.source) {\r\n      return false;\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Get selection levels for the imodel managed by this handler */\r\n  public getSelectionLevels(): number[] {\r\n    return this.manager.getSelectionLevels(this.imodel);\r\n  }\r\n\r\n  /**\r\n   * Get selection for the imodel managed by this handler.\r\n   * @param level Level of the selection to get. Defaults to 0.\r\n   */\r\n  public getSelection(level?: number): Readonly<KeySet> {\r\n    return this.manager.getSelection(this.imodel, level);\r\n  }\r\n\r\n  /**\r\n   * Add to selection.\r\n   * @param keys The keys to add to selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public addToSelection(keys: Keys, level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.addToSelection(this.name, this.imodel, keys, level, this.rulesetId);\r\n  }\r\n\r\n  /**\r\n   * Remove from selection.\r\n   * @param keys The keys to remove from selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public removeFromSelection(keys: Keys, level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.removeFromSelection(this.name, this.imodel, keys, level, this.rulesetId);\r\n  }\r\n\r\n  /**\r\n   * Change selection.\r\n   * @param keys The keys indicating the new selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public replaceSelection(keys: Keys, level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.replaceSelection(this.name, this.imodel, keys, level, this.rulesetId);\r\n  }\r\n\r\n  /**\r\n   * Clear selection.\r\n   * @param level Level of the selection.\r\n   */\r\n  public clearSelection(level: number = 0): void {\r\n    if (this._inSelect) {\r\n      return;\r\n    }\r\n\r\n    return this.manager.clearSelection(this.name, this.imodel, level, this.rulesetId);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SelectionHandler.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/* eslint-disable @typescript-eslint/no-deprecated */\n/** @packageDocumentation\n * @module UnifiedSelection\n */\n\nimport { DisposableList } from \"@itwin/core-bentley\";\nimport { IModelConnection } from \"@itwin/core-frontend\";\nimport { Keys, KeySet } from \"@itwin/presentation-common\";\nimport { ISelectionProvider } from \"./ISelectionProvider\";\nimport { SelectionChangeEventArgs, SelectionChangesListener } from \"./SelectionChangeEvent\";\nimport { SelectionManager } from \"./SelectionManager\";\n\n/**\n * Properties for creating a `SelectionHandler` instance.\n * @public\n * @deprecated in 5.0. Use `SelectionStorage` from [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md#basic-usage) package instead.\n */\nexport interface SelectionHandlerProps {\n  /** SelectionManager used to store overall selection. */\n  manager: SelectionManager;\n  /** iModel connection the selection changes will be associated with. */\n  imodel: IModelConnection;\n  /**\n   * Name of the selection handler. This is an identifier of what caused the\n   * selection to change, set as `SelectionChangeEventArgs.source` when firing\n   * selection change events. `SelectionHandler.shouldHandle` uses `name` to filter\n   * events that it doesn't need to handle.\n   */\n  name: string;\n  /**\n   * ID of presentation ruleset used by the component using this handler. The ID is set as\n   * `SelectionChangeEventArgs.rulesetId` when making selection changes and event\n   * listeners can use or ignore this information.\n   */\n  rulesetId?: string;\n  /** Callback function called when selection changes. */\n  onSelect?: SelectionChangesListener;\n}\n\n/**\n * A class that handles selection changes and helps to change\n * internal the selection state.\n *\n * @public\n * @deprecated in 5.0. Use `SelectionStorage` from [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md#basic-usage) package instead.\n */\nexport class SelectionHandler implements Disposable {\n  private _inSelect: boolean;\n  private _disposables: DisposableList;\n\n  /** Selection manager used by this handler to manage selection */\n  public readonly manager: SelectionManager;\n  /** Name that's used as `SelectionChangeEventArgs.source` when making selection changes */\n  public name: string;\n  /** iModel whose selection is being handled */\n  public imodel: IModelConnection;\n  /**\n   * Id of a ruleset selection changes will be associated with.\n   * @see `SelectionHandlerProps.rulesetId`\n   */\n  public rulesetId?: string;\n  /** Callback function called when selection changes */\n  public onSelect?: SelectionChangesListener;\n\n  /**\n   * Constructor.\n   */\n  constructor(props: SelectionHandlerProps) {\n    this._inSelect = false;\n    this.manager = props.manager;\n    this._disposables = new DisposableList();\n    this.name = props.name;\n    this.rulesetId = props.rulesetId;\n    this.imodel = props.imodel;\n    this.onSelect = props.onSelect;\n    this._disposables.add(this.manager.selectionChange.addListener(this.onSelectionChanged));\n  }\n\n  /**\n   * Destructor. Must be called before disposing this object to make sure it cleans\n   * up correctly.\n   */\n  public [Symbol.dispose](): void {\n    this._disposables.dispose();\n  }\n\n  /** @deprecated in 5.0 Use [Symbol.dispose] instead. */\n  // istanbul ignore next\n  public dispose() {\n    this[Symbol.dispose]();\n  }\n\n  /**\n   * Called when the selection changes. Handles this callback by first checking whether\n   * the event should be handled at all (using the `shouldHandle` method) and then calling `onSelect`\n   */\n  protected onSelectionChanged = (evt: SelectionChangeEventArgs, provider: ISelectionProvider): void => {\n    if (!this.onSelect || !this.shouldHandle(evt)) {\n      return;\n    }\n\n    this._inSelect = true;\n    this.onSelect(evt, provider);\n    this._inSelect = false;\n  };\n\n  /** Called to check whether the event should be handled by this handler */\n  protected shouldHandle(evt: SelectionChangeEventArgs): boolean {\n    if (this.name === evt.source) {\n      return false;\n    }\n    return true;\n  }\n\n  /** Get selection levels for the imodel managed by this handler */\n  public getSelectionLevels(): number[] {\n    return this.manager.getSelectionLevels(this.imodel);\n  }\n\n  /**\n   * Get selection for the imodel managed by this handler.\n   * @param level Level of the selection to get. Defaults to 0.\n   */\n  public getSelection(level?: number): Readonly<KeySet> {\n    return this.manager.getSelection(this.imodel, level);\n  }\n\n  /**\n   * Add to selection.\n   * @param keys The keys to add to selection.\n   * @param level Level of the selection.\n   */\n  public addToSelection(keys: Keys, level: number = 0): void {\n    if (this._inSelect) {\n      return;\n    }\n\n    return this.manager.addToSelection(this.name, this.imodel, keys, level, this.rulesetId);\n  }\n\n  /**\n   * Remove from selection.\n   * @param keys The keys to remove from selection.\n   * @param level Level of the selection.\n   */\n  public removeFromSelection(keys: Keys, level: number = 0): void {\n    if (this._inSelect) {\n      return;\n    }\n\n    return this.manager.removeFromSelection(this.name, this.imodel, keys, level, this.rulesetId);\n  }\n\n  /**\n   * Change selection.\n   * @param keys The keys indicating the new selection.\n   * @param level Level of the selection.\n   */\n  public replaceSelection(keys: Keys, level: number = 0): void {\n    if (this._inSelect) {\n      return;\n    }\n\n    return this.manager.replaceSelection(this.name, this.imodel, keys, level, this.rulesetId);\n  }\n\n  /**\n   * Clear selection.\n   * @param level Level of the selection.\n   */\n  public clearSelection(level: number = 0): void {\n    if (this._inSelect) {\n      return;\n    }\n\n    return this.manager.clearSelection(this.name, this.imodel, level, this.rulesetId);\n  }\n}\n"]}

package/lib/cjs/presentation-frontend/selection/SelectionHelper.d.ts

@@ -5,6 +5,8 @@ import { Key, Keys } from "@itwin/presentation-common";
 /**
  * Helper class for working with selection.
  * @public
+ * @deprecated in 5.0. This is unnecessary after switching to [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md)
+ * package. A similar method to this in the new system is `Selectables.load()`.
  */
 export declare class SelectionHelper {
     private constructor();

package/lib/cjs/presentation-frontend/selection/SelectionHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionHelper.d.ts","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAW,MAAM,4BAA4B,CAAC;AAEhE;;;GAGG;AACH,qBAAa,eAAe;IAE1B,OAAO;IAEP;;;;OAIG;WACW,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE;CAe/D"}
+{"version":3,"file":"SelectionHelper.d.ts","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAW,MAAM,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,qBAAa,eAAe;IAE1B,OAAO;IAEP;;;;OAIG;WACW,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE;CAe/D"}

package/lib/cjs/presentation-frontend/selection/SelectionHelper.js

@@ -12,6 +12,8 @@ const presentation_common_1 = require("@itwin/presentation-common");
 /**
  * Helper class for working with selection.
  * @public
+ * @deprecated in 5.0. This is unnecessary after switching to [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md)
+ * package. A similar method to this in the new system is `Selectables.load()`.
  */
 class SelectionHelper {
     // istanbul ignore next

package/lib/cjs/presentation-frontend/selection/SelectionHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionHelper.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH,oEAAgE;AAEhE;;;GAGG;AACH,MAAa,eAAe;IAC1B,uBAAuB;IACvB,gBAAuB,CAAC;IAExB;;;;OAIG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAAoB;QACpD,MAAM,MAAM,GAAG,IAAI,KAAK,EAAO,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YACxB,IAAI,yBAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,6BAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAxBD,0CAwBC","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 UnifiedSelection\r\n */\r\n\r\nimport { Key, Keys, NodeKey } from \"@itwin/presentation-common\";\r\n\r\n/**\r\n * Helper class for working with selection.\r\n * @public\r\n */\r\nexport class SelectionHelper {\r\n  // istanbul ignore next\r\n  private constructor() {}\r\n\r\n  /**\r\n   * Re-map the given keyset for selection. This means all instance node keys get converted\r\n   * to instance keys, because in that case we want to select instances instead of nodes. All\r\n   * other types of keys ar left as is.\r\n   */\r\n  public static getKeysForSelection(keys: Readonly<Keys>): Key[] {\r\n    const result = new Array<Key>();\r\n    keys.forEach((key: Key) => {\r\n      if (Key.isNodeKey(key)) {\r\n        if (NodeKey.isInstancesNodeKey(key)) {\r\n          result.push(...key.instanceKeys);\r\n        } else {\r\n          result.push(key);\r\n        }\r\n      } else {\r\n        result.push(key);\r\n      }\r\n    });\r\n    return result;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SelectionHelper.js","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionHelper.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH,oEAAgE;AAEhE;;;;;GAKG;AACH,MAAa,eAAe;IAC1B,uBAAuB;IACvB,gBAAuB,CAAC;IAExB;;;;OAIG;IACI,MAAM,CAAC,mBAAmB,CAAC,IAAoB;QACpD,MAAM,MAAM,GAAG,IAAI,KAAK,EAAO,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YACxB,IAAI,yBAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,6BAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAxBD,0CAwBC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module UnifiedSelection\n */\n\nimport { Key, Keys, NodeKey } from \"@itwin/presentation-common\";\n\n/**\n * Helper class for working with selection.\n * @public\n * @deprecated in 5.0. This is unnecessary after switching to [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md)\n * package. A similar method to this in the new system is `Selectables.load()`.\n */\nexport class SelectionHelper {\n  // istanbul ignore next\n  private constructor() {}\n\n  /**\n   * Re-map the given keyset for selection. This means all instance node keys get converted\n   * to instance keys, because in that case we want to select instances instead of nodes. All\n   * other types of keys ar left as is.\n   */\n  public static getKeysForSelection(keys: Readonly<Keys>): Key[] {\n    const result = new Array<Key>();\n    keys.forEach((key: Key) => {\n      if (Key.isNodeKey(key)) {\n        if (NodeKey.isInstancesNodeKey(key)) {\n          result.push(...key.instanceKeys);\n        } else {\n          result.push(key);\n        }\n      } else {\n        result.push(key);\n      }\n    });\n    return result;\n  }\n}\n"]}

package/lib/cjs/presentation-frontend/selection/SelectionManager.d.ts

@@ -1,7 +1,7 @@
 /** @packageDocumentation
  * @module UnifiedSelection
  */
-import { Id64Arg, IDisposable } from "@itwin/core-bentley";
+import { Id64Arg } from "@itwin/core-bentley";
 import { IModelConnection } from "@itwin/core-frontend";
 import { Keys, KeySet, SelectionScope, SelectionScopeProps } from "@itwin/presentation-common";
 import { SelectionStorage } from "@itwin/unified-selection";
@@ -12,6 +12,7 @@ import { SelectionScopesManager } from "./SelectionScopesManager";
 /**
  * Properties for creating [[SelectionManager]].
  * @public
+ * @deprecated in 5.0. Use `SelectionStorage` from [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md) package instead.
  */
 export interface SelectionManagerProps {
     /** A manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
@@ -21,13 +22,22 @@ export interface SelectionManagerProps {
      * and maintains storage.
      */
     selectionStorage?: SelectionStorage;
+    /**
+     * An optional function that returns a key for the given iModel. The key is what "glues" iModel selection
+     * changes made in `selectionStorage`, where iModels are identified by key, and `SelectionManager`, where
+     * iModels are specified as `IModelConnection`.
+     *
+     * If not provided, [IModelConnection.key]($core-frontend) or [IModelConnection.name]($core-frontend) is used.
+     */
+    imodelKeyFactory?: (imodel: IModelConnection) => string;
 }
 /**
  * The selection manager which stores the overall selection.
  * @public
+ * @deprecated in 5.0. Use `SelectionStorage` from [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md) package instead.
  */
-export declare class SelectionManager implements ISelectionProvider {
-    private _selectionStorage;
+export declare class SelectionManager implements ISelectionProvider, Disposable {
+    private _imodelKeyFactory;
     private _imodelToolSelectionSyncHandlers;
     private _hiliteSetProviders;
     private _ownsStorage;
@@ -36,6 +46,11 @@ export declare class SelectionManager implements ISelectionProvider {
     private _selectionChanges;
     private _selectionEventsSubscription;
     private _listeners;
+    /**
+     * Underlying selection storage used by this selection manager. Ideally, consumers should use
+     * the storage directly instead of using this manager to manipulate selection.
+     */
+    readonly selectionStorage: SelectionStorage;
     /** An event which gets broadcasted on selection changes */
     readonly selectionChange: SelectionChangeEvent;
     /** Manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
@@ -44,6 +59,8 @@ export declare class SelectionManager implements ISelectionProvider {
      * Creates an instance of SelectionManager.
      */
     constructor(props: SelectionManagerProps);
+    [Symbol.dispose](): void;
+    /** @deprecated in 5.0. Use [Symbol.dispose] instead. */
     dispose(): void;
     private onConnectionClose;
     /** @internal */
@@ -53,10 +70,13 @@ export declare class SelectionManager implements ISelectionProvider {
      */
     setSyncWithIModelToolSelection(imodel: IModelConnection, sync?: boolean): void;
     /**
-     * Temporarily suspends tool selection synchronization until the returned `IDisposable`
+     * Temporarily suspends tool selection synchronization until the returned `Disposable`
      * is disposed.
      */
-    suspendIModelToolSelectionSync(imodel: IModelConnection): IDisposable;
+    suspendIModelToolSelectionSync(imodel: IModelConnection): {
+        [Symbol.dispose]: () => void;
+        dispose: () => void;
+    };
     /** Get the selection levels currently stored in this manager for the specified imodel */
     getSelectionLevels(imodel: IModelConnection): number[];
     /**
@@ -147,7 +167,7 @@ export declare class SelectionManager implements ISelectionProvider {
     private streamSelectionEvents;
 }
 /** @internal */
-export declare class ToolSelectionSyncHandler implements IDisposable {
+export declare class ToolSelectionSyncHandler implements Disposable {
     private _selectionSourceName;
     private _logicalSelection;
     private _imodel;
@@ -155,7 +175,7 @@ export declare class ToolSelectionSyncHandler implements IDisposable {
     private _asyncsTracker;
     isSuspended?: boolean;
     constructor(imodel: IModelConnection, logicalSelection: SelectionManager);
-    dispose(): void;
+    [Symbol.dispose](): void;
     /** note: used only it tests */
     get pendingAsyncs(): Set<string>;
     private onToolSelectionChanged;

package/lib/cjs/presentation-frontend/selection/SelectionManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionManager.d.ts","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionManager.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAQ,OAAO,EAAa,WAAW,EAAS,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAA4C,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAoD,IAAI,EAAE,MAAM,EAAW,cAAc,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1J,OAAO,EAKL,gBAAgB,EAIjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAiD,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAA6B,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAE7F;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,gCAAgC,CAA+F;IACvI,OAAO,CAAC,mBAAmB,CAAkD;IAC7E,OAAO,CAAC,YAAY,CAAU;IAE9B,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,iBAAiB,CAAkD;IAC3E,OAAO,CAAC,4BAA4B,CAAe;IACnD,OAAO,CAAC,UAAU,CAAyB;IAE3C,2DAA2D;IAC3D,SAAgB,eAAe,EAAE,oBAAoB,CAAC;IAEtD,kGAAkG;IAClG,SAAgB,MAAM,EAAE,sBAAsB,CAAC;IAE/C;;OAEG;gBACS,KAAK,EAAE,qBAAqB;IAmBjC,OAAO;IAKd,OAAO,CAAC,iBAAiB;IAUzB,gBAAgB;IAET,2BAA2B,CAAC,MAAM,EAAE,gBAAgB;IAI3D;;OAEG;IACI,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,UAAO;IAqB3E;;;OAGG;IACI,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAW5E,yFAAyF;IAClF,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAI7D;;;;;;OAMG;IACI,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,GAAE,MAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;IAIlF,OAAO,CAAC,WAAW;IAoCnB;;;;;;;OAOG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAaxH;;;;;;;OAOG;IACI,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAa7H;;;;;;;OAOG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAa1H;;;;;;OAMG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAa5G;;;;;;;;OAQG;IACU,uBAAuB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,GAAG,cAAc,GAAG,MAAM,EACpD,KAAK,GAAE,MAAU,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;;;;OAQG;IACU,4BAA4B,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,GAAG,cAAc,GAAG,MAAM,EACpD,KAAK,GAAE,MAAU,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;;;;OAQG;IACU,yBAAyB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,GAAG,cAAc,GAAG,MAAM,EACpD,KAAK,GAAE,MAAU,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAKhB;;;OAGG;IACU,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIvE;;;OAGG;IACI,oBAAoB,CAAC,MAAM,EAAE,gBAAgB;IAIpD,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,qBAAqB;CA8B9B;AAED,gBAAgB;AAChB,qBAAa,wBAAyB,YAAW,WAAW;IAC1D,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,uCAAuC,CAAa;IAC5D,OAAO,CAAC,cAAc,CAA2B;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;gBAEV,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB;IAMxE,OAAO;IAId,+BAA+B;IAC/B,IAAW,aAAa,gBAEvB;IAED,OAAO,CAAC,sBAAsB,CA4D5B;CACH"}
+{"version":3,"file":"SelectionManager.d.ts","sourceRoot":"","sources":["../../../../src/presentation-frontend/selection/SelectionManager.ts"],"names":[],"mappings":"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"}

package/lib/cjs/presentation-frontend/selection/SelectionManager.js

@@ -3,9 +3,62 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
+/* eslint-disable @typescript-eslint/no-deprecated */
 /** @packageDocumentation
  * @module UnifiedSelection
  */
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolSelectionSyncHandler = exports.SelectionManager = void 0;
 const rxjs_1 = require("rxjs");
@@ -20,42 +73,62 @@ const SelectionScopesManager_1 = require("./SelectionScopesManager");
 /**
  * The selection manager which stores the overall selection.
  * @public
+ * @deprecated in 5.0. Use `SelectionStorage` from [@itwin/unified-selection](https://github.com/iTwin/presentation/blob/master/packages/unified-selection/README.md) package instead.
  */
 class SelectionManager {
+    _imodelKeyFactory;
+    _imodelToolSelectionSyncHandlers = new Map();
+    _hiliteSetProviders = new Map();
+    _ownsStorage;
+    _knownIModels = new Set();
+    _currentSelection = new CurrentSelectionStorage();
+    _selectionChanges = new rxjs_1.Subject();
+    _selectionEventsSubscription;
+    _listeners = [];
+    /**
+     * Underlying selection storage used by this selection manager. Ideally, consumers should use
+     * the storage directly instead of using this manager to manipulate selection.
+     */
+    selectionStorage;
+    /** An event which gets broadcasted on selection changes */
+    selectionChange;
+    /** Manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
+    scopes;
     /**
      * Creates an instance of SelectionManager.
      */
     constructor(props) {
-        this._imodelToolSelectionSyncHandlers = new Map();
-        this._hiliteSetProviders = new Map();
-        this._knownIModels = new Map();
-        this._currentSelection = new CurrentSelectionStorage();
-        this._selectionChanges = new rxjs_1.Subject();
-        this._listeners = [];
         this.selectionChange = new SelectionChangeEvent_1.SelectionChangeEvent();
         this.scopes = props.scopes;
-        this._selectionStorage = props.selectionStorage ?? (0, unified_selection_1.createStorage)();
+        this.selectionStorage = props.selectionStorage ?? (0, unified_selection_1.createStorage)();
+        this._imodelKeyFactory = props.imodelKeyFactory ?? ((imodel) => (imodel.key.length ? imodel.key : imodel.name));
         this._ownsStorage = props.selectionStorage === undefined;
-        this._selectionStorage.selectionChangeEvent.addListener((args) => this._selectionChanges.next(args));
+        this.selectionStorage.selectionChangeEvent.addListener((args) => this._selectionChanges.next(args));
         this._selectionEventsSubscription = this.streamSelectionEvents();
         this._listeners.push(core_frontend_1.IModelConnection.onOpen.addListener((imodel) => {
-            this._knownIModels.set(imodel.key, imodel);
+            this._knownIModels.add(imodel);
         }));
         this._listeners.push(core_frontend_1.IModelConnection.onClose.addListener((imodel) => {
             this.onConnectionClose(imodel);
         }));
     }
-    dispose() {
+    [Symbol.dispose]() {
         this._selectionEventsSubscription.unsubscribe();
         this._listeners.forEach((dispose) => dispose());
     }
+    /** @deprecated in 5.0. Use [Symbol.dispose] instead. */
+    // istanbul ignore next
+    dispose() {
+        this[Symbol.dispose]();
+    }
     onConnectionClose(imodel) {
+        const imodelKey = this._imodelKeyFactory(imodel);
         this._hiliteSetProviders.delete(imodel);
-        this._knownIModels.delete(imodel.key);
-        this._currentSelection.clear(imodel.key);
+        this._knownIModels.delete(imodel);
+        this._currentSelection.clear(imodelKey);
         if (this._ownsStorage) {
             this.clearSelection("Connection Close Event", imodel);
-            this._selectionStorage.clearStorage({ iModelKey: imodel.key });
+            this.selectionStorage.clearStorage({ imodelKey });
         }
     }
     /** @internal */
@@ -84,27 +157,30 @@ class SelectionManager {
                 }
                 else {
                     this._imodelToolSelectionSyncHandlers.delete(imodel);
-                    registration.handler.dispose();
+                    registration.handler[Symbol.dispose]();
                 }
             }
         }
     }
     /**
-     * Temporarily suspends tool selection synchronization until the returned `IDisposable`
+     * Temporarily suspends tool selection synchronization until the returned `Disposable`
      * is disposed.
      */
     suspendIModelToolSelectionSync(imodel) {
         const registration = this._imodelToolSelectionSyncHandlers.get(imodel);
         if (!registration) {
-            return { dispose: () => { } };
+            const noop = () => { };
+            return { [Symbol.dispose]: noop, dispose: noop };
         }
         const wasSuspended = registration.handler.isSuspended;
         registration.handler.isSuspended = true;
-        return { dispose: () => (registration.handler.isSuspended = wasSuspended) };
+        const doDispose = () => (registration.handler.isSuspended = wasSuspended);
+        return { [Symbol.dispose]: doDispose, dispose: doDispose };
     }
     /** Get the selection levels currently stored in this manager for the specified imodel */
     getSelectionLevels(imodel) {
-        return this._selectionStorage.getSelectionLevels({ iModelKey: imodel.key });
+        const imodelKey = this._imodelKeyFactory(imodel);
+        return this.selectionStorage.getSelectionLevels({ imodelKey });
     }
     /**
      * Get the selection currently stored in this manager
@@ -114,39 +190,39 @@ class SelectionManager {
      * latest selection after changes.
      */
     getSelection(imodel, level = 0) {
-        return this._currentSelection.getSelection(imodel.key, level);
+        const imodelKey = this._imodelKeyFactory(imodel);
+        return this._currentSelection.getSelection(imodelKey, level);
     }
     handleEvent(evt) {
-        if (!this._knownIModels.has(evt.imodel.key)) {
-            this._knownIModels.set(evt.imodel.key, evt.imodel);
-        }
+        const imodelKey = this._imodelKeyFactory(evt.imodel);
+        this._knownIModels.add(evt.imodel);
         switch (evt.changeType) {
             case SelectionChangeEvent_1.SelectionChangeType.Add:
-                this._selectionStorage.addToSelection({
-                    iModelKey: evt.imodel.key,
+                this.selectionStorage.addToSelection({
+                    imodelKey,
                     source: evt.source,
                     level: evt.level,
                     selectables: keysToSelectable(evt.imodel, evt.keys),
                 });
                 break;
             case SelectionChangeEvent_1.SelectionChangeType.Remove:
-                this._selectionStorage.removeFromSelection({
-                    iModelKey: evt.imodel.key,
+                this.selectionStorage.removeFromSelection({
+                    imodelKey,
                     source: evt.source,
                     level: evt.level,
                     selectables: keysToSelectable(evt.imodel, evt.keys),
                 });
                 break;
             case SelectionChangeEvent_1.SelectionChangeType.Replace:
-                this._selectionStorage.replaceSelection({
-                    iModelKey: evt.imodel.key,
+                this.selectionStorage.replaceSelection({
+                    imodelKey,
                     source: evt.source,
                     level: evt.level,
                     selectables: keysToSelectable(evt.imodel, evt.keys),
                 });
                 break;
             case SelectionChangeEvent_1.SelectionChangeType.Clear:
-                this._selectionStorage.clearSelection({ iModelKey: evt.imodel.key, source: evt.source, level: evt.level });
+                this.selectionStorage.clearSelection({ imodelKey, source: evt.source, level: evt.level });
                 break;
         }
     }
@@ -293,9 +369,9 @@ class SelectionManager {
     streamSelectionEvents() {
         return this._selectionChanges
             .pipe((0, rxjs_1.mergeMap)((args) => {
-            const currentSelectables = this._selectionStorage.getSelection({ iModelKey: args.imodelKey, level: args.level });
+            const currentSelectables = this.selectionStorage.getSelection({ imodelKey: args.imodelKey, level: args.level });
             return this._currentSelection.computeSelection(args.imodelKey, args.level, currentSelectables, args.selectables).pipe((0, rxjs_1.mergeMap)(({ level, changedSelection }) => {
-                const imodel = this._knownIModels.get(args.imodelKey);
+                const imodel = findIModel(this._knownIModels, this._imodelKeyFactory, args.imodelKey);
                 // istanbul ignore if
                 if (!imodel) {
                     return rxjs_1.EMPTY;
@@ -318,12 +394,37 @@ class SelectionManager {
     }
 }
 exports.SelectionManager = SelectionManager;
+function findIModel(set, imodelKeyFactory, key) {
+    for (const imodel of set) {
+        if (imodelKeyFactory(imodel) === key) {
+            return imodel;
+        }
+    }
+    return undefined;
+}
 /** @internal */
 class ToolSelectionSyncHandler {
+    _selectionSourceName = "Tool";
+    _logicalSelection;
+    _imodel;
+    _imodelToolSelectionListenerDisposeFunc;
+    _asyncsTracker = new presentation_common_1.AsyncTasksTracker();
+    isSuspended;
     constructor(imodel, logicalSelection) {
-        this._selectionSourceName = "Tool";
-        this._asyncsTracker = new presentation_common_1.AsyncTasksTracker();
-        this.onToolSelectionChanged = async (ev) => {
+        this._imodel = imodel;
+        this._logicalSelection = logicalSelection;
+        this._imodelToolSelectionListenerDisposeFunc = imodel.selectionSet.onChanged.addListener(this.onToolSelectionChanged);
+    }
+    [Symbol.dispose]() {
+        this._imodelToolSelectionListenerDisposeFunc();
+    }
+    /** note: used only it tests */
+    get pendingAsyncs() {
+        return this._asyncsTracker.pendingAsyncs;
+    }
+    onToolSelectionChanged = async (ev) => {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
             // ignore selection change event if the handler is suspended
             if (this.isSuspended) {
                 return;
@@ -339,13 +440,13 @@ class ToolSelectionSyncHandler {
             let ids;
             switch (ev.type) {
                 case core_frontend_1.SelectionSetEventType.Add:
-                    ids = ev.added;
+                    ids = ev.additions;
                     break;
                 case core_frontend_1.SelectionSetEventType.Replace:
-                    ids = ev.set.elements;
+                    ids = ev.set.active;
                     break;
                 default:
-                    ids = ev.removed;
+                    ids = ev.removals;
                     break;
             }
             // we're always using scoped selection changer even if the scope is set to "element" - that
@@ -353,40 +454,33 @@ class ToolSelectionSyncHandler {
             // we can't because otherwise our keys compare fails (presentation components load data with
             // concrete classes)
             const changer = new ScopedSelectionChanger(this._selectionSourceName, this._imodel, this._logicalSelection, (0, SelectionScopesManager_1.createSelectionScopeProps)(this._logicalSelection.scopes.activeScope));
-            // we know what to do immediately on `clear` events
-            if (core_frontend_1.SelectionSetEventType.Clear === ev.type) {
-                await changer.clear(selectionLevel);
-                return;
+            const _r = __addDisposableResource(env_1, this._asyncsTracker.trackAsyncTask(), false);
+            switch (ev.type) {
+                case core_frontend_1.SelectionSetEventType.Add:
+                    await changer.add(ids, selectionLevel);
+                    break;
+                case core_frontend_1.SelectionSetEventType.Replace:
+                    await changer.replace(ids, selectionLevel);
+                    break;
+                case core_frontend_1.SelectionSetEventType.Remove:
+                    await changer.remove(ids, selectionLevel);
+                    break;
+                case core_frontend_1.SelectionSetEventType.Clear:
+                    await changer.clear(selectionLevel);
+                    break;
             }
-            const parsedIds = parseIds(ids);
-            await (0, core_bentley_1.using)(this._asyncsTracker.trackAsyncTask(), async (_r) => {
-                switch (ev.type) {
-                    case core_frontend_1.SelectionSetEventType.Add:
-                        await changer.add(parsedIds.transient, parsedIds.persistent, selectionLevel);
-                        break;
-                    case core_frontend_1.SelectionSetEventType.Replace:
-                        await changer.replace(parsedIds.transient, parsedIds.persistent, selectionLevel);
-                        break;
-                    case core_frontend_1.SelectionSetEventType.Remove:
-                        await changer.remove(parsedIds.transient, parsedIds.persistent, selectionLevel);
-                        break;
-                }
-            });
-        };
-        this._imodel = imodel;
-        this._logicalSelection = logicalSelection;
-        this._imodelToolSelectionListenerDisposeFunc = imodel.selectionSet.onChanged.addListener(this.onToolSelectionChanged);
-    }
-    dispose() {
-        this._imodelToolSelectionListenerDisposeFunc();
-    }
-    /** note: used only it tests */
-    get pendingAsyncs() {
-        return this._asyncsTracker.pendingAsyncs;
-    }
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            __disposeResources(env_1);
+        }
+    };
 }
 exports.ToolSelectionSyncHandler = ToolSelectionSyncHandler;
-const parseIds = (ids) => {
+const parseElementIds = (ids) => {
     let allPersistent = true;
     let allTransient = true;
     for (const id of core_bentley_1.Id64.iterable(ids)) {
@@ -421,13 +515,16 @@ const parseIds = (ids) => {
     }
     return { persistent: persistentElementIds, transient: transientElementIds };
 };
-function addTransientKeys(transientIds, keys) {
-    for (const id of core_bentley_1.Id64.iterable(transientIds)) {
-        keys.add({ className: unified_selection_1.TRANSIENT_ELEMENT_CLASSNAME, id });
+function addKeys(target, className, ids) {
+    for (const id of core_bentley_1.Id64.iterable(ids)) {
+        target.add({ className, id });
     }
 }
-/** @internal */
 class ScopedSelectionChanger {
+    name;
+    imodel;
+    manager;
+    scope;
     constructor(name, imodel, manager, scope) {
         this.name = name;
         this.imodel = imodel;
@@ -437,27 +534,37 @@ class ScopedSelectionChanger {
     async clear(level) {
         this.manager.clearSelection(this.name, this.imodel, level);
     }
-    async add(transientIds, persistentIds, level) {
-        const keys = await this.manager.scopes.computeSelection(this.imodel, persistentIds, this.scope);
-        addTransientKeys(transientIds, keys);
+    async add(ids, level) {
+        const keys = await this.#computeSelection(ids);
         this.manager.addToSelection(this.name, this.imodel, keys, level);
     }
-    async remove(transientIds, persistentIds, level) {
-        const keys = await this.manager.scopes.computeSelection(this.imodel, persistentIds, this.scope);
-        addTransientKeys(transientIds, keys);
+    async remove(ids, level) {
+        const keys = await this.#computeSelection(ids);
         this.manager.removeFromSelection(this.name, this.imodel, keys, level);
     }
-    async replace(transientIds, persistentIds, level) {
-        const keys = await this.manager.scopes.computeSelection(this.imodel, persistentIds, this.scope);
-        addTransientKeys(transientIds, keys);
+    async replace(ids, level) {
+        const keys = await this.#computeSelection(ids);
         this.manager.replaceSelection(this.name, this.imodel, keys, level);
     }
+    async #computeSelection(ids) {
+        let keys = new presentation_common_1.KeySet();
+        if (ids.elements) {
+            const { persistent, transient } = parseElementIds(ids.elements);
+            keys = await this.manager.scopes.computeSelection(this.imodel, persistent, this.scope);
+            addKeys(keys, unified_selection_1.TRANSIENT_ELEMENT_CLASSNAME, transient);
+        }
+        if (ids.models) {
+            addKeys(keys, "BisCore.Model", ids.models);
+        }
+        if (ids.subcategories) {
+            addKeys(keys, "BisCore.SubCategory", ids.subcategories);
+        }
+        return keys;
+    }
 }
 /** Stores current selection in `KeySet` format per iModel.  */
 class CurrentSelectionStorage {
-    constructor() {
-        this._currentSelection = new Map();
-    }
+    _currentSelection = new Map();
     getCurrentSelectionStorage(imodelKey) {
         let storage = this._currentSelection.get(imodelKey);
         if (!storage) {
@@ -481,9 +588,7 @@ class CurrentSelectionStorage {
  * It always stores result of latest resolved call to `computeSelection`.
  */
 class IModelSelectionStorage {
-    constructor() {
-        this._currentSelection = new Map();
-    }
+    _currentSelection = new Map();
     getSelection(level) {
         let entry = this._currentSelection.get(level);
         if (!entry) {