@itwin/appui-react 3.6.0-dev.34 → 3.6.0-dev.36

package/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright © 2017-2022 Bentley Systems, Incorporated. All rights reserved.
+Copyright © 2017-2023 Bentley Systems, Incorporated. All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/lib/cjs/appui-react/UiFramework.d.ts

@@ -1,243 +1,243 @@
-/** @packageDocumentation
- * @module Utilities
- */
-import { Store } from "redux";
-import { GuidString } from "@itwin/core-bentley";
-import { Localization } from "@itwin/core-common";
-import { IModelConnection, SnapMode, ViewState } from "@itwin/core-frontend";
-import { UiEvent } from "@itwin/appui-abstract";
-import { SettingsManager, UiStateStorage } from "@itwin/core-react";
-import { BackstageManager } from "./backstage/BackstageManager";
-import { ChildWindowManager } from "./childwindow/ChildWindowManager";
-import { FrameworkState } from "./redux/FrameworkState";
-import { CursorMenuData, PresentationSelectionScope } from "./redux/SessionState";
-import { HideIsolateEmphasizeActionHandler } from "./selection/HideIsolateEmphasizeManager";
-import { WidgetManager } from "./widgets/WidgetManager";
-/** Defined that available UI Versions. It is recommended to always use the latest version available.
- * @deprecated Used to toggle between UI1.0 and UI2.0.
- * @public
- */
-export declare type FrameworkVersionId = "1" | "2";
-/** Interface to be implemented but any classes that wants to load their user settings when the UiStateEntry storage class is set.
- * @public
- */
-export interface UserSettingsProvider {
-    /** Unique provider Id */
-    providerId: string;
-    /** Function to load settings from settings storage */
-    loadUserSettings(storage: UiStateStorage): Promise<void>;
-}
-/** UiVisibility Event Args interface.
- * @public
- */
-export interface UiVisibilityEventArgs {
-    visible: boolean;
-}
-/** UiVisibility Event class.
- * @public
- */
-export declare class UiVisibilityChangedEvent extends UiEvent<UiVisibilityEventArgs> {
-}
-/** FrameworkVersion Changed Event Args interface.
- * @internal
- */
-export interface FrameworkVersionChangedEventArgs {
-    oldVersion: FrameworkVersionId;
-    version: FrameworkVersionId;
-}
-/** FrameworkVersion Changed Event class.
- * @internal
- */
-export declare class FrameworkVersionChangedEvent extends UiEvent<FrameworkVersionChangedEventArgs> {
-}
-/** TrackingTime time argument used by our feature tracking manager as an option argument to the TelemetryClient
- * @internal
- */
-export interface TrackingTime {
-    startTime: Date;
-    endTime: Date;
-}
-/**
- * Manages the Redux store, localization service and iModel, Project and Login services for the ui-framework package.
- * @public
- */
-export declare class UiFramework {
-    private static _initialized;
-    private static _store?;
-    private static _complaint;
-    private static _frameworkStateKeyInStore;
-    private static _backstageManager?;
-    private static _widgetManager?;
-    private static _uiVersion;
-    private static _hideIsolateEmphasizeActionHandler?;
-    /** this provides a default state storage handler */
-    private static _uiStateStorage;
-    private static _settingsManager?;
-    private static _uiSettingsProviderRegistry;
-    private static _PopupWindowManager;
-    static useDefaultPopoutUrl: boolean;
-    /** @public */
-    static get childWindowManager(): ChildWindowManager;
-    /** Registers class that will be informed when the UserSettingsStorage location has been set or changed. This allows
-     * classes to load any previously saved settings from the new storage location. Common storage locations are the browser's
-     * local storage, or the iTwin Product Settings cloud storage available via the SettingsAdmin see `IModelApp.settingsAdmin`.
-     * @beta
-     */
-    static registerUserSettingsProvider(entry: UserSettingsProvider): boolean;
-    /** Get Show Ui event.
-     * @public
-     */
-    static readonly onUiVisibilityChanged: UiVisibilityChangedEvent;
-    /**
-     * Called by the application to initialize the UiFramework. Also initializes UIIModelComponents, UiComponents, UiCore.
-     * @param store The single Redux store created by the host application. If this is `undefined` then it is assumed that the [[StateManager]] is being used to provide the Redux store.
-     * @param frameworkStateKey The name of the key used by the app when adding the UiFramework state into the Redux store. If not defined "frameworkState" is assumed. This value is ignored if [[StateManager]] is being used. The StateManager use "frameworkState".
-     * @param startInUi1Mode Used for legacy applications to start up in the deprecated UI 1 mode. This should not set by newer applications.
-     */
-    static initialize(store: Store<any> | undefined, frameworkStateKey?: string): Promise<void>;
-    /**
-     * @deprecated UI1.0 is deprecated. Use an overload without a `startInUi1Mode` argument instead.
-     */
-    static initialize(store: Store<any> | undefined, frameworkStateKey?: string, startInUi1Mode?: boolean): Promise<void>;
-    /**
-     * Called by the application to initialize the UiFramework. Also initializes UIIModelComponents, UiComponents, UiCore.
-     * @param store The single Redux store created by the host application. If this is `undefined` then it is assumed that the [[StateManager]] is being used to provide the Redux store.
-     * @param frameworkStateKey The name of the key used by the app when adding the UiFramework state into the Redux store. If not defined "frameworkState" is assumed. This value is ignored if [[StateManager]] is being used. The StateManager use "frameworkState".
-     * @param startInUi1Mode Used for legacy applications to start up in the deprecated UI 1 mode. This should not set by newer applications.
-     *
-     * @internal
-     */
-    static initializeEx(store: Store<any> | undefined, frameworkStateKey?: string, startInUi1Mode?: boolean): Promise<void>;
-    /** Un-registers the UiFramework internationalization service namespace */
-    static terminate(): void;
-    /** Determines if UiFramework has been initialized */
-    static get initialized(): boolean;
-    /** Property that returns the SettingManager used by AppUI-based applications.
-     * @public
-     */
-    static get settingsManager(): SettingsManager;
-    /** @public */
-    static get frameworkStateKey(): string;
-    /** The UiFramework state maintained by Redux
-     * @public
-     */
-    static get frameworkState(): FrameworkState | undefined;
-    /** The Redux store */
-    static get store(): Store<any>;
-    /** The internationalization service created by the app.
-     * @internal
-    */
-    static get localization(): Localization;
-    /** The internationalization service namespace. */
-    static get localizationNamespace(): string;
-    /** @public */
-    static get backstageManager(): BackstageManager;
-    /** @alpha */
-    static get hideIsolateEmphasizeActionHandler(): HideIsolateEmphasizeActionHandler;
-    /** @alpha */
-    static setHideIsolateEmphasizeActionHandler(handler: HideIsolateEmphasizeActionHandler | undefined): void;
-    /** @alpha */
-    static get widgetManager(): WidgetManager;
-    /** Calls localization.getLocalizedString with the "UiFramework" namespace. Do NOT include the namespace in the key.
-     * @internal
-     */
-    static translate(key: string | string[]): string;
-    /** @internal */
-    static get packageName(): string;
-    /** @internal */
-    static loggerCategory(obj: any): string;
-    static dispatchActionToStore(type: string, payload: any, immediateSync?: boolean): void;
-    static setAccudrawSnapMode(snapMode: SnapMode): void;
-    static getAccudrawSnapMode(): SnapMode;
-    static getActiveSelectionScope(): string;
-    static setActiveSelectionScope(selectionScopeId: string): void;
-    /** @public */
-    static openCursorMenu(menuData: CursorMenuData | undefined): void;
-    /** @public */
-    static closeCursorMenu(): void;
-    /** @public */
-    static getCursorMenuData(): CursorMenuData | undefined;
-    static getActiveIModelId(): string;
-    static setActiveIModelId(iModelId: string): void;
-    static setIModelConnection(iModelConnection: IModelConnection | undefined, immediateSync?: boolean): void;
-    static getIModelConnection(): IModelConnection | undefined;
-    /** Called by iModelApp to initialize saved UI state from registered UseSettingsProviders
-     * @public
-     */
-    static initializeStateFromUserSettingsProviders(immediateSync?: boolean): Promise<void>;
-    /** @public */
-    static setUiStateStorage(storage: UiStateStorage, immediateSync?: boolean): Promise<void>;
-    /** The UI Settings Storage is a convenient wrapper around Local Storage to assist in caching state information across user sessions.
-     * It was previously used to conflate both the state information across session and the information driven directly from user explicit action,
-     * which are now handled with user preferences.
-     * @public
-     */
-    static getUiStateStorage(): UiStateStorage;
-    static setDefaultIModelViewportControlId(iModelViewportControlId: string, immediateSync?: boolean): void;
-    static getDefaultIModelViewportControlId(): string | undefined;
-    static setDefaultViewId(viewId: string, immediateSync?: boolean): void;
-    static getDefaultViewId(): string | undefined;
-    static setDefaultViewState(viewState: ViewState, immediateSync?: boolean): void;
-    static getDefaultViewState(): ViewState | undefined;
-    /** @public */
-    static getAvailableSelectionScopes(): PresentationSelectionScope[];
-    static getIsUiVisible(): boolean;
-    static setIsUiVisible(visible: boolean): void;
-    static setColorTheme(theme: string): void;
-    static getColorTheme(): string;
-    /** UiFramework.setToolbarOpacity() sets the non-hovered opacity to the value specified. Used by UI 2.0 and later.
-     * @param opacity a value between 0 and 1. The default value is 0.5. IT IS NOT ADVISED TO USE A VALUE BELOW 0.2
-     * @public
-     */
-    static setToolbarOpacity(opacity: number): void;
-    /** UiFramework.getToolbarOpacity() returns a number between 0 and 1 that is the non-hovered opacity for toolbars.
-     * @public
-     */
-    static getToolbarOpacity(): number;
-    static setWidgetOpacity(opacity: number): void;
-    static getWidgetOpacity(): number;
-    static isMobile(): boolean;
-    /** Returns the Ui Version.
-     * @deprecated UI1.0 is deprecated.
-     * @public
-     */
-    static get uiVersion(): FrameworkVersionId;
-    /** @deprecated UI1.0 is deprecated. */
-    static setUiVersion(version: FrameworkVersionId): void;
-    static get showWidgetIcon(): boolean;
-    static setShowWidgetIcon(value: boolean): void;
-    /** Animate Tool Settings on appear  */
-    static get animateToolSettings(): boolean;
-    static setAnimateToolSettings(value: boolean): void;
-    /** Use Tool Name As Tool Settings Widget Tab Label */
-    static get useToolAsToolSettingsLabel(): boolean;
-    static setUseToolAsToolSettingsLabel(value: boolean): void;
-    /** @alpha */
-    static get autoCollapseUnpinnedPanels(): boolean;
-    /** Method used to enable the automatic closing of an unpinned widget panel as soon as the
-     * mouse leaves the widget panel. The default behavior is to require a mouse click outside
-     * the panel before it is closed.
-     * @alpha */
-    static setAutoCollapseUnpinnedPanels(value: boolean): void;
-    static get useDragInteraction(): boolean;
-    static setUseDragInteraction(useDragInteraction: boolean): void;
-    /** Returns the variable controlling whether the overlay is displayed in a Viewport
-     * @public
-     */
-    static get viewOverlayDisplay(): boolean;
-    /** Set the variable that controls display of the view overlay. Applies to all viewports in the app
-   * @public
-   */
-    static setViewOverlayDisplay(display: boolean): void;
-    /** Send logging message to the telemetry system
-     * @internal
-     */
-    static postTelemetry(eventName: string, eventId?: GuidString, iTwinId?: GuidString, iModeId?: GuidString, changeSetId?: string, time?: TrackingTime, additionalProperties?: {
-        [key: string]: any;
-    }): Promise<void>;
-    /** Determines whether a ContextMenu is open
-     * @alpha
-     * */
-    static get isContextMenuOpen(): boolean;
-}
+/** @packageDocumentation
+ * @module Utilities
+ */
+import { Store } from "redux";
+import { GuidString } from "@itwin/core-bentley";
+import { Localization } from "@itwin/core-common";
+import { IModelConnection, SnapMode, ViewState } from "@itwin/core-frontend";
+import { UiEvent } from "@itwin/appui-abstract";
+import { SettingsManager, UiStateStorage } from "@itwin/core-react";
+import { BackstageManager } from "./backstage/BackstageManager";
+import { ChildWindowManager } from "./childwindow/ChildWindowManager";
+import { FrameworkState } from "./redux/FrameworkState";
+import { CursorMenuData, PresentationSelectionScope } from "./redux/SessionState";
+import { HideIsolateEmphasizeActionHandler } from "./selection/HideIsolateEmphasizeManager";
+import { WidgetManager } from "./widgets/WidgetManager";
+/** Defined that available UI Versions. It is recommended to always use the latest version available.
+ * @deprecated Used to toggle between UI1.0 and UI2.0.
+ * @public
+ */
+export declare type FrameworkVersionId = "1" | "2";
+/** Interface to be implemented but any classes that wants to load their user settings when the UiStateEntry storage class is set.
+ * @public
+ */
+export interface UserSettingsProvider {
+    /** Unique provider Id */
+    providerId: string;
+    /** Function to load settings from settings storage */
+    loadUserSettings(storage: UiStateStorage): Promise<void>;
+}
+/** UiVisibility Event Args interface.
+ * @public
+ */
+export interface UiVisibilityEventArgs {
+    visible: boolean;
+}
+/** UiVisibility Event class.
+ * @public
+ */
+export declare class UiVisibilityChangedEvent extends UiEvent<UiVisibilityEventArgs> {
+}
+/** FrameworkVersion Changed Event Args interface.
+ * @internal
+ */
+export interface FrameworkVersionChangedEventArgs {
+    oldVersion: FrameworkVersionId;
+    version: FrameworkVersionId;
+}
+/** FrameworkVersion Changed Event class.
+ * @internal
+ */
+export declare class FrameworkVersionChangedEvent extends UiEvent<FrameworkVersionChangedEventArgs> {
+}
+/** TrackingTime time argument used by our feature tracking manager as an option argument to the TelemetryClient
+ * @internal
+ */
+export interface TrackingTime {
+    startTime: Date;
+    endTime: Date;
+}
+/**
+ * Manages the Redux store, localization service and iModel, Project and Login services for the ui-framework package.
+ * @public
+ */
+export declare class UiFramework {
+    private static _initialized;
+    private static _store?;
+    private static _complaint;
+    private static _frameworkStateKeyInStore;
+    private static _backstageManager?;
+    private static _widgetManager?;
+    private static _uiVersion;
+    private static _hideIsolateEmphasizeActionHandler?;
+    /** this provides a default state storage handler */
+    private static _uiStateStorage;
+    private static _settingsManager?;
+    private static _uiSettingsProviderRegistry;
+    private static _PopupWindowManager;
+    static useDefaultPopoutUrl: boolean;
+    /** @public */
+    static get childWindowManager(): ChildWindowManager;
+    /** Registers class that will be informed when the UserSettingsStorage location has been set or changed. This allows
+     * classes to load any previously saved settings from the new storage location. Common storage locations are the browser's
+     * local storage, or the iTwin Product Settings cloud storage available via the SettingsAdmin see `IModelApp.settingsAdmin`.
+     * @beta
+     */
+    static registerUserSettingsProvider(entry: UserSettingsProvider): boolean;
+    /** Get Show Ui event.
+     * @public
+     */
+    static readonly onUiVisibilityChanged: UiVisibilityChangedEvent;
+    /**
+     * Called by the application to initialize the UiFramework. Also initializes UIIModelComponents, UiComponents, UiCore.
+     * @param store The single Redux store created by the host application. If this is `undefined` then it is assumed that the [[StateManager]] is being used to provide the Redux store.
+     * @param frameworkStateKey The name of the key used by the app when adding the UiFramework state into the Redux store. If not defined "frameworkState" is assumed. This value is ignored if [[StateManager]] is being used. The StateManager use "frameworkState".
+     * @param startInUi1Mode Used for legacy applications to start up in the deprecated UI 1 mode. This should not set by newer applications.
+     */
+    static initialize(store: Store<any> | undefined, frameworkStateKey?: string): Promise<void>;
+    /**
+     * @deprecated UI1.0 is deprecated. Use an overload without a `startInUi1Mode` argument instead.
+     */
+    static initialize(store: Store<any> | undefined, frameworkStateKey?: string, startInUi1Mode?: boolean): Promise<void>;
+    /**
+     * Called by the application to initialize the UiFramework. Also initializes UIIModelComponents, UiComponents, UiCore.
+     * @param store The single Redux store created by the host application. If this is `undefined` then it is assumed that the [[StateManager]] is being used to provide the Redux store.
+     * @param frameworkStateKey The name of the key used by the app when adding the UiFramework state into the Redux store. If not defined "frameworkState" is assumed. This value is ignored if [[StateManager]] is being used. The StateManager use "frameworkState".
+     * @param startInUi1Mode Used for legacy applications to start up in the deprecated UI 1 mode. This should not set by newer applications.
+     *
+     * @internal
+     */
+    static initializeEx(store: Store<any> | undefined, frameworkStateKey?: string, startInUi1Mode?: boolean): Promise<void>;
+    /** Un-registers the UiFramework internationalization service namespace */
+    static terminate(): void;
+    /** Determines if UiFramework has been initialized */
+    static get initialized(): boolean;
+    /** Property that returns the SettingManager used by AppUI-based applications.
+     * @public
+     */
+    static get settingsManager(): SettingsManager;
+    /** @public */
+    static get frameworkStateKey(): string;
+    /** The UiFramework state maintained by Redux
+     * @public
+     */
+    static get frameworkState(): FrameworkState | undefined;
+    /** The Redux store */
+    static get store(): Store<any>;
+    /** The internationalization service created by the app.
+     * @internal
+    */
+    static get localization(): Localization;
+    /** The internationalization service namespace. */
+    static get localizationNamespace(): string;
+    /** @public */
+    static get backstageManager(): BackstageManager;
+    /** @alpha */
+    static get hideIsolateEmphasizeActionHandler(): HideIsolateEmphasizeActionHandler;
+    /** @alpha */
+    static setHideIsolateEmphasizeActionHandler(handler: HideIsolateEmphasizeActionHandler | undefined): void;
+    /** @alpha */
+    static get widgetManager(): WidgetManager;
+    /** Calls localization.getLocalizedString with the "UiFramework" namespace. Do NOT include the namespace in the key.
+     * @internal
+     */
+    static translate(key: string | string[]): string;
+    /** @internal */
+    static get packageName(): string;
+    /** @internal */
+    static loggerCategory(obj: any): string;
+    static dispatchActionToStore(type: string, payload: any, immediateSync?: boolean): void;
+    static setAccudrawSnapMode(snapMode: SnapMode): void;
+    static getAccudrawSnapMode(): SnapMode;
+    static getActiveSelectionScope(): string;
+    static setActiveSelectionScope(selectionScopeId: string): void;
+    /** @public */
+    static openCursorMenu(menuData: CursorMenuData | undefined): void;
+    /** @public */
+    static closeCursorMenu(): void;
+    /** @public */
+    static getCursorMenuData(): CursorMenuData | undefined;
+    static getActiveIModelId(): string;
+    static setActiveIModelId(iModelId: string): void;
+    static setIModelConnection(iModelConnection: IModelConnection | undefined, immediateSync?: boolean): void;
+    static getIModelConnection(): IModelConnection | undefined;
+    /** Called by iModelApp to initialize saved UI state from registered UseSettingsProviders
+     * @public
+     */
+    static initializeStateFromUserSettingsProviders(immediateSync?: boolean): Promise<void>;
+    /** @public */
+    static setUiStateStorage(storage: UiStateStorage, immediateSync?: boolean): Promise<void>;
+    /** The UI Settings Storage is a convenient wrapper around Local Storage to assist in caching state information across user sessions.
+     * It was previously used to conflate both the state information across session and the information driven directly from user explicit action,
+     * which are now handled with user preferences.
+     * @public
+     */
+    static getUiStateStorage(): UiStateStorage;
+    static setDefaultIModelViewportControlId(iModelViewportControlId: string, immediateSync?: boolean): void;
+    static getDefaultIModelViewportControlId(): string | undefined;
+    static setDefaultViewId(viewId: string, immediateSync?: boolean): void;
+    static getDefaultViewId(): string | undefined;
+    static setDefaultViewState(viewState: ViewState, immediateSync?: boolean): void;
+    static getDefaultViewState(): ViewState | undefined;
+    /** @public */
+    static getAvailableSelectionScopes(): PresentationSelectionScope[];
+    static getIsUiVisible(): boolean;
+    static setIsUiVisible(visible: boolean): void;
+    static setColorTheme(theme: string): void;
+    static getColorTheme(): string;
+    /** UiFramework.setToolbarOpacity() sets the non-hovered opacity to the value specified. Used by UI 2.0 and later.
+     * @param opacity a value between 0 and 1. The default value is 0.5. IT IS NOT ADVISED TO USE A VALUE BELOW 0.2
+     * @public
+     */
+    static setToolbarOpacity(opacity: number): void;
+    /** UiFramework.getToolbarOpacity() returns a number between 0 and 1 that is the non-hovered opacity for toolbars.
+     * @public
+     */
+    static getToolbarOpacity(): number;
+    static setWidgetOpacity(opacity: number): void;
+    static getWidgetOpacity(): number;
+    static isMobile(): boolean;
+    /** Returns the Ui Version.
+     * @deprecated UI1.0 is deprecated.
+     * @public
+     */
+    static get uiVersion(): FrameworkVersionId;
+    /** @deprecated UI1.0 is deprecated. */
+    static setUiVersion(version: FrameworkVersionId): void;
+    static get showWidgetIcon(): boolean;
+    static setShowWidgetIcon(value: boolean): void;
+    /** Animate Tool Settings on appear  */
+    static get animateToolSettings(): boolean;
+    static setAnimateToolSettings(value: boolean): void;
+    /** Use Tool Name As Tool Settings Widget Tab Label */
+    static get useToolAsToolSettingsLabel(): boolean;
+    static setUseToolAsToolSettingsLabel(value: boolean): void;
+    /** @alpha */
+    static get autoCollapseUnpinnedPanels(): boolean;
+    /** Method used to enable the automatic closing of an unpinned widget panel as soon as the
+     * mouse leaves the widget panel. The default behavior is to require a mouse click outside
+     * the panel before it is closed.
+     * @alpha */
+    static setAutoCollapseUnpinnedPanels(value: boolean): void;
+    static get useDragInteraction(): boolean;
+    static setUseDragInteraction(useDragInteraction: boolean): void;
+    /** Returns the variable controlling whether the overlay is displayed in a Viewport
+     * @public
+     */
+    static get viewOverlayDisplay(): boolean;
+    /** Set the variable that controls display of the view overlay. Applies to all viewports in the app
+   * @public
+   */
+    static setViewOverlayDisplay(display: boolean): void;
+    /** Send logging message to the telemetry system
+     * @internal
+     */
+    static postTelemetry(eventName: string, eventId?: GuidString, iTwinId?: GuidString, iModeId?: GuidString, changeSetId?: string, time?: TrackingTime, additionalProperties?: {
+        [key: string]: any;
+    }): Promise<void>;
+    /** Determines whether a ContextMenu is open
+     * @alpha
+     * */
+    static get isContextMenuOpen(): boolean;
+}
 //# sourceMappingURL=UiFramework.d.ts.map