@openfin/core 40.82.20 → 40.82.22

package/out/mock-alpha.d.ts

@@ -3657,11 +3657,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"
      *
@@ -7686,6 +7681,29 @@ declare class Layout extends Base {
      * ```
      */
     applyPreset: (options: PresetLayoutOptions) => Promise<void>;
+    /**
+     * Adds a view to the platform layout. Behaves like @link{Platform#createView} with the current layout as the target.
+     *
+     * @param viewOptions - The options for creating the view.
+     * @param options - Optional parameters for adding the view.
+     * @param options.location - The location where the view should be added.
+     * @param options.targetView - The target view to which the new view should be added.
+     * @returns A promise that resolves to an object containing the identity of the added view.
+     */
+    addView(viewOptions: OpenFin_2.PlatformViewCreationOptions, { location, targetView }?: {
+        location?: OpenFin_2.CreateViewTarget['location'];
+        targetView?: OpenFin_2.Identity;
+    }): Promise<{
+        identity: OpenFin_2.Identity;
+    }>;
+    /**
+     * Closes a view by its identity. Throws an error if the view does not belong to the current layout.
+     * Behaves like @link{Platform#closeView} but only closes the view if it belongs the current layout.
+     *
+     * @param viewIdentity - The identity of the view to close.
+     * @returns A promise that resolves when the view is closed.
+     */
+    closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
 }
 
 /**
@@ -7698,7 +7716,7 @@ declare type LayoutColumn = LayoutItemConfig & {
 /**
  * @interface
  */
-declare type LayoutComponent = LayoutItemConfig & {
+declare type LayoutComponent = Omit<LayoutItemConfig, 'content' | 'type'> & {
     /**
      * Only a component type will have this property and it should be set to view.
      */
@@ -7707,6 +7725,7 @@ declare type LayoutComponent = LayoutItemConfig & {
      * Only a component type will have this property and it represents the view options of a given component.
      */
     componentState?: Partial<ViewCreationOptions>;
+    type: 'component';
 };
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
@@ -7790,10 +7809,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin_2.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin_2.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin_2.ViewCreationResult[];
 };
 
 /**
@@ -7901,7 +7917,7 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity;
+    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity | undefined;
     /**
      * @experimental
      */
@@ -8892,6 +8908,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 */
@@ -9148,6 +9170,9 @@ declare namespace OpenFin_2 {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -10951,6 +10976,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_2.Identity, error: Error): Promise<OpenFin_2.ViewCreationSuccess | void>;
 }
 
 /**
@@ -15607,6 +15671,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}.
  *
@@ -15622,6 +15704,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.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/mock-beta.d.ts

@@ -3657,11 +3657,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"
      *
@@ -7686,6 +7681,29 @@ declare class Layout extends Base {
      * ```
      */
     applyPreset: (options: PresetLayoutOptions) => Promise<void>;
+    /**
+     * Adds a view to the platform layout. Behaves like @link{Platform#createView} with the current layout as the target.
+     *
+     * @param viewOptions - The options for creating the view.
+     * @param options - Optional parameters for adding the view.
+     * @param options.location - The location where the view should be added.
+     * @param options.targetView - The target view to which the new view should be added.
+     * @returns A promise that resolves to an object containing the identity of the added view.
+     */
+    addView(viewOptions: OpenFin_2.PlatformViewCreationOptions, { location, targetView }?: {
+        location?: OpenFin_2.CreateViewTarget['location'];
+        targetView?: OpenFin_2.Identity;
+    }): Promise<{
+        identity: OpenFin_2.Identity;
+    }>;
+    /**
+     * Closes a view by its identity. Throws an error if the view does not belong to the current layout.
+     * Behaves like @link{Platform#closeView} but only closes the view if it belongs the current layout.
+     *
+     * @param viewIdentity - The identity of the view to close.
+     * @returns A promise that resolves when the view is closed.
+     */
+    closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
 }
 
 /**
@@ -7698,7 +7716,7 @@ declare type LayoutColumn = LayoutItemConfig & {
 /**
  * @interface
  */
