@itwin/presentation-frontend 4.0.0-dev.7 → 4.0.0-dev.72

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

@@ -1 +1 @@
-{"version":3,"file":"LocalizationHelper.js","sourceRoot":"","sources":["../../../src/presentation-frontend/LocalizationHelper.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F,oEAAgE;AAChE,iDAA8C;AAE9C,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAEhE,gBAAgB;AAChB,MAAa,0BAA2B,SAAQ,wCAAkB;IAEhE,YAAY,IAAa;QACvB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,2BAAY,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAClI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAW,MAAM,CAAC,MAA0B;QAC1C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;IACtB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,kBAAkB;QACpC,MAAM,oBAAoB,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,2BAAY,CAAC,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QACzH,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAEM,MAAM,CAAC,oBAAoB;QAChC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,2BAAY,CAAC,YAAY,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1F,CAAC;CACF;AAtBD,gEAsBC","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\nimport { LocalizationHelper } from \"@itwin/presentation-common\";\r\nimport { Presentation } from \"./Presentation\";\r\n\r\nconst NAMESPACES = [\"BisCore\", \"ECPresentation\", \"RulesEngine\"];\r\n\r\n/** @internal */\r\nexport class FrontendLocalizationHelper extends LocalizationHelper {\r\n  private _lang: string | undefined;\r\n  constructor(lang?: string) {\r\n    super({ getLocalizedString: (key) => Presentation.localization.getLocalizedString(key, { defaultValue: key, lng: this._lang }) });\r\n    this._lang = lang;\r\n  }\r\n\r\n  public get locale() {\r\n    return this._lang;\r\n  }\r\n  public set locale(locale: string | undefined) {\r\n    this._lang = locale;\r\n  }\r\n\r\n  public static async registerNamespaces() {\r\n    const localizationPromises = NAMESPACES.map(async (namespace) => Presentation.localization.registerNamespace(namespace));\r\n    await Promise.all(localizationPromises);\r\n  }\r\n\r\n  public static unregisterNamespaces() {\r\n    NAMESPACES.map((namespace) => Presentation.localization.unregisterNamespace(namespace));\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"LocalizationHelper.js","sourceRoot":"","sources":["../../../src/presentation-frontend/LocalizationHelper.ts"],"names":[],"mappings":";;;AAAA;;;+FAG+F;AAC/F,oEAAgE;AAChE,iDAA8C;AAE9C,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,CAAC;AAEpC,gBAAgB;AAChB,MAAa,0BAA2B,SAAQ,wCAAkB;IAEhE,YAAY,IAAa;QACvB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,2BAAY,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAClI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,IAAW,MAAM,CAAC,MAA0B;QAC1C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;IACtB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,kBAAkB;QACpC,MAAM,oBAAoB,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,2BAAY,CAAC,YAAY,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QACzH,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAEM,MAAM,CAAC,oBAAoB;QAChC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,2BAAY,CAAC,YAAY,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1F,CAAC;CACF;AAtBD,gEAsBC","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\nimport { LocalizationHelper } from \"@itwin/presentation-common\";\r\nimport { Presentation } from \"./Presentation\";\r\n\r\nconst NAMESPACES = [\"Presentation\"];\r\n\r\n/** @internal */\r\nexport class FrontendLocalizationHelper extends LocalizationHelper {\r\n  private _lang: string | undefined;\r\n  constructor(lang?: string) {\r\n    super({ getLocalizedString: (key) => Presentation.localization.getLocalizedString(key, { defaultValue: key, lng: this._lang }) });\r\n    this._lang = lang;\r\n  }\r\n\r\n  public get locale() {\r\n    return this._lang;\r\n  }\r\n  public set locale(locale: string | undefined) {\r\n    this._lang = locale;\r\n  }\r\n\r\n  public static async registerNamespaces() {\r\n    const localizationPromises = NAMESPACES.map(async (namespace) => Presentation.localization.registerNamespace(namespace));\r\n    await Promise.all(localizationPromises);\r\n  }\r\n\r\n  public static unregisterNamespaces() {\r\n    NAMESPACES.map((namespace) => Presentation.localization.unregisterNamespace(namespace));\r\n  }\r\n}\r\n"]}

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

@@ -1,76 +1,74 @@
-/** @packageDocumentation
- * @module Core
- */
-import { Localization } from "@itwin/core-common";
-import { FavoritePropertiesManager, FavoritePropertiesManagerProps } from "./favorite-properties/FavoritePropertiesManager";
-import { PresentationManager, PresentationManagerProps } from "./PresentationManager";
-import { SelectionManager, SelectionManagerProps } from "./selection/SelectionManager";
-/**
- * Props for initializing [[Presentation]].
- * @public
- */
-export interface PresentationProps {
-    /** Props for [[PresentationManager]]. */
-    presentation?: PresentationManagerProps;
-    /** Props for [[SelectionManager]]. */
-    selection?: SelectionManagerProps;
-    /** Props for [[FavoritePropertiesManager]]. */
-    favorites?: FavoritePropertiesManagerProps;
-}
-/**
- * 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 declare class Presentation {
-    private 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 initialize(props?: PresentationProps): Promise<void>;
-    /**
-     * Terminates Presentation library frontend. This method should be called
-     * before a call to [IModelApp.shutdown]($core-frontend)
-     */
-    static terminate(): void;
-    /**
-     * Registers an additional handler which will be invoked during Presentation library frontend
-     * initialization.
-     *
-     * @internal
-     */
-    static registerInitializationHandler(handler: () => Promise<() => void>): void;
-    /** The singleton [[PresentationManager]] */
-    static get presentation(): PresentationManager;
-    /** @internal */
-    static setPresentationManager(value: PresentationManager): void;
-    /** The singleton [[SelectionManager]] */
-    static get selection(): SelectionManager;
-    /** @internal */
-    static setSelectionManager(value: SelectionManager): void;
-    /**
-     * The singleton [[FavoritePropertiesManager]]
-     * @public
-     */
-    static get favoriteProperties(): FavoritePropertiesManager;
-    /** @internal */
-    static setFavoritePropertiesManager(value: FavoritePropertiesManager): void;
-    /**
-     * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.
-     */
-    static get localization(): Localization;
-    /** @internal */
-    static setLocalization(value: Localization): void;
-}
+/** @packageDocumentation
+ * @module Core
+ */
+import { Localization } from "@itwin/core-common";
+import { FavoritePropertiesManager, FavoritePropertiesManagerProps } from "./favorite-properties/FavoritePropertiesManager";
+import { PresentationManager, PresentationManagerProps } from "./PresentationManager";
+import { SelectionManager, SelectionManagerProps } from "./selection/SelectionManager";
+/**
+ * Props for initializing [[Presentation]].
+ * @public
+ */
+export interface PresentationProps {
+    /** Props for [[PresentationManager]]. */
+    presentation?: PresentationManagerProps;
+    /** Props for [[SelectionManager]]. */
+    selection?: SelectionManagerProps;
+    /** Props for [[FavoritePropertiesManager]]. */
+    favorites?: FavoritePropertiesManagerProps;
+}
+/**
+ * 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 declare class Presentation {
+    private 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 initialize(props?: PresentationProps): Promise<void>;
+    /**
+     * Terminates Presentation library frontend. This method should be called
+     * before a call to [IModelApp.shutdown]($core-frontend)
+     */
+    static terminate(): void;
+    /**
+     * Registers an additional handler which will be invoked during Presentation library frontend
+     * initialization.
+     */
+    static registerInitializationHandler(handler: () => Promise<() => void>): void;
+    /** The singleton [[PresentationManager]] */
+    static get presentation(): PresentationManager;
+    /** @internal */
+    static setPresentationManager(value: PresentationManager): void;
+    /** The singleton [[SelectionManager]] */
+    static get selection(): SelectionManager;
+    /** @internal */
+    static setSelectionManager(value: SelectionManager): void;
+    /**
+     * The singleton [[FavoritePropertiesManager]]
+     * @public
+     */
+    static get favoriteProperties(): FavoritePropertiesManager;
+    /** @internal */
+    static setFavoritePropertiesManager(value: FavoritePropertiesManager): void;
+    /**
+     * The localization manager used by Presentation frontend. Returns the result of `IModelApp.i18n`.
+     */
+    static get localization(): Localization;
+    /** @internal */
+    static setLocalization(value: Localization): void;
+}
 //# sourceMappingURL=Presentation.d.ts.map

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;IAGvB,OAAO;IAEP;;;;;;;;;OASG;WACiB,UAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCxE;;;OAGG;WACW,SAAS,IAAI,IAAI;IAmB/B;;;;;OAKG;WACW,6BAA6B,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IAIrF,4CAA4C;IAC5C,WAAkB,YAAY,IAAI,mBAAmB,CAIpD;IAED,gBAAgB;WACF,sBAAsB,CAAC,KAAK,EAAE,mBAAmB;IAM/D,yCAAyC;IACzC,WAAkB,SAAS,IAAI,gBAAgB,CAI9C;IAED,gBAAgB;WACF,mBAAmB,CAAC,KAAK,EAAE,gBAAgB;IAIzD;;;OAGG;IACH,WAAkB,kBAAkB,IAAI,yBAAyB,CAIhE;IAED,gBAAgB;WACF,4BAA4B,CAAC,KAAK,EAAE,yBAAyB;IAM3E;;OAEG;IACH,WAAkB,YAAY,IAAI,YAAY,CAI7C;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,qBAAqB,CAAC;IAElC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,8BAA8B,CAAC;CAC5C;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAGvB,OAAO;IAEP;;;;;;;;;OASG;WACiB,UAAU,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCxE;;;OAGG;WACW,SAAS,IAAI,IAAI;IAmB/B;;;OAGG;WACW,6BAA6B,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IAIrF,4CAA4C;IAC5C,WAAkB,YAAY,IAAI,mBAAmB,CAIpD;IAED,gBAAgB;WACF,sBAAsB,CAAC,KAAK,EAAE,mBAAmB;IAM/D,yCAAyC;IACzC,WAAkB,SAAS,IAAI,gBAAgB,CAI9C;IAED,gBAAgB;WACF,mBAAmB,CAAC,KAAK,EAAE,gBAAgB;IAIzD;;;OAGG;IACH,WAAkB,kBAAkB,IAAI,yBAAyB,CAIhE;IAED,gBAAgB;WACF,4BAA4B,CAAC,KAAK,EAAE,yBAAyB;IAM3E;;OAEG;IACH,WAAkB,YAAY,IAAI,YAAY,CAI7C;IAED,gBAAgB;WACF,eAAe,CAAC,KAAK,EAAE,YAAY;CAGlD"}

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

