@openfin/core 43.100.23 → 43.100.27

package/out/mock-alpha.d.ts

@@ -9192,6 +9192,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12330,6 +12331,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         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;
@@ -17962,6 +17967,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

@@ -9192,6 +9192,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12330,6 +12331,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         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;
@@ -17962,6 +17967,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

@@ -9192,6 +9192,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12330,6 +12331,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         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;
@@ -17962,6 +17967,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

@@ -9492,6 +9492,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12731,6 +12732,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         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;
@@ -18416,6 +18421,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.
 	     *
@@ -4995,6 +5026,9 @@ function requireInstance () {
 	     * ```
 	     */
 	    updateOptions(options) {
+	        if ('frame' in options) {
+	            console.warn(`Deprecation Warning: Starting with version 45 it will not be possible to change the frame value after window has been created.`);
+	        }
 	        return this.wire.sendAction('update-window-options', { options, ...this.identity }).then(() => undefined);
 	    }
 	    /**

package/package.json

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