-declare type LayoutComponent = LayoutItemConfig & {
+declare type LayoutComponent = Omit<LayoutItemConfig, 'content' | 'type'> & {
     /**
      * Only a component type will have this property and it should be set to view.
      */
@@ -7707,6 +7725,7 @@ declare type LayoutComponent = LayoutItemConfig & {
      * Only a component type will have this property and it represents the view options of a given component.
      */
     componentState?: Partial<ViewCreationOptions>;
+    type: 'component';
 };
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
@@ -7790,10 +7809,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin_2.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin_2.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin_2.ViewCreationResult[];
 };
 
 /**
@@ -7901,7 +7917,7 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity;
+    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity | undefined;
     /**
      * @experimental
      */
@@ -8892,6 +8908,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 */
@@ -9148,6 +9170,9 @@ declare namespace OpenFin_2 {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -10951,6 +10976,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_2.Identity, error: Error): Promise<OpenFin_2.ViewCreationSuccess | void>;
 }
 
 /**
@@ -15607,6 +15671,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}.
  *
@@ -15622,6 +15704,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.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/mock-public.d.ts

@@ -3657,11 +3657,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"
      *
@@ -7686,6 +7681,29 @@ declare class Layout extends Base {
      * ```
      */
     applyPreset: (options: PresetLayoutOptions) => Promise<void>;
+    /**
+     * Adds a view to the platform layout. Behaves like @link{Platform#createView} with the current layout as the target.
+     *
+     * @param viewOptions - The options for creating the view.
+     * @param options - Optional parameters for adding the view.
+     * @param options.location - The location where the view should be added.
+     * @param options.targetView - The target view to which the new view should be added.
+     * @returns A promise that resolves to an object containing the identity of the added view.
+     */
+    addView(viewOptions: OpenFin_2.PlatformViewCreationOptions, { location, targetView }?: {
+        location?: OpenFin_2.CreateViewTarget['location'];
+        targetView?: OpenFin_2.Identity;
+    }): Promise<{
+        identity: OpenFin_2.Identity;
+    }>;
+    /**
+     * Closes a view by its identity. Throws an error if the view does not belong to the current layout.
+     * Behaves like @link{Platform#closeView} but only closes the view if it belongs the current layout.
+     *
+     * @param viewIdentity - The identity of the view to close.
+     * @returns A promise that resolves when the view is closed.
+     */
+    closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
 }
 
 /**
@@ -7698,7 +7716,7 @@ declare type LayoutColumn = LayoutItemConfig & {
 /**
  * @interface
  */
-declare type LayoutComponent = LayoutItemConfig & {
+declare type LayoutComponent = Omit<LayoutItemConfig, 'content' | 'type'> & {
     /**
      * Only a component type will have this property and it should be set to view.
      */
@@ -7707,6 +7725,7 @@ declare type LayoutComponent = LayoutItemConfig & {
      * Only a component type will have this property and it represents the view options of a given component.
      */
     componentState?: Partial<ViewCreationOptions>;
+    type: 'component';
 };
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
@@ -7790,10 +7809,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin_2.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin_2.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin_2.ViewCreationResult[];
 };
 
 /**
@@ -7901,7 +7917,7 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity;
+    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity | undefined;
     /**
      * @experimental
      */
@@ -8892,6 +8908,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 */
@@ -9148,6 +9170,9 @@ declare namespace OpenFin_2 {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -10951,6 +10976,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_2.Identity, error: Error): Promise<OpenFin_2.ViewCreationSuccess | void>;
 }
 
 /**
@@ -15607,6 +15671,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}.
  *
@@ -15622,6 +15704,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.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/mock.d.ts

@@ -3716,11 +3716,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"
      *
@@ -7812,6 +7807,29 @@ declare class Layout extends Base {
      * ```
      */
     applyPreset: (options: PresetLayoutOptions) => Promise<void>;
+    /**
+     * Adds a view to the platform layout. Behaves like @link{Platform#createView} with the current layout as the target.
+     *
+     * @param viewOptions - The options for creating the view.
+     * @param options - Optional parameters for adding the view.
+     * @param options.location - The location where the view should be added.
+     * @param options.targetView - The target view to which the new view should be added.
+     * @returns A promise that resolves to an object containing the identity of the added view.
+     */
+    addView(viewOptions: OpenFin_2.PlatformViewCreationOptions, { location, targetView }?: {
+        location?: OpenFin_2.CreateViewTarget['location'];
+        targetView?: OpenFin_2.Identity;
+    }): Promise<{
+        identity: OpenFin_2.Identity;
+    }>;
+    /**
+     * Closes a view by its identity. Throws an error if the view does not belong to the current layout.
+     * Behaves like @link{Platform#closeView} but only closes the view if it belongs the current layout.
+     *
+     * @param viewIdentity - The identity of the view to close.
+     * @returns A promise that resolves when the view is closed.
+     */
+    closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
 }
 
 /**
@@ -7824,7 +7842,7 @@ declare type LayoutColumn = LayoutItemConfig & {
 /**
  * @interface
  */