@@ -1,163 +1,160 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* 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
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Presentation = void 0;
-const core_frontend_1 = require("@itwin/core-frontend");
-const presentation_common_1 = require("@itwin/presentation-common");
-const FavoritePropertiesManager_1 = require("./favorite-properties/FavoritePropertiesManager");
-const FavoritePropertiesStorage_1 = require("./favorite-properties/FavoritePropertiesStorage");
-const LocalizationHelper_1 = require("./LocalizationHelper");
-const PresentationManager_1 = require("./PresentationManager");
-const SelectionManager_1 = require("./selection/SelectionManager");
-const SelectionScopesManager_1 = require("./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
- */
-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 (!core_frontend_1.IModelApp.initialized) {
-            throw new presentation_common_1.PresentationError(presentation_common_1.PresentationStatus.NotInitialized, "IModelApp.startup must be called before calling Presentation.initialize");
-        }
-        if (!localization) {
-            localization = core_frontend_1.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_1.PresentationManager.create(managerProps);
-        }
-        if (!selectionManager) {
-            selectionManager = new SelectionManager_1.SelectionManager((_b = props === null || props === void 0 ? void 0 : props.selection) !== null && _b !== void 0 ? _b : {
-                scopes: new SelectionScopesManager_1.SelectionScopesManager({
-                    rpcRequestsHandler: presentationManager.rpcRequestsHandler,
-                    localeProvider: () => this.presentation.activeLocale,
-                }),
-            });
-        }
-        if (!favoritePropertiesManager) {
-            favoritePropertiesManager = new FavoritePropertiesManager_1.FavoritePropertiesManager({
-                storage: (props === null || props === void 0 ? void 0 : props.favorites) ? props.favorites.storage : (0, FavoritePropertiesStorage_1.createFavoritePropertiesStorage)(FavoritePropertiesStorage_1.DefaultFavoritePropertiesStorageTypes.Noop),
-            });
-        }
-        // eslint-disable-next-line @typescript-eslint/unbound-method
-        presentationManager.onNewiModelConnection = favoritePropertiesManager.initializeConnection.bind(favoritePropertiesManager);
-        await LocalizationHelper_1.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)
-            LocalizationHelper_1.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;
-    }
-}
-exports.Presentation = Presentation;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Presentation = void 0;
+const core_frontend_1 = require("@itwin/core-frontend");
+const presentation_common_1 = require("@itwin/presentation-common");
+const FavoritePropertiesManager_1 = require("./favorite-properties/FavoritePropertiesManager");
+const FavoritePropertiesStorage_1 = require("./favorite-properties/FavoritePropertiesStorage");
+const LocalizationHelper_1 = require("./LocalizationHelper");
+const PresentationManager_1 = require("./PresentationManager");
+const SelectionManager_1 = require("./selection/SelectionManager");
+const SelectionScopesManager_1 = require("./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
+ */
+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) {
+        if (!core_frontend_1.IModelApp.initialized) {
+            throw new presentation_common_1.PresentationError(presentation_common_1.PresentationStatus.NotInitialized, "IModelApp.startup must be called before calling Presentation.initialize");
+        }
+        if (!localization) {
+            localization = core_frontend_1.IModelApp.localization;
+        }
+        if (!presentationManager) {
+            const managerProps = props?.presentation ?? {};
+            if (!managerProps.activeLocale) {
+                const languages = Presentation.localization.getLanguageList();
+                managerProps.activeLocale = (languages.length ? languages[0] : undefined);
+            }
+            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,
+                }),
+            });
+        }
+        if (!favoritePropertiesManager) {
+            favoritePropertiesManager = new FavoritePropertiesManager_1.FavoritePropertiesManager({
+                storage: props?.favorites ? props.favorites.storage : (0, FavoritePropertiesStorage_1.createFavoritePropertiesStorage)(FavoritePropertiesStorage_1.DefaultFavoritePropertiesStorageTypes.Noop),
+            });
+        }
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        presentationManager.onNewiModelConnection = favoritePropertiesManager.initializeConnection.bind(favoritePropertiesManager);
+        await LocalizationHelper_1.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)
+            LocalizationHelper_1.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.
+     */
+    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;
+    }
+}
+exports.Presentation = Presentation;
 //# sourceMappingURL=Presentation.js.map

package/lib/cjs/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":["/*---------------------------------------------------------------------------------------------\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"]}
+{"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  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"]}