@openfin/fdc3-api 43.100.23 → 43.100.27

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

@@ -9534,6 +9534,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12670,6 +12671,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18408,6 +18413,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.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.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

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

@@ -9534,6 +9534,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12670,6 +12671,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18408,6 +18413,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.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.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

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

@@ -9534,6 +9534,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -12670,6 +12671,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18408,6 +18413,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.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.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/out/fdc3-api.d.ts

@@ -9834,6 +9834,7 @@ declare type MutableWindowOptions = {
     customData: any;
     /**
      * @defaultValue true
+     * @deprecated Will be removed in runtime version 45
      *
      * Show the window's frame.
      */
@@ -13071,6 +13072,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         transitions: OpenFin.Transition;
         options: OpenFin.TransitionOptions;
     }>;
+    'activate-window-and-focus': ApiCall<{
+        winIdentity: OpenFin.Identity;
+        focusIdentity: OpenFin.Identity;
+    }, boolean>;
     'get-all-frames': IdentityCall<{}, OpenFin.FrameInfo[]>;
     'get-window-bounds': IdentityCall<{
         options?: OpenFin.GetBoundsOptions;
@@ -18862,6 +18867,30 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * ```
      */
     getAllFrames(): Promise<Array<OpenFin.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.Identity): Promise<boolean>;
     /**
      * Gets the current bounds (top, bottom, right, left, width, height) of the window.
      *

package/package.json

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