@scion/workbench 18.0.0-beta.2 → 18.0.0-beta.4

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").WritableSignal<ɵWorkbenchPerspective | null>;
     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//311/265workbench-perspective.model.d.ts

@@ -1,27 +1,30 @@
+import { InjectionToken, Injector, Signal, WritableSignal } from '@angular/core';
 import { WorkbenchPerspective, WorkbenchPerspectiveDefinition } from './workbench-perspective.model';
-import { Observable } from 'rxjs';
+/**
+ * Provides the activated perspective.
+ */
+export declare const ACTIVE_PERSPECTIVE: InjectionToken<WritableSignal<ɵWorkbenchPerspective | null>>;
 /**
  * @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 _activePerspective;
+    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.
@@ -31,6 +34,10 @@ export declare class ɵWorkbenchPerspective implements WorkbenchPerspective {
      * Resets this perspective to its initial layout.
      */
     reset(): Promise<void>;
+    /**
+     * Reference to the handle's injector. The injector will be destroyed when unregistering the perspective.
+     */
+    get injector(): Injector;
     /**
      * Creates layout with the workbench grid of this perspective and the main area of the current layout.
      *
@@ -39,15 +46,18 @@ export declare class ɵWorkbenchPerspective implements WorkbenchPerspective {
      * 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.

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

@@ -166,6 +166,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;
     /**

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.
      *
@@ -48,6 +42,10 @@ export declare class PopupService {
      *          - resolves to `undefined` if closed without a result
      */
     open<R>(config: PopupConfig): Promise<R>;
+    /**
+     * Creates the popup handle.
+     */
+    private createPopup;
     private setPopupAlignCssClass;
     /**
      * Closes the popup depending on the configured popup closing strategy.
@@ -76,6 +74,6 @@ export declare class PopupService {
      * 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/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,4 @@
 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';

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.
      */
@@ -61,4 +62,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,5 +1,5 @@
 import { Navigation } from '@angular/router';
-import { ViewStates } from './routing.model';
+import { NavigationStates } from './routing.model';
 /**
  * Provides methods to associate {@link WorkbenchNavigationalState} with a navigation.
  */
