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

package/lib/microfrontend-platform/routing/microfrontend-view-routes.d.ts

@@ -0,0 +1,49 @@
+import { Params, UrlMatcher, UrlSegment } from '@angular/router';
+import { WorkbenchViewCapability } from '@scion/workbench-client';
+import { Commands } from '../../routing/routing.model';
+/**
+ * Provides functions and constants specific to microfrontend routes.
+ */
+export declare const MicrofrontendViewRoutes: {
+    /**
+     * Prefix to identify a microfrontend route.
+     */
+    readonly ROUTE_PREFIX: "~";
+    /**
+     * Key for associating transient parameters with a navigation.
+     */
+    readonly STATE_TRANSIENT_PARAMS: "transientParams";
+    /**
+     * Custom URL matcher for microfrontend URLs, enabling transient parameters to be provided as regular route parameters.
+     *
+     * A microfrontend route consists of two segments:
+     * 1. An identifier segment (`~`) to identify a microfrontend route.
+     * 2. Capability segment to identify the microfrontend capability.
+     *
+     * Parameters are included in the second segment as matrix parameters.
+     *
+     * Example URL: `~/a538d2a;param1=value1;param2=value
+     *
+     * @see MicrofrontendViewRoutes.createMicrofrontendNavigateCommands
+     */
+    readonly provideMicrofrontendRouteMatcher: () => UrlMatcher;
+    /**
+     * Creates routing commands to navigate a microfrontend.
+     *
+     * Format: ['~', '<capabilityId>, {params}]
+     *
+     * @see MicrofrontendViewRoutes.provideMicrofrontendRouteMatcher
+     */
+    readonly createMicrofrontendNavigateCommands: (viewCapabilityId: string, params: Params) => Commands;
+    /**
+     * Tests given URL to be a microfrontend route.
+     */
+    readonly isMicrofrontendRoute: (segments: UrlSegment[]) => boolean;
+    /**
+     * Splits given params into URL and transient params.
+     */
+    readonly splitParams: (params: Params, capability: WorkbenchViewCapability) => {
+        urlParams: Params;
+        transientParams: Params;
+    };
+};

package/lib/microfrontend-platform/workbench-microfrontend-support.d.ts

@@ -1,5 +1,6 @@
 import { EnvironmentProviders } from '@angular/core';
 import { WorkbenchModuleConfig } from '../workbench-module-config';
+import './microfrontend-platform.config';
 /**
  * Provides a set of DI providers to set up microfrontend support in the workbench.
  */

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

@@ -1,5 +1,5 @@
 import { WorkbenchStorage } from '../storage/workbench-storage';
