@openfin/core 31.74.31 → 32.75.1

package/src/api/platform/layout/entities/layout-entities.js

@@ -21,33 +21,25 @@ const channel_api_relay_1 = require("../../../../util/channel-api-relay");
     refs, we define and export all the classes here.
 */
 /**
+ * @ignore
  * @internal
  * Supplies an ApiClient for {@link LayoutEntitiesController} and helper methods
  * for the entities {@link TabStack} AND {@link ColumnOrRow} to use.
  */
 class LayoutNode {
-    /** @internal */
+    /**
+     * @internal
+     * @ignore
+     */
     constructor(client, entityId) {
         /**
+         * @ignore
          * @internal
          * ApiClient for {@link LayoutEntitiesController}
          */
         _LayoutNode_client.set(this, void 0);
-        /**
-         * Determines if this {@link ColumnOrRow} or {@link TabStack} is the top level content item in the current layout.
-         * @returns Promise resolving true if this is the root, or false otherwise.
-         */
         this.isRoot = () => __classPrivateFieldGet(this, _LayoutNode_client, "f").isRoot(this.entityId);
-        /**
-         * Determines if this {@link ColumnOrRow} or {@link TabStack} is the top level
-         * content item in the current layout.
-         * @returns Promise resolving true if this is the root, or false otherwise.
-         */
         this.exists = () => __classPrivateFieldGet(this, _LayoutNode_client, "f").exists(this.entityId);
-        /**
-         * Retrieves the parent {@link ColumnOrRow} or {@link TabStack} of this item, if one exists.
-         * @returns Promise resolving with the {@link ColumnOrRow} or {@link TabStack} that contains this item, or undefined if this is the root content item.
-         */
         this.getParent = async () => {
             const parent = await __classPrivateFieldGet(this, _LayoutNode_client, "f").getParent(this.entityId);
             if (!parent) {
@@ -55,34 +47,16 @@ class LayoutNode {
             }
             return LayoutNode.getEntity(parent, __classPrivateFieldGet(this, _LayoutNode_client, "f"));
         };
-        /**
-         * Given a list of view creation options or references and a layout position, creates an adjacent {@link TabStack}
-         *
-         * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
-         * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
-         * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
-         * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
-         *
-         * @param views List of identities or view creation options of the views to include in the stack
-         * @param options Creation options, defaults to position: 'right'
-         * @returns an instance of {@link TabStack} containing the given views
-         * @experimental
-         */
         this.createAdjacentStack = async (views, options) => {
             const entityId = await __classPrivateFieldGet(this, _LayoutNode_client, "f").createAdjacentStack(this.entityId, views, options);
             return LayoutNode.getEntity({ entityId, type: 'stack' }, __classPrivateFieldGet(this, _LayoutNode_client, "f"));
         };
-        /**
-         * Finds the immediate adjacent layout item given an edge Position
-         * @param edgePosition
-         * @returns either {@link TabStack} or {@link ColumnOrRow} that was found, or `undefined` if there is no item with that edgePosition
-         */
         this.getAdjacentStacks = async (edge) => {
             const adjacentStacks = await __classPrivateFieldGet(this, _LayoutNode_client, "f").getAdjacentStacks({
                 targetId: this.entityId,
                 edge
             });
-            return adjacentStacks.map(stack => LayoutNode.getEntity({
+            return adjacentStacks.map((stack) => LayoutNode.getEntity({
                 type: 'stack',
                 entityId: stack.entityId
             }, __classPrivateFieldGet(this, _LayoutNode_client, "f")));
@@ -94,6 +68,7 @@ class LayoutNode {
 exports.LayoutNode = LayoutNode;
 _a = LayoutNode, _LayoutNode_client = new WeakMap();
 /**
+ * @ignore
  * @internal
  * Encapsulates Api consumption of {@link LayoutEntitiesController} with a relayed dispatch
  * @param client
@@ -119,10 +94,73 @@ LayoutNode.getEntity = (definition, client) => {
     }
 };
 /**
- * A {@link TabStack} is used to manage the state of a TabStack within an OpenFin Layout and
- * traverse to its parent Content Item.
+ * @typedef {string} LayoutPosition
+ * @summary Represents the position of an item in a layout relative to another. Possible values are 'top', 'bottom', 'left' and 'right'.
+ */
+/**
+ * @typedef {object} StackCreationOptions
+ * @summary Stack creation options.
+ * @property {LayoutPosition} [position] - The position to create the new {@link TabStack} in, relative to the given adjacent {@link TabStack}. Defaults to 'right'.
+ */
+/**
+ * @typedef {object} TabStack~AddViewOptions
+ * @summary Options to use when adding a view to a {@link TabStack}
+ * @property {number} [index] - Insertion index when adding the view. Defaults to 0.
+ */
+/**
+ * A TabStack is used to manage the state of a stack of tabs within an OpenFin Layout.
  */
 class TabStack extends LayoutNode {
+    /**
+     * Determines if this {@link TabStack} is the top level content item in the current layout.
+     * @function isRoot
+     * @memberof TabStack
+     * @instance
+     * @tutorial TabStack.isRoot
+     * @return {Promise<boolean>} Resolves true if this TabStack is the top level content item, or false if it is not.
+     */
+    /**
+     * Determines if this  {@link TabStack} exists.
+     * @function exists
+     * @instance
+     * @memberof TabStack
+     * @tutorial TabStack.exists
+     * @return {Promise<boolean>} Resolves true if this is the TabStack exists, or false if it has been destroyed.
+     */
+    /**
+     * Retrieves the parent {@link ColumnOrRow} of this {@link TabStack}, if one exists.
+     * @function getParent
+     * @instance
+     * @memberof TabStack
+     * @tutorial TabStack.getParent
+     * @return {Promise<ColumnOrRow | TabStack | undefined>} Promise resolving with the {@link ColumnOrRow} that contains this item, or undefined if this {@link TabStack} is the root content item or does not exist.
+     */
+    /**
+     * Returns all the adjacent stacks that share an edge with the given {@link TabStack}.
+     * @function getAdjacentStacks
+     * @instance
+     * @memberof TabStack
+     * @param  {LayoutPosition} edge - Edge to check for any adjacent stacks.
+     * @returns {Promise<TabStack[]>}
+     * @tutorial TabStack.getAdjacentStacks
+     */
+    /**
+     * Given a list of view creation options or references and a layout position, creates a {@link TabStack} adjacent to the current {@link TabStack}
+     *
+     * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
+     * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
+     * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
+     *
+     * @function createAdjacentStack
+     * @instance
+     * @memberof TabStack
+     * @param {View~options} views - List of identities or view creation options of the views to include in the stack
+     * @param {StackCreationOptions} options - Creation options.
+     * @returns {Promise<TabStack>} The created TabStack.
+     * @tutorial TabStack.createAdjacentStack
+     * @experimental
+     */
     /** @internal */
     constructor(client, entityId) {
         super(client, entityId);
@@ -143,8 +181,9 @@ class TabStack extends LayoutNode {
          * If that happens and then getViews() is called, it will return the identities in a different order than
          * than the currently rendered tab order.
          *
-         * @returns Resolves with a list containing the {@link OpenFin.Identity identities} of each view belonging to the {@link TabStack}.
+         * @returns {Promise<Identity[]>} Resolves with a list containing the {@link OpenFin.Identity identities} of each view belonging to the {@link TabStack}.
          * @throws If the {@link TabStack} has been destroyed.
+         * @tutorial TabStack.getViews
          * @experimental
          */
         this.getViews = () => __classPrivateFieldGet(this, _TabStack_client, "f").getStackViews(this.entityId);
@@ -154,43 +193,112 @@ class TabStack extends LayoutNode {
          * Known Issue: If adding a view overflows the tab-container, the added view will be set as active
          * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
          *
-         * @param view The identity of an existing view to add, or options to create a view.
-         * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
-         * @returns Resolves with the {@link OpenFin.Identity identity} of the added view.
+         * @param {View~options} view The identity of an existing view to add, or options to create a view.
+         * @param {TabStack~AddViewOptions} options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
+         * @returns {Promise<identity>} Resolves with the {@link OpenFin.Identity identity} of the added view.
          * @throws If the view does not exist or fails to create.
          * @throws If the {@link TabStack} has been destroyed.
+         * @tutorial TabStack.addView
          * @experimental
          */
         this.addView = async (view, options = { index: 0 }) => __classPrivateFieldGet(this, _TabStack_client, "f").addViewToStack(this.entityId, view, options);
         /**
          * Removes a view from this {@link TabStack}.
-         * @param view {@link OpenFin.Identiy Identity} of the view to remove.
+         * @param {Identity} view - Identity of the view to remove.
          * @throws If the view does not exist or does not belong to the stack.
          * @throws If the {@link TabStack} has been destroyed.
+         * @return {Promise<void>}
+         * @tutorial TabStack.removeView
          */
         this.removeView = async (view) => {
             await __classPrivateFieldGet(this, _TabStack_client, "f").removeViewFromStack(this.entityId, view);
         };
+        /**
+         * Sets the active view of the {@link TabStack} without focusing it.
+         * @param {Identity} view - Identity of the view to activate.
+         * @returns {Promise<void>} Promise which resolves with void once the view has been activated.
+         * @throws If the {@link TabStack} has been destroyed.
+         * @throws If the view does not exist.
+         * @tutorial TabStack.setActiveView
+         * @experimental
+         */
+        this.setActiveView = async (view) => {
+            await __classPrivateFieldGet(this, _TabStack_client, "f").setStackActiveView(this.entityId, view);
+        };
         __classPrivateFieldSet(this, _TabStack_client, client, "f");
     }
 }
 exports.TabStack = TabStack;
 _TabStack_client = new WeakMap();
 /**
- * A {@link ColumnOrRow} is used to manage the state of a ColumnOrRow within an OpenFin Layout.
+ * A ColumnOrRow is used to manage the state of Column and Rows within an OpenFin Layout.
  */
 class ColumnOrRow extends LayoutNode {
-    /** @internal */
+    /**
+     * Determines if this {@link ColumnOrRow} is the top level content item in the current layout.
+     * @function isRoot
+     * @memberof ColumnOrRow
+     * @instance
+     * @tutorial ColumnOrRow.isRoot
+     * @return {Promise<boolean>} Resolves true if this TabStack is the top level content item, or false if it is not.
+     */
+    /**
+     * Determines if this  {@link ColumnOrRow} exists.
+     * @function exists
+     * @instance
+     * @memberof ColumnOrRow
+     * @tutorial ColumnOrRow.exists
+     * @return {Promise<boolean>} Resolves true if the TabStack exists, or false if it has been destroyed.
+     */
+    /**
+     * Retrieves the parent {@link ColumnOrRow} of this {@link ColumnOrRow}, if one exists.
+     * @function getParent
+     * @instance
+     * @memberof ColumnOrRow
+     * @tutorial ColumnOrRow.getParent
+     * @return {Promise<ColumnOrRow | undefined>} Promise resolving with the {@link ColumnOrRow} that contains this item, or undefined if this {@link ColumnOrRow} does not exist or is the root content item.
+     */
+    /**
+     * Returns all the adjacent stacks that share an edge with the given {@link ColumnOrRow}.
+     * @function getAdjacentStacks
+     * @instance
+     * @memberof ColumnOrRow
+     * @param  {LayoutPosition} edge - Edge to check for any adjacent stacks.
+     * @returns {Promise<TabStack[]>}
+     * @tutorial ColumnOrRow.getAdjacentStacks
+     */
+    /**
+     * Given a list of view creation options or references and a layout position, creates a {@link TabStack} adjacent to the given {@link ColumnOrRow}
+     *
+     * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
+     * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
+     * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
+     *
+     * @function createAdjacentStack
+     * @instance
+     * @memberof ColumnOrRow
+     * @param {View~options} views - List of identities or view creation options of the views to include in the stack
+     * @param {StackCreationOptions} options - Creation options.
+     * @returns {Promise<TabStack>} The created TabStack
+     * @tutorial ColumnOrRow.createAdjacentStack
+     * @experimental
+     */
+    /**
+     * @internal
+     */
     constructor(client, entityId, type) {
         super(client, entityId);
         /**
+         * @ignore
          * @internal
          * ApiClient for {@link LayoutEntitiesController}
          */
         _ColumnOrRow_client.set(this, void 0);
         /**
          * Retrieves a list of all content items belonging to this {@link ColumnOrRow} in order of appearance.
-         * @returns Resolves with a list containing {@link ColumnOrRow} and {@link TabStack} items belonging to this {@link ColumnOrRow}.
+         * @returns {Promise<Array<ColumnOrRow | TabStack>>} Resolves with a list containing {@link ColumnOrRow} and {@link TabStack} items belonging to this {@link ColumnOrRow}.
+         * @tutorial ColumnOrRow.getContent
          */
         this.getContent = async () => {
             const contentItemEntities = await __classPrivateFieldGet(this, _ColumnOrRow_client, "f").getContent(this.entityId);

package/src/api/platform/layout/utils/layout-traversal.d.ts

@@ -1,3 +1,4 @@
 import type * as OpenFin from '../../../../OpenFin';
 export declare const getAdjacentItem: (component: GoldenLayout.ContentItem, edge: OpenFin.LayoutPosition) => GoldenLayout.ContentItem | undefined;
+export declare const doShareEdge: (from: GoldenLayout.ContentItem, to: GoldenLayout.ContentItem, edge: OpenFin.LayoutPosition) => boolean;
 export declare const getAdjacentStacks: (item: GoldenLayout.ContentItem, edge: OpenFin.LayoutPosition) => GoldenLayout.ContentItem[];

package/src/api/platform/layout/utils/layout-traversal.js

@@ -1,9 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAdjacentStacks = exports.getAdjacentItem = void 0;
+exports.getAdjacentStacks = exports.doShareEdge = exports.getAdjacentItem = void 0;
 const getAdjacentItem = (component, edge) => {
     const { parent } = component;
-    // need to handle the case where a stack is the parent content item
     if (parent.isRoot) {
         return undefined;
     }
@@ -19,25 +18,26 @@ const getAdjacentItem = (component, edge) => {
     return (0, exports.getAdjacentItem)(parent, edge);
 };
 exports.getAdjacentItem = getAdjacentItem;
-const doShareEdge = (a, b, edge) => {
+const doShareEdge = (from, to, edge) => {
     var _a, _b;
-    const boundsA = (_a = a.element.get(0)) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
-    const boundsB = (_b = b.element.get(0)) === null || _b === void 0 ? void 0 : _b.getBoundingClientRect();
-    if (!boundsA || !boundsB) {
+    const boundsFrom = (_a = from.element.get(0)) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect();
+    const boundsTo = (_b = to.element.get(0)) === null || _b === void 0 ? void 0 : _b.getBoundingClientRect();
+    if (!boundsFrom || !boundsTo) {
         return false;
     }
     if (['top', 'bottom'].includes(edge)) {
-        return ((boundsB.left >= boundsA.left && boundsB.left < boundsA.right) ||
-            (boundsB.right > boundsA.left && boundsB.right <= boundsA.right));
+        const horizontallyOutOfBounds = boundsFrom.right < boundsTo.left || boundsFrom.left > boundsTo.right;
+        return !horizontallyOutOfBounds;
     }
-    return ((boundsB.top >= boundsA.top && boundsB.top < boundsA.bottom) ||
-        (boundsB.bottom > boundsA.top && boundsB.bottom <= boundsA.bottom));
+    const verticallyOutOfBounds = boundsFrom.bottom < boundsTo.top || boundsFrom.top > boundsTo.bottom;
+    return !verticallyOutOfBounds;
 };
+exports.doShareEdge = doShareEdge;
 const getAdjacentStacks = (item, edge) => {
     const targetContainer = ['top', 'bottom'].includes(edge) ? 'row' : 'column';
     const findEdgeStacks = (component) => {
         if (component.type === 'stack') {
-            if (doShareEdge(item, component, edge)) {
+            if ((0, exports.doShareEdge)(item, component, edge)) {
                 return [component];
             }
             return [];

package/src/api/platform/provider.d.ts

@@ -1,5 +1,5 @@
-import { WindowOptionsChangedEvent } from '../events/window';
 import * as OpenFin from '../../OpenFin';
+type WindowOptionsChangedEvent = OpenFin.WindowEvents.WindowOptionsChangedEvent;
 /**
  * This class handles Platform actions. It does not need to be used directly by developers.
  * However, its methods can be overriden by passing an `overrideCallback` to {@link Platform#init Platform.init}
@@ -160,3 +160,4 @@ export interface PlatformProvider {
      */
     handleViewsAndWindowClose(windowId: OpenFin.Identity, userDecision: OpenFin.BeforeUnloadUserDecision): Promise<void>;
 }
+export {};

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

@@ -460,6 +460,15 @@ export default class System extends EmitterBase<OpenFin.SystemEvent> {
      */
     getServiceConfiguration(serviceIdentifier: OpenFin.ServiceIdentifier): Promise<OpenFin.ServiceConfiguration>;
     protected getSystemAppConfig(name: string): Promise<any>;
+    /**
+     * Registers a system shutdown handler so user can do some cleanup before system is shutting down.
+     * Note: Once system shutdown starts, you are unable to cancel it.
+     * @param { SystemShutdownHandler } handler system shutdown handler
+     * @return {Promise.<void>}
+     * @tutorial System.registerShutdownHandler
+     * @experimental
+     */
+    registerShutdownHandler(handler: OpenFin.SystemShutdownHandler): Promise<void>;
     /**
      * Signals the RVM to perform a health check and returns the results as json.
      * @return {Promise.<string[]>}

package/src/api/system/index.js

@@ -512,53 +512,62 @@ class System extends base_1.EmitterBase {
      * @tutorial System.downloadAsset
      */
     // incompatible with standalone node process.
-    downloadAsset(appAsset, progressListener) {
-        return new Promise((resolve, reject) => {
-            // node.js environment not supported
-            if (this.wire.environment.constructor.name === 'NodeEnvironment') {
-                reject(new transport_errors_1.NotSupportedError('downloadAsset only supported in an OpenFin Render process'));
-                return;
-            }
-            const downloadId = this.wire.environment.getNextMessageId().toString();
-            const dlProgressKey = `asset-download-progress-${downloadId}`;
-            const dlErrorKey = `asset-download-error-${downloadId}`;
-            const dlCompleteKey = `asset-download-complete-${downloadId}`;
-            const dlProgress = (progress) => {
-                const p = {
-                    downloadedBytes: progress.downloadedBytes,
-                    totalBytes: progress.totalBytes
-                };
-                progressListener(p);
-            };
-            const cleanListeners = () => {
-                // TODO: fix internal types
-                // @ts-expect-error
-                this.removeListener(dlProgressKey, dlProgress);
-            };
-            const dlError = (payload) => {
-                cleanListeners();
-                const { reason, err: error } = payload;
-                reject(new transport_errors_1.RuntimeError({ reason, error }));
-            };
-            const dlComplete = () => {
-                cleanListeners();
-                resolve();
+    async downloadAsset(appAsset, progressListener) {
+        // eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/no-empty-function
+        const noop = () => { };
+        let resolve = noop;
+        let reject = noop;
+        const downloadCompletePromise = new Promise((y, n) => {
+            resolve = y;
+            reject = n;
+        });
+        // node.js environment not supported
+        if (this.wire.environment.constructor.name === 'NodeEnvironment') {
+            throw new transport_errors_1.NotSupportedError('downloadAsset only supported in an OpenFin Render process');
+        }
+        const callSite = transport_errors_1.RuntimeError.getCallSite();
+        const downloadId = this.wire.environment.getNextMessageId().toString();
+        const dlProgressKey = `asset-download-progress-${downloadId}`;
+        const dlErrorKey = `asset-download-error-${downloadId}`;
+        const dlCompleteKey = `asset-download-complete-${downloadId}`;
+        const dlProgress = (progress) => {
+            const p = {
+                downloadedBytes: progress.downloadedBytes,
+                totalBytes: progress.totalBytes
             };
+            progressListener(p);
+        };
+        const cleanListeners = () => {
             // TODO: fix internal types
             // @ts-expect-error
-            this.on(dlProgressKey, dlProgress);
+            this.removeListener(dlProgressKey, dlProgress);
+        };
+        const dlError = (payload) => {
+            cleanListeners();
+            const { reason, err: error } = payload;
+            reject(new transport_errors_1.RuntimeError({ reason, error }, callSite));
+        };
+        const dlComplete = () => {
+            cleanListeners();
+            resolve();
+        };
+        await Promise.all([
             // TODO: fix internal types
             // @ts-expect-error
-            this.once(dlErrorKey, dlError);
+            this.on(dlProgressKey, dlProgress),
             // TODO: fix internal types
             // @ts-expect-error
-            this.once(dlCompleteKey, dlComplete);
-            const downloadOptions = Object.assign(appAsset, { downloadId });
-            this.wire.sendAction('download-asset', downloadOptions).catch((err) => {
-                cleanListeners();
-                reject(err);
-            });
+            this.once(dlErrorKey, dlError),
+            // TODO: fix internal types
+            // @ts-expect-error
+            this.once(dlCompleteKey, dlComplete)
+        ]);
+        const downloadOptions = Object.assign(appAsset, { downloadId });
+        await this.wire.sendAction('download-asset', downloadOptions).catch((err) => {
+            cleanListeners();
+            throw err;
         });
+        return downloadCompletePromise;
     }
     /**
      * Downloads a version of the runtime.
@@ -568,6 +577,7 @@ class System extends base_1.EmitterBase {
      * @tutorial System.downloadRuntime
      */
     downloadRuntime(options, progressListener) {
+        const callsites = transport_errors_1.RuntimeError.getCallSite();
         return new Promise((resolve, reject) => {
             // node.js environment not supported
             if (this.wire.environment.constructor.name === 'NodeEnvironment') {
@@ -593,7 +603,7 @@ class System extends base_1.EmitterBase {
             const dlError = (payload) => {
                 cleanListeners();
                 const { reason, err: error } = payload;
-                reject(new transport_errors_1.RuntimeError({ reason, error }));
+                reject(new transport_errors_1.RuntimeError({ reason, error }, callsites));
             };
             const dlComplete = () => {
                 cleanListeners();
@@ -735,6 +745,34 @@ class System extends base_1.EmitterBase {
         }
         return this.wire.sendAction('get-system-app-configuration', { name }).then(({ payload }) => payload.data);
     }
+    /**
+     * Registers a system shutdown handler so user can do some cleanup before system is shutting down.
+     * Note: Once system shutdown starts, you are unable to cancel it.
+     * @param { SystemShutdownHandler } handler system shutdown handler
+     * @return {Promise.<void>}
+     * @tutorial System.registerShutdownHandler
+     * @experimental
+     */
+    async registerShutdownHandler(handler) {
+        this.wire.sendAction('system-register-shutdown-handler').catch((e) => {
+            // don't expose, analytics-only call
+        });
+        const SystemShutdownEventName = 'system-shutdown';
+        const SystemShutdownHandledEventName = 'system-shutdown-handled';
+        const { uuid, name } = this.wire.me;
+        const shutdownHandler = (payload) => {
+            const proceed = () => {
+                // notify core that the app is ready for shutdown
+                this.wire.environment.raiseEvent(`application/${SystemShutdownHandledEventName}`, {
+                    uuid,
+                    name,
+                    topic: 'application'
+                });
+            };
+            handler({ proceed });
+        };
+        this.on(SystemShutdownEventName, shutdownHandler);
+    }
     /**
      * Signals the RVM to perform a health check and returns the results as json.
      * @return {Promise.<string[]>}

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

@@ -1,8 +1,8 @@
 import type * as OpenFin from '../../OpenFin';
 import { Transport } from '../../transport/transport';
-import { ViewEvent } from '../events/view';
 import { WebContents } from '../webcontents/main';
 type UpdatableViewOptions = OpenFin.UpdatableViewOptions;
+type ViewEvent = OpenFin.ViewEvent;
 /**
  * @PORTED
  * @typedef {object} View~options
@@ -144,6 +144,9 @@ type UpdatableViewOptions = OpenFin.UpdatableViewOptions;
  * @property {string} [processAffinity=<application uuid>]
  * A string to attempt to group renderers together. Will only be used if pages are on the same origin.
  *
+ * @property {boolean} [spellCheck=false]
+ * Enable spell check in input text fields for the view.
+ *
  * @property {Identity} [target]
  * The identity of the window this view should be attached to.
  *
@@ -447,10 +450,10 @@ export declare class View extends WebContents<ViewEvent> {
     getCurrentWindow: () => Promise<OpenFin.Window>;
     /**
      * Retrieves the current {@link TabStack} of the view if it belongs to one.
-     * @return {Promise<TabStack | undefined>} The {@link TabStack} this view belongs to.
+     * @return {Promise<TabStack>} The {@link TabStack} this view belongs to.
      * @throws if this view does not belong to a TabStack or if the window has been destroyed.
      */
-    getCurrentStack: () => Promise<OpenFin.TabStack | undefined>;
+    getCurrentStack: () => Promise<OpenFin.TabStack>;
     /**
      * Triggers the before-unload handler for the View, if one is set. Returns `true` if the handler is trying to prevent the View from unloading, and `false` if it isn't.
      * Only enabled when setting enableBeforeUnload: true in your View options. If this option is not enabled it will always return false.

package/src/api/view/Instance.js

@@ -11,7 +11,6 @@ const transport_errors_1 = require("../../transport/transport-errors");
 const lazy_1 = require("../../util/lazy");
 const layout_entities_1 = require("../platform/layout/entities/layout-entities");
 const layout_constants_1 = require("../platform/layout/layout.constants");
-const bounds_observer_1 = require("../platform/layout/utils/bounds-observer");
 const main_1 = require("../webcontents/main");
 const window_1 = require("../window");
 /**
@@ -155,6 +154,9 @@ const window_1 = require("../window");
  * @property {string} [processAffinity=<application uuid>]
  * A string to attempt to group renderers together. Will only be used if pages are on the same origin.
  *
+ * @property {boolean} [spellCheck=false]
+ * Enable spell check in input text fields for the view.
+ *
  * @property {Identity} [target]
  * The identity of the window this view should be attached to.
  *
@@ -459,23 +461,22 @@ class View extends main_1.WebContents {
         };
         /**
          * Retrieves the current {@link TabStack} of the view if it belongs to one.
-         * @return {Promise<TabStack | undefined>} The {@link TabStack} this view belongs to.
+         * @return {Promise<TabStack>} The {@link TabStack} this view belongs to.
          * @throws if this view does not belong to a TabStack or if the window has been destroyed.
          */
         this.getCurrentStack = async () => {
+            this.wire.sendAction('view-get-current-stack').catch(() => {
+                // don't expose
+            });
             try {
                 const layoutWindow = await this.getCurrentWindow();
                 const providerChannelClient = await __classPrivateFieldGet(this, _View_providerChannelClient, "f").getValue();
                 const client = await layout_entities_1.LayoutNode.newLayoutEntitiesClient(providerChannelClient, layout_constants_1.LAYOUT_CONTROLLER_ID, layoutWindow.identity);
-                const stackDefinition = await client.getStackByView(this.identity);
+                const stackDefinition = (await client.getStackByView(this.identity));
                 return layout_entities_1.LayoutNode.getEntity(stackDefinition, client);
             }
             catch (error) {
-                const e = new transport_errors_1.RuntimeError({ reason: 'This view does not belong to a stack.' });
-                // TODO: @pierre to fix
-                // @ts-expect-error pending PR !3459 to fix runtime errors
-                e.cause = error;
-                throw e;
+                throw new transport_errors_1.RuntimeError({ reason: 'This view does not belong to a stack.', error });
             }
         };
         /**
@@ -508,7 +509,7 @@ class View extends main_1.WebContents {
                 throw new Error('Element not found.');
             }
             const onChange = async (bounds) => this.setBounds(bounds);
-            return (0, bounds_observer_1.observeBounds)(element, onChange);
+            return this.wire.environment.observeBounds(element, onChange);
         };
     }
     /**

package/src/api/webcontents/main.d.ts

@@ -2,31 +2,11 @@ import type * as OpenFin from '../../OpenFin';
 import { EmitterBase } from '../base';
 import { Transport } from '../../transport/transport';
 import { BaseEvent } from '../events/base';
-/**
- * Configuration for page capture.
- */
-export interface CapturePageOptions {
-    /**
-     * The area of the window to be captured.
-     */
-    area?: OpenFin.Rectangle;
-    /**
-     * @defaultValue 'png'
-     *
-     * The format of the captured image.  Can be 'png', 'jpg', or 'bmp'.
-     */
-    format?: 'bmp' | 'jpg' | 'png';
-    /**
-     * @defaultValue 100
-     *
-     * Quality of JPEG image. Between 0 - 100.
-     */
-    quality?: number;
-}
 export declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
+    identity: OpenFin.Identity;
     entityType: string;
     constructor(wire: Transport, identity: OpenFin.Identity, entityType: string);
-    capturePage(options?: CapturePageOptions): Promise<string>;
+    capturePage(options?: OpenFin.CapturePageOptions): Promise<string>;
     executeJavaScript(code: string): Promise<void>;
     getZoomLevel(): Promise<number>;
     setZoomLevel(level: number): Promise<void>;