@scion/workbench 20.0.0-beta.9 → 21.0.0-beta.2

package/{index.d.ts → types/scion-workbench.d.ts}

@@ -1,12 +1,12 @@
 import * as _angular_cdk_portal from '@angular/cdk/portal';
 import { ComponentType } from '@angular/cdk/portal';
 import * as i0 from '@angular/core';
-import { InjectionToken, Signal, Injector, Type, EnvironmentProviders, ElementRef, StaticProvider, ViewContainerRef, TemplateRef, WritableSignal, ComponentRef, Provider, OnDestroy, OnInit, DestroyableInjector, AbstractType, PipeTransform } from '@angular/core';
-import { MicrofrontendPlatformConfig } from '@scion/microfrontend-platform';
-import * as _angular_router from '@angular/router';
-import { UrlSegment, NavigationExtras, ActivatedRoute, CanMatchFn } from '@angular/router';
+import { InjectionToken, Signal, Injector, Type, EnvironmentProviders, TemplateRef, WritableSignal, ComponentRef, Provider, ViewContainerRef, OnDestroy, OnInit, DestroyableInjector, ElementRef, StaticProvider, PipeTransform } from '@angular/core';
+import { MicrofrontendPlatformConfig, Qualifier, Capability } from '@scion/microfrontend-platform';
+import { CanMatchFn, UrlSegment, NavigationExtras, ActivatedRoute } from '@angular/router';
 import { Observable, BehaviorSubject } from 'rxjs';
 import * as _scion_workbench from '@scion/workbench';
+import { WorkbenchPopupReferrer } from '@scion/workbench-client';
 
 /**
  * Set of log levels to control logging output.
@@ -141,19 +141,190 @@ declare abstract class MicrofrontendPlatformConfigLoader {
 }
 
 /**
- * DI token to get a unique id of the workbench.
+ * Configures a route to only match workbench parts navigated to the specified part capability.
  *
- * The id is different each time the app is reloaded. Different workbench windows have different ids.
+ * Use this guard to differentiate microfrontend routes, which must all have an empty path.
+ *
+ * @example - Route matching a part capability with qualifier {part: 'navigator'}
+ * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchPartCapability} from '@scion/workbench';
+ *
+ * const routes: Routes = [
+ *   {path: '', canMatch: [canMatchWorkbenchPartCapability({part: 'navigator'})], component: NavigatorComponent},
+ * ];
+ * ```
+ *
+ * The above route matches the following part capability:
+ *
+ * ```json
+ * {
+ *   "type": "part",
+ *   "qualifier": {
+ *     "part": "navigator"
+ *   },
+ *   "properties": {
+ *     "path": ""
+ *   }
+ * }
+ * ```
+ *
+ * @param qualifier - Identifies the part capability.
+ * @return guard matching the specified part capability.
  */
-declare const WORKBENCH_ID: InjectionToken<string>;
+declare function canMatchWorkbenchPartCapability(qualifier: Qualifier): CanMatchFn;
 /**
- * Format of a view identifier.
+ * Configures a route to only match workbench views navigated to the specified view capability.
  *
- * Each view is assigned a unique identifier (e.g., `view.d4de99fb`, `view.cad347dd`, 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.
+ * Use this guard to differentiate microfrontend routes, which must all have an empty path.
+ *
+ * @example - Route matching a view capability with qualifier {view: 'search'}
+ * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchViewCapability} from '@scion/workbench';
+ *
+ * const routes: Routes = [
+ *   {path: '', canMatch: [canMatchWorkbenchViewCapability({view: 'search'})], component: SearchComponent},
+ * ];
+ * ```
+ *
+ * The above route matches the following view capability:
+ *
+ * ```json
+ * {
+ *   "type": "view",
+ *   "qualifier": {
+ *     "view": "search"
+ *   },
+ *   "properties": {
+ *     "path": ""
+ *   }
+ * }
+ * ```
+ *
+ * @param qualifier - Identifies the view capability.
+ * @return guard matching the specified view capability.
  */
-type ViewId = `${typeof VIEW_ID_PREFIX}${string}`;
+declare function canMatchWorkbenchViewCapability(qualifier: Qualifier): CanMatchFn;
+/**
+ * Configures a route to only match workbench dialogs navigated to the specified dialog capability.
+ *
+ * Use this guard to differentiate microfrontend routes, which must all have an empty path.
+ *
+ * @example - Route matching a dialog capability with qualifier {dialog: 'about'}
+ * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchDialogCapability} from '@scion/workbench';
+ *
+ * const routes: Routes = [
+ *   {path: '', canMatch: [canMatchWorkbenchDialogCapability({dialog: 'about'})], component: AboutComponent},
+ * ];
+ * ```
+ *
+ * The above route matches the following dialog capability:
+ *
+ * ```json
+ * {
+ *   "type": "dialog",
+ *   "qualifier": {
+ *     "dialog": "about"
+ *   },
+ *   "properties": {
+ *     "path": ""
+ *   }
+ * }
+ * ```
+ *
+ * @param qualifier - Identifies the dialog capability.
+ * @return guard matching the specified dialog capability.
+ */
+declare function canMatchWorkbenchDialogCapability(qualifier: Qualifier): CanMatchFn;
+/**
+ * Configures a route to only match workbench messageboxes navigated to the specified messagebox capability.
+ *
+ * Use this guard to differentiate microfrontend routes, which must all have an empty path.
+ *
+ * @example - Route matching a messagebox capability with qualifier {messagebox: 'alert'}
+ * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchMessageBoxCapability} from '@scion/workbench';
+ *
+ * const routes: Routes = [
+ *   {path: '', canMatch: [canMatchWorkbenchMessageBoxCapability({messagebox: 'alert'})], component: AlertComponent},
+ * ];
+ * ```
+ *
+ * The above route matches the following messagebox capability:
+ *
+ * ```json
+ * {
+ *   "type": "messagebox",
+ *   "qualifier": {
+ *     "messagebox": "alert"
+ *   },
+ *   "properties": {
+ *     "path": ""
+ *   }
+ * }
+ * ```
+ *
+ * @param qualifier - Identifies the messagebox capability.
+ * @return guard matching the specified messagebox capability.
+ */
+declare function canMatchWorkbenchMessageBoxCapability(qualifier: Qualifier): CanMatchFn;
+/**
+ * Configures a route to only match workbench popups navigated to the specified popup capability.
+ *
+ * Use this guard to differentiate microfrontend routes, which must all have an empty path.
+ *
+ * @example - Route matching a popup capability with qualifier {popup: 'info'}
+ * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchPopupCapability} from '@scion/workbench';
+ *
+ * const routes: Routes = [
+ *   {path: '', canMatch: [canMatchWorkbenchPopupCapability({popup: 'info'})], component: InfoComponent},
+ * ];
+ * ```
+ *
+ * The above route matches the following popup capability:
+ *
+ * ```json
+ * {
+ *   "type": "popup",
+ *   "qualifier": {
+ *     "popup": "info"
+ *   },
+ *   "properties": {
+ *     "path": ""
+ *   }
+ * }
+ * ```
+ *
+ * @param qualifier - Identifies the popup capability.
+ * @return guard matching the specified popup capability.
+ */
+declare function canMatchWorkbenchPopupCapability(qualifier: Qualifier): CanMatchFn;
+/**
+ * Format of a microfrontend capability id.
+ */
+type MicrofrontendCapabilityId = string;
+/**
+ * Format of a microfrontend host outlet name.
+ *
+ * Microfrontend host outlets are used to render microfrontends provided by the host application.
+ *
+ * Format: `workbench.microfrontend.host.<capabilityId>.<workbenchElementType>.<workbenchElementId>`
+ * Example: `workbench.microfrontend.host.39768ab.part.5485357a`
+ */
+type MicrofrontendHostOutlet = `workbench.microfrontend.host.${MicrofrontendCapabilityId}.${PartId | ViewId | DialogId | PopupId}`;
+
+/**
+ * DI token to get a unique id of the workbench.
+ *
+ * The id is different each time the app is reloaded. Different workbench windows have different ids.
+ */
+declare const WORKBENCH_ID: InjectionToken<string>;
 /**
  * Format of a part identifier.
  *
@@ -162,6 +333,14 @@ type ViewId = `${typeof VIEW_ID_PREFIX}${string}`;
  * be identified either by its unique or alternative id.
  */
 type PartId = `${typeof PART_ID_PREFIX}${string}`;
+/**
+ * Format of a view identifier.
+ *
+ * Each view is assigned a unique identifier (e.g., `view.d4de99fb`, `view.cad347dd`, 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.
+ */
+type ViewId = `${typeof VIEW_ID_PREFIX}${string}`;
 /**
  * Format of a dialog identifier.
  */
@@ -186,18 +365,10 @@ type ViewOutlet = ViewId;
  * Format of a part outlet name.
  */
 type PartOutlet = PartId;
-/**
- * Format of a popup outlet name.
- */
-type PopupOutlet = PopupId;
-/**
- * Format of a dialog outlet name.
- */
-type DialogOutlet = DialogId;
 /**
  * Union of workbench outlets.
  */
-type WorkbenchOutlet = PartOutlet | ViewOutlet | DialogOutlet | PopupOutlet;
+type WorkbenchOutlet = PartOutlet | ViewOutlet | MicrofrontendHostOutlet;
 /**
  * Represents the id prefix of views.
  *
@@ -1046,7 +1217,7 @@ interface WorkbenchIconDescriptor {
      */
     component: ComponentType<unknown>;
     /**
-     * Optional data to pass to the component. Inputs are available as input properties in the component.
+     * Specifies data to pass to the component. Inputs are available as input properties in the component.
      *
      * ```ts
      * @Component({...})
@@ -1190,42 +1361,6 @@ declare abstract class WorkbenchConfig {
      * Set to `false` to exclude all built-in menu items.
      */
     abstract viewMenuItems?: ViewMenuItemsConfig | false;
-    /**
-     * Configures startup of the SCION Workbench.
-     *
-     * The SCION Workbench starts automatically when the `<wb-workbench>` component is added to the DOM. Alternatively,
-     * the workbench can be started manually using {@link WorkbenchLauncher.launch}, such as in an app initializer or a route guard.
-     *
-     * The application can hook into the startup process of the SCION Workbench by providing one or more initializers to {@link provideWorkbenchInitializer}.
-     * Initializers execute at defined points during startup, enabling the application's controlled initialization. The workbench is fully started once
-     * all initializers have completed.
-     *
-     * The application can inject {@link WorkbenchStartup} to check if the workbench has completed startup.
-     */
-    abstract startup?: {
-        /**
-         * Controls when to start the SCION Workbench. Defaults to `LAZY`.
-         *
-         * - **LAZY**
-         *   Starts the workbench when the `<wb-workbench>` component is added to the DOM or manually via {@link WorkbenchLauncher#launch},
-         *   e.g., from a route guard or app initializer.
-         *
-         *  - **APP_INITIALIZER**
-         *   Starts the workbench during application bootstrapping, blocking Angular's app startup until the workbench is ready.
-         *   No splash is displayed.
-         *
-         * @deprecated since version 19.0.0-beta.3. To start the workbench in an app initializer, use Angular's `provideAppInitializer()` function: `provideAppInitializer(() => inject(WorkbenchLauncher).launch())`. Otherwise, no migration is necessary. No replacement. API will be removed in version 21.
-         */
-        launcher?: 'LAZY' | 'APP_INITIALIZER';
-        /**
-         * Specifies the component to display in `<wb-workbench>` while the workbench is starting.
-         *
-         * Note: No splash screen is displayed when using the app initializer strategy.
-         *
-         * @deprecated since version 19.0.0-beta.3. Property has been moved. Configure the splash in `WorkbenchConfig.splashComponent`. Property will be removed in version 21.
-         */
-        splash?: ComponentType<unknown>;
-    };
     /**
      * Configures microfrontend support in the workbench, allowing the integration of microfrontends as workbench views or
      * workbench popups.
@@ -1246,7 +1381,7 @@ declare abstract class WorkbenchConfig {
      * "SCION Microfrontend Platform DevTools".
      *
      * Typically, the host app provides API to integrated micro apps via the intent mechanism. Consider registering intent handlers
-     * under the DI token {@link MICROFRONTEND_PLATFORM_POST_STARTUP}.
+     * in an initializer function registered via {@link provideMicrofrontendPlatformInitializer}.
      */
     abstract microfrontendPlatform?: MicrofrontendPlatformConfig | Type<MicrofrontendPlatformConfigLoader>;
     /**
@@ -1387,20 +1522,6 @@ interface ViewMenuItemsConfig {
  * Configures a built-in menu item.
  */
 interface MenuItemConfig {
-    /**
-     * @deprecated since version 19.0.0-beta.2. Set to `false` in {@link ViewMenuItemsConfig} to exclude the menu item. API will be removed in version 21.
-     */
-    visible?: boolean;
-    /**
-     * Specifies the text of this menu item.
-     *
-     * Can be a string or a function that returns a string or a {@link Signal}.
-     *
-     * The function can call `inject` to get any required dependencies, or use `toSignal` to convert an observable to a signal.
-     *
-     * @deprecated since version 19.0.0-beta.3. Register a text provider to change or localize menu item texts. Register the text provider via workbench configuration passed to the `provideWorkbench` function. API will be removed in version 21.
-     */
-    text?: string | (() => string | Signal<string>);
     accelerator?: string[];
     group?: string;
     cssClass?: string | string[];
@@ -1514,7 +1635,7 @@ interface Disposable {
  */
 declare abstract class WorkbenchPart {
     /**
-     * Unique identity of this part.
+     * Identity of this part.
      */
     abstract readonly id: PartId;
     /**
@@ -1639,7 +1760,7 @@ interface WorkbenchPartNavigation {
  */
 declare abstract class WorkbenchView {
     /**
-     * Unique identity of this view.
+     * Identity of this view.
      *
      * @see alternativeId
      */
@@ -1659,24 +1780,6 @@ declare abstract class WorkbenchView {
      * A view can be navigated using {@link WorkbenchRouter#navigate} or {@link WorkbenchLayout#navigateView}.
      */
     abstract readonly navigation: Signal<WorkbenchViewNavigation | undefined>;
-    /**
-     * Hint passed to the navigation.
-     *
-     * @deprecated since version 19.0.0-beta.2. Use {@link navigation.hint} instead. API will be removed in version 21.
-     */
-    abstract readonly navigationHint: Signal<string | undefined>;
-    /**
-     * Data passed to the navigation.
-     *
-     * @deprecated since version 19.0.0-beta.2. Use {@link navigation.data} instead. API will be removed in version 21.
-     */
-    abstract readonly navigationData: Signal<NavigationData>;
-    /**
-     * State passed to the navigation.
-     *
-     * @deprecated since version 19.0.0-beta.2. Use {@link navigation.state} instead. API will be removed in version 21.
-     */
-    abstract readonly navigationState: Signal<NavigationState>;
     /**
      * Part which contains this view.
      *
@@ -1741,12 +1844,6 @@ declare abstract class WorkbenchView {
      * Menu items associated with this view.
      */
     abstract readonly menuItems: Signal<WorkbenchMenuItem[]>;
-    /**
-     * URL associated with this view.
-     *
-     * @deprecated since version 19.0.0-beta.2. Use {@link navigation.path} instead. API will be removed in version 21.
-     */
-    abstract readonly urlSegments: Signal<UrlSegment[]>;
     /**
      * Gets the activation instant of this view.
      */
@@ -1847,13 +1944,13 @@ interface WorkbenchViewNavigation {
 /**
  * Handle to interact with a dialog opened via {@link WorkbenchDialogService}.
  *
- * The dialog component can inject this handle to interact with the dialog, such as setting the title or closing the dialog.
+ * The dialog component can inject this handle to interact with the dialog.
  *
  * Dialog inputs are available as input properties in the dialog component.
  */
-declare abstract class WorkbenchDialog<R = unknown> {
+declare abstract class WorkbenchDialog {
     /**
-     * Unique identity of this dialog.
+     * Identity of this dialog.
      */
     abstract readonly id: DialogId;
     /**
@@ -1864,7 +1961,7 @@ declare abstract class WorkbenchDialog<R = unknown> {
     abstract get title(): Signal<Translatable | undefined>;
     abstract set title(title: Translatable | undefined);
     /**
-     * Specifies the preferred dialog size.
+     * Sets the preferred dialog size. Defaults to the content's intrinsic size, constrained by min and max size, if set.
      */
     abstract readonly size: WorkbenchDialogSize;
     /**
@@ -1898,23 +1995,27 @@ declare abstract class WorkbenchDialog<R = unknown> {
     /**
      * Closes the dialog. Optionally, pass a result or an error to the dialog opener.
      */
-    abstract close(result?: R | Error): void;
+    abstract close<R>(result?: R | Error): void;
 }
 /**
  * Represents the preferred dialog size.
  */
 interface WorkbenchDialogSize {
+    /**
+     * Specifies the height of the dialog, constrained by {@link minHeight} and {@link maxHeight}, if any.
+     */
+    get height(): Signal<string | undefined>;
+    set height(height: string | undefined);
+    /**
+     * Specifies the width of the dialog, constrained by {@link minWidth} and {@link maxWidth}, if any.
+     */
+    get width(): Signal<string | undefined>;
+    set width(width: string | undefined);
     /**
      * Specifies the minimum height of the dialog.
      */
     get minHeight(): Signal<string | undefined>;
     set minHeight(minHeight: string | undefined);
-    /**
-     * Specifies the height of the dialog, displaying a vertical scrollbar if its content overflows.
-     * If not specified, the dialog adapts its height to its context height, respecting any `minHeight' or `maxHeight' constraint.
-     */
-    get height(): Signal<string | undefined>;
-    set height(height: string | undefined);
     /**
      * Specifies the maximum height of the dialog.
      */
@@ -1925,12 +2026,6 @@ interface WorkbenchDialogSize {
      */
     get minWidth(): Signal<string | undefined>;
     set minWidth(minWidth: string | undefined);
-    /**
-     * Specifies the width of the dialog, displaying a horizontal scrollbar if its content overflows.
-     * If not specified, the dialog adapts its width to its context width, respecting any `minWidth' or `maxWidth' constraint.
-     */
-    get width(): Signal<string | undefined>;
-    set width(width: string | undefined);
     /**
      * Specifies the maximum width of the dialog.
      */
@@ -1939,250 +2034,99 @@ interface WorkbenchDialogSize {
 }
 
 /**
- * Represents a point on the page or view, optionally with a dimension, where a workbench popup should be attached.
+ * A popup is a visual workbench element for displaying content above other content. The popup is positioned relative
+ * to an anchor based on its preferred alignment. The anchor can be an element or a coordinate.
+ *
+ * The popup component can inject this handle to interact with the popup.
+ *
+ * Popup inputs are available as input properties in the popup component.
+ *
+ * @see WorkbenchPopupService
  */
-type PopupOrigin = (Point | TopLeftPoint | TopRightPoint | BottomLeftPoint | BottomRightPoint) & {
-    width?: number;
-    height?: number;
-};
+declare abstract class WorkbenchPopup {
+    /**
+     * Identity of this popup.
+     */
+    abstract readonly id: PopupId;
+    /**
+     * Sets the preferred popup size. Defaults to the content's intrinsic size, constrained by min and max size, if set.
+     */
+    abstract readonly size: WorkbenchPopupSize;
+    /**
+     * Specifies CSS class(es) to add to the popup, e.g., to locate the popup in tests.
+     */
+    abstract get cssClass(): Signal<string[]>;
+    abstract set cssClass(cssClass: string | string[]);
+    /**
+     * Indicates whether this popup has the focus.
+     */
+    abstract readonly focused: Signal<boolean>;
+    /**
+     * Sets a result that will be passed to the popup opener when the popup is closed on focus loss {@link CloseStrategy#onFocusLost}.
+     */
+    abstract setResult<R>(result?: R): void;
+    /**
+     * Closes the popup. Optionally, pass a result or an error to the popup opener.
+     */
+    abstract close<R>(result?: R | Error): void;
+}
 /**
- * Coordinate relative to the "x/y" corner of the view or page viewport.
+ * Represents the preferred size of a popup.
  */
-interface Point {
-    x: number;
-    y: number;
+interface WorkbenchPopupSize {
+    /**
+     * Specifies the height of the popup, constrained by {@link minHeight} and {@link maxHeight}, if any.
+     */
+    get height(): Signal<string | undefined>;
+    set height(height: string | undefined);
+    /**
+     * Specifies the width of the popup, constrained by {@link minWidth} and {@link maxWidth}, if any.
+     */
+    get width(): Signal<string | undefined>;
+    set width(width: string | undefined);
+    /**
+     * Specifies the minimum height of the popup.
+     */
+    get minHeight(): Signal<string | undefined>;
+    set minHeight(minHeight: string | undefined);
+    /**
+     * Specifies the maximum height of the popup.
+     */
+    get maxHeight(): Signal<string | undefined>;
+    set maxHeight(maxHeight: string | undefined);
+    /**
+     * Specifies the minimum width of the popup.
+     */
+    get minWidth(): Signal<string | undefined>;
+    set minWidth(minWidth: string | undefined);
+    /**
+     * Specifies the maximum width of the popup.
+     */
+    get maxWidth(): Signal<string | undefined>;
+    set maxWidth(maxWidth: string | undefined);
 }
+
 /**
- * Coordinate relative to the "top/left" corner of the view or page viewport.
+ * The signature of a function to confirm closing a view., e.g., if dirty.
  *
- * This is equivalent to passing a "x/y" coordinate as {@link Point}.
+ * The function can call `inject` to get dependencies.
  */
-interface TopLeftPoint {
-    top: number;
-    left: number;
-}
+type CanCloseFn = () => Observable<boolean> | Promise<boolean> | boolean;
 /**
- * Coordinate relative to the "top/right" corner of the view or page viewport.
+ * Reference to a `CanClose` guard registered on a view.
  */
-interface TopRightPoint {
-    top: number;
-    right: number;
+interface CanCloseRef {
+    /**
+     * Removes the `CanClose` guard from the view.
+     *
+     * Has no effect if another guard was registered in the meantime.
+     */
+    dispose(): void;
 }
 /**
- * Coordinate relative to the "bottom/left" corner of the view or page viewport.
- */
-interface BottomLeftPoint {
-    bottom: number;
-    left: number;
-}
-/**
- * Coordinate relative to the "bottom/right" corner of the view or page viewport.
- */
-interface BottomRightPoint {
-    bottom: number;
-    right: number;
-}
-
-/**
- * Controls the appearance and behavior of a popup.
- */
-declare abstract class PopupConfig {
-    /**
-     * Controls where to open the popup.
-     *
-     * Can be an HTML element or a coordinate. The coordinate is relative to the {@link context}, defaulting to the calling context.
-     *
-     * Supported coordinate pairs:
-     * - x/y: Relative to the top/left corner of the context.
-     * - top/left: Same as x/y.
-     * - top/right: Relative to the top/right corner of the context.
-     * - bottom/left: Relative to the bottom/left corner of the context.
-     * - bottom/right: Relative to the bottom/right corner of the context.
-     *
-     * Passing an Observable allows for updating the coordinate.
-     */
-    abstract readonly anchor: ElementRef<Element> | Element | PopupOrigin | Observable<PopupOrigin>;
-    /**
-     * Specifies the component to display in the popup.
-     *
-     * In the component, you can inject the popup handle {@link WorkbenchPopup} to interact with the popup, such as to close it
-     * or obtain its input data.
-     */
-    abstract readonly component: Type<any>;
-    /**
-     * Instructs Angular how to construct the component. In most cases, construct options need not to be set.
-     */
-    readonly componentConstructOptions?: {
-        /**
-         * Sets the injector for the instantiation of the popup component, giving you control over the objects available
-         * for injection into the popup component. If not specified, uses the application's root injector, or the view's
-         * injector if opened in the context of a view.
-         *
-         * ```ts
-         * Injector.create({
-         *   parent: ...,
-         *   providers: [
-         *    {provide: <DiToken>, useValue: <value>}
-         *   ],
-         * })
-         * ```
-         */
-        injector?: Injector;
-        /**
-         * Specifies providers to be registered with the popup injector. Unlike providers that are registered via a separate {@link injector},
-         * passed providers are registered in the same injector as the popup handle itself, allowing for dependency injection of the popup handle.
-         */
-        providers?: StaticProvider[];
-        /**
-         * Sets the component's attachment point in Angular's logical component tree (not the DOM tree used for rendering), effecting when
-         * Angular checks the component for changes during a change detection cycle. If not set, inserts the component at the top level
-         * in the component tree.
-         */
-        viewContainerRef?: ViewContainerRef;
-    };
-    /**
-     * Hint where to align the popup relative to the popup anchor, unless there is not enough space available in that area. By default,
-     * if not specified, the popup opens north of the anchor.
-     */
-    readonly align?: 'east' | 'west' | 'north' | 'south';
-    /**
-     * Optional data to pass to the popup component. In the component, you can inject the popup handle {@link WorkbenchPopup} to read input data.
-     */
-    readonly input?: any;
-    /**
-     * Controls when to close the popup.
-     */
-    readonly closeStrategy?: CloseStrategy;
-    /**
-     * Specifies the preferred popup size. If not specified, the popup adjusts its size to the content size.
-     */
-    readonly size?: PopupSize;
-    /**
-     * Specifies CSS class(es) to add to the popup, e.g., to locate the popup in tests.
-     */
-    readonly cssClass?: string | string[];
-    /**
-     * Binds the popup to a context (e.g., a part or view). Defaults to the calling context.
-     *
-     * The popup is displayed only if the context is visible and closes when the context is disposed.
-     *
-     * Set to `null` to open the popup outside a context.
-     */
-    abstract context?: ViewId | PartId | DialogId | PopupId | Context$2 | null;
-}
-/**
- * Specifies when to close the popup.
- */
-interface CloseStrategy {
-    /**
-     * Controls if to close the popup on focus loss, returning the result set via {@link WorkbenchPopup#setResult} to the popup opener.
-     * Defaults to `true`.
-     */
-    onFocusLost?: boolean;
-    /**
-     * Controls if to close the popup when pressing escape. Defaults to `true`.
-     * No return value will be passed to the popup opener.
-     */
-    onEscape?: boolean;
-}
-/**
- * Represents the preferred popup size as specified by the popup opener.
- */
-interface PopupSize {
-    /**
-     * Specifies the min-height of the popup.
-     */
-    minHeight?: string;
-    /**
-     * Specifies the height of the popup.
-     */
-    height?: string;
-    /**
-     * Specifies the max-height of the popup.
-     */
-    maxHeight?: string;
-    /**
-     * Specifies the min-width of the popup.
-     */
-    minWidth?: string;
-    /**
-     * Specifies the width of the popup.
-     */
-    width?: string;
-    /**
-     * Specifies the max-width of the popup.
-     */
-    maxWidth?: string;
-}
-/**
- * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
- */
-interface Context$2 {
-    /**
-     * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
-     */
-    viewId?: ViewId | null;
-}
-
-/**
- * Handle to interact with a popup opened via {@link WorkbenchPopupService}.
- *
- * The popup component can inject this handle to interact with the popup.
- *
- * Popup inputs are available via {@link WorkbenchPopup.input} property.
- */
-declare abstract class WorkbenchPopup<T = unknown, R = unknown> {
-    /**
-     * Unique identity of this popup.
-     */
-    abstract readonly id: PopupId;
-    /**
-     * Input data as passed by the popup opener when opened the popup, or `undefined` if not passed.
-     */
-    abstract readonly input: T | undefined;
-    /**
-     * Preferred popup size as specified by the popup opener, or `undefined` if not set.
-     */
-    abstract readonly size: PopupSize | undefined;
-    /**
-     * CSS classes associated with the popup.
-     */
-    abstract readonly cssClasses: string[];
-    /**
-     * Indicates whether this popup has the focus.
-     */
-    abstract readonly focused: Signal<boolean>;
-    /**
-     * Sets a result that will be passed to the popup opener when the popup is closed on focus loss {@link CloseStrategy#onFocusLost}.
-     */
-    abstract setResult(result?: R): void;
-    /**
-     * Closes the popup. Optionally, pass a result or an error to the popup opener.
-     */
-    abstract close(result?: R | Error): void;
-}
-
-/**
- * The signature of a function to confirm closing a view., e.g., if dirty.
- *
- * The function can call `inject` to get dependencies.
- */
-type CanCloseFn = () => Observable<boolean> | Promise<boolean> | boolean;
-/**
- * Reference to a `CanClose` guard registered on a view.
- */
-interface CanCloseRef {
-    /**
-     * Removes the `CanClose` guard from the view.
-     *
-     * Has no effect if another guard was registered in the meantime.
-     */
-    dispose(): void;
-}
-/**
- * Represents an action of a {@link WorkbenchPart}.
- *
- * Part actions are displayed in the part bar, enabling interaction with the part and its content. Actions can be aligned to the left or right.
+ * Represents an action of a {@link WorkbenchPart}.
+ *
+ * Part actions are displayed in the part bar, enabling interaction with the part and its content. Actions can be aligned to the left or right.
  */
 interface WorkbenchPartAction {
     /**
@@ -2194,7 +2138,7 @@ interface WorkbenchPartAction {
      */
     content: ComponentType<unknown> | TemplateRef<unknown>;
     /**
-     * Optional data to pass to the component or template.
+     * Specifies data to pass to the component or template.
      *
      * If using a component, inputs are available as input properties.
      *
@@ -2253,7 +2197,7 @@ interface WorkbenchMenuItem {
      */
     content: ComponentType<unknown> | TemplateRef<unknown>;
     /**
-     * Optional data to pass to the component or template.
+     * Specifies data to pass to the component or template.
      *
      * If using a component, inputs are available as input properties.
      *
@@ -2334,21 +2278,6 @@ type WorkbenchPartActionFn = (part: WorkbenchPart) => WorkbenchPartAction | Comp
  *   Use Angular's `untracked` function to execute code outside this reactive context.
  */
 type WorkbenchViewMenuItemFn = (view: WorkbenchView) => WorkbenchMenuItem | null;
-/**
- * Information about a workbench theme.
- *
- * @deprecated since version 19.0.0-beta.3. Read the theme from `WorkbenchService.settings.theme` signal, and the color scheme from 'getComputedStyle(inject(DOCUMENT).documentElement).colorScheme'. API will be removed in version 21.
- */
-interface WorkbenchTheme {
-    /**
-     * The name of the theme.
-     */
-    name: string;
-    /**
-     * The color scheme of the theme.
-     */
-    colorScheme: 'light' | 'dark';
-}
 /**
  * Union of workbench elements.
  */
@@ -2514,19 +2443,6 @@ declare abstract class WorkbenchService {
      * @return handle to unregister the menu item.
      */
     abstract registerViewMenuItem(fn: WorkbenchViewMenuItemFn): Disposable;
-    /**
-     * Switches the theme of the workbench.
-     *
-     * Themes can be registered when loading the `@scion/workbench` SCSS module in the application's `styles.scss` file.
-     * By default, SCION provides a light and a dark theme, `scion-light` and `scion-dark`.
-     *
-     * See the documentation of `@scion/workbench` SCSS module for more information.
-     *
-     * @param theme - The name of the theme to switch to.
-     *
-     * @deprecated since version 19.0.0-beta.3. Switch theme using `WorkbenchService.settings.theme` signal. API will be removed in version 21.
-     */
-    abstract switchTheme(theme: string): Promise<void>;
     /**
      * Defines settings to adapt the workbench to personal preferences and working styles.
      *
@@ -2558,12 +2474,6 @@ declare abstract class WorkbenchService {
      * Provides the focused workbench element, or `null` if the focus is on a DOM element outside any workbench element.
      */
     abstract readonly activeElement: Signal<WorkbenchElement | null>;
-    /**
-     * Provides the current workbench theme, if any.
-     *
-     * @deprecated since version 19.0.0-beta.3. Read the theme from `WorkbenchService.settings.theme` signal, and the color scheme from 'getComputedStyle(inject(DOCUMENT).documentElement).colorScheme'. API will be removed in version 21.
-     */
-    abstract readonly theme: Signal<WorkbenchTheme | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchService>;
 }
@@ -2584,22 +2494,6 @@ declare abstract class WorkbenchStartup {
      * After startup, the workbench layout is available.
      */
     abstract readonly whenDone: Promise<void>;
-    /**
-     * Indicates whether the workbench has completed startup.
-     *
-     * After startup, the workbench layout is available.
-     *
-     * @deprecated since version 19.0.0-beta.3. Use `WorkbenchStartup.done` instead. API will be removed in version 21.
-     */
-    abstract readonly isStarted: Signal<boolean>;
-    /**
-     * Resolves when the workbench completes startup.
-     *
-     * After startup, the workbench layout is available.
-     *
-     * @deprecated since version 19.0.0-beta.3. Use `WorkbenchStartup.whenDone` instead. API will be removed in version 21.
-     */
-    abstract readonly whenStarted: Promise<true>;
     static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchStartup, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchStartup>;
 }
@@ -2624,15 +2518,6 @@ interface MPartGrid {
      */
     referencePartId?: PartId;
 }
-/**
- * {@link MPartGrid} with additional fields not serialized into the URL.
- */
-interface ɵMPartGrid extends MPartGrid {
-    /**
-     * Indicates if this grid was migrated from an older version.
-     */
-    migrated?: true;
-}
 /**
  * Represents a node in the grid.
  *
@@ -2724,7 +2609,7 @@ interface MView {
 /**
  * Grids referenced in the workbench layout.
  */
-interface WorkbenchGrids<T = ɵMPartGrid> {
+interface WorkbenchGrids<T = MPartGrid> {
     /**
      * Reference to the "root" grid of the workbench layout.
      */
@@ -3710,6 +3595,10 @@ interface PortalOptions {
      * Providers registered with the injector for the instantiation of the component.
      */
     providers?: Provider[];
+    /**
+     * Optional name used in portal lifecycle logs.
+     */
+    debugName?: string;
 }
 /**
  * Lifecycle hook for the component rendered by {@link WbComponentPortal} after attached to the DOM.
@@ -4136,7 +4025,6 @@ declare class DesktopSlotComponent implements OnAttach, OnDetach {
     private readonly _host;
     private readonly _document;
     private readonly _viewport;
-    private readonly _logger;
     private _scrollTop;
     private _scrollLeft;
     private _activeElementBeforeDetach;
@@ -4149,7 +4037,6 @@ declare class DesktopSlotComponent implements OnAttach, OnDetach {
      * Method invoked before detaching this component from the DOM.
      */
     onDetach(): void;
-    protected onLegacyDesktopActivate(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DesktopSlotComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DesktopSlotComponent, "wb-desktop-slot", never, {}, {}, never, never, true, never>;
 }
@@ -4194,7 +4081,7 @@ declare class MainAreaPartComponent {
     private readonly _layout;
     private readonly _viewDragService;
     protected readonly part: ɵWorkbenchPart;
-    protected readonly mainAreaGrid: i0.Signal<ɵMPartGrid>;
+    protected readonly mainAreaGrid: i0.Signal<MPartGrid>;
     protected readonly desktop: WorkbenchDesktop;
     protected readonly dasherize: typeof dasherize;
     protected readonly canDrop: i0.Signal<boolean>;
@@ -4221,7 +4108,6 @@ declare class PartComponent implements OnInit {
      * Constructs view components of inactive views, so they can initialize, e.g., to set the view tab title.
      */
     private constructInactiveViewComponents;
-    private addHostCssClasses;
     private installComponentLifecycleLogger;
     static ɵfac: i0.ɵɵFactoryDeclaration<PartComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PartComponent, "wb-part", never, {}, {}, never, never, true, never>;
@@ -4232,9 +4118,9 @@ declare class PartComponent implements OnInit {
  */
 interface WorkbenchDialogOptions {
     /**
-     * Optional data to pass to the dialog component. Inputs are available as input properties in the dialog component.
+     * Specifies data to pass to the dialog component. Inputs are available as input properties in the dialog component.
      *
-     * **Example:**
+     * @example - Reading inputs in the component
      * ```ts
      * public someInput = input.required<string>();
      * ```
@@ -4253,20 +4139,19 @@ interface WorkbenchDialogOptions {
      */
     modality?: 'none' | 'context' | 'application' | ViewModality$1;
     /**
-     * Binds the dialog to a context (e.g., a part or view). Defaults to the calling context.
+     * Binds the dialog to a context (e.g., part or view). Defaults to the calling context.
      *
      * The dialog is displayed only if the context is visible and closes when the context is disposed.
      * The dialog is opened in the center of its context, if any, unless opened from the peripheral area.
      *
      * Set to `null` to open the dialog outside a context.
      */
-    context?: ViewId | PartId | DialogId | PopupId | Context$1 | null;
+    context?: ViewId | PartId | DialogId | PopupId | Context$3 | null;
     /**
-     * Sets the injector for the instantiation of the dialog component, giving control over the objects available
-     * for injection into the dialog component. If not specified, uses the application's root injector, or the view's
-     * injector if opened in the context of a view.
+     * Specifies the injector for the instantiation of the dialog, giving control over the objects available
+     * for injection in the dialog component. Defaults to the application's root injector.
      *
-     * **Example:**
+     * @example - Creating an injector with a DI token
      * ```ts
      * Injector.create({
      *   parent: ...,
@@ -4277,6 +4162,12 @@ interface WorkbenchDialogOptions {
      * ```
      */
     injector?: Injector;
+    /**
+     * Specifies providers available for injection in the dialog component.
+     *
+     * Providers can inject {@link WorkbenchDialog} to interact with the dialog.
+     */
+    providers?: Provider[];
     /**
      * Specifies CSS class(es) to add to the dialog, e.g., to locate the dialog in tests.
      */
@@ -4293,7 +4184,7 @@ type ViewModality$1 = 'view';
 /**
  * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
  */
-interface Context$1 {
+interface Context$3 {
     /**
      * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
      */
@@ -4403,7 +4294,7 @@ interface WorkbenchInvocationContext {
 }
 
 /** @inheritDoc */
-declare class ɵWorkbenchDialog<R = unknown> implements WorkbenchDialog<R>, Blockable, Blocking {
+declare class ɵWorkbenchDialog implements WorkbenchDialog, Blockable, Blocking {
     id: DialogId;
     component: ComponentType<unknown>;
     invocationContext: WorkbenchInvocationContext | null;
@@ -4439,9 +4330,9 @@ declare class ɵWorkbenchDialog<R = unknown> implements WorkbenchDialog<R>, Bloc
     /**
      * Waits for the dialog to close, resolving to its result or rejecting if closed with an error.
      */
-    waitForClose(): Promise<R | undefined>;
+    waitForClose<R>(): Promise<R | undefined>;
     /** @inheritDoc */
-    close(result?: R | Error): void;
+    close<R>(result?: R | Error): void;
     /**
      * Inputs passed to the dialog.
      */
@@ -4638,7 +4529,6 @@ declare class ViewSlotComponent implements OnAttach, OnDetach {
      */
     onDetach(): void;
     private installMenuAccelerators;
-    private addHostCssClasses;
     /**
      * Unsets the active workbench element if this view was the focused element when its part is deactivated,
      * such as when closing the activity containing this view. Otherwise, the active element would not be unset.
@@ -4663,18 +4553,13 @@ declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     private readonly _viewDragService;
     private readonly _focusMonitor;
     private readonly _logger;
-    private readonly _adapters;
     private readonly _title;
     private readonly _heading;
     private readonly _dirty;
     private readonly _closable;
     private readonly _scrolledIntoView;
-    alternativeId: string | undefined;
+    readonly alternativeId: string | undefined;
     readonly navigation: i0.WritableSignal<WorkbenchViewNavigation | undefined>;
-    readonly navigationHint: Signal<string | undefined>;
-    readonly navigationData: Signal<_scion_workbench.NavigationData>;
-    readonly navigationState: Signal<_scion_workbench.NavigationState>;
-    readonly urlSegments: Signal<_angular_router.UrlSegment[]>;
     readonly position: Signal<number>;
     readonly first: Signal<boolean>;
     readonly last: Signal<boolean>;
@@ -4751,20 +4636,6 @@ declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     }): void;
     /** @inheritDoc */
     canClose(canClose: CanCloseFn): CanCloseRef;
-    /**
-     * Registers an adapter for this view, replacing any previously registered adapter of the same type.
-     *
-     * Adapters enable loosely coupled extension of an object, allowing one object to be adapted to another.
-     */
-    registerAdapter<T>(adapterType: AbstractType<T> | Type<T>, object: T): void;
-    /**
-     * Unregisters the given adapter. Has no effect if not registered.
-     */
-    unregisterAdapter(adapterType: AbstractType<unknown> | Type<unknown>): void;
-    /**
-     * Adapts this object to the specified type. Returns `null` if no such object can be found.
-     */
-    adapt<T>(adapterType: AbstractType<T> | Type<T>): T | null;
     get destroyed(): Signal<boolean>;
     /**
      * Computes menu items matching this view.
@@ -4843,39 +4714,230 @@ declare class ɵWorkbenchPerspective implements WorkbenchPerspective {
     destroy(): void;
 }
 
-/** @inheritDoc */
-declare class ɵWorkbenchPopup<T = unknown, R = unknown> implements WorkbenchPopup<T, R>, Blockable {
-    id: PopupId;
-    invocationContext: WorkbenchInvocationContext | null;
-    private _config;
-    /** Injector for the popup; destroyed when the popup is closed. */
-    readonly injector: DestroyableInjector;
-    private readonly _overlayRef;
-    private readonly _focusMonitor;
-    private readonly _portal;
-    private readonly _componentRef;
-    private readonly _popupOrigin;
-    readonly cssClasses: string[];
-    readonly focused: Signal<boolean>;
-    readonly attached: Signal<boolean>;
-    readonly destroyed: i0.WritableSignal<boolean>;
-    readonly bounds: Signal<DOMRect | undefined>;
-    readonly blockedBy: Signal<ɵWorkbenchDialog | null>;
-    result: R | Error | undefined;
-    constructor(id: PopupId, invocationContext: WorkbenchInvocationContext | null, _config: PopupConfig);
+/**
+ * Represents a point on the page or view, optionally with a dimension, where a workbench popup should be attached.
+ */
+type PopupOrigin = (Point | TopLeftPoint | TopRightPoint | BottomLeftPoint | BottomRightPoint) & {
+    width?: number;
+    height?: number;
     /**
-     * Waits for the popup to close, resolving to its result or rejecting if closed with an error.
+     * Specifies if the coordinate is relative to the context (e.g., part or view) or page viewport. Defaults to `context`.
+     *
+     * If relative to the viewport and bound to a context, the popup is still constrained by the context's bounds.
      */
-    waitForClose(): Promise<R | undefined>;
+    relativeTo?: 'context' | 'viewport';
+};
+/**
+ * Coordinate relative to the "x/y" corner of the view or page viewport.
+ */
+interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Coordinate relative to the "top/left" corner of the view or page viewport.
+ *
+ * This is equivalent to passing a "x/y" coordinate as {@link Point}.
+ */
+interface TopLeftPoint {
+    top: number;
+    left: number;
+}
+/**
+ * Coordinate relative to the "top/right" corner of the view or page viewport.
+ */
+interface TopRightPoint {
+    top: number;
+    right: number;
+}
+/**
+ * Coordinate relative to the "bottom/left" corner of the view or page viewport.
+ */
+interface BottomLeftPoint {
+    bottom: number;
+    left: number;
+}
+/**
+ * Coordinate relative to the "bottom/right" corner of the view or page viewport.
+ */
+interface BottomRightPoint {
+    bottom: number;
+    right: number;
+}
+
+/**
+ * Controls the appearance and behavior of a popup.
+ */
+interface WorkbenchPopupOptions {
+    /**
+     * Controls where to open the popup.
+     *
+     * Can be an HTML element or a coordinate. The coordinate is relative to the {@link context}, defaulting to the calling context.
+     *
+     * Supported coordinate pairs:
+     * - x/y: Relative to the top/left corner of the context.
+     * - top/left: Same as x/y.
+     * - top/right: Relative to the top/right corner of the context.
+     * - bottom/left: Relative to the bottom/left corner of the context.
+     * - bottom/right: Relative to the bottom/right corner of the context.
+     *
+     * Passing an Observable allows for updating the coordinate.
+     */
+    anchor: ElementRef<Element> | Element | PopupOrigin | Observable<PopupOrigin>;
+    /**
+     * Controls where to align the popup relative to the popup anchor, unless there is not enough space available in that area. Defaults to `north`.
+     */
+    align?: 'east' | 'west' | 'north' | 'south';
+    /**
+     * Specifies data to pass to the popup component. Inputs are available as input properties in the popup component.
+     *
+     * @example - Reading inputs in the component
+     * ```ts
+     * public someInput = input.required<string>();
+     * ```
+     */
+    inputs?: {
+        [name: string]: unknown;
+    };
+    /**
+     * Controls when to close the popup.
+     */
+    closeStrategy?: CloseStrategy$1;
+    /**
+     * Specifies the preferred popup size. Defaults to the content's intrinsic size, constrained by min and max size, if set.
+     *
+     * @deprecated since version 21.0.0-beta.1. Popup size should be set by the popup component. To migrate, inject `WorkbenchPopup` into the popup component and set the size via the `WorkbenchPopup.size` property. Marked for removal in version 22.
+     */
+    size?: {
+        minHeight?: string;
+        height?: string;
+        maxHeight?: string;
+        minWidth?: string;
+        width?: string;
+        maxWidth?: string;
+    };
+    /**
+     * Specifies CSS class(es) to add to the popup, e.g., to locate the popup in tests.
+     */
+    cssClass?: string | string[];
+    /**
+     * Binds the popup to a context (e.g., part or view). Defaults to the calling context.
+     *
+     * The popup is displayed only if the context is visible and closes when the context is disposed.
+     *
+     * Set to `null` to open the popup outside a context.
+     */
+    context?: ViewId | PartId | DialogId | PopupId | Context$2 | null;
+    /**
+     * Specifies the injector for the instantiation of the popup, giving control over the objects available
+     * for injection in the popup component. Defaults to the application's root injector.
+     *
+     * @example - Creating an injector with a DI token
+     * ```ts
+     * Injector.create({
+     *   parent: ...,
+     *   providers: [
+     *    {provide: <TOKEN>, useValue: <VALUE>}
+     *   ],
+     * })
+     * ```
+     */
+    injector?: Injector;
+    /**
+     * Specifies providers available for injection in the popup component.
+     *
+     * Providers can inject {@link WorkbenchPopup} to interact with the popup.
+     */
+    providers?: Provider[];
+}
+/**
+ * Specifies when to close the popup.
+ */
+interface CloseStrategy$1 {
+    /**
+     * Controls if to close the popup on focus loss, returning the result set via {@link WorkbenchPopup#setResult} to the popup opener.
+     * Defaults to `true`.
+     */
+    onFocusLost?: boolean;
+    /**
+     * Controls if to close the popup when pressing escape. Defaults to `true`.
+     *
+     * No return value will be returned to the popup opener.
+     */
+    onEscape?: boolean;
+}
+/**
+ * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
+ */
+interface Context$2 {
+    /**
+     * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
+     */
+    viewId?: ViewId | null;
+}
+
+/**
+ * A popup is a visual workbench element for displaying content above other content. The popup is positioned relative
+ * to an anchor based on its preferred alignment. The anchor can be an element or a coordinate.
+ *
+ * The popup component can inject this handle to interact with the popup.
+ *
+ * Popup inputs are available as input properties in the popup component.
+ *
+ * @see WorkbenchPopupService
+ *
+ * @deprecated since version 21.0.0-beta.1. Replaced by `WorkbenchPopup`. Marked for removal in version 22.
+ */
+declare abstract class Popup<T = unknown, R = unknown> extends WorkbenchPopup {
+    /**
+     * Input data as passed by the popup opener when opened the popup, or `undefined` if not passed.
+     *
+     * @deprecated since version 21.0.0-beta.1. Use `WorkbenchPopupService` to open popups. Inputs are available as input properties in the popup component. Marked for removal in version 22.
+     */
+    abstract readonly input: T | undefined;
+    /**
+     * CSS classes associated with the popup.
+     *
+     * @deprecated since version 21.0.0-beta.1. Use `WorkbenchPopup.cssClass` instead. Marked for removal in version 22.
+     */
+    abstract readonly cssClasses: string[];
+}
+
+/** @inheritDoc */
+declare class ɵWorkbenchPopup implements Popup, WorkbenchPopup, Blockable {
+    id: PopupId;
+    component: ComponentType<unknown>;
+    invocationContext: WorkbenchInvocationContext | null;
+    private _options;
+    /** Injector for the popup; destroyed when the popup is closed. */
+    readonly injector: DestroyableInjector;
+    private readonly _overlayRef;
+    private readonly _focusMonitor;
+    private readonly _portal;
+    private readonly _componentRef;
+    private readonly _popupOrigin;
+    private readonly _cssClass;
+    readonly size: WorkbenchPopupSize;
+    readonly focused: Signal<boolean>;
+    readonly attached: Signal<boolean>;
+    readonly destroyed: WritableSignal<boolean>;
+    readonly bounds: Signal<DOMRect | undefined>;
+    readonly blockedBy: Signal<ɵWorkbenchDialog | null>;
+    readonly input: unknown | undefined;
+    result: unknown | Error | undefined;
+    constructor(id: PopupId, component: ComponentType<unknown>, invocationContext: WorkbenchInvocationContext | null, _options: WorkbenchPopupOptions);
+    /**
+     * Waits for the popup to close, resolving to its result or rejecting if closed with an error.
+     */
+    waitForClose<R>(): Promise<R | undefined>;
     /**
-     * Creates a portal to render {@link PopupComponent} in the popup's injection context.
+     * Creates a portal to render {@link WorkbenchPopupComponent} in the popup's injection context.
      */
     private createPortal;
     /**
      * Creates a dedicated overlay per popup to place it on top of previously created overlays, such as dialogs, popups, dropdowns, etc.
      */
     private createOverlay;
-    private focus;
     /**
      * Moves the popup with the anchor.
      */
@@ -4909,15 +4971,21 @@ declare class ɵWorkbenchPopup<T = unknown, R = unknown> implements WorkbenchPop
      */
     private trackPopupOrigin;
     /** @inheritDoc */
-    setResult(result?: R): void;
+    setResult<R>(result?: R): void;
     /** @inheritDoc */
-    close(result?: R | Error): void;
+    close<R>(result?: R | Error): void;
     /** @inheritDoc */
-    get input(): T | undefined;
+    get cssClass(): Signal<string[]>;
     /** @inheritDoc */
-    get size(): PopupSize | undefined;
-    get component(): Type<any>;
-    get viewContainerRef(): ViewContainerRef | undefined;
+    set cssClass(cssClass: string | string[]);
+    set cssClasses(cssClasses: string[]);
+    get cssClasses(): string[];
+    /**
+     * Inputs passed to the popup.
+     */
+    get inputs(): {
+        [name: string]: unknown;
+    } | undefined;
     /**
      * Destroys this popup and associated resources.
      */
@@ -4934,15 +5002,14 @@ declare class ɵWorkbenchService implements WorkbenchService {
     private readonly _partActionRegistry;
     private readonly _viewMenuItemRegistry;
     private readonly _perspectiveService;
-    readonly layout: Signal<ɵWorkbenchLayout>;
-    readonly perspectives: Signal<ɵWorkbenchPerspective[]>;
-    readonly parts: Signal<ɵWorkbenchPart[]>;
-    readonly views: Signal<ɵWorkbenchView[]>;
-    readonly dialogs: Signal<ɵWorkbenchDialog<unknown>[]>;
-    readonly popups: Signal<ɵWorkbenchPopup<unknown, unknown>[]>;
-    readonly activePerspective: Signal<ɵWorkbenchPerspective | undefined>;
-    readonly activeElement: Signal<_scion_workbench.WorkbenchElement | null>;
-    readonly theme: Signal<WorkbenchTheme | null>;
+    readonly layout: i0.Signal<ɵWorkbenchLayout>;
+    readonly perspectives: i0.Signal<ɵWorkbenchPerspective[]>;
+    readonly parts: i0.Signal<ɵWorkbenchPart[]>;
+    readonly views: i0.Signal<ɵWorkbenchView[]>;
+    readonly dialogs: i0.Signal<ɵWorkbenchDialog[]>;
+    readonly popups: i0.Signal<ɵWorkbenchPopup[]>;
+    readonly activePerspective: i0.Signal<ɵWorkbenchPerspective | undefined>;
+    readonly activeElement: i0.Signal<_scion_workbench.WorkbenchElement | null>;
     readonly settings: {
         theme: i0.WritableSignal<string | null>;
         panelAlignment: i0.WritableSignal<"justify">;
@@ -4970,9 +5037,6 @@ declare class ɵWorkbenchService implements WorkbenchService {
     registerPartAction(fn: WorkbenchPartActionFn): Disposable;
     /** @inheritDoc */
     registerViewMenuItem(fn: WorkbenchViewMenuItemFn): Disposable;
-    /** @inheritDoc */
-    switchTheme(theme: string): Promise<void>;
-    private computeLegacyThemeObject;
     static ɵfac: i0.ɵɵFactoryDeclaration<ɵWorkbenchService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ɵWorkbenchService>;
 }
@@ -4981,15 +5045,15 @@ declare class ɵWorkbenchService implements WorkbenchService {
  * Main entry point component of the SCION Workbench.
  */
 declare class WorkbenchComponent {
-    private _workbenchLauncher;
-    private _logger;
+    private readonly _workbenchLauncher;
+    private readonly _logger;
     private readonly _workbenchRouter;
-    private _iframeOverlayHost;
-    private _viewDropZoneOverlayHost;
+    private readonly _iframeOverlayHost;
+    private readonly _viewDropZoneOverlayHost;
     /** Splash to display during workbench startup. */
-    protected splash: _angular_cdk_portal.ComponentType<unknown>;
-    protected workbenchStartup: WorkbenchStartup;
-    protected workbenchService: ɵWorkbenchService;
+    protected readonly splash: _angular_cdk_portal.ComponentType<unknown>;
+    protected readonly workbenchStartup: WorkbenchStartup;
+    protected readonly workbenchService: ɵWorkbenchService;
     constructor();
     /**
      * Toggles layout maximization by pressing Ctrl+Shift+F12.
@@ -5204,6 +5268,16 @@ declare class WorkbenchPartActionDirective {
     static ɵdir: i0.ɵɵDirectiveDeclaration<WorkbenchPartActionDirective, "ng-template[wbPartAction]", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "canMatch": { "alias": "canMatch"; "required": false; "isSignal": true; }; "cssClass": { "alias": "cssClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * DI token to register providers available for DI if in the context of a workbench part.
+ */
+declare const WORKBENCH_PART_CONTEXT: InjectionToken<Provider[]>;
+
+/**
+ * DI token to register providers available for DI if in the context of a workbench view.
+ */
+declare const WORKBENCH_VIEW_CONTEXT: InjectionToken<Provider[]>;
+
 /**
  * Enables navigation of workbench views and modification of the workbench layout.
  *
@@ -5334,16 +5408,6 @@ declare const WorkbenchRouteData: {
      * Property to associate CSS class(es) with a workbench element in {@link Route.data}, e.g., to locate it in tests.
      */
     readonly cssClass: "ɵworkbenchCssClass";
-    /**
-     * @internal
-     *
-     * Property to obtain the outlet name of the route. This property is only set on the top-level route.
-     *
-     * Use if the route's injection context is not available, e.g., in a {@link UrlMatcher}.
-     * Otherwise, the outlet can be injected using the {@link WORKBENCH_AUXILIARY_ROUTE_OUTLET} DI token,
-     * even in child routes, e.g., in guards.
-     */
-    readonly ɵoutlet: "ɵworkbenchOutlet";
 };
 
 /**
@@ -5354,12 +5418,16 @@ declare const WorkbenchRouteData: {
  *
  * Example for navigating a view to the 'SearchComponent':
  * ```ts
- * // Navigation
+ * import {WorkbenchRouter} from '@scion/workbench';
+ *
  * inject(WorkbenchRouter).navigate([], {hint: 'search'});
  * ```
  *
- * // Routes
+ * Routes:
  * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchView} from '@scion/workbench';
+ *
  * const routes: Routes = [
  *   {path: '', canMatch: [canMatchWorkbenchView('search')], component: SearchComponent},
  *   {path: '', canMatch: [canMatchWorkbenchView('outline')], component: OutlineComponent},
@@ -5381,13 +5449,18 @@ declare function canMatchWorkbenchView(canMatch: boolean): CanMatchFn;
  *
  * Example for navigating a part to the 'SearchComponent':
  * ```ts
+ * import {WorkbenchRouter} from '@scion/workbench';
+ *
  * inject(WorkbenchRouter).navigate(layout => {
  *   return layout.navigatePart('search', [], {hint: 'search'});
  * });
  * ```
  *
- * // Routes
+ * Routes:
  * ```ts
+ * import {Routes} from '@angular/router';
+ * import {canMatchWorkbenchPart} from '@scion/workbench';
+ *
  * const routes: Routes = [
  *   {path: '', canMatch: [canMatchWorkbenchPart('search')], component: SearchComponent},
  *   {path: '', canMatch: [canMatchWorkbenchPart('outline')], component: OutlineComponent},
@@ -5500,23 +5573,24 @@ interface WorkbenchMessageBoxOptions {
      */
     modality?: 'none' | 'context' | 'application' | ViewModality;
     /**
-     * Binds the message box to a context (e.g., a part or view). Defaults to the calling context.
+     * Binds the message box to a context (e.g., part or view). Defaults to the calling context.
      *
      * The message box is displayed only if the context is visible and closes when the context is disposed.
      * The message box is opened in the center of its context, if any, unless opened from the peripheral area.
      *
      * Set to `null` to open the message box outside a context.
      */
-    context?: ViewId | PartId | DialogId | PopupId | Context | null;
+    context?: ViewId | PartId | DialogId | PopupId | Context$1 | null;
     /**
      * Specifies if the user can select text displayed in the message box. Defaults to `false`.
      */
     contentSelectable?: boolean;
     /**
-     * Specifies data available as input properties in the message component.
+     * Specifies data to pass to the message component. Inputs are available as input properties in the message component.
      *
-     * This property only applies to a message box opened with a component, not a plain text message.
+     * Has no effect if opening a plain text message.
      *
+     * @example - Reading inputs in the component
      * ```ts
      * public someInput = input.required<string>();
      * ```
@@ -5525,12 +5599,10 @@ interface WorkbenchMessageBoxOptions {
         [name: string]: unknown;
     };
     /**
-     * Specifies the injector for the instantiation of the message component.
-     *
-     * This property only applies to a message box opened with a component, not a plain text message.
+     * Specifies the injector for the instantiation of the message box, giving control over the objects available
+     * for injection in the message component. Defaults to the application's root injector.
      *
-     * A custom injector gives control over the objects available for injection into the message component. If not specified, uses the
-     * application's root injector, or the view's injector if opened in the context of a view.
+     * @example - Creating an injector with a DI token
      *
      * ```ts
      * Injector.create({
@@ -5542,6 +5614,12 @@ interface WorkbenchMessageBoxOptions {
      * ```
      */
     injector?: Injector;
+    /**
+     * Specifies providers available for injection in the message component.
+     *
+     * Providers can inject {@link WorkbenchMessageBox} to interact with the message.
+     */
+    providers?: Provider[];
     /**
      * Specifies CSS class(es) to add to the message box, e.g., to locate the message box in tests.
      */
@@ -5554,7 +5632,7 @@ type ViewModality = 'view';
 /**
  * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
  */
-interface Context {
+interface Context$1 {
     /**
      * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
      */
@@ -5573,7 +5651,7 @@ interface Context {
  * application-modal blocks the workbench or browser viewport, based on {@link WorkbenchConfig.dialog.modalityScope}.
  *
  * ## Context
- * A message box can be bound to a context (e.g., a part or view), defaulting to the calling context.
+ * A message box can be bound to a context (e.g., part or view), defaulting to the calling context.
  * The message box is displayed only if the context is visible and closes when the context is disposed.
  *
  * ## Positioning
@@ -5622,8 +5700,9 @@ declare abstract class WorkbenchMessageBoxService {
      *
      * By default, the message box is modal to the calling context. Specify a different modality in {@link WorkbenchMessageBoxOptions.modality}.
      *
-     * Data can be passed to the component as inputs via {@link WorkbenchMessageBoxOptions.inputs} property or by providing a custom injector
-     * via {@link WorkbenchMessageBoxOptions.injector} property. Inputs are available as input properties in the component.
+     * Data can be passed to the component as inputs via {@link WorkbenchMessageBoxOptions.inputs} option. Inputs are available as input
+     * properties in the component. Alternatively, data can be passed for injection via a custom injector ({@link WorkbenchMessageBoxOptions.injector})
+     * or providers ({@link WorkbenchMessageBoxOptions.providers}).
      *
      * @example
      * ```ts
@@ -5674,7 +5753,7 @@ declare abstract class WorkbenchMessageBoxService {
  * application-modal blocks the workbench or browser viewport, based on {@link WorkbenchConfig.dialog.modalityScope}.
  *
  * ## Context
- * A dialog can be bound to a context (e.g., a part or view), defaulting to the calling context.
+ * A dialog can be bound to a context (e.g., part or view), defaulting to the calling context.
  * The dialog is displayed only if the context is visible and closes when the context is disposed.
  *
  * ## Positioning
@@ -5747,8 +5826,9 @@ declare abstract class WorkbenchDialogService {
      *
      * By default, the dialog is modal to the calling context. Specify a different modality in {@link WorkbenchDialogOptions.modality}.
      *
-     * Data can be passed to the component as inputs via {@link WorkbenchDialogOptions.inputs} property or by providing a custom injector
-     * via {@link WorkbenchDialogOptions.injector} property. Dialog inputs are available as input properties in the dialog component.
+     * Data can be passed to the component as inputs via {@link WorkbenchDialogOptions.inputs} option. Inputs are available as input
+     * properties in the component. Alternatively, data can be passed for injection via a custom injector ({@link WorkbenchDialogOptions.injector})
+     * or providers ({@link WorkbenchDialogOptions.providers}).
      *
      * @param component - Specifies the component to display in the dialog.
      * @param options - Controls the appearance and behavior of the dialog.
@@ -5759,28 +5839,31 @@ declare abstract class WorkbenchDialogService {
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchDialogService>;
 }
 
+/**
+ * DI token to register providers available for DI if in the context of a workbench dialog.
+ */
+declare const WORKBENCH_DIALOG_CONTEXT: InjectionToken<Provider[]>;
+
 /**
  * Represents a handle that a notification component can inject to interact with the notification, for example,
  * to read input data or to configure the notification.
  *
  * A notification is a closable message that appears in the upper-right corner and disappears automatically after a few seconds.
  * It informs the user of a system event, e.g., that a task has been completed or an error has occurred.
+ *
+ * @deprecated since version 21.0.0-beta.1. Replaced by `WorkbenchNotification`. Marked for removal in version 22.
  */
 declare abstract class Notification<T = any> {
     /**
      * Input data as passed by the notification opener, or `undefined` if not passed.
      */
     readonly input: T | undefined;
-    /**
-     * Sets the title of the notification.
-     */
-    abstract setTitle(title: Translatable | undefined): void;
     /**
      * Sets the title of the notification.
      *
-     * @deprecated since version 20.0.0-beta.6. To migrate, pass a translatable and provide the text using a text provider registered in `WorkbenchClient.registerTextProvider`.
+     * Can be text or a translation key. A translation key starts with the percent symbol (`%`) and may include parameters in matrix notation for text interpolation.
      */
-    abstract setTitle(title: Observable<Translatable | undefined>): void;
+    abstract setTitle(title: Translatable | undefined): void;
     /**
      * Sets the severity of the notification.
      */
@@ -5801,23 +5884,17 @@ declare abstract class Notification<T = any> {
 }
 
 /**
- * Configures the content and appearance of a notification presented to the user.
+ * Controls the appearance and behavior of a notification.
  *
- * A notification is a closable message that appears in the upper-right corner and disappears automatically after a few seconds.
- * It informs the user of a system event, e.g., that a task has been completed or an error has occurred.
- *
- * Multiple notifications are stacked vertically. Notifications can be grouped. For each group, only the last notification is
- * displayed at any given time.
+ * @deprecated since version 21.0.0-beta.1. Replaced by `WorkbenchNotificationOptions`. Use `WorkbenchNotificationService` to show notifications. Marked for removal in version 22.
  */
 interface NotificationConfig {
     /**
      * Optional title of the notification.
      *
      * Can be text or a translation key. A translation key starts with the percent symbol (`%`) and may include parameters in matrix notation for text interpolation.
-     *
-     * TODO [Angular 21] Passing an Observable is deprecated. To migrate, pass a translatable and provide the text using a text provider registered in `WorkbenchClient.registerTextProvider`. API will be removed in version 21.
      */
-    title?: Translatable | Observable<Translatable | undefined>;
+    title?: Translatable;
     /**
      * Content of the notification, can be either a plain text message or a component.
      *
@@ -5852,7 +5929,7 @@ interface NotificationConfig {
         viewContainerRef?: ViewContainerRef;
     };
     /**
-     * Optional data to pass to the notification component. In the component, you can inject the notification handle {@link Notification} to
+     * Specifies data to pass to the notification component. In the component, you can inject the notification handle {@link Notification} to
      * read input data. Use only in combination with a custom notification component, has no effect otherwise.
      */
     componentInput?: unknown;
@@ -5888,260 +5965,393 @@ interface NotificationConfig {
 }
 
 /**
- * Allows displaying a notification to the user.
+ * Shows a notification.
  *
- * A notification is a closable message that appears in the upper-right corner and disappears automatically after a few seconds.
- * It informs the user of a system event, e.g., that a task has been completed or an error has occurred.
+ * A notification is a closable message displayed in the upper-right corner that disappears after a few seconds unless hovered.
+ * It informs about system events, task completion or errors. The severity indicates importance or urgency.
+ *
+ * Notifications can be grouped. Only the most recent notification within a group is displayed.
  *
- * Multiple notifications are stacked vertically. Notifications can be grouped. For each group, only the last notification is
- * displayed.
+ * Content can be plain text or structured. Pressing Escape closes the notification.
  *
- * To display structured content, consider passing a component to {@link NotificationConfig#content} instead of plain text.
+ * @deprecated since version 21.0.0-beta.1. Use `WorkbenchNotificationService` to show notifications. Marked for removal in version 22.
  */
 declare class NotificationService {
-    private readonly _zone;
-    private readonly _injector;
-    private readonly _document;
-    private readonly _notifications$;
-    constructor();
+    private readonly _notificationService;
     /**
-     * Presents the user with a notification that is displayed in the upper-right corner based on the given config.
+     * Displays the specified text or component as workbench notification.
      *
-     * To display structured content, consider passing a component to {@link NotificationConfig#content}.
+     * @param notification - Configures content and appearance of the notification.
      *
-     * ### Usage:
-     * ```typescript
-     * notificationService.notify({
-     *   content: 'Task scheduled for execution.',
-     *   severity: 'info',
-     *   duration: 'short',
-     * });
-     * ```
-     *
-     * @param  notification - Configures the content and appearance of the notification.
+     * @deprecated since version 21.0.0-beta.1. Use `WorkbenchNotificationService` to show notifications. Marked for removal in version 22.
      */
     notify(notification: Translatable | NotificationConfig): void;
-    private addNotification;
-    /**
-     * Constructs the notification based on the given config and computes its insertion index.
-     */
-    private constructNotification;
-    private get notifications();
-    /**
-     * Installs a keystroke listener to close the last notification when the user presses the escape keystroke.
-     */
-    private installEscapeHandler;
     static ɵfac: i0.ɵɵFactoryDeclaration<NotificationService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
 }
 
 /**
- * Enables the display of a component in a popup.
+ * A notification is a closable message displayed in the upper-right corner that disappears after a few seconds unless hovered.
+ * It informs about system events, task completion or errors. The severity indicates importance or urgency.
  *
- * A popup is a visual workbench element for displaying content above other content. It is positioned relative to an anchor,
- * which can be an element or a coordinate. The popup moves with the anchor. By default, the popup closes on focus loss or
- * when pressing the escape key.
+ * The notification component can inject this handle to interact with the notification.
  *
- * A popup can be bound to a context (e.g., a part or view), displaying the popup only if the context is visible and closing
- * it when the context is disposed. Defaults to the calling context.
+ * Notification inputs are available as input properties in the notification component.
+ *
+ * @see WorkbenchNotificationService
  */
-declare abstract class WorkbenchPopupService {
+declare abstract class WorkbenchNotification {
     /**
-     * Opens a popup with the specified component and options.
-     *
-     * An anchor is used to position the popup based on its preferred alignment. The anchor can be an element or a coordinate.
-     *
-     * Data can be passed to the component via {@link PopupConfig.input} property. The component can inject the popup handle {@link WorkbenchPopup} to
-     * read input data or to close the popup.
+     * Sets the title of the notification.
      *
-     * By default, the popup closes on focus loss or when pressing the escape key.
+     * Can be text or a translation key. A translation key starts with the percent symbol (`%`) and may include parameters in matrix notation for text interpolation.
+     */
+    abstract get title(): Signal<Translatable | undefined>;
+    abstract set title(title: Translatable | undefined);
+    /**
+     * Sets the severity of the notification to indicate importance or urgency.
+     */
+    abstract get severity(): Signal<'info' | 'warn' | 'error'>;
+    abstract set severity(severity: 'info' | 'warn' | 'error');
+    /**
+     * Controls how long to display the notification.
      *
-     * @param config - Controls the appearance and behavior of the popup.
-     * @returns Promise that resolves to the popup result, if any, or that rejects if the popup couldn't be opened or was closed with an error.
+     * Can be a duration alias, or milliseconds.
      */
-    abstract open<R>(config: PopupConfig): Promise<R | undefined>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchPopupService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchPopupService>;
-}
-
+    abstract get duration(): Signal<'short' | 'medium' | 'long' | 'infinite' | number>;
+    abstract set duration(duration: 'short' | 'medium' | 'long' | 'infinite' | number);
+    /**
+     * Specifies CSS class(es) to add to the notification, e.g., to locate the notification in tests.
+     */
+    abstract get cssClass(): Signal<string[]>;
+    abstract set cssClass(cssClass: string | string[]);
+    /**
+     * Closes the notification.
+     */
+    abstract close(): void;
+}
+
 /**
- * Keys for associating workbench-specific data with a perspective.
+ * Controls the appearance and behavior of a notification.
  */
-declare const WorkbenchPerspectiveData: {
+interface WorkbenchNotificationOptions {
     /**
-     * Property to get the capability providing the perspective.
+     * Specifies the title of the notification.
+     *
+     * Can be text or a translation key. A translation key starts with the percent symbol (`%`) and may include parameters in matrix notation for text interpolation.
      */
-    readonly capability: "ɵcapability";
-};
+    title?: Translatable;
+    /**
+     * Specifies the severity of the notification. Defaults to `info`.
+     */
+    severity?: 'info' | 'warn' | 'error';
+    /**
+     * Controls how long to display the notification.
+     *
+     * Can be a duration alias, or milliseconds.
+     */
+    duration?: 'short' | 'medium' | 'long' | 'infinite' | number;
+    /**
+     * Specifies the group to which the notification belongs. Only the most recent notification within a group is displayed.
+     */
+    group?: string;
+    /**
+     * Enables aggregation of input values of notifications of the same group.
+     *
+     * Use with {@link group} to combine inputs of notifications of the same group.
+     *
+     * The reducer is invoked with inputs of the previous notification, if still displaying, and inputs of the new notification.
+     * The returned input is passed to the new notification.
+     */
+    groupInputReduceFn?: (prevInput: {
+        [name: string]: unknown;
+    }, currInput: {
+        [name: string]: unknown;
+    }) => {
+        [name: string]: unknown;
+    };
+    /**
+     * Specifies data to pass to the notification component. Inputs are available as input properties in the notification component.
+     *
+     * Has no effect if opening a plain text notification.
+     *
+     * @example - Reading inputs in the component
+     * ```ts
+     * public someInput = input.required<string>();
+     * ```
+     */
+    inputs?: {
+        [name: string]: unknown;
+    };
+    /**
+     * Specifies the injector for the instantiation of the notification, giving control over the objects available
+     * for injection in the notification component. Defaults to the application's root injector.
+     *
+     * @example - Creating an injector with a DI token
+     *
+     * ```ts
+     * Injector.create({
+     *   parent: ...,
+     *   providers: [
+     *    {provide: <TOKEN>, useValue: <VALUE>}
+     *   ],
+     * })
+     * ```
+     */
+    injector?: Injector;
+    /**
+     * Specifies providers available for injection in the notification component.
+     *
+     * Providers can inject {@link WorkbenchNotification} to interact with the notification.
+     */
+    providers?: Provider[];
+    /**
+     * Specifies CSS class(es) to add to the notification, e.g., to locate the notification in tests.
+     */
+    cssClass?: string | string[];
+}
 
 /**
- * Registers a function that is executed during the startup of the SCION Workbench.
+ * Shows a notification.
  *
- * Initializers help to run initialization tasks (synchronous or asynchronous) during startup of the SCION Workbench.
- * The workbench is fully started once all initializers have completed.
- *
- * Initializers can specify a phase for execution. Initializers in lower phases execute before initializers in higher phases.
- * Initializers in the same phase may execute in parallel. If no phase is specified, the initializer executes in the `Startup` phase.
- *
- * Available phases, in order of execution:
- * - {@link WorkbenchStartupPhase.PreStartup}
- * - {@link WorkbenchStartupPhase.Startup}
- * - {@link WorkbenchStartupPhase.PostStartup}
+ * A notification is a closable message displayed in the upper-right corner that disappears after a few seconds unless hovered.
+ * It informs about system events, task completion or errors. The severity indicates importance or urgency.
  *
- * The function can call `inject` to get any required dependencies.
+ * Notifications can be grouped. Only the most recent notification within a group is displayed.
  *
- * @param initializerFn - Specifies the function to execute.
- * @param options - Controls execution of the function.
- * @return A set of dependency-injection providers to be registered in Angular.
+ * Content can be plain text or structured. Pressing Escape closes the notification.
  */
-declare function provideWorkbenchInitializer(initializerFn: WorkbenchInitializerFn, options?: WorkbenchInitializerOptions): EnvironmentProviders;
+declare abstract class WorkbenchNotificationService {
+    /**
+     * Displays the specified message as workbench notification.
+     *
+     * @param message - Specifies the text to display.
+     *                  Can be text or a translation key. A translation key starts with the percent symbol (`%`) and may include parameters in matrix notation for text interpolation.
+     * @param options - Controls the appearance and behavior of the notification.
+     */
+    abstract show(message: Translatable, options?: WorkbenchNotificationOptions): void;
+    /**
+     * Displays the specified component as workbench notification.
+     *
+     * Data can be passed to the component as inputs via {@link WorkbenchNotificationOptions.inputs} option. Inputs are available as input
+     * properties in the component. Alternatively, data can be passed for injection via a custom injector ({@link WorkbenchNotificationOptions.injector})
+     * or providers ({@link WorkbenchNotificationOptions.providers}).
+     *
+     * @param component - Specifies the component to render as the notification.
+     * @param options - Controls the appearance and behavior of the notification.
+     */
+    abstract show(component: ComponentType<unknown>, options?: WorkbenchNotificationOptions): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchNotificationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchNotificationService>;
+}
+
 /**
- * Controls the execution of an initializer function during the startup of the SCION Workbench.
+ * Enables the display of a component in a popup.
+ *
+ * A popup is a visual workbench element for displaying content above other content. It is positioned relative to an anchor,
+ * which can be an element or a coordinate. The popup moves with the anchor. By default, the popup closes on focus loss or
+ * when pressing the escape key.
+ *
+ * A popup can be bound to a context (e.g., part or view), displaying the popup only if the context is visible and closing
+ * it when the context is disposed. Defaults to the calling context.
  */
-interface WorkbenchInitializerOptions {
+declare abstract class WorkbenchPopupService {
     /**
-     * Controls in which phase to execute the initializer.
+     * Opens a popup with the specified component and options.
+     *
+     * An anchor is used to position the popup based on its preferred alignment. The anchor can be an element or a coordinate.
+     *
+     * Data can be passed to the component as inputs via {@link WorkbenchPopupOptions.inputs} option. Inputs are available as input
+     * properties in the component. Alternatively, data can be passed for injection via a custom injector ({@link WorkbenchPopupOptions.injector})
+     * or providers ({@link WorkbenchPopupOptions.providers}).
+     *
+     * By default, the popup closes on focus loss or when pressing the escape key.
+     *
+     * @param component - Specifies the component to display in the popup.
+     * @param options - Controls the appearance and behavior of the popup.
+     * @returns Promise that resolves to the popup result, if any, or that rejects if the popup couldn't be opened or was closed with an error.
      */
-    phase?: WorkbenchStartupPhase;
+    abstract open<R>(component: ComponentType<unknown>, options: WorkbenchPopupOptions): Promise<R | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchPopupService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchPopupService>;
 }
+
 /**
- * Enumeration of phases for running a {@link WorkbenchInitializerFn} function during the startup of the SCION Workbench.
+ * Controls the appearance and behavior of a popup.
  *
- * Functions associated with the same phase may run in parallel. Defaults to {@link Startup} phase.
+ * @deprecated since version 21.0.0-beta.1. Replaced by `WorkbenchPopupOptions`. Use `WorkbenchPopupService` to open popups. Marked for removal in version 22.
  */
-declare enum WorkbenchStartupPhase {
+declare abstract class PopupConfig {
     /**
-     * Use to run an initializer before starting the workbench.
+     * Controls where to open the popup.
+     *
+     * Can be an HTML element or a coordinate. The coordinate is relative to the {@link context}, defaulting to the calling context.
+     *
+     * Supported coordinate pairs:
+     * - x/y: Relative to the top/left corner of the context.
+     * - top/left: Same as x/y.
+     * - top/right: Relative to the top/right corner of the context.
+     * - bottom/left: Relative to the bottom/left corner of the context.
+     * - bottom/right: Relative to the bottom/right corner of the context.
+     *
+     * Passing an Observable allows for updating the coordinate.
      */
-    PreStartup = 0,
+    abstract readonly anchor: ElementRef<Element> | Element | PopupOrigin | Observable<PopupOrigin>;
     /**
-     * Use to run an initializer function after initializers of the {@link PreStartup} phase.
+     * Specifies the component to display in the popup.
      *
-     * This is the default phase if not specifying a phase.
+     * In the component, you can inject the popup handle {@link WorkbenchPopup} to interact with the popup, such as to close it
+     * or obtain its input data.
      */
-    Startup = 1,
+    abstract readonly component: Type<any>;
     /**
-     * Use to run an initializer function after initializers of the {@link Startup} phase.
+     * Instructs Angular how to construct the component. In most cases, construct options need not to be set.
      */
-    PostStartup = 2
+    readonly componentConstructOptions?: {
+        /**
+         * Sets the injector for the instantiation of the popup component, giving you control over the objects available
+         * for injection into the popup component. If not specified, uses the application's root injector, or the view's
+         * injector if opened in the context of a view.
+         *
+         * ```ts
+         * Injector.create({
+         *   parent: ...,
+         *   providers: [
+         *    {provide: <DiToken>, useValue: <value>}
+         *   ],
+         * })
+         * ```
+         */
+        injector?: Injector;
+        /**
+         * Specifies providers to be registered with the popup injector. Unlike providers that are registered via a separate {@link injector},
+         * passed providers are registered in the same injector as the popup handle itself, allowing for dependency injection of the popup handle.
+         */
+        providers?: StaticProvider[];
+        /**
+         * Sets the component's attachment point in Angular's logical component tree (not the DOM tree used for rendering), effecting when
+         * Angular checks the component for changes during a change detection cycle. If not set, inserts the component at the top level
+         * in the component tree.
+         *
+         * @deprecated since version 21.0.0-beta.1. Marked for removal. No replacement as not required anymore.
+         */
+        viewContainerRef?: ViewContainerRef;
+    };
+    /**
+     * Controls where to align the popup relative to the popup anchor, unless there is not enough space available in that area. By default,
+     * if not specified, the popup opens north of the anchor.
+     */
+    readonly align?: 'east' | 'west' | 'north' | 'south';
+    /**
+     * Specifies data to pass to the popup component. In the component, you can inject the popup handle {@link WorkbenchPopup} to read input data.
+     */
+    readonly input?: any;
+    /**
+     * Controls when to close the popup.
+     */
+    readonly closeStrategy?: CloseStrategy;
+    /**
+     * Specifies the preferred popup size. If not specified, the popup adjusts its size to the content size.
+     */
+    readonly size?: {
+        minHeight?: string;
+        height?: string;
+        maxHeight?: string;
+        minWidth?: string;
+        width?: string;
+        maxWidth?: string;
+    };
+    /**
+     * Specifies CSS class(es) to add to the popup, e.g., to locate the popup in tests.
+     */
+    readonly cssClass?: string | string[];
+    /**
+     * Binds the popup to a context (e.g., part or view). Defaults to the calling context.
+     *
+     * The popup is displayed only if the context is visible and closes when the context is disposed.
+     *
+     * Set to `null` to open the popup outside a context.
+     */
+    abstract context?: ViewId | PartId | DialogId | PopupId | Context | null;
 }
 /**
- * The signature of a function executed during the startup of the SCION Workbench.
- *
- * Initializers help to run initialization tasks (synchronous or asynchronous) during startup of the SCION Workbench.
- * The workbench is fully started once all initializers have completed.
- *
- * Initializers are registered using the `provideWorkbenchInitializer()` function and can specify a phase for execution.
- * Initializers in lower phases execute before initializers in higher phases. Initializers in the same phase may
- * execute in parallel. If no phase is specified, the initializer executes in the `Startup` phase.
- *
- * Available phases, in order of execution:
- * - {@link WorkbenchStartupPhase.PreStartup}
- * - {@link WorkbenchStartupPhase.Startup}
- * - {@link WorkbenchStartupPhase.PostStartup}
- *
- * The function can call `inject` to get any required dependencies.
- *
- * ### Example:
- *
- * ```ts
- * import {provideWorkbench, provideWorkbenchInitializer} from '@scion/workbench';
- * import {bootstrapApplication} from '@angular/platform-browser';
- * import {inject} from '@angular/core';
- *
- * bootstrapApplication(AppComponent, {
- *   providers: [
- *     provideWorkbench(),
- *     provideWorkbenchInitializer(() => inject(SomeService).init()),
- *   ],
- * });
- * ```
- * @see provideWorkbenchInitializer
+ * Specifies when to close the popup.
  */
-type WorkbenchInitializerFn = () => void | Promise<void>;
+interface CloseStrategy {
+    /**
+     * Controls if to close the popup on focus loss, returning the result set via {@link WorkbenchPopup#setResult} to the popup opener.
+     * Defaults to `true`.
+     */
+    onFocusLost?: boolean;
+    /**
+     * Controls if to close the popup when pressing escape. Defaults to `true`.
+     * No return value will be passed to the popup opener.
+     */
+    onEscape?: boolean;
+}
 /**
- * The signature of a class to hook into the startup of the SCION Workbench.
- *
- * The SCION Workbench defines a set of DI tokens called at defined points during startup, enabling the application's controlled initialization.
- *
- * Available DI tokens, in order of execution:
- * - {@link WORKBENCH_PRE_STARTUP}
- * - {@link WORKBENCH_STARTUP}
- * - {@link WORKBENCH_POST_STARTUP}
- *
- * ### Example:
- *
- * ```ts
- * import {provideWorkbench, WORKBENCH_STARTUP, WorkbenchInitializer} from '@scion/workbench';
- * import {bootstrapApplication} from '@angular/platform-browser';
- * import {Injectable} from '@angular/core';
+ * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
+ */
+interface Context {
+    /**
+     * @deprecated since version 20.0.0-beta.9. Set view id directly. Migrate `{context: {viewId: 'view.x'}}` to `{context: 'view.x'}`. Marked for removal in version 22.
+     */
+    viewId?: ViewId | null;
+}
+
+/**
+ * Enables the display of a component in a popup.
  *
- * @Injectable()
- * export class Initializer implements WorkbenchInitializer {
- *   public async init(): Promise<void> {
- *     // initialize application
- *   }
- * }
+ * A popup is a visual workbench element for displaying content above other content. It is positioned relative to an anchor,
+ * which can be an element or a coordinate. The popup moves with the anchor. By default, the popup closes on focus loss or
+ * when pressing the escape key.
  *
- * bootstrapApplication(AppComponent, {
- *   providers: [
- *     provideWorkbench(),
- *     {
- *       provide: WORKBENCH_STARTUP,
- *       multi: true,
- *       useClass: Initializer,
- *     },
- *   ],
- * });
- * ```
- * @see WORKBENCH_PRE_STARTUP
- * @see WORKBENCH_STARTUP
- * @see WORKBENCH_POST_STARTUP
+ * A popup can be bound to a context (e.g., part or view), displaying the popup only if the context is visible and closing
+ * it when the context is disposed. Defaults to the calling context.
  *
- * @deprecated since version 19.0.0-beta.3. Register an initializer function instead. The function can call `inject` to get required dependencies. See `WorkbenchInitializerFn` for an example. API will be removed in version 21.
+ * @deprecated since version 21.0.0-beta.1. Use `WorkbenchPopupService` to open popups. Marked for removal in version 22.
  */
-interface WorkbenchInitializer {
+declare abstract class PopupService {
     /**
-     * This method is called during the startup of the SCION Workbench.
+     * Opens a popup with the specified component and options.
+     *
+     * An anchor is used to position the popup based on its preferred alignment. The anchor can be an element or a coordinate.
      *
-     * The method can call `inject` to get required dependencies.
+     * Data can be passed to the component via {@link PopupConfig.input} property. The component can inject the popup handle {@link WorkbenchPopup} to
+     * read input data or to close the popup.
+     *
+     * By default, the popup closes on focus loss or when pressing the escape key.
      *
-     * @return A Promise blocking startup until it resolves.
+     * @param config - Controls the appearance and behavior of the popup.
+     * @returns Promise that resolves to the popup result, if any, or that rejects if the popup couldn't be opened or was closed with an error.
+     *
+     * @deprecated since version 21.0.0-beta.1. Use `WorkbenchPopupService` to open popups. Marked for removal in version 22.
      */
-    init(): Promise<void>;
+    abstract open<R>(config: PopupConfig): Promise<R | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PopupService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PopupService>;
 }
+
 /**
- * DI token to register a {@link WorkbenchInitializerFn} as a multi-provider to hook into the startup process of the SCION Workbench.
- *
- * Initializers associated with this DI token are executed before starting the SCION Workbench.
- *
- * @see WorkbenchInitializerFn
- * @deprecated since version 19.0.0-beta.3. Register initializer using `provideWorkbenchInitializer` function. See `provideWorkbenchInitializer` for an example. API will be removed in version 21.
- */
-declare const WORKBENCH_PRE_STARTUP: InjectionToken<object | WorkbenchInitializerFn | WorkbenchInitializer>;
-/**
- * DI token to register a {@link WorkbenchInitializerFn} as a multi-provider to hook into the startup process of the SCION Workbench.
- *
- * Initializers associated with this DI token are executed after initializers of {@link WORKBENCH_PRE_STARTUP}.
- *
- * @see WorkbenchInitializerFn
- * @deprecated since version 19.0.0-beta.3. Register initializer using `provideWorkbenchInitializer` function. See `provideWorkbenchInitializer` for an example. API will be removed in version 21.
+ * DI token to register providers available for DI if in the context of a workbench popup.
  */
-declare const WORKBENCH_STARTUP: InjectionToken<object | WorkbenchInitializerFn | WorkbenchInitializer>;
+declare const WORKBENCH_POPUP_CONTEXT: InjectionToken<Provider[]>;
+
 /**
- * DI token to register a {@link WorkbenchInitializerFn} as a multi-provider to hook into the startup process of the SCION Workbench.
- *
- * Initializers associated with this DI token are executed after initializers of {@link WORKBENCH_STARTUP}.
- *
- * @see WorkbenchInitializerFn
- * @deprecated since version 19.0.0-beta.3. Register initializer using `provideWorkbenchInitializer` function. See `provideWorkbenchInitializer` for an example. API will be removed in version 21.
+ * Keys for associating workbench-specific data with a perspective.
  */
-declare const WORKBENCH_POST_STARTUP: InjectionToken<object | WorkbenchInitializerFn | WorkbenchInitializer>;
+declare const WorkbenchPerspectiveData: {
+    /**
+     * Property to get the capability providing the perspective.
+     */
+    readonly capability: "ɵcapability";
+};
 
 /**
  * Registers a function that is executed during the startup of the SCION Microfrontend Platform.
  *
- * Initializers help to run initialization tasks (synchronous or asynchronous) during startup of the SCION Microfrontend Platform.
+ * Initializers are used to run initialization tasks during startup of the SCION Microfrontend Platform.
+ * The SCION Microfrontend Platform is fully started once all initializers have completed.
  *
  * Initializers can specify a phase for execution. Initializers in lower phases execute before initializers in higher phases.
  * Initializers in the same phase may execute in parallel. If no phase is specified, the initializer executes in the `PostStartup` phase.
@@ -6150,6 +6360,8 @@ declare const WORKBENCH_POST_STARTUP: InjectionToken<object | WorkbenchInitializ
  * - {@link MicrofrontendPlatformStartupPhase.PreStartup}
  * - {@link MicrofrontendPlatformStartupPhase.PostStartup}
  *
+ * Microfrontend platform initializers run during the {@link WorkbenchStartupPhase.Startup} phase.
+ *
  * The function can call `inject` to get any required dependencies.
  *
  * Initializers are only called if microfrontend support is enabled.
@@ -6158,7 +6370,7 @@ declare const WORKBENCH_POST_STARTUP: InjectionToken<object | WorkbenchInitializ
  * @param options - Controls execution of the function.
  * @return A set of dependency-injection providers to be registered in Angular.
  */
-declare function provideMicrofrontendPlatformInitializer(initializerFn: WorkbenchInitializerFn, options?: MicrofrontendPlatformInitializerOptions): EnvironmentProviders;
+declare function provideMicrofrontendPlatformInitializer(initializerFn: MicrofrontendPlatformInitializerFn, options?: MicrofrontendPlatformInitializerOptions): EnvironmentProviders;
 /**
  * Controls the execution of an initializer function during the startup of the SCION Microfrontend Platform.
  */
@@ -6169,7 +6381,7 @@ interface MicrofrontendPlatformInitializerOptions {
     phase?: MicrofrontendPlatformStartupPhase;
 }
 /**
- * Enumeration of phases for running a {@link WorkbenchInitializerFn} function during the startup of the SCION Microfrontend Platform.
+ * Enumeration of phases for running a {@link MicrofrontendPlatformInitializerFn} function during the startup of the SCION Microfrontend Platform.
  *
  * Functions associated with the same phase may run in parallel. Defaults to {@link PostStartup} phase.
  */
@@ -6178,7 +6390,7 @@ declare enum MicrofrontendPlatformStartupPhase {
      * Use to run an initializer before starting the SCION Microfrontend Platform.
      *
      * Typically, you would configure the SCION Microfrontend Platform in this phase, for example, register interceptors or decorators.
-     * At this point, you cannot interact with the microfrontend platform because it has not been started yet.
+     * At this point, you cannot interact with the Microfrontend Platform because it has not been started yet.
      *
      * This phase is only called if microfrontend support is enabled.
      */
@@ -6189,38 +6401,52 @@ declare enum MicrofrontendPlatformStartupPhase {
      * Typically, you would install intent and message handlers in this phase.
      * At this point, the activators of the micro applications are not yet installed.
      *
+     * This is the default phase if not specifying a phase.
+     *
      * This phase is only called if microfrontend support is enabled.
      */
     PostStartup = 2
 }
 /**
- * DI token to register a {@link WorkbenchInitializerFn} as a multi-provider to hook into the startup process of the SCION Microfrontend Platform.
+ * The signature of a function executed during the startup of the SCION Microfrontend Platform.
  *
- * Initializers associated with this DI token are executed during {@link WORKBENCH_STARTUP} before starting the SCION Microfrontend Platform.
+ * Initializers are used to run initialization tasks during startup of the SCION Microfrontend Platform.
  *
- * Typically, you would configure the SCION Microfrontend Platform in this lifecycle hook, for example, register interceptors or decorators.
- * At this point, you cannot interact with the microfrontend platform because it has not been started yet.
+ * Initializers are registered using the `provideMicrofrontendPlatformInitializer()` function and can specify a phase for execution.
+ * Initializers in lower phases execute before initializers in higher phases. Initializers in the same phase may
+ * execute in parallel. If no phase is specified, the initializer executes in the `PostStartup` phase.
  *
- * This lifecycle hook is only called if microfrontend support is enabled.
+ * Microfrontend platform initializers run during the {@link WorkbenchStartupPhase.Startup} phase.
  *
- * @see WorkbenchInitializerFn
- * @deprecated since version 19.0.0-beta.3. Register initializer using `provideMicrofrontendPlatformInitializer` function. See `provideMicrofrontendPlatformInitializer` for an example. API will be removed in version 21.
- */
-declare const MICROFRONTEND_PLATFORM_PRE_STARTUP: InjectionToken<object | WorkbenchInitializerFn | WorkbenchInitializer>;
-/**
- * DI token to register a {@link WorkbenchInitializerFn} as a multi-provider to hook into the startup process of the SCION Microfrontend Platform.
+ * Available phases, in order of execution:
+ * - {@link MicrofrontendPlatformStartupPhase.PreStartup}
+ * - {@link MicrofrontendPlatformStartupPhase.PostStartup}
  *
- * Initializers associated with this DI token are executed during {@link WORKBENCH_STARTUP} after started the SCION Microfrontend Platform.
+ * The function can call `inject` to get any required dependencies.
  *
- * Typically, you would install intent and message handlers in this lifecycle hook.
- * At this point, the activators of the micro applications are not yet installed.
+ * @example - Registration of an initializer function
+ * ```ts
+ * import {provideWorkbench, provideMicrofrontendPlatformInitializer} from '@scion/workbench';
+ * import {bootstrapApplication} from '@angular/platform-browser';
+ * import {inject} from '@angular/core';
  *
- * This lifecycle hook is only called if microfrontend support is enabled.
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideWorkbench(),
+ *     provideMicrofrontendPlatformInitializer(() => inject(SomeService).init()),
+ *   ],
+ * });
+ * ```
+ * @see provideMicrofrontendPlatformInitializer
+ */
+type MicrofrontendPlatformInitializerFn = () => void | Promise<void>;
+
+/**
+ * DI token to inject the deprecated referrer previously available on the removed `WorkbenchPopup.referrer`.
  *
- * @see WorkbenchInitializerFn
- * @deprecated since version 19.0.0-beta.3. Register initializer using `provideMicrofrontendPlatformInitializer` function. See `provideMicrofrontendPlatformInitializer` for an example. API will be removed in version 21.
+ * @deprecated since version 21.0.0-beta.2. Marked for removal. No replacement. Instead, add a parameter to the popup capability for the popup opener to pass required referrer information.
  */
-declare const MICROFRONTEND_PLATFORM_POST_STARTUP: InjectionToken<object | WorkbenchInitializerFn | WorkbenchInitializer>;
+declare const WORKBENCH_POPUP_REFERRER: InjectionToken<WorkbenchPopupReferrer>;
 
 /**
  * Patches '@scion/microfrontend-platform' typedef definition via module augmentation.
@@ -6248,6 +6474,26 @@ declare module '@scion/microfrontend-platform' {
     }
 }
 
+/**
+ * Provides capability and parameters of a host microfrontend.
+ *
+ * Can be injected into a microfrontend component of the host application.
+ */
+declare abstract class ActivatedMicrofrontend {
+    /**
+     * Capability associated with the microfrontend.
+     */
+    abstract readonly capability: Signal<Capability>;
+    /**
+     * Parameters passed to the microfrontend.
+     */
+    abstract readonly params: Signal<Map<string, unknown>>;
+    /**
+     * Symbolic name of the application that opened the microfrontend.
+     */
+    abstract readonly referrer: Signal<string>;
+}
+
 /**
  * Provides the main entry point to start the SCION Workbench.
  *
@@ -6305,6 +6551,91 @@ declare abstract class WorkbenchLauncher {
     static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchLauncher>;
 }
 
+/**
+ * Registers a function that is executed during the startup of the SCION Workbench.
+ *
+ * Initializers are used to run initialization tasks during startup of the SCION Workbench.
+ * The workbench is fully started once all initializers have completed.
+ *
+ * Initializers can specify a phase for execution. Initializers in lower phases execute before initializers in higher phases.
+ * Initializers in the same phase may execute in parallel. If no phase is specified, the initializer executes in the `Startup` phase.
+ *
+ * Available phases, in order of execution:
+ * - {@link WorkbenchStartupPhase.PreStartup}
+ * - {@link WorkbenchStartupPhase.Startup}
+ * - {@link WorkbenchStartupPhase.PostStartup}
+ *
+ * The function can call `inject` to get any required dependencies.
+ *
+ * @param initializerFn - Specifies the function to execute.
+ * @param options - Controls execution of the function.
+ * @return A set of dependency-injection providers to be registered in Angular.
+ */
+declare function provideWorkbenchInitializer(initializerFn: WorkbenchInitializerFn, options?: WorkbenchInitializerOptions): EnvironmentProviders;
+/**
+ * Controls the execution of an initializer function during the startup of the SCION Workbench.
+ */
+interface WorkbenchInitializerOptions {
+    /**
+     * Controls in which phase to execute the initializer.
+     */
+    phase?: WorkbenchStartupPhase;
+}
+/**
+ * Enumeration of phases for running a {@link WorkbenchInitializerFn} function during the startup of the SCION Workbench.
+ *
+ * Functions associated with the same phase may run in parallel. Defaults to {@link Startup} phase.
+ */
+declare enum WorkbenchStartupPhase {
+    /**
+     * Use to run an initializer before starting the workbench.
+     */
+    PreStartup = 0,
+    /**
+     * Use to run an initializer function after initializers of the {@link PreStartup} phase.
+     *
+     * This is the default phase if not specifying a phase.
+     */
+    Startup = 1,
+    /**
+     * Use to run an initializer function after initializers of the {@link Startup} phase.
+     */
+    PostStartup = 2
+}
+/**
+ * The signature of a function executed during the startup of the SCION Workbench.
+ *
+ * Initializers are used to run initialization tasks during startup of the SCION Workbench.
+ * The workbench is fully started once all initializers have completed.
+ *
+ * Initializers are registered using the `provideWorkbenchInitializer()` function and can specify a phase for execution.
+ * Initializers in lower phases execute before initializers in higher phases. Initializers in the same phase may
+ * execute in parallel. If no phase is specified, the initializer executes in the `Startup` phase.
+ *
+ * Available phases, in order of execution:
+ * - {@link WorkbenchStartupPhase.PreStartup}
+ * - {@link WorkbenchStartupPhase.Startup}
+ * - {@link WorkbenchStartupPhase.PostStartup}
+ *
+ * The function can call `inject` to get any required dependencies.
+ *
+ * @example - Registration of an initializer function
+ * ```ts
+ * import {provideWorkbench, provideWorkbenchInitializer} from '@scion/workbench';
+ * import {bootstrapApplication} from '@angular/platform-browser';
+ * import {inject} from '@angular/core';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideWorkbench(),
+ *     provideWorkbenchInitializer(() => inject(SomeService).init()),
+ *   ],
+ * });
+ * ```
+ * @see provideWorkbenchInitializer
+ */
+type WorkbenchInitializerFn = () => void | Promise<void>;
+
 /**
  * Enables the translation of a given {@link Translatable}.
  *
@@ -6388,5 +6719,5 @@ declare class IconComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<IconComponent, "wb-icon", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { IconComponent, LogAppender, LogLevel, Logger, LoggerName, MAIN_AREA, MAIN_AREA_INITIAL_PART_ID, MICROFRONTEND_PLATFORM_POST_STARTUP, MICROFRONTEND_PLATFORM_PRE_STARTUP, MicrofrontendPlatformConfigLoader, MicrofrontendPlatformStartupPhase, Notification, NotificationService, WorkbenchPopup as Popup, PopupConfig, WorkbenchPopupService as PopupService, TextPipe, VIEW_TAB_RENDERING_CONTEXT, WORKBENCH_ID, WORKBENCH_POST_STARTUP, WORKBENCH_PRE_STARTUP, WORKBENCH_STARTUP, WorkbenchComponent, WorkbenchConfig, WorkbenchDesktopDirective, WorkbenchDialog, WorkbenchDialogActionDirective, WorkbenchDialogFooterDirective, WorkbenchDialogHeaderDirective, WorkbenchDialogService, WorkbenchLauncher, WorkbenchLayoutFactory, WorkbenchMessageBoxService, WorkbenchPart, WorkbenchPartActionDirective, WorkbenchPerspectiveData, WorkbenchPopup, WorkbenchPopupService, WorkbenchRouteData, WorkbenchRouter, WorkbenchRouterLinkDirective, WorkbenchService, WorkbenchStartup, WorkbenchStartupPhase, WorkbenchStorage, WorkbenchView, WorkbenchViewMenuItemDirective, canMatchWorkbenchOutlet, canMatchWorkbenchPart, canMatchWorkbenchPerspective, canMatchWorkbenchView, provideMicrofrontendPlatformInitializer, provideWorkbench, provideWorkbenchInitializer, text };
-export type { ActivityId, BottomLeftPoint, BottomRightPoint, CanCloseFn, CanCloseRef, CloseStrategy, Commands, DialogId, Disposable, DockedPartExtras, DockingArea, LogEvent, MenuItemConfig, MicrofrontendPlatformInitializerOptions, NavigateFn, NavigationData, NavigationState, NotificationConfig, PartExtras, PartId, Point, PopupId, PopupOrigin, PopupSize, ReferencePart, TopLeftPoint, TopRightPoint, Translatable, ViewId, ViewMenuItemsConfig, ViewTabRenderingContext, WorkbenchDialogOptions, WorkbenchDialogSize, WorkbenchElement, WorkbenchIconDescriptor, WorkbenchIconProviderFn, WorkbenchInitializer, WorkbenchInitializerFn, WorkbenchInitializerOptions, WorkbenchLayout, WorkbenchLayoutFn, WorkbenchMenuItem, WorkbenchMessageBoxOptions, WorkbenchNavigationExtras, WorkbenchPartAction, WorkbenchPartActionFn, WorkbenchPartNavigation, WorkbenchPerspective, WorkbenchPerspectiveDefinition, WorkbenchPerspectiveSelectionFn, WorkbenchPerspectives, WorkbenchTextProviderFn, WorkbenchTheme, WorkbenchViewMenuItemFn, WorkbenchViewNavigation };
+export { ActivatedMicrofrontend, IconComponent, LogAppender, LogLevel, Logger, LoggerName, MAIN_AREA, MAIN_AREA_INITIAL_PART_ID, MicrofrontendPlatformConfigLoader, MicrofrontendPlatformStartupPhase, Notification, NotificationService, Popup, PopupConfig, PopupService, TextPipe, VIEW_TAB_RENDERING_CONTEXT, WORKBENCH_DIALOG_CONTEXT, WORKBENCH_ID, WORKBENCH_PART_CONTEXT, WORKBENCH_POPUP_CONTEXT, WORKBENCH_POPUP_REFERRER, WORKBENCH_VIEW_CONTEXT, WorkbenchComponent, WorkbenchConfig, WorkbenchDesktopDirective, WorkbenchDialog, WorkbenchDialogActionDirective, WorkbenchDialogFooterDirective, WorkbenchDialogHeaderDirective, WorkbenchDialogService, WorkbenchLauncher, WorkbenchLayoutFactory, WorkbenchMessageBoxService, WorkbenchNotification, WorkbenchNotificationService, WorkbenchPart, WorkbenchPartActionDirective, WorkbenchPerspectiveData, WorkbenchPopup, WorkbenchPopupService, WorkbenchRouteData, WorkbenchRouter, WorkbenchRouterLinkDirective, WorkbenchService, WorkbenchStartup, WorkbenchStartupPhase, WorkbenchStorage, WorkbenchView, WorkbenchViewMenuItemDirective, canMatchWorkbenchDialogCapability, canMatchWorkbenchMessageBoxCapability, canMatchWorkbenchOutlet, canMatchWorkbenchPart, canMatchWorkbenchPartCapability, canMatchWorkbenchPerspective, canMatchWorkbenchPopupCapability, canMatchWorkbenchView, canMatchWorkbenchViewCapability, provideMicrofrontendPlatformInitializer, provideWorkbench, provideWorkbenchInitializer, text };
+export type { ActivityId, BottomLeftPoint, BottomRightPoint, CanCloseFn, CanCloseRef, CloseStrategy$1 as CloseStrategy, Commands, DialogId, Disposable, DockedPartExtras, DockingArea, LogEvent, MenuItemConfig, MicrofrontendPlatformInitializerOptions, NavigateFn, NavigationData, NavigationState, NotificationConfig, PartExtras, PartId, Point, PopupId, PopupOrigin, ReferencePart, TopLeftPoint, TopRightPoint, Translatable, ViewId, ViewMenuItemsConfig, ViewTabRenderingContext, WorkbenchDialogOptions, WorkbenchDialogSize, WorkbenchElement, WorkbenchIconDescriptor, WorkbenchIconProviderFn, WorkbenchInitializerFn, WorkbenchInitializerOptions, WorkbenchLayout, WorkbenchLayoutFn, WorkbenchMenuItem, WorkbenchMessageBoxOptions, WorkbenchNavigationExtras, WorkbenchNotificationOptions, WorkbenchPartAction, WorkbenchPartActionFn, WorkbenchPartNavigation, WorkbenchPerspective, WorkbenchPerspectiveDefinition, WorkbenchPerspectiveSelectionFn, WorkbenchPerspectives, WorkbenchPopupOptions, WorkbenchPopupSize, WorkbenchTextProviderFn, WorkbenchViewMenuItemFn, WorkbenchViewNavigation };