@theia/core 1.67.0-next.56 → 1.67.0-next.86

package/lib/browser/shell/shell-layout-restorer.js

@@ -0,0 +1,343 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+var ShellLayoutRestorer_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShellLayoutRestorer = exports.RESET_LAYOUT = exports.ShellLayoutTransformer = exports.ApplicationShellLayoutMigration = exports.ApplicationShellLayoutMigrationError = exports.StatefulWidget = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const widget_manager_1 = require("../widget-manager");
+const storage_service_1 = require("../storage-service");
+const logger_1 = require("../../common/logger");
+const command_1 = require("../../common/command");
+const theming_1 = require("../theming");
+const contribution_provider_1 = require("../../common/contribution-provider");
+const application_shell_1 = require("./application-shell");
+const common_commands_1 = require("../common-commands");
+const window_service_1 = require("../window/window-service");
+const frontend_application_state_1 = require("../../common/frontend-application-state");
+const common_1 = require("../../common");
+var StatefulWidget;
+(function (StatefulWidget) {
+    function is(arg) {
+        return (0, common_1.isObject)(arg) && (0, common_1.isFunction)(arg.storeState) && (0, common_1.isFunction)(arg.restoreState);
+    }
+    StatefulWidget.is = is;
+})(StatefulWidget || (exports.StatefulWidget = StatefulWidget = {}));
+var ApplicationShellLayoutMigrationError;
+(function (ApplicationShellLayoutMigrationError) {
+    const code = 'ApplicationShellLayoutMigrationError';
+    function create(message) {
+        return Object.assign(new Error(`Could not migrate layout to version ${application_shell_1.applicationShellLayoutVersion}.` + (message ? '\n' + message : '')), { code });
+    }
+    ApplicationShellLayoutMigrationError.create = create;
+    function is(error) {
+        return !!error && 'code' in error && error['code'] === code;
+    }
+    ApplicationShellLayoutMigrationError.is = is;
+})(ApplicationShellLayoutMigrationError || (exports.ApplicationShellLayoutMigrationError = ApplicationShellLayoutMigrationError = {}));
+exports.ApplicationShellLayoutMigration = Symbol('ApplicationShellLayoutMigration');
+exports.ShellLayoutTransformer = Symbol('ShellLayoutTransformer');
+exports.RESET_LAYOUT = command_1.Command.toLocalizedCommand({
+    id: 'reset.layout',
+    category: common_commands_1.CommonCommands.VIEW_CATEGORY,
+    label: 'Reset Workbench Layout'
+}, 'theia/core/resetWorkbenchLayout', common_commands_1.CommonCommands.VIEW_CATEGORY_KEY);
+let ShellLayoutRestorer = ShellLayoutRestorer_1 = class ShellLayoutRestorer {
+    constructor(widgetManager, logger, storageService) {
+        this.widgetManager = widgetManager;
+        this.logger = logger;
+        this.storageService = storageService;
+        this.storageKey = 'layout';
+        this.shouldStoreLayout = true;
+    }
+    registerCommands(commands) {
+        commands.registerCommand(exports.RESET_LAYOUT, {
+            execute: async () => this.resetLayout()
+        });
+    }
+    async resetLayout() {
+        if (await this.windowService.isSafeToShutDown(frontend_application_state_1.StopReason.Reload)) {
+            this.logger.info('>>> Resetting layout...');
+            this.shouldStoreLayout = false;
+            this.storageService.setData(this.storageKey, undefined);
+            this.themeService.reset();
+            this.logger.info('<<< The layout has been successfully reset.');
+            this.windowService.reload();
+        }
+    }
+    storeLayout(app) {
+        if (this.shouldStoreLayout) {
+            try {
+                this.logger.info('>>> Storing the layout...');
+                const layoutData = app.shell.getLayoutData();
+                const serializedLayoutData = this.deflate(layoutData);
+                this.storageService.setData(this.storageKey, serializedLayoutData);
+                this.logger.info('<<< The layout has been successfully stored.');
+            }
+            catch (error) {
+                this.storageService.setData(this.storageKey, undefined);
+                this.logger.error('Error during serialization of layout data', error);
+            }
+        }
+    }
+    async restoreLayout(app) {
+        this.logger.info('>>> Restoring the layout state...');
+        const serializedLayoutData = await this.storageService.getData(this.storageKey);
+        if (serializedLayoutData === undefined) {
+            this.logger.info('<<< Nothing to restore.');
+            return false;
+        }
+        const layoutData = await this.inflate(serializedLayoutData);
+        this.transformations.getContributions().forEach(transformation => transformation.transformLayoutOnRestore(layoutData));
+        await app.shell.setLayoutData(layoutData);
+        this.logger.info('<<< The layout has been successfully restored.');
+        return true;
+    }
+    isWidgetProperty(propertyName) {
+        return propertyName === 'widget';
+    }
+    isWidgetsProperty(propertyName) {
+        return propertyName === 'widgets';
+    }
+    /**
+     * Turns the layout data to a string representation.
+     */
+    deflate(data) {
+        return JSON.stringify(data, (property, value) => {
+            if (this.isWidgetProperty(property)) {
+                const description = this.convertToDescription(value);
+                return description;
+            }
+            else if (this.isWidgetsProperty(property)) {
+                const descriptions = [];
+                for (const widget of value) {
+                    const description = this.convertToDescription(widget);
+                    if (description) {
+                        descriptions.push(description);
+                    }
+                }
+                return descriptions;
+            }
+            return value;
+        });
+    }
+    convertToDescription(widget) {
+        const desc = this.widgetManager.getDescription(widget);
+        if (desc) {
+            if (StatefulWidget.is(widget)) {
+                const innerState = widget.storeState();
+                return innerState ? {
+                    constructionOptions: desc,
+                    innerWidgetState: this.deflate(innerState)
+                } : undefined;
+            }
+            else {
+                return {
+                    constructionOptions: desc,
+                    innerWidgetState: undefined
+                };
+            }
+        }
+    }
+    /**
+     * Creates the layout data from its string representation.
+     */
+    async inflate(layoutData) {
+        const parseContext = new ShellLayoutRestorer_1.ParseContext();
+        const layout = this.parse(layoutData, parseContext);
+        const layoutVersion = Number(layout.version);
+        if (typeof layoutVersion !== 'number' || Number.isNaN(layoutVersion)) {
+            throw new Error('could not resolve a layout version');
+        }
+        if (layoutVersion !== application_shell_1.applicationShellLayoutVersion) {
+            if (layoutVersion < application_shell_1.applicationShellLayoutVersion) {
+                console.warn(`Layout version ${layoutVersion} is behind current layout version ${application_shell_1.applicationShellLayoutVersion}, trying to migrate...`);
+            }
+            else {
+                console.warn(`Layout version ${layoutVersion} is ahead current layout version ${application_shell_1.applicationShellLayoutVersion}, trying to load anyway...`);
+            }
+            console.info(`Please use '${exports.RESET_LAYOUT.label}' command if the layout looks bogus.`);
+        }
+        const migrations = this.migrations.getContributions()
+            .filter(m => m.layoutVersion > layoutVersion && m.layoutVersion <= application_shell_1.applicationShellLayoutVersion)
+            .sort((m, m2) => m.layoutVersion - m2.layoutVersion);
+        if (migrations.length) {
+            console.info(`Found ${migrations.length} migrations from layout version ${layoutVersion} to version ${application_shell_1.applicationShellLayoutVersion}, migrating...`);
+        }
+        const context = { layout, layoutVersion, migrations };
+        await this.fireWillInflateLayout(context);
+        await parseContext.inflate(context);
+        return layout;
+    }
+    async fireWillInflateLayout(context) {
+        for (const migration of context.migrations) {
+            if (migration.onWillInflateLayout) {
+                // don't catch exceptions, if one migration fails all should fail.
+                await migration.onWillInflateLayout(context);
+            }
+        }
+    }
+    parse(layoutData, parseContext) {
+        return JSON.parse(layoutData, (property, value) => {
+            if (this.isWidgetsProperty(property)) {
+                const widgets = parseContext.filteredArray();
+                const descs = value;
+                for (let i = 0; i < descs.length; i++) {
+                    parseContext.push(async (context) => {
+                        widgets[i] = await this.convertToWidget(descs[i], context);
+                    });
+                }
+                return widgets;
+            }
+            else if ((0, common_1.isObject)(value) && !Array.isArray(value)) {
+                const copy = {};
+                for (const p in value) {
+                    if (this.isWidgetProperty(p)) {
+                        parseContext.push(async (context) => {
+                            copy[p] = await this.convertToWidget(value[p], context);
+                        });
+                    }
+                    else {
+                        copy[p] = value[p];
+                    }
+                }
+                return copy;
+            }
+            return value;
+        });
+    }
+    async fireWillInflateWidget(desc, context) {
+        for (const migration of context.migrations) {
+            if (migration.onWillInflateWidget) {
+                // don't catch exceptions, if one migration fails all should fail.
+                const migrated = await migration.onWillInflateWidget(desc, context);
+                if (migrated) {
+                    if ((0, common_1.isObject)(migrated.innerWidgetState)) {
+                        // in order to inflate nested widgets
+                        migrated.innerWidgetState = JSON.stringify(migrated.innerWidgetState);
+                    }
+                    desc = migrated;
+                }
+            }
+        }
+        return desc;
+    }
+    async convertToWidget(desc, context) {
+        if (!desc.constructionOptions) {
+            return undefined;
+        }
+        try {
+            desc = await this.fireWillInflateWidget(desc, context);
+            const widget = await this.widgetManager.getOrCreateWidget(desc.constructionOptions.factoryId, desc.constructionOptions.options);
+            if (StatefulWidget.is(widget) && desc.innerWidgetState !== undefined) {
+                try {
+                    let oldState;
+                    if (typeof desc.innerWidgetState === 'string') {
+                        const parseContext = new ShellLayoutRestorer_1.ParseContext();
+                        oldState = this.parse(desc.innerWidgetState, parseContext);
+                        await parseContext.inflate({ ...context, parent: widget });
+                    }
+                    else {
+                        oldState = desc.innerWidgetState;
+                    }
+                    widget.restoreState(oldState);
+                }
+                catch (e) {
+                    if (ApplicationShellLayoutMigrationError.is(e)) {
+                        throw e;
+                    }
+                    this.logger.warn(`Couldn't restore widget state for ${widget.id}. Error: ${e} `);
+                }
+            }
+            if (widget.isDisposed) {
+                return undefined;
+            }
+            return widget;
+        }
+        catch (e) {
+            if (ApplicationShellLayoutMigrationError.is(e)) {
+                throw e;
+            }
+            this.logger.warn(`Couldn't restore widget for ${desc.constructionOptions.factoryId}. Error: ${e} `);
+            return undefined;
+        }
+    }
+};
+exports.ShellLayoutRestorer = ShellLayoutRestorer;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(contribution_provider_1.ContributionProvider),
+    (0, inversify_1.named)(exports.ApplicationShellLayoutMigration),
+    tslib_1.__metadata("design:type", Object)
+], ShellLayoutRestorer.prototype, "migrations", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(contribution_provider_1.ContributionProvider),
+    (0, inversify_1.named)(exports.ShellLayoutTransformer),
+    tslib_1.__metadata("design:type", Object)
+], ShellLayoutRestorer.prototype, "transformations", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(window_service_1.WindowService),
+    tslib_1.__metadata("design:type", Object)
+], ShellLayoutRestorer.prototype, "windowService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(theming_1.ThemeService),
+    tslib_1.__metadata("design:type", theming_1.ThemeService)
+], ShellLayoutRestorer.prototype, "themeService", void 0);
+exports.ShellLayoutRestorer = ShellLayoutRestorer = ShellLayoutRestorer_1 = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(widget_manager_1.WidgetManager)),
+    tslib_1.__param(1, (0, inversify_1.inject)(logger_1.ILogger)),
+    tslib_1.__param(2, (0, inversify_1.inject)(storage_service_1.StorageService)),
+    tslib_1.__metadata("design:paramtypes", [widget_manager_1.WidgetManager, Object, Object])
+], ShellLayoutRestorer);
+(function (ShellLayoutRestorer) {
+    class ParseContext {
+        constructor() {
+            this.toInflate = [];
+            this.toFilter = [];
+        }
+        /**
+         * Returns an array, which will be filtered from undefined elements
+         * after resolving promises, that create widgets.
+         */
+        filteredArray() {
+            const array = [];
+            this.toFilter.push(array);
+            return array;
+        }
+        push(toInflate) {
+            this.toInflate.push(toInflate);
+        }
+        async inflate(context) {
+            const pending = [];
+            while (this.toInflate.length) {
+                pending.push(this.toInflate.pop()(context));
+            }
+            await Promise.all(pending);
+            if (this.toFilter.length) {
+                this.toFilter.forEach(array => {
+                    for (let i = 0; i < array.length; i++) {
+                        if (array[i] === undefined) {
+                            array.splice(i--, 1);
+                        }
+                    }
+                });
+            }
+        }
+    }
+    ShellLayoutRestorer.ParseContext = ParseContext;
+})(ShellLayoutRestorer || (exports.ShellLayoutRestorer = ShellLayoutRestorer = {}));
+//# sourceMappingURL=shell-layout-restorer.js.map

