@theia/core 1.74.0-next.9 → 1.74.1

package/lib/browser/perspective-service.d.ts

@@ -0,0 +1,173 @@
+import { DockLayout } from '@lumino/widgets';
+import { ApplicationShell, WidgetAreaResolver } from './shell/application-shell';
+import { SidePanel } from './shell/side-panel-handler';
+import { FrontendApplicationContribution } from './frontend-application-contribution';
+import { WidgetManager } from './widget-manager';
+import { ContributionProvider } from '../common/contribution-provider';
+import { Command, CommandContribution, CommandRegistry } from '../common/command';
+import { Emitter, Event } from '../common/event';
+import { ILogger } from '../common/logger';
+import { QuickInputService } from '../common/quick-pick-service';
+import { ContextKeyService } from './context-key-service';
+export declare const ACTIVE_PERSPECTIVE_CONTEXT_KEY = "activePerspectiveId";
+export interface PerspectiveChromeOptions {
+    /** Areas to collapse on first activation. User can re-expand freely. */
+    collapseAreas?: ('left' | 'right' | 'bottom')[];
+}
+export interface PerspectiveDescriptor {
+    id: string;
+    label: string;
+    /** Widget/view-container ID → target shell area */
+    viewPlacements: Map<string, ApplicationShell.Area>;
+    /** Chrome control options for this perspective */
+    chromeOptions?: PerspectiveChromeOptions;
+    /** Per-area primary view: the widget to activate last in each shell area, so it gets focus. */
+    primaryViews?: Partial<Record<ApplicationShell.Area, string>>;
+    /** Called when perspective is activated */
+    onActivate?(shell: ApplicationShell): void;
+    /** Called when switching away */
+    onDeactivate?(shell: ApplicationShell): void;
+}
+export declare const PerspectiveService: unique symbol;
+export interface PerspectiveService {
+    /** Event fired whenever the active perspective changes. The payload is the new perspective ID. */
+    readonly onDidChangePerspective: Event<string>;
+    /**
+     * Registers a new perspective descriptor.
+     * Contributions should call this from their `PerspectiveContribution.registerPerspectives` callback.
+     */
+    registerPerspective(descriptor: PerspectiveDescriptor): void;
+    /**
+     * Switches the workbench to the given perspective.
+     * Saves the current perspective's layout, then restores the target perspective's layout
+     * (or applies its `viewPlacements` on first activation). Concurrent calls are serialized.
+     */
+    switchPerspective(id: string): Promise<void>;
+    /** Returns the descriptor of the currently active perspective, or `undefined` if none. */
+    getActivePerspective(): PerspectiveDescriptor | undefined;
+    /** Returns the target shell area for a widget in the active perspective, or `undefined` if unmapped. */
+    getAreaForView(viewId: string): ApplicationShell.Area | undefined;
+    /** Returns all registered perspective descriptors. */
+    getRegisteredPerspectives(): PerspectiveDescriptor[];
+    /** Returns the ID of the currently active perspective. A convenient alternative to `getActivePerspective()?.id` that always returns a string. */
+    getActivePerspectiveId(): string;
+    /**
+     * Resets the active perspective to its programmatic state (viewPlacements from its descriptor),
+     * discarding the saved layout. Does not affect other perspectives.
+     */
+    resetCurrentPerspective(): Promise<void>;
+}
+export declare const PerspectiveServiceInternal: unique symbol;
+/**
+ * Internal plumbing API for layout persistence infrastructure.
+ * General consumers should use {@link PerspectiveService} instead.
+ */
+export interface PerspectiveServiceInternal {
+    /**
+     * Returns the ID of the currently active perspective.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` for layout persistence.
+     */
+    getActivePerspectiveId(): string;
+    /**
+     * Returns the IDs of all perspectives that have a saved (in-memory) layout snapshot.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` for layout persistence.
+     */
+    getSavedPerspectiveIds(): string[];
+    /**
+     * Returns the saved in-memory layout for a perspective, or `undefined` if none exists.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` for layout persistence.
+     */
+    getSavedLayout(perspectiveId: string): ApplicationShell.LayoutData | undefined;
+    /**
+     * Stores an in-memory layout snapshot for a perspective.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` for layout persistence.
+     */
+    setSavedLayout(perspectiveId: string, layout: ApplicationShell.LayoutData): void;
+    /**
+     * Sets the active perspective ID (without triggering a switch).
+     * Returns `true` if the ID corresponds to a registered perspective, `false` otherwise.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` during layout restore.
+     */
+    setActivePerspectiveId(id: string): boolean;
+    /**
+     * The ID of the built-in default perspective.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` for legacy migration.
+     */
+    readonly defaultPerspectiveId: string;
+    /**
+     * Clears all saved in-memory layout snapshots.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` during layout reset.
+     */
+    clearSavedLayouts(): void;
+    /**
+     * Called by `ShellLayoutRestorer` after restoring a persisted layout to apply chrome options
+     * (e.g., status bar visibility) for the given perspective.
+     * @internal Plumbing API, used by `ShellLayoutRestorer` after layout restore.
+     */
+    onLayoutRestored(activePerspectiveId: string): void;
+}
+export declare const PerspectiveContribution: unique symbol;
+export interface PerspectiveContribution {
+    registerPerspectives(service: PerspectiveService): void;
+}
+export declare class WidgetAreaResolverImpl implements WidgetAreaResolver {
+    protected activePlacementMap: Map<string, ApplicationShell.Area>;
+    setActivePlacementMap(map: Map<string, ApplicationShell.Area>): void;
+    resolveArea(widgetId: string, requestedArea: ApplicationShell.Area): ApplicationShell.Area | undefined;
+}
+export declare class PerspectiveServiceImpl implements FrontendApplicationContribution, CommandContribution, PerspectiveService, PerspectiveServiceInternal {
+    static readonly SWITCH_PERSPECTIVE_COMMAND: Command;
+    static readonly RESET_PERSPECTIVE_COMMAND: Command;
+    protected readonly shell: ApplicationShell;
+    protected readonly widgetManager: WidgetManager;
+    protected readonly contributions: ContributionProvider<PerspectiveContribution> | undefined;
+    protected readonly appContributions: ContributionProvider<FrontendApplicationContribution>;
+    protected readonly quickInputService: QuickInputService | undefined;
+    protected readonly logger: ILogger;
+    protected readonly widgetAreaResolver: WidgetAreaResolver;
+    protected readonly contextKeyService: ContextKeyService | undefined;
+    static readonly DEFAULT_PERSPECTIVE_ID = "default";
+    readonly defaultPerspectiveId = "default";
+    protected readonly perspectives: Map<string, PerspectiveDescriptor>;
+    protected activePerspectiveId: string | undefined;
+    protected readonly savedLayouts: Map<string, ApplicationShell.LayoutData>;
+    protected readonly onDidChangePerspectiveEmitter: Emitter<string>;
+    readonly onDidChangePerspective: Event<string>;
+    protected switchInProgress: Promise<void> | undefined;
+    onLayoutRestored(activePerspectiveId: string): void;
+    initialize(): void;
+    onStop(): void;
+    protected updateActivePerspectiveContextKey(id: string): void;
+    registerPerspective(descriptor: PerspectiveDescriptor): void;
+    switchPerspective(id: string): Promise<void>;
+    protected doSwitchPerspective(id: string): Promise<void>;
+    protected applyViewPlacements(descriptor: PerspectiveDescriptor): Promise<void>;
+    resetCurrentPerspective(): Promise<void>;
+    protected doResetCurrentPerspective(): Promise<void>;
+    protected resetDefaultPerspective(): Promise<void>;
+    /**
+     * Views may be shared between multiple perspective. If a view exists in two or more perspectives
+     * and is closed in one of them, the shared widget is disposed. When switching back to the other
+     * perspective, we need to restore this widget (i.e. reopen the view).
+     * @param layout
+     */
+    protected healLayoutData(layout: ApplicationShell.LayoutData): Promise<void>;
+    protected healSidePanelLayout(layout: SidePanel.LayoutData): Promise<void>;
+    protected healDockAreaConfig(config: DockLayout.ITabAreaConfig | DockLayout.ISplitAreaConfig): Promise<void>;
+    protected collectWidgetIds(layout: ApplicationShell.LayoutData): Set<string>;
+    protected collectSidePanelWidgetIds(layout: SidePanel.LayoutData, ids: Set<string>): void;
+    protected collectDockWidgetIds(config: DockLayout.ITabAreaConfig | DockLayout.ISplitAreaConfig, ids: Set<string>): void;
+    protected detachStrayWidgets(layoutWidgetIds: Set<string>): void;
+    getActivePerspective(): PerspectiveDescriptor | undefined;
+    getAreaForView(viewId: string): ApplicationShell.Area | undefined;
+    getRegisteredPerspectives(): PerspectiveDescriptor[];
+    getActivePerspectiveId(): string;
+    getSavedPerspectiveIds(): string[];
+    getSavedLayout(perspectiveId: string): ApplicationShell.LayoutData | undefined;
+    setSavedLayout(perspectiveId: string, layout: ApplicationShell.LayoutData): void;
+    setActivePerspectiveId(id: string): boolean;
+    clearSavedLayouts(): void;
+    registerCommands(commands: CommandRegistry): void;
+    protected showPerspectivePicker(): Promise<void>;
+}
+//# sourceMappingURL=perspective-service.d.ts.map

