@openfin/fdc3-api 40.82.19 → 40.82.21

package/out/fdc3-api-alpha.d.ts

@@ -3654,11 +3654,6 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
-    /**
-     * Specify a taskbar group for the window.
-     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
-     */
-    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -4696,6 +4691,7 @@ declare interface Environment {
     getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
         fdc3Version?: Version;
     }>;
+    getViewWindowIdentity(fin: OpenFin.Fin<OpenFin.EntityType>, identity: OpenFin.Identity): Promise<OpenFin.Identity>;
     readonly type: EnvironmentType;
 }
 
@@ -7863,6 +7859,7 @@ declare type LaunchIntoPlatformPayload = {
  */
 declare class Layout extends Base {
     #private;
+    /* Excluded from this release type: getClient */
     /* Excluded from this release type: init */
     identity: OpenFin.Identity | OpenFin.LayoutIdentity;
     private platform;
@@ -7962,6 +7959,16 @@ declare class Layout extends Base {
      * ```
      */
     getRootItem(): Promise<OpenFin.ColumnOrRow | OpenFin.TabStack>;
+    /**
+     * Retrieves the OpenFin.TabStack instance which the View belongs to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const stack = await fin.View.wrapSync(viewIdentity).getStackByViewIdentity(viewIdentity);
+     * console.log(await stack.getViews());
+     * ```
+     */
     getStackByViewIdentity(identity: OpenFin.Identity): Promise<OpenFin.TabStack>;
     /**
      * Replaces the specified view with a view with the provided configuration.
@@ -8120,10 +8127,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin.ViewCreationResult[];
 };
 
 /**
@@ -8332,6 +8336,17 @@ declare class LayoutModule extends Base {
      * ```
      */
     getCurrentSync(): OpenFin.Layout;
+    /**
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const layout = await fin.Platform.Layout.getLayoutByViewIdentity(viewIdentity);
+     * console.log(await layout.getCurrentViews());
+     * ```
+     */
+    getLayoutByViewIdentity(viewIdentity: OpenFin.Identity): Promise<OpenFin.Layout>;
     /**
      * Initialize the window's Layout.
      *
@@ -9211,6 +9226,12 @@ declare type MutableWindowOptions = {
      * Shows the window's icon in the taskbar.
      */
     showTaskbarIcon: boolean;
+    /**
+     * Specify a taskbar group for the window.
+     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * @remarks It's only updatable when `enableJumpList` is set to false.
+     */
+    taskbarIconGroup: string;
     interop: InteropConfig;
     /* Excluded from this release type: _internalWorkspaceData */
     /* Excluded from this release type: workspacePlatform */
@@ -9467,6 +9488,9 @@ declare namespace OpenFin {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -11268,6 +11292,45 @@ declare interface PlatformProvider {
      * @returns {Promise<void>}
      */
     handleRunRequested({ manifest, userAppConfigArgs }: RunRequestedEvent): Promise<void>;
+    /**
+     * @experimental
+     *
+     * This method is called to handle errors with view creation and initial navigation during layout creation.
+     * Overriding this method enables catching the error and correcting behavior (ie navigating to an error page).
+     * * To indicate that the error has been handled, view creation should be treated as successful return {identity: viewIdentity, success: true}.
+     * * Not returning anything will cause the layout-initialized event to include the view as failed with the original error.
+     * * Throwing an error will update the error on the event payload of layout-initialized to the thrown error.
+     *
+     * @param viewIdentity Identity of the view
+     * @param error error thrown during a view creation
+     * @returns {Promise<OpenFin.ViewCreationSuccess | void>}
+     *
+     * @example
+     *
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         async handleFailedViewCreation(viewIdentity, error) {
+     *              const view = fin.View.wrapSync(viewId);
+     *              try {
+     *                  // navigate to an error page
+     *                  await view.navigate('http://localhost:3000/errorPage.html');
+     *                  // resolve a success result after redirecting to a error page
+     *                  return {identity: viewIdentity, success: true};
+     *              } catch(e) {
+     *                  // layout-initialized event will include this view with the error
+     *                  throw error;
+     *              }
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     *
+     * ```
+     */
+    handleFailedViewCreation(viewIdentity: OpenFin.Identity, error: Error): Promise<OpenFin.ViewCreationSuccess | void>;
 }
 
 /**
@@ -15866,7 +15929,7 @@ declare class View_2 extends WebContents<OpenFin.ViewEvent> {
      */
     getInfo: () => Promise<OpenFin.ViewInfo>;
     /**
-     * Retrieves the layout for the window the view is attached to.
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
      *
      * @example
      * ```js
@@ -16030,6 +16093,24 @@ declare type ViewContentCreationRule = BaseContentCreationRule & {
     options?: Partial<ViewOptions>;
 };
 
+/**
+ * @interface
+ */
+declare type ViewCreationFailure = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created with errors
+     */
+    success: false;
+    /**
+     * Error thrown during view creation
+     */
+    error: Error;
+};
+
 /**
  * The options object required by {@link View.ViewModule.create View.create}.
  *
@@ -16045,6 +16126,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCreationOptions;
 
+/**
+ * A view creation state
+ */
+declare type ViewCreationResult = ViewCreationSuccess | ViewCreationFailure;
+
+/**
+ * @interface
+ */
+declare type ViewCreationSuccess = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created without errors
+     */
+    success: true;
+};
+
 /**
  * Generated when a window has a view detached from it.
  * @remarks Will fire when a view is destroyed in which case `target` will be null.

package/out/fdc3-api-beta.d.ts

@@ -3654,11 +3654,6 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
-    /**
-     * Specify a taskbar group for the window.
-     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
-     */
-    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -4696,6 +4691,7 @@ declare interface Environment {
     getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
         fdc3Version?: Version;
     }>;
+    getViewWindowIdentity(fin: OpenFin.Fin<OpenFin.EntityType>, identity: OpenFin.Identity): Promise<OpenFin.Identity>;
     readonly type: EnvironmentType;
 }
 
@@ -7863,6 +7859,7 @@ declare type LaunchIntoPlatformPayload = {
  */
 declare class Layout extends Base {
     #private;
+    /* Excluded from this release type: getClient */
     /* Excluded from this release type: init */
     identity: OpenFin.Identity | OpenFin.LayoutIdentity;
     private platform;
@@ -7962,6 +7959,16 @@ declare class Layout extends Base {
      * ```
      */
     getRootItem(): Promise<OpenFin.ColumnOrRow | OpenFin.TabStack>;
+    /**
+     * Retrieves the OpenFin.TabStack instance which the View belongs to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const stack = await fin.View.wrapSync(viewIdentity).getStackByViewIdentity(viewIdentity);
+     * console.log(await stack.getViews());
+     * ```
+     */
     getStackByViewIdentity(identity: OpenFin.Identity): Promise<OpenFin.TabStack>;
     /**
      * Replaces the specified view with a view with the provided configuration.
@@ -8120,10 +8127,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin.ViewCreationResult[];
 };
 
 /**
@@ -8332,6 +8336,17 @@ declare class LayoutModule extends Base {
      * ```
      */
     getCurrentSync(): OpenFin.Layout;
+    /**
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const layout = await fin.Platform.Layout.getLayoutByViewIdentity(viewIdentity);
+     * console.log(await layout.getCurrentViews());
+     * ```
+     */
+    getLayoutByViewIdentity(viewIdentity: OpenFin.Identity): Promise<OpenFin.Layout>;
     /**
      * Initialize the window's Layout.
      *
@@ -9211,6 +9226,12 @@ declare type MutableWindowOptions = {
      * Shows the window's icon in the taskbar.
      */
     showTaskbarIcon: boolean;
+    /**
+     * Specify a taskbar group for the window.
+     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * @remarks It's only updatable when `enableJumpList` is set to false.
+     */
+    taskbarIconGroup: string;
     interop: InteropConfig;
     /* Excluded from this release type: _internalWorkspaceData */
     /* Excluded from this release type: workspacePlatform */
@@ -9467,6 +9488,9 @@ declare namespace OpenFin {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -11268,6 +11292,45 @@ declare interface PlatformProvider {
      * @returns {Promise<void>}
      */
     handleRunRequested({ manifest, userAppConfigArgs }: RunRequestedEvent): Promise<void>;
+    /**
+     * @experimental
+     *
+     * This method is called to handle errors with view creation and initial navigation during layout creation.
+     * Overriding this method enables catching the error and correcting behavior (ie navigating to an error page).
+     * * To indicate that the error has been handled, view creation should be treated as successful return {identity: viewIdentity, success: true}.
+     * * Not returning anything will cause the layout-initialized event to include the view as failed with the original error.
+     * * Throwing an error will update the error on the event payload of layout-initialized to the thrown error.
+     *
+     * @param viewIdentity Identity of the view
+     * @param error error thrown during a view creation
+     * @returns {Promise<OpenFin.ViewCreationSuccess | void>}
+     *
+     * @example
+     *
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         async handleFailedViewCreation(viewIdentity, error) {
+     *              const view = fin.View.wrapSync(viewId);
+     *              try {
+     *                  // navigate to an error page
+     *                  await view.navigate('http://localhost:3000/errorPage.html');
+     *                  // resolve a success result after redirecting to a error page
+     *                  return {identity: viewIdentity, success: true};
+     *              } catch(e) {
+     *                  // layout-initialized event will include this view with the error
+     *                  throw error;
+     *              }
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     *
+     * ```
+     */
+    handleFailedViewCreation(viewIdentity: OpenFin.Identity, error: Error): Promise<OpenFin.ViewCreationSuccess | void>;
 }
 
 /**
@@ -15866,7 +15929,7 @@ declare class View_2 extends WebContents<OpenFin.ViewEvent> {
      */
     getInfo: () => Promise<OpenFin.ViewInfo>;
     /**
-     * Retrieves the layout for the window the view is attached to.
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
      *
      * @example
      * ```js
@@ -16030,6 +16093,24 @@ declare type ViewContentCreationRule = BaseContentCreationRule & {
     options?: Partial<ViewOptions>;
 };
 
+/**
+ * @interface
+ */
+declare type ViewCreationFailure = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created with errors
+     */
+    success: false;
+    /**
+     * Error thrown during view creation
+     */
+    error: Error;
+};
+
 /**
  * The options object required by {@link View.ViewModule.create View.create}.
  *
@@ -16045,6 +16126,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCreationOptions;
 
+/**
+ * A view creation state
+ */
+declare type ViewCreationResult = ViewCreationSuccess | ViewCreationFailure;
+
+/**
+ * @interface
+ */
+declare type ViewCreationSuccess = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created without errors
+     */
+    success: true;
+};
+
 /**
  * Generated when a window has a view detached from it.
  * @remarks Will fire when a view is destroyed in which case `target` will be null.

package/out/fdc3-api-public.d.ts

@@ -3654,11 +3654,6 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
-    /**
-     * Specify a taskbar group for the window.
-     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
-     */
-    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -4696,6 +4691,7 @@ declare interface Environment {
     getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
         fdc3Version?: Version;
     }>;
+    getViewWindowIdentity(fin: OpenFin.Fin<OpenFin.EntityType>, identity: OpenFin.Identity): Promise<OpenFin.Identity>;
     readonly type: EnvironmentType;
 }
 
@@ -7863,6 +7859,7 @@ declare type LaunchIntoPlatformPayload = {
  */
 declare class Layout extends Base {
     #private;
+    /* Excluded from this release type: getClient */
     /* Excluded from this release type: init */
     identity: OpenFin.Identity | OpenFin.LayoutIdentity;
     private platform;
@@ -7962,6 +7959,16 @@ declare class Layout extends Base {
      * ```
      */
     getRootItem(): Promise<OpenFin.ColumnOrRow | OpenFin.TabStack>;
+    /**
+     * Retrieves the OpenFin.TabStack instance which the View belongs to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const stack = await fin.View.wrapSync(viewIdentity).getStackByViewIdentity(viewIdentity);
+     * console.log(await stack.getViews());
+     * ```
+     */
     getStackByViewIdentity(identity: OpenFin.Identity): Promise<OpenFin.TabStack>;
     /**
      * Replaces the specified view with a view with the provided configuration.
@@ -8120,10 +8127,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin.ViewCreationResult[];
 };
 
 /**
@@ -8332,6 +8336,17 @@ declare class LayoutModule extends Base {
      * ```
      */
     getCurrentSync(): OpenFin.Layout;
+    /**
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const layout = await fin.Platform.Layout.getLayoutByViewIdentity(viewIdentity);
+     * console.log(await layout.getCurrentViews());
+     * ```
+     */
+    getLayoutByViewIdentity(viewIdentity: OpenFin.Identity): Promise<OpenFin.Layout>;
     /**
      * Initialize the window's Layout.
      *
@@ -9211,6 +9226,12 @@ declare type MutableWindowOptions = {
      * Shows the window's icon in the taskbar.
      */
     showTaskbarIcon: boolean;
+    /**
+     * Specify a taskbar group for the window.
+     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * @remarks It's only updatable when `enableJumpList` is set to false.
+     */
+    taskbarIconGroup: string;
     interop: InteropConfig;
     /* Excluded from this release type: _internalWorkspaceData */
     /* Excluded from this release type: workspacePlatform */
@@ -9467,6 +9488,9 @@ declare namespace OpenFin {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -11268,6 +11292,45 @@ declare interface PlatformProvider {
      * @returns {Promise<void>}
      */
     handleRunRequested({ manifest, userAppConfigArgs }: RunRequestedEvent): Promise<void>;
+    /**
+     * @experimental
+     *
+     * This method is called to handle errors with view creation and initial navigation during layout creation.
+     * Overriding this method enables catching the error and correcting behavior (ie navigating to an error page).
+     * * To indicate that the error has been handled, view creation should be treated as successful return {identity: viewIdentity, success: true}.
+     * * Not returning anything will cause the layout-initialized event to include the view as failed with the original error.
+     * * Throwing an error will update the error on the event payload of layout-initialized to the thrown error.
+     *
+     * @param viewIdentity Identity of the view
+     * @param error error thrown during a view creation
+     * @returns {Promise<OpenFin.ViewCreationSuccess | void>}
+     *
+     * @example
+     *
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         async handleFailedViewCreation(viewIdentity, error) {
+     *              const view = fin.View.wrapSync(viewId);
+     *              try {
+     *                  // navigate to an error page
+     *                  await view.navigate('http://localhost:3000/errorPage.html');
+     *                  // resolve a success result after redirecting to a error page
+     *                  return {identity: viewIdentity, success: true};
+     *              } catch(e) {
+     *                  // layout-initialized event will include this view with the error
+     *                  throw error;
+     *              }
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     *
+     * ```
+     */
+    handleFailedViewCreation(viewIdentity: OpenFin.Identity, error: Error): Promise<OpenFin.ViewCreationSuccess | void>;
 }
 
 /**
@@ -15866,7 +15929,7 @@ declare class View_2 extends WebContents<OpenFin.ViewEvent> {
      */
     getInfo: () => Promise<OpenFin.ViewInfo>;
     /**
-     * Retrieves the layout for the window the view is attached to.
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
      *
      * @example
      * ```js
@@ -16030,6 +16093,24 @@ declare type ViewContentCreationRule = BaseContentCreationRule & {
     options?: Partial<ViewOptions>;
 };
 
+/**
+ * @interface
+ */
+declare type ViewCreationFailure = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created with errors
+     */
+    success: false;
+    /**
+     * Error thrown during view creation
+     */
+    error: Error;
+};
+
 /**
  * The options object required by {@link View.ViewModule.create View.create}.
  *
@@ -16045,6 +16126,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCreationOptions;
 
+/**
+ * A view creation state
+ */
+declare type ViewCreationResult = ViewCreationSuccess | ViewCreationFailure;
+
+/**
+ * @interface
+ */
+declare type ViewCreationSuccess = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created without errors
+     */
+    success: true;
+};
+
 /**
  * Generated when a window has a view detached from it.
  * @remarks Will fire when a view is destroyed in which case `target` will be null.

package/out/fdc3-api.d.ts

@@ -3713,11 +3713,6 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
-    /**
-     * Specify a taskbar group for the window.
-     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
-     */
-    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -4760,6 +4755,7 @@ declare interface Environment {
     getInteropInfo(fin: OpenFin.Fin<OpenFin.EntityType>): Promise<InternalInteropBrokerOptions & {
         fdc3Version?: Version;
     }>;
+    getViewWindowIdentity(fin: OpenFin.Fin<OpenFin.EntityType>, identity: OpenFin.Identity): Promise<OpenFin.Identity>;
     readonly type: EnvironmentType;
 }
 
@@ -7980,6 +7976,10 @@ declare type LaunchIntoPlatformPayload = {
  */
 declare class Layout extends Base {
     #private;
+    /**
+     * @internal
+     */
+    static getClient(layout: Layout): Promise<LayoutEntitiesClient>;
     /**
      * @internal
      */
@@ -8085,6 +8085,16 @@ declare class Layout extends Base {
      * ```
      */
     getRootItem(): Promise<OpenFin.ColumnOrRow | OpenFin.TabStack>;
+    /**
+     * Retrieves the OpenFin.TabStack instance which the View belongs to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const stack = await fin.View.wrapSync(viewIdentity).getStackByViewIdentity(viewIdentity);
+     * console.log(await stack.getViews());
+     * ```
+     */
     getStackByViewIdentity(identity: OpenFin.Identity): Promise<OpenFin.TabStack>;
     /**
      * Replaces the specified view with a view with the provided configuration.
@@ -8243,10 +8253,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin.ViewCreationResult[];
 };
 
 /**
@@ -8455,6 +8462,17 @@ declare class LayoutModule extends Base {
      * ```
      */
     getCurrentSync(): OpenFin.Layout;
+    /**
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
+     *
+     * @example
+     * ```js
+     * const viewIdentity = { uuid: 'uuid', name: 'view-name' };
+     * const layout = await fin.Platform.Layout.getLayoutByViewIdentity(viewIdentity);
+     * console.log(await layout.getCurrentViews());
+     * ```
+     */
+    getLayoutByViewIdentity(viewIdentity: OpenFin.Identity): Promise<OpenFin.Layout>;
     /**
      * Initialize the window's Layout.
      *
@@ -9508,6 +9526,12 @@ declare type MutableWindowOptions = {
      * Shows the window's icon in the taskbar.
      */
     showTaskbarIcon: boolean;
+    /**
+     * Specify a taskbar group for the window.
+     * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * @remarks It's only updatable when `enableJumpList` is set to false.
+     */
+    taskbarIconGroup: string;
     interop: InteropConfig;
     /**
      * @internal
@@ -9782,6 +9806,9 @@ declare namespace OpenFin {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -11666,6 +11693,45 @@ declare interface PlatformProvider {
      * @returns {Promise<void>}
      */
     handleRunRequested({ manifest, userAppConfigArgs }: RunRequestedEvent): Promise<void>;
+    /**
+     * @experimental
+     *
+     * This method is called to handle errors with view creation and initial navigation during layout creation.
+     * Overriding this method enables catching the error and correcting behavior (ie navigating to an error page).
+     * * To indicate that the error has been handled, view creation should be treated as successful return {identity: viewIdentity, success: true}.
+     * * Not returning anything will cause the layout-initialized event to include the view as failed with the original error.
+     * * Throwing an error will update the error on the event payload of layout-initialized to the thrown error.
+     *
+     * @param viewIdentity Identity of the view
+     * @param error error thrown during a view creation
+     * @returns {Promise<OpenFin.ViewCreationSuccess | void>}
+     *
+     * @example
+     *
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         async handleFailedViewCreation(viewIdentity, error) {
+     *              const view = fin.View.wrapSync(viewId);
+     *              try {
+     *                  // navigate to an error page
+     *                  await view.navigate('http://localhost:3000/errorPage.html');
+     *                  // resolve a success result after redirecting to a error page
+     *                  return {identity: viewIdentity, success: true};
+     *              } catch(e) {
+     *                  // layout-initialized event will include this view with the error
+     *                  throw error;
+     *              }
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     *
+     * ```
+     */
+    handleFailedViewCreation(viewIdentity: OpenFin.Identity, error: Error): Promise<OpenFin.ViewCreationSuccess | void>;
 }
 
 /**
@@ -16280,7 +16346,7 @@ declare class View_2 extends WebContents<OpenFin.ViewEvent> {
      */
     getInfo: () => Promise<OpenFin.ViewInfo>;
     /**
-     * Retrieves the layout for the window the view is attached to.
+     * Retrieves the OpenFin.Layout instance for the Window the View is attached to.
      *
      * @example
      * ```js
@@ -16478,6 +16544,24 @@ declare type ViewContentCreationRule = BaseContentCreationRule & {
     options?: Partial<ViewOptions>;
 };
 
+/**
+ * @interface
+ */
+declare type ViewCreationFailure = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created with errors
+     */
+    success: false;
+    /**
+     * Error thrown during view creation
+     */
+    error: Error;
+};
+
 /**
  * The options object required by {@link View.ViewModule.create View.create}.
  *
@@ -16493,6 +16577,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCreationOptions;
 
+/**
+ * A view creation state
+ */
+declare type ViewCreationResult = ViewCreationSuccess | ViewCreationFailure;
+
+/**
+ * @interface
+ */
+declare type ViewCreationSuccess = {
+    /**
+     * The identity of the created view
+     */
+    identity: Identity_4;
+    /**
+     * Whether the view was created without errors
+     */
+    success: true;
+};
+
 /**
  * Generated when a window has a view detached from it.
  * @remarks Will fire when a view is destroyed in which case `target` will be null.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "40.82.19",
+    "version": "40.82.21",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,