@@ -30,7 +30,7 @@ export interface WorkbenchNavigationalState {
      */
     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/routing/workbench-url-observer.service.d.ts

@@ -1,16 +1,3 @@
-import { Router } from '@angular/router';
-import { EnvironmentInjector } from '@angular/core';
-import { WorkbenchAuxiliaryRoutesRegistrator } from './workbench-auxiliary-routes-registrator.service';
-import { WorkbenchViewRegistry } from '../view/workbench-view.registry';
-import { WorkbenchPartRegistry } from '../part/workbench-part.registry';
-import { WorkbenchLayoutService } from '../layout/workbench-layout.service';
-import { WorkbenchLayoutDiffer } from './workbench-layout-differ';
-import { WorkbenchPopupDiffer } from './workbench-popup-differ';
-import { Logger } from '../logging';
-import { ɵWorkbenchLayoutFactory } from '../layout/ɵworkbench-layout.factory';
-import { WorkbenchDialogDiffer } from './workbench-dialog-differ';
-import { ɵWorkbenchRouter } from './ɵworkbench-router.service';
-import { WorkbenchMessageBoxDiffer } from './workbench-message-box-differ';
 import * as i0 from "@angular/core";
 /**
  * Tracks the browser URL for workbench layout changes.
@@ -22,20 +9,21 @@ import * as i0 from "@angular/core";
  * - Parses the serialized layout and injects it into {@link WorkbenchLayoutService}.
  */
 export declare class WorkbenchUrlObserver {
-    private _router;
-    private _auxiliaryRoutesRegistrator;
-    private _viewRegistry;
-    private _partRegistry;
-    private _workbenchLayoutService;
-    private _environmentInjector;
-    private _workbenchRouter;
-    private _workbenchLayoutFactory;
-    private _workbenchLayoutDiffer;
-    private _workbenchPopupDiffer;
-    private _workbenchDialogDiffer;
-    private _workbenchMessageBoxDiffer;
-    private _logger;
-    constructor(_router: Router, _auxiliaryRoutesRegistrator: WorkbenchAuxiliaryRoutesRegistrator, _viewRegistry: WorkbenchViewRegistry, _partRegistry: WorkbenchPartRegistry, _workbenchLayoutService: WorkbenchLayoutService, _environmentInjector: EnvironmentInjector, _workbenchRouter: ɵWorkbenchRouter, _workbenchLayoutFactory: ɵWorkbenchLayoutFactory, _workbenchLayoutDiffer: WorkbenchLayoutDiffer, _workbenchPopupDiffer: WorkbenchPopupDiffer, _workbenchDialogDiffer: WorkbenchDialogDiffer, _workbenchMessageBoxDiffer: WorkbenchMessageBoxDiffer, _logger: Logger);
+    private readonly _router;
+    private readonly _auxiliaryRouteInstaller;
+    private readonly _viewRegistry;
+    private readonly _partRegistry;
+    private readonly _workbenchLayoutService;
+    private readonly _environmentInjector;
+    private readonly _workbenchRouter;
+    private readonly _workbenchLayoutFactory;
+    private readonly _workbenchLayoutDiffer;
+    private readonly _workbenchViewOutletDiffer;
+    private readonly _workbenchPopupDiffer;
+    private readonly _workbenchDialogDiffer;
+    private readonly _workbenchMessageBoxDiffer;
+    private readonly _logger;
+    constructor();
     /** Invoked at the beginning of each navigation */
     private onNavigationStart;
     /** Invoked upon successful navigation */
@@ -44,8 +32,6 @@ export declare class WorkbenchUrlObserver {
     private onNavigationCancel;
     /** Invoked when the navigation failed */
     private onNavigationError;
-    /** Invoked after checked guards for activation */
-    private onGuardsCheckEnd;
     /**
      * Creates the context of the current navigation. The context provides access to the new layout and how it differs from the current layout.
      */
@@ -55,45 +41,35 @@ export declare class WorkbenchUrlObserver {
      */
     private registerAddedOutletAuxiliaryRoutes;
     /**
-     * Reverts the workbench differs to the state before the navigation.
-     *
-     * Invoke this method after navigation failure or cancellation. The navigation is cancelled when guards perform a redirect or reject navigation.
+     * Unregisters auxiliary routes of removed workbench outlets.
      */
-    private undoWorkbenchDiffers;
+    private unregisterRemovedOutletAuxiliaryRoutes;
     /**
-     * Undoes the registration of auxiliary routes.
-     *
-     * Invoke this method after navigation failure or cancellation. The navigation is cancelled when guards perform a redirect or reject navigation.
+     * For each added part, constructs a {@link WorkbenchPart} and registers it in {@link WORKBENCH_PART_REGISTRY}.
      */
-    private undoAuxiliaryRoutesRegistration;
+    private registerAddedWorkbenchParts;
     /**
-     * Updates registries and workbench handles to reflect the new layout.
+     * For each removed part, destroys the {@link WorkbenchPart} and unregisters it in {@link WORKBENCH_PART_REGISTRY}.
      */
-    private applyWorkbenchLayoutChanges;
+    private unregisterRemovedWorkbenchParts;
     /**
-     * Publishes the workbench layout via {@link WorkbenchLayoutService}, similar to a transactional commit.
+     * For each added view, constructs a {@link WorkbenchView} and registers it in {@link WORKBENCH_VIEW_REGISTRY}.
      */
-    private publishWorkbenchLayout;
+    private registerAddedWorkbenchViews;
     /**
-     * Updates the URL if the layout has been migrated from an outdated version.
-     */
-    private migrateURL;
-    /**
-     * Unregisters auxiliary routes of removed workbench outlets.
+     * For each removed view, destroys the {@link WorkbenchView} and unregisters it from {@link WORKBENCH_VIEW_REGISTRY}.
      */
-    private unregisterRemovedOutletAuxiliaryRoutes;
+    private unregisterRemovedWorkbenchViews;
+    private createWorkbenchPart;
+    private createWorkbenchView;
     /**
-     * - For each added view, constructs a {@link WorkbenchView} and registers it in {@link WorkbenchViewRegistry}
-     * - For each removed view, destroys the {@link WorkbenchView} and unregisters it in {@link WorkbenchViewRegistry}
+     * Applies the current layout to the workbench.
      */
-    private updateViewRegistry;
+    private applyWorkbenchLayout;
     /**
-     * - For each added part, constructs a {@link WorkbenchPart} and registers it in {@link WorkbenchPartRegistry}
-     * - For each removed part, destroys the {@link WorkbenchPart} and unregisters it in {@link WorkbenchPartRegistry}
+     * Updates the URL if the layout has been migrated from an outdated version.
      */
-    private updatePartRegistry;
-    private createWorkbenchPart;
-    private createWorkbenchView;
+    private migrateURL;
     private installRouterEventListeners;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchUrlObserver, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchUrlObserver>;

package/lib/routing/workbench-view-outlet-differ.d.ts

@@ -0,0 +1,32 @@
+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";
+/**
+ * Stateful differ to compute view outlets.
+ *
+ * Use this differ to register/unregister view auxiliary routes.
+ *
+ * Because the layout is not available during initial navigation and empty-path views do not have
+ * an outlet in the URL, this differ uses both, outlets in the URL and views in the layout.
+ */
+export declare class WorkbenchViewOutletDiffer {
+    private _differ;
+    constructor(differs: IterableDiffers);
+    /**
+     * Computes differences since last time {@link WorkbenchViewOutletDiffer#diff} was invoked.
+     */
+    diff(workbenchLayout: ɵWorkbenchLayout | null, urlTree: UrlTree): WorkbenchViewOutletDiff;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchViewOutletDiffer, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchViewOutletDiffer>;
+}
+/**
+ * Lists the view outlets added/removed in the current navigation.
+ */
+export declare class WorkbenchViewOutletDiff {
+    readonly addedViewOutlets: `view.${number}`[];
+    readonly removedViewOutlets: `view.${number}`[];
+    constructor(changes: IterableChanges<ViewId> | null);
+    toString(): string;
+}

package/lib/routing//311/265workbench-router.service.d.ts

@@ -1,26 +1,20 @@
-import { NavigationExtras, Router, UrlTree } from '@angular/router';
+import { NavigationExtras, UrlTree } from '@angular/router';
 import { WorkbenchRouter } from './workbench-router.service';
-import { Injector, NgZone } from '@angular/core';
-import { WorkbenchLayoutService } from '../layout/workbench-layout.service';
 import { ɵWorkbenchLayout } from '../layout/ɵworkbench-layout';
 import { Commands, WorkbenchNavigationContext, WorkbenchNavigationExtras } from './routing.model';
-import { WorkbenchViewRegistry } from '../view/workbench-view.registry';
-import { Logger } from '../logging';
 import * as i0 from "@angular/core";
 /** @inheritDoc */
 export declare class ɵWorkbenchRouter implements WorkbenchRouter {
-    private _router;
-    private _workbenchLayoutService;
-    private _workbenchViewRegistry;
-    private _injector;
-    private _logger;
-    private _zone;
-    private _singleNavigationExecutor;
-    /**
-     * Holds the current navigational context during a workbench navigation, or `null` if no navigation is in progress.
-     */
+    private readonly _router;
+    private readonly _workbenchLayoutService;
+    private readonly _workbenchViewRegistry;
+    private readonly _injector;
+    private readonly _logger;
+    private readonly _zone;
+    private readonly _singleNavigationExecutor;
+    /** Holds the current navigational context during a workbench navigation, or `null` if no navigation is in progress. */
     private _currentNavigationContext;
-    constructor(_router: Router, _workbenchLayoutService: WorkbenchLayoutService, _workbenchViewRegistry: WorkbenchViewRegistry, _injector: Injector, _logger: Logger, _zone: NgZone);
+    constructor();
     /** @inheritDoc */
     navigate(commands: Commands, extras?: WorkbenchNavigationExtras): Promise<boolean>;
     navigate(navigateFn: ɵNavigateFn, extras?: Omit<NavigationExtras, 'relativeTo' | 'state'>): Promise<boolean>;

package/lib/testing/workbench.provider.d.ts

@@ -26,4 +26,6 @@ import { EnvironmentProviders } from '@angular/core';
  * });
  * ```
  */
-export declare function provideWorkbenchForTest(config?: WorkbenchConfig): EnvironmentProviders;
+export declare function provideWorkbenchForTest(config?: WorkbenchConfig & {
+    mainAreaInitialPartId?: string;
+}): EnvironmentProviders;