@scion/workbench 17.0.0-beta.7 → 17.0.0-beta.9

package/lib/routing/workbench-url-observer.service.d.ts

@@ -4,17 +4,18 @@ import { WorkbenchAuxiliaryRoutesRegistrator } from './workbench-auxiliary-route
 import { WorkbenchViewRegistry } from '../view/workbench-view.registry';
 import { WorkbenchPartRegistry } from '../part/workbench-part.registry';
 import { WorkbenchLayoutService } from '../layout/workbench-layout.service';
-import { WorkbenchRouter } from './workbench-router.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.
  *
- * - For each added view, constructs a {@link WorkbenchView} and registers view specific auxiliary routes of all primary routes
+ * - For each added view, constructs a {@link WorkbenchView} and registers view specific auxiliary routes of all top-level routes
  * - For each removed view, destroys {@link WorkbenchView} and unregisters its auxiliary routes
  * - For each added part, constructs a {@link WorkbenchPart}
  * - For each removed part, destroys {@link WorkbenchPart}
@@ -22,7 +23,7 @@ import * as i0 from "@angular/core";
  */
 export declare class WorkbenchUrlObserver {
     private _router;
-    private _auxRoutesRegistrator;
+    private _auxiliaryRoutesRegistrator;
     private _viewRegistry;
     private _partRegistry;
     private _workbenchLayoutService;
@@ -32,8 +33,9 @@ export declare class WorkbenchUrlObserver {
     private _workbenchLayoutDiffer;
     private _workbenchPopupDiffer;
     private _workbenchDialogDiffer;
+    private _workbenchMessageBoxDiffer;
     private _logger;
-    constructor(_router: Router, _auxRoutesRegistrator: WorkbenchAuxiliaryRoutesRegistrator, _viewRegistry: WorkbenchViewRegistry, _partRegistry: WorkbenchPartRegistry, _workbenchLayoutService: WorkbenchLayoutService, _environmentInjector: EnvironmentInjector, _workbenchRouter: WorkbenchRouter, _workbenchLayoutFactory: ɵWorkbenchLayoutFactory, _workbenchLayoutDiffer: WorkbenchLayoutDiffer, _workbenchPopupDiffer: WorkbenchPopupDiffer, _workbenchDialogDiffer: WorkbenchDialogDiffer, _logger: 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);
     /** Invoked at the beginning of each navigation */
     private onNavigationStart;
     /** Invoked upon successful navigation */
@@ -49,35 +51,15 @@ export declare class WorkbenchUrlObserver {
      */
     private createWorkbenchNavigationContext;
     /**
-     * For each added view, registers auxiliary routes of all primary routes.
+     * For each added workbench outlet, registers auxiliary routes of all top-level routes.
      */
-    private registerAddedViewAuxiliaryRoutes;
+    private registerAddedOutletAuxiliaryRoutes;
     /**
-     * For each added popup, registers auxiliary routes of all primary routes.
-     */
-    registerAddedPopupAuxiliaryRoutes(): void;
-    /**
-     * For each added dialog, registers auxiliary routes of all primary routes.
-     */
-    registerAddedDialogAuxiliaryRoutes(): void;
-    /**
-     * Reverts the workbench layout differ 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.
-     */
-    private undoWorkbenchLayoutDiffer;
-    /**
-     * Reverts the popup outlet differ 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.
-     */
-    private undoWorkbenchPopupDiffer;
-    /**
-     * Reverts the dialog outlet differ to the state before the navigation.
+     * 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.
      */
-    private undoWorkbenchDialogDiffer;
+    private undoWorkbenchDiffers;
     /**
      * Undoes the registration of auxiliary routes.
      *

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

@@ -0,0 +1,74 @@
+import { NavigationExtras, Router, 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 _currentNavigationContext;
+    constructor(_router: Router, _workbenchLayoutService: WorkbenchLayoutService, _workbenchViewRegistry: WorkbenchViewRegistry, _injector: Injector, _logger: Logger, _zone: NgZone);
+    /** @inheritDoc */
+    navigate(commands: Commands, extras?: WorkbenchNavigationExtras): Promise<boolean>;
+    navigate(navigateFn: ɵNavigateFn, extras?: Omit<NavigationExtras, 'relativeTo' | 'state'>): Promise<boolean>;
+    navigate(commandsOrNavigateFn: Commands | ɵNavigateFn, extras?: WorkbenchNavigationExtras | Omit<NavigationExtras, 'relativeTo' | 'state'>): Promise<boolean>;
+    /**
+     * Performs changes to the current workbench layout.
+     *
+     * Unlike {@link navigate}, does not perform the navigation but returns the URL tree instead.
+     *
+     * The router will invoke the callback and pass the current layout for modification. The callback can call `inject` to get any required dependencies.
+     *
+     * The following example adds a part to the left of the main area, inserts a view and navigates it.
+     *
+     * ```ts
+     * inject(WorkbenchRouter).createUrlTree(layout => layout
+     *   .addPart('left', {relativeTo: MAIN_AREA, align: 'left'})
+     *   .addView('navigator', {partId: 'left'})
+     *   .navigateView('navigator', ['path/to/view'])
+     *   .activateView('navigator'),
+     * );
+     * ```
+     *
+     * @param onNavigate - Specifies the callback to modify the layout.
+     * @param extras - Controls how to perform the navigation.
+     * @see NavigateFn
+     */
+    createUrlTree(onNavigate: (layout: ɵWorkbenchLayout) => Promise<ɵWorkbenchLayout | null> | ɵWorkbenchLayout | null, extras?: Omit<NavigationExtras, 'relativeTo' | 'state'>): Promise<UrlTree | null>;
+    /**
+     * Decides if given view can be closed, invoking `CanClose` guard if implemented.
+     */
+    private canCloseView;
+    /**
+     * Returns the context of the current workbench navigation, when being invoked during navigation, or throws an error otherwise.
+     */
+    getCurrentNavigationContext(): WorkbenchNavigationContext;
+    /**
+     * Sets navigational contextual data.
+     */
+    setCurrentNavigationContext(context: WorkbenchNavigationContext | null): void;
+    /**
+     * Blocks until the initial layout is available, i.e. after completion of Angular's initial navigation.
+     */
+    private waitForInitialLayout;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ɵWorkbenchRouter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ɵWorkbenchRouter>;
+}
+/**
+ * @inheritDoc
+ * @see NavigateFn
+ */
+export type ɵNavigateFn = (layout: ɵWorkbenchLayout) => Promise<ɵWorkbenchLayout | null> | ɵWorkbenchLayout | null;

package/lib/startup/workbench-launcher.service.d.ts

@@ -1,4 +1,4 @@
-import { WorkbenchModuleConfig } from '../workbench-module-config';
+import { WorkbenchConfig } from '../workbench-config';
 import { EnvironmentProviders, Injector, NgZone } from '@angular/core';
 import { Logger } from '../logging';
 import * as i0 from "@angular/core";
@@ -9,7 +9,7 @@ import * as i0 from "@angular/core";
  * Workbench initializers may execute in parallel. To register a workbench initializer, provide a class implementing
  * {@link WorkbenchInitializer} as a multi-provider using the DI class token {@link WorkbenchInitializer}.
  *
- * When importing the {@link WorkbenchModule}, you can configure which workbench launching strategy to use.
+ * The SCION Workbench supports the following launchers:
  *
  *  - **APP_INITIALIZER**
  *   Launches the workbench in an Angular `APP_INITIALIZER`, which is before bootstrapping the app component.
@@ -23,7 +23,7 @@ import * as i0 from "@angular/core";
  *   tree.
  *
  * The workbench component displays a startup splash until completed startup. You can configure a custom splash in
- * {@link WorkbenchModuleConfig#startup#splash}. When launching the workbench in an Angular `APP_INITIALIZER`, no splash will
+ * {@link WorkbenchConfig#startup#splash}. When launching the workbench in an Angular `APP_INITIALIZER`, no splash will
  * display since the workbench will start upfront.
  */
 export declare class WorkbenchLauncher {
@@ -97,4 +97,4 @@ export declare class WorkbenchStartup {
 /**
  * Provides a set of DI providers for launching the workbench.
  */
-export declare function provideWorkbenchLauncher(workbenchModuleConfig: WorkbenchModuleConfig): EnvironmentProviders | [];
+export declare function provideWorkbenchLauncher(workbenchConfig: WorkbenchConfig): EnvironmentProviders | [];

package/lib/testing/public_api.d.ts

@@ -1 +1,2 @@
 export { WorkbenchTestingModule } from './workbench-testing.module';
+export { provideWorkbenchForTest } from './workbench.provider';

package/lib/testing/workbench-testing.module.d.ts

@@ -1,12 +1,11 @@
 import { ModuleWithProviders } from '@angular/core';
-import { WorkbenchModuleConfig } from '../workbench-module-config';
+import { WorkbenchConfig } from '../workbench-config';
 import * as i0 from "@angular/core";
-import * as i1 from "../workbench.module";
 /**
  * Sets up the SCION Workbench to be used for testing.
  *
- * It does the following:
- * - provides the workbench applying given config
+ * Does the following:
+ * - provides the workbench with given config
  * - configures the workbench to name the initial part 'main'
  * - installs a sequence for activation instants
  * - configures the testbed to auto-detect changes
@@ -27,13 +26,15 @@ import * as i1 from "../workbench.module";
  *    });
  * });
  * ```
+ *
+ * @deprecated since version 17.0.0-beta.8; Register SCION Workbench providers using `provideWorkbench` function instead; API will be removed in a future release; API will be removed in a future release.
  */
 export declare class WorkbenchTestingModule {
     /**
      * Sets up the SCION Workbench to be used for testing.
      */
-    static forTest(config?: WorkbenchModuleConfig): ModuleWithProviders<WorkbenchTestingModule>;
+    static forTest(config?: WorkbenchConfig): ModuleWithProviders<WorkbenchTestingModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchTestingModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<WorkbenchTestingModule, never, never, [typeof i1.WorkbenchModule]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<WorkbenchTestingModule, never, never, never>;
     static ɵinj: i0.ɵɵInjectorDeclaration<WorkbenchTestingModule>;
 }

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

@@ -0,0 +1,29 @@
+import { WorkbenchConfig } from '../workbench-config';
+import { EnvironmentProviders } from '@angular/core';
+/**
+ * Returns the set of dependency-injection providers to enable and configure the SCION Workbench in tests.
+ *
+ * Does the following:
+ * - provides the workbench with given config
+ * - configures the workbench to name the initial part 'main'
+ * - installs a sequence for activation instants
+ * - configures the testbed to auto-detect changes
+ * - disables animations
+ * - performs the initial navigation
+ *
+ * ### Usage
+ *
+ * ```
+ * beforeEach(() => {
+ *   TestBed.configureTestingModule({
+ *      imports: [
+ *        WorkbenchTestingModule.forTest(),
+ *        RouterTestingModule.withRoutes([
+ *          {path: 'test-view', component: TestComponent},
+ *        ]),
+ *      ],
+ *    });
+ * });
+ * ```
+ */
+export declare function provideWorkbenchForTest(config?: WorkbenchConfig): EnvironmentProviders;

package/lib/view/public_api.d.ts

@@ -1 +1,2 @@
-export { WorkbenchView } from './workbench-view.model';
+export { WorkbenchView, ViewId } from './workbench-view.model';
+export { canMatchWorkbenchView } from './workbench-view-route-guards';

package/lib/view/view-move-handler.service.d.ts

@@ -1,8 +1,7 @@
-import { Injector } from '@angular/core';
 import { ViewDragService } from '../view-dnd/view-drag.service';
 import { Router } from '@angular/router';
 import { LocationStrategy } from '@angular/common';
-import { WorkbenchRouter } from '../routing/workbench-router.service';
+import { ɵWorkbenchRouter } from '../routing/ɵworkbench-router.service';
 import { ɵWorkbenchLayoutFactory } from '../layout/ɵworkbench-layout.factory';
 import * as i0 from "@angular/core";
 /**
@@ -15,8 +14,7 @@ export declare class ViewMoveHandler {
     private _viewDragService;
     private _router;
     private _locationStrategy;
-    private _injector;
-    constructor(_workbenchId: string, _workbenchRouter: WorkbenchRouter, _workbenchLayoutFactory: ɵWorkbenchLayoutFactory, _viewDragService: ViewDragService, _router: Router, _locationStrategy: LocationStrategy, _injector: Injector);
+    constructor(_workbenchId: string, _workbenchRouter: ɵWorkbenchRouter, _workbenchLayoutFactory: ɵWorkbenchLayoutFactory, _viewDragService: ViewDragService, _router: Router, _locationStrategy: LocationStrategy);
     private installViewMoveListener;
     private addView;
     private moveViewToNewWindow;

package/lib/view/view-portal.pipe.d.ts

@@ -2,6 +2,7 @@ import { PipeTransform } from '@angular/core';
 import { WorkbenchViewRegistry } from './workbench-view.registry';
 import { WbComponentPortal } from '../portal/wb-component-portal';
 import type { ViewComponent } from '../view/view.component';
+import { ViewId } from './workbench-view.model';
 import * as i0 from "@angular/core";
 /**
  * Resolves the portal for the given view, or throws an error if the view is not registered.
@@ -9,7 +10,7 @@ import * as i0 from "@angular/core";
 export declare class ViewPortalPipe implements PipeTransform {
     private _viewRegistry;
     constructor(_viewRegistry: WorkbenchViewRegistry);
-    transform(viewId: string | null): WbComponentPortal<ViewComponent> | null;
+    transform(viewId: ViewId | null): WbComponentPortal<ViewComponent> | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<ViewPortalPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<ViewPortalPipe, "wbViewPortal", true>;
 }

package/lib/view/view.component.d.ts

@@ -1,5 +1,4 @@
 import { ElementRef, OnDestroy } from '@angular/core';
-import { ActivatedRoute, RouterOutlet } from '@angular/router';
 import { SciViewportComponent } from '@scion/components/viewport';
 import { ViewMenuService } from '../part/view-context-menu/view-menu.service';
 import { ɵWorkbenchView } from './ɵworkbench-view.model';
@@ -8,13 +7,7 @@ import { ViewDragService } from '../view-dnd/view-drag.service';
 import * as i0 from "@angular/core";
 import * as i1 from "../glass-pane/glass-pane.directive";
 /**
- * Is the graphical representation of a workbench view.
- *
- * The view has its dedicated router outlet to display view content. Use route path parameters
- * to decide what specific content to present. Use matrix parameters to associate optional data
- * with the view outlet URL.
- *
- * Title and heading of this view are either set via `WorkbenchView`, or given as route data or matrix parameter.
+ * Renders the workbench view, using a router-outlet to display view content.
  */
 export declare class ViewComponent implements OnDestroy {
     private _view;
@@ -23,15 +16,12 @@ export declare class ViewComponent implements OnDestroy {
     private _viewDragService;
     private _viewport$;
     set setViewport(viewport: SciViewportComponent);
-    routerOutlet: RouterOutlet;
     get viewId(): string;
     get cssClasses(): string;
     get isViewDragActive(): boolean;
     constructor(_view: ɵWorkbenchView, _logger: Logger, _host: ElementRef<HTMLElement>, _viewDragService: ViewDragService, viewContextMenuService: ViewMenuService);
     private onActivateView;
     private onDeactivateView;
-    onActivateRoute(route: ActivatedRoute): void;
-    onDeactivateRoute(): void;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ViewComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ViewComponent, "wb-view", never, {}, {}, never, never, true, [{ directive: typeof i1.GlassPaneDirective; inputs: {}; outputs: {}; }]>;

package/lib/view/workbench-view-route-guards.d.ts

@@ -0,0 +1,36 @@
+import { CanMatchFn } from '@angular/router';
+/**
+ * Matches the route if target of a workbench view and navigating with the given hint.
+ *
+ * Can be used to differentiate between routes with an identical path. For example, the views of the initial layout or a perspective
+ * are usually navigated to the empty path route to avoid cluttering the URL. A hint can be set when navigating the view to match a
+ * particular route.
+ *
+ * ### Example:
+ *
+ * The following routes both match the empty path, but only if navigated with a specific hint.
+ * ```ts
+ * const routes: Routes = [
+ *   {path: '', canMatch: [canMatchWorkbenchView('navigator')], component: NavigatorComponent},
+ *   {path: '', canMatch: [canMatchWorkbenchView('outline')], component: OutlineComponent},
+ * ];
+ * ```
+ *
+ * The following example navigates to the `OutlineComponent`, passing a hint to match the route.
+ * ```ts
+ * inject(WorkbenchRouter).navigate([], {hint: 'outline'});
+ * ```
+ */
+export declare function canMatchWorkbenchView(navigationHint: string): CanMatchFn;
+/**
+ * Matches the route if, or if not target of a workbench view.
+ *
+ * Can be used to guard the application's root route from matching an empty path view navigation.
+ */
+export declare function canMatchWorkbenchView(canMatch: boolean): CanMatchFn;
+/**
+ * Matches if the view has been navigated (or cannot be found).
+ *
+ * The view cannot be found during initial navigation as the workbench layout is loaded asynchronously.
+ */
+export declare const canMatchNotFoundPage: CanMatchFn;

package/lib/view/workbench-view.model.d.ts

@@ -5,17 +5,41 @@ import { WorkbenchMenuItem } from '../workbench.model';
 import { WorkbenchPart } from '../part/workbench-part.model';
 import { ViewState } from '../routing/routing.model';
 /**
- * A view is a visual workbench component for displaying content stacked or side-by-side.
+ * Handle to interact with a view opened via {@link WorkbenchRouter}.
  *
- * Any component registered as a primary Angular route can be opened as a view using the {@link WorkbenchRouter}.
+ * The view component can inject this handle to interact with the view, such as setting the title or closing the view.
  *
- * @see WorkbenchPart
+ * The view component can inject `ActivatedRoute` to obtain parameters passed to the navigation and/or read data associated with the route.
+ *
+ * @see WorkbenchRouter
  */
 export declare abstract class WorkbenchView {
     /**
      * Unique identity of this view.
+     *
+     * Each view is assigned a unique identifier (e.g., `view.1`, `view.2`, etc.).
+     *
+     * @see alternativeId
+     */
+    abstract readonly id: ViewId;
+    /**
+     * Alternative identity of this view.
+     *
+     * A view can have an alternative id, a meaningful but not necessarily unique name. A view can
+     * be identified either by its unique or alternative id.
+     *
+     * @see id
      */
-    abstract readonly id: string;
+    abstract readonly alternativeId: string | undefined;
+    /**
+     * Hint passed to the navigation.
+     *
+     * A hint can be passed to the navigation to differentiate between routes with identical paths.
+     *
+     * For example, the views of the initial layout or a perspective are usually navigated to the empty path route to avoid cluttering the URL,
+     * requiring a navigation hint to differentiate between the routes.
+     */
+    abstract readonly navigationHint: string | undefined;
     /**
      * Reference to the part which contains this view.
      *
@@ -31,7 +55,7 @@ export declare abstract class WorkbenchView {
      */
     abstract heading: string | null;
     /**
-     * Specifies CSS class(es) to be added to the view, useful in end-to-end tests for locating view and view tab.
+     * Specifies CSS class(es) to add to the view, e.g., to locate the view in tests.
      */
     abstract cssClass: string | string[];
     /**
@@ -126,3 +150,11 @@ export declare abstract class WorkbenchView {
      */
     abstract registerMenuItem(menuItem: WorkbenchMenuItem): Disposable;
 }
+/**
+ * Format of a view identifier.
+ *
+ * Each view is assigned a unique identifier (e.g., `view.1`, `view.2`, etc.).
+ * A view can also have an alternative id, a meaningful but not necessarily unique name. A view can
+ * be identified either by its unique or alternative id.
+ */
+export type ViewId = `view.${number}`;

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

@@ -1,6 +1,7 @@
 import { OnDestroy } from '@angular/core';
 import { Observable } from 'rxjs';
 import { ɵWorkbenchView } from './ɵworkbench-view.model';
+import { ViewId } from './workbench-view.model';
 import * as i0 from "@angular/core";
 /**
  * Registry for {@link WorkbenchView} model objects.
@@ -15,12 +16,12 @@ export declare class WorkbenchViewRegistry implements OnDestroy {
     /**
      * Unregisters specified view and destroys it.
      */
-    unregister(viewId: string): void;
+    unregister(viewId: ViewId): void;
     /**
      * Returns the {@link WorkbenchView} of the given identity. If not found, by default, throws an error unless setting the `orElseNull` option.
      */
-    get(viewId: string): ɵWorkbenchView;
-    get(viewId: string, options: {
+    get(viewId: ViewId): ɵWorkbenchView;
+    get(viewId: ViewId, options: {
         orElse: null;
     }): ɵWorkbenchView | null;
     get views(): readonly ɵWorkbenchView[];

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

@@ -2,25 +2,27 @@ import { BehaviorSubject, Observable } from 'rxjs';
 import { UrlSegment } from '@angular/router';
 import { Disposable } from '../common/disposable';
 import { WorkbenchMenuItem } from '../workbench.model';
-import { WorkbenchView } from './workbench-view.model';
+import { ViewId, WorkbenchView } from './workbench-view.model';
 import { WorkbenchPart } from '../part/workbench-part.model';
 import { ComponentType } from '@angular/cdk/portal';
 import { WbComponentPortal } from '../portal/wb-component-portal';
-import { AbstractType, Type } from '@angular/core';
+import { AbstractType, Injector, Type } from '@angular/core';
 import { ɵWorkbenchLayout } from '../layout/ɵworkbench-layout';
 import { ɵWorkbenchDialog } from '../dialog/ɵworkbench-dialog';
 import { Blockable } from '../glass-pane/blockable';
-import { ViewState } from '../routing/routing.model';
 import { ClassList } from '../common/class-list';
+import { ViewState } from '../routing/routing.model';
+import { UUID } from '../common/uuid.util';
 export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
-    readonly id: string;
+    readonly id: ViewId;
     private readonly _workbenchId;
     private readonly _workbenchService;
     private readonly _workbenchLayoutService;
+    private readonly _router;
     private readonly _workbenchRouter;
+    private readonly _childrenOutletContexts;
     private readonly _partRegistry;
     private readonly _viewDragService;
-    private readonly _router;
     private readonly _activationInstantProvider;
     private readonly _workbenchDialogRegistry;
     private readonly _part$;
@@ -30,43 +32,68 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     private readonly _destroyRef;
     private _activationInstant;
     private _closable;
+    uid: UUID;
+    alternativeId: string | undefined;
+    navigationHint: string | undefined;
+    urlSegments: UrlSegment[];
+    state: ViewState;
     title: string | null;
     heading: string | null;
     dirty: boolean;
     scrollTop: number;
     scrollLeft: number;
-    state: ViewState;
     readonly active$: BehaviorSubject<boolean>;
     readonly menuItems$: Observable<WorkbenchMenuItem[]>;
     readonly blockedBy$: BehaviorSubject<ɵWorkbenchDialog<unknown> | null>;
     readonly portal: WbComponentPortal;
     readonly classList: ClassList;
-    constructor(id: string, options: {
+    constructor(id: ViewId, options: {
         component: ComponentType<ViewComponent>;
     });
     private createPortal;
     /**
-     * Method invoked to update this workbench model object when the workbench layout changes.
+     * Method invoked when a route is about to be activated for this view.
+     */
+    private onRouteActivate;
+    /**
+     * Method invoked when the workbench layout has changed.
+     *
+     * This method:
+     * - is called on every layout change, including changes not relevant for this view.
+     * - is called after successful navigation, i.e., after {@link onRouteActivate}.
      */
     onLayoutChange(layout: ɵWorkbenchLayout): void;
+    /**
+     * Returns the component of this view. Returns `null` if not navigated the view, or before it was activated for the first time.
+     */
+    getComponent<T = unknown>(): T | null;
+    /**
+     * Returns the injector of the component. Returns `null` if not navigated the view, or before it was activated for the first time.
+     */
+    getComponentInjector(): Injector | null;
+    /** @inheritDoc */
     get first(): boolean;
+    /** @inheritDoc */
     get last(): boolean;
+    /** @inheritDoc */
     get position(): number;
+    /** @inheritDoc */
     set cssClass(cssClass: string | string[]);
+    /** @inheritDoc */
     get cssClass(): string[];
+    /** @inheritDoc */
     get active(): boolean;
+    /** @inheritDoc */
     set closable(closable: boolean);
+    /** @inheritDoc */
     get closable(): boolean;
+    /** @inheritDoc */
     activate(options?: {
         skipLocationChange?: boolean;
     }): Promise<boolean>;
-    /**
-     * Sets whether the tab of this view is scrolled into view in the tabbar.
-     */
+    /** @inheritDoc */
     set scrolledIntoView(scrolledIntoView: boolean);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     get scrolledIntoView(): boolean;
     /**
      * Informs whether the tab of this view is scrolled into view in the tabbar.
@@ -74,14 +101,17 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
      */
     get scrolledIntoView$(): Observable<boolean>;
     get activationInstant(): number | undefined;
+    /** @inheritDoc */
     get part(): WorkbenchPart;
+    /** @inheritDoc */
     close(target?: 'self' | 'all-views' | 'other-views' | 'views-to-the-right' | 'views-to-the-left'): Promise<boolean>;
+    /** @inheritDoc */
     move(target: 'new-window'): void;
     move(partId: string, options?: {
         region?: 'north' | 'south' | 'west' | 'east';
         workbenchId?: string;
     }): void;
-    get urlSegments(): UrlSegment[];
+    /** @inheritDoc */
     registerMenuItem(menuItem: WorkbenchMenuItem): Disposable;
     /**
      * Registers an adapter for this view, replacing any previously registered adapter of the same type.
@@ -110,6 +140,22 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
      * Blocks this view when a dialog overlays it.
      */
     private blockWhenDialogOpened;
+    /**
+     * Detects when to activate a route for this view.
+     *
+     * Listening for route activations on the view's router outlet is not sufficient,
+     * as the outlet does not report subsequent activations of nested child routes.
+     *
+     * Example:
+     * ```html
+     * <router-outlet #router_outlet="outlet"
+     *                (activate)="onActivateRoute(router_outlet.activatedRoute)">
+     * </router-outlet>
+     * ```
+     *
+     * Instead, we subscribe to Angular's `ActivationStart` router events and update the view properties accordingly.
+     */
+    private detectRouteActivation;
     destroy(): void;
 }
 /**