@openfin/core 35.78.2 → 35.78.3

package/out/mock.js

@@ -36,18 +36,6 @@ var application$1 = {};
  * @packageDocumentation
  */
 Object.defineProperty(application$1, "__esModule", { value: true });
-application$1.ApplicationWindowEventTypes = void 0;
-/**
- * Array of valid `type` values for an {@link ApplicationWindowEvent}.
- */
-application$1.ApplicationWindowEventTypes = [
-    'window-alert-requested',
-    'window-created',
-    'window-end-load',
-    'window-not-responding',
-    'window-responding',
-    'window-start-load'
-];
 
 var base$1 = {};
 
@@ -1244,6 +1232,15 @@ class LayoutNode {
         /**
          * Creates a new TabStack adjacent to the given TabStack or ColumnOrRow. Inputs can be new views to create, or existing views.
          *
+         * 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 The views that will populate the new TabStack.
+         * @param options Additional options that control new TabStack creation.
+         * @returns The newly-created TabStack.
+         *
          * @example
          * ```js
          * if (!fin.me.isView) {
@@ -1278,13 +1275,16 @@ class LayoutNode {
          * console.log(`A new TabStack created to the right has ${newStack.length} views in it`);
          *
          * ```
+         * @experimental
          */
         this.createAdjacentStack = async (views, options) => {
             const entityId = await __classPrivateFieldGet$e(this, _LayoutNode_client, "f").createAdjacentStack(this.entityId, views, options);
             return LayoutNode.getEntity({ entityId, type: 'stack' }, __classPrivateFieldGet$e(this, _LayoutNode_client, "f"));
         };
         /**
-         * Retrieves the adjacent TabStacks of the given TabStack or ColumnOrRow
+         * Retrieves the adjacent TabStacks of the given TabStack or ColumnOrRow.
+         *
+         * @param edge Edge whose adjacent TabStacks will be returned.
          *
          * @example
          * ```js
@@ -1304,6 +1304,7 @@ class LayoutNode {
          * console.log(`The entity has ${rightStacks.length} stacks to the right, and ${leftStacks.length} stacks to the left`);
          *
          * ```
+         * @experimental
          */
         this.getAdjacentStacks = async (edge) => {
             const adjacentStacks = await __classPrivateFieldGet$e(this, _LayoutNode_client, "f").getAdjacentStacks({
@@ -1347,74 +1348,10 @@ LayoutNode.getEntity = (definition, client) => {
             throw new Error(`Unrecognised Layout Entity encountered ('${JSON.stringify(definition)})`);
     }
 };
-/**
- * @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
-     * @returns 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
-     * @returns 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
-     * @returns 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.
-     *
-     * @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 views - List of identities or view creation options of the views to include in the stack
-     * @param options - Creation options.
-     * @returns The created TabStack.
-     * @tutorial TabStack.createAdjacentStack
-     * @experimental
-     */
     /** @internal */
     constructor(client, entityId) {
         super(client, entityId);
@@ -1547,57 +1484,6 @@ _TabStack_client = new WeakMap();
  * A ColumnOrRow is used to manage the state of Column and Rows within an OpenFin Layout.
  */
 class ColumnOrRow extends LayoutNode {
-    /**
-     * Determines if this {@link ColumnOrRow} is the top level content item in the current layout.
-     * @function isRoot
-     * @memberof ColumnOrRow
-     * @instance
-     * @tutorial ColumnOrRow.isRoot
-     * @returns 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
-     * @returns 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
-     * @returns 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.
-     *
-     * @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 views - List of identities or view creation options of the views to include in the stack
-     * @param options - Creation options.
-     * @returns The created TabStack
-     * @tutorial ColumnOrRow.createAdjacentStack
-     * @experimental
-     */
     /**
      * @internal
      */
@@ -1643,7 +1529,8 @@ var layout_constants = {};
 Object.defineProperty(layout_constants, "__esModule", { value: true });
 layout_constants.DEFAULT_LAYOUT_KEY = layout_constants.LAYOUT_CONTROLLER_ID = void 0;
 layout_constants.LAYOUT_CONTROLLER_ID = 'layout-entities';
-layout_constants.DEFAULT_LAYOUT_KEY = 'default';
+// TODO: eventually export this somehow
+layout_constants.DEFAULT_LAYOUT_KEY = '__default__';
 
 var main = {};
 
@@ -2672,10 +2559,8 @@ class WebContents extends base_1$k.EmitterBase {
         });
         const { data: { willOpen, options: popupOptions } } = tryCreatePayload;
         if (willOpen) {
-            await this.wire.environment.createChildContent({
-                options: popupOptions.initialOptions,
-                entityType: 'window'
-            });
+            // Solve the issue where Interop in a popup window with non cross-origin url is not working(core-1076).
+            await this.fin.Window.create(popupOptions.initialOptions);
         }
         const normalizePopupResult = (payload) => {
             const { name, uuid, result, data } = payload;
@@ -2737,169 +2622,6 @@ function requireInstance$2 () {
 	const layout_constants_1 = layout_constants;
 	const main_1 = main;
 	const window_1 = requireWindow();
-	/**
-	 * @PORTED
-	 * @typedef {object} View~options
-	 * @summary View creation options.
-	 * @desc This is the options object required by {@link View.create View.create}.
-	 *
-	 * Note that `name` and `target` are the only required properties — albeit the `url` property is usually provided as well
-	 * (defaults to `"about:blank"` when omitted).
-	 *
-	 * @property {object} [experimental]
-	 * Configurations for API injection.
-	 *
-	 * @property {boolean} [experimental.childWindows] Configure if the runtime should enable child windows for views.
-	 *
-	 * @property {object} [accelerator]
-	 * Enable keyboard shortcuts for devtools, zoom, reload, and reload ignoring cache.
-	 *
-	 * @property {boolean} [accelerator.devtools=false]
-	 * If `true`, enables the devtools keyboard shortcut:<br>
-	 * `Ctrl` + `Shift` + `I` _(Toggles Devtools)_
-	 *
-	 * @property {boolean} [accelerator.reload=false]
-	 * If `true`, enables the reload keyboard shortcuts:<br>
-	 * `Ctrl` + `R` _(Windows)_<br>
-	 * `F5` _(Windows)_<br>
-	 * `Command` + `R` _(Mac)_
-	 *
-	 * @property {boolean} [accelerator.reloadIgnoringCache=false]
-	 * If `true`, enables the reload-from-source keyboard shortcuts:<br>
-	 * `Ctrl` + `Shift` + `R` _(Windows)_<br>
-	 * `Shift` + `F5` _(Windows)_<br>
-	 * `Command` + `Shift` + `R` _(Mac)_
-	 *
-	 * @property {boolean} [accelerator.zoom=false]
-	 * If `true`, enables the zoom keyboard shortcuts:<br>
-	 * `Ctrl` + `+` _(Zoom In)_<br>
-	 * `Ctrl` + `Shift` + `+` _(Zoom In)_<br>
-	 * `Ctrl` + `NumPad+` _(Zoom In)_<br>
-	 * `Ctrl` + `-` _(Zoom Out)_<br>
-	 * `Ctrl` + `Shift` + `-` _(Zoom Out)_<br>
-	 * `Ctrl` + `NumPad-` _(Zoom Out)_<br>
-	 * `Ctrl` + `Scroll` _(Zoom In & Out)_<br>
-	 * `Ctrl` + `0` _(Restore to 100%)_
-	 *
-	 * @property {object} [api]
-	 * Configurations for API injection.
-	 *
-	 * @property {object} [api.iframe] Configure if the the API should be injected into iframes based on domain.
-	 *
-	 * @property {boolean} [api.iframe.crossOriginInjection=false] Controls if the `fin` API object is present for cross origin iframes.
-	 * @property {boolean} [api.iframe.sameOriginInjection=true] Controls if the `fin` API object is present for same origin iframes.
-	 *
-	 * @property {string} [autoplayPolicy="no-user-gesture-required"]
-	 * Autoplay policy to apply to content in the window, can be
-	 * `no-user-gesture-required`, `user-gesture-required`,
-	 * `document-user-activation-required`. Defaults to `no-user-gesture-required`.
-	 *
-	 * @property {object} [autoResize] AutoResize options
-	 *
-	 * @property {object} [bounds] initial bounds given relative to the window.
-	 *
-	 * @property {string} [backgroundColor="#FFF"] - _Updatable._
-	 * The view’s _backfill_ color as a hexadecimal value. Not to be confused with the content background color
-	 * (`document.body.style.backgroundColor`),
-	 * this color briefly fills a view’s (a) content area before its content is loaded as well as (b) newly exposed
-	 * areas when growing a window. Setting
-	 * this value to the anticipated content background color can help improve user experience.
-	 * Default is white.
-	 *
-	 * @property {object} [contentNavigation]
-	 * Restrict navigation to URLs that match an allowed pattern.
-	 * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
-	 * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
-	 * @property {string[]} [contentNavigation.allowlist=[]] List of allowed URLs.
-	 * @property {string[]} [contentNavigation.denylist=[]] List of denied URLs.
-	 *
-	 * @property {object} [contentRedirect]
-	 * Restrict redirects to URLs that match an allowed pattern.
-	 * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
-	 * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
-	 * @property {string[]} [contentRedirect.allowlist=[]] List of allowed URLs.
-	 * @property {string[]} [contentRedirect.denylist=[]] List of denied URLs.
-	 *
-	 * @property {object} [contextMenuSettings] - _Updatable._
-	 * Deprecated - superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
-	 * Configure the context menu when right-clicking on a view.
-	 * @property {boolean} [contextMenuSettings.enable=true] Should the context menu display on right click.
-	 * @property {boolean} [contextMenuSettings.devtools=true] Should the context menu contain a button for opening devtools.
-	 * @property {boolean} [contextMenuSettings.reload=true] Should the context menu contain a button for reloading the page.
-	 *
-	 * @property {object} [contextMenuOptions] - _Updatable._
-	 * Configure the context menu when right-clicking on a view. Supported menu items:
-	 * 'separator'
-	 * 'cut'
-	 * 'copy'
-	 * 'copyImage',
-	 * 'paste'
-	 * 'spellCheck'
-	 * 'inspect'
-	 * 'reload'
-	 * 'navigateForward'
-	 * 'navigateBack'
-	 * 'print'
-	 * @property {boolean} [contextMenuOptions.enabled = true] Should the context menu display on right click.
-	 * @property {string[]} [contextMenuOptions.template=[]] List of context menu items to display on right-click.
-	 *
-	 * @property {any} [customData=""] - _Updatable._
-	 * 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}
-	 *
-	 * @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}.
-	 * Within Platform, OpenFin also implements a set of pre-defined actions called
-	 * [keyboard commands]{@link https://developers.openfin.co/docs/platform-api#section-5-3-using-keyboard-commands}
-	 * that can be assigned to a specific hotkey in the platform manifest.
-	 * @property {string} hotkeys.keys The key combination of the hotkey, i.e. "Ctrl+T"
-	 * @property {boolean} [hotkeys.preventDefault=false] preventDefault will prevent the page keydown/keyup events from being emitted.
-	 *
-	 * @property {boolean} [isClosable=true] **Platforms Only.** If false, the view will be persistent and can't be closed through
-	 * either UI or `Platform.closeView`. Note that the view will still be closed if the host window is closed or
-	 * if the view isn't part of the new layout when running `Layout.replace`.
-	 *
-	 * @property {string} name
-	 * The name of the view.
-	 *
-	 * @property {boolean} [detachOnClose=false] - _Updatable._
-	 * Platforms Only.  If true, will hide and detach the View from the window for later use instead of closing,
-	 * allowing the state of the View to be saved and the View to be immediately shown in a new Layout.
-	 *
-	 * @property {string} [manifestUrl] **Platforms Only.** Url to a manifest that contains View Options. Properties other than manifestUrl can still be used
-	 * but the properties in the manifest will take precedence if there is any collision.
-	 *
-	 * @property {preloadScript[]} [preloadScripts] - _Inheritable_
-	 * A list of scripts that are eval'ed before other scripts in the page. When omitted, _inherits_
-	 * from the parent application.
-	 *
-	 * @property {boolean} [preventDragOut=false] **Platforms Only.** If true, the tab of the view can't be dragged out of its host 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.
-	 *
-	 * @property {string} [url="about:blank"]
-	 * The URL of the view.
-	 *
-	 * @property {string} [uuid=<application uuid>]
-	 * The `uuid` of the application, unique within the set of all `Application`s running in OpenFin Runtime.
-	 * If omitted, defaults to the `uuid` of the application spawning the view.
-	 * If given, must match the `uuid` of the application spawning the view.
-	 * In other words, the application's `uuid` is the only acceptable value, but is the default, so there's
-	 * really no need to provide it.
-	 */
 	/**
 	 * A View can be used to embed additional web content into a Window.
 	 * It is like a child window, except it is positioned relative to its owning window.
@@ -3475,7 +3197,7 @@ function requireView () {
 		 * * {@link ViewModule} contains static members of the `View` API, accessible through `fin.View`.
 		 * * {@link View} describes an instance of an OpenFin View, e.g. as returned by `fin.View.getCurrent`.
 		 *
-		 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+		 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 		 * both of these were documented on the same page.
 		 *
 		 * @packageDocumentation
@@ -3523,100 +3245,6 @@ function requireInstance$1 () {
 	        });
 	        return windowList;
 	    }
-	    /**
-	     * Adds a listener to the end of the listeners array for the specified event.
-	     * @param eventType  - The type of the event.
-	     * @param listener - Called whenever an event of the specified type occurs.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function addListener
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * Adds a listener to the end of the listeners array for the specified event.
-	     * @param eventType  - The type of the event.
-	     * @param listener - Called whenever an event of the specified type occurs.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function on
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function once
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * Adds a listener to the beginning of the listeners array for the specified event.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function prependListener
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-	     * The listener is added to the beginning of the listeners array.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function prependOnceListener
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * Remove a listener from the listener array for the specified event.
-	     * Caution: Calling this method changes the array indices in the listener array behind the listener.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function removeListener
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * Removes all listeners, or those of the specified event.
-	     * @param eventType  - The type of the event.
-	     *
-	     * @function removeAllListeners
-	     * @memberof Application
-	     * @instance
-	     * @tutorial Application.EventEmitter
-	     */
-	    /**
-	     * JumpListCategory interface
-	     * @typedef { object } JumpListCategory
-	     * @property { string } name The display title for the category. If omitted, items in this category will be placed into the standard 'Tasks' category. There can be only one such category, and it will always be displayed at the bottom of the JumpList.
-	     * @property { JumpListItem[] } items Array of JumpListItem objects
-	     */
-	    /**
-	     * @PORTED
-	     * JumpListItem interface
-	     * @typedef { object } JumpListItem
-	     * @property { string } type One of the following: "task" or "separator". Defaults to task.
-	     * @property { string } title The text to be displayed for the JumpList Item. Should only be set if type is "task".
-	     * @property { string } description Description of the task (displayed in a tooltip). Should only be set if type is "task".
-	     * @property { string } deepLink Deep link to a manifest, i.e: fins://path.to/manifest.json?$$param1=value1. See {@link https://developers.openfin.co/docs/deep-linking deep-linking} for more information.
-	     * @property { string } iconPath The absolute path to an icon to be displayed for the item, which can be an arbitrary resource file that contains an icon (e.g. .ico, .exe, .dll).
-	     * @property { number } iconIndex The index of the icon in the resource file. If a resource file contains multiple icons this value can be used to specify the zero-based index of the icon that should be displayed for this task. If a resource file contains only one icon, this property should be set to zero.
-	     */
 	    /**
 	     * Determines if the application is currently running.
 	     *
@@ -4616,7 +4244,7 @@ function requireApplication () {
 		 * * {@link ApplicationModule} contains static members of the `Application` API, accessible through `fin.Application`.
 		 * * {@link Application} describes an instance of an OpenFin Application, e.g. as returned by `fin.Application.getCurrent`.
 		 *
-		 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+		 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 		 * both of these were documented on the same page.
 		 *
 		 * @packageDocumentation
@@ -4642,476 +4270,6 @@ function requireInstance () {
 	const main_1 = main;
 	const view_1 = requireView();
 	const warnings_1 = warnings;
-	/**
-	 * @PORTED
-	 * @typedef { object } Margins
-	 * @property { string } [marginType]
-	 * Can be `default`, `none`, `printableArea`, or `custom`. If `custom` is chosen,
-	 * you will also need to specify `top`, `bottom`, `left`, and `right`.
-	 *
-	 * @property { number } [top] The top margin of the printed web page, in pixels.
-	 * @property { number } [bottom] The bottom margin of the printed web page, in pixels.
-	 * @property { number } [left] The left margin of the printed web page, in pixels.
-	 * @property { number } [right] The right margin of the printed web page, in pixels.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef { object } Dpi
-	 * @property { number } [horizontal] The horizontal dpi
-	 * @property { number } [vertical] The vertical dpi
-	 */
-	/**
-	 * @PORTED
-	 * @typedef { object } PrintOptions
-	 * @property { boolean } [silent=false] Don't ask user for print settings.
-	 * @property { boolean } [printBackground=false] Prints the background color and image of the web page.
-	 * @property { string } [deviceName=''] Set the printer device name to use.
-	 * @property { boolean } [color=true] Set whether the printed web page will be in color or grayscale.
-	 * @property { Margins } [margins] Set margins for the printed web page
-	 * @property { boolean } [landscape=false] Whether the web page should be printed in landscape mode.
-	 * @property { number } [scaleFactor] The scale factor of the web page.
-	 * @property { number } [pagesPerSheet] The number of pages to print per page sheet.
-	 * @property { boolean } [collate] Whether the web page should be collated.
-	 * @property { number } [copies] The number of copies of the web page to print.
-	 * @property { Record<string, number> } [pageRanges] The page range to print. Should have two keys: from and to.
-	 * @property { string } [duplexMode] Set the duplex mode of the printed web page. Can be simplex, shortEdge, or longEdge.
-	 * @property { Dpi } [dpi] Set dpi for the printed web page
-	 */
-	/**
-	 * @REMOVED
-	 * PrinterInfo interface
-	 * @typedef { object } PrinterInfo
-	 * @property { string } name Printer Name
-	 * @property { string } description Printer Description
-	 * @property { number } status Printer Status
-	 * @property { boolean } isDefault Indicates that system's default printer
-	 */
-	/**
-	 * @REMOVED
-	 * SharedWorkerInfo interface
-	 * @typedef { object } SharedWorkerInfo
-	 * @property { string } id The unique id of the shared worker.
-	 * @property { string } url The url of the shared worker.
-	 */
-	/**
-	 * @PORTED
-	 * ContentCreationRule interface
-	 * @typedef { object } ContentCreationRule
-	 * @property { string } behavior 'view' | 'window' | 'browser' | 'block'
-	 * @property { string[] } match List of [match patterns](https://developer.chrome.com/extensions/match_patterns).
-	 * @property { object } options Window creation options or View creation options.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} Window~options
-	 * @summary Window creation options.
-	 * @desc This is the options object required by {@link Window.create Window.create}.
-	 *
-	 * Note that `name` is the only required property — albeit the `url` property is usually provided as well
-	 * (defaults to `"about:blank"` when omitted).
-	 *
-	 * _This jsdoc typedef mirrors the `WindowOptions` TypeScript interface in `@types/openfin`._
-	 *
-	 * @property {object} [accelerator]
-	 * Enable keyboard shortcuts for devtools, zoom, reload, and reload ignoring cache.
-	 *
-	 * @property {boolean} [accelerator.devtools=false]
-	 * If `true`, enables the devtools keyboard shortcut:<br>
-	 * `Ctrl` + `Shift` + `I` _(Toggles Devtools)_
-	 *
-	 * @property {boolean} [accelerator.reload=false]
-	 * If `true`, enables the reload keyboard shortcuts:<br>
-	 * `Ctrl` + `R` _(Windows)_<br>
-	 * `F5` _(Windows)_<br>
-	 * `Command` + `R` _(Mac)_
-	 *
-	 * @property {boolean} [accelerator.reloadIgnoringCache=false]
-	 * If `true`, enables the reload-from-source keyboard shortcuts:<br>
-	 * `Ctrl` + `Shift` + `R` _(Windows)_<br>
-	 * `Shift` + `F5` _(Windows)_<br>
-	 * `Command` + `Shift` + `R` _(Mac)_
-	 *
-	 * @property {boolean} [accelerator.zoom=false]
-	 * NOTE: It is not recommended to set this value to true for Windows in Platforms as that may lead to unexpected visual shifts in layout.
-	 * If `true`, enables the zoom keyboard shortcuts:<br>
-	 * `Ctrl` + `+` _(Zoom In)_<br>
-	 * `Ctrl` + `Shift` + `+` _(Zoom In)_<br>
-	 * `Ctrl` + `NumPad+` _(Zoom In)_<br>
-	 * `Ctrl` + `-` _(Zoom Out)_<br>
-	 * `Ctrl` + `Shift` + `-` _(Zoom Out)_<br>
-	 * `Ctrl` + `NumPad-` _(Zoom Out)_<br>
-	 * `Ctrl` + `Scroll` _(Zoom In & Out)_<br>
-	 * `Ctrl` + `0` _(Restore to 100%)_
-	 *
-	 * @property {object} [alphaMask] - _Experimental._  _Updatable._
-	 * <br>
-	 * alphaMask turns anything of matching RGB value transparent.
-	 * <br>
-	 * Caveats:
-	 * * Runtime flags --disable-gpu and --allow-unsafe-compositing are required. Note: Unclear behavior on remote Desktop support
-	 * * User cannot click-through transparent regions
-	 * * Not supported on Mac
-	 * * Windows Aero must be enabled
-	 * * Won't make visual sense on Pixel-pushed environments such as Citrix
-	 * * Not supported on rounded corner windows
-	 * @property {number} [alphaMask.red=-1] 0-255
-	 * @property {number} [alphaMask.green=-1] 0-255
-	 * @property {number} [alphaMask.blue=-1] 0-255
-	 *
-	 * @property {boolean} [alwaysOnTop=false] - _Updatable._
-	 * A flag to always position the window at the top of the window stack.
-	 *
-	 * @property {object} [api]
-	 * Configurations for API injection.
-	 *
-	 * @property {object} [api.iframe] Configure if the the API should be injected into iframes based on domain.
-	 *
-	 * @property {boolean} [api.iframe.crossOriginInjection=false] Controls if the `fin` API object is present for cross origin iframes.
-	 * @property {boolean} [api.iframe.sameOriginInjection=true] Controls if the `fin` API object is present for same origin iframes.
-	 *
-	 * @property {string} [applicationIcon = ""] - _Deprecated_ - use `icon` instead.
-	 *
-	 * @property {number} [aspectRatio=0] - _Updatable._
-	 * The aspect ratio of width to height to enforce for the window. If this value is equal to or less than zero,
-	 * an aspect ratio will not be enforced.
-	 *
-	 * @property {string} [autoplayPolicy="no-user-gesture-required"]
-	 * Autoplay policy to apply to content in the window, can be
-	 * `no-user-gesture-required`, `user-gesture-required`,
-	 * `document-user-activation-required`. Defaults to `no-user-gesture-required`.
-	 *
-	 * @property {boolean} [autoShow=true]
-	 * A flag to automatically show the window when it is created.
-	 *
-	 * @property {string} [backgroundColor="#FFF"]
-	 * The window’s _backfill_ color as a hexadecimal value. Not to be confused with the content background color
-	 * (`document.body.style.backgroundColor`),
-	 * this color briefly fills a window’s (a) content area before its content is loaded as well as (b) newly exposed
-	 * areas when growing a window. Setting
-	 * this value to the anticipated content background color can help improve user experience.
-	 * Default is white.
-	 *
-	 * @property {object} [contentCreation]
-	 * Apply rules that determine how user interaction (`window.open` and links) creates content.
-	 * @property {ContentCreationRule[]} [contentCreation.rules = []] List of content creation rules.
-	 *
-	 * @property {object} [contentNavigation]
-	 * Restrict navigation to URLs that match an allowed pattern.
-	 * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
-	 * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
-	 * @property {string[]} [contentNavigation.allowlist=[]] List of allowed URLs.
-	 * @property {string[]} [contentNavigation.denylist=[]] List of denied URLs.
-	 *
-	 * @property {object} [contentRedirect]
-	 * Restrict redirects to URLs that match an allowed pattern.
-	 * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
-	 * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
-	 * @property {string[]} [contentRedirect.allowlist=[]] List of allowed URLs.
-	 * @property {string[]} [contentRedirect.denylist=[]] List of denied URLs.
-	 *
-	 * @property {boolean} [contextMenu=true] - _Updatable._
-	 * A flag to show the context menu when right-clicking on a window.
-	 * Gives access to the devtools for the window.
-	 *
-	 * @property {object} [contextMenuSettings] - _Updatable._
-	 * Deprecated - superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
-	 * Configure the context menu when right-clicking on a window.
-	 * @property {boolean} [contextMenuSettings.enable=true] Should the context menu display on right click.
-	 * @property {boolean} [contextMenuSettings.devtools=true] Should the context menu contain a button for opening devtools.
-	 * @property {boolean} [contextMenuSettings.reload=true] Should the context menu contain a button for reloading the page.
-	 *
-	 * @property {object} [contextMenuOptions] - _Updatable._
-	 * Configure the context menu when right-clicking on a window. Supported menu items:
-	 * 'separator'
-	 * 'cut'
-	 * 'copy'
-	 * 'paste'
-	 * 'spellCheck'
-	 * 'inspect'
-	 * 'reload'
-	 * 'navigateForward'
-	 * 'navigateBack'
-	 * 'print'
-	 * @property {boolean} [contextMenuOptions.enabled = true] Should the context menu display on right click.
-	 * @property {string[]} [contextMenuSettings.template=[]] List of context menu items to display on right-click.
-	 *
-	 * @property {object} [cornerRounding] - _Updatable._
-	 * Defines and applies rounded corners for a frameless window. **NOTE:** On macOS corner is not ellipse but circle rounded by the
-	 *  average of _height_ and _width_.
-	 * @property {number} [cornerRounding.height=0] The height in pixels.
-	 * @property {number} [cornerRounding.width=0] The width in pixels.
-	 *
-	 * @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, _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. 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.
-	 * @property {string[]} [customRequestHeaders.urlPatterns=[]] The URL patterns for which the headers will be applied
-	 * @property {object[]} [customRequestHeaders.headers=[]] Objects representing headers and their values,
-	 * where the object key is the name of header and value at key is the value of the header
-	 *
-	 * @property {boolean} [closeOnLastViewRemoved=true] - _Experimental._  _Updatable._
-	 * Toggling off would keep the Window alive even if all its Views were closed.
-	 * This is meant for advanced users and should be used with caution.
-	 * Limitations - Once a Layout has been emptied out of all views it's not usable anymore, and certain API calls will fail.
-	 * Use `layout.replace` to create a fresh Layout instance in case you want to populate it with Views again.
-	 * ** note ** - This option is ignored in non-Platforms apps.
-	 *
-	 * @property {boolean} [defaultCentered=false]
-	 * Centers the window in the primary monitor. This option overrides `defaultLeft` and `defaultTop`. When `saveWindowState` is `true`,
-	 * this value will be ignored for subsequent launches in favor of the cached value. **NOTE:** On macOS _defaultCenter_ is
-	 * somewhat above center vertically.
-	 *
-	 * @property {number} [defaultHeight=500]
-	 * The default height of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent launches
-	 * in favor of the cached value.
-	 *
-	 * @property {number} [defaultLeft=100]
-	 * The default left position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
-	 * launches in favor of the cached value.
-	 *
-	 * @property {number} [defaultTop=100]
-	 * The default top position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
-	 * launches in favor of the cached value.
-	 *
-	 * @property {number} [defaultWidth=800]
-	 * The default width of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
-	 * launches in favor of the cached value.
-	 *
-	 * @property {boolean} [includeInSnapshots=true] - _Updatable._
-	 * When true, the window will be be included in snapshots returned by Platform.getSnapshot(). Turning this off may be desirable when dealing with
-	 * inherently temporary windows whose state shouldn't be preserved, such as modals, menus, or popups.
-	 *
-	 * @property {boolean} [frame=true] - _Updatable._
-	 * A flag to show the frame.
-	 *
-	 * @hidden-property {boolean} [hideOnClose=false] - A flag to allow a window to be hidden when the close button is clicked.
-	 *
-	 * @property {object[]} [hotkeys=[]] - _Updatable._
-	 * Defines the list of hotkeys that will be emitted as a `hotkey` event on the window. For usage example see [example]{@tutorial hotkeys}.
-	 * Within Platform, OpenFin also implements a set of pre-defined actions called
-	 * [keyboard commands]{@link https://developers.openfin.co/docs/platform-api#section-5-3-using-keyboard-commands}
-	 * that can be assigned to a specific hotkey in the platform manifest.
-	 * @property {string} hotkeys.keys The key combination of the hotkey, i.e. "Ctrl+T"
-	 * @property {boolean} [hotkeys.preventDefault=false] Whether or not to prevent default key handling before emitting the event
-	 *
-	 * @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._
-	 *  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._
-	 * The maximum height of a window. Will default to the OS defined value if set to -1.
-	 *
-	 * @property {boolean} [maximizable=true] - _Updatable._
-	 * A flag that lets the window be maximized.
-	 *
-	 * @property {number} [maxWidth=-1] - _Updatable._
-	 * The maximum width of a window. Will default to the OS defined value if set to -1.
-	 *
-	 * @property {number} [minHeight=0] - _Updatable._
-	 * The minimum height of a window.
-	 *
-	 * @property {boolean} [minimizable=true] - _Updatable._
-	 * A flag that lets the window be minimized.
-	 *
-	 * @property {number} [minWidth=0] - _Updatable._
-	 * The minimum width of a window.
-	 *
-	 * @property {Identity} [modalParentIdentity]
-	 * Parent identity of a modal window. It will create a modal child window when this option is set.
-	 *
-	 * @property {string} name
-	 * The name of the window.
-	 *
-	 * @property {number} [opacity=1.0] - _Updatable._
-	 * A flag that specifies how transparent the window will be.
-	 * Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
-	 * This value is clamped between `0.0` and `1.0`.
-	 * * In software composition mode, the runtime flag --allow-unsafe-compositing is required.
-	 *
-	 * @property {preloadScript[]} [preloadScripts] - _Inheritable_
-	 * A list of scripts that are eval'ed before other scripts in the page. When omitted, _inherits_
-	 * from the parent application.
-	 *
-	 * @property {string} [processAffinity]
-	 * A string to attempt to group renderers together. Will only be used if pages are on the same origin.
-	 *
-	 * @property {boolean} [resizable=true] - _Updatable._
-	 * A flag to allow the user to resize the window.
-	 *
-	 * @property {object} [resizeRegion] - _Updatable._
-	 * Defines a region in pixels that will respond to user mouse interaction for resizing a frameless window.
-	 * @property {number} [resizeRegion.bottomRightCorner=9]
-	 * The size in pixels of an additional square resizable region located at the bottom right corner of a frameless window.
-	 * @property {number} [resizeRegion.size=7]
-	 * The size in pixels.
-	 * @property {object} [resizeRegion.sides={top:true,right:true,bottom:true,left:true}]
-	 * Sides that a window can be resized from.
-	 *
-	 * @property {boolean} [saveWindowState=true]
-	 * A flag to cache the location of the window.
-	 * ** note ** - This option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
-	 *
-	 * @property {boolean} [ignoreSavedWindowState]
-	 * A flag to ignore previously cached state of the window. It defaults the opposite value of `saveWindowState` to maintain backwards compatibility.
-	 *
-	 * @property {boolean} [shadow=false]
-	 * A flag to display a shadow on frameless windows.
-	 * `shadow` and `cornerRounding` are mutually exclusive.
-	 * On Windows 7, Aero theme is required.
-	 *
-	 * @property {boolean} [showBackgroundImages=false] - _Updatable._
-	 * Platforms Only.  If true, will show background images in the layout when the Views are hidden.
-	 * This occurs when the window is resizing or a tab is being dragged within the layout.
-	 *
-	 * @property {boolean} [showTaskbarIcon=true] - _Updatable._ _Windows_.
-	 * A flag to show the window's icon in the taskbar.
-	 *
-	 * @property {boolean} [smallWindow=false]
-	 * A flag to specify a frameless window that can be be created and resized to less than 41x36 px (width x height).
-	 * _Note: Caveats of small windows are no Aero Snap and drag to/from maximize._
-	 * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
-	 *
-	 * @property {boolean} [spellCheck=false]
-	 * Enable spell check in input text fields for the window.
-	 *
-	 * @property {string} [state="normal"]
-	 * The visible state of the window on creation.
-	 * One of:
-	 * * `"maximized"`
-	 * * `"minimized"`
-	 * * `"normal"`
-	 *
-	 * @property {string} [taskbarIcon=string] - Deprecated - use `icon` instead._Windows_.
-	 *
-	 * @property {string} [taskbarIconGroup=<application uuid>] - _Windows_.
-	 * Specify a taskbar group for the window.
-	 * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
-	 *
-	 * @property {string} [url="about:blank"]
-	 * The URL of the window.
-	 *
-	 * @property {string} [uuid=<application uuid>]
-	 * The `uuid` of the application, unique within the set of all `Application`s running in OpenFin Runtime.
-	 * If omitted, defaults to the `uuid` of the application spawning the window.
-	 * If given, must match the `uuid` of the  application spawning the window.
-	 * In other words, the application's `uuid` is the only acceptable value, but is the default, so there's
-	 * really no need to provide it.
-	 *
-	 * @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.
-	 */
-	/**
-	 * @PORTED
-	 * @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.
-	 * @property {ShowViewsOnTabDrag} [showViewsOnTabDrag] _Supported on Windows Operating Systems only_. Allows views to be shown when the user is dragging a tab around a layout.
-	 */
-	/**
-	 * @PORTED
-	 * @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.
-	 */
-	/**
-	 * @REMOVED
-	 * @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.
-	 */
-	/**
-	 * @REMOVED
-	 * @typedef {Object} ShowViewsOnTabDrag _Platform Windows Only_. Allows views to be shown when the user is manipulating the layout by repositioning a tab.
-	 * @property {boolean} [enabled=false] Enables or disables showing views when a tab is being dragged.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} CapturePageOptions
-	 * @property { Area } [area] The area of the window to be captured.
-	 * @property { string } [format='png'] The format of the captured image.  Can be 'png', 'jpg', or 'bmp'.
-	 * @property { number } [quality=100] Number representing quality of JPEG image only. Between 0 - 100.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef { object } Area
-	 * @property { number } height Area's height
-	 * @property { number } width Area's width
-	 * @property { number } x X coordinate of area's starting point
-	 * @property { number } y Y coordinate of area's starting point
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} FindInPageOptions
-	 * @property {boolean} [forward=true] Whether to search forward or backward.
-	 * @property {boolean} [findNext=false] Whether to begin a new text finding session. Should be true for first requests, and false for subsequent requests. Defaults to false.
-	 * @property {boolean} [matchCase=false] Whether search should be case-sensitive.
-	 * @property {boolean} [wordStart=false] Whether to look only at the start of words.
-	 * @property {boolean} [medialCapitalAsWordStart=false]
-	 * When combined with wordStart, accepts a match in the middle of a word if the match begins with an uppercase letter followed by a<br>
-	 * lowercase or non-letter. Accepts several other intra-word matches.
-	 */
-	/**
-	 * @REMOVED
-	 * @typedef {object} Transition
-	 * @property {Opacity} opacity - The Opacity transition
-	 * @property {Position} position - The Position transition
-	 * @property {Size} size - The Size transition
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} TransitionOptions
-	 * @property {boolean} interrupt - This option interrupts the current animation. When false it pushes
-	this animation onto the end of the animation queue.
-	 * @property {boolean} relative - Treat 'opacity' as absolute or as a delta. Defaults to false.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} Size
-	 * @property {number} duration - The total time in milliseconds this transition should take.
-	 * @property {boolean} relative - Treat 'opacity' as absolute or as a delta. Defaults to false.
-	 * @property {number} width - Optional if height is present. Defaults to the window's current width.
-	 * @property {number} height - Optional if width is present. Defaults to the window's current height.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} Position
-	 * @property {number} duration - The total time in milliseconds this transition should take.
-	 * @property {boolean} relative - Treat 'opacity' as absolute or as a delta. Defaults to false.
-	 * @property {number} left - Defaults to the window's current left position in virtual screen coordinates.
-	 * @property {number} top - Defaults to the window's current top position in virtual screen coordinates.
-	 */
-	/**
-	 * @PORTED
-	 * @typedef {object} Opacity
-	 * @property {number} duration - The total time in milliseconds this transition should take.
-	 * @property {boolean} relative - Treat 'opacity' as absolute or as a delta. Defaults to false.
-	 * @property {number} opacity - This value is clamped from 0.0 to 1.0.
-	 */
-	/**
-	 * @REMOVED
-	 * Bounds is a interface that has the properties of height,
-	 * width, left, top which are all numbers
-	 * @typedef { object } Bounds
-	 * @property { number } height Get the application height bound
-	 * @property { number } width Get the application width bound
-	 * @property { number } top Get the application top bound
-	 * @property { number } left Get the application left bound
-	 * @property { number } right Get the application right bound
-	 * @property { number } bottom Get the application bottom bound
-	 */
 	/**
 	 * A basic window that wraps a native HTML window. Provides more fine-grained
 	 * control over the window state such as the ability to minimize, maximize, restore, etc.
@@ -5127,83 +4285,6 @@ function requireInstance () {
 	    constructor(wire, identity) {
 	        super(wire, identity, 'window');
 	    }
-	    /**
-	     * Adds a listener to the end of the listeners array for the specified event.
-	     * @param eventType  - The type of the event.
-	     * @param listener - Called whenever an event of the specified type occurs.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function addListener
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
-	    /**
-	     * Adds a listener to the end of the listeners array for the specified event.
-	     * @param eventType  - The type of the event.
-	     * @param listener - Called whenever an event of the specified type occurs.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function on
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
-	    /**
-	     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function once
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
-	    /**
-	     * Adds a listener to the beginning of the listeners array for the specified event.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function prependListener
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
-	    /**
-	     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-	     * The listener is added to the beginning of the listeners array.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function prependOnceListener
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
-	    /**
-	     * Remove a listener from the listener array for the specified event.
-	     * Caution: Calling this method changes the array indices in the listener array behind the listener.
-	     * @param eventType  - The type of the event.
-	     * @param listener - The callback function.
-	     * @param options - Option to support event timestamps.
-	     *
-	     * @function removeListener
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
-	    /**
-	     * Removes all listeners, or those of the specified event.
-	     * @param eventType  - The type of the event.
-	     *
-	     * @function removeAllListeners
-	     * @memberof Window
-	     * @instance
-	     * @tutorial Window.EventEmitter
-	     */
 	    /**
 	     * create a new window
 	     * @internal
@@ -6195,10 +5276,9 @@ function requireInstance () {
 	    }
 	    /**
 	     * Shows the window if it is hidden at the specified location.
-	     * If the toggle parameter is set to true, the window will
-	     * alternate between showing and hiding.
-	     * @param left The left position of the window
-	     * @param top The right position of the window
+	     *
+	     * @param left The left position of the window in pixels
+	     * @param top The top position of the window in pixels
 	     * @param force Show will be prevented from closing when force is false and
 	     * ‘show-requested’ has been subscribed to for application’s main window
 	     *
@@ -6275,28 +5355,6 @@ function requireInstance () {
 	            .sendAction('window-authenticate', { userName, password, ...this.identity })
 	            .then(() => undefined);
 	    }
-	    /**
-	     * @typedef {object} ShowPopupMenuOptions
-	     * @property {Array<MenuItemTemplate>} template - An array describing the menu to show.
-	     * @property {number} [x] - The window x coordinate where to show the menu. Defaults to mouse position. If using must also use `y`.
-	     * @property {number} [y] - The window y coordinate where to show the menu. Defaults to mouse position. If using must also use `x`
-	     */
-	    /**
-	     * @typedef {object} MenuItemTemplate
-	     * @property {*} data - Data to be returned if the user selects the element. Must be serializable. Large objects can have a performance impact.
-	     * @property {'normal' | 'separator' | 'submenu' | 'checkbox'} [type] - Defaults to 'normal' unless a 'submenu' key exists
-	     * @property {string} [label] - The text to show on the menu item. Should be left undefined for `type: 'separator'`
-	     * @property {boolean} [enabled] - If false, the menu item will be greyed out and unclickable.
-	     * @property {boolean} [visible] - If false, the menu item will be entirely hidden.
-	     * @property {boolean} [checked] - Should only be specified for `checkbox` type menu items.
-	     * @property {string} [icon] - Image Data URI with image dimensions inferred from the encoded string
-	     * @property {Array<MenuItemTemplate>} [submenu] Should be specified for `submenu` type menu items. If `submenu` is specified, the `type: 'submenu'` can be omitted.
-	     */
-	    /**
-	     * @typedef {object} MenuResult
-	     * @property {'clicked' | 'closed'} result - Whether the user clicked on a menu item or the menu was closed (user clicked elsewhere).
-	     * @property {* | undefined} [data] - The data property of the menu item clicked by the user. Only defined if result was `clicked`.
-	     */
 	    /**
 	     * Shows a menu on the window.
 	     *
@@ -6397,31 +5455,6 @@ function requireInstance () {
 	    async closePopupMenu() {
 	        return this.wire.sendAction('close-popup-menu', { ...this.identity }).then(() => undefined);
 	    }
-	    /**
-	     * @PORTED
-	     * @typedef {object} PopupOptions
-	     * @property {string} [name] - If a window with this `name` exists, it will be shown as a popup. Otherwise, a new window with this `name` will be created. If this `name` is undefined, `initialOptions.name` will be used. If this `name` and `intialOptions.name` are both undefined, a `name` will be generated.
-	     * @property {string} [url] - Navigates to this `url` if showing an existing window as a popup, otherwise the newly created window will load this `url`.
-	     * @property {Window~options} [initialOptions] - Window creation options when using `showPopupWindow` to create a new window.
-	     * @property {Window~options} [additionalOptions] - Updatable window options applied to new and existing windows when shown as popups.
-	     * @property {function} [onPopupResult] - Executed when this window's popup calls `dispatchPopupResult`. Note: if this is defined, `showPopupWindow` will not return a `PopupResult`.
-	     * @property {function} [onPopupReady] - Executed when the popup window is shown. Provides the popup window to the provided function, and allows for easy access the popup window for additional behavior customization.
-	     * @property {number} [height] - Height of the popup window (takes priority over `intialOptions` size properties).
-	     * @property {number} [width] - Width of the popup window (takes priority over `intialOptions` size properties).
-	     * @property {number} [x] - Left position where the popup window will be shown (relative to the window calling `showPopupWindow`).
-	     * @property {number} [y] - Top position where the popup window will be shown (relative to the window calling `showPopupWindow`).
-	     * @property {'modal' | 'hide' | 'close'} [blurBehavior] - Determines what happens if the popup window is blurred. 'modal' restricts resizing and positioning in the caller, 'hide' hides the popup window on blur and 'close' closes the popup window on blur.
-	     * @property {'none' | 'hide' | 'close'} [resultDispatchBehavior] - Determines what happens when the popup window calls `dispatchPopupResult`. 'none' will do nothing, 'hide' hides the popup window on `dispatchPopupResult` and 'close' closes the popup window on `dispatchPopupResult`.
-	     * @property {boolean} [focus] - Determines if the popup window should or should not be focused when it is shown.
-	     * @property {boolean} [hideOnClose] - Hide the popup window instead of closing whenever `close` is called on it. Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
-	     */
-	    /**
-	     * @PORTED
-	     * @typedef {object} PopupResult
-	     * @property {Identity} identity - `name` and `uuid` of the popup window that called dispatched this result.
-	     * @property {'clicked' | 'dismissed'} result - Result of the user interaction with the popup window.
-	     * @property {* | undefined} [data] - Data passed to `dispatchPopupResult`.
-	     */
 	    /**
 	     * Dispatch a result to the caller of `showPopupWindow`.
 	     *
@@ -6673,7 +5706,7 @@ function requireWindow () {
 		 * * {@link _WindowModule} contains static members of the `Window` API, accessible through `fin.Window`.
 		 * * {@link _Window} describes an instance of an OpenFin Window, e.g. as returned by `fin.Window.getCurrent`.
 		 *
-		 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+		 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 		 * both of these were documented on the same page.
 		 *
 		 * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
@@ -6757,83 +5790,6 @@ class System extends base_1$j.EmitterBase {
             });
         });
     }
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - Called whenever an event of the specified type occurs.
-     * @param options - Option to support event timestamps.
-     *
-     * @function addListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - Called whenever an event of the specified type occurs.
-     * @param options - Option to support event timestamps.
-     *
-     * @function on
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function once
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a listener to the beginning of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function prependListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * The listener is added to the beginning of the listeners array.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function prependOnceListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Remove a listener from the listener array for the specified event.
-     * Caution: Calling this method changes the array indices in the listener array behind the listener.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function removeListener
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
-    /**
-     * Removes all listeners, or those of the specified event.
-     * @param eventType  - The type of the event.
-     *
-     * @function removeAllListeners
-     * @memberof System
-     * @instance
-     * @tutorial System.EventEmitter
-     */
     /**
      * Returns the version of the runtime. The version contains the major, minor,
      * build and revision numbers.
@@ -9318,7 +8274,8 @@ function errorToPOJO(error) {
         stack: error.stack,
         name: error.name,
         message: error.message,
-        toString: error.toString
+        // support the case where stack is empty or missing
+        toString: () => error.stack || error.toString()
     };
 }
 errors.errorToPOJO = errorToPOJO;
@@ -11035,20 +9992,6 @@ var clipboard = {};
 Object.defineProperty(clipboard, "__esModule", { value: true });
 clipboard.Clipboard = void 0;
 const base_1$d = base;
-/**
- * @PORTED
- * WriteRequestType interface
- * @typedef { object } WriteRequestType
- * @property { string } data Data to be written
- * @property { string } [type] Clipboard Type
- */
-/**
- * @PORTED
- * OpenFin.WriteAnyClipboardRequest interface
- * @typedef { object } OpenFin.WriteAnyClipboardRequest
- * @property { string } data Data to be written
- * @property { OpenFin.ClipboardSelectionType } [type] Clipboard Type defaults to 'clipboard', use 'selection' for linux
- */
 /**
  * The Clipboard API allows reading and writing to the clipboard in multiple formats.
  *
@@ -11261,83 +10204,6 @@ class ExternalApplication extends base_1$c.EmitterBase {
         super(wire, 'external-application', identity.uuid);
         this.identity = identity;
     }
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - Called whenever an event of the specified type occurs.
-     * @param options - Option to support event timestamps.
-     *
-     * @function addListener
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - Called whenever an event of the specified type occurs.
-     * @param options - Option to support event timestamps.
-     *
-     * @function on
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function once
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
-    /**
-     * Adds a listener to the beginning of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function prependListener
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * The listener is added to the beginning of the listeners array.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function prependOnceListener
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
-    /**
-     * Remove a listener from the listener array for the specified event.
-     * Caution: Calling this method changes the array indices in the listener array behind the listener.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function removeListener
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
-    /**
-     * Removes all listeners, or those of the specified event.
-     * @param eventType  - The type of the event.
-     *
-     * @function removeAllListeners
-     * @memberof ExternalApplication
-     * @instance
-     * @tutorial ExternalApplication.EventEmitter
-     */
     /**
      * Retrieves information about the external application.
      *
@@ -11427,7 +10293,7 @@ Factory$5.ExternalApplicationModule = ExternalApplicationModule;
 	 * * {@link ExternalApplicationModule} contains static members of the `ExternalApplication` type, accessible through `fin.ExternalApplication`.
 	 * * {@link ExternalApplication} describes an instance of an OpenFin ExternalApplication, e.g. as returned by `fin.ExternalApplication.getCurrent`.
 	 *
-	 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+	 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 	 * both of these were documented on the same page.
 	 *
 	 * @packageDocumentation
@@ -11474,83 +10340,6 @@ class _Frame extends base_1$a.EmitterBase {
         super(wire, 'frame', identity.uuid, identity.name);
         this.identity = identity;
     }
-    /**
-     * Adds the listener function to the end of the listeners array for the specified event type.
-     * @param eventType  - The type of the event.
-     * @param listener - Called whenever an event of the specified type occurs.
-     * @param options - Option to support event timestamps.
-     *
-     * @function addListener
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
-    /**
-     * Adds a listener to the end of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - Called whenever an event of the specified type occurs.
-     * @param options - Option to support event timestamps.
-     *
-     * @function on
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function once
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
-    /**
-     * Adds a listener to the beginning of the listeners array for the specified event.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function prependListener
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
-    /**
-     * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
-     * The listener is added to the beginning of the listeners array.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function prependOnceListener
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
-    /**
-     * Remove a listener from the listener array for the specified event.
-     * Caution: Calling this method changes the array indices in the listener array behind the listener.
-     * @param eventType  - The type of the event.
-     * @param listener - The callback function.
-     * @param options - Option to support event timestamps.
-     *
-     * @function removeListener
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
-    /**
-     * Removes all listeners, or those of the specified event.
-     * @param eventType  - The type of the event.
-     *
-     * @function removeAllListeners
-     * @memberof Frame
-     * @instance
-     * @tutorial Frame.EventEmitter
-     */
     /**
      * Returns a frame info object for the represented frame.
      *
@@ -11678,7 +10467,7 @@ Factory$4._FrameModule = _FrameModule;
 	 * * {@link _FrameModule} contains static members of the `Frame` API, accessible through `fin.Frame`.
 	 * * {@link _Frame} describes an instance of an OpenFin Frame, e.g. as returned by `fin.Frame.getCurrent`.
 	 *
-	 * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+	 * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 	 * both of these were documented on the same page.
 	 *
 	 * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
@@ -13024,7 +11813,6 @@ class Layout extends base_1$6.Base {
             // don't expose
         });
         const client = await this.platform.getClient();
-        console.log(`Layout::toConfig() called!`);
         return client.dispatch('get-frame-snapshot', {
             target: this.identity
         });
@@ -13074,7 +11862,7 @@ class Layout extends base_1$6.Base {
             // don't expose
         });
         const client = await __classPrivateFieldGet$5(this, _Layout_layoutClient, "f").getValue();
-        const root = await client.getRoot(this.identity);
+        const root = await client.getRoot('layoutName' in this.identity ? this.identity : undefined);
         return layout_entities_1.LayoutNode.getEntity(root, client);
     }
 }
@@ -13092,7 +11880,7 @@ var __classPrivateFieldSet$4 = (commonjsGlobal && commonjsGlobal.__classPrivateF
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_throwIfLayoutManagerNotInitialized;
+var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_waitForBackCompatLayoutManager, _LayoutModule_getSafeLayoutManager;
 Object.defineProperty(Factory$2, "__esModule", { value: true });
 Factory$2.LayoutModule = void 0;
 const base_1$5 = base;
@@ -13145,7 +11933,7 @@ class LayoutModule extends base_1$5.Base {
          * ```
          */
         this.init = async (options = {}) => {
-            this.wire.sendAction('layout-init').catch((e) => {
+            this.wire.sendAction('layout-init').catch(() => {
                 // don't expose
             });
             if (!this.fin.me.isWindow) {
@@ -13155,40 +11943,57 @@ class LayoutModule extends base_1$5.Base {
                 throw new Error('Layout.init was already called, please use Layout.create to add additional layouts.');
             }
             __classPrivateFieldSet$4(this, _LayoutModule_layoutInitializationAttempted, true, "f");
-            __classPrivateFieldSet$4(this, _LayoutModule_layoutManager, await this.wire.environment.initLayout(this.fin, this.wire, options), "f");
-            // back-compat ONLY if layoutManagerOverride not provided
+            __classPrivateFieldSet$4(this, _LayoutModule_layoutManager, await this.wire.environment.initLayoutManager(this.fin, this.wire, options), "f");
+            // in single-layout case, we return the undocumented layoutManager type (deprecate with CORE-1081)
+            let backCompatLayoutPromise;
             if (!options.layoutManagerOverride) {
-                const layoutInstance = await __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").resolveLayout();
-                const layout = this.wrapSync(layoutInstance.identity);
-                // Backward compat - undocumented / not typed layoutInstance as layoutManager
-                return Object.assign(layout, { layoutManager: layoutInstance });
+                backCompatLayoutPromise = __classPrivateFieldGet$4(this, _LayoutModule_waitForBackCompatLayoutManager, "f").call(this, this.fin);
+            }
+            // apply the initial snapshot which in turn will call fin.Platform.Layout.create()
+            const platformClient = await this.fin.Platform.getCurrentSync().getClient();
+            const snapshot = await platformClient.dispatch('get-initial-layout-snapshot');
+            await __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").applyLayoutSnapshot(snapshot);
+            if (backCompatLayoutPromise) {
+                return backCompatLayoutPromise;
             }
-            // Warn user if they do not create any layouts in the next 10 seconds
+            // warn user if they do not call create() in the next 30 seconds
             setTimeout(() => {
-                const layoutSize = Object.keys(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").getLayouts()).length;
-                if (layoutSize === 0) {
-                    console.warn(`[Layout.init] Layout.init was called but no layouts have been created yet. Make sure you ` +
+                if (__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f")?.size() === 0) {
+                    console.warn(`[Layout.init] Layout.init was called 30s ago, but no layouts have been created yet. Make sure you ` +
                         `override LayoutManager.applyLayoutSnapshot, and then call fin.Platform.Layout.create()`);
                 }
-            }, 10000);
+            }, 30000);
             return this.wrapSync(this.fin.me.identity);
         };
+        // deprecate with CORE-1081
+        _LayoutModule_waitForBackCompatLayoutManager.set(this, async (fin) => {
+            let layoutManager;
+            let resolve;
+            const layoutResolved = new Promise((r) => {
+                resolve = r;
+            });
+            // wait for a layout to be created
+            await fin.me.once('layout-ready', async ({ layoutIdentity }) => {
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                layoutManager = await this.wire.environment.resolveLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
+                // Backward compat - undocumented / not typed openfin-layout as layoutManager
+                // TODO: eventually deprecate this
+                resolve(Object.assign(this.wrapSync(layoutIdentity), { layoutManager }));
+            });
+            return layoutResolved;
+        });
         /**
          * Returns the layout manager for the current window
          * @returns
          */
         this.getCurrentLayoutManagerSync = () => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this);
-            // @ts-expect-error User may have implemented their own snapshot type when overriding LayoutManager
-            return __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f");
+            return __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_getSafeLayoutManager).call(this, `fin.Platform.Layout.getCurrentLayoutManagerSync()`);
         };
         this.create = async (options) => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this);
-            return this.wire.environment.createLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), options);
+            return this.wire.environment.createLayout(__classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_getSafeLayoutManager).call(this, `fin.Platform.Layout.create()`), options);
         };
         this.destroy = async (layoutIdentity) => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this);
-            return this.wire.environment.destroyLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
+            return this.wire.environment.destroyLayout(__classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_getSafeLayoutManager).call(this, `fin.Platform.Layout.destroy()`), layoutIdentity);
         };
     }
     /**
@@ -13211,7 +12016,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     async wrap(identity) {
-        this.wire.sendAction('layout-wrap').catch((e) => {
+        this.wire.sendAction('layout-wrap').catch(() => {
             // don't expose
         });
         return new Instance_1$2.Layout(identity, this.wire);
@@ -13236,7 +12041,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     wrapSync(identity) {
-        this.wire.sendAction('layout-wrap-sync').catch((e) => {
+        this.wire.sendAction('layout-wrap-sync').catch(() => {
             // don't expose
         });
         return new Instance_1$2.Layout(identity, this.wire);
@@ -13252,7 +12057,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     async getCurrent() {
-        this.wire.sendAction('layout-get-current').catch((e) => {
+        this.wire.sendAction('layout-get-current').catch(() => {
             // don't expose
         });
         if (!this.fin.me.isWindow) {
@@ -13275,7 +12080,7 @@ class LayoutModule extends base_1$5.Base {
      * ```
      */
     getCurrentSync() {
-        this.wire.sendAction('layout-get-current-sync').catch((e) => {
+        this.wire.sendAction('layout-get-current-sync').catch(() => {
             // don't expose
         });
         if (!this.fin.me.isWindow) {
@@ -13286,10 +12091,11 @@ class LayoutModule extends base_1$5.Base {
     }
 }
 Factory$2.LayoutModule = LayoutModule;
-_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_throwIfLayoutManagerNotInitialized = function _LayoutModule_throwIfLayoutManagerNotInitialized() {
+_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_waitForBackCompatLayoutManager = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_getSafeLayoutManager = function _LayoutModule_getSafeLayoutManager(method) {
     if (!__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f")) {
-        throw new Error('You must call init before using this API');
+        throw new Error(`You must call init before using the API ${method}`);
     }
+    return __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f");
 };
 
 (function (exports) {
@@ -13299,7 +12105,7 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layou
 	 * * {@link LayoutModule} contains static members of the `Layout` API, accessible through `fin.Platform.Layout`.
 	 * * {@link Layout} describes an instance of an OpenFin Layout, e.g. as returned by `fin.Platform.Layout.getCurrent`.
 	 *
-	 * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+	 * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 	 * both of these were documented on the same page.
 	 *
 	 * @packageDocumentation
@@ -13580,7 +12386,7 @@ Factory$3.PlatformModule = PlatformModule;
 	 * * {@link PlatformModule} contains static members of the `Platform` API, accessible through `fin.Platform`.
 	 * * {@link Platform} describes an instance of an OpenFin Platform, e.g. as returned by `fin.Platform.getCurrent`.
 	 *
-	 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+	 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 	 * both of these were documented on the same page.
 	 *
 	 * @packageDocumentation
@@ -14468,57 +13274,6 @@ function requireInteropBroker () {
 	    /*
 	    Client API
 	    */
-	    /**
-	     * @REMOVED
-	     * SetContextOptions interface
-	     * @typedef { object } SetContextOptions
-	     * @property { Context } {context} - New context to set.
-	     */
-	    /**
-	     * @REMOVED
-	     * GetContextOptions interface
-	     * @typedef { object } GetContextOptions
-	     * @property { string } [contextType] - Context Type
-	     */
-	    // TODO: extract inline type and do proper comments
-	    /**
-	     * @REMOVED
-	     * JoinContextGroupOptions interface
-	     * @typedef { object } JoinContextGroupOptions
-	     * @property { string } contextGroupId - Id of the context group.
-	     * @property { Identity | ClientIdentity } [target] - Identity of the entity you wish to join to a context group.
-	     */
-	    /**
-	     * @REMOVED
-	     * AddClientToContextGroupOptions interface
-	     * @typedef { object } AddClientToContextGroupOptions
-	     * @property { string } contextGroupId - Name of the context group.
-	     */
-	    /**
-	     * @REMOVED
-	     * RemoveFromContextGroupOptions interface
-	     * @typedef { object } RemoveFromContextGroupOptions
-	     * @property { Identity | ClientIdentity } target - Identity of the entity you wish to join to a context group.
-	     */
-	    /**
-	     * @REMOVED
-	     * GetInfoForContextGroupOptions interface
-	     * @typedef { object } GetInfoForContextGroupOptions
-	     * @property { string } contextGroupId - Name of the context group to get info for.
-	     */
-	    /**
-	     * @REMOVED
-	     * GetAllClientsInContextGroupOptions interface
-	     * @typedef { object } GetAllClientsInContextGroupOptions
-	     * @property { string } contextGroupId - Name of the context group to get info for.
-	     */
-	    /**
-	     * @PORTED
-	     * InfoForIntentOptions interface
-	     * @typedef { object } InfoForIntentOptions
-	     * @property { string } name Name of the intent to get info for.
-	     * @property { Context } [context] Optional context.
-	     */
 	    /**
 	     * Sets a context for the context group of the incoming current entity.
 	     * @param setContextOptions - New context to set.
@@ -14987,7 +13742,7 @@ function requireInteropBroker () {
 	     * // }
 	     * ```
 	     *
-	     * More information on the IntentResolution type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/IntentResolution).
+	     * More information on the IntentResolution type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/Metadata#intentresolution).
 	     *
 	     * @param contextForIntent Data passed between entities and applications.
 	     * @param clientIdentity Identity of the Client making the request.
@@ -15678,97 +14433,6 @@ const base_1$2 = base;
 const SessionContextGroupClient_1 = SessionContextGroupClient$1;
 const utils_1$2 = utils$1;
 /**
- * @PORTED
- * @typedef { object } Intent
- * @summary The combination of an action and a context that is passed to an application for resolution.
- * @property { string } name Name of the intent.
- * @property { Context } context Data associated with the intent
- */
-/**
- * @REMOVED
- * @typedef { object } Subscription
- * @summary Object returned when subscribing a handler.
- * @property { function } unsubscribe Function to unsubscribe the handler.
- */
-/**
- * @typedef { function } ContextHandler
- * @summary Subscription function for addContextHandler.
- */
-/**
- * @typedef { function } IntentHandler
- * @summary Subscription function for registerIntentHandler
- */
-/**
- * @PORTED
- * @typedef { object } ClientIdentity
- * @summary The Identity for a Channel Client. Includes endpointId to differentiate between different connections for an entity.
- * @property {string} uuid GUID of an application.
- * @property {string} name Name of an entity in an application.
- * @property {string} endpointId Unique differentiator for different Channel connections for an entity.
- */
-/**
- * @PORTED
- * @typedef { object } ContextGroupInfo
- * @summary Information for a Context Group. Contains metadata for displaying the group properly.
- * @property {string} id Name of the context group
- * @property {DisplayMetadata} displayMetadata Metadata for the Context Group. Contains the group's human-readable name, color, and an image, as defined by the Interop Broker.
- */
-/**
- * @PORTED
- * @typedef { object } DisplayMetadata
- * @summary The display data for a Context Group.
- * @property {string} name A user-readable name for this context group, e.g: `"Red"`
- * @property {string} [color] The color that should be associated within this context group when displaying this context group in a UI, e.g: `0xFF0000`.
- * @property {string} [glyph] A URL of an image that can be used to display this context group
- */
-/**
- * @PORTED
- * @typedef { object } Context
- * @summary Data passed between entities and applications.
- * @property {object} [id] An object containing string key-value pairs for the bulk of the data for the context. Differs between context types.
- * @property {string} [name] User-readable name for the incoming context.
- * @property {string} type Conserved type for the context (e.g. `instrument` or `country`)
- */
-/**
- * @REMOVED
- * @typedef { object } ContextForIntent
- * @summary Data passed between entities and applications, including an optional metadata.
- * @property {object} [id] An object containing string key-value pairs for the bulk of the data for the context. Differs between context types.
- * @property {string} [name] User-readable name for the incoming context.
- * @property {string} type Conserved type for the context (e.g. `instrument` or `country`)
- * @property {any} [metadata]
- */
-/**
- * @REMOVED
- * @typedef { object } SessionContextGroup
- * @summary An instance of a SessionContextGroup
- * @property {string} id The SessionContextGroup's id.
- * @property {setContext} setContext Sets a context of a certain type
- * @property {getCurrentContext} getCurrentContext Gets the currently set context of a certain type
- * @property {addContextHandler} addContextHandler Adds a handler for context change.
- */
-/**
- * @typedef {function} setContext
- * @summary A SessionContextGroup instance method for setting a context in the SessionContextGroup.
- * @param context The Context to be set.
- *
- */
-/**
- * @typedef {function} getCurrentContext
- * @summary A SessionContextGroup instance method for getting the current context of a certain type.
- * @param contextType The Context Type to get. If not specified the last contextType set would get used.
- *
- */
-/**
- * @typedef {function} addContextHandler
- * @summary A SessionContextGroup instance method for adding a handler for context change.
- * @param contextHandler The callback to be invoked. Is invoked when (a) the context changes or (b) immediately after getting created if the context is already set.
- * @param contextType The context type this handler should listen to. If not specified, a global handler for all context types will get created. Only one global handler is allowed per SessionContextGroup.
- *
- */
-/**
- * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
- *
  * The Interop Client API is broken up into two groups:
  *
  * **Content Facing APIs** - For Application Developers putting Views into a Platform Window, who care about Context. These are APIs that send out and receive the Context data that flows between applications. Think of this as the Water in the Interop Pipes.
@@ -16334,7 +14998,11 @@ class InteropClient extends base_1$2.Base {
             listener({ type: 'interop-broker', topic: 'disconnected', brokerName: uuid });
         });
     }
-    // used to ferry fdc3-only calls from the fdc3 shim to the Interop Broker
+    /**
+     * @internal
+     *
+     * Used to ferry fdc3-only calls from the fdc3 shim to the Interop Broker
+     */
     static async ferryFdc3Call(interopClient, action, payload) {
         const client = await __classPrivateFieldGet$2(interopClient, _InteropClient_clientPromise, "f");
         return client.dispatch(action, payload || null);
@@ -16399,13 +15067,6 @@ function requireFactory () {
 	const common_utils_1 = commonUtils;
 	const defaultOverride = (Class) => new Class();
 	const BrokerParamAccessError = 'You have attempted to use or modify InteropBroker parameters, which is not allowed. You are likely using an older InteropBroker override scheme. Please consult our Interop docs for guidance on migrating to the new override scheme.';
-	/**
-	 * @PORTED
-	 * @typedef { object } InteropConfig
-	 * @summary Information relevant to the Interop Broker.
-	 * @property {string} [currentContextGroup] Context Group for the client. (green, yellow, red, etc.)
-	 * @property {string} [providerId] When provided, automatically connects the client to the specified provider uuid
-	 */
 	/**
 	 * Manages creation of Interop Brokers and Interop Clients. These APIs are called under-the-hood in Platforms.
 	 *
@@ -16790,7 +15451,7 @@ Factory.SnapshotSourceModule = SnapshotSourceModule;
 	 * * {@link SnapshotSourceModule} contains static members of the `SnapshotSource` API, accessible through `fin.SnapshotSource`.
 	 * * {@link SnapshotSource} describes an instance of an OpenFin SnapshotSource, e.g. as returned by `fin.SnapshotSource.wrap`.
 	 *
-	 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
+	 * These are separate code entities, and are documented separately.  In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/32.114.76.10/index.html),
 	 * both of these were documented on the same page.
 	 *
 	 * @packageDocumentation
@@ -17224,7 +15885,7 @@ class MockEnvironment {
     getRtcPeer() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }
-    initLayout() {
+    initLayoutManager() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }
     async createLayout() {
@@ -17233,6 +15894,9 @@ class MockEnvironment {
     async destroyLayout() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }
+    async resolveLayout() {
+        throw new Error(me_1.environmentUnsupportedMessage);
+    }
     initPlatform() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }