@openfin/core 28.71.14 → 28.71.17

package/OpenFin.d.ts

@@ -254,6 +254,19 @@ declare namespace OpenFin {
 
     export type WindowOptions = MutableWindowOptions & ConstWindowOptions;
 
+    export interface ShowViewOnWindowResizeOptions {
+        enabled?: boolean;
+        paintIntervalMs?: number;
+    }
+
+    export interface ShowViewOnSplitterDragOptions {
+        enabled?: boolean;
+    }
+    export type ViewVisibilityOptions = {
+        showViewsOnWindowResize?: ShowViewOnWindowResizeOptions;
+        showViewsOnSplitterDrag?: ShowViewOnSplitterDragOptions;
+    };
+
     export type WindowState = 'maximized' | 'minimized' | 'normal';
 
     export type ConstWindowOptions = {
@@ -294,6 +307,8 @@ declare namespace OpenFin {
         y: number;
         experimental?: any;
         fdc3InteropApi?: string;
+        // Platform only
+        viewVisibility?: ViewVisibilityOptions;
     };
 
     export type MutableWindowOptions = {
@@ -1114,6 +1129,7 @@ declare namespace OpenFin {
     export type RvmLaunchOptions = {
         noUi?: boolean;
         userAppConfigArgs?: object;
+        timeToLive?: number;
     };
 
     export type ShortCutConfig = {
@@ -1692,4 +1708,14 @@ declare namespace OpenFin {
         | 'navigateForward'
         | 'navigateBack'
         | 'print';
+
+    export type InteropBrokerDisconnectionEvent = {
+        type: string;
+        topic: string;
+        brokerName: string;
+    };
+
+    export type InteropClientOnDisconnectionListener = (
+        InteropBrokerDisconnectionEvent: InteropBrokerDisconnectionEvent
+    ) => any;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "28.71.14",
+    "version": "28.71.17",
     "license": "Apache-2.0",
     "main": "./src/mock.js",
     "types": "./src/mock.d.ts",

package/src/api/application/Factory.d.ts

@@ -111,12 +111,13 @@ export default class ApplicationModule extends Base {
      * Asynchronously starts a batch of applications given an array of application identifiers and manifestUrls.
      * Returns once the RVM is finished attempting to launch the applications.
      * @param { Array.<ManifestInfo> } applications
+     * @param {RvmLaunchOptions} [opts] - Parameters that the RVM will use.
      * @return {Promise.<void>}
      * @static
      * @tutorial Application.startManyManifests
      * @experimental
      */
-    startManyManifests(applications: Array<OpenFin.ManifestInfo>): Promise<void>;
+    startManyManifests(applications: Array<OpenFin.ManifestInfo>, opts?: OpenFin.RvmLaunchOptions): Promise<void>;
     /**
      * Asynchronously returns an Application object that represents the current application
      * @return {Promise.<Application>}

package/src/api/application/Factory.js

@@ -156,13 +156,14 @@ class ApplicationModule extends base_1.Base {
      * Asynchronously starts a batch of applications given an array of application identifiers and manifestUrls.
      * Returns once the RVM is finished attempting to launch the applications.
      * @param { Array.<ManifestInfo> } applications
+     * @param {RvmLaunchOptions} [opts] - Parameters that the RVM will use.
      * @return {Promise.<void>}
      * @static
      * @tutorial Application.startManyManifests
      * @experimental
      */
-    async startManyManifests(applications) {
-        return this.wire.sendAction('run-applications', { applications }).then(() => undefined);
+    async startManyManifests(applications, opts) {
+        return this.wire.sendAction('run-applications', { applications, opts }).then(() => undefined);
     }
     /**
      * Asynchronously returns an Application object that represents the current application

package/src/api/application/Instance.d.ts

@@ -264,6 +264,12 @@ export declare class Application extends EmitterBase<OpenFin.ApplicationEvents>
      * @tutorial Application.getTrayIconInfo
      */
     getTrayIconInfo(): Promise<OpenFin.TrayInfo>;
+    /**
+     * @summary Checks if the application has an associated tray icon.
+     * @return {Promise.<boolean>}
+     * @tutorial Application.hasTrayIcon
+     */
+    hasTrayIcon(): Promise<boolean>;
     /**
      * Closes the application by terminating its process.
      * @return {Promise.<void>}

package/src/api/application/Instance.js

@@ -363,6 +363,14 @@ class Application extends base_1.EmitterBase {
     getTrayIconInfo() {
         return this.wire.sendAction('get-tray-icon-info', this.identity).then(({ payload }) => payload.data);
     }
+    /**
+     * @summary Checks if the application has an associated tray icon.
+     * @return {Promise.<boolean>}
+     * @tutorial Application.hasTrayIcon
+     */
+    hasTrayIcon() {
+        return this.wire.sendAction('has-tray-icon', this.identity).then(({ payload }) => payload.data);
+    }
     /**
      * Closes the application by terminating its process.
      * @return {Promise.<void>}

package/src/api/interop/Factory.d.ts

@@ -33,5 +33,5 @@ export default class InteropModule extends Base {
      * @experimental
      * @static
      */
-    connectSync(name: string, interopConfig: OpenFin.InteropConfig): InteropClient;
+    connectSync(name: string, interopConfig?: OpenFin.InteropConfig): InteropClient;
 }

package/src/api/interop/Factory.js

@@ -29,10 +29,16 @@ class InteropModule extends base_1.Base {
         this.wire.sendAction('interop-init').catch((e) => {
             // don't expose, analytics-only call
         });
-        const provider = await this.fin.InterApplicationBus.Channel.create(`interop-broker-${name}`);
         // Allows for manifest-level configuration, without having to override. (e.g. specifying custom context groups)
         const options = await this.fin.Application.getCurrentSync().getInfo();
-        return override(InteropBroker_1.InteropBroker, this.wire, provider, options.initialOptions.interopBrokerConfiguration || {});
+        let provider;
+        const getProvider = () => {
+            if (!provider) {
+                provider = this.fin.InterApplicationBus.Channel.create(`interop-broker-${name}`);
+            }
+            return provider;
+        };
+        return override(InteropBroker_1.InteropBroker, this.wire, getProvider, options.initialOptions.interopBrokerConfiguration || {});
     }
     /**
      * Connects a client to an Interop broker. This is called under-the-hood for Views in a Platform.

package/src/api/interop/InteropBroker.d.ts

@@ -124,13 +124,14 @@ import Identity = OpenFin.Identity;
  * @class
  */
 export declare class InteropBroker extends Base {
-    private channel;
+    private getProvider;
     private interopClients;
     private contextGroupsById;
     private intentClientMap;
     private lastContextMap;
     private sessionContextGroupMap;
-    constructor(wire: Transport, channel: OpenFin.ChannelProvider, options?: any);
+    private channel;
+    constructor(wire: Transport, getProvider: () => Promise<OpenFin.ChannelProvider>, options?: any);
     /**
      * SetContextOptions interface
      * @typedef { object } SetContextOptions
@@ -314,6 +315,13 @@ export declare class InteropBroker extends Base {
      * @experimental
      */
     handleFiredIntentForContext(contextForIntent: OpenFin.ContextForIntent, clientIdentity: OpenFin.ClientIdentity): Promise<unknown>;
+    /**
+     * Provides the identity of any Interop Client that disconnects from the Interop Broker. It is meant to be overriden.
+     * @param clientIdentity
+     * @return { Promise<void> }
+     * @tutorial interop.clientDisconnected
+     */
+    clientDisconnected(clientIdentity: OpenFin.ClientIdentity): Promise<void>;
     decorateSnapshot(snapshot: OpenFin.Snapshot): OpenFin.Snapshot;
     applySnapshot(snapshot: OpenFin.Snapshot, options: OpenFin.ApplySnapshotOptions): void;
     updateExistingClients(contextGroupStates: OpenFin.ContextGroupStates): void;
@@ -345,6 +353,7 @@ export declare class InteropBroker extends Base {
     static isContextTypeCompatible(contextType: string, registeredContextType: string | undefined): boolean;
     private setContextGroupMap;
     private static setCurrentContextGroupInClientOptions;
+    private setupChannelProvider;
     private wireChannel;
     /**
      * Can be used to completely prevent a connection. Return false to prevent connections. Allows all connections by default.

package/src/api/interop/InteropBroker.js

@@ -171,9 +171,9 @@ let contextGroups = [
  * @class
  */
 class InteropBroker extends base_1.Base {
-    constructor(wire, channel, options) {
+    constructor(wire, getProvider, options) {
         super(wire);
-        this.channel = channel;
+        this.getProvider = getProvider;
         this.interopClients = new Map();
         this.contextGroupsById = new Map();
         if (options.contextGroups) {
@@ -183,7 +183,7 @@ class InteropBroker extends base_1.Base {
         this.lastContextMap = new Map();
         this.sessionContextGroupMap = new Map();
         this.setContextGroupMap();
-        this.wireChannel(channel);
+        this.setupChannelProvider();
     }
     /*
     Client API
@@ -321,19 +321,24 @@ class InteropBroker extends base_1.Base {
                 await this.addClientToContextGroup({ contextGroupId }, target);
             }
             // Sanity check here in case a single app has multiple connections
-            const allConnections = this.channel.connections.filter((x) => x.uuid === target.uuid && x.name === target.name);
-            if (!allConnections.length) {
-                throw new Error(`Given Identity ${target.uuid} ${target.name} is not connected to the Interop Broker.`);
-            }
-            if (allConnections.length > 1) {
-                // Should figure out how we want to handle this situation. In the meantime, just change context group for all connections.
-                console.warn(`More than one connection found for identity ${target.uuid} ${target.name}`);
+            try {
+                const allConnections = this.channel.connections.filter((x) => x.uuid === target.uuid && x.name === target.name);
+                if (!allConnections.length) {
+                    throw new Error(`Given Identity ${target.uuid} ${target.name} is not connected to the Interop Broker.`);
+                }
+                if (allConnections.length > 1) {
+                    // Should figure out how we want to handle this situation. In the meantime, just change context group for all connections.
+                    console.warn(`More than one connection found for identity ${target.uuid} ${target.name}`);
+                }
+                const promises = [];
+                for (const connection of allConnections) {
+                    promises.push(this.addClientToContextGroup({ contextGroupId }, connection));
+                }
+                await Promise.all(promises);
             }
-            const promises = [];
-            for (const connection of allConnections) {
-                promises.push(this.addClientToContextGroup({ contextGroupId }, connection));
+            catch (error) {
+                throw new Error(error);
             }
-            await Promise.all(promises);
         }
         else {
             // No target provided, add the sender to the context group.
@@ -402,19 +407,24 @@ class InteropBroker extends base_1.Base {
             if (InteropBroker.hasEndpointId(target)) {
                 await this.removeClientFromContextGroup(target);
             }
-            // Sanity check here in case a single app has multiple connections
-            const allConnections = this.channel.connections.filter((x) => x.uuid === target.uuid && x.name === target.name);
-            if (!allConnections.length) {
-                throw new Error(`No connection found for given Identity ${target.uuid} ${target.name}`);
-            }
-            if (allConnections.length > 1) {
-                console.warn(`More than one connection found for identity ${target.uuid} ${target.name}`);
+            try {
+                // Sanity check here in case a single app has multiple connections
+                const allConnections = this.channel.connections.filter((x) => x.uuid === target.uuid && x.name === target.name);
+                if (!allConnections.length) {
+                    throw new Error(`No connection found for given Identity ${target.uuid} ${target.name}`);
+                }
+                if (allConnections.length > 1) {
+                    console.warn(`More than one connection found for identity ${target.uuid} ${target.name}`);
+                }
+                const promises = [];
+                for (const connection of allConnections) {
+                    promises.push(this.removeClientFromContextGroup(connection));
+                }
+                await Promise.all(promises);
             }
-            const promises = [];
-            for (const connection of allConnections) {
-                promises.push(this.removeClientFromContextGroup(connection));
+            catch (error) {
+                throw new Error(error);
             }
-            await Promise.all(promises);
         }
         else {
             // No target provided, remove the sender from the context group.
@@ -592,6 +602,17 @@ class InteropBroker extends base_1.Base {
         console.warn(warning);
         throw new Error(utils_1.BROKER_ERRORS.fireIntentForContext);
     }
+    /**
+     * Provides the identity of any Interop Client that disconnects from the Interop Broker. It is meant to be overriden.
+     * @param clientIdentity
+     * @return { Promise<void> }
+     * @tutorial interop.clientDisconnected
+     */
+    // eslint-disable-next-line class-methods-use-this
+    async clientDisconnected(clientIdentity) {
+        // This function is called in channel.onDisconnection.
+        // It is meant to be overridden to inform when an Interop Client has been disconnected.
+    }
     /*
     Snapshot APIs
     */
@@ -706,8 +727,10 @@ class InteropBroker extends base_1.Base {
     }
     // Used to invoke a client's context handler
     invokeContextHandler(clientIdentity, handlerId, context) {
-        this.channel.dispatch(clientIdentity, handlerId, context).catch((e) => {
-            console.error(`Error invoking context handler ${handlerId} for context type ${context.type} in client ${clientIdentity.uuid}/${clientIdentity.name}/${clientIdentity.endpointId}`, e);
+        this.getProvider().then((channel) => {
+            channel.dispatch(clientIdentity, handlerId, context).catch((e) => {
+                console.error(`Error invoking context handler ${handlerId} for context type ${context.type} in client ${clientIdentity.uuid}/${clientIdentity.name}/${clientIdentity.endpointId}`, e);
+            });
         });
     }
     // Used to remove a context handler for a client
@@ -826,6 +849,16 @@ class InteropBroker extends base_1.Base {
             console.warn(`Setting Current Context Group: Entity with identity ${clientIdentity.uuid}, ${clientIdentity.name} is not a window or view. It is a ${entityInfo.entityType} instead.`);
         }
     }
+    async setupChannelProvider() {
+        try {
+            const channel = await this.getProvider();
+            this.channel = channel;
+            this.wireChannel(channel);
+        }
+        catch (error) {
+            throw new Error(`Error setting up Interop Broker Channel Provider: ${error}`);
+        }
+    }
     // Setup Channel Connection Logic
     wireChannel(channel) {
         channel.onConnection((clientIdentity, payload) => {
@@ -857,6 +890,7 @@ class InteropBroker extends base_1.Base {
             this.sessionContextGroupMap.forEach((sessionContextGroup) => {
                 sessionContextGroup.onDisconnection(clientIdentity);
             });
+            this.clientDisconnected(clientIdentity);
         });
         // eslint-disable-next-line @typescript-eslint/ban-ts-ignore
         // @ts-ignore

package/src/api/interop/InteropClient.d.ts

@@ -138,7 +138,7 @@ import { Base } from '../base';
  */
 export declare class InteropClient extends Base {
     #private;
-    constructor(wire: Transport, name: string, interopConfig: OpenFin.InteropConfig);
+    constructor(wire: Transport, name: string, interopConfig?: OpenFin.InteropConfig);
     /**
      * Sets a context for the context group of the current entity.
      * @param { Context } context - New context to set.
@@ -264,5 +264,12 @@ export declare class InteropClient extends Base {
      * @experimental
      */
     joinSessionContextGroup(sessionContextGroupId: string): Promise<OpenFin.SessionContextGroup>;
-    private wrapIntentHandler;
+    /**
+     * Register a listener that is called when the Interop Client has been disconnected from the Interop Broker.
+     * Only one listener per Interop Client can be set.
+     * @param listener
+     * @return { Promise<void> }
+     * @tutorial interop.onDisconnection
+     */
+    onDisconnection(listener: OpenFin.InteropClientOnDisconnectionListener): Promise<void>;
 }

package/src/api/interop/InteropClient.js

@@ -155,7 +155,7 @@ const utils_1 = require("./utils");
  * @class
  */
 class InteropClient extends base_1.Base {
-    constructor(wire, name, interopConfig) {
+    constructor(wire, name, interopConfig = {}) {
         super(wire);
         _clientPromise.set(this, void 0);
         _sessionContextGroups.set(this, void 0);
@@ -193,6 +193,9 @@ class InteropClient extends base_1.Base {
         this.wire.sendAction('interop-client-add-context-handler').catch((e) => {
             // don't expose, analytics-only call
         });
+        if (typeof handler !== 'function') {
+            throw new Error("Non-function argument passed to the first parameter 'handler'. Be aware that the argument order does not match the FDC3 standard.");
+        }
         const client = await __classPrivateFieldGet(this, _clientPromise);
         let handlerId;
         if (contextType) {
@@ -327,7 +330,7 @@ class InteropClient extends base_1.Base {
         });
         const client = await __classPrivateFieldGet(this, _clientPromise);
         const handlerId = `intent-handler-${intentName}`;
-        const wrappedHandler = this.wrapIntentHandler(handler, handlerId);
+        const wrappedHandler = utils_1.wrapIntentHandler(handler, handlerId);
         try {
             await client.register(handlerId, wrappedHandler);
             await client.dispatch('intentHandlerRegistered', { handlerId });
@@ -430,20 +433,22 @@ class InteropClient extends base_1.Base {
             throw error;
         }
     }
-    /*
-    Internal Utilties
-    */
-    // eslint-disable-next-line class-methods-use-this
-    wrapIntentHandler(handler, handlerId) {
-        return async (intent) => {
-            try {
-                await handler(intent);
-            }
-            catch (error) {
-                console.error(`Error thrown by handler ${handlerId}: ${error}`);
-                throw error;
-            }
-        };
+    /**
+     * Register a listener that is called when the Interop Client has been disconnected from the Interop Broker.
+     * Only one listener per Interop Client can be set.
+     * @param listener
+     * @return { Promise<void> }
+     * @tutorial interop.onDisconnection
+     */
+    async onDisconnection(listener) {
+        this.wire.sendAction('interop-client-add-ondisconnection-listener').catch((e) => {
+            // don't expose, analytics-only call
+        });
+        const client = await __classPrivateFieldGet(this, _clientPromise);
+        return client.onDisconnection((event) => {
+            const { uuid } = event;
+            listener({ type: 'interop-broker', topic: 'disconnected', brokerName: uuid });
+        });
     }
 }
 exports.InteropClient = InteropClient;

package/src/api/interop/SessionContextGroupClient.js

@@ -53,6 +53,9 @@ class SessionContextGroupClient extends base_1.Base {
         this.wire.sendAction('interop-session-context-group-add-handler').catch((e) => {
             // don't expose, analytics-only call
         });
+        if (typeof contextHandler !== 'function') {
+            throw new Error("Non-function argument passed to the first parameter 'handler'. Be aware that the argument order does not match the FDC3 standard.");
+        }
         const client = await __classPrivateFieldGet(this, _clientPromise);
         let handlerId;
         if (contextType) {

package/src/api/interop/utils.d.ts

@@ -9,3 +9,4 @@ export declare const BROKER_ERRORS: {
     getInfoForIntent: string;
     getInfoForIntentsByContext: string;
 };
+export declare const wrapIntentHandler: (handler: OpenFin.IntentHandler, handlerId: string) => (intent: OpenFin.Intent) => Promise<void>;

package/src/api/interop/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BROKER_ERRORS = exports.generateOverrideWarning = exports.generateOverrideError = exports.wrapContextHandler = exports.wrapInTryCatch = exports.generateId = void 0;
+exports.wrapIntentHandler = exports.BROKER_ERRORS = exports.generateOverrideWarning = exports.generateOverrideError = exports.wrapContextHandler = exports.wrapInTryCatch = exports.generateId = void 0;
 exports.generateId = () => `${Math.random()}${Date.now()}`;
 exports.wrapInTryCatch = (f, prefix) => (...args) => {
     try {
@@ -34,3 +34,14 @@ exports.BROKER_ERRORS = {
     getInfoForIntent: exports.generateOverrideError('getInfoForIntent', 'handleInfoForIntent'),
     getInfoForIntentsByContext: exports.generateOverrideError('getInfoForIntentsByContext', 'handleInfoForIntentsByContext')
 };
+exports.wrapIntentHandler = (handler, handlerId) => {
+    return async (intent) => {
+        try {
+            await handler(intent);
+        }
+        catch (error) {
+            console.error(`Error thrown by handler ${handlerId}: ${error}`);
+            throw error;
+        }
+    };
+};

package/src/api/platform/layout/Factory.js

@@ -18,6 +18,8 @@ exports.LayoutModule = void 0;
 /* eslint-disable no-undef, import/prefer-default-export */
 const Instance_1 = require("./Instance");
 const base_1 = require("../../base");
+const SplitterController_1 = require("./SplitterController");
+const view_overlay_1 = require("./SplitterController/view-overlay");
 /**
  * InitLayoutOptions interface
  * @typedef { object } InitLayoutOptions
@@ -105,7 +107,9 @@ class LayoutModule extends base_1.Base {
             }
             // We need to go through environment to make sure it is only imported/bundled in OpenFin.
             const ManagerConstructor = await this.wire.environment.getManagerConstructor();
-            __classPrivateFieldSet(this, _layoutManager, new ManagerConstructor());
+            const viewOverlay = new view_overlay_1.ViewOverlay(this.wire);
+            const splitterController = new SplitterController_1.SplitterController(viewOverlay);
+            __classPrivateFieldSet(this, _layoutManager, new ManagerConstructor(splitterController));
             // eslint-disable-next-line @typescript-eslint/ban-ts-ignore
             // @ts-ignore - layout warning here for backwards compatibility, can remove layout check in .52
             let { layout, containerId } = options;

package/src/api/platform/layout/SplitterController/bounds-observer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Observes the bounding client box rectangle of the given element for changes.
+ *
+ * This solution only works for 2 scenarios, though could be updated to support more
+ * (e.g. via polling).
+ *
+ * MutationObserver will only pick up changes to bounds if they are specified via fixed
+ * style rules in the element's attribtues.
+ *
+ * ResizeObserver will pick up all changes to an element's width and height but will not capture
+ * any changes to position.
+ *
+ * @param element The element to observe the bounding box for (i.e. position, width, height)
+ * @param onChange Called every time the bounding box changes.
+ * @returns Function which disposes the observers when invoked.
+ */
+export declare const observeBounds: (element: Element, onChange: (bounds: DOMRect) => void) => () => void;

package/src/api/platform/layout/SplitterController/bounds-observer.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.observeBounds = void 0;
+/**
+ * Observes the bounding client box rectangle of the given element for changes.
+ *
+ * This solution only works for 2 scenarios, though could be updated to support more
+ * (e.g. via polling).
+ *
+ * MutationObserver will only pick up changes to bounds if they are specified via fixed
+ * style rules in the element's attribtues.
+ *
+ * ResizeObserver will pick up all changes to an element's width and height but will not capture
+ * any changes to position.
+ *
+ * @param element The element to observe the bounding box for (i.e. position, width, height)
+ * @param onChange Called every time the bounding box changes.
+ * @returns Function which disposes the observers when invoked.
+ */
+exports.observeBounds = (element, onChange) => {
+    let lastBounds;
+    const isDomRectEqual = (a, b) => {
+        if (a.top !== b.top
+            || a.left !== b.left
+            || a.width !== b.width
+            || a.height !== b.height
+            || a.x !== b.x
+            || a.y !== b.y) {
+            return false;
+        }
+        return true;
+    };
+    const checkBounds = () => {
+        const currentBounds = element.getBoundingClientRect();
+        if (!lastBounds || !isDomRectEqual(lastBounds, currentBounds)) {
+            lastBounds = currentBounds;
+            onChange(element.getBoundingClientRect());
+        }
+    };
+    const resizeObserver = new ResizeObserver(() => checkBounds());
+    const mutationObserver = new MutationObserver(() => checkBounds());
+    resizeObserver.observe(element, { box: 'content-box' });
+    mutationObserver.observe(element, { attributes: true, attributeFilter: ['style'] });
+    checkBounds();
+    return () => {
+        resizeObserver.disconnect();
+        mutationObserver.disconnect();
+    };
+};

package/src/api/platform/layout/SplitterController/index.d.ts

@@ -0,0 +1,29 @@
+import { ViewOverlay } from './view-overlay';
+export declare type SplitterItem = GoldenLayout.ContentItem & {
+    viewEventsAdded: boolean;
+    isVertical: boolean;
+};
+/**
+ * Utility class for managing Golden Layout splitter drag interactions.
+ */
+export declare class SplitterController {
+    private readonly viewOverlay;
+    constructor(viewOverlay: ViewOverlay);
+    private teardown?;
+    private tryTeardown;
+    /**
+     * Disables the pointer events on the splitters, preventing them from being dragged.
+     */
+    preventSplitterResize: () => void;
+    /**
+     * Ends a splitter drag move, if one is in progress.
+     */
+    endMove: () => Promise<void>;
+    /**
+     * Initialises a splitter drag move, rendering a view on top of the splitter
+     * to allow it to render on top of the views within a layout (as they will always
+     * have a higher z-index to the platform window itself).
+     * @param splitterItem The Golden Layout splitter item that is currently being dragged.
+     */
+    startMove: (splitterItem: SplitterItem) => Promise<void>;
+}

package/src/api/platform/layout/SplitterController/index.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SplitterController = void 0;
+const bounds_observer_1 = require("./bounds-observer");
+const applyBoundsOffset = (bounds, offsets = {}) => {
+    const sum = (bound, offset) => {
+        return bound + (offset || 0);
+    };
+    return {
+        left: sum(bounds.left, offsets.left),
+        top: sum(bounds.top, offsets.top),
+        width: sum(bounds.width, offsets.width),
+        height: sum(bounds.height, offsets.height)
+    };
+};
+/**
+ * Utility class for managing Golden Layout splitter drag interactions.
+ */
+class SplitterController {
+    // eslint-disable-next-line
+    constructor(viewOverlay) {
+        this.viewOverlay = viewOverlay;
+        this.tryTeardown = () => {
+            if (this.teardown) {
+                this.teardown();
+                this.teardown = undefined;
+            }
+        };
+        /**
+         * Disables the pointer events on the splitters, preventing them from being dragged.
+         */
+        this.preventSplitterResize = () => {
+            document.querySelectorAll('.lm_splitter').forEach((splitter) => {
+                splitter.style.pointerEvents = 'none';
+            });
+        };
+        /**
+         * Ends a splitter drag move, if one is in progress.
+         */
+        this.endMove = async () => {
+            try {
+                this.viewOverlay.detachOverlay();
+                this.tryTeardown();
+            }
+            catch (error) {
+                throw new Error(`Failed to end splitter move: ${error.stack}`);
+            }
+        };
+        /**
+         * Initialises a splitter drag move, rendering a view on top of the splitter
+         * to allow it to render on top of the views within a layout (as they will always
+         * have a higher z-index to the platform window itself).
+         * @param splitterItem The Golden Layout splitter item that is currently being dragged.
+         */
+        this.startMove = async (splitterItem) => {
+            try {
+                if (this.teardown) {
+                    console.warn('Splitter move started before other move has been torn down.');
+                    this.tryTeardown();
+                }
+                const splitterDiv = splitterItem.element.get(0);
+                const { backgroundColor } = getComputedStyle(splitterDiv);
+                const initialVisibility = splitterDiv.style.visibility;
+                splitterDiv.style.visibility = 'hidden';
+                const onBoundsChange = (bounds) => {
+                    const offsetBounds = applyBoundsOffset(bounds, { height: splitterItem.isVertical ? 0 : 2 });
+                    this.viewOverlay.renderOverlay({ bounds: offsetBounds, backgroundColor });
+                };
+                const teardownBoundsObserver = bounds_observer_1.observeBounds(splitterDiv, onBoundsChange);
+                this.teardown = () => {
+                    teardownBoundsObserver();
+                    splitterDiv.style.visibility = initialVisibility;
+                };
+            }
+            catch (error) {
+                throw new Error(`Failed to start splitter move: ${error.stack}`);
+            }
+        };
+    }
+}
+exports.SplitterController = SplitterController;

package/src/api/platform/layout/SplitterController/view-overlay.d.ts

@@ -0,0 +1,23 @@
+import Transport from "../../../../transport/transport";
+/**
+ * Api client allowing an empty electron BrowserView to be rendered
+ * in the current window with the specified bounds.
+ *
+ * Please note, only one  view based overlay can be rendered at a time per runtime.
+ */
+export declare class ViewOverlay {
+    private wire;
+    constructor(wire: Transport);
+    /**
+     * Renders the overlay at the specified position relative to the calling window.
+     * @param options Bounds and background color to display in the overlay.
+     */
+    renderOverlay: (options: {
+        bounds: OpenFin.Bounds;
+        backgroundColor: string;
+    }) => Promise<void>;
+    /**
+     * Removes the overlay from the current window.
+     */
+    detachOverlay: () => Promise<void>;
+}

package/src/api/platform/layout/SplitterController/view-overlay.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewOverlay = void 0;
+/**
+ * Api client allowing an empty electron BrowserView to be rendered
+ * in the current window with the specified bounds.
+ *
+ * Please note, only one  view based overlay can be rendered at a time per runtime.
+ */
+class ViewOverlay {
+    // eslint-disable-next-line
+    constructor(wire) {
+        this.wire = wire;
+        /**
+         * Renders the overlay at the specified position relative to the calling window.
+         * @param options Bounds and background color to display in the overlay.
+         */
+        this.renderOverlay = async (options) => {
+            const { bounds, backgroundColor } = options;
+            await this.wire.sendAction('render-overlay', { bounds, backgroundColor });
+        };
+        /**
+         * Removes the overlay from the current window.
+         */
+        this.detachOverlay = async () => {
+            await this.wire.sendAction('detach-overlay');
+        };
+    }
+}
+exports.ViewOverlay = ViewOverlay;

package/src/api/system/index.d.ts

@@ -13,6 +13,7 @@ import EntityInfo = OpenFin.EntityInfo;
 import Entity = OpenFin.ApplicationType;
 import ApplicationState = OpenFin.ApplicationState;
 import ApplicationWindowInfo = OpenFin.ApplicationWindowInfo;
+import PrinterInfo = OpenFin.PrinterInfo;
 /**
  * AppAssetInfo interface
  * @typedef { object } AppAssetInfo
@@ -397,6 +398,7 @@ import ApplicationWindowInfo = OpenFin.ApplicationWindowInfo;
  * @typedef { object } RvmLaunchOptions
  * @property { boolean } [noUi] true if no UI when launching
  * @property { object } [userAppConfigArgs] The user app configuration args
+ * @property { number } [timeToLive] Timeout in seconds until RVM launch request expires
  */
 /**
  * ServiceIdentifier interface
@@ -957,4 +959,10 @@ export default class System extends EmitterBase<SystemEvents> {
      * @tutorial System.registerUsage
      */
     registerUsage({ data, type }: OpenFin.RegisterUsageData): Promise<void>;
+    /**
+     * Returns an array with all printers of the caller and not all the printers on the desktop.
+     * @return { Promise.Array.<PrinterInfo> }
+     * @tutorial System.getPrinters
+     */
+    getPrinters(): Promise<PrinterInfo[]>;
 }

package/src/api/system/index.js

@@ -387,6 +387,7 @@ const window_1 = require("../window");
  * @typedef { object } RvmLaunchOptions
  * @property { boolean } [noUi] true if no UI when launching
  * @property { object } [userAppConfigArgs] The user app configuration args
+ * @property { number } [timeToLive] Timeout in seconds until RVM launch request expires
  */
 /**
  * ServiceIdentifier interface
@@ -1237,5 +1238,14 @@ class System extends base_1.EmitterBase {
     async registerUsage({ data, type }) {
         await this.wire.sendAction('register-usage', { data, type });
     }
+    /**
+     * Returns an array with all printers of the caller and not all the printers on the desktop.
+     * @return { Promise.Array.<PrinterInfo> }
+     * @tutorial System.getPrinters
+     */
+    async getPrinters() {
+        const { payload } = await this.wire.sendAction('system-get-printers');
+        return payload.data;
+    }
 }
 exports.default = System;

package/src/api/view/Instance.d.ts

@@ -57,11 +57,14 @@ import UpdatableViewOptions = OpenFin.UpdatableViewOptions;
  * @property {boolean} [contextMenuSettings.reload=true] Should the context menu contain a button for reloading the page.
  *
  * @property {any} [customData=""] - _Updatable._
- * A field that the user can attach serializable data to to be ferried around with the view options.
+ * A field that the user can attach serializable data to be ferried around with the view options.
  * _When omitted, the default value of this property is the empty string (`""`)._
  *
+ * @property {any} [customContext=""] - _Updatable._
+ * A field that the user can use to attach serializable data that will be saved when {@link Platform#getSnapshot Platform.getSnapshot}
+ * is called.
  * When omitted, the default value of this property is the empty string (`""`).
- * As opposed to customData this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
+ * As opposed to customData, this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
  *
  * @property {object[]} [hotkeys=[]] - _Updatable._
  * Defines the list of hotkeys that will be emitted as a `hotkey` event on the view. For usage example see [example]{@tutorial hotkeys}.
@@ -248,6 +251,7 @@ export declare class View extends WebContents<ViewEvents> {
      */
     /**
      * Returns an array with all system printers
+     * @deprecated use System.getPrinters instead
      * @function getPrinters
      * @memberOf View
      * @instance

package/src/api/view/Instance.js

@@ -60,11 +60,14 @@ const window_1 = require("../window");
  * @property {boolean} [contextMenuSettings.reload=true] Should the context menu contain a button for reloading the page.
  *
  * @property {any} [customData=""] - _Updatable._
- * A field that the user can attach serializable data to to be ferried around with the view options.
+ * A field that the user can attach serializable data to be ferried around with the view options.
  * _When omitted, the default value of this property is the empty string (`""`)._
  *
+ * @property {any} [customContext=""] - _Updatable._
+ * A field that the user can use to attach serializable data that will be saved when {@link Platform#getSnapshot Platform.getSnapshot}
+ * is called.
  * When omitted, the default value of this property is the empty string (`""`).
- * As opposed to customData this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
+ * As opposed to customData, this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
  *
  * @property {object[]} [hotkeys=[]] - _Updatable._
  * Defines the list of hotkeys that will be emitted as a `hotkey` event on the view. For usage example see [example]{@tutorial hotkeys}.
@@ -220,6 +223,7 @@ class View extends main_1.WebContents {
          */
         /**
          * Returns an array with all system printers
+         * @deprecated use System.getPrinters instead
          * @function getPrinters
          * @memberOf View
          * @instance

package/src/api/window/Instance.d.ts

@@ -171,16 +171,16 @@ import WindowEvents = OpenFin.WindowEvents;
  * @property {number} [cornerRounding.height=0] The height in pixels.
  * @property {number} [cornerRounding.width=0] The width in pixels.
  *
- * @property {any} [customContext=""] - _Updatable._
+ * @property {any} [customContext=""] - _Updatable. Inheritable._
  * A field that the user can use to attach serializable data that will be saved when {@link Platform#getSnapshot Platform.getSnapshot}
  * is called.  If a window in a Platform is trying to update or retrieve its own context, it can use the
  * {@link Platform#setWindowContext Platform.setWindowContext} and {@link Platform#getWindowContext Platform.getWindowContext} calls.
- * When omitted, the default value of this property is the empty string (`""`).
- * As opposed to customData this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
+ * _When omitted, _inherits_ from the parent application._
+ * As opposed to customData, this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
  *
- * @property {any} [customData=""] - _Updatable._
- * A field that the user can attach serializable data to to be ferried around with the window options.
- * _When omitted, the default value of this property is the empty string (`""`)._
+ * @property {any} [customData=""] - _Updatable. Inheritable._
+ * A field that the user can attach serializable data to be ferried around with the window options.
+ * _When omitted, _inherits_ from the parent application._
  *
  * @property {object[]} [customRequestHeaders]
  * Defines list of custom headers for requests sent by the window.
@@ -235,7 +235,7 @@ import WindowEvents = OpenFin.WindowEvents;
  *
  * @property {string} [icon] - _Updatable. Inheritable._
  * A URL for the icon to be shown in the window title bar and the taskbar.
- * _When omitted, inherits from the parent application._
+ * When omitted, inherits from the parent application._
  *  note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
  *
  * @property {number} [maxHeight=-1] - _Updatable._
@@ -333,6 +333,23 @@ import WindowEvents = OpenFin.WindowEvents;
  * @property {boolean} [waitForPageLoad=false]
  * When set to `true`, the window will not appear until the `window` object's `load` event fires.
  * When set to `false`, the window will appear immediately without waiting for content to be loaded.
+ *
+ * @property {ViewVisibility} [viewVisibility]
+ * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
+ */
+/**
+ * @typedef {Object} ViewVisibility _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
+ * @property {ShowViewsOnWindowResize} [showViewsOnWindowResize] Enables views to be shown when a Platform Window is being resized by the user.
+ * @property {ShowViewsOnSplitterDrag} [showViewsOnSplitterDrag] Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.
+ */
+/**
+ * @typedef {Object} ShowViewsOnWindowResize _Platform Windows Only_. Enables views to be shown when a Platform Window is being resized by the user.
+ * @property {boolean} [enabled=false] Enables or disables showing Views when a Platform Window is being resized.
+ * @property {number} [paintIntervalMs=0] Number of miliseconds to wait between view repaints.
+ */
+/**
+ * @typedef {Object} ShowViewsOnSplitterDrag _Platform Windows Only_. Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.
+ * @property {boolean} [enabled=false] Enables or disables showing views when the layout splitter is being dragged.
  */
 /**
  * @typedef {object} CapturePageOptions
@@ -610,6 +627,7 @@ export declare class _Window extends WebContents<WindowEvents> {
      */
     /**
      * Returns an array with all system printers
+     * @deprecated use System.getPrinters instead
      * @function getPrinters
      * @memberOf Window
      * @instance

package/src/api/window/Instance.js

@@ -178,16 +178,16 @@ const view_1 = require("../view");
  * @property {number} [cornerRounding.height=0] The height in pixels.
  * @property {number} [cornerRounding.width=0] The width in pixels.
  *
- * @property {any} [customContext=""] - _Updatable._
+ * @property {any} [customContext=""] - _Updatable. Inheritable._
  * A field that the user can use to attach serializable data that will be saved when {@link Platform#getSnapshot Platform.getSnapshot}
  * is called.  If a window in a Platform is trying to update or retrieve its own context, it can use the
  * {@link Platform#setWindowContext Platform.setWindowContext} and {@link Platform#getWindowContext Platform.getWindowContext} calls.
- * When omitted, the default value of this property is the empty string (`""`).
- * As opposed to customData this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
+ * _When omitted, _inherits_ from the parent application._
+ * As opposed to customData, this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
  *
- * @property {any} [customData=""] - _Updatable._
- * A field that the user can attach serializable data to to be ferried around with the window options.
- * _When omitted, the default value of this property is the empty string (`""`)._
+ * @property {any} [customData=""] - _Updatable. Inheritable._
+ * A field that the user can attach serializable data to be ferried around with the window options.
+ * _When omitted, _inherits_ from the parent application._
  *
  * @property {object[]} [customRequestHeaders]
  * Defines list of custom headers for requests sent by the window.
@@ -242,7 +242,7 @@ const view_1 = require("../view");
  *
  * @property {string} [icon] - _Updatable. Inheritable._
  * A URL for the icon to be shown in the window title bar and the taskbar.
- * _When omitted, inherits from the parent application._
+ * When omitted, inherits from the parent application._
  *  note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
  *
  * @property {number} [maxHeight=-1] - _Updatable._
@@ -340,6 +340,23 @@ const view_1 = require("../view");
  * @property {boolean} [waitForPageLoad=false]
  * When set to `true`, the window will not appear until the `window` object's `load` event fires.
  * When set to `false`, the window will appear immediately without waiting for content to be loaded.
+ *
+ * @property {ViewVisibility} [viewVisibility]
+ * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
+ */
+/**
+ * @typedef {Object} ViewVisibility _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
+ * @property {ShowViewsOnWindowResize} [showViewsOnWindowResize] Enables views to be shown when a Platform Window is being resized by the user.
+ * @property {ShowViewsOnSplitterDrag} [showViewsOnSplitterDrag] Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.
+ */
+/**
+ * @typedef {Object} ShowViewsOnWindowResize _Platform Windows Only_. Enables views to be shown when a Platform Window is being resized by the user.
+ * @property {boolean} [enabled=false] Enables or disables showing Views when a Platform Window is being resized.
+ * @property {number} [paintIntervalMs=0] Number of miliseconds to wait between view repaints.
+ */
+/**
+ * @typedef {Object} ShowViewsOnSplitterDrag _Platform Windows Only_. Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.
+ * @property {boolean} [enabled=false] Enables or disables showing views when the layout splitter is being dragged.
  */
 /**
  * @typedef {object} CapturePageOptions
@@ -620,6 +637,7 @@ class _Window extends main_1.WebContents {
      */
     /**
      * Returns an array with all system printers
+     * @deprecated use System.getPrinters instead
      * @function getPrinters
      * @memberOf Window
      * @instance

package/src/shapes/protocol.d.ts

@@ -68,98 +68,29 @@ export interface ProtocolMap extends ProtocolMapBase {
         request: OpenFin.Identity;
         response: void;
     };
-    'fdc3-add-context-listener': {
-        request: void;
-        response: void;
-    };
-    'fdc3-broadcast': {
-        request: void;
-        response: void;
-    };
-    'fdc3-get-system-channels': {
-        request: void;
-        response: void;
-    };
-    'fdc3-join-channel': {
-        request: void;
-        response: void;
-    };
-    'fdc3-leave-current-channel': {
-        request: void;
-        response: void;
-    };
-    'interop-connect-sync': {
-        request: void;
-        response: void;
-    };
-    'interop-client-set-context': {
-        request: void;
-        response: void;
-    };
-    'interop-client-add-context-handler': {
-        request: void;
-        response: void;
-    };
-    'interop-client-get-context-groups': {
-        request: void;
-        response: void;
-    };
-    'interop-client-join-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-client-remove-from-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-client-get-all-clients-in-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-client-get-info-for-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-add-client-to-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-get-all-clients-in-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-get-context-groups': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-get-info-for-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-is-action-authorized': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-is-connection-authorized': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-join-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-remove-client-from-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-remove-from-context-group': {
-        request: void;
-        response: void;
-    };
-    'interop-broker-set-context': {
-        request: void;
-        response: void;
-    };
+    'fdc3-add-context-listener': VoidCall;
+    'fdc3-broadcast': VoidCall;
+    'fdc3-get-system-channels': VoidCall;
+    'fdc3-join-channel': VoidCall;
+    'fdc3-leave-current-channel': VoidCall;
+    'interop-connect-sync': VoidCall;
+    'interop-client-set-context': VoidCall;
+    'interop-client-add-context-handler': VoidCall;
+    'interop-client-get-context-groups': VoidCall;
+    'interop-client-join-context-group': VoidCall;
+    'interop-client-remove-from-context-group': VoidCall;
+    'interop-client-get-all-clients-in-context-group': VoidCall;
+    'interop-client-get-info-for-context-group': VoidCall;
+    'interop-broker-add-client-to-context-group': VoidCall;
+    'interop-broker-get-all-clients-in-context-group': VoidCall;
+    'interop-broker-get-context-groups': VoidCall;
+    'interop-broker-get-info-for-context-group': VoidCall;
+    'interop-broker-is-action-authorized': VoidCall;
+    'interop-broker-is-connection-authorized': VoidCall;
+    'interop-broker-join-context-group': VoidCall;
+    'interop-broker-remove-client-from-context-group': VoidCall;
+    'interop-broker-remove-from-context-group': VoidCall;
+    'interop-broker-set-context': VoidCall;
     'query-permission-for-current-context': {
         request: {
             apiName: string;
@@ -188,7 +119,23 @@ export interface ProtocolMap extends ProtocolMapBase {
         };
         response: void;
     };
+    'render-overlay': {
+        request: {
+            bounds: OpenFin.Bounds;
+            backgroundColor: string;
+        };
+        response: void;
+    };
+    'detach-overlay': VoidCall;
+    'system-get-printers': {
+        request: void;
+        response: OpenFin.PrinterInfo[];
+    };
 }
+declare type VoidCall = {
+    request: void;
+    response: void;
+};
 interface ProtocolMapBase {
     [action: string]: {
         request: any;