@scion/workbench 17.0.0-beta.9 → 18.0.0-beta.10

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

@@ -1,20 +1,17 @@
-import { EnvironmentInjector } from '@angular/core';
-import { WorkbenchLayoutFn, WorkbenchPerspectiveDefinition, WorkbenchPerspectives } from './workbench-perspective.model';
+import { ɵWorkbenchPerspective } from './ɵworkbench-perspective.model';
+import { WorkbenchPerspectiveDefinition } from './workbench-perspective.model';
 import { WorkbenchInitializer } from '../startup/workbench-initializer';
-import { Logger } from '../logging/logger';
-import { WorkbenchStartup } from '../startup/workbench-launcher.service';
-import { WorkbenchPerspectiveRegistry } from './workbench-perspective.registry';
-import { WorkbenchPerspectiveStorageService } from './workbench-perspective-storage.service';
 import * as i0 from "@angular/core";
 /**
  * Enables registration and activation of perspectives.
  */
 export declare class WorkbenchPerspectiveService implements WorkbenchInitializer {
-    private _layoutConfig;
-    private _perspectiveRegistry;
-    private _environmentInjector;
-    private _workbenchPerspectiveStorageService;
-    constructor(_layoutConfig: WorkbenchLayoutFn | WorkbenchPerspectives, _perspectiveRegistry: WorkbenchPerspectiveRegistry, _environmentInjector: EnvironmentInjector, _workbenchPerspectiveStorageService: WorkbenchPerspectiveStorageService, workbenchStartup: WorkbenchStartup, logger: Logger);
+    private readonly _workbenchConfig;
+    private readonly _perspectiveRegistry;
+    private readonly _environmentInjector;
+    private readonly _applicationInitStatus;
+    private readonly _workbenchPerspectiveStorageService;
+    readonly activePerspective: import("@angular/core").Signal<ɵWorkbenchPerspective | undefined>;
     init(): Promise<void>;
     /**
      * Registers perspectives configured in {@link WorkbenchConfig}.
@@ -29,6 +26,7 @@ export declare class WorkbenchPerspectiveService implements WorkbenchInitializer
      * Registers the given perspective to arrange views around the main area.
      */
     registerPerspective(definition: WorkbenchPerspectiveDefinition): Promise<void>;
+    private createPerspective;
     /**
      * Switches to the specified perspective. The main area will not change, if any.
      *
@@ -45,13 +43,17 @@ export declare class WorkbenchPerspectiveService implements WorkbenchInitializer
      */
     resetPerspective(): Promise<void>;
     /**
-     * Activates the initial perspective, if any.
+     * Activates the initial perspective.
      */
     private activateInitialPerspective;
     /**
-     * Returns the currently active perspective, or `null` if there is no current perspective.
+     * Determines which perspective to activate, with the following precedence:
+     *
+     * 1. Perspective defined as window name.
+     * 2. Perspective defined in storage.
+     * 3. Perspective configured in the workbench config.
      */
-    private get activePerspective();
+    private determineInitialPerspective;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchPerspectiveService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchPerspectiveService>;
 }

package/lib/perspective/workench-perspective-serializer.service.d.ts

@@ -19,7 +19,7 @@ export declare class WorkbenchPerspectiveSerializer {
 /**
  * Represents the current version of the workbench perspective layout.
  *
- * Increment this version and write a migrator when introducting a breaking change.
+ * Increment this version and write a migrator when introducing a breaking change.
  *
  * @see WorkbenchMigrator
  */

package/lib/perspective//311/265workbench-perspective.model.d.ts

@@ -1,27 +1,25 @@
+import { InjectionToken, Injector, Signal } from '@angular/core';
 import { WorkbenchPerspective, WorkbenchPerspectiveDefinition } from './workbench-perspective.model';
-import { Observable } from 'rxjs';
 /**
  * @inheritDoc
  */
 export declare class ɵWorkbenchPerspective implements WorkbenchPerspective {
-    private _workbenchLayoutFactory;
-    private _workbenchGridMerger;
-    private _workbenchPerspectiveStorageService;
-    private _workbenchLayoutService;
-    private _workbenchRouter;
-    private _environmentInjector;
-    private _initialLayoutFn;
-    private _activePerspectiveId$;
-    private _perspectiveViewConflictResolver;
-    private _destroyRef;
-    private _initialPerspectiveLayout;
-    private _perspectiveLayout;
-    id: string;
-    transient: boolean;
-    data: {
+    private readonly _perspectiveEnvironmentInjector;
+    private readonly _workbenchLayoutFactory;
+    private readonly _workbenchGridMerger;
+    private readonly _workbenchPerspectiveStorageService;
+    private readonly _workbenchLayoutService;
+    private readonly _workbenchRouter;
+    private readonly _initialLayoutFn;
+    private readonly _perspectiveViewConflictResolver;
+    readonly id: string;
+    readonly transient: boolean;
+    readonly data: {
         [key: string]: any;
     };
-    active$: Observable<boolean>;
+    readonly active: Signal<boolean>;
+    private _initialPerspectiveLayout;
+    private _perspectiveLayout;
     constructor(definition: WorkbenchPerspectiveDefinition);
     /**
      * Activates this perspective.
@@ -32,22 +30,29 @@ export declare class ɵWorkbenchPerspective implements WorkbenchPerspective {
      */
     reset(): Promise<void>;
     /**
-     * Creates layout with the workbench grid of this perspective and the main area of the current layout.
+     * Reference to the handle's injector. The injector will be destroyed when unregistering the perspective.
+     */
+    get injector(): Injector;
+    /**
+     * Creates the perspective layout using the main area of the current layout.
      *
      * When switching perspective, id clashes between the views contained in the perspective and the
      * views contained in the main area are possible. The activation detects and resolves conflicts,
      * changing the layout of this perspective if necessary.
      */
     private createLayoutForActivation;
-    get active(): boolean;
     /**
      * Creates the initial layout of this perspective as defined in the perspective definition.
      */
     private createInitialPerspectiveLayout;
     /**
-     * Subscribes to workbench layout changes, invoking the given callback on layout change, but only if this perspective is active.
+     * Activates the first view of each part if not specified.
+     */
+    private ensureActiveView;
+    /**
+     * Sets up automatic persistence of the perspective layout on every layout change.
      */
-    private onPerspectiveLayoutChange;
+    private installLayoutPersister;
     /**
      * Loads the layout of this perspective from storage, applying necessary migrations if the layout is outdated.
      * Returns `null` if not stored or could not be deserialized.
@@ -61,3 +66,7 @@ export declare class ɵWorkbenchPerspective implements WorkbenchPerspective {
     private storePerspectiveLayout;
     destroy(): void;
 }
+/**
+ * Provides the currently active perspective in the workbench.
+ */
+export declare const ACTIVE_PERSPECTIVE: InjectionToken<Signal<ɵWorkbenchPerspective | undefined>>;

package/lib/popup/popup.config.d.ts

@@ -111,14 +111,13 @@ export declare abstract class PopupConfig {
  */
 export interface CloseStrategy {
     /**
-     * If `true`, which is by default, will close the popup on focus loss.
-     * No return value will be passed to the popup opener.
+     * Controls if to close the popup on focus loss, returning the result set via {@link Popup#setResult} to the popup opener.
+     * Defaults to `true`.
      */
     onFocusLost?: boolean;
     /**
-     * If `true`, which is by default, will close the popup when the user
-     * hits the escape key. No return value will be passed to the popup
-     * opener.
+     * Controls if to close the popup when pressing escape. Defaults to `true`.
+     * No return value will be passed to the popup opener.
      */
     onEscape?: boolean;
 }
@@ -155,7 +154,7 @@ export interface PopupSize {
  * Represents a handle that a popup component can inject to interact with the popup, for example,
  * to read input data or the configured size, or to close the popup.
  */
-export declare abstract class Popup<T = any> {
+export declare abstract class Popup<T = unknown, R = unknown> {
     /**
      * Input data as passed by the popup opener when opened the popup, or `undefined` if not passed.
      */
@@ -166,6 +165,8 @@ export declare abstract class Popup<T = any> {
     abstract readonly size: PopupSize | undefined;
     /**
      * Provides information about the context in which this popup was opened.
+     *
+     * @deprecated since version 18.0.0-beta.4; Inject {@link WorkbenchView} instead.
      */
     abstract readonly referrer: PopupReferrer;
     /**
@@ -173,13 +174,13 @@ export declare abstract class Popup<T = any> {
      */
     abstract readonly cssClasses: string[];
     /**
-     * Closes the popup. Optionally, pass a result to the popup opener.
+     * Sets a result that will be passed to the popup opener when the popup is closed on focus loss {@link CloseStrategy#onFocusLost}.
      */
-    abstract close<R = any>(result?: R | undefined): void;
+    abstract setResult(result?: R): void;
     /**
-     * Closes the popup returning the given error to the popup opener.
+     * Closes the popup. Optionally, pass a result or an error to the popup opener.
      */
-    abstract closeWithError(error: Error | string): void;
+    abstract close(result?: R | Error): void;
 }
 /**
  * Information about the context in which a popup was opened.

package/lib/popup/popup.service.d.ts

@@ -1,9 +1,4 @@
-import { Injector, NgZone } from '@angular/core';
-import { Overlay } from '@angular/cdk/overlay';
 import { PopupConfig } from './popup.config';
-import { FocusMonitor } from '@angular/cdk/a11y';
-import { WorkbenchViewRegistry } from '../view/workbench-view.registry';
-import { ɵWorkbenchView } from '../view/ɵworkbench-view.model';
 import * as i0 from "@angular/core";
 /**
  * Allows displaying a component in a workbench popup.
@@ -14,14 +9,13 @@ import * as i0 from "@angular/core";
  * Unlike views, popups are not part of the persistent Workbench navigation, meaning that popups do not survive a page reload.
  */
 export declare class PopupService {
-    private _injector;
-    private _overlay;
-    private _focusManager;
-    private _viewRegistry;
-    private _zone;
-    private _document;
-    private _view?;
-    constructor(_injector: Injector, _overlay: Overlay, _focusManager: FocusMonitor, _viewRegistry: WorkbenchViewRegistry, _zone: NgZone, _document: Document, _view?: ɵWorkbenchView | undefined);
+    private readonly _environmentInjector;
+    private readonly _overlay;
+    private readonly _focusManager;
+    private readonly _viewRegistry;
+    private readonly _zone;
+    private readonly _document;
+    private readonly _view;
     /**
      * Displays the specified component in a popup.
      *
@@ -47,8 +41,11 @@ export declare class PopupService {
      *          - resolves to the result if closed with a result
      *          - resolves to `undefined` if closed without a result
      */
-    open<R>(config: PopupConfig): Promise<R>;
-    private setPopupAlignCssClass;
+    open<R>(config: PopupConfig): Promise<R | undefined>;
+    /**
+     * Creates the popup handle.
+     */
+    private createPopup;
     /**
      * Closes the popup depending on the configured popup closing strategy.
      */
@@ -59,23 +56,13 @@ export declare class PopupService {
      */
     private hidePopupOnViewDetach;
     /**
-     * Observes the position of the popup anchor.
-     *
-     * The Observable emits the anchor's initial position, and each time when its position changes.
+     * Creates a signal that tracks the position of the popup anchor.
      */
-    private observePopupOrigin$;
-    /**
-     * Observes the bounds of the viewport (view or page) in which the popup has been opened.
-     */
-    private viewportBounds$;
+    private trackPopupOrigin;
     /**
      * Resolves the contextual view to which the popup is bound.
      */
     private resolveContextualView;
-    /**
-     * Maps the passed popup origin, which is relative to the given viewport, to a page coordinate.
-     */
-    private mapPopupOriginToPageCoordinate;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PopupService, [null, null, null, null, null, null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PopupService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PopupService>;
 }

package/lib/portal/wb-component-portal.d.ts

@@ -1,6 +1,5 @@
 import { ComponentType } from '@angular/cdk/portal';
-import { ComponentRef, Injector, Provider, ViewContainerRef } from '@angular/core';
-import { Observable } from 'rxjs';
+import { ComponentRef, Injector, Provider, Signal, ViewContainerRef } from '@angular/core';
 /**
  * Like the Angular CDK 'ComponentPortal' but does not destroy the component on detach.
  *
@@ -17,7 +16,7 @@ export declare class WbComponentPortal<T = any> {
     private _viewContainerRef;
     private _componentRef;
     private _logger;
-    private _attached$;
+    private _attached;
     constructor(_componentType: ComponentType<T>, _options?: PortalOptions | undefined);
     /**
      * Constructs the portal's component using given injection context.
@@ -43,11 +42,10 @@ export declare class WbComponentPortal<T = any> {
      */
     detach(): void;
     get isConstructed(): boolean;
-    private get isAttached();
     isAttachedTo(viewContainerRef: ViewContainerRef): boolean;
     get isDestroyed(): boolean;
     get componentRef(): ComponentRef<T>;
-    get attached$(): Observable<boolean>;
+    get attached(): Signal<boolean>;
     private onDestroy;
     /**
      * Destroys the component instance and all the data structures associated with it.
@@ -63,3 +61,21 @@ export interface PortalOptions {
      */
     providers?: Provider[];
 }
+/**
+ * Lifecycle hook for component rendered by {@link WbComponentPortal} when attaching to the DOM.
+ */
+export interface OnAttach {
+    /**
+     * Method invoked after attached this component to the DOM.
+     */
+    onAttach(): void;
+}
+/**
+ * Lifecycle hook for component rendered by {@link WbComponentPortal} when detaching from the DOM.
+ */
+export interface OnDetach {
+    /**
+     * Method invoked before detaching this component from the DOM.
+     */
+    onDetach(): void;
+}

package/lib/public_api.d.ts

@@ -3,7 +3,7 @@ export { WorkbenchModule, WorkbenchModuleConfig } from './workbench.module';
 export { provideWorkbench } from './workbench.provider';
 export { WorkbenchService } from './workbench.service';
 export { WORKBENCH_ID } from './workbench-id';
-export { WorkbenchPartAction, WorkbenchTheme, CanMatchPartFn, WorkbenchMenuItem, WorkbenchMenuItemFactoryFn, CanClose } from './workbench.model';
+export { WorkbenchPartAction, WorkbenchTheme, CanMatchPartFn, WorkbenchMenuItem, WorkbenchMenuItemFactoryFn, CanClose, CanCloseFn, CanCloseRef } from './workbench.model';
 export { WorkbenchComponent } from './workbench.component';
 export { VIEW_TAB_RENDERING_CONTEXT, ViewTabRenderingContext } from './workbench.constants';
 export * from './layout/public_api';

package/lib/registry/workbench-object-registry.d.ts

@@ -1,4 +1,3 @@
-import { Observable } from 'rxjs';
 /**
  * Provides a registry for workbench model objects.
  */
@@ -7,18 +6,23 @@ export declare class WorkbenchObjectRegistry<KEY, T> {
     private readonly _objectsById;
     private readonly _keyFn;
     private readonly _nullObjectErrorFn;
-    private readonly _change$;
-    readonly objects$: Observable<readonly T[]>;
+    private readonly _onUnregister;
+    readonly objects: import("@angular/core").Signal<T[]>;
     /**
      * Creates an instance of the registry.
      *
+     * This registry must be constructed within an injection context. Destroying the injection context will also destroy the registry,
+     * invoking the specified `onUnregister` function for each object in the registry.
+     *
      * @param config - Controls the creation of the registry.
      * @param config.keyFn - Function to extract the key of an object.
      * @param config.nullObjectErrorFn - Function to provide an error when looking up an object not contained in the registry.
+     * @param config.onUnregister - Function invoked when an object is unregistered.
      */
     constructor(config: {
         keyFn: (object: T) => KEY;
-        nullObjectErrorFn: (key: KEY) => Error;
+        nullObjectErrorFn?: (key: KEY) => Error;
+        onUnregister?: (object: T) => void;
     });
     /**
      * Registers given object, replacing any previously registered object with the same key.
@@ -40,9 +44,9 @@ export declare class WorkbenchObjectRegistry<KEY, T> {
      */
     has(key: KEY): boolean;
     /**
-     * Readonly reference to registered objects.
+     * Indicates whether this registry is empty.
      */
-    get objects(): readonly T[];
+    isEmpty(): boolean;
     /**
      * Clears this registry.
      */

package/lib/routing/public_api.d.ts

@@ -1,5 +1,5 @@
 export { WorkbenchRouter } from './workbench-router.service';
 export { WorkbenchRouterLinkDirective } from './workbench-router-link.directive';
-export { WorkbenchAuxiliaryRoutesRegistrator } from './workbench-auxiliary-routes-registrator.service';
 export { WorkbenchRouteData } from './workbench-route-data';
-export { Commands, ViewState, WorkbenchNavigationExtras, NavigateFn } from './routing.model';
+export { Commands, NavigationData, NavigationState, WorkbenchNavigationExtras, NavigateFn } from './routing.model';
+export { canMatchWorkbenchView, canMatchWorkbenchPerspective } from './workbench-route-guards';

package/lib/routing/routing.model.d.ts

@@ -43,14 +43,20 @@ export interface WorkbenchNavigationExtras extends NavigationExtras {
      */
     position?: number | 'start' | 'end' | 'before-active-view' | 'after-active-view';
     /**
-     * Associates arbitrary state with a view navigation.
+     * Associates data with a view navigation.
      *
-     * Navigational state is stored in the browser's session history, supporting back/forward navigation, but is lost on page reload.
-     * Therefore, a view must be able to restore its state without relying on navigational state.
+     * Unlike matrix parameters, navigation data is stored in the layout and not added to the path, allowing data to be passed to empty path navigations.
      *
-     * Navigational state can be read from {@link WorkbenchView.state} or the browser's session history via `history.state`.
+     * Data must be JSON serializable. Data can be read from {@link WorkbenchView.navigationData}.
      */
-    state?: ViewState;
+    data?: NavigationData;
+    /**
+     * Passes state to a view navigation.
+     *
+     * State is not persistent, unlike {@link data}, it is only added to the browser's session history to support back/forward browser navigation.
+     * State can be read from {@link WorkbenchView.navigationState} or from the browser's session history via `history.state`.
+     */
+    state?: NavigationState;
     /**
      * Closes views that match the specified path and navigation hint. Matrix parameters do not affect view resolution.
      * The path supports the asterisk wildcard segment (`*`) to match views with any value in a segment.
@@ -84,20 +90,26 @@ export type ViewOutlets = {
     [viewId: ViewId]: UrlSegment[];
 };
 /**
- * Navigational view states associated with a workbench navigation.
+ * States associated with view navigations.
  */
-export type ViewStates = {
-    [viewId: ViewId]: ViewState;
+export type NavigationStates = {
+    [viewId: ViewId]: NavigationState;
 };
 /**
- * State associated with a view navigation.
+ * State passed to a view navigation.
  *
- * Navigational state is stored in the browser's session history, supporting back/forward navigation, but is lost on page reload.
- * Therefore, a view must be able to restore its state without relying on navigational state.
+ * State is not persistent, unlike {@link data}, it is only added to the browser's session history to support back/forward browser navigation.
+ * State can be read from {@link WorkbenchView.navigationState} or from the browser's session history via `history.state`.
+ */
+export type NavigationState = {
+    [key: string]: unknown;
+};
+/**
+ * Data associated with a view navigation.
  *
- * Navigational state can be read from {@link WorkbenchView.state} or the browser's session history via `history.state`.
+ * Data can be read from {@link WorkbenchView.navigationData}. Data must be JSON serializable.
  */
-export type ViewState = {
+export type NavigationData = {
     [key: string]: unknown;
 };
 /**

package/lib/routing/{router.util.d.ts → routing.util.d.ts}

@@ -1,10 +1,11 @@
 import { ActivatedRoute, ActivatedRouteSnapshot, OutletContext, UrlSegment, UrlTree } from '@angular/router';
 import { Commands } from '../routing/routing.model';
 import { ViewId } from '../view/workbench-view.model';
+import { Observable } from 'rxjs';
 /**
  * Provides utility functions for router operations.
  */
-export declare const RouterUtils: {
+export declare const Routing: {
     /**
      * Converts given URL segments into an array of commands that can be passed to the Angular router for navigation.
      */
@@ -39,6 +40,10 @@ export declare const RouterUtils: {
      * Looks for requested data on given route, or its parent route(s) if not found.
      */
     readonly lookupRouteData: <T>(activatedRoute: ActivatedRouteSnapshot, dataKey: string) => T | undefined;
+    /**
+     * Tests if the given outlet matches the format of the view outlet.
+     */
+    readonly isViewOutlet: (outlet: string | undefined | null) => outlet is `view.${number}`;
     /**
      * Tests if the given outlet matches the format of a popup outlet.
      */
@@ -61,4 +66,26 @@ export declare const RouterUtils: {
      * Tests if given route has an empty path from root.
      */
     readonly hasEmptyPathFromRoot: (route: ActivatedRoute) => boolean;
+    /**
+     * Observes the route activation for the specified outlet.
+     *
+     * The observable emits after the previous component has been destroyed (if any) but before constructing the new component.
+     *
+     * Options to control when to emit:
+     * - `routeChange`: Emit only when navigating the outlet to a different route.
+     * - `routeOrParamChange`: Emit when navigating the outlet to a different route or changing params (named path params or matrix params).
+     * - `always`: Emit at every navigation, even if the outlet is not the target of the navigation.
+     *
+     * This method must be called within an injection context.
+     *
+     * Note: Listening for route activations/deactivations on the router outlet alone is insufficient for nested routes, as the outlet does not report
+     * activations/deactivations of child routes.
+     *
+     * @param outlet - Specifies the outlet to observe.
+     * @param options - Controls when to emit the observable.
+     * @return An observable emitting a tuple of the previous and current route snapshots.
+     */
+    readonly activatedRoute$: (outlet: string, options: {
+        emitOn: 'routeChange' | 'routeOrParamChange' | 'always';
+    }) => Observable<[ActivatedRouteSnapshot | null, ActivatedRouteSnapshot]>;
 };

package/lib/routing/{workbench-auxiliary-routes-registrator.service.d.ts → workbench-auxiliary-route-installer.service.d.ts}

@@ -5,7 +5,7 @@ import * as i0 from "@angular/core";
 /**
  * Facilitates the registration of auxiliary routes of top-level routes.
  */
-export declare class WorkbenchAuxiliaryRoutesRegistrator {
+export declare class WorkbenchAuxiliaryRouteInstaller {
     private _workbenchConfig;
     private _router;
     constructor(_workbenchConfig: WorkbenchConfig, _router: Router);
@@ -24,8 +24,8 @@ export declare class WorkbenchAuxiliaryRoutesRegistrator {
      * Replaces the router configuration to install or uninstall auxiliary routes.
      */
     private replaceRouterConfig;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchAuxiliaryRoutesRegistrator, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchAuxiliaryRoutesRegistrator>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchAuxiliaryRouteInstaller, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchAuxiliaryRouteInstaller>;
 }
 /**
  * Configures auxiliary routes.
@@ -43,3 +43,10 @@ export interface AuxiliaryRouteConfig {
  * Can be injected in a `CanMatch` guard to obtain a reference to the workbench element.
  */
 export declare const WORKBENCH_AUXILIARY_ROUTE_OUTLET: InjectionToken<string>;
+/**
+ * Component to display if the outlet has not yet been navigated or no navigation information is available.
+ */
+export declare class BlankComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<BlankComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BlankComponent, "wb-blank", never, {}, {}, never, never, true, never>;
+}

package/lib/routing/workbench-layout-differ.d.ts

@@ -1,6 +1,5 @@
 import { IterableChanges, IterableDiffers } from '@angular/core';
 import { ɵWorkbenchLayout } from '../layout/ɵworkbench-layout';
-import { UrlTree } from '@angular/router';
 import { ViewId } from '../view/workbench-view.model';
 import * as i0 from "@angular/core";
 /**
@@ -13,7 +12,7 @@ export declare class WorkbenchLayoutDiffer {
     /**
      * Computes differences in the layout since last time {@link WorkbenchLayoutDiffer#diff} was invoked.
      */
-    diff(workbenchLayout: ɵWorkbenchLayout | null, urlTree: UrlTree): WorkbenchLayoutDiff;
+    diff(workbenchLayout: ɵWorkbenchLayout | null): WorkbenchLayoutDiff;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchLayoutDiffer, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchLayoutDiffer>;
 }

package/lib/routing/workbench-navigational-states.d.ts

@@ -1,11 +1,11 @@
 import { Navigation } from '@angular/router';
-import { ViewStates } from './routing.model';
+import { NavigationStates } from './routing.model';
 /**
  * Provides methods to associate {@link WorkbenchNavigationalState} with a navigation.
  */
 export declare const WorkbenchNavigationalStates: {
     /**
-     * Returns workbench-specific state associated with given navigation, or `null` if not a workbench navigation.
+     * Returns workbench-specific state associated with given navigation, or `null` if the navigation was not performed through the workbench router.
      */
     readonly fromNavigation: (navigation: Navigation) => WorkbenchNavigationalState | null;
     /**
@@ -25,12 +25,16 @@ export interface WorkbenchNavigationalState {
      * Note: The main area grid is not passed as navigational state, but as query parameter {@link MAIN_AREA_LAYOUT_QUERY_PARAM}.
      */
     workbenchGrid: string;
+    /**
+     * Identifies the perspective that is navigated.
+     */
+    perspectiveId?: string | undefined;
     /**
      * Indicates whether to maximize the main area.
      */
     maximized: boolean;
     /**
-     * View states to be associated with the navigation.
+     * Provides navigation state of views contained in the workbench layout.
      */
-    viewStates: ViewStates;
+    navigationStates: NavigationStates;
 }

package/lib/{view/workbench-view-route-guards.d.ts → routing/workbench-route-guards.d.ts}

@@ -29,8 +29,14 @@ export declare function canMatchWorkbenchView(navigationHint: string): CanMatchF
  */
 export declare function canMatchWorkbenchView(canMatch: boolean): CanMatchFn;
 /**
- * Matches if the view has been navigated (or cannot be found).
+ * Matches the route based on the active perspective.
  *
- * The view cannot be found during initial navigation as the workbench layout is loaded asynchronously.
+ * Can be used to have a different start page per perspective.
+ */
+export declare function canMatchWorkbenchPerspective(id: string): CanMatchFn;
+/**
+ * Matches if the view has been navigated.
+ *
+ * Does not match if no navigation information is available, e.g., during initial navigation because the layout is loaded asynchronously, or when closing the view.
  */
 export declare const canMatchNotFoundPage: CanMatchFn;