@openfin/core 41.100.120 → 41.100.121

package/out/mock-alpha.d.ts

@@ -12249,6 +12249,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -17798,6 +17802,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/mock-beta.d.ts

@@ -12249,6 +12249,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -17798,6 +17802,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/mock-public.d.ts

@@ -12249,6 +12249,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -17798,6 +17802,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/stub.d.ts

@@ -12650,6 +12650,10 @@ declare interface ProtocolMap extends ProtocolMapBase {
         transitions: OpenFin_2.Transition;
         options: OpenFin_2.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin_2.Identity;
+        focusIdentity: OpenFin_2.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin_2.GetBoundsOptions;
@@ -18252,6 +18256,30 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin_2.FrameInfo>>;
+    /**
+     * Activates the current window and focuses the child entity if it exists. If this does
+     * not succeed - say the child does not belong to this window, or the identity does not exist -
+     * it will return false.
+     *
+     * @example
+     * ```js
+     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+     *
+     * win.getCurrentViews()
+     *   .then(([view1]) => {
+     *      return win.activateAndFocus(view1.identity);
+     *   })
+     *   .then(success => {
+     *     if (success) {
+     *        console.log('Window activated and child focused');
+     *     } else {
+     *        console.log('Window activation failed, focus state unchanged');
+     *     }
+     *   })
+     *   .catch(console.error);
+     * ```
+     */
+    activateAndFocus(childIdentityToFocus: OpenFin_2.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/stub.js

@@ -4044,6 +4044,37 @@ function requireInstance () {
 	    getAllFrames() {
 	        return this.wire.sendAction('get-all-frames', this.identity).then(({ payload }) => payload.data);
 	    }
+	    /**
+	     * Activates the current window and focuses the child entity if it exists. If this does
+	     * not succeed - say the child does not belong to this window, or the identity does not exist -
+	     * it will return false.
+	     *
+	     * @example
+	     * ```js
+	     * const win = fin.Window.wrapSync({ uuid: 'myApp', name: 'myOtherWindow' });
+	     *
+	     * win.getCurrentViews()
+	     *   .then(([view1]) => {
+	     *      return win.activateAndFocus(view1.identity);
+	     *   })
+	     *   .then(success => {
+	     *     if (success) {
+	     *        console.log('Window activated and child focused');
+	     *     } else {
+	     *        console.log('Window activation failed, focus state unchanged');
+	     *     }
+	     *   })
+	     *   .catch(console.error);
+	     * ```
+	     */
+	    activateAndFocus(childIdentityToFocus) {
+	        return this.wire
+	            .sendAction('activate-window-and-focus', {
+	            winIdentity: this.identity,
+	            focusIdentity: childIdentityToFocus
+	        })
+	            .then(({ payload }) => payload.data);
+	    }
 	    /**
 	     * Gets the current bounds (top, bottom, right, left, width, height) of the window.
 	     *

package/package.json

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