@itwin/presentation-frontend 3.5.0-dev.19 → 3.5.0-dev.21

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

@@ -1,159 +1,159 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Core
- */
-import { IModelApp } from "@itwin/core-frontend";
-import { PresentationError, PresentationStatus } from "@itwin/presentation-common";
-import { FavoritePropertiesManager } from "./favorite-properties/FavoritePropertiesManager";
-import { createFavoritePropertiesStorage, DefaultFavoritePropertiesStorageTypes } from "./favorite-properties/FavoritePropertiesStorage";
-import { FrontendLocalizationHelper } from "./LocalizationHelper";
-import { PresentationManager } from "./PresentationManager";
-import { SelectionManager } from "./selection/SelectionManager";
-import { SelectionScopesManager } from "./selection/SelectionScopesManager";
-let localization;
-let presentationManager;
-let selectionManager;
-let favoritePropertiesManager;
-const initializationHandlers = [];
-const terminationHandlers = [];
-/**
- * Static class used to statically set up Presentation library for the frontend.
- * Basically what it does is:
- * - Create a singleton [[PresentationManager]] instance
- * - Create a singleton [[SelectionManager]] instance
- * - Create a singleton [[FavoritePropertiesManager]]] instance
- *
- * @public
- */
-export class Presentation {
-    /* istanbul ignore next */
-    constructor() { }
-    /**
-     * Initializes Presentation library for the frontend.
-     *
-     * Example:
-     * ``` ts
-     * [[include:Presentation.Frontend.Initialization]]
-     * ```
-     *
-     * The method should be called after a call to [IModelApp.startup]($core-frontend).
-     */
-    static async initialize(props) {
-        var _a, _b;
-        if (!IModelApp.initialized) {
-            throw new PresentationError(PresentationStatus.NotInitialized, "IModelApp.startup must be called before calling Presentation.initialize");
-        }
-        if (!localization) {
-            localization = IModelApp.localization;
-        }
-        if (!presentationManager) {
-            const managerProps = (_a = props === null || props === void 0 ? void 0 : props.presentation) !== null && _a !== void 0 ? _a : {};
-            if (!managerProps.activeLocale) {
-                const languages = Presentation.localization.getLanguageList();
-                managerProps.activeLocale = (languages.length ? languages[0] : undefined);
-            }
-            presentationManager = PresentationManager.create(managerProps);
-        }
-        if (!selectionManager) {
-            selectionManager = new SelectionManager((_b = props === null || props === void 0 ? void 0 : props.selection) !== null && _b !== void 0 ? _b : {
-                scopes: new SelectionScopesManager({
-                    rpcRequestsHandler: presentationManager.rpcRequestsHandler,
-                    localeProvider: () => this.presentation.activeLocale,
-                }),
-            });
-        }
-        if (!favoritePropertiesManager) {
-            favoritePropertiesManager = new FavoritePropertiesManager({
-                storage: (props === null || props === void 0 ? void 0 : props.favorites) ? props.favorites.storage : createFavoritePropertiesStorage(DefaultFavoritePropertiesStorageTypes.Noop),
-            });
-        }
-        // eslint-disable-next-line @typescript-eslint/unbound-method
-        presentationManager.onNewiModelConnection = favoritePropertiesManager.initializeConnection.bind(favoritePropertiesManager);
-        await FrontendLocalizationHelper.registerNamespaces();
-        for (const handler of initializationHandlers) {
-            const cleanup = await handler();
-            if (cleanup)
-                terminationHandlers.push(cleanup);
-        }
-    }
-    /**
-     * Terminates Presentation library frontend. This method should be called
-     * before a call to [IModelApp.shutdown]($core-frontend)
-     */
-    static terminate() {
-        terminationHandlers.forEach((handler) => handler());
-        terminationHandlers.length = 0;
-        if (localization)
-            FrontendLocalizationHelper.unregisterNamespaces();
-        if (presentationManager)
-            presentationManager.dispose();
-        presentationManager = undefined;
-        if (favoritePropertiesManager)
-            favoritePropertiesManager.dispose();
-        favoritePropertiesManager = undefined;
-        selectionManager = undefined;
-        localization = undefined;
-    }
-    /**
-     * Registers an additional handler which will be invoked during Presentation library frontend
-     * initialization.
-     *
-     * @internal
-     */
-    static registerInitializationHandler(handler) {
-        initializationHandlers.push(handler);
-    }
-    /** The singleton [[PresentationManager]] */
-    static get presentation() {
-        if (!presentationManager)
-            throw new Error("Presentation must be first initialized by calling Presentation.initialize");
-        return presentationManager;
-    }
-    /** @internal */
-    static setPresentationManager(value) {
-        if (presentationManager)
-            presentationManager.dispose();
-        presentationManager = value;
-    }
-    /** The singleton [[SelectionManager]] */
-    static get selection() {
-        if (!selectionManager)
-            throw new Error("Presentation must be first initialized by calling Presentation.initialize");
-        return selectionManager;
-    }
-    /** @internal */
-    static setSelectionManager(value) {
-        selectionManager = value;
-    }
-    /**
-     * The singleton [[FavoritePropertiesManager]]
-     * @public
-     */
-    static get favoriteProperties() {
-        if (!favoritePropertiesManager)
-            throw new Error("Favorite Properties must be first initialized by calling Presentation.initialize");
-        return favoritePropertiesManager;
-    }
-    /** @internal */
-    static setFavoritePropertiesManager(value) {
-        if (favoritePropertiesManager)
-            favoritePropertiesManager.dispose();
-        favoritePropertiesManager = value;
-    }
-    /**
-     * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.
-     */
-    static get localization() {
-        if (!localization)
-            throw new Error("Presentation must be first initialized by calling Presentation.initialize");
-        return localization;
-    }
-    /** @internal */
-    static setLocalization(value) {
-        localization = value;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Core
+ */
+import { IModelApp } from "@itwin/core-frontend";
+import { PresentationError, PresentationStatus } from "@itwin/presentation-common";
+import { FavoritePropertiesManager } from "./favorite-properties/FavoritePropertiesManager";
+import { createFavoritePropertiesStorage, DefaultFavoritePropertiesStorageTypes } from "./favorite-properties/FavoritePropertiesStorage";
+import { FrontendLocalizationHelper } from "./LocalizationHelper";
+import { PresentationManager } from "./PresentationManager";
+import { SelectionManager } from "./selection/SelectionManager";
+import { SelectionScopesManager } from "./selection/SelectionScopesManager";
+let localization;
+let presentationManager;
+let selectionManager;
+let favoritePropertiesManager;
+const initializationHandlers = [];
+const terminationHandlers = [];
+/**
+ * Static class used to statically set up Presentation library for the frontend.
+ * Basically what it does is:
+ * - Create a singleton [[PresentationManager]] instance
+ * - Create a singleton [[SelectionManager]] instance
+ * - Create a singleton [[FavoritePropertiesManager]]] instance
+ *
+ * @public
+ */
+export class Presentation {
+    /* istanbul ignore next */
+    constructor() { }
+    /**
+     * Initializes Presentation library for the frontend.
+     *
+     * Example:
+     * ``` ts
+     * [[include:Presentation.Frontend.Initialization]]
+     * ```
+     *
+     * The method should be called after a call to [IModelApp.startup]($core-frontend).
+     */
+    static async initialize(props) {
+        var _a, _b;
+        if (!IModelApp.initialized) {
+            throw new PresentationError(PresentationStatus.NotInitialized, "IModelApp.startup must be called before calling Presentation.initialize");
+        }
+        if (!localization) {
+            localization = IModelApp.localization;
+        }
+        if (!presentationManager) {
+            const managerProps = (_a = props === null || props === void 0 ? void 0 : props.presentation) !== null && _a !== void 0 ? _a : {};
+            if (!managerProps.activeLocale) {
+                const languages = Presentation.localization.getLanguageList();
+                managerProps.activeLocale = (languages.length ? languages[0] : undefined);
+            }
+            presentationManager = PresentationManager.create(managerProps);
+        }
+        if (!selectionManager) {
+            selectionManager = new SelectionManager((_b = props === null || props === void 0 ? void 0 : props.selection) !== null && _b !== void 0 ? _b : {
+                scopes: new SelectionScopesManager({
+                    rpcRequestsHandler: presentationManager.rpcRequestsHandler,
+                    localeProvider: () => this.presentation.activeLocale,
+                }),
+            });
+        }
+        if (!favoritePropertiesManager) {
+            favoritePropertiesManager = new FavoritePropertiesManager({
+                storage: (props === null || props === void 0 ? void 0 : props.favorites) ? props.favorites.storage : createFavoritePropertiesStorage(DefaultFavoritePropertiesStorageTypes.Noop),
+            });
+        }
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        presentationManager.onNewiModelConnection = favoritePropertiesManager.initializeConnection.bind(favoritePropertiesManager);
+        await FrontendLocalizationHelper.registerNamespaces();
+        for (const handler of initializationHandlers) {
+            const cleanup = await handler();
+            if (cleanup)
+                terminationHandlers.push(cleanup);
+        }
+    }
+    /**
+     * Terminates Presentation library frontend. This method should be called
+     * before a call to [IModelApp.shutdown]($core-frontend)
+     */
+    static terminate() {
+        terminationHandlers.forEach((handler) => handler());
+        terminationHandlers.length = 0;
+        if (localization)
+            FrontendLocalizationHelper.unregisterNamespaces();
+        if (presentationManager)
+            presentationManager.dispose();
+        presentationManager = undefined;
+        if (favoritePropertiesManager)
+            favoritePropertiesManager.dispose();
+        favoritePropertiesManager = undefined;
+        selectionManager = undefined;
+        localization = undefined;
+    }
+    /**
+     * Registers an additional handler which will be invoked during Presentation library frontend
+     * initialization.
+     *
+     * @internal
+     */
+    static registerInitializationHandler(handler) {
+        initializationHandlers.push(handler);
+    }
+    /** The singleton [[PresentationManager]] */
+    static get presentation() {
+        if (!presentationManager)
+            throw new Error("Presentation must be first initialized by calling Presentation.initialize");
+        return presentationManager;
+    }
+    /** @internal */
+    static setPresentationManager(value) {
+        if (presentationManager)
+            presentationManager.dispose();
+        presentationManager = value;
+    }
+    /** The singleton [[SelectionManager]] */
+    static get selection() {
+        if (!selectionManager)
+            throw new Error("Presentation must be first initialized by calling Presentation.initialize");
+        return selectionManager;
+    }
+    /** @internal */
+    static setSelectionManager(value) {
+        selectionManager = value;
+    }
+    /**
+     * The singleton [[FavoritePropertiesManager]]
+     * @public
+     */
+    static get favoriteProperties() {
+        if (!favoritePropertiesManager)
+            throw new Error("Favorite Properties must be first initialized by calling Presentation.initialize");
+        return favoritePropertiesManager;
+    }
+    /** @internal */
+    static setFavoritePropertiesManager(value) {
+        if (favoritePropertiesManager)
+            favoritePropertiesManager.dispose();
+        favoritePropertiesManager = value;
+    }
+    /**
+     * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.
+     */
+    static get localization() {
+        if (!localization)
+            throw new Error("Presentation must be first initialized by calling Presentation.initialize");
+        return localization;
+    }
+    /** @internal */
+    static setLocalization(value) {
+        localization = value;
+    }
+}
 //# sourceMappingURL=Presentation.js.map

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

@@ -1 +1 @@
-{"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?: 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\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,\n        \"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(props?.selection ?? {\n        scopes: 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    // eslint-disable-next-line @typescript-eslint/unbound-method\n    presentationManager.onNewiModelConnection = favoritePropertiesManager.initializeConnection.bind(favoritePropertiesManager);\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   * 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    if (presentationManager)\n      presentationManager.dispose();\n    presentationManager = undefined;\n\n    if (favoritePropertiesManager)\n      favoritePropertiesManager.dispose();\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   * @internal\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    return presentationManager;\n  }\n\n  /** @internal */\n  public static setPresentationManager(value: PresentationManager) {\n    if (presentationManager)\n      presentationManager.dispose();\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    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    return favoritePropertiesManager;\n  }\n\n  /** @internal */\n  public static setFavoritePropertiesManager(value: FavoritePropertiesManager) {\n    if (favoritePropertiesManager)\n      favoritePropertiesManager.dispose();\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    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":["/*---------------------------------------------------------------------------------------------\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 Core\r\n */\r\n\r\nimport { IModelApp } from \"@itwin/core-frontend\";\r\nimport { Localization } from \"@itwin/core-common\";\r\nimport { PresentationError, PresentationStatus } from \"@itwin/presentation-common\";\r\nimport { FavoritePropertiesManager, FavoritePropertiesManagerProps } from \"./favorite-properties/FavoritePropertiesManager\";\r\nimport { createFavoritePropertiesStorage, DefaultFavoritePropertiesStorageTypes } from \"./favorite-properties/FavoritePropertiesStorage\";\r\nimport { FrontendLocalizationHelper } from \"./LocalizationHelper\";\r\nimport { PresentationManager, PresentationManagerProps } from \"./PresentationManager\";\r\nimport { SelectionManager, SelectionManagerProps } from \"./selection/SelectionManager\";\r\nimport { SelectionScopesManager } from \"./selection/SelectionScopesManager\";\r\n\r\nlet localization: Localization | undefined;\r\nlet presentationManager: PresentationManager | undefined;\r\nlet selectionManager: SelectionManager | undefined;\r\nlet favoritePropertiesManager: FavoritePropertiesManager | undefined;\r\nconst initializationHandlers: Array<() => Promise<(() => void) | void>> = [];\r\nconst terminationHandlers: Array<() => void> = [];\r\n\r\n/**\r\n * Props for initializing [[Presentation]].\r\n * @public\r\n */\r\nexport interface PresentationProps {\r\n  /** Props for [[PresentationManager]]. */\r\n  presentation?: PresentationManagerProps;\r\n\r\n  /** Props for [[SelectionManager]]. */\r\n  selection?: SelectionManagerProps;\r\n\r\n  /** Props for [[FavoritePropertiesManager]]. */\r\n  favorites?: FavoritePropertiesManagerProps;\r\n}\r\n\r\n/**\r\n * Static class used to statically set up Presentation library for the frontend.\r\n * Basically what it does is:\r\n * - Create a singleton [[PresentationManager]] instance\r\n * - Create a singleton [[SelectionManager]] instance\r\n * - Create a singleton [[FavoritePropertiesManager]]] instance\r\n *\r\n * @public\r\n */\r\nexport class Presentation {\r\n\r\n  /* istanbul ignore next */\r\n  private constructor() { }\r\n\r\n  /**\r\n   * Initializes Presentation library for the frontend.\r\n   *\r\n   * Example:\r\n   * ``` ts\r\n   * [[include:Presentation.Frontend.Initialization]]\r\n   * ```\r\n   *\r\n   * The method should be called after a call to [IModelApp.startup]($core-frontend).\r\n   */\r\n  public static async initialize(props?: PresentationProps): Promise<void> {\r\n    if (!IModelApp.initialized) {\r\n      throw new PresentationError(PresentationStatus.NotInitialized,\r\n        \"IModelApp.startup must be called before calling Presentation.initialize\");\r\n    }\r\n    if (!localization) {\r\n      localization = IModelApp.localization;\r\n    }\r\n    if (!presentationManager) {\r\n      const managerProps = props?.presentation ?? {};\r\n      if (!managerProps.activeLocale) {\r\n        const languages = Presentation.localization.getLanguageList();\r\n        managerProps.activeLocale = (languages.length ? languages[0] : undefined);\r\n      }\r\n      presentationManager = PresentationManager.create(managerProps);\r\n    }\r\n    if (!selectionManager) {\r\n      selectionManager = new SelectionManager(props?.selection ?? {\r\n        scopes: new SelectionScopesManager({\r\n          rpcRequestsHandler: presentationManager.rpcRequestsHandler,\r\n          localeProvider: () => this.presentation.activeLocale,\r\n        }),\r\n      });\r\n    }\r\n    if (!favoritePropertiesManager) {\r\n      favoritePropertiesManager = new FavoritePropertiesManager({\r\n        storage: props?.favorites ? props.favorites.storage : createFavoritePropertiesStorage(DefaultFavoritePropertiesStorageTypes.Noop),\r\n      });\r\n    }\r\n    // eslint-disable-next-line @typescript-eslint/unbound-method\r\n    presentationManager.onNewiModelConnection = favoritePropertiesManager.initializeConnection.bind(favoritePropertiesManager);\r\n    await FrontendLocalizationHelper.registerNamespaces();\r\n    for (const handler of initializationHandlers) {\r\n      const cleanup = await handler();\r\n      if (cleanup)\r\n        terminationHandlers.push(cleanup);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Terminates Presentation library frontend. This method should be called\r\n   * before a call to [IModelApp.shutdown]($core-frontend)\r\n   */\r\n  public static terminate(): void {\r\n    terminationHandlers.forEach((handler) => handler());\r\n    terminationHandlers.length = 0;\r\n\r\n    if (localization)\r\n      FrontendLocalizationHelper.unregisterNamespaces();\r\n\r\n    if (presentationManager)\r\n      presentationManager.dispose();\r\n    presentationManager = undefined;\r\n\r\n    if (favoritePropertiesManager)\r\n      favoritePropertiesManager.dispose();\r\n    favoritePropertiesManager = undefined;\r\n\r\n    selectionManager = undefined;\r\n    localization = undefined;\r\n  }\r\n\r\n  /**\r\n   * Registers an additional handler which will be invoked during Presentation library frontend\r\n   * initialization.\r\n   *\r\n   * @internal\r\n   */\r\n  public static registerInitializationHandler(handler: () => Promise<() => void>): void {\r\n    initializationHandlers.push(handler);\r\n  }\r\n\r\n  /** The singleton [[PresentationManager]] */\r\n  public static get presentation(): PresentationManager {\r\n    if (!presentationManager)\r\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\r\n    return presentationManager;\r\n  }\r\n\r\n  /** @internal */\r\n  public static setPresentationManager(value: PresentationManager) {\r\n    if (presentationManager)\r\n      presentationManager.dispose();\r\n    presentationManager = value;\r\n  }\r\n\r\n  /** The singleton [[SelectionManager]] */\r\n  public static get selection(): SelectionManager {\r\n    if (!selectionManager)\r\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\r\n    return selectionManager;\r\n  }\r\n\r\n  /** @internal */\r\n  public static setSelectionManager(value: SelectionManager) {\r\n    selectionManager = value;\r\n  }\r\n\r\n  /**\r\n   * The singleton [[FavoritePropertiesManager]]\r\n   * @public\r\n   */\r\n  public static get favoriteProperties(): FavoritePropertiesManager {\r\n    if (!favoritePropertiesManager)\r\n      throw new Error(\"Favorite Properties must be first initialized by calling Presentation.initialize\");\r\n    return favoritePropertiesManager;\r\n  }\r\n\r\n  /** @internal */\r\n  public static setFavoritePropertiesManager(value: FavoritePropertiesManager) {\r\n    if (favoritePropertiesManager)\r\n      favoritePropertiesManager.dispose();\r\n    favoritePropertiesManager = value;\r\n  }\r\n\r\n  /**\r\n   * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.\r\n   */\r\n  public static get localization(): Localization {\r\n    if (!localization)\r\n      throw new Error(\"Presentation must be first initialized by calling Presentation.initialize\");\r\n    return localization;\r\n  }\r\n\r\n  /** @internal */\r\n  public static setLocalization(value: Localization) {\r\n    localization = value;\r\n  }\r\n}\r\n"]}