@itwin/presentation-frontend 5.0.0-dev.10 → 5.0.0-dev.102

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

@@ -3,66 +3,135 @@
  * 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");
 const core_bentley_1 = require("@itwin/core-bentley");
 const core_frontend_1 = require("@itwin/core-frontend");
 const presentation_common_1 = require("@itwin/presentation-common");
+const internal_1 = require("@itwin/presentation-common/internal");
 const unified_selection_1 = require("@itwin/unified-selection");
-const Presentation_1 = require("../Presentation");
-const HiliteSetProvider_1 = require("./HiliteSetProvider");
-const SelectionChangeEvent_1 = require("./SelectionChangeEvent");
-const SelectionScopesManager_1 = require("./SelectionScopesManager");
+const Presentation_js_1 = require("../Presentation.js");
+const HiliteSetProvider_js_1 = require("./HiliteSetProvider.js");
+const SelectionChangeEvent_js_1 = require("./SelectionChangeEvent.js");
+const SelectionScopesManager_js_1 = require("./SelectionScopesManager.js");
 /**
  * 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.selectionChange = new SelectionChangeEvent_js_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. */
+    /* c8 ignore next 3 */
+    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 */
-    // istanbul ignore next
-    getToolSelectionSyncHandler(imodel) {
-        return this._imodelToolSelectionSyncHandlers.get(imodel)?.handler;
-    }
     /**
      * Request the manager to sync with imodel's tool selection (see `IModelConnection.selectionSet`).
      */
@@ -84,27 +153,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 +186,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,
+            case SelectionChangeEvent_js_1.SelectionChangeType.Add:
+                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,
+            case SelectionChangeEvent_js_1.SelectionChangeType.Remove:
+                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,
+            case SelectionChangeEvent_js_1.SelectionChangeType.Replace:
+                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 });
+            case SelectionChangeEvent_js_1.SelectionChangeType.Clear:
+                this.selectionStorage.clearSelection({ imodelKey, source: evt.source, level: evt.level });
                 break;
         }
     }
@@ -163,7 +235,7 @@ class SelectionManager {
             source,
             level,
             imodel,
-            changeType: SelectionChangeEvent_1.SelectionChangeType.Add,
+            changeType: SelectionChangeEvent_js_1.SelectionChangeType.Add,
             keys: new presentation_common_1.KeySet(keys),
             timestamp: new Date(),
             rulesetId,
@@ -183,7 +255,7 @@ class SelectionManager {
             source,
             level,
             imodel,
-            changeType: SelectionChangeEvent_1.SelectionChangeType.Remove,
+            changeType: SelectionChangeEvent_js_1.SelectionChangeType.Remove,
             keys: new presentation_common_1.KeySet(keys),
             timestamp: new Date(),
             rulesetId,
@@ -203,7 +275,7 @@ class SelectionManager {
             source,
             level,
             imodel,
-            changeType: SelectionChangeEvent_1.SelectionChangeType.Replace,
+            changeType: SelectionChangeEvent_js_1.SelectionChangeType.Replace,
             keys: new presentation_common_1.KeySet(keys),
             timestamp: new Date(),
             rulesetId,
@@ -222,7 +294,7 @@ class SelectionManager {
             source,
             level,
             imodel,
-            changeType: SelectionChangeEvent_1.SelectionChangeType.Clear,
+            changeType: SelectionChangeEvent_js_1.SelectionChangeType.Clear,
             keys: new presentation_common_1.KeySet(),
             timestamp: new Date(),
             rulesetId,
@@ -285,7 +357,7 @@ class SelectionManager {
     getHiliteSetProvider(imodel) {
         let provider = this._hiliteSetProviders.get(imodel);
         if (!provider) {
-            provider = HiliteSetProvider_1.HiliteSetProvider.create({ imodel });
+            provider = HiliteSetProvider_js_1.HiliteSetProvider.create({ imodel });
             this._hiliteSetProviders.set(imodel, provider);
         }
         return provider;
@@ -293,10 +365,10 @@ 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);
-                // istanbul ignore if
+                const imodel = findIModel(this._knownIModels, this._imodelKeyFactory, args.imodelKey);
+                /* c8 ignore next 3 */
                 if (!imodel) {
                     return rxjs_1.EMPTY;
                 }
@@ -318,12 +390,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 internal_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,54 +436,47 @@ 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
             // makes sure we're adding to selection keys with concrete classes and not "BisCore:Element", which
             // 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 changer = new ScopedSelectionChanger(this._selectionSourceName, this._imodel, this._logicalSelection, (0, SelectionScopesManager_js_1.createSelectionScopeProps)(this._logicalSelection.scopes.activeScope));
+            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 +511,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 +530,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 +584,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) {
@@ -501,7 +602,7 @@ class IModelSelectionStorage {
         }
         clearedLevels.forEach((storedLevel) => {
             const entry = this._currentSelection.get(storedLevel);
-            // istanbul ignore if
+            /* c8 ignore next 3 */
             if (!entry) {
                 return;
             }
@@ -521,13 +622,12 @@ class IModelSelectionStorage {
     }
     setSelection(level, keys, disposer) {
         const currEntry = this._currentSelection.get(level);
-        // istanbul ignore else
         if (currEntry) {
             currEntry.ongoingComputationDisposers.delete(disposer);
         }
         this._currentSelection.set(level, {
             value: keys,
-            ongoingComputationDisposers: currEntry?.ongoingComputationDisposers ?? /* istanbul ignore next */ new Set(),
+            ongoingComputationDisposers: currEntry?.ongoingComputationDisposers ?? /* c8 ignore next */ new Set(),
         });
     }
     computeSelection(level, currSelectables, changedSelectables) {
@@ -606,7 +706,7 @@ async function* createInstanceKeysIterator(imodel, nodeKey) {
         }
         return;
     }
-    const content = await Presentation_1.Presentation.presentation.getContentInstanceKeys({
+    const content = await Presentation_js_1.Presentation.presentation.getContentInstanceKeys({
         imodel,
         keys: new presentation_common_1.KeySet([nodeKey]),
         rulesetOrId: {
@@ -634,13 +734,13 @@ function isNodeKey(data) {
 function getChangeType(type) {
     switch (type) {
         case "add":
-            return SelectionChangeEvent_1.SelectionChangeType.Add;
+            return SelectionChangeEvent_js_1.SelectionChangeType.Add;
         case "remove":
-            return SelectionChangeEvent_1.SelectionChangeType.Remove;
+            return SelectionChangeEvent_js_1.SelectionChangeType.Remove;
         case "replace":
-            return SelectionChangeEvent_1.SelectionChangeType.Replace;
+            return SelectionChangeEvent_js_1.SelectionChangeType.Replace;
         case "clear":
-            return SelectionChangeEvent_1.SelectionChangeType.Clear;
+            return SelectionChangeEvent_js_1.SelectionChangeType.Clear;
     }
 }
 //# sourceMappingURL=SelectionManager.js.map