-import { Commands } from '../routing/workbench-router.service';
+import { Commands } from '../routing/routing.model';
 import * as i0 from "@angular/core";
 /**
  * Provides API to read/write perspective data from/to {@link WorkbenchStorage}.

package/lib/perspective/workbench-perspective-view-conflict-resolver.service.d.ts

@@ -1,6 +1,6 @@
 import { MPartGrid } from '../layout/workbench-layout.model';
 import { ɵWorkbenchLayoutFactory } from '../layout/ɵworkbench-layout.factory';
-import { Commands } from '../routing/workbench-router.service';
+import { Commands } from '../routing/routing.model';
 import * as i0 from "@angular/core";
 /**
  * Detects and resolves name conflicts of view names, that may occur when switching between perspectives.

package/lib/routing/public_api.d.ts

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

package/lib/routing/router.util.d.ts

@@ -1,31 +1,23 @@
 import { ActivatedRouteSnapshot, Router, UrlSegment } from '@angular/router';
-import { Commands } from './workbench-router.service';
-export declare namespace RouterUtils {
-    /**
-     * Replaces named parameters in the given path with values contained in the given {@link Map}.
-     * Named parameters begin with a colon (`:`) and are allowed in path segments, query parameters, matrix parameters
-     * and the fragment part.
-     *
-     * Some examples about the usage of named parameters:
-     * /segment/:param1/segment/:param2 // path params
-     * /segment/segment;matrixParam1=:param1;matrixParam2=:param2 // matrix params
-     * /segment/segment?queryParam1=:param1&queryParam2=:param2 // query params
-     */
-    function substituteNamedParameters(path: string | null, params?: Map<string, any>): string | null;
+import { Commands } from './routing.model';
+/**
+ * Provides utility functions for router operations.
+ */
+export declare const RouterUtils: {
     /**
      * Converts URL segments into an array of routable commands to be passed to the Angular router for navigation.
      */
-    function segmentsToCommands(segments: UrlSegment[]): Commands[];
+    readonly segmentsToCommands: (segments: UrlSegment[]) => Commands[];
     /**
      * Reads specified outlets from the current URL, optionally applying a `replacer` function to replace the commands of an outlet.
      */
-    function outletsFromCurrentUrl(router: Router, outletNames: string[], replacer?: (outlet: string, commands: Commands) => Commands | null): {
+    readonly outletsFromCurrentUrl: (router: Router, outletNames: string[], replacer?: ((outlet: string, commands: Commands) => Commands | null) | undefined) => {
         [viewId: string]: Commands;
     };
     /**
      * Parses the given path including any matrix parameters into URL segments.
      */
-    function parsePath(router: Router, path: string): UrlSegment[];
+    readonly parsePath: (router: Router, path: string) => UrlSegment[];
     /**
      * Resolves to the actual {@link ActivatedRouteSnapshot} loaded into a router outlet.
      *
@@ -33,14 +25,14 @@ export declare namespace RouterUtils {
      * or resolver, is not always the route that is actually loaded into the outlet, for example, if the route
      * is a child of a component-less route.
      */
-    function resolveActualRouteSnapshot(route: ActivatedRouteSnapshot): ActivatedRouteSnapshot;
+    readonly resolveActualRouteSnapshot: (route: ActivatedRouteSnapshot) => ActivatedRouteSnapshot;
     /**
      * Looks for requested data on given route, or its parent route(s) if not declared.
      */
-    function lookupRouteData<T>(activatedRoute: ActivatedRouteSnapshot, dataKey: string): T | undefined;
+    readonly lookupRouteData: <T>(activatedRoute: ActivatedRouteSnapshot, dataKey: string) => T | undefined;
     /**
      * Tests if the given view can be the target of a primary route.
      * Such views have an id that begins with the view prefix.
      */
-    function isPrimaryRouteTarget(viewId: string): boolean;
-}
+    readonly isPrimaryRouteTarget: (viewId: string) => boolean;
+};

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

@@ -0,0 +1,30 @@
+/**
+ * Represents an ordered list of path segments instructing the router which route to navigate to.
+ *
+ * A command can be either a `string` or an object literal. String literals represent path segments, while object literals associate data
+ * with the preceding path segment. Multiple path segments can be combined into a single command, separated by a forward slash. The first
+ * path segment supports the usage of navigational symbols such as `/`, `./`, or `../`.
+ *
+ * Example:
+ * - Navigate to the path 'path/to/view', passing two parameters:
+ *   ['path', 'to', 'view', {param1: 'value1', param2: 'value2'}]
+ * - Alternative syntax using a combined segment:
+ *   ['path/to/view', {param1: 'value1', param2: 'value2'}]
+ */
+export type Commands = any[];
+/**
+ * Navigational view states associated with a workbench navigation.
+ */
+export type ViewStates = {
+    [viewId: string]: ViewState;
+};
+/**
+ * State associated with a view navigation.
+ *
+ * State is written to the browser session history, not to the URL, so will be lost on page reload.
+ *
+ * State can be read from {@link WorkbenchView.state}, or the browser's session history via `history.state`.
+ */
+export type ViewState = {
+    [key: string]: unknown;
+};

package/lib/routing/workbench-auxiliary-routes-registrator.service.d.ts

@@ -1,4 +1,4 @@
-import { CanActivateFn, CanDeactivateFn, Data, ResolveData, Router, Routes } from '@angular/router';
+import { CanActivateFn, CanDeactivateFn, Data, Router, Routes } from '@angular/router';
 import * as i0 from "@angular/core";
 /**
  * Registers auxiliary routes for views.
@@ -29,8 +29,7 @@ export declare class WorkbenchAuxiliaryRoutesRegistrator {
  * Controls the creation of auxiliary routes for a named router outlet.
  */
 export interface OutletAuxiliaryRouteConfig {
-    canDeactivate?: CanDeactivateFn<any>[];
     canActivate?: CanActivateFn[];
+    canDeactivate?: CanDeactivateFn<any>[];
     data?: Data;
-    resolve?: ResolveData;
 }

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

@@ -0,0 +1,25 @@
+import { IterableChanges, IterableDiffers } from '@angular/core';
+import { UrlTree } from '@angular/router';
+import * as i0 from "@angular/core";
+/**
+ * Stateful differ for finding added/removed dialogs.
+ */
+export declare class WorkbenchDialogDiffer {
+    private _dialogDiffer;
+    constructor(differs: IterableDiffers);
+    /**
+     * Computes differences in the URL since last time {@link WorkbenchDialogDiffer#diff} was invoked.
+     */
+    diff(urlTree: UrlTree): WorkbenchDialogDiff;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WorkbenchDialogDiffer, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WorkbenchDialogDiffer>;
+}
+/**
+ * Lists the dialogs added/removed in the current navigation.
+ */
+export declare class WorkbenchDialogDiff {
+    readonly addedDialogOutlets: string[];
+    readonly removedDialogOutlets: string[];
+    constructor(changes: IterableChanges<string> | null);
+    toString(): string;
+}

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

@@ -1,18 +1,24 @@
-import { Dictionary } from '@scion/toolkit/util';
 import { Navigation, NavigationExtras } from '@angular/router';
+import { ViewState, ViewStates } from './routing.model';
 /**
  * Provides methods to associate {@link WorkbenchNavigationalState} with a navigation.
  */
-export declare namespace WorkbenchNavigationalStates {
+export declare const WorkbenchNavigationalStates: {
     /**
      * Returns workbench-specific state associated with given navigation, or `null` if not a workbench navigation.
      */
-    function fromNavigation(navigation: Navigation): WorkbenchNavigationalState | null;
+    readonly fromNavigation: (navigation: Navigation) => WorkbenchNavigationalState | null;
+    /**
+     * Resolves navigational state associated with a view.
+     *
+     * TODO [WB-LAYOUT] Remove when migrated to the new Router API as state is retained in layout.
+     */
+    readonly resolveViewState: (viewId: string) => ViewState | undefined;
     /**
      * Associates workbench-specific state with given navigation extras.
      */
-    function addToNavigationExtras(extras: NavigationExtras, state: WorkbenchNavigationalState): void;
-}
+    readonly addToNavigationExtras: (extras: NavigationExtras, state: WorkbenchNavigationalState) => void;
+};
 /**
  * Represents workbench-specific state associated with a navigation.
  */
@@ -28,19 +34,16 @@ export interface WorkbenchNavigationalState {
      */
     maximized: boolean;
     /**
-     * View state to be associated with the navigation.
-     * View state can be read from {@link ActivatedRoute.data} using the key {@link WorkbenchRouteData.state}.
+     * View states to be associated with the navigation.
      */
-    viewStates: {
-        [viewId: string]: Dictionary;
-    };
+    viewStates: ViewStates;
 }
 /**
  * Keys for associating state with a view navigation.
  */
-export declare namespace WorkbenchNavigationalViewStates {
+export declare const WorkbenchNavigationalViewStates: {
     /**
      * Key for associating CSS class(es) with a view state.
      */
-    const cssClass = "\u0275cssClass";
-}
+    readonly cssClass: "ɵcssClass";
+};

package/lib/routing/workbench-route-data.d.ts

@@ -3,25 +3,17 @@
  *
  * @see Route.data
  */
-export declare namespace WorkbenchRouteData {
+export declare const WorkbenchRouteData: {
     /**
      * Key to define the title of a view in {@link Route.data}.
      */
-    const title = "\u0275workbenchViewTitle";
+    readonly title: "ɵworkbenchViewTitle";
     /**
      * Key to define the heading of a view in {@link Route.data}.
      */
-    const heading = "\u0275workbenchViewHeading";
+    readonly heading: "ɵworkbenchViewHeading";
     /**
      * Key to associate CSS class(es) with a view in {@link Route.data}, useful in end-to-end tests for locating views and view tabs.
      */
-    const cssClass = "\u0275workbenchViewCssClass";
-    /**
-     * Key for reading view-specific navigational state from {@link ActivatedRoute.data}.
-     *
-     * The state object contains user-defined state passed to navigation extras.
-     *
-     * @see WorkbenchNavigationalState
-     */
-    const state = "\u0275workbenchViewState";
-}
+    readonly cssClass: "ɵworkbenchViewCssClass";
+};

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

@@ -1,9 +1,9 @@
 import { NavigationExtras, Router } from '@angular/router';
-import { Dictionary } from '@scion/toolkit/util';
 import { NgZone, OnDestroy } from '@angular/core';
 import { WorkbenchLayoutService } from '../layout/workbench-layout.service';
 import { WorkbenchViewRegistry } from '../view/workbench-view.registry';
 import { ɵWorkbenchLayout } from '../layout/ɵworkbench-layout';
+import { Commands, ViewState, ViewStates } from './routing.model';
 import * as i0 from "@angular/core";
 /**
  * Provides workbench view navigation capabilities based on Angular Router.
@@ -129,32 +129,19 @@ export interface WorkbenchNavigationExtras extends NavigationExtras {
      */
     blankInsertionIndex?: number | 'start' | 'end';
     /**
-     * State that will be passed to the navigation.
+     * Associates state with a view navigation.
      *
-     * See {@link NavigationExtras#state} for detailed instructions on how to access passed state during and after the navigation.
+     * State is written to the browser session history, not to the URL, so will be lost on page reload.
      *
-     * In addition, the workbench router makes state available to the routed component as resolved data under the key {@link WorkbenchRouteData.state}.
+     * State can be read from {@link WorkbenchView.state}, or the browser's session history via `history.state`.
      */
-    state?: Dictionary;
+    state?: ViewState;
     /**
      * Specifies CSS class(es) to be added to the view, useful in end-to-end tests for locating view and view tab.
      * CSS class(es) will not be added to the browser URL, consequently will not survive a page reload.
      */
     cssClass?: string | string[];
 }
-/**
- * An array of URL fragments with which to construct a view's URL.
- *
- * If the path is static, can be the literal URL string. For a dynamic path, pass an array of path segments,
- * followed by the parameters for each segment.
- *
- * The last segment allows adding matrix parameters in the form of a dictionary to provide additional data along
- * with the URL. Matrix parameters do not affect route resolution. In the routed component, matrix parameters are
- * available in {@link ActivatedRoute#params}.
- *
- * Example command array with 'details' as matrix parameter: `['user', userName, {details: true}]`,
- */
-export type Commands = any[];
 /**
  * Information about a workbench navigation operation.
  */
@@ -172,9 +159,7 @@ export interface WorkbenchNavigation {
         [outlet: string]: Commands | null;
     };
     /**
-     * State to be passed to the routed component as resolved data under the key {@link WorkbenchRouteData.state}.
+     * View states to be associated with the navigation.
      */
-    viewStates?: {
-        [outlet: string]: Dictionary;
-    };
+    viewStates?: ViewStates;
 }

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

@@ -9,6 +9,7 @@ import { WorkbenchLayoutDiffer } from './workbench-layout-differ';
 import { WorkbenchPopupDiffer } from './workbench-popup-differ';
 import { Logger } from '../logging';
 import { ɵWorkbenchLayoutFactory } from '../layout/ɵworkbench-layout.factory';
+import { WorkbenchDialogDiffer } from './workbench-dialog-differ';
 import * as i0 from "@angular/core";
 /**
  * Tracks the browser URL for workbench layout changes.
@@ -30,8 +31,9 @@ export declare class WorkbenchUrlObserver {
     private _workbenchLayoutFactory;
     private _workbenchLayoutDiffer;
     private _workbenchPopupDiffer;
+    private _workbenchDialogDiffer;
     private _logger;
-    constructor(_router: Router, _auxRoutesRegistrator: WorkbenchAuxiliaryRoutesRegistrator, _viewRegistry: WorkbenchViewRegistry, _partRegistry: WorkbenchPartRegistry, _workbenchLayoutService: WorkbenchLayoutService, _environmentInjector: EnvironmentInjector, _workbenchRouter: WorkbenchRouter, _workbenchLayoutFactory: ɵWorkbenchLayoutFactory, _workbenchLayoutDiffer: WorkbenchLayoutDiffer, _workbenchPopupDiffer: WorkbenchPopupDiffer, _logger: Logger);
+    constructor(_router: Router, _auxRoutesRegistrator: WorkbenchAuxiliaryRoutesRegistrator, _viewRegistry: WorkbenchViewRegistry, _partRegistry: WorkbenchPartRegistry, _workbenchLayoutService: WorkbenchLayoutService, _environmentInjector: EnvironmentInjector, _workbenchRouter: WorkbenchRouter, _workbenchLayoutFactory: ɵWorkbenchLayoutFactory, _workbenchLayoutDiffer: WorkbenchLayoutDiffer, _workbenchPopupDiffer: WorkbenchPopupDiffer, _workbenchDialogDiffer: WorkbenchDialogDiffer, _logger: Logger);
     /** Invoked at the beginning of each navigation */
     private onNavigationStart;
     /** Invoked upon successful navigation */
@@ -54,6 +56,10 @@ export declare class WorkbenchUrlObserver {
      * For each added popup, registers auxiliary routes of all primary routes.
      */
     registerAddedPopupAuxiliaryRoutes(): void;
+    /**
+     * For each added dialog, registers auxiliary routes of all primary routes.
+     */
+    registerAddedDialogAuxiliaryRoutes(): void;
     /**
      * Reverts the workbench layout differ to the state before the navigation.
      *
@@ -66,6 +72,12 @@ export declare class WorkbenchUrlObserver {
      * Invoke this method after navigation failure or cancellation. The navigation is cancelled when guards perform a redirect or reject navigation.
      */
     private undoWorkbenchPopupDiffer;
+    /**
+     * Reverts the dialog outlet differ to the state before the navigation.
+     *
+     * Invoke this method after navigation failure or cancellation. The navigation is cancelled when guards perform a redirect or reject navigation.
+     */
+    private undoWorkbenchDialogDiffer;
     /**
      * Undoes the registration of auxiliary routes.
      *

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

@@ -3,6 +3,7 @@ import { UrlSegment } from '@angular/router';
 import { Disposable } from '../common/disposable';
 import { WorkbenchMenuItem } from '../workbench.model';
 import { WorkbenchPart } from '../part/workbench-part.model';
+import { ViewState } from '../routing/routing.model';
 /**
  * A view is a visual workbench component for displaying content stacked or side-by-side.
  *
@@ -32,11 +33,7 @@ export declare abstract class WorkbenchView {
     /**
      * Specifies CSS class(es) to be added to the view, useful in end-to-end tests for locating view and view tab.
      */
-    abstract set cssClass(cssClass: string | string[]);
-    /**
-     * CSS classes associated with the view.
-     */
-    abstract readonly cssClasses: string[];
+    abstract cssClass: string | string[];
     /**
      * Specifies if the content of the current view is dirty.
      * If dirty, a dirty marker is displayed in the view tab.
@@ -77,11 +74,15 @@ export declare abstract class WorkbenchView {
      */
     abstract readonly destroyed: boolean;
     /**
-     * Returns the URL segments of this view.
-     *
-     * A {@link UrlSegment} is a part of a URL between the two slashes. It contains a path and the matrix parameters associated with the segment.
+     * URL associated with this view.
      */
     abstract readonly urlSegments: UrlSegment[];
+    /**
+     * State associated with this view.
+     *
+     * Note that state is volatile, meaning it is not encoded in the URL but read from the browser session history; thus, it will be lost when the page is reloaded.
+     */
+    abstract readonly state: ViewState;
     /**
      * Activates this view.
      *

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

@@ -6,9 +6,12 @@ import { WorkbenchView } from './workbench-view.model';
 import { WorkbenchPart } from '../part/workbench-part.model';
 import { ComponentType } from '@angular/cdk/portal';
 import { WbComponentPortal } from '../portal/wb-component-portal';
+import { AbstractType, Type } from '@angular/core';
 import { ɵWorkbenchLayout } from '../layout/ɵworkbench-layout';
 import { ɵWorkbenchDialog } from '../dialog/ɵworkbench-dialog';
 import { Blockable } from '../glass-pane/blockable';
+import { ViewState } from '../routing/routing.model';
+import { ClassList } from '../common/class-list';
 export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     readonly id: string;
     private readonly _workbenchId;
@@ -23,6 +26,7 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     private readonly _part$;
     private readonly _menuItemProviders$;
     private readonly _scrolledIntoView$;
+    private readonly _adapters;
     private readonly _destroyRef;
     private _activationInstant;
     private _closable;
@@ -31,11 +35,12 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     dirty: boolean;
     scrollTop: number;
     scrollLeft: number;
+    state: ViewState;
     readonly active$: BehaviorSubject<boolean>;
-    readonly cssClasses$: BehaviorSubject<string[]>;
     readonly menuItems$: Observable<WorkbenchMenuItem[]>;
     readonly blockedBy$: BehaviorSubject<ɵWorkbenchDialog<unknown> | null>;
     readonly portal: WbComponentPortal;
+    readonly classList: ClassList;
     constructor(id: string, options: {
         component: ComponentType<ViewComponent>;
     });
@@ -48,7 +53,7 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     get last(): boolean;
     get position(): number;
     set cssClass(cssClass: string | string[]);
-    get cssClasses(): string[];
+    get cssClass(): string[];
     get active(): boolean;
     set closable(closable: boolean);
     get closable(): boolean;
@@ -78,6 +83,20 @@ export declare class ɵWorkbenchView implements WorkbenchView, Blockable {
     }): void;
     get urlSegments(): UrlSegment[];
     registerMenuItem(menuItem: WorkbenchMenuItem): Disposable;
+    /**
+     * 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(): boolean;
     /**
      * Monitors the associated part to check if this view is currently active, updating the active state of this view accordingly.

package/lib/view-dnd/grid-drop-targets.util.d.ts

@@ -1,24 +1,22 @@
 import { ViewMoveEventTarget } from './view-drag.service';
 import { MPartGrid } from '../layout/workbench-layout.model';
-/**
- * Resolves the drop target for moving a view to the root part (or node) of a grid.
- *
- * Examples:
- * - Droping a view at the grid's boundaries (north, south, east, west).
- * - Dropping a view on the grid's start page (center).
- *
- * When dropping a view on the grid's start page, the root of the grid can be a part or a node,
- * depending on whether the grid contains structural parts.
- */
-declare function resolve(target: {
-    grid: MPartGrid;
-    dropRegion: 'west' | 'east' | 'north' | 'south' | 'center';
-    workbenchId: string;
-}): ViewMoveEventTarget;
 /**
  * Provides helper functions for dragging a view to a grid.
  */
 export declare const GridDropTargets: {
-    readonly resolve: typeof resolve;
+    /**
+     * Resolves the drop target for moving a view to the root part (or node) of a grid.
+     *
+     * Examples:
+     * - Droping a view at the grid's boundaries (north, south, east, west).
+     * - Dropping a view on the grid's start page (center).
+     *
+     * When dropping a view on the grid's start page, the root of the grid can be a part or a node,
+     * depending on whether the grid contains structural parts.
+     */
+    readonly resolve: (target: {
+        grid: MPartGrid;
+        dropRegion: 'west' | 'east' | 'north' | 'south' | 'center';
+        workbenchId: string;
+    }) => ViewMoveEventTarget;
 };
-export {};

package/lib/view-dnd/view-drag.service.d.ts

@@ -1,6 +1,7 @@
 import { NgZone, OnDestroy } from '@angular/core';
 import { Observable } from 'rxjs';
 import { UrlSegment } from '@angular/router';
+import { ClassListMap } from '../common/class-list';
 import * as i0 from "@angular/core";
 /**
  * Events fired during view drag and drop operation.
@@ -130,6 +131,7 @@ export interface ViewDragData {
     viewTabWidth: number;
     viewTabHeight: number;
     workbenchId: string;
+    classList?: ClassListMap;
 }
 /**
  * Event emitted when moving a view.
@@ -146,6 +148,7 @@ export interface ViewMoveEventSource {
     partId: string;
     viewUrlSegments: UrlSegment[];
     workbenchId: string;
+    classList?: ClassListMap;
 }
 /**
  * Describes the target location for moving a view.

package/lib/workbench.constants.d.ts

@@ -16,6 +16,10 @@ export declare const VIEW_ID_PREFIX = "view.";
  * Represents the id prefix of popups.
  */
 export declare const POPUP_ID_PREFIX = "popup.";
+/**
+ * Represents the id prefix of dialogs.
+ */
+export declare const DIALOG_ID_PREFIX = "dialog.";
 /**
  * Name of the query parameter that contains the layout of the main area.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scion/workbench",
-  "version": "17.0.0-beta.6",
+  "version": "17.0.0-beta.7",
   "description": "SCION Workbench enables the creation of Angular web applications that require a flexible layout to arrange content side-by-side or stacked, all personalizable by the user via drag & drop.",
   "license": "EPL-2.0",
   "private": false,
@@ -39,7 +39,7 @@
     "@scion/components": "^17.0.0",
     "@scion/toolkit": "^1.4.0",
     "@scion/microfrontend-platform": "^1.2.1",
-    "@scion/workbench-client": "^1.0.0-beta.20",
+    "@scion/workbench-client": "^1.0.0-beta.21",
     "rxjs": "^7.8.0"
   },
   "peerDependenciesMeta": {

package/esm2022/lib/microfrontend-platform/microfrontend-popup/microfrontend-popup-capability-interceptor.service.mjs

@@ -1,30 +0,0 @@
-import { Injectable } from '@angular/core';
-import { WorkbenchCapabilities } from '@scion/workbench-client';
-import * as i0 from "@angular/core";
-/**
- * Asserts popup capabilities to have required properties.
- */
-export class MicrofrontendPopupCapabilityInterceptor {
-    async intercept(capability) {
-        if (capability.type !== WorkbenchCapabilities.Popup) {
-            return capability;
-        }
-        const popupCapability = capability;
-        // Assert the popup capability to have a qualifier set.
-        if (!popupCapability.qualifier || !Object.keys(popupCapability.qualifier).length) {
-            throw Error(`[NullQualifierError] Popup capability requires a qualifier [capability=${JSON.stringify(popupCapability)}]`);
-        }
-        // Assert the popup capability to have a path set.
-        const path = popupCapability.properties?.path;
-        if (path === undefined || path === null) {
-            throw Error(`[NullPathError] Popup capability requires a path to the microfrontend in its properties [capability=${JSON.stringify(popupCapability)}]`);
-        }
-        return popupCapability;
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.0.3", ngImport: i0, type: MicrofrontendPopupCapabilityInterceptor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.0.3", ngImport: i0, type: MicrofrontendPopupCapabilityInterceptor }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.0.3", ngImport: i0, type: MicrofrontendPopupCapabilityInterceptor, decorators: [{
-            type: Injectable
-        }] });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWljcm9mcm9udGVuZC1wb3B1cC1jYXBhYmlsaXR5LWludGVyY2VwdG9yLnNlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9wcm9qZWN0cy9zY2lvbi93b3JrYmVuY2gvc3JjL2xpYi9taWNyb2Zyb250ZW5kLXBsYXRmb3JtL21pY3JvZnJvbnRlbmQtcG9wdXAvbWljcm9mcm9udGVuZC1wb3B1cC1jYXBhYmlsaXR5LWludGVyY2VwdG9yLnNlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBV0EsT0FBTyxFQUFDLFVBQVUsRUFBQyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUMscUJBQXFCLEVBQTJCLE1BQU0seUJBQXlCLENBQUM7O0FBRXhGOztHQUVHO0FBRUgsTUFBTSxPQUFPLHVDQUF1QztJQUUzQyxLQUFLLENBQUMsU0FBUyxDQUFDLFVBQXNCO1FBQzNDLElBQUksVUFBVSxDQUFDLElBQUksS0FBSyxxQkFBcUIsQ0FBQyxLQUFLLEVBQUU7WUFDbkQsT0FBTyxVQUFVLENBQUM7U0FDbkI7UUFFRCxNQUFNLGVBQWUsR0FBRyxVQUFzQyxDQUFDO1FBQy9ELHVEQUF1RDtRQUN2RCxJQUFJLENBQUMsZUFBZSxDQUFDLFNBQVMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLFNBQVMsQ0FBQyxDQUFDLE1BQU0sRUFBRTtZQUNoRixNQUFNLEtBQUssQ0FBQywwRUFBMEUsSUFBSSxDQUFDLFNBQVMsQ0FBQyxlQUFlLENBQUMsR0FBRyxDQUFDLENBQUM7U0FDM0g7UUFFRCxrREFBa0Q7UUFDbEQsTUFBTSxJQUFJLEdBQUcsZUFBZSxDQUFDLFVBQVUsRUFBRSxJQUFJLENBQUM7UUFDOUMsSUFBSSxJQUFJLEtBQUssU0FBUyxJQUFJLElBQUksS0FBSyxJQUFJLEVBQUU7WUFDdkMsTUFBTSxLQUFLLENBQUMsdUdBQXVHLElBQUksQ0FBQyxTQUFTLENBQUMsZUFBZSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1NBQ3hKO1FBRUQsT0FBTyxlQUFlLENBQUM7SUFDekIsQ0FBQzs4R0FwQlUsdUNBQXVDO2tIQUF2Qyx1Q0FBdUM7OzJGQUF2Qyx1Q0FBdUM7a0JBRG5ELFVBQVUiLCJzb3VyY2VzQ29udGVudCI6WyIvKlxuICogQ29weXJpZ2h0IChjKSAyMDE4LTIwMjIgU3dpc3MgRmVkZXJhbCBSYWlsd2F5c1xuICpcbiAqIFRoaXMgcHJvZ3JhbSBhbmQgdGhlIGFjY29tcGFueWluZyBtYXRlcmlhbHMgYXJlIG1hZGVcbiAqIGF2YWlsYWJsZSB1bmRlciB0aGUgdGVybXMgb2YgdGhlIEVjbGlwc2UgUHVibGljIExpY2Vuc2UgMi4wXG4gKiB3aGljaCBpcyBhdmFpbGFibGUgYXQgaHR0cHM6Ly93d3cuZWNsaXBzZS5vcmcvbGVnYWwvZXBsLTIuMC9cbiAqXG4gKiBTUERYLUxpY2Vuc2UtSWRlbnRpZmllcjogRVBMLTIuMFxuICovXG5cbmltcG9ydCB7Q2FwYWJpbGl0eSwgQ2FwYWJpbGl0eUludGVyY2VwdG9yfSBmcm9tICdAc2Npb24vbWljcm9mcm9udGVuZC1wbGF0Zm9ybSc7XG5pbXBvcnQge0luamVjdGFibGV9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xuaW1wb3J0IHtXb3JrYmVuY2hDYXBhYmlsaXRpZXMsIFdvcmtiZW5jaFBvcHVwQ2FwYWJpbGl0eX0gZnJvbSAnQHNjaW9uL3dvcmtiZW5jaC1jbGllbnQnO1xuXG4vKipcbiAqIEFzc2VydHMgcG9wdXAgY2FwYWJpbGl0aWVzIHRvIGhhdmUgcmVxdWlyZWQgcHJvcGVydGllcy5cbiAqL1xuQEluamVjdGFibGUoLyogRE8gTk9UIFBST1ZJREUgdmlhICdwcm92aWRlZEluJyBtZXRhZGF0YSBhcyBvbmx5IHJlZ2lzdGVyZWQgaWYgbWljcm9mcm9udGVuZCBzdXBwb3J0IGlzIGVuYWJsZWQuICovKVxuZXhwb3J0IGNsYXNzIE1pY3JvZnJvbnRlbmRQb3B1cENhcGFiaWxpdHlJbnRlcmNlcHRvciBpbXBsZW1lbnRzIENhcGFiaWxpdHlJbnRlcmNlcHRvciB7XG5cbiAgcHVibGljIGFzeW5jIGludGVyY2VwdChjYXBhYmlsaXR5OiBDYXBhYmlsaXR5KTogUHJvbWlzZTxDYXBhYmlsaXR5PiB7XG4gICAgaWYgKGNhcGFiaWxpdHkudHlwZSAhPT0gV29ya2JlbmNoQ2FwYWJpbGl0aWVzLlBvcHVwKSB7XG4gICAgICByZXR1cm4gY2FwYWJpbGl0eTtcbiAgICB9XG5cbiAgICBjb25zdCBwb3B1cENhcGFiaWxpdHkgPSBjYXBhYmlsaXR5IGFzIFdvcmtiZW5jaFBvcHVwQ2FwYWJpbGl0eTtcbiAgICAvLyBBc3NlcnQgdGhlIHBvcHVwIGNhcGFiaWxpdHkgdG8gaGF2ZSBhIHF1YWxpZmllciBzZXQuXG4gICAgaWYgKCFwb3B1cENhcGFiaWxpdHkucXVhbGlmaWVyIHx8ICFPYmplY3Qua2V5cyhwb3B1cENhcGFiaWxpdHkucXVhbGlmaWVyKS5sZW5ndGgpIHtcbiAgICAgIHRocm93IEVycm9yKGBbTnVsbFF1YWxpZmllckVycm9yXSBQb3B1cCBjYXBhYmlsaXR5IHJlcXVpcmVzIGEgcXVhbGlmaWVyIFtjYXBhYmlsaXR5PSR7SlNPTi5zdHJpbmdpZnkocG9wdXBDYXBhYmlsaXR5KX1dYCk7XG4gICAgfVxuXG4gICAgLy8gQXNzZXJ0IHRoZSBwb3B1cCBjYXBhYmlsaXR5IHRvIGhhdmUgYSBwYXRoIHNldC5cbiAgICBjb25zdCBwYXRoID0gcG9wdXBDYXBhYmlsaXR5LnByb3BlcnRpZXM/LnBhdGg7XG4gICAgaWYgKHBhdGggPT09IHVuZGVmaW5lZCB8fCBwYXRoID09PSBudWxsKSB7XG4gICAgICB0aHJvdyBFcnJvcihgW051bGxQYXRoRXJyb3JdIFBvcHVwIGNhcGFiaWxpdHkgcmVxdWlyZXMgYSBwYXRoIHRvIHRoZSBtaWNyb2Zyb250ZW5kIGluIGl0cyBwcm9wZXJ0aWVzIFtjYXBhYmlsaXR5PSR7SlNPTi5zdHJpbmdpZnkocG9wdXBDYXBhYmlsaXR5KX1dYCk7XG4gICAgfVxuXG4gICAgcmV0dXJuIHBvcHVwQ2FwYWJpbGl0eTtcbiAgfVxufVxuIl19