package/lib/browser/shell/shell-layout-restorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-layout-restorer.js","sourceRoot":"","sources":["../../../src/browser/shell/shell-layout-restorer.ts"],"names":[],"mappings":"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"}

package/lib/browser/shell/side-panel-handler.d.ts

@@ -0,0 +1,287 @@
+import { TabBar, Widget, DockPanel, Title, Panel } from '@lumino/widgets';
+import { AttachedProperty } from '@lumino/properties';
+import { TabBarRenderer, SideTabBar } from './tab-bars';
+import { SidebarMenuWidget, SidebarMenu } from './sidebar-menu-widget';
+import { SplitPositionHandler } from './split-panels';
+import { FrontendApplicationStateService } from '../frontend-application-state';
+import { TheiaDockPanel } from './theia-dock-panel';
+import { SidePanelToolbar } from './side-panel-toolbar';
+import { TabBarToolbarRegistry, TabBarToolbar } from './tab-bar-toolbar';
+import { DisposableCollection } from '../../common/disposable';
+import { ContextMenuRenderer } from '../context-menu-renderer';
+import { MenuPath } from '../../common/menu';
+import { SidebarBottomMenuWidget } from './sidebar-bottom-menu-widget';
+import { SidebarTopMenuWidget } from './sidebar-top-menu-widget';
+import { AdditionalViewsMenuWidget, AdditionalViewsMenuWidgetFactory } from './additional-views-menu-widget';
+/** The class name added to the left and right area panels. */
+export declare const LEFT_RIGHT_AREA_CLASS = "theia-app-sides";
+export declare const SidePanelHandlerFactory: unique symbol;
+export declare const SIDE_PANEL_TOOLBAR_CONTEXT_MENU: MenuPath;
+/**
+ * A class which manages a dock panel and a related side bar. This is used for the left and right
+ * panel of the application shell.
+ */
+export declare class SidePanelHandler {
+    /**
+     * A property that can be attached to widgets in order to determine the insertion index
+     * of their title in the tab bar.
+     */
+    protected static readonly rankProperty: AttachedProperty<Widget, number | undefined>;
+    /**
+     * The tab bar displays the titles of the widgets in the side panel. Visibility of the widgets
+     * is controlled entirely through tab selection: a widget is revealed by setting the `currentTitle`
+     * accordingly in the tab bar, and the panel is hidden by setting that property to `null`. The
+     * tab bar itself remains visible as long as there is at least one widget.
+     */
+    tabBar: SideTabBar;
+    /**
+     * Conditional menu placed below the tabBar. Manages overflowing/hidden tabs.
+     * Is only visible if there are overflowing tabs.
+     */
+    additionalViewsMenu: AdditionalViewsMenuWidget;
+    /**
+     * The menu placed on the sidebar top.
+     * Displayed as icons.
+     * Open menus when on clicks.
+     */
+    topMenu: SidebarMenuWidget;
+    /**
+     * The menu placed on the sidebar bottom.
+     * Displayed as icons.
+     * Open menus when on clicks.
+     */
+    bottomMenu: SidebarMenuWidget;
+    /**
+     * A tool bar, which displays a title and widget specific command buttons.
+     */
+    toolBar: SidePanelToolbar;
+    /**
+     * The widget container is a dock panel in `single-document` mode, which means that the panel
+     * cannot be split.
+     */
+    dockPanel: TheiaDockPanel;
+    /**
+     * The panel that contains the tab bar and the dock panel. This one is hidden whenever the dock
+     * panel is empty.
+     */
+    container: Panel;
+    /**
+     * The current state of the side panel.
+     */
+    readonly state: SidePanel.State;
+    /**
+     * The shell area where the panel is placed. This property should not be modified directly, but
+     * only by calling `create`.
+     */
+    protected side: 'left' | 'right';
+    /**
+     * Options that control the behavior of the side panel.
+     */
+    protected options: SidePanel.Options;
+    protected tabBarToolBarRegistry: TabBarToolbarRegistry;
+    protected tabBarToolBarFactory: () => TabBarToolbar;
+    protected tabBarRendererFactory: () => TabBarRenderer;
+    protected sidebarTopWidgetFactory: () => SidebarTopMenuWidget;
+    protected sidebarBottomWidgetFactory: () => SidebarBottomMenuWidget;
+    protected additionalViewsMenuFactory: AdditionalViewsMenuWidgetFactory;
+    protected splitPositionHandler: SplitPositionHandler;
+    protected readonly applicationStateService: FrontendApplicationStateService;
+    protected readonly dockPanelFactory: TheiaDockPanel.Factory;
+    protected readonly contextMenuRenderer: ContextMenuRenderer;
+    /**
+     * Create the side bar and dock panel widgets.
+     */
+    create(side: 'left' | 'right', options: SidePanel.Options): void;
+    protected createSideBar(): SideTabBar;
+    protected createSidePanel(): TheiaDockPanel;
+    protected createToolbar(): SidePanelToolbar;
+    protected createAdditionalViewsWidget(): AdditionalViewsMenuWidget;
+    protected createSidebarTopMenu(): SidebarTopMenuWidget;
+    protected createSidebarBottomMenu(): SidebarBottomMenuWidget;
+    protected createSidebarMenu<T extends SidebarMenuWidget>(factory: () => T): T;
+    protected showContextMenu(e: MouseEvent): void;
+    protected createContainer(): Panel;
+    /**
+     * Create an object that describes the current side panel layout. This object may contain references
+     * to widgets; these need to be transformed before the layout can be serialized.
+     */
+    getLayoutData(): SidePanel.LayoutData;
+    /**
+     * Apply a side panel layout that has been previously created with `getLayoutData`.
+     */
+    setLayoutData(layoutData: SidePanel.LayoutData): void;
+    /**
+     * Activate a widget residing in the side panel by ID.
+     *
+     * @returns the activated widget if it was found
+     */
+    activate(id: string): Widget | undefined;
+    /**
+     * Expand a widget residing in the side panel by ID. If no ID is given and the panel is
+     * currently collapsed, the last active tab of this side panel is expanded. If no tab
+     * was expanded previously, the first one is taken.
+     *
+     * @returns the expanded widget if it was found
+     */
+    expand(id?: string): Widget | undefined;
+    /**
+     * Collapse the sidebar so no items are expanded.
+     */
+    collapse(): Promise<void>;
+    /**
+     * Add a widget and its title to the dock panel and side bar.
+     *
+     * If the widget is already added, it will be moved.
+     */
+    addWidget(widget: Widget, options: SidePanel.WidgetOptions): void;
+    /**
+     * Add a menu to the sidebar top.
+     *
+     * If the menu is already added, it will be ignored.
+     */
+    addTopMenu(menu: SidebarMenu): void;
+    /**
+     * Remove a menu from the sidebar top.
+     *
+     * @param menuId id of the menu to remove
+     */
+    removeTopMenu(menuId: string): void;
+    /**
+     * Add a menu to the sidebar bottom.
+     *
+     * If the menu is already added, it will be ignored.
+     */
+    addBottomMenu(menu: SidebarMenu): void;
+    /**
+     * Remove a menu from the sidebar bottom.
+     *
+     * @param menuId id of the menu to remove
+     */
+    removeBottomMenu(menuId: string): void;
+    protected updateToolbarTitle: () => void;
+    /**
+     * Refresh the visibility of the side bar and dock panel.
+     */
+    refresh(): void;
+    /**
+     * Sets the size of the side panel.
+     *
+     * @param size the desired size (width) of the panel in pixels.
+     */
+    resize(size: number): void;
+    /**
+     * Compute the current width of the panel. This implementation assumes that the parent of
+     * the panel container is a `SplitPanel`.
+     */
+    protected getPanelSize(): number | undefined;
+    /**
+     * Determine the default size to apply when the panel is expanded for the first time.
+     */
+    protected getDefaultPanelSize(): number | undefined;
+    /**
+     * Modify the width of the panel. This implementation assumes that the parent of the panel
+     * container is a `SplitPanel`.
+     */
+    protected setPanelSize(size: number): Promise<void>;
+    protected readonly toDisposeOnCurrentTabChanged: DisposableCollection;
+    /**
+     * Handle a `currentChanged` signal from the sidebar. The side panel is refreshed so it displays
+     * the new selected widget.
+     */
+    protected onCurrentTabChanged(sender: SideTabBar, { currentTitle, currentIndex }: TabBar.ICurrentChangedArgs<Widget>): void;
+    /**
+     * Handle a `tabDetachRequested` signal from the sidebar. A drag is started so the widget can be
+     * moved to another application shell area.
+     */
+    protected onTabDetachRequested(sender: SideTabBar, { title, tab, clientX, clientY }: TabBar.ITabDetachRequestedArgs<Widget>): void;
+    protected onTabsOverflowChanged(sender: SideTabBar, event: {
+        titles: Title<Widget>[];
+        startIndex: number;
+    }): void;
+    protected onWidgetAdded(sender: DockPanel, widget: Widget): void;
+    protected onWidgetRemoved(sender: DockPanel, widget: Widget): void;
+    protected updateSashState(sidePanelElement: Panel | null, sidePanelCollapsed: boolean): void;
+}
+export declare namespace SidePanel {
+    /**
+     * Options that control the behavior of side panels.
+     */
+    interface Options {
+        /**
+         * When a widget is being dragged and the distance of the mouse cursor to the shell border
+         * is below this threshold, the respective side panel is expanded so the widget can be dropped
+         * into that panel. Set this to `-1` to disable expanding the side panel while dragging.
+         */
+        expandThreshold: number;
+        /**
+         * The duration in milliseconds of the animation shown when a side panel is expanded.
+         * Set this to `0` to disable expansion animation.
+         */
+        expandDuration: number;
+        /**
+         * The ratio of the available shell size to use as initial size for the side panel.
+         */
+        initialSizeRatio: number;
+        /**
+         * How large the panel should be when it's expanded and empty.
+         */
+        emptySize: number;
+    }
+    /**
+     * The options for adding a widget to a side panel.
+     */
+    interface WidgetOptions {
+        /**
+         * The rank order of the widget among its siblings.
+         */
+        rank?: number;
+    }
+    /**
+     * Data to save and load the layout of a side panel.
+     */
+    interface LayoutData {
+        type: 'sidepanel';
+        items?: WidgetItem[];
+        size?: number;
+    }
+    /**
+     * Data structure used to save and restore the side panel layout.
+     */
+    interface WidgetItem extends WidgetOptions {
+        /** Can be undefined in case the widget could not be restored. */
+        widget?: Widget;
+        expanded?: boolean;
+        pinned?: boolean;
+    }
+    interface State {
+        /**
+         * Indicates whether the panel is empty.
+         */
+        empty: boolean;
+        /**
+         * Indicates whether the panel is expanded, collapsed, or in a transition between the two.
+         */
+        expansion: ExpansionState;
+        /**
+         * A promise that is resolved when the currently pending side panel updates are done.
+         */
+        pendingUpdate: Promise<void>;
+        /**
+         * The index of the last tab that was selected. When the panel is expanded, it tries to restore
+         * the tab selection to the previous state.
+         */
+        lastActiveTabIndex?: number;
+        /**
+         * The width or height of the panel before it was collapsed. When the panel is expanded, it tries
+         * to restore its size to this value.
+         */
+        lastPanelSize?: number;
+    }
+    enum ExpansionState {
+        collapsed = "collapsed",
+        expanding = "expanding",
+        expanded = "expanded",
+        collapsing = "collapsing"
+    }
+}
+//# sourceMappingURL=side-panel-handler.d.ts.map

package/lib/browser/shell/side-panel-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-panel-handler.d.ts","sourceRoot":"","sources":["../../../src/browser/shell/side-panel-handler.ts"],"names":[],"mappings":"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"}