@openfin/core 28.71.8 → 28.71.9

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 = {
@@ -301,7 +316,9 @@ declare namespace OpenFin {
         alwaysOnTop: boolean;
         aspectRatio: number;
         contextMenu: boolean;
+        // DEPRECATED
         contextMenuSettings: ContextMenuSettings;
+        contextMenuOptions: ContextMenuOptions;
         cornerRounding: Partial<CornerRounding>;
         customContext: any;
         customData: any;
@@ -401,6 +418,7 @@ declare namespace OpenFin {
         green: number;
     };
 
+    // DEPRECATED
     export type ContextMenuSettings = {
         enable: boolean;
         devtools?: boolean;
@@ -469,7 +487,10 @@ declare namespace OpenFin {
 
     export type MutableViewOptions = {
         autoResize: AutoResizeOptions;
+        contextMenu: boolean;
+        // DEPRECATED
         contextMenuSettings: ContextMenuSettings;
+        contextMenuOptions: ContextMenuOptions;
         backgroundColor: string;
         customData: any;
         customContext: any;
@@ -1324,6 +1345,7 @@ declare namespace OpenFin {
          * Defaults to 'normal' unless a 'submenu' key exists
          */
         type?: 'normal' | 'separator' | 'submenu' | 'checkbox';
+        role?: 'cut' | 'copy' | 'paste' | 'toggleDevTools' | 'reload';
         label?: string;
         /**
          * If false, the menu item will be greyed out and unclickable.
@@ -1348,7 +1370,7 @@ declare namespace OpenFin {
         /**
          * Data to be returned if the user selects the element. Must be serializable
          */
-        data: any;
+        data?: any;
 
         /**
          * Image Data URI with image dimensions inferred from the encoded string
@@ -1668,4 +1690,21 @@ declare namespace OpenFin {
     export type PlatformEvents = import('./src/api/events/platform').PlatformEvents;
 
     export type ExternalApplicationEvents = import('./src/api/events/externalApplication').ExternalApplicationEvents;
+
+    export type ContextMenuOptions = {
+        template: Array<PrebuiltContextMenuItems>;
+        enabled?: boolean;
+    };
+
+    export type PrebuiltContextMenuItems =
+        | 'separator'
+        | 'cut'
+        | 'copy'
+        | 'paste'
+        | 'spellCheck'
+        | 'inspect'
+        | 'reload'
+        | 'navigateForward'
+        | 'navigateBack'
+        | 'print';
 }

package/package.json

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

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.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
@@ -345,6 +346,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.
@@ -706,8 +716,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 +838,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) => {

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 overlay_1 = require("./SplitterController/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 overlay = new overlay_1.Overlay(this.wire);
+            const splitterController = new SplitterController_1.SplitterController(overlay);
+            __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 { Overlay } from './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 overlay;
+    constructor(overlay: Overlay);
+    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(overlay) {
+        this.overlay = overlay;
+        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.overlay.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.overlay.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/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 Overlay can be rendered at a time per runtime.
+ */
+export declare class Overlay {
+    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/overlay.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Overlay = void 0;
+/**
+ * Api client allowing an empty electron BrowserView to be rendered
+ * in the current window with the specified bounds.
+ *
+ * Please note, only one Overlay can be rendered at a time per runtime.
+ */
+class Overlay {
+    // 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.Overlay = Overlay;

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
@@ -957,4 +958,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

@@ -1237,5 +1237,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

@@ -248,6 +248,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

@@ -220,6 +220,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

@@ -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

@@ -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;