package/lib/browser/perspective-service.d.ts.map

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

package/lib/browser/perspective-service.js

@@ -0,0 +1,484 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// 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 PerspectiveServiceImpl_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerspectiveServiceImpl = exports.WidgetAreaResolverImpl = exports.PerspectiveContribution = exports.PerspectiveServiceInternal = exports.PerspectiveService = exports.ACTIVE_PERSPECTIVE_CONTEXT_KEY = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const application_shell_1 = require("./shell/application-shell");
+const frontend_application_contribution_1 = require("./frontend-application-contribution");
+const view_contribution_1 = require("./shell/view-contribution");
+const widget_manager_1 = require("./widget-manager");
+const contribution_provider_1 = require("../common/contribution-provider");
+const command_1 = require("../common/command");
+const event_1 = require("../common/event");
+const logger_1 = require("../common/logger");
+const quick_pick_service_1 = require("../common/quick-pick-service");
+const nls_1 = require("../common/nls");
+const common_commands_1 = require("./common-commands");
+const context_key_service_1 = require("./context-key-service");
+exports.ACTIVE_PERSPECTIVE_CONTEXT_KEY = 'activePerspectiveId';
+exports.PerspectiveService = Symbol('PerspectiveService');
+exports.PerspectiveServiceInternal = Symbol('PerspectiveServiceInternal');
+exports.PerspectiveContribution = Symbol('PerspectiveContribution');
+let WidgetAreaResolverImpl = class WidgetAreaResolverImpl {
+    constructor() {
+        this.activePlacementMap = new Map();
+    }
+    setActivePlacementMap(map) {
+        this.activePlacementMap = map;
+    }
+    resolveArea(widgetId, requestedArea) {
+        return this.activePlacementMap.get(widgetId);
+    }
+};
+exports.WidgetAreaResolverImpl = WidgetAreaResolverImpl;
+exports.WidgetAreaResolverImpl = WidgetAreaResolverImpl = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], WidgetAreaResolverImpl);
+let PerspectiveServiceImpl = class PerspectiveServiceImpl {
+    constructor() {
+        this.defaultPerspectiveId = PerspectiveServiceImpl_1.DEFAULT_PERSPECTIVE_ID;
+        this.perspectives = new Map();
+        this.savedLayouts = new Map();
+        this.onDidChangePerspectiveEmitter = new event_1.Emitter();
+        this.onDidChangePerspective = this.onDidChangePerspectiveEmitter.event;
+    }
+    static { PerspectiveServiceImpl_1 = this; }
+    static { this.SWITCH_PERSPECTIVE_COMMAND = command_1.Command.toLocalizedCommand({
+        id: 'perspective.switch',
+        category: common_commands_1.CommonCommands.VIEW_CATEGORY,
+        label: 'Switch Perspective (Experimental)'
+    }, 'theia/core/perspective/switchPerspective', common_commands_1.CommonCommands.VIEW_CATEGORY_KEY); }
+    static { this.RESET_PERSPECTIVE_COMMAND = command_1.Command.toLocalizedCommand({
+        id: 'perspective.reset',
+        category: common_commands_1.CommonCommands.VIEW_CATEGORY,
+        label: 'Reset Perspective (Experimental)'
+    }, 'theia/core/perspective/resetPerspective', common_commands_1.CommonCommands.VIEW_CATEGORY_KEY); }
+    static { this.DEFAULT_PERSPECTIVE_ID = 'default'; }
+    onLayoutRestored(activePerspectiveId) {
+        this.updateActivePerspectiveContextKey(activePerspectiveId);
+    }
+    initialize() {
+        this.registerPerspective({
+            id: PerspectiveServiceImpl_1.DEFAULT_PERSPECTIVE_ID,
+            label: nls_1.nls.localizeByDefault('Default'),
+            viewPlacements: new Map()
+        });
+        this.activePerspectiveId = PerspectiveServiceImpl_1.DEFAULT_PERSPECTIVE_ID;
+        this.updateActivePerspectiveContextKey(PerspectiveServiceImpl_1.DEFAULT_PERSPECTIVE_ID);
+        if (this.contributions) {
+            for (const contribution of this.contributions.getContributions()) {
+                contribution.registerPerspectives(this);
+            }
+        }
+    }
+    onStop() {
+        this.onDidChangePerspectiveEmitter.dispose();
+    }
+    updateActivePerspectiveContextKey(id) {
+        this.contextKeyService?.createKey(exports.ACTIVE_PERSPECTIVE_CONTEXT_KEY, id).set(id);
+    }
+    registerPerspective(descriptor) {
+        this.perspectives.set(descriptor.id, descriptor);
+    }
+    async switchPerspective(id) {
+        const pending = (this.switchInProgress ?? Promise.resolve())
+            .catch(() => { })
+            .then(() => this.doSwitchPerspective(id));
+        this.switchInProgress = pending;
+        try {
+            await pending;
+        }
+        finally {
+            if (this.switchInProgress === pending) {
+                this.switchInProgress = undefined;
+            }
+        }
+    }
+    async doSwitchPerspective(id) {
+        if (id === this.activePerspectiveId) {
+            return;
+        }
+        const descriptor = this.perspectives.get(id);
+        if (!descriptor) {
+            return;
+        }
+        const oldPerspective = this.getActivePerspective();
+        if (oldPerspective?.onDeactivate) {
+            oldPerspective.onDeactivate(this.shell);
+        }
+        if (this.activePerspectiveId) {
+            this.savedLayouts.set(this.activePerspectiveId, this.shell.getLayoutData());
+        }
+        this.activePerspectiveId = id;
+        this.widgetAreaResolver.setActivePlacementMap(descriptor.viewPlacements);
+        try {
+            const savedLayout = this.savedLayouts.get(id);
+            if (savedLayout) {
+                const layoutWidgetIds = this.collectWidgetIds(savedLayout);
+                await this.healLayoutData(savedLayout);
+                await this.shell.setLayoutData(savedLayout);
+                this.detachStrayWidgets(layoutWidgetIds);
+            }
+            else {
+                await this.applyViewPlacements(descriptor);
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to apply layout for perspective', error);
+        }
+        if (descriptor.onActivate) {
+            descriptor.onActivate(this.shell);
+        }
+        this.updateActivePerspectiveContextKey(id);
+        this.onDidChangePerspectiveEmitter.fire(id);
+    }
+    async applyViewPlacements(descriptor) {
+        for (const [viewId, area] of descriptor.viewPlacements) {
+            try {
+                const widget = await this.widgetManager.getOrCreateWidget(viewId);
+                const currentTabBar = this.shell.getTabBarFor(widget);
+                if (currentTabBar) {
+                    const currentArea = this.shell.getAreaFor(widget);
+                    if (currentArea === area) {
+                        continue;
+                    }
+                }
+                await this.shell.addWidget(widget, { area });
+            }
+            catch (error) {
+                this.logger.warn('Failed to create or place widget for perspective', error);
+            }
+        }
+        for (const [viewId] of descriptor.viewPlacements) {
+            try {
+                await this.shell.activateWidget(viewId);
+            }
+            catch (error) {
+                this.logger.warn('Failed to activate widget for perspective', error);
+            }
+        }
+        if (descriptor.primaryViews) {
+            for (const viewId of Object.values(descriptor.primaryViews)) {
+                if (viewId) {
+                    try {
+                        await this.shell.activateWidget(viewId);
+                    }
+                    catch (error) {
+                        this.logger.warn('Failed to activate primary view for perspective', error);
+                    }
+                }
+            }
+        }
+        if (descriptor.chromeOptions?.collapseAreas) {
+            for (const area of descriptor.chromeOptions.collapseAreas) {
+                await this.shell.collapsePanel(area);
+            }
+        }
+    }
+    async resetCurrentPerspective() {
+        const pending = (this.switchInProgress ?? Promise.resolve())
+            .catch(() => { })
+            .then(() => this.doResetCurrentPerspective());
+        this.switchInProgress = pending;
+        try {
+            await pending;
+        }
+        finally {
+            if (this.switchInProgress === pending) {
+                this.switchInProgress = undefined;
+            }
+        }
+    }
+    async doResetCurrentPerspective() {
+        const descriptor = this.getActivePerspective();
+        if (!descriptor) {
+            return;
+        }
+        this.savedLayouts.delete(descriptor.id);
+        try {
+            if (descriptor.id === PerspectiveServiceImpl_1.DEFAULT_PERSPECTIVE_ID) {
+                await this.resetDefaultPerspective();
+            }
+            else {
+                await this.applyViewPlacements(descriptor);
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to apply layout for perspective', error);
+        }
+        if (descriptor.onActivate) {
+            descriptor.onActivate(this.shell);
+        }
+        this.onDidChangePerspectiveEmitter.fire(descriptor.id);
+    }
+    async resetDefaultPerspective() {
+        // Phase 1: Relocate open views to their default areas
+        for (const contribution of this.appContributions.getContributions()) {
+            if (contribution instanceof view_contribution_1.AbstractViewContribution) {
+                const widgetId = contribution.effectiveWidgetId;
+                const targetArea = contribution.defaultViewOptions?.area;
+                if (!widgetId || !targetArea) {
+                    continue;
+                }
+                const widget = this.widgetManager.tryGetWidget(widgetId);
+                if (widget && !widget.isDisposed && widget.isAttached) {
+                    const currentArea = this.shell.getAreaFor(widget);
+                    if (currentArea && currentArea !== targetArea) {
+                        try {
+                            await this.shell.addWidget(widget, { area: targetArea });
+                        }
+                        catch (error) {
+                            this.logger.warn('Failed to relocate widget during default perspective reset', widgetId, error);
+                        }
+                    }
+                }
+            }
+        }
+        // Phase 2: Re-open closed views via openView({ activate: false }).
+        // Non-view contributions (e.g., Terminal) are skipped to avoid side effects
+        // like creating new terminal instances.
+        for (const contribution of this.appContributions.getContributions()) {
+            if (contribution instanceof view_contribution_1.AbstractViewContribution) {
+                try {
+                    await contribution.openView({ activate: false });
+                }
+                catch (error) {
+                    this.logger.warn('Failed to open view during default perspective reset', error);
+                }
+            }
+        }
+    }
+    /**
+     * Views may be shared between multiple perspective. If a view exists in two or more perspectives
+     * and is closed in one of them, the shared widget is disposed. When switching back to the other
+     * perspective, we need to restore this widget (i.e. reopen the view).
+     * @param layout
+     */
+    async healLayoutData(layout) {
+        if (layout.leftPanel) {
+            await this.healSidePanelLayout(layout.leftPanel);
+        }
+        if (layout.rightPanel) {
+            await this.healSidePanelLayout(layout.rightPanel);
+        }
+        if (layout.mainPanel?.main) {
+            await this.healDockAreaConfig(layout.mainPanel.main);
+        }
+        if (layout.bottomPanel?.config?.main) {
+            await this.healDockAreaConfig(layout.bottomPanel.config.main);
+        }
+    }
+    async healSidePanelLayout(layout) {
+        if (!layout.items) {
+            return;
+        }
+        for (const item of layout.items) {
+            if (item.widget?.isDisposed) {
+                try {
+                    item.widget = await this.widgetManager.getOrCreateWidget(item.widget.id);
+                }
+                catch (error) {
+                    this.logger.warn('Failed to recreate disposed widget for perspective layout', item.widget.id, error);
+                    item.widget = undefined;
+                }
+            }
+        }
+    }
+    async healDockAreaConfig(config) {
+        if (config.type === 'tab-area') {
+            for (let i = 0; i < config.widgets.length; i++) {
+                const widget = config.widgets[i];
+                if (widget.isDisposed) {
+                    try {
+                        config.widgets[i] = await this.widgetManager.getOrCreateWidget(widget.id);
+                    }
+                    catch (error) {
+                        this.logger.warn('Failed to recreate disposed widget for perspective layout', widget.id, error);
+                        config.widgets.splice(i, 1);
+                        i--;
+                    }
+                }
+            }
+        }
+        else if (config.type === 'split-area') {
+            for (const child of config.children) {
+                await this.healDockAreaConfig(child);
+            }
+        }
+    }
+    collectWidgetIds(layout) {
+        const ids = new Set();
+        if (layout.leftPanel) {
+            this.collectSidePanelWidgetIds(layout.leftPanel, ids);
+        }
+        if (layout.rightPanel) {
+            this.collectSidePanelWidgetIds(layout.rightPanel, ids);
+        }
+        if (layout.mainPanel?.main) {
+            this.collectDockWidgetIds(layout.mainPanel.main, ids);
+        }
+        if (layout.bottomPanel?.config?.main) {
+            this.collectDockWidgetIds(layout.bottomPanel.config.main, ids);
+        }
+        return ids;
+    }
+    collectSidePanelWidgetIds(layout, ids) {
+        if (layout.items) {
+            for (const item of layout.items) {
+                if (item.widget) {
+                    ids.add(item.widget.id);
+                }
+            }
+        }
+    }
+    collectDockWidgetIds(config, ids) {
+        if (config.type === 'tab-area') {
+            for (const widget of config.widgets) {
+                if (widget) {
+                    ids.add(widget.id);
+                }
+            }
+        }
+        else if (config.type === 'split-area') {
+            for (const child of config.children) {
+                this.collectDockWidgetIds(child, ids);
+            }
+        }
+    }
+    detachStrayWidgets(layoutWidgetIds) {
+        const sidePanelAreas = ['left', 'right'];
+        for (const area of sidePanelAreas) {
+            for (const widget of this.shell.getWidgets(area)) {
+                if (!layoutWidgetIds.has(widget.id)) {
+                    // Detach via parent = null rather than widget.close() to avoid
+                    // disposing the widget — it may be needed by another perspective.
+                    // eslint-disable-next-line no-null/no-null
+                    widget.parent = null;
+                }
+            }
+        }
+    }
+    getActivePerspective() {
+        if (this.activePerspectiveId) {
+            return this.perspectives.get(this.activePerspectiveId);
+        }
+        return undefined;
+    }
+    getAreaForView(viewId) {
+        const active = this.getActivePerspective();
+        if (active) {
+            return active.viewPlacements.get(viewId);
+        }
+        return undefined;
+    }
+    getRegisteredPerspectives() {
+        return Array.from(this.perspectives.values());
+    }
+    getActivePerspectiveId() {
+        return this.activePerspectiveId ?? PerspectiveServiceImpl_1.DEFAULT_PERSPECTIVE_ID;
+    }
+    getSavedPerspectiveIds() {
+        return Array.from(this.savedLayouts.keys());
+    }
+    getSavedLayout(perspectiveId) {
+        return this.savedLayouts.get(perspectiveId);
+    }
+    setSavedLayout(perspectiveId, layout) {
+        this.savedLayouts.set(perspectiveId, layout);
+    }
+    setActivePerspectiveId(id) {
+        if (this.perspectives.has(id)) {
+            this.activePerspectiveId = id;
+            return true;
+        }
+        return false;
+    }
+    clearSavedLayouts() {
+        this.savedLayouts.clear();
+    }
+    registerCommands(commands) {
+        commands.registerCommand(PerspectiveServiceImpl_1.SWITCH_PERSPECTIVE_COMMAND, {
+            execute: () => this.showPerspectivePicker(),
+            isVisible: () => this.perspectives.size > 1
+        });
+        commands.registerCommand(PerspectiveServiceImpl_1.RESET_PERSPECTIVE_COMMAND, {
+            execute: () => this.resetCurrentPerspective(),
+            isEnabled: () => this.activePerspectiveId !== undefined
+        });
+    }
+    async showPerspectivePicker() {
+        if (!this.quickInputService) {
+            return;
+        }
+        const items = this.getRegisteredPerspectives().map(p => ({
+            label: p.label,
+            id: p.id,
+            description: this.activePerspectiveId === p.id ? nls_1.nls.localizeByDefault('Active') : undefined
+        }));
+        const selected = await this.quickInputService.showQuickPick(items, {
+            placeholder: nls_1.nls.localize('theia/core/perspective/selectPerspective', 'Select a perspective')
+        });
+        if (selected?.id) {
+            await this.switchPerspective(selected.id);
+        }
+    }
+};
+exports.PerspectiveServiceImpl = PerspectiveServiceImpl;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(application_shell_1.ApplicationShell),
+    tslib_1.__metadata("design:type", application_shell_1.ApplicationShell)
+], PerspectiveServiceImpl.prototype, "shell", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(widget_manager_1.WidgetManager),
+    tslib_1.__metadata("design:type", widget_manager_1.WidgetManager)
+], PerspectiveServiceImpl.prototype, "widgetManager", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(contribution_provider_1.ContributionProvider),
+    (0, inversify_1.named)(exports.PerspectiveContribution),
+    (0, inversify_1.optional)(),
+    tslib_1.__metadata("design:type", Object)
+], PerspectiveServiceImpl.prototype, "contributions", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(contribution_provider_1.ContributionProvider),
+    (0, inversify_1.named)(frontend_application_contribution_1.FrontendApplicationContribution),
+    tslib_1.__metadata("design:type", Object)
+], PerspectiveServiceImpl.prototype, "appContributions", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(quick_pick_service_1.QuickInputService),
+    (0, inversify_1.optional)(),
+    tslib_1.__metadata("design:type", Object)
+], PerspectiveServiceImpl.prototype, "quickInputService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(logger_1.ILogger),
+    (0, inversify_1.named)('core:PerspectiveService'),
+    tslib_1.__metadata("design:type", Object)
+], PerspectiveServiceImpl.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(application_shell_1.WidgetAreaResolver),
+    tslib_1.__metadata("design:type", Object)
+], PerspectiveServiceImpl.prototype, "widgetAreaResolver", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(context_key_service_1.ContextKeyService),
+    (0, inversify_1.optional)(),
+    tslib_1.__metadata("design:type", Object)
+], PerspectiveServiceImpl.prototype, "contextKeyService", void 0);
+exports.PerspectiveServiceImpl = PerspectiveServiceImpl = PerspectiveServiceImpl_1 = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], PerspectiveServiceImpl);
+//# sourceMappingURL=perspective-service.js.map