-declare type LayoutComponent = LayoutItemConfig & {
+declare type LayoutComponent = Omit<LayoutItemConfig, 'content' | 'type'> & {
     /**
      * Only a component type will have this property and it should be set to view.
      */
@@ -7833,6 +7851,7 @@ declare type LayoutComponent = LayoutItemConfig & {
      * Only a component type will have this property and it represents the view options of a given component.
      */
     componentState?: Partial<ViewCreationOptions>;
+    type: 'component';
 };
 
 declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
@@ -7916,10 +7935,7 @@ declare type LayoutIdentity = Identity_4 & {
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin_2.LayoutIdentity;
-    ofViews: {
-        identity: OpenFin_2.Identity;
-        entityType: 'view';
-    }[];
+    ofViews: OpenFin_2.ViewCreationResult[];
 };
 
 /**
@@ -8027,7 +8043,7 @@ declare interface LayoutManager<T extends LayoutSnapshot> {
     /**
      * @experimental
      */
-    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity;
+    getLayoutIdentityForView(viewIdentity: Identity_4): LayoutIdentity | undefined;
     /**
      * @experimental
      */
@@ -9192,6 +9208,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
@@ -9466,6 +9488,9 @@ declare namespace OpenFin_2 {
         ViewOptions,
         ConstViewOptions,
         ViewState,
+        ViewCreationSuccess,
+        ViewCreationFailure,
+        ViewCreationResult,
         Certificate,
         HostContextChangedPayload,
         ApplySnapshotOptions,
@@ -11352,6 +11377,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_2.Identity, error: Error): Promise<OpenFin_2.ViewCreationSuccess | void>;
 }
 
 /**
@@ -16058,6 +16122,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}.
  *
@@ -16073,6 +16155,25 @@ declare type ViewCreationOptions = Partial<ViewOptions> & {
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.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/mock.js

@@ -11893,7 +11893,7 @@ var __classPrivateFieldGet$4 = (commonjsGlobal && commonjsGlobal.__classPrivateF
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Layout_layoutClient;
+var _Layout_instances, _Layout_layoutClient, _Layout_forwardLayoutAction;
 Object.defineProperty(Instance$1, "__esModule", { value: true });
 Instance$1.Layout = void 0;
 const lazy_1 = lazy;
@@ -12047,6 +12047,7 @@ class Layout extends base_1$5.Base {
     // eslint-disable-next-line no-shadow
     constructor(identity, wire) {
         super(wire);
+        _Layout_instances.add(this);
         /**
          * @internal
          * Lazily constructed {@link LayoutEntitiesClient} bound to this platform's client and identity
@@ -12286,9 +12287,50 @@ class Layout extends base_1$5.Base {
         }
         return layout_entities_1.LayoutNode.getEntity(stack, client);
     }
+    /**
+     * Adds a view to the platform layout. Behaves like @link{Platform#createView} with the current layout as the target.
+     *
+     * @param viewOptions - The options for creating the view.
+     * @param options - Optional parameters for adding the view.
+     * @param options.location - The location where the view should be added.
+     * @param options.targetView - The target view to which the new view should be added.
+     * @returns A promise that resolves to an object containing the identity of the added view.
+     */
+    async addView(viewOptions, { location, targetView } = {}) {
+        this.wire.sendAction('layout-add-view').catch((e) => {
+            // don't expose
+        });
+        const { identity } = await __classPrivateFieldGet$4(this, _Layout_instances, "m", _Layout_forwardLayoutAction).call(this, 'layout-add-view', {
+            viewOptions,
+            location,
+            targetView
+        });
+        return { identity };
+    }
+    /**
+     * Closes a view by its identity. Throws an error if the view does not belong to the current layout.
+     * Behaves like @link{Platform#closeView} but only closes the view if it belongs the current layout.
+     *
+     * @param viewIdentity - The identity of the view to close.
+     * @returns A promise that resolves when the view is closed.
+     */
+    async closeView(viewIdentity) {
+        this.wire.sendAction('layout-close-view').catch((e) => {
+            // don't expose
+        });
+        await __classPrivateFieldGet$4(this, _Layout_instances, "m", _Layout_forwardLayoutAction).call(this, 'layout-close-view', { viewIdentity });
+    }
 }
 Instance$1.Layout = Layout;
-_Layout_layoutClient = new WeakMap();
+_Layout_layoutClient = new WeakMap(), _Layout_instances = new WeakSet(), _Layout_forwardLayoutAction = 
+/**
+ * @internal
+ * Use to type-guard actions sent to the layout via the provider.
+ */
+async function _Layout_forwardLayoutAction(action, payload) {
+    const client = await this.platform.getClient();
+    return client.dispatch(action, { target: this.identity, opts: payload });
+};
 
 var __classPrivateFieldGet$3 = (commonjsGlobal && commonjsGlobal.__classPrivateFieldGet) || function (receiver, state, kind, f) {
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");

package/package.json

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