@itwin/presentation-frontend 4.5.0-dev.40 → 4.5.0-dev.41

package/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Change Log - @itwin/presentation-frontend
 
-This log was last generated on Mon, 25 Mar 2024 16:58:09 GMT and should not be manually modified.
+This log was last generated on Mon, 25 Mar 2024 22:23:34 GMT and should not be manually modified.
+
+## 4.4.8
+Mon, 25 Mar 2024 22:22:26 GMT
+
+_Version update only_
 
 ## 4.4.7
 Fri, 15 Mar 2024 19:15:14 GMT

package/lib/cjs/presentation-frontend/Presentation.d.ts

@@ -13,7 +13,7 @@ export interface PresentationProps {
     /** Props for [[PresentationManager]]. */
     presentation?: PresentationManagerProps;
     /** Props for [[SelectionManager]]. */
-    selection?: SelectionManagerProps;
+    selection?: Partial<SelectionManagerProps>;
     /** Props for [[FavoritePropertiesManager]]. */
     favorites?: FavoritePropertiesManagerProps;
 }

package/lib/cjs/presentation-frontend/Presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Presentation.d.ts","sourceRoot":"","sources":["../../../src/presentation-frontend/Presentation.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AAG5H,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAUvF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IAExC,sCAAsC;IACtC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAElC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,8BAA8B,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAEvB,OAAO;IAEP;;;;;;;;;OASG;WACiB,UAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxE;;;OAGG;WACW,SAAS,IAAI,IAAI;IAsB/B;;;OAGG;WACW,6BAA6B,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IAIrF,4CAA4C;IAC5C,WAAkB,YAAY,IAAI,mBAAmB,CAKpD;IAED,gBAAgB;WACF,sBAAsB,CAAC,KAAK,EAAE,mBAAmB;IAO/D,yCAAyC;IACzC,WAAkB,SAAS,IAAI,gBAAgB,CAK9C;IAED,gBAAgB;WACF,mBAAmB,CAAC,KAAK,EAAE,gBAAgB;IAIzD;;;OAGG;IACH,WAAkB,kBAAkB,IAAI,yBAAyB,CAKhE;IAED,gBAAgB;WACF,4BAA4B,CAAC,KAAK,EAAE,yBAAyB;IAO3E;;OAEG;IACH,WAAkB,YAAY,IAAI,YAAY,CAK7C;IAED,gBAAgB;WACF,eAAe,CAAC,KAAK,EAAE,YAAY;CAGlD"}
+{"version":3,"file":"Presentation.d.ts","sourceRoot":"","sources":["../../../src/presentation-frontend/Presentation.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AAG5H,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAUvF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IAExC,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE3C,+CAA+C;IAC/C,SAAS,CAAC,EAAE,8BAA8B,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAEvB,OAAO;IAEP;;;;;;;;;OASG;WACiB,UAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CxE;;;OAGG;WACW,SAAS,IAAI,IAAI;IAyB/B;;;OAGG;WACW,6BAA6B,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IAIrF,4CAA4C;IAC5C,WAAkB,YAAY,IAAI,mBAAmB,CAKpD;IAED,gBAAgB;WACF,sBAAsB,CAAC,KAAK,EAAE,mBAAmB;IAO/D,yCAAyC;IACzC,WAAkB,SAAS,IAAI,gBAAgB,CAK9C;IAED,gBAAgB;WACF,mBAAmB,CAAC,KAAK,EAAE,gBAAgB;IAIzD;;;OAGG;IACH,WAAkB,kBAAkB,IAAI,yBAAyB,CAKhE;IAED,gBAAgB;WACF,4BAA4B,CAAC,KAAK,EAAE,yBAAyB;IAO3E;;OAEG;IACH,WAAkB,YAAY,IAAI,YAAY,CAK7C;IAED,gBAAgB;WACF,eAAe,CAAC,KAAK,EAAE,YAAY;CAGlD"}

package/lib/cjs/presentation-frontend/Presentation.js

@@ -60,11 +60,13 @@ class Presentation {
             presentationManager = PresentationManager_1.PresentationManager.create(managerProps);
         }
         if (!selectionManager) {
-            selectionManager = new SelectionManager_1.SelectionManager(props?.selection ?? {
-                scopes: new SelectionScopesManager_1.SelectionScopesManager({
-                    rpcRequestsHandler: presentationManager.rpcRequestsHandler,
-                    localeProvider: () => this.presentation.activeLocale,
-                }),
+            selectionManager = new SelectionManager_1.SelectionManager({
+                ...props?.selection,
+                scopes: props?.selection?.scopes ??
+                    new SelectionScopesManager_1.SelectionScopesManager({
+                        rpcRequestsHandler: presentationManager.rpcRequestsHandler,
+                        localeProvider: () => this.presentation.activeLocale,
+                    }),
             });
         }
         if (!favoritePropertiesManager) {
@@ -100,6 +102,9 @@ class Presentation {
             favoritePropertiesManager.dispose();
         }
         favoritePropertiesManager = undefined;
+        if (selectionManager) {
+            selectionManager.dispose();
+        }
         selectionManager = undefined;
         localization = undefined;
     }

package/lib/cjs/presentation-frontend/Presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Presentation.js","sourceRoot":"","sources":["../../../src/presentation-frontend/Presentation.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;AAChG;;GAEG;;;AAEH,wDAAiD;AAEjD,oEAAmF;AACnF,+FAA4H;AAC5H,+FAAyI;AACzI,6DAAkE;AAClE,+DAAsF;AACtF,mEAAuF;AACvF,+EAA4E;AAE5E,IAAI,YAAsC,CAAC;AAC3C,IAAI,mBAAoD,CAAC;AACzD,IAAI,gBAA8C,CAAC;AACnD,IAAI,yBAAgE,CAAC;AACrE,MAAM,sBAAsB,GAA8C,EAAE,CAAC;AAC7E,MAAM,mBAAmB,GAAsB,EAAE,CAAC;AAiBlD;;;;;;;;GAQG;AACH,MAAa,YAAY;IACvB,0BAA0B;IAC1B,gBAAuB,CAAC;IAExB;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAyB;QACtD,IAAI,CAAC,yBAAS,CAAC,WAAW,EAAE;YAC1B,MAAM,IAAI,uCAAiB,CAAC,wCAAkB,CAAC,cAAc,EAAE,yEAAyE,CAAC,CAAC;SAC3I;QACD,IAAI,CAAC,YAAY,EAAE;YACjB,YAAY,GAAG,yBAAS,CAAC,YAAY,CAAC;SACvC;QACD,IAAI,CAAC,mBAAmB,EAAE;YACxB,MAAM,YAAY,GAAG,KAAK,EAAE,YAAY,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE;gBAC9B,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC;gBAC9D,YAAY,CAAC,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;aACzE;YACD,mBAAmB,GAAG,yCAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;SAChE;QACD,IAAI,CAAC,gBAAgB,EAAE;YACrB,gBAAgB,GAAG,IAAI,mCAAgB,CACrC,KAAK,EAAE,SAAS,IAAI;gBAClB,MAAM,EAAE,IAAI,+CAAsB,CAAC;oBACjC,kBAAkB,EAAE,mBAAmB,CAAC,kBAAkB;oBAC1D,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY;iBACrD,CAAC;aACH,CACF,CAAC;SACH;QACD,IAAI,CAAC,yBAAyB,EAAE;YAC9B,yBAAyB,GAAG,IAAI,qDAAyB,CAAC;gBACxD,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,2DAA+B,EAAC,iEAAqC,CAAC,IAAI,CAAC;aAClI,CAAC,CAAC;SACJ;QAED,mBAAmB,CAAC,yBAAyB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,EAAE,6BAA6B,CAAC,MAAM,CAAC,CAAC;QAC7H,mBAAmB,CAAC,uBAAuB,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAErH,MAAM,+CAA0B,CAAC,kBAAkB,EAAE,CAAC;QACtD,KAAK,MAAM,OAAO,IAAI,sBAAsB,EAAE;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAC;YAChC,IAAI,OAAO,EAAE;gBACX,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;aACnC;SACF;IACH,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,SAAS;QACrB,mBAAmB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;QAE/B,IAAI,YAAY,EAAE;YAChB,+CAA0B,CAAC,oBAAoB,EAAE,CAAC;SACnD;QAED,IAAI,mBAAmB,EAAE;YACvB,mBAAmB,CAAC,OAAO,EAAE,CAAC;SAC/B;QACD,mBAAmB,GAAG,SAAS,CAAC;QAEhC,IAAI,yBAAyB,EAAE;YAC7B,yBAAyB,CAAC,OAAO,EAAE,CAAC;SACrC;QACD,yBAAyB,GAAG,SAAS,CAAC;QAEtC,gBAAgB,GAAG,SAAS,CAAC;QAC7B,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,6BAA6B,CAAC,OAAkC;QAC5E,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,4CAA4C;IACrC,MAAM,KAAK,YAAY;QAC5B,IAAI,CAAC,mBAAmB,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;SAC9F;QACD,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,sBAAsB,CAAC,KAA0B;QAC7D,IAAI,mBAAmB,EAAE;YACvB,mBAAmB,CAAC,OAAO,EAAE,CAAC;SAC/B;QACD,mBAAmB,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,yCAAyC;IAClC,MAAM,KAAK,SAAS;QACzB,IAAI,CAAC,gBAAgB,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;SAC9F;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,mBAAmB,CAAC,KAAuB;QACvD,gBAAgB,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,MAAM,KAAK,kBAAkB;QAClC,IAAI,CAAC,yBAAyB,EAAE;YAC9B,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;SACrG;QACD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,4BAA4B,CAAC,KAAgC;QACzE,IAAI,yBAAyB,EAAE;YAC7B,yBAAyB,CAAC,OAAO,EAAE,CAAC;SACrC;QACD,yBAAyB,GAAG,KAAK,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,MAAM,KAAK,YAAY;QAC5B,IAAI,CAAC,YAAY,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;SAC9F;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,eAAe,CAAC,KAAmB;QAC/C,YAAY,GAAG,KAAK,CAAC;IACvB,CAAC;CACF;AAzJD,oCAyJC","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 Core\n */\n\nimport { IModelApp } from \"@itwin/core-frontend\";\nimport { Localization } from \"@itwin/core-common\";\nimport { PresentationError, PresentationStatus } from \"@itwin/presentation-common\";\nimport { FavoritePropertiesManager, FavoritePropertiesManagerProps } from \"./favorite-properties/FavoritePropertiesManager\";\nimport { createFavoritePropertiesStorage, DefaultFavoritePropertiesStorageTypes } from \"./favorite-properties/FavoritePropertiesStorage\";\nimport { FrontendLocalizationHelper } from \"./LocalizationHelper\";\nimport { PresentationManager, PresentationManagerProps } from \"./PresentationManager\";\nimport { SelectionManager, SelectionManagerProps } from \"./selection/SelectionManager\";\nimport { SelectionScopesManager } from \"./selection/SelectionScopesManager\";\n\nlet localization: Localization | undefined;\nlet presentationManager: PresentationManager | undefined;\nlet selectionManager: SelectionManager | undefined;\nlet favoritePropertiesManager: FavoritePropertiesManager | undefined;\nconst initializationHandlers: Array<() => Promise<(() => void) | void>> = [];\nconst terminationHandlers: Array<() => void> = [];\n\n/**\n * Props for initializing [[Presentation]].\n * @public\n */\nexport interface PresentationProps {\n  /** Props for [[PresentationManager]]. */\n  presentation?: PresentationManagerProps;\n\n  /** Props for [[SelectionManager]]. */\n  selection?: SelectionManagerProps;\n\n  /** Props for [[FavoritePropertiesManager]]. */\n  favorites?: FavoritePropertiesManagerProps;\n}\n\n/**\n * Static class used to statically set up Presentation library for the frontend.\n * Basically what it does is:\n * - Create a singleton [[PresentationManager]] instance\n * - Create a singleton [[SelectionManager]] instance\n * - Create a singleton [[FavoritePropertiesManager]]] instance\n *\n * @public\n */\nexport class Presentation {\n  /* istanbul ignore next */\n  private constructor() {}\n\n  /**\n   * Initializes Presentation library for the frontend.\n   *\n   * Example:\n   * ``` ts\n   * [[include:Presentation.Frontend.Initialization]]\n   * ```\n   *\n   * The method should be called after a call to [IModelApp.startup]($core-frontend).\n   */\n  public static async initialize(props?: PresentationProps): Promise<void> {\n    if (!IModelApp.initialized) {\n      throw new PresentationError(PresentationStatus.NotInitialized, \"IModelApp.startup must be called before calling Presentation.initialize\");\n    }\n    if (!localization) {\n      localization = IModelApp.localization;\n    }\n    if (!presentationManager) {\n      const managerProps = props?.presentation ?? {};\n      if (!managerProps.activeLocale) {\n        const languages = Presentation.localization.getLanguageList();\n        managerProps.activeLocale = languages.length ? languages[0] : undefined;\n      }\n      presentationManager = PresentationManager.create(managerProps);\n    }\n    if (!selectionManager) {\n      selectionManager = new SelectionManager(\n        props?.selection ?? {\n          scopes: new SelectionScopesManager({\n            rpcRequestsHandler: presentationManager.rpcRequestsHandler,\n            localeProvider: () => this.presentation.activeLocale,\n          }),\n        },\n      );\n    }\n    if (!favoritePropertiesManager) {\n      favoritePropertiesManager = new FavoritePropertiesManager({\n        storage: props?.favorites ? props.favorites.storage : createFavoritePropertiesStorage(DefaultFavoritePropertiesStorageTypes.Noop),\n      });\n    }\n\n    presentationManager.startIModelInitialization = (imodel) => favoritePropertiesManager?.startConnectionInitialization(imodel);\n    presentationManager.ensureIModelInitialized = async (imodel) => favoritePropertiesManager?.ensureInitialized(imodel);\n\n    await FrontendLocalizationHelper.registerNamespaces();\n    for (const handler of initializationHandlers) {\n      const cleanup = await handler();\n      if (cleanup) {\n        terminationHandlers.push(cleanup);\n      }\n    }\n  }\n\n  /**\n   * Terminates Presentation library frontend. This method should be called\n   * before a call to [IModelApp.shutdown]($core-frontend)\n   */\n  public static terminate(): void {\n    terminationHandlers.forEach((handler) => handler());\n    terminationHandlers.length = 0;\n\n    if (localization) {\n      FrontendLocalizationHelper.unregisterNamespaces();\n    }\n\n    if (presentationManager) {\n      presentationManager.dispose();\n    }\n    presentationManager = undefined;\n\n    if (favoritePropertiesManager) {\n      favoritePropertiesManager.dispose();\n    }\n    favoritePropertiesManager = undefined;\n\n    selectionManager = undefined;\n    localization = undefined;\n  }\n\n  /**\n   * Registers an additional handler which will be invoked during Presentation library frontend\n   * initialization.\n   */\n  public static registerInitializationHandler(handler: () => Promise<() => void>): void {\n    initializationHandlers.push(handler);\n  }\n\n  /** The singleton [[PresentationManager]] */\n  public static get presentation(): PresentationManager {\n    if (!presentationManager) {\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\n    }\n    return presentationManager;\n  }\n\n  /** @internal */\n  public static setPresentationManager(value: PresentationManager) {\n    if (presentationManager) {\n      presentationManager.dispose();\n    }\n    presentationManager = value;\n  }\n\n  /** The singleton [[SelectionManager]] */\n  public static get selection(): SelectionManager {\n    if (!selectionManager) {\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\n    }\n    return selectionManager;\n  }\n\n  /** @internal */\n  public static setSelectionManager(value: SelectionManager) {\n    selectionManager = value;\n  }\n\n  /**\n   * The singleton [[FavoritePropertiesManager]]\n   * @public\n   */\n  public static get favoriteProperties(): FavoritePropertiesManager {\n    if (!favoritePropertiesManager) {\n      throw new Error(\"Favorite Properties must be first initialized by calling Presentation.initialize\");\n    }\n    return favoritePropertiesManager;\n  }\n\n  /** @internal */\n  public static setFavoritePropertiesManager(value: FavoritePropertiesManager) {\n    if (favoritePropertiesManager) {\n      favoritePropertiesManager.dispose();\n    }\n    favoritePropertiesManager = value;\n  }\n\n  /**\n   * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.\n   */\n  public static get localization(): Localization {\n    if (!localization) {\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\n    }\n    return localization;\n  }\n\n  /** @internal */\n  public static setLocalization(value: Localization) {\n    localization = value;\n  }\n}\n"]}
+{"version":3,"file":"Presentation.js","sourceRoot":"","sources":["../../../src/presentation-frontend/Presentation.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/** @packageDocumentation\n * @module Core\n */\n\nimport { IModelApp } from \"@itwin/core-frontend\";\nimport { Localization } from \"@itwin/core-common\";\nimport { PresentationError, PresentationStatus } from \"@itwin/presentation-common\";\nimport { FavoritePropertiesManager, FavoritePropertiesManagerProps } from \"./favorite-properties/FavoritePropertiesManager\";\nimport { createFavoritePropertiesStorage, DefaultFavoritePropertiesStorageTypes } from \"./favorite-properties/FavoritePropertiesStorage\";\nimport { FrontendLocalizationHelper } from \"./LocalizationHelper\";\nimport { PresentationManager, PresentationManagerProps } from \"./PresentationManager\";\nimport { SelectionManager, SelectionManagerProps } from \"./selection/SelectionManager\";\nimport { SelectionScopesManager } from \"./selection/SelectionScopesManager\";\n\nlet localization: Localization | undefined;\nlet presentationManager: PresentationManager | undefined;\nlet selectionManager: SelectionManager | undefined;\nlet favoritePropertiesManager: FavoritePropertiesManager | undefined;\nconst initializationHandlers: Array<() => Promise<(() => void) | void>> = [];\nconst terminationHandlers: Array<() => void> = [];\n\n/**\n * Props for initializing [[Presentation]].\n * @public\n */\nexport interface PresentationProps {\n  /** Props for [[PresentationManager]]. */\n  presentation?: PresentationManagerProps;\n\n  /** Props for [[SelectionManager]]. */\n  selection?: Partial<SelectionManagerProps>;\n\n  /** Props for [[FavoritePropertiesManager]]. */\n  favorites?: FavoritePropertiesManagerProps;\n}\n\n/**\n * Static class used to statically set up Presentation library for the frontend.\n * Basically what it does is:\n * - Create a singleton [[PresentationManager]] instance\n * - Create a singleton [[SelectionManager]] instance\n * - Create a singleton [[FavoritePropertiesManager]]] instance\n *\n * @public\n */\nexport class Presentation {\n  /* istanbul ignore next */\n  private constructor() {}\n\n  /**\n   * Initializes Presentation library for the frontend.\n   *\n   * Example:\n   * ``` ts\n   * [[include:Presentation.Frontend.Initialization]]\n   * ```\n   *\n   * The method should be called after a call to [IModelApp.startup]($core-frontend).\n   */\n  public static async initialize(props?: PresentationProps): Promise<void> {\n    if (!IModelApp.initialized) {\n      throw new PresentationError(PresentationStatus.NotInitialized, \"IModelApp.startup must be called before calling Presentation.initialize\");\n    }\n    if (!localization) {\n      localization = IModelApp.localization;\n    }\n    if (!presentationManager) {\n      const managerProps = props?.presentation ?? {};\n      if (!managerProps.activeLocale) {\n        const languages = Presentation.localization.getLanguageList();\n        managerProps.activeLocale = languages.length ? languages[0] : undefined;\n      }\n      presentationManager = PresentationManager.create(managerProps);\n    }\n    if (!selectionManager) {\n      selectionManager = new SelectionManager({\n        ...props?.selection,\n        scopes:\n          props?.selection?.scopes ??\n          new SelectionScopesManager({\n            rpcRequestsHandler: presentationManager.rpcRequestsHandler,\n            localeProvider: () => this.presentation.activeLocale,\n          }),\n      });\n    }\n    if (!favoritePropertiesManager) {\n      favoritePropertiesManager = new FavoritePropertiesManager({\n        storage: props?.favorites ? props.favorites.storage : createFavoritePropertiesStorage(DefaultFavoritePropertiesStorageTypes.Noop),\n      });\n    }\n\n    presentationManager.startIModelInitialization = (imodel) => favoritePropertiesManager?.startConnectionInitialization(imodel);\n    presentationManager.ensureIModelInitialized = async (imodel) => favoritePropertiesManager?.ensureInitialized(imodel);\n\n    await FrontendLocalizationHelper.registerNamespaces();\n    for (const handler of initializationHandlers) {\n      const cleanup = await handler();\n      if (cleanup) {\n        terminationHandlers.push(cleanup);\n      }\n    }\n  }\n\n  /**\n   * Terminates Presentation library frontend. This method should be called\n   * before a call to [IModelApp.shutdown]($core-frontend)\n   */\n  public static terminate(): void {\n    terminationHandlers.forEach((handler) => handler());\n    terminationHandlers.length = 0;\n\n    if (localization) {\n      FrontendLocalizationHelper.unregisterNamespaces();\n    }\n\n    if (presentationManager) {\n      presentationManager.dispose();\n    }\n    presentationManager = undefined;\n\n    if (favoritePropertiesManager) {\n      favoritePropertiesManager.dispose();\n    }\n    favoritePropertiesManager = undefined;\n\n    if (selectionManager) {\n      selectionManager.dispose();\n    }\n    selectionManager = undefined;\n    localization = undefined;\n  }\n\n  /**\n   * Registers an additional handler which will be invoked during Presentation library frontend\n   * initialization.\n   */\n  public static registerInitializationHandler(handler: () => Promise<() => void>): void {\n    initializationHandlers.push(handler);\n  }\n\n  /** The singleton [[PresentationManager]] */\n  public static get presentation(): PresentationManager {\n    if (!presentationManager) {\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\n    }\n    return presentationManager;\n  }\n\n  /** @internal */\n  public static setPresentationManager(value: PresentationManager) {\n    if (presentationManager) {\n      presentationManager.dispose();\n    }\n    presentationManager = value;\n  }\n\n  /** The singleton [[SelectionManager]] */\n  public static get selection(): SelectionManager {\n    if (!selectionManager) {\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\n    }\n    return selectionManager;\n  }\n\n  /** @internal */\n  public static setSelectionManager(value: SelectionManager) {\n    selectionManager = value;\n  }\n\n  /**\n   * The singleton [[FavoritePropertiesManager]]\n   * @public\n   */\n  public static get favoriteProperties(): FavoritePropertiesManager {\n    if (!favoritePropertiesManager) {\n      throw new Error(\"Favorite Properties must be first initialized by calling Presentation.initialize\");\n    }\n    return favoritePropertiesManager;\n  }\n\n  /** @internal */\n  public static setFavoritePropertiesManager(value: FavoritePropertiesManager) {\n    if (favoritePropertiesManager) {\n      favoritePropertiesManager.dispose();\n    }\n    favoritePropertiesManager = value;\n  }\n\n  /**\n   * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.\n   */\n  public static get localization(): Localization {\n    if (!localization) {\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\n    }\n    return localization;\n  }\n\n  /** @internal */\n  public static setLocalization(value: Localization) {\n    localization = value;\n  }\n}\n"]}

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

@@ -4,6 +4,7 @@
 import { Id64Arg, IDisposable } 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";
 import { HiliteSet } from "./HiliteSetProvider";
 import { ISelectionProvider } from "./ISelectionProvider";
 import { SelectionChangeEvent } from "./SelectionChangeEvent";
@@ -15,15 +16,26 @@ import { SelectionScopesManager } from "./SelectionScopesManager";
 export interface SelectionManagerProps {
     /** A manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
     scopes: SelectionScopesManager;
+    /**
+     * Custom unified selection storage to be used by [[SelectionManager]]. If not provided [[SelectionManager]] creates
+     * and maintains storage.
+     */
+    selectionStorage?: SelectionStorage;
 }
 /**
  * The selection manager which stores the overall selection.
  * @public
  */
 export declare class SelectionManager implements ISelectionProvider {
-    private _selectionContainerMap;
+    private _selectionStorage;
     private _imodelToolSelectionSyncHandlers;
     private _hiliteSetProviders;
+    private _ownsStorage;
+    private _knownIModels;
+    private _currentSelection;
+    private _selectionChanges;
+    private _selectionEventsSubscription;
+    private _listeners;
     /** An event which gets broadcasted on selection changes */
     readonly selectionChange: SelectionChangeEvent;
     /** Manager for [selection scopes]($docs/presentation/unified-selection/index#selection-scopes) */
@@ -32,8 +44,8 @@ export declare class SelectionManager implements ISelectionProvider {
      * Creates an instance of SelectionManager.
      */
     constructor(props: SelectionManagerProps);
+    dispose(): void;
     private onConnectionClose;
-    private getContainer;
     /** @internal */
     getToolSelectionSyncHandler(imodel: IModelConnection): ToolSelectionSyncHandler | undefined;
     /**
@@ -47,7 +59,13 @@ export declare class SelectionManager implements ISelectionProvider {
     suspendIModelToolSelectionSync(imodel: IModelConnection): IDisposable;
     /** Get the selection levels currently stored in this manager for the specified imodel */
     getSelectionLevels(imodel: IModelConnection): number[];
-    /** Get the selection currently stored in this manager */
+    /**
+     * Get the selection currently stored in this manager
+     *
+     * @note Calling immediately after `add*`|`replace*`|`remove*`|`clear*` method call does not guarantee
+     * that returned `KeySet` will include latest changes. Listen for `selectionChange` event to get the
+     * latest selection after changes.
+     */
     getSelection(imodel: IModelConnection, level?: number): Readonly<KeySet>;
     private handleEvent;
     /**
@@ -126,6 +144,7 @@ export declare class SelectionManager implements ISelectionProvider {
      */
     getHiliteSetIterator(imodel: IModelConnection): AsyncIterableIterator<HiliteSet>;
     private getHiliteSetProvider;
+    private streamSelectionEvents;
 }
 /** @internal */
 export declare const TRANSIENT_ELEMENT_CLASSNAME = "/TRANSIENT";

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":"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"}
+{"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

@@ -8,9 +8,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolSelectionSyncHandler = exports.TRANSIENT_ELEMENT_CLASSNAME = 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 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");
@@ -23,27 +26,37 @@ class SelectionManager {
      * Creates an instance of SelectionManager.
      */
     constructor(props) {
-        this._selectionContainerMap = new Map();
         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;
-        core_frontend_1.IModelConnection.onClose.addListener((imodel) => {
+        this._selectionStorage = props.selectionStorage ?? (0, unified_selection_1.createStorage)();
+        this._ownsStorage = props.selectionStorage === undefined;
+        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._listeners.push(core_frontend_1.IModelConnection.onClose.addListener((imodel) => {
             this.onConnectionClose(imodel);
-        });
+        }));
+    }
+    dispose() {
+        this._selectionEventsSubscription.unsubscribe();
+        this._listeners.forEach((dispose) => dispose());
     }
     onConnectionClose(imodel) {
-        this.clearSelection("Connection Close Event", imodel);
-        this._selectionContainerMap.delete(imodel);
         this._hiliteSetProviders.delete(imodel);
-    }
-    getContainer(imodel) {
-        let selectionContainer = this._selectionContainerMap.get(imodel);
-        if (!selectionContainer) {
-            selectionContainer = new SelectionContainer();
-            this._selectionContainerMap.set(imodel, selectionContainer);
+        this._knownIModels.delete(imodel.key);
+        this._currentSelection.clear(imodel.key);
+        if (this._ownsStorage) {
+            this.clearSelection("Connection Close Event", imodel);
+            this._selectionStorage.clearStorage({ iModelKey: imodel.key });
         }
-        return selectionContainer;
     }
     /** @internal */
     // istanbul ignore next
@@ -91,39 +104,48 @@ class SelectionManager {
     }
     /** Get the selection levels currently stored in this manager for the specified imodel */
     getSelectionLevels(imodel) {
-        return this.getContainer(imodel).getSelectionLevels();
+        return this._selectionStorage.getSelectionLevels({ iModelKey: imodel.key });
     }
-    /** Get the selection currently stored in this manager */
+    /**
+     * Get the selection currently stored in this manager
+     *
+     * @note Calling immediately after `add*`|`replace*`|`remove*`|`clear*` method call does not guarantee
+     * that returned `KeySet` will include latest changes. Listen for `selectionChange` event to get the
+     * latest selection after changes.
+     */
     getSelection(imodel, level = 0) {
-        return this.getContainer(imodel).getSelection(level);
+        return this._currentSelection.getSelection(imodel.key, level);
     }
     handleEvent(evt) {
-        const container = this.getContainer(evt.imodel);
-        const selectedItemsSet = container.getSelection(evt.level);
-        const guidBefore = selectedItemsSet.guid;
         switch (evt.changeType) {
             case SelectionChangeEvent_1.SelectionChangeType.Add:
-                selectedItemsSet.add(evt.keys);
+                this._selectionStorage.addToSelection({
+                    iModelKey: evt.imodel.key,
+                    source: evt.source,
+                    level: evt.level,
+                    selectables: keysToSelectable(evt.imodel, evt.keys),
+                });
                 break;
             case SelectionChangeEvent_1.SelectionChangeType.Remove:
-                selectedItemsSet.delete(evt.keys);
+                this._selectionStorage.removeFromSelection({
+                    iModelKey: evt.imodel.key,
+                    source: evt.source,
+                    level: evt.level,
+                    selectables: keysToSelectable(evt.imodel, evt.keys),
+                });
                 break;
             case SelectionChangeEvent_1.SelectionChangeType.Replace:
-                if (selectedItemsSet.size !== evt.keys.size || !selectedItemsSet.hasAll(evt.keys)) {
-                    // note: the above check is only needed to avoid changing
-                    // guid of the keyset if we're replacing keyset with the same keys
-                    selectedItemsSet.clear().add(evt.keys);
-                }
+                this._selectionStorage.replaceSelection({
+                    iModelKey: evt.imodel.key,
+                    source: evt.source,
+                    level: evt.level,
+                    selectables: keysToSelectable(evt.imodel, evt.keys),
+                });
                 break;
             case SelectionChangeEvent_1.SelectionChangeType.Clear:
-                selectedItemsSet.clear();
+                this._selectionStorage.clearSelection({ iModelKey: evt.imodel.key, source: evt.source, level: evt.level });
                 break;
         }
-        if (selectedItemsSet.guid === guidBefore) {
-            return;
-        }
-        container.clear(evt.level + 1);
-        this.selectionChange.raiseEvent(evt, this);
     }
     /**
      * Add keys to the selection
@@ -265,40 +287,33 @@ class SelectionManager {
         }
         return provider;
     }
-}
-exports.SelectionManager = SelectionManager;
-/** @internal */
-class SelectionContainer {
-    constructor() {
-        this._selectedItemsSetMap = new Map();
-    }
-    getSelection(level) {
-        let selectedItemsSet = this._selectedItemsSetMap.get(level);
-        if (!selectedItemsSet) {
-            selectedItemsSet = new presentation_common_1.KeySet();
-            this._selectedItemsSetMap.set(level, selectedItemsSet);
-        }
-        return selectedItemsSet;
-    }
-    getSelectionLevels() {
-        const levels = new Array();
-        for (const entry of this._selectedItemsSetMap.entries()) {
-            if (!entry[1].isEmpty) {
-                levels.push(entry[0]);
-            }
-        }
-        return levels.sort();
-    }
-    clear(level) {
-        const keys = this._selectedItemsSetMap.keys();
-        for (const key of keys) {
-            if (key >= level) {
-                const selectedItemsSet = this._selectedItemsSetMap.get(key);
-                selectedItemsSet.clear();
-            }
-        }
+    streamSelectionEvents() {
+        return this._selectionChanges
+            .pipe((0, rxjs_1.mergeMap)((args) => {
+            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);
+                if (!imodel) {
+                    return rxjs_1.EMPTY;
+                }
+                return (0, rxjs_1.of)({
+                    imodel,
+                    keys: changedSelection,
+                    level,
+                    source: args.source,
+                    timestamp: args.timestamp,
+                    changeType: getChangeType(args.changeType),
+                });
+            }));
+        }))
+            .subscribe({
+            next: (args) => {
+                this.selectionChange.raiseEvent(args, this);
+            },
+        });
     }
 }
+exports.SelectionManager = SelectionManager;
 /** @internal */
 exports.TRANSIENT_ELEMENT_CLASSNAME = "/TRANSIENT";
 /** @internal */
@@ -437,4 +452,194 @@ class ScopedSelectionChanger {
         this.manager.replaceSelection(this.name, this.imodel, keys, level);
     }
 }
+/** Stores current selection in `KeySet` format per iModel.  */
+class CurrentSelectionStorage {
+    constructor() {
+        this._currentSelection = new Map();
+    }
+    getCurrentSelectionStorage(imodelKey) {
+        let storage = this._currentSelection.get(imodelKey);
+        if (!storage) {
+            storage = new IModelSelectionStorage();
+            this._currentSelection.set(imodelKey, storage);
+        }
+        return storage;
+    }
+    getSelection(imodelKey, level) {
+        return this.getCurrentSelectionStorage(imodelKey).getSelection(level);
+    }
+    clear(imodelKey) {
+        this._currentSelection.delete(imodelKey);
+    }
+    computeSelection(imodelKey, level, currSelectables, changedSelectables) {
+        return this.getCurrentSelectionStorage(imodelKey).computeSelection(level, currSelectables, changedSelectables);
+    }
+}
+/**
+ * Computes and stores current selection in `KeySet` format.
+ * It always stores result of latest resolved call to `computeSelection`.
+ */
+class IModelSelectionStorage {
+    constructor() {
+        this._currentSelection = new Map();
+    }
+    getSelection(level) {
+        let entry = this._currentSelection.get(level);
+        if (!entry) {
+            entry = { value: new presentation_common_1.KeySet(), ongoingComputationDisposers: new Set() };
+            this._currentSelection.set(level, entry);
+        }
+        return entry.value;
+    }
+    clearSelections(level) {
+        const clearedLevels = [];
+        for (const [storedLevel] of this._currentSelection.entries()) {
+            if (storedLevel > level) {
+                clearedLevels.push(storedLevel);
+            }
+        }
+        clearedLevels.forEach((storedLevel) => {
+            const entry = this._currentSelection.get(storedLevel);
+            // istanbul ignore if
+            if (!entry) {
+                return;
+            }
+            for (const disposer of entry.ongoingComputationDisposers) {
+                disposer.next();
+            }
+            this._currentSelection.delete(storedLevel);
+        });
+    }
+    addDisposer(level, disposer) {
+        const entry = this._currentSelection.get(level);
+        if (!entry) {
+            this._currentSelection.set(level, { value: new presentation_common_1.KeySet(), ongoingComputationDisposers: new Set([disposer]) });
+            return;
+        }
+        entry.ongoingComputationDisposers.add(disposer);
+    }
+    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(),
+        });
+    }
+    computeSelection(level, currSelectables, changedSelectables) {
+        this.clearSelections(level);
+        const prevComputationsDisposers = [...(this._currentSelection.get(level)?.ongoingComputationDisposers ?? [])];
+        const currDisposer = new rxjs_1.Subject();
+        this.addDisposer(level, currDisposer);
+        return (0, rxjs_1.defer)(async () => {
+            const convertedSelectables = [];
+            const [current, changed] = await Promise.all([
+                selectablesToKeys(currSelectables, convertedSelectables),
+                selectablesToKeys(changedSelectables, convertedSelectables),
+            ]);
+            const currentSelection = new presentation_common_1.KeySet([...current.keys, ...current.selectableKeys.flatMap((selectable) => selectable.keys)]);
+            const changedSelection = new presentation_common_1.KeySet([...changed.keys, ...changed.selectableKeys.flatMap((selectable) => selectable.keys)]);
+            return {
+                level,
+                currentSelection,
+                changedSelection,
+            };
+        }).pipe((0, rxjs_1.takeUntil)(currDisposer), (0, rxjs_1.tap)({
+            next: (val) => {
+                prevComputationsDisposers.forEach((disposer) => disposer.next());
+                this.setSelection(val.level, val.currentSelection, currDisposer);
+            },
+        }));
+    }
+}
+function keysToSelectable(imodel, keys) {
+    const selectables = [];
+    keys.forEach((key) => {
+        if ("id" in key) {
+            selectables.push(key);
+            return;
+        }
+        const customSelectable = {
+            identifier: key.pathFromRoot.join("/"),
+            data: key,
+            loadInstanceKeys: () => createInstanceKeysIterator(imodel, key),
+        };
+        selectables.push(customSelectable);
+    });
+    return selectables;
+}
+async function selectablesToKeys(selectables, convertedList) {
+    const keys = [];
+    const selectableKeys = [];
+    for (const [className, ids] of selectables.instanceKeys) {
+        for (const id of ids) {
+            keys.push({ id, className });
+        }
+    }
+    for (const [_, selectable] of selectables.custom) {
+        if (isNodeKey(selectable.data)) {
+            selectableKeys.push({ identifier: selectable.identifier, keys: [selectable.data] });
+            continue;
+        }
+        const converted = convertedList.find((con) => con.identifier === selectable.identifier);
+        if (converted) {
+            selectableKeys.push(converted);
+            continue;
+        }
+        const newConverted = { identifier: selectable.identifier, keys: [] };
+        convertedList.push(newConverted);
+        for await (const instanceKey of selectable.loadInstanceKeys()) {
+            newConverted.keys.push(instanceKey);
+        }
+        selectableKeys.push(newConverted);
+    }
+    return { keys, selectableKeys };
+}
+async function* createInstanceKeysIterator(imodel, nodeKey) {
+    if (presentation_common_1.NodeKey.isInstancesNodeKey(nodeKey)) {
+        for (const key of nodeKey.instanceKeys) {
+            yield key;
+        }
+        return;
+    }
+    const content = await Presentation_1.Presentation.presentation.getContentInstanceKeys({
+        imodel,
+        keys: new presentation_common_1.KeySet([nodeKey]),
+        rulesetOrId: {
+            id: "grouped-instances",
+            rules: [
+                {
+                    ruleType: "Content",
+                    specifications: [
+                        {
+                            specType: "SelectedNodeInstances",
+                        },
+                    ],
+                },
+            ],
+        },
+    });
+    for await (const key of content.items()) {
+        yield key;
+    }
+}
+function isNodeKey(data) {
+    const key = data;
+    return key.pathFromRoot !== undefined && key.type !== undefined;
+}
+function getChangeType(type) {
+    switch (type) {
+        case "add":
+            return SelectionChangeEvent_1.SelectionChangeType.Add;
+        case "remove":
+            return SelectionChangeEvent_1.SelectionChangeType.Remove;
+        case "replace":
+            return SelectionChangeEvent_1.SelectionChangeType.Replace;
+        case "clear":
+            return SelectionChangeEvent_1.SelectionChangeType.Clear;
+    }
+}
 //# sourceMappingURL=SelectionManager.js.map