@openfin/core 40.101.1 → 40.102.2

package/out/GlobalOpenFin.d.ts

@@ -1,4 +1,5 @@
-import OpenFin from './mock';
+// eslint-disable-next-line import/no-named-as-default
+import OpenFin from './stub';
 
 export = OpenFin;
 export as namespace OpenFin;

package/out/mock-alpha.d.ts

@@ -4601,6 +4601,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
     eventNames: () => (string | symbol)[];
     /* Excluded from this release type: emit */
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -5678,6 +5687,30 @@ declare type FrameProcessDetails = ProcessDetails & {
     entityType: string;
 };
 
+/**
+ * @interface
+ * Options for the {@link Window._Window.getBounds} method.
+ */
+declare interface GetBoundsOptions {
+    /**
+     * Specifies the state of the window for which to retrieve the bounds.
+     *
+     * - `'normal'`: Returns the bounds of the window in its 'normal' state (not maximized or minimized).
+     * - `'current'`: Returns the bounds of the window in its current state. For a minimized window, this returns the bounds from its previous state before being minimized.
+     *
+     *  If a window is in `normal` state, `current` and `normal` will return the same bounds.
+     *
+     * If a window is `maximized`, `current` will return the dimensions of the screen while `normal` will return the bounds the window will be restored to.
+     *
+     * If a window is `minimized`, both `current` and `normal` will return the bounds of the window prior to it being minimized.
+     *
+     * **Edge case:** On MacOS, if a window is maximized, then minimized, calling `getBounds` with `boundsType: 'current'` will return the bounds of the window when it was maximized while `normal` will return the normal bounds.
+     *
+     * @default 'normal'
+     */
+    boundsType?: 'normal' | 'current';
+}
+
 /**
  * @interface
  */
@@ -7585,7 +7618,7 @@ declare type LaunchIntoPlatformPayload = {
  *
  * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
+ * #### [addEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7602,7 +7635,7 @@ declare type LaunchIntoPlatformPayload = {
  * });
  * ```
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
+ * #### [removeEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7866,7 +7899,7 @@ 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.
+     * Adds a view to the platform layout. Behaves like {@link Platform#createView 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.
@@ -7882,7 +7915,7 @@ declare class Layout extends Base {
     }>;
     /**
      * 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.
+     * Behaves like {@link Platform#closeView 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.
@@ -9296,6 +9329,7 @@ declare namespace OpenFin_2 {
         EntityType_4 as EntityType,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -11981,7 +12015,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
         options: OpenFin_2.TransitionOptions;
     }>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
-    'get-window-bounds': IdentityCall<{}, OpenFin_2.WindowBounds>;
+    'get-window-bounds': IdentityCall<{
+        options?: OpenFin_2.GetBoundsOptions;
+    }, OpenFin_2.WindowBounds>;
     'center-window': IdentityCall;
     'blur-window': IdentityCall;
     'bring-window-to-front': IdentityCall;
@@ -13359,6 +13395,7 @@ declare type Snapshot = {
 declare type SnapshotAppliedEvent = BaseEvents.BaseEvent & {
     topic: 'application';
     type: 'platform-snapshot-applied';
+    snapshot: Snapshot;
 };
 
 /**
@@ -17465,7 +17502,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * getBounds().then(bounds => console.log(bounds)).catch(err => console.log(err));
      * ```
      */
-    getBounds(): Promise<OpenFin_2.WindowBounds>;
+    getBounds(options?: OpenFin_2.GetBoundsOptions): Promise<OpenFin_2.WindowBounds>;
     /**
      * Centers the window on its current screen.
      *

package/out/mock-beta.d.ts

@@ -4601,6 +4601,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
     eventNames: () => (string | symbol)[];
     /* Excluded from this release type: emit */
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -5678,6 +5687,30 @@ declare type FrameProcessDetails = ProcessDetails & {
     entityType: string;
 };
 
+/**
+ * @interface
+ * Options for the {@link Window._Window.getBounds} method.
+ */
+declare interface GetBoundsOptions {
+    /**
+     * Specifies the state of the window for which to retrieve the bounds.
+     *
+     * - `'normal'`: Returns the bounds of the window in its 'normal' state (not maximized or minimized).
+     * - `'current'`: Returns the bounds of the window in its current state. For a minimized window, this returns the bounds from its previous state before being minimized.
+     *
+     *  If a window is in `normal` state, `current` and `normal` will return the same bounds.
+     *
+     * If a window is `maximized`, `current` will return the dimensions of the screen while `normal` will return the bounds the window will be restored to.
+     *
+     * If a window is `minimized`, both `current` and `normal` will return the bounds of the window prior to it being minimized.
+     *
+     * **Edge case:** On MacOS, if a window is maximized, then minimized, calling `getBounds` with `boundsType: 'current'` will return the bounds of the window when it was maximized while `normal` will return the normal bounds.
+     *
+     * @default 'normal'
+     */
+    boundsType?: 'normal' | 'current';
+}
+
 /**
  * @interface
  */
@@ -7585,7 +7618,7 @@ declare type LaunchIntoPlatformPayload = {
  *
  * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
+ * #### [addEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7602,7 +7635,7 @@ declare type LaunchIntoPlatformPayload = {
  * });
  * ```
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
+ * #### [removeEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7866,7 +7899,7 @@ 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.
+     * Adds a view to the platform layout. Behaves like {@link Platform#createView 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.
@@ -7882,7 +7915,7 @@ declare class Layout extends Base {
     }>;
     /**
      * 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.
+     * Behaves like {@link Platform#closeView 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.
@@ -9296,6 +9329,7 @@ declare namespace OpenFin_2 {
         EntityType_4 as EntityType,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -11981,7 +12015,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
         options: OpenFin_2.TransitionOptions;
     }>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
-    'get-window-bounds': IdentityCall<{}, OpenFin_2.WindowBounds>;
+    'get-window-bounds': IdentityCall<{
+        options?: OpenFin_2.GetBoundsOptions;
+    }, OpenFin_2.WindowBounds>;
     'center-window': IdentityCall;
     'blur-window': IdentityCall;
     'bring-window-to-front': IdentityCall;
@@ -13359,6 +13395,7 @@ declare type Snapshot = {
 declare type SnapshotAppliedEvent = BaseEvents.BaseEvent & {
     topic: 'application';
     type: 'platform-snapshot-applied';
+    snapshot: Snapshot;
 };
 
 /**
@@ -17465,7 +17502,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * getBounds().then(bounds => console.log(bounds)).catch(err => console.log(err));
      * ```
      */
-    getBounds(): Promise<OpenFin_2.WindowBounds>;
+    getBounds(options?: OpenFin_2.GetBoundsOptions): Promise<OpenFin_2.WindowBounds>;
     /**
      * Centers the window on its current screen.
      *

package/out/mock-public.d.ts

@@ -4601,6 +4601,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
     eventNames: () => (string | symbol)[];
     /* Excluded from this release type: emit */
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -5678,6 +5687,30 @@ declare type FrameProcessDetails = ProcessDetails & {
     entityType: string;
 };
 
+/**
+ * @interface
+ * Options for the {@link Window._Window.getBounds} method.
+ */
+declare interface GetBoundsOptions {
+    /**
+     * Specifies the state of the window for which to retrieve the bounds.
+     *
+     * - `'normal'`: Returns the bounds of the window in its 'normal' state (not maximized or minimized).
+     * - `'current'`: Returns the bounds of the window in its current state. For a minimized window, this returns the bounds from its previous state before being minimized.
+     *
+     *  If a window is in `normal` state, `current` and `normal` will return the same bounds.
+     *
+     * If a window is `maximized`, `current` will return the dimensions of the screen while `normal` will return the bounds the window will be restored to.
+     *
+     * If a window is `minimized`, both `current` and `normal` will return the bounds of the window prior to it being minimized.
+     *
+     * **Edge case:** On MacOS, if a window is maximized, then minimized, calling `getBounds` with `boundsType: 'current'` will return the bounds of the window when it was maximized while `normal` will return the normal bounds.
+     *
+     * @default 'normal'
+     */
+    boundsType?: 'normal' | 'current';
+}
+
 /**
  * @interface
  */
@@ -7585,7 +7618,7 @@ declare type LaunchIntoPlatformPayload = {
  *
  * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
+ * #### [addEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7602,7 +7635,7 @@ declare type LaunchIntoPlatformPayload = {
  * });
  * ```
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
+ * #### [removeEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7866,7 +7899,7 @@ 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.
+     * Adds a view to the platform layout. Behaves like {@link Platform#createView 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.
@@ -7882,7 +7915,7 @@ declare class Layout extends Base {
     }>;
     /**
      * 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.
+     * Behaves like {@link Platform#closeView 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.
@@ -9296,6 +9329,7 @@ declare namespace OpenFin_2 {
         EntityType_4 as EntityType,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -11981,7 +12015,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
         options: OpenFin_2.TransitionOptions;
     }>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
-    'get-window-bounds': IdentityCall<{}, OpenFin_2.WindowBounds>;
+    'get-window-bounds': IdentityCall<{
+        options?: OpenFin_2.GetBoundsOptions;
+    }, OpenFin_2.WindowBounds>;
     'center-window': IdentityCall;
     'blur-window': IdentityCall;
     'bring-window-to-front': IdentityCall;
@@ -13359,6 +13395,7 @@ declare type Snapshot = {
 declare type SnapshotAppliedEvent = BaseEvents.BaseEvent & {
     topic: 'application';
     type: 'platform-snapshot-applied';
+    snapshot: Snapshot;
 };
 
 /**
@@ -17465,7 +17502,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * getBounds().then(bounds => console.log(bounds)).catch(err => console.log(err));
      * ```
      */
-    getBounds(): Promise<OpenFin_2.WindowBounds>;
+    getBounds(options?: OpenFin_2.GetBoundsOptions): Promise<OpenFin_2.WindowBounds>;
     /**
      * Centers the window on its current screen.
      *

package/out/{mock.d.ts → stub.d.ts}

@@ -4665,6 +4665,15 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
         type: EventType;
     }>, ...args: any[]) => boolean;
     private hasEmitter;
+    /**
+     * Cleans up after removal of a listener, e.g. deleting any lingering deregistration handlers for a
+     * `once` subscription.
+     *
+     * @remarks Implementing this as a `removeListener` handler ensures that direct removal of a listener
+     * on the base emitter will not leak additional core handlers.  We could do this in the forwarding method,
+     * which would involve less "magic," but would be more-vulnerable to accidental re-introduction of a leak.
+     */
+    private cleanUpRemovedListener;
     private getOrCreateEmitter;
     listeners: (type: string | symbol) => Function[];
     listenerCount: (type: string | symbol) => number;
@@ -5766,6 +5775,30 @@ declare type FrameProcessDetails = ProcessDetails & {
     entityType: string;
 };
 
+/**
+ * @interface
+ * Options for the {@link Window._Window.getBounds} method.
+ */
+declare interface GetBoundsOptions {
+    /**
+     * Specifies the state of the window for which to retrieve the bounds.
+     *
+     * - `'normal'`: Returns the bounds of the window in its 'normal' state (not maximized or minimized).
+     * - `'current'`: Returns the bounds of the window in its current state. For a minimized window, this returns the bounds from its previous state before being minimized.
+     *
+     *  If a window is in `normal` state, `current` and `normal` will return the same bounds.
+     *
+     * If a window is `maximized`, `current` will return the dimensions of the screen while `normal` will return the bounds the window will be restored to.
+     *
+     * If a window is `minimized`, both `current` and `normal` will return the bounds of the window prior to it being minimized.
+     *
+     * **Edge case:** On MacOS, if a window is maximized, then minimized, calling `getBounds` with `boundsType: 'current'` will return the bounds of the window when it was maximized while `normal` will return the normal bounds.
+     *
+     * @default 'normal'
+     */
+    boundsType?: 'normal' | 'current';
+}
+
 /**
  * @interface
  */
@@ -7702,7 +7735,7 @@ declare type LaunchIntoPlatformPayload = {
  *
  * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
+ * #### [addEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7719,7 +7752,7 @@ declare type LaunchIntoPlatformPayload = {
  * });
  * ```
  *
- * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
+ * #### [removeEventListener(type, listener [, options]);](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener)
  * Adds a listener to the end of the listeners array for the specified event.
  * @example
  * ```js
@@ -7992,7 +8025,7 @@ 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.
+     * Adds a view to the platform layout. Behaves like {@link Platform#createView 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.
@@ -8008,7 +8041,7 @@ declare class Layout extends Base {
     }>;
     /**
      * 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.
+     * Behaves like {@link Platform#closeView 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.
@@ -9614,6 +9647,7 @@ declare namespace OpenFin_2 {
         EntityType_4 as EntityType,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -12382,7 +12416,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
         options: OpenFin_2.TransitionOptions;
     }>;
     'get-all-frames': IdentityCall<{}, OpenFin_2.FrameInfo[]>;
-    'get-window-bounds': IdentityCall<{}, OpenFin_2.WindowBounds>;
+    'get-window-bounds': IdentityCall<{
+        options?: OpenFin_2.GetBoundsOptions;
+    }, OpenFin_2.WindowBounds>;
     'center-window': IdentityCall;
     'blur-window': IdentityCall;
     'bring-window-to-front': IdentityCall;
@@ -13760,6 +13796,7 @@ declare type Snapshot = {
 declare type SnapshotAppliedEvent = BaseEvents.BaseEvent & {
     topic: 'application';
     type: 'platform-snapshot-applied';
+    snapshot: Snapshot;
 };
 
 /**
@@ -17919,7 +17956,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * getBounds().then(bounds => console.log(bounds)).catch(err => console.log(err));
      * ```
      */
-    getBounds(): Promise<OpenFin_2.WindowBounds>;
+    getBounds(options?: OpenFin_2.GetBoundsOptions): Promise<OpenFin_2.WindowBounds>;
     /**
      * Centers the window on its current screen.
      *