@openfin/core 34.78.53 → 34.78.56

package/out/mock-alpha.d.ts

@@ -3636,7 +3636,7 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue true
      *
-     * Toggling off would keep the Window alive even if all its Views were closed.
+     * Setting this to false 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.
@@ -3646,7 +3646,8 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue 'all'
      *
-     * Determines which views prevent close if `closeOnLastViewRemoved` is set to true. Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
+     * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
+     +    * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
      * **NOTE:** - This option is ignored in non-Platforms apps.
      */
     viewsPreventingClose: 'all' | 'layout';
@@ -4453,7 +4454,7 @@ declare type CreateViewPayload = {
 /**
  * @interface
  */
-declare type CreateViewTarget = LayoutIdentity & {
+declare type CreateViewTarget = (Identity_5 | LayoutIdentity) & {
     /**
      * If specified, view creation will not attach to a window and caller must
      * insert the view into the layout explicitly
@@ -4593,6 +4594,14 @@ declare type DestroyedEvent = BaseEvent_4 & {
     type: 'destroyed';
 };
 
+/**
+ * @interface
+ */
+declare type DeviceInfo = {
+    vendorId: string | number;
+    productId: string | number;
+};
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -5053,9 +5062,10 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
-    initLayout(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
+    initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
     createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<void>;
     destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
+    resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
     initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
     observeBounds(element: Element, onChange: (bounds: DOMRect) => Promise<void> | void): () => void;
     writeToken(path: string, token: string): Promise<string>;
@@ -7433,7 +7443,7 @@ declare class InteropBroker extends Base {
      * // }
      * ```
      *
-     * 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.
@@ -8607,7 +8617,7 @@ declare type LaunchIntoPlatformPayload = {
 declare class Layout extends Base {
     #private;
     /* Excluded from this release type: init */
-    identity: OpenFin_2.LayoutIdentity;
+    identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     private platform;
     wire: Transport;
     /* Excluded from this release type: __constructor */
@@ -8823,25 +8833,23 @@ declare type LayoutEntityTypes = Exclude<GoldenLayout.ItemType, 'component' | 'r
  */
 declare type LayoutIdentity = Identity_5 & {
     /**
-     * The name of the layout an action should be targeted to. When not provided,
-     * OpenFin attempts to resolve the instance via visibility checks.
+     * The name of the layout in a given window.
      */
-    layoutName?: string;
+    layoutName: string;
 };
 
 /**
- * Generated when a window and all of its layout's views have either finished or failed navigation.
+ * Generated when the window and all of its layout's views have either finished or failed navigation, once per layout.
  * @interface
  */
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     ofViews: (OpenFin_2.Identity & {
         entityType: 'view';
     })[];
 };
 
-/* Excluded from this release type: LayoutInstance */
-
 /**
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
  * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
@@ -8869,7 +8877,7 @@ declare type LayoutItemConfig = {
  *
  * **NOTE**: Internal use only. This type is reserved for Workspace Browser implementation.
  *
- * Responsible for aggergating all layout snapshots and storing LayoutInstances
+ * Responsible for aggregating all layout snapshots and storing layout instances
  */
 declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
@@ -8893,16 +8901,6 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
      * @throws if Object.keys(snapshot).length > 1
      */
     applyLayoutSnapshot(snapshot: T): Promise<void>;
-    /**
-     * Called at the start of layout initialization. Adds a new LayoutInstance if the snapshot
-     * contains a single layout.
-     *
-     * Throws if the snapshot contains more than 1 layout, it is expected that the user handles calling
-     * fin.Platform.Layout.create() once for each layout to properly connect it to their UI state.
-     *
-     * @param snapshot
-     * @throws if Object.keys(snapshot).length > 1
-     */
     /**
      * @experimental
      *
@@ -8923,31 +8921,49 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      *
-     * @param layoutIdentity
-     * @returns
+     * A hook provided to the consumer for controlling how OpenFin routes Layout API calls. Override
+     * this method to control the target layout for Layout API calls.
+     *
+     * Example use case: You have hidden all the layouts and are showing a dialog that will
+     * execute an API call (ex: Layout.replace()) - override this method and save the
+     * "last visible" layout identity and return it.
+     *
+     * By default, OpenFin will use a series of checks to determine which Layout the API
+     * call must route to in this order of precedence:
+     * - try to resolve the layout from the layoutIdentity, throws if missing
+     * - if there is only 1 layout, resolves that one
+     * - enumerates all layouts checks visibility via element offsetTop/Left + window.innerHeight/Width
+     * - returns undefined
+     *
+     * @param identity
+     * @returns LayoutIdentity | undefined
      */
-    resolveLayout(layoutIdentity?: LayoutIdentity): Promise<LayoutInstance>;
+    resolveLayoutIdentity(identity?: Identity_5 | LayoutIdentity): LayoutIdentity | undefined;
     /**
      * @experimental
      *
-     * Returns a LayoutInstance if one exists with the name layoutIdentity.layoutName.
-     * Throws if it does not exist.
-     * @param layoutName
-     * @returns
+     * A hook provided to the consumer when it's time to remove a layout. Use this hook to
+     * update your local state and remove the layout for the given LayoutIdentity. Note that
+     * this hook does not call `fin.Platform.Layout.destroy()` for you, instead it is to
+     * signify to your application it's time to destroy this layout.
+     *
+     * Note that if the Window Option {@link WindowOptions.closeOnLastViewRemoved} is true, and the last View in this layout is closed, this hook will be called before the window closes.
+     *
+     * @param LayoutIdentity
      */
-    getLayoutByName(layoutName: string): LayoutInstance;
+    removeLayout({ layoutName }: LayoutIdentity): Promise<void>;
     /**
      * @experimental
      */
-    getLayouts(): Record<string, LayoutInstance>;
+    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
+    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
     /**
      * @experimental
      */
-    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
+    size(): number;
 }
 
 /**
@@ -8994,7 +9010,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrap(identity: OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
+    wrap(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
     /**
      * Synchronously returns a Layout object that represents a Window's layout.
      *
@@ -9014,7 +9030,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrapSync(identity: OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
+    wrapSync(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
     /**
      * Asynchronously returns a Layout object that represents a Window's layout.
      *
@@ -9190,11 +9206,12 @@ declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
 /**
- * Generated when a window and all of its layout's views have been created and can receive API calls.
+ * Generated when the layout and all of the its views have been created and can receive API calls.
  * @interface
  */
 declare type LayoutReadyEvent = BaseEvent_5 & {
     type: 'layout-ready';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     views: (OpenFin_2.Identity & {
         success: boolean;
     })[];
@@ -10132,6 +10149,7 @@ declare namespace OpenFin_2 {
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
+        DeviceInfo,
         Permissions_2 as Permissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
@@ -10289,7 +10307,6 @@ declare namespace OpenFin_2 {
         InitLayoutOptions,
         LayoutManagerConstructor,
         LayoutManagerOverride,
-        LayoutInstance,
         LayoutManager,
         CreateLayoutOptions,
         PresetLayoutOptions_2 as PresetLayoutOptions,
@@ -10481,6 +10498,7 @@ declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
     webAPIs?: WebPermission[];
+    devices?: DeviceInfo[];
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12821,7 +12839,7 @@ declare type ReplaceLayoutPayload = {
     /**
      * Identity of the window whose layout will be replaced.
      */
-    target: LayoutIdentity;
+    target: Identity_5 | LayoutIdentity;
 };
 
 /**
@@ -16411,7 +16429,7 @@ declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformVi
  */
 declare type ViewDetachedEvent = BaseEvent_5 & {
     type: 'view-detached';
-    target: OpenFin_2.Identity;
+    target: OpenFin_2.Identity | null;
     previousTarget: OpenFin_2.Identity;
     viewIdentity: OpenFin_2.Identity;
 };
@@ -17647,7 +17665,7 @@ declare namespace WebContentsEvents {
  * `clipboard-read`: Request access to read from the clipboard.<br>
  * `clipboard-sanitized-write`: Request access to write to the clipboard.
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | OpenExternalPermission;
+declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
 
 /**
  * Object representing headers and their values, where the

package/out/mock-beta.d.ts

@@ -3636,7 +3636,7 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue true
      *
-     * Toggling off would keep the Window alive even if all its Views were closed.
+     * Setting this to false 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.
@@ -3646,7 +3646,8 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue 'all'
      *
-     * Determines which views prevent close if `closeOnLastViewRemoved` is set to true. Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
+     * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
+     +    * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
      * **NOTE:** - This option is ignored in non-Platforms apps.
      */
     viewsPreventingClose: 'all' | 'layout';
@@ -4453,7 +4454,7 @@ declare type CreateViewPayload = {
 /**
  * @interface
  */
-declare type CreateViewTarget = LayoutIdentity & {
+declare type CreateViewTarget = (Identity_5 | LayoutIdentity) & {
     /**
      * If specified, view creation will not attach to a window and caller must
      * insert the view into the layout explicitly
@@ -4593,6 +4594,14 @@ declare type DestroyedEvent = BaseEvent_4 & {
     type: 'destroyed';
 };
 
+/**
+ * @interface
+ */
+declare type DeviceInfo = {
+    vendorId: string | number;
+    productId: string | number;
+};
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -5053,9 +5062,10 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
-    initLayout(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
+    initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
     createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<void>;
     destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
+    resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
     initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
     observeBounds(element: Element, onChange: (bounds: DOMRect) => Promise<void> | void): () => void;
     writeToken(path: string, token: string): Promise<string>;
@@ -7433,7 +7443,7 @@ declare class InteropBroker extends Base {
      * // }
      * ```
      *
-     * 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.
@@ -8607,7 +8617,7 @@ declare type LaunchIntoPlatformPayload = {
 declare class Layout extends Base {
     #private;
     /* Excluded from this release type: init */
-    identity: OpenFin_2.LayoutIdentity;
+    identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     private platform;
     wire: Transport;
     /* Excluded from this release type: __constructor */
@@ -8823,25 +8833,23 @@ declare type LayoutEntityTypes = Exclude<GoldenLayout.ItemType, 'component' | 'r
  */
 declare type LayoutIdentity = Identity_5 & {
     /**
-     * The name of the layout an action should be targeted to. When not provided,
-     * OpenFin attempts to resolve the instance via visibility checks.
+     * The name of the layout in a given window.
      */
-    layoutName?: string;
+    layoutName: string;
 };
 
 /**
- * Generated when a window and all of its layout's views have either finished or failed navigation.
+ * Generated when the window and all of its layout's views have either finished or failed navigation, once per layout.
  * @interface
  */
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     ofViews: (OpenFin_2.Identity & {
         entityType: 'view';
     })[];
 };
 
-/* Excluded from this release type: LayoutInstance */
-
 /**
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
  * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
@@ -8869,7 +8877,7 @@ declare type LayoutItemConfig = {
  *
  * **NOTE**: Internal use only. This type is reserved for Workspace Browser implementation.
  *
- * Responsible for aggergating all layout snapshots and storing LayoutInstances
+ * Responsible for aggregating all layout snapshots and storing layout instances
  */
 declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
@@ -8893,16 +8901,6 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
      * @throws if Object.keys(snapshot).length > 1
      */
     applyLayoutSnapshot(snapshot: T): Promise<void>;
-    /**
-     * Called at the start of layout initialization. Adds a new LayoutInstance if the snapshot
-     * contains a single layout.
-     *
-     * Throws if the snapshot contains more than 1 layout, it is expected that the user handles calling
-     * fin.Platform.Layout.create() once for each layout to properly connect it to their UI state.
-     *
-     * @param snapshot
-     * @throws if Object.keys(snapshot).length > 1
-     */
     /**
      * @experimental
      *
@@ -8923,31 +8921,49 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      *
-     * @param layoutIdentity
-     * @returns
+     * A hook provided to the consumer for controlling how OpenFin routes Layout API calls. Override
+     * this method to control the target layout for Layout API calls.
+     *
+     * Example use case: You have hidden all the layouts and are showing a dialog that will
+     * execute an API call (ex: Layout.replace()) - override this method and save the
+     * "last visible" layout identity and return it.
+     *
+     * By default, OpenFin will use a series of checks to determine which Layout the API
+     * call must route to in this order of precedence:
+     * - try to resolve the layout from the layoutIdentity, throws if missing
+     * - if there is only 1 layout, resolves that one
+     * - enumerates all layouts checks visibility via element offsetTop/Left + window.innerHeight/Width
+     * - returns undefined
+     *
+     * @param identity
+     * @returns LayoutIdentity | undefined
      */
-    resolveLayout(layoutIdentity?: LayoutIdentity): Promise<LayoutInstance>;
+    resolveLayoutIdentity(identity?: Identity_5 | LayoutIdentity): LayoutIdentity | undefined;
     /**
      * @experimental
      *
-     * Returns a LayoutInstance if one exists with the name layoutIdentity.layoutName.
-     * Throws if it does not exist.
-     * @param layoutName
-     * @returns
+     * A hook provided to the consumer when it's time to remove a layout. Use this hook to
+     * update your local state and remove the layout for the given LayoutIdentity. Note that
+     * this hook does not call `fin.Platform.Layout.destroy()` for you, instead it is to
+     * signify to your application it's time to destroy this layout.
+     *
+     * Note that if the Window Option {@link WindowOptions.closeOnLastViewRemoved} is true, and the last View in this layout is closed, this hook will be called before the window closes.
+     *
+     * @param LayoutIdentity
      */
-    getLayoutByName(layoutName: string): LayoutInstance;
+    removeLayout({ layoutName }: LayoutIdentity): Promise<void>;
     /**
      * @experimental
      */
-    getLayouts(): Record<string, LayoutInstance>;
+    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
+    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
     /**
      * @experimental
      */
-    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
+    size(): number;
 }
 
 /**
@@ -8994,7 +9010,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrap(identity: OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
+    wrap(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
     /**
      * Synchronously returns a Layout object that represents a Window's layout.
      *
@@ -9014,7 +9030,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrapSync(identity: OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
+    wrapSync(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
     /**
      * Asynchronously returns a Layout object that represents a Window's layout.
      *
@@ -9190,11 +9206,12 @@ declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
 /**
- * Generated when a window and all of its layout's views have been created and can receive API calls.
+ * Generated when the layout and all of the its views have been created and can receive API calls.
  * @interface
  */
 declare type LayoutReadyEvent = BaseEvent_5 & {
     type: 'layout-ready';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     views: (OpenFin_2.Identity & {
         success: boolean;
     })[];
@@ -10132,6 +10149,7 @@ declare namespace OpenFin_2 {
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
+        DeviceInfo,
         Permissions_2 as Permissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
@@ -10289,7 +10307,6 @@ declare namespace OpenFin_2 {
         InitLayoutOptions,
         LayoutManagerConstructor,
         LayoutManagerOverride,
-        LayoutInstance,
         LayoutManager,
         CreateLayoutOptions,
         PresetLayoutOptions_2 as PresetLayoutOptions,
@@ -10481,6 +10498,7 @@ declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
     webAPIs?: WebPermission[];
+    devices?: DeviceInfo[];
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12821,7 +12839,7 @@ declare type ReplaceLayoutPayload = {
     /**
      * Identity of the window whose layout will be replaced.
      */
-    target: LayoutIdentity;
+    target: Identity_5 | LayoutIdentity;
 };
 
 /**
@@ -16411,7 +16429,7 @@ declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformVi
  */
 declare type ViewDetachedEvent = BaseEvent_5 & {
     type: 'view-detached';
-    target: OpenFin_2.Identity;
+    target: OpenFin_2.Identity | null;
     previousTarget: OpenFin_2.Identity;
     viewIdentity: OpenFin_2.Identity;
 };
@@ -17647,7 +17665,7 @@ declare namespace WebContentsEvents {
  * `clipboard-read`: Request access to read from the clipboard.<br>
  * `clipboard-sanitized-write`: Request access to write to the clipboard.
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | OpenExternalPermission;
+declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
 
 /**
  * Object representing headers and their values, where the

package/out/mock-public.d.ts

@@ -3636,7 +3636,7 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue true
      *
-     * Toggling off would keep the Window alive even if all its Views were closed.
+     * Setting this to false 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.
@@ -3646,7 +3646,8 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue 'all'
      *
-     * Determines which views prevent close if `closeOnLastViewRemoved` is set to true. Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
+     * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
+     +    * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
      * **NOTE:** - This option is ignored in non-Platforms apps.
      */
     viewsPreventingClose: 'all' | 'layout';
@@ -4453,7 +4454,7 @@ declare type CreateViewPayload = {
 /**
  * @interface
  */
-declare type CreateViewTarget = LayoutIdentity & {
+declare type CreateViewTarget = (Identity_5 | LayoutIdentity) & {
     /**
      * If specified, view creation will not attach to a window and caller must
      * insert the view into the layout explicitly
@@ -4593,6 +4594,14 @@ declare type DestroyedEvent = BaseEvent_4 & {
     type: 'destroyed';
 };
 
+/**
+ * @interface
+ */
+declare type DeviceInfo = {
+    vendorId: string | number;
+    productId: string | number;
+};
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -5053,9 +5062,10 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
-    initLayout(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
+    initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
     createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<void>;
     destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
+    resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
     initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
     observeBounds(element: Element, onChange: (bounds: DOMRect) => Promise<void> | void): () => void;
     writeToken(path: string, token: string): Promise<string>;
@@ -7433,7 +7443,7 @@ declare class InteropBroker extends Base {
      * // }
      * ```
      *
-     * 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.
@@ -8607,7 +8617,7 @@ declare type LaunchIntoPlatformPayload = {
 declare class Layout extends Base {
     #private;
     /* Excluded from this release type: init */
-    identity: OpenFin_2.LayoutIdentity;
+    identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     private platform;
     wire: Transport;
     /* Excluded from this release type: __constructor */
@@ -8823,25 +8833,23 @@ declare type LayoutEntityTypes = Exclude<GoldenLayout.ItemType, 'component' | 'r
  */
 declare type LayoutIdentity = Identity_5 & {
     /**
-     * The name of the layout an action should be targeted to. When not provided,
-     * OpenFin attempts to resolve the instance via visibility checks.
+     * The name of the layout in a given window.
      */
-    layoutName?: string;
+    layoutName: string;
 };
 
 /**
- * Generated when a window and all of its layout's views have either finished or failed navigation.
+ * Generated when the window and all of its layout's views have either finished or failed navigation, once per layout.
  * @interface
  */
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     ofViews: (OpenFin_2.Identity & {
         entityType: 'view';
     })[];
 };
 
-/* Excluded from this release type: LayoutInstance */
-
 /**
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
  * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
@@ -8869,7 +8877,7 @@ declare type LayoutItemConfig = {
  *
  * **NOTE**: Internal use only. This type is reserved for Workspace Browser implementation.
  *
- * Responsible for aggergating all layout snapshots and storing LayoutInstances
+ * Responsible for aggregating all layout snapshots and storing layout instances
  */
 declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
@@ -8893,16 +8901,6 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
      * @throws if Object.keys(snapshot).length > 1
      */
     applyLayoutSnapshot(snapshot: T): Promise<void>;
-    /**
-     * Called at the start of layout initialization. Adds a new LayoutInstance if the snapshot
-     * contains a single layout.
-     *
-     * Throws if the snapshot contains more than 1 layout, it is expected that the user handles calling
-     * fin.Platform.Layout.create() once for each layout to properly connect it to their UI state.
-     *
-     * @param snapshot
-     * @throws if Object.keys(snapshot).length > 1
-     */
     /**
      * @experimental
      *
@@ -8923,31 +8921,49 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      *
-     * @param layoutIdentity
-     * @returns
+     * A hook provided to the consumer for controlling how OpenFin routes Layout API calls. Override
+     * this method to control the target layout for Layout API calls.
+     *
+     * Example use case: You have hidden all the layouts and are showing a dialog that will
+     * execute an API call (ex: Layout.replace()) - override this method and save the
+     * "last visible" layout identity and return it.
+     *
+     * By default, OpenFin will use a series of checks to determine which Layout the API
+     * call must route to in this order of precedence:
+     * - try to resolve the layout from the layoutIdentity, throws if missing
+     * - if there is only 1 layout, resolves that one
+     * - enumerates all layouts checks visibility via element offsetTop/Left + window.innerHeight/Width
+     * - returns undefined
+     *
+     * @param identity
+     * @returns LayoutIdentity | undefined
      */
-    resolveLayout(layoutIdentity?: LayoutIdentity): Promise<LayoutInstance>;
+    resolveLayoutIdentity(identity?: Identity_5 | LayoutIdentity): LayoutIdentity | undefined;
     /**
      * @experimental
      *
-     * Returns a LayoutInstance if one exists with the name layoutIdentity.layoutName.
-     * Throws if it does not exist.
-     * @param layoutName
-     * @returns
+     * A hook provided to the consumer when it's time to remove a layout. Use this hook to
+     * update your local state and remove the layout for the given LayoutIdentity. Note that
+     * this hook does not call `fin.Platform.Layout.destroy()` for you, instead it is to
+     * signify to your application it's time to destroy this layout.
+     *
+     * Note that if the Window Option {@link WindowOptions.closeOnLastViewRemoved} is true, and the last View in this layout is closed, this hook will be called before the window closes.
+     *
+     * @param LayoutIdentity
      */
-    getLayoutByName(layoutName: string): LayoutInstance;
+    removeLayout({ layoutName }: LayoutIdentity): Promise<void>;
     /**
      * @experimental
      */
-    getLayouts(): Record<string, LayoutInstance>;
+    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
+    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
     /**
      * @experimental
      */
-    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
+    size(): number;
 }
 
 /**
@@ -8994,7 +9010,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrap(identity: OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
+    wrap(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
     /**
      * Synchronously returns a Layout object that represents a Window's layout.
      *
@@ -9014,7 +9030,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrapSync(identity: OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
+    wrapSync(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
     /**
      * Asynchronously returns a Layout object that represents a Window's layout.
      *
@@ -9190,11 +9206,12 @@ declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
 /**
- * Generated when a window and all of its layout's views have been created and can receive API calls.
+ * Generated when the layout and all of the its views have been created and can receive API calls.
  * @interface
  */
 declare type LayoutReadyEvent = BaseEvent_5 & {
     type: 'layout-ready';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     views: (OpenFin_2.Identity & {
         success: boolean;
     })[];
@@ -10132,6 +10149,7 @@ declare namespace OpenFin_2 {
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
+        DeviceInfo,
         Permissions_2 as Permissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
@@ -10289,7 +10307,6 @@ declare namespace OpenFin_2 {
         InitLayoutOptions,
         LayoutManagerConstructor,
         LayoutManagerOverride,
-        LayoutInstance,
         LayoutManager,
         CreateLayoutOptions,
         PresetLayoutOptions_2 as PresetLayoutOptions,
@@ -10481,6 +10498,7 @@ declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
     webAPIs?: WebPermission[];
+    devices?: DeviceInfo[];
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -12821,7 +12839,7 @@ declare type ReplaceLayoutPayload = {
     /**
      * Identity of the window whose layout will be replaced.
      */
-    target: LayoutIdentity;
+    target: Identity_5 | LayoutIdentity;
 };
 
 /**
@@ -16411,7 +16429,7 @@ declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformVi
  */
 declare type ViewDetachedEvent = BaseEvent_5 & {
     type: 'view-detached';
-    target: OpenFin_2.Identity;
+    target: OpenFin_2.Identity | null;
     previousTarget: OpenFin_2.Identity;
     viewIdentity: OpenFin_2.Identity;
 };
@@ -17647,7 +17665,7 @@ declare namespace WebContentsEvents {
  * `clipboard-read`: Request access to read from the clipboard.<br>
  * `clipboard-sanitized-write`: Request access to write to the clipboard.
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | OpenExternalPermission;
+declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
 
 /**
  * Object representing headers and their values, where the

package/out/mock.d.ts

@@ -3730,7 +3730,7 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue true
      *
-     * Toggling off would keep the Window alive even if all its Views were closed.
+     * Setting this to false 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.
@@ -3740,7 +3740,8 @@ declare type ConstWindowOptions = {
     /**
      * @defaultValue 'all'
      *
-     * Determines which views prevent close if `closeOnLastViewRemoved` is set to true. Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
+     * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
+     +    * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
      * **NOTE:** - This option is ignored in non-Platforms apps.
      */
     viewsPreventingClose: 'all' | 'layout';
@@ -4547,7 +4548,7 @@ declare type CreateViewPayload = {
 /**
  * @interface
  */
-declare type CreateViewTarget = LayoutIdentity & {
+declare type CreateViewTarget = (Identity_5 | LayoutIdentity) & {
     /**
      * If specified, view creation will not attach to a window and caller must
      * insert the view into the layout explicitly
@@ -4687,6 +4688,14 @@ declare type DestroyedEvent = BaseEvent_4 & {
     type: 'destroyed';
 };
 
+/**
+ * @interface
+ */
+declare type DeviceInfo = {
+    vendorId: string | number;
+    productId: string | number;
+};
+
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
  * @interface
@@ -5152,9 +5161,10 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 } : never;
 
 declare interface Environment {
-    initLayout(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
+    initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
     createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<void>;
     destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
+    resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
     initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
     observeBounds(element: Element, onChange: (bounds: DOMRect) => Promise<void> | void): () => void;
     writeToken(path: string, token: string): Promise<string>;
@@ -7577,7 +7587,7 @@ declare class InteropBroker extends Base {
      * // }
      * ```
      *
-     * 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.
@@ -8757,7 +8767,7 @@ declare class Layout extends Base {
      * @internal
      */
     init: (options?: OpenFin_2.InitLayoutOptions) => Promise<Layout>;
-    identity: OpenFin_2.LayoutIdentity;
+    identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     private platform;
     wire: Transport;
     /**
@@ -8976,45 +8986,23 @@ declare type LayoutEntityTypes = Exclude<GoldenLayout.ItemType, 'component' | 'r
  */
 declare type LayoutIdentity = Identity_5 & {
     /**
-     * The name of the layout an action should be targeted to. When not provided,
-     * OpenFin attempts to resolve the instance via visibility checks.
+     * The name of the layout in a given window.
      */
-    layoutName?: string;
+    layoutName: string;
 };
 
 /**
- * Generated when a window and all of its layout's views have either finished or failed navigation.
+ * Generated when the window and all of its layout's views have either finished or failed navigation, once per layout.
  * @interface
  */
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     ofViews: (OpenFin_2.Identity & {
         entityType: 'view';
     })[];
 };
 
-/**
- * @interface @experimental @internal
- *
- * **NOTE**: Internal use only. This type is reserved for Workspace Browser implementation.
- *
- * Responsible for handling all layout management and renderering
- */
-declare type LayoutInstance = {
-    identity: LayoutIdentity;
-    getFrameSnapshot: () => Promise<LayoutOptions>;
-    addView: (payload: AddViewOptions) => Promise<View_2>;
-    closeView: (viewIdentity: Identity_5) => Promise<void>;
-    removeView: (viewConfig: Identity_5 | ViewState) => Promise<View_2>;
-    replaceView: (payload: ReplaceViewOptions) => Promise<View_2>;
-    getViews: () => LayoutComponent[];
-    getCurrentViews: () => Identity_5[];
-    startReplaceLayout: (payload: ReplaceLayoutOptions) => Promise<void>;
-    applyPreset: (payload: PresetLayoutOptions_2) => void;
-    isVisible: () => boolean;
-    destroy: () => Promise<void>;
-};
-
 /**
  * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
  * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot}.
@@ -9042,7 +9030,7 @@ declare type LayoutItemConfig = {
  *
  * **NOTE**: Internal use only. This type is reserved for Workspace Browser implementation.
  *
- * Responsible for aggergating all layout snapshots and storing LayoutInstances
+ * Responsible for aggregating all layout snapshots and storing layout instances
  */
 declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
@@ -9066,16 +9054,6 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
      * @throws if Object.keys(snapshot).length > 1
      */
     applyLayoutSnapshot(snapshot: T): Promise<void>;
-    /**
-     * Called at the start of layout initialization. Adds a new LayoutInstance if the snapshot
-     * contains a single layout.
-     *
-     * Throws if the snapshot contains more than 1 layout, it is expected that the user handles calling
-     * fin.Platform.Layout.create() once for each layout to properly connect it to their UI state.
-     *
-     * @param snapshot
-     * @throws if Object.keys(snapshot).length > 1
-     */
     /**
      * @experimental
      *
@@ -9096,31 +9074,49 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      *
-     * @param layoutIdentity
-     * @returns
+     * A hook provided to the consumer for controlling how OpenFin routes Layout API calls. Override
+     * this method to control the target layout for Layout API calls.
+     *
+     * Example use case: You have hidden all the layouts and are showing a dialog that will
+     * execute an API call (ex: Layout.replace()) - override this method and save the
+     * "last visible" layout identity and return it.
+     *
+     * By default, OpenFin will use a series of checks to determine which Layout the API
+     * call must route to in this order of precedence:
+     * - try to resolve the layout from the layoutIdentity, throws if missing
+     * - if there is only 1 layout, resolves that one
+     * - enumerates all layouts checks visibility via element offsetTop/Left + window.innerHeight/Width
+     * - returns undefined
+     *
+     * @param identity
+     * @returns LayoutIdentity | undefined
      */
-    resolveLayout(layoutIdentity?: LayoutIdentity): Promise<LayoutInstance>;
+    resolveLayoutIdentity(identity?: Identity_5 | LayoutIdentity): LayoutIdentity | undefined;
     /**
      * @experimental
      *
-     * Returns a LayoutInstance if one exists with the name layoutIdentity.layoutName.
-     * Throws if it does not exist.
-     * @param layoutName
-     * @returns
+     * A hook provided to the consumer when it's time to remove a layout. Use this hook to
+     * update your local state and remove the layout for the given LayoutIdentity. Note that
+     * this hook does not call `fin.Platform.Layout.destroy()` for you, instead it is to
+     * signify to your application it's time to destroy this layout.
+     *
+     * Note that if the Window Option {@link WindowOptions.closeOnLastViewRemoved} is true, and the last View in this layout is closed, this hook will be called before the window closes.
+     *
+     * @param LayoutIdentity
      */
-    getLayoutByName(layoutName: string): LayoutInstance;
+    removeLayout({ layoutName }: LayoutIdentity): Promise<void>;
     /**
      * @experimental
      */
-    getLayouts(): Record<string, LayoutInstance>;
+    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_5): LayoutIdentity;
+    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
     /**
      * @experimental
      */
-    isLayoutVisible({ layoutName }: LayoutIdentity): boolean;
+    size(): number;
 }
 
 /**
@@ -9167,7 +9163,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrap(identity: OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
+    wrap(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): Promise<OpenFin_2.Layout>;
     /**
      * Synchronously returns a Layout object that represents a Window's layout.
      *
@@ -9187,7 +9183,7 @@ declare class LayoutModule extends Base {
      * const layoutConfig = await layout.getConfig();
      * ```
      */
-    wrapSync(identity: OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
+    wrapSync(identity: OpenFin_2.Identity | OpenFin_2.LayoutIdentity): OpenFin_2.Layout;
     /**
      * Asynchronously returns a Layout object that represents a Window's layout.
      *
@@ -9520,11 +9516,12 @@ declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
 declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 
 /**
- * Generated when a window and all of its layout's views have been created and can receive API calls.
+ * Generated when the layout and all of the its views have been created and can receive API calls.
  * @interface
  */
 declare type LayoutReadyEvent = BaseEvent_5 & {
     type: 'layout-ready';
+    layoutIdentity: OpenFin_2.LayoutIdentity;
     views: (OpenFin_2.Identity & {
         success: boolean;
     })[];
@@ -10480,6 +10477,7 @@ declare namespace OpenFin_2 {
         WebPermission,
         VerboseWebPermission,
         OpenExternalPermission,
+        DeviceInfo,
         Permissions_2 as Permissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
@@ -10637,7 +10635,6 @@ declare namespace OpenFin_2 {
         InitLayoutOptions,
         LayoutManagerConstructor,
         LayoutManagerOverride,
-        LayoutInstance,
         LayoutManager,
         CreateLayoutOptions,
         PresetLayoutOptions_2 as PresetLayoutOptions,
@@ -10829,6 +10826,7 @@ declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
     webAPIs?: WebPermission[];
+    devices?: DeviceInfo[];
 };
 
 declare type PermissionState_2 = 'granted' | 'denied' | 'unavailable';
@@ -13262,7 +13260,7 @@ declare type ReplaceLayoutPayload = {
     /**
      * Identity of the window whose layout will be replaced.
      */
-    target: LayoutIdentity;
+    target: Identity_5 | LayoutIdentity;
 };
 
 /**
@@ -16952,7 +16950,7 @@ declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformVi
  */
 declare type ViewDetachedEvent = BaseEvent_5 & {
     type: 'view-detached';
-    target: OpenFin_2.Identity;
+    target: OpenFin_2.Identity | null;
     previousTarget: OpenFin_2.Identity;
     viewIdentity: OpenFin_2.Identity;
 };
@@ -18188,7 +18186,7 @@ declare namespace WebContentsEvents {
  * `clipboard-read`: Request access to read from the clipboard.<br>
  * `clipboard-sanitized-write`: Request access to write to the clipboard.
  */
-declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | OpenExternalPermission;
+declare type WebPermission = 'audio' | 'video' | 'geolocation' | 'notifications' | 'midiSysex' | 'pointerLock' | 'fullscreen' | 'openExternal' | 'clipboard-read' | 'clipboard-sanitized-write' | 'hid' | 'usb' | OpenExternalPermission;
 
 /**
  * Object representing headers and their values, where the

package/out/mock.js

@@ -3463,7 +3463,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
@@ -4604,7 +4604,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
@@ -6661,7 +6661,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.
@@ -11415,7 +11415,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
@@ -11666,7 +11666,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.
@@ -13012,7 +13012,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
         });
@@ -13062,7 +13061,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);
     }
 }
@@ -13080,7 +13079,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_getBackCompatLayoutManager, _LayoutModule_throwIfLayoutManagerNotInitialized;
 Object.defineProperty(Factory$2, "__esModule", { value: true });
 Factory$2.LayoutModule = void 0;
 const base_1$5 = base;
@@ -13143,39 +13142,53 @@ 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");
+            // 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 (!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 });
+                return __classPrivateFieldGet$4(this, _LayoutModule_getBackCompatLayoutManager, "f").call(this, this.fin);
             }
-            // 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);
         };
+        _LayoutModule_getBackCompatLayoutManager.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 }) => {
+                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);
+            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this, `fin.Platform.Layout.getCurrentLayoutManagerSync()`);
             // @ts-expect-error User may have implemented their own snapshot type when overriding LayoutManager
             return __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f");
         };
         this.create = async (options) => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this);
+            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this, `fin.Platform.Layout.create()`);
             return this.wire.environment.createLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), options);
         };
         this.destroy = async (layoutIdentity) => {
-            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this);
+            __classPrivateFieldGet$4(this, _LayoutModule_instances, "m", _LayoutModule_throwIfLayoutManagerNotInitialized).call(this, `fin.Platform.Layout.destroy()`);
             return this.wire.environment.destroyLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
         };
     }
@@ -13274,9 +13287,9 @@ 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_getBackCompatLayoutManager = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_throwIfLayoutManagerNotInitialized = function _LayoutModule_throwIfLayoutManagerNotInitialized(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}`);
     }
 };
 
@@ -13287,7 +13300,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
@@ -13568,7 +13581,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
@@ -14975,7 +14988,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.
@@ -16778,7 +16791,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
@@ -17212,7 +17225,7 @@ class MockEnvironment {
     getRtcPeer() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }
-    initLayout() {
+    initLayoutManager() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }
     async createLayout() {
@@ -17221,6 +17234,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);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "34.78.53",
+    "version": "34.78.56",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.MD",
     "main": "out/mock.js",