@openfin/core 41.100.73 → 41.100.79

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

@@ -4676,6 +4676,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;
@@ -5754,6 +5763,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
  */
@@ -9405,6 +9438,7 @@ declare namespace OpenFin_2 {
         ScreenCapturePermission,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -12127,7 +12161,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;
@@ -17656,7 +17692,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

@@ -4676,6 +4676,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;
@@ -5754,6 +5763,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
  */
@@ -9405,6 +9438,7 @@ declare namespace OpenFin_2 {
         ScreenCapturePermission,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -12127,7 +12161,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;
@@ -17656,7 +17692,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

@@ -4676,6 +4676,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;
@@ -5754,6 +5763,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
  */
@@ -9405,6 +9438,7 @@ declare namespace OpenFin_2 {
         ScreenCapturePermission,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -12127,7 +12161,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;
@@ -17656,7 +17692,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}

@@ -4740,6 +4740,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;
@@ -5842,6 +5851,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
  */
@@ -9723,6 +9756,7 @@ declare namespace OpenFin_2 {
         ScreenCapturePermission,
         Bounds,
         WindowBounds,
+        GetBoundsOptions,
         Rectangle,
         ApplicationCreationOptions,
         TimeZones,
@@ -12528,7 +12562,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;
@@ -18110,7 +18146,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.js → stub.js}

@@ -372,7 +372,7 @@ var __classPrivateFieldGet$h = (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 _EmitterBase_emitterAccessor;
+var _EmitterBase_emitterAccessor, _EmitterBase_deregisterOnceListeners;
 Object.defineProperty(base, "__esModule", { value: true });
 base.Reply = base.EmitterBase = base.Base = void 0;
 const promises_1 = promises;
@@ -444,6 +444,7 @@ class EmitterBase extends Base {
         super(wire);
         this.topic = topic;
         _EmitterBase_emitterAccessor.set(this, void 0);
+        _EmitterBase_deregisterOnceListeners.set(this, void 0);
         this.eventNames = () => (this.hasEmitter() ? this.getOrCreateEmitter().eventNames() : []);
         /**
          * @internal
@@ -452,7 +453,28 @@ class EmitterBase extends Base {
             return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
         };
         this.hasEmitter = () => this.wire.eventAggregator.has(__classPrivateFieldGet$h(this, _EmitterBase_emitterAccessor, "f"));
-        this.getOrCreateEmitter = () => this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$h(this, _EmitterBase_emitterAccessor, "f"));
+        /**
+         * 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.
+         */
+        this.cleanUpRemovedListener = (eventType, listener) => {
+            const deregister = __classPrivateFieldGet$h(this, _EmitterBase_deregisterOnceListeners, "f").get(listener);
+            if (deregister) {
+                const emitter = this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$h(this, _EmitterBase_emitterAccessor, "f"));
+                emitter.removeListener(eventType, deregister);
+            }
+        };
+        this.getOrCreateEmitter = () => {
+            const emitter = this.wire.eventAggregator.getOrCreate(__classPrivateFieldGet$h(this, _EmitterBase_emitterAccessor, "f"));
+            if (!emitter.listeners('removeListener').includes(this.cleanUpRemovedListener)) {
+                emitter.on('removeListener', this.cleanUpRemovedListener);
+            }
+            return emitter;
+        };
         this.listeners = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(type) : [];
         this.listenerCount = (type) => this.hasEmitter() ? this.getOrCreateEmitter().listenerCount(type) : 0;
         this.registerEventListener = async (eventType, options = {}, applySubscription, undoSubscription) => {
@@ -484,13 +506,13 @@ class EmitterBase extends Base {
                     type: eventType
                 };
                 await this.wire.sendAction('unsubscribe-to-desktop-event', runtimeEvent).catch(() => null);
-                const emitter = this.getOrCreateEmitter();
-                return emitter;
+                return this.getOrCreateEmitter();
             }
             // This will only be reached if unsubscribe from event that does not exist but do not want to error here
             return Promise.resolve();
         };
         __classPrivateFieldSet$g(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
+        __classPrivateFieldSet$g(this, _EmitterBase_deregisterOnceListeners, new WeakMap(), "f");
         this.listeners = (event) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(event) : [];
     }
     /**
@@ -519,6 +541,7 @@ class EmitterBase extends Base {
      */
     async once(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
+        __classPrivateFieldGet$h(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.once(eventType, deregister);
             emitter.once(eventType, listener);
@@ -549,6 +572,7 @@ class EmitterBase extends Base {
      */
     async prependOnceListener(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
+        __classPrivateFieldGet$h(this, _EmitterBase_deregisterOnceListeners, "f").set(listener, deregister);
         await this.registerEventListener(eventType, options, (emitter) => {
             emitter.prependOnceListener(eventType, listener);
             emitter.once(eventType, deregister);
@@ -607,13 +631,13 @@ class EmitterBase extends Base {
         return this;
     }
     deleteEmitterIfNothingRegistered(emitter) {
-        if (emitter.eventNames().length === 0) {
+        if (emitter.eventNames().every((type) => type === 'removeListener')) {
             this.wire.eventAggregator.delete(__classPrivateFieldGet$h(this, _EmitterBase_emitterAccessor, "f"));
         }
     }
 }
 base.EmitterBase = EmitterBase;
-_EmitterBase_emitterAccessor = new WeakMap();
+_EmitterBase_emitterAccessor = new WeakMap(), _EmitterBase_deregisterOnceListeners = new WeakMap();
 class Reply {
 }
 base.Reply = Reply;
@@ -4039,9 +4063,9 @@ function requireInstance () {
 	     * getBounds().then(bounds => console.log(bounds)).catch(err => console.log(err));
 	     * ```
 	     */
-	    getBounds() {
+	    getBounds(options) {
 	        return this.wire
-	            .sendAction('get-window-bounds', this.identity)
+	            .sendAction('get-window-bounds', { ...this.identity, options })
 	            .then(({ payload }) => payload.data);
 	    }
 	    /**
@@ -17603,12 +17627,12 @@ class Transport extends events_1$1.EventEmitter {
 Transport_1 = transport.Transport = Transport;
 _Transport_wire = new WeakMap(), _Transport_fin = new WeakMap();
 
-var mockEnvironment = {};
+var stubEnvironment = {};
 
-Object.defineProperty(mockEnvironment, "__esModule", { value: true });
-var MockEnvironment_1 = mockEnvironment.MockEnvironment = void 0;
+Object.defineProperty(stubEnvironment, "__esModule", { value: true });
+var StubEnvironment_1 = stubEnvironment.StubEnvironment = void 0;
 const me_1 = me;
-class MockEnvironment {
+class StubEnvironment {
     constructor() {
         this.type = 'other';
         this.childViews = true;
@@ -17689,15 +17713,15 @@ class MockEnvironment {
         throw new Error('Method not implemented.');
     }
 }
-MockEnvironment_1 = mockEnvironment.MockEnvironment = MockEnvironment;
+StubEnvironment_1 = stubEnvironment.StubEnvironment = StubEnvironment;
 
-var mockWire = {};
+var stubWire = {};
 
-Object.defineProperty(mockWire, "__esModule", { value: true });
-var MockWire_1 = mockWire.MockWire = void 0;
+Object.defineProperty(stubWire, "__esModule", { value: true });
+var StubWire_1 = stubWire.StubWire = void 0;
 /* eslint-disable @typescript-eslint/no-unused-vars */
 const events_1 = require$$0;
-class MockWire extends events_1.EventEmitter {
+class StubWire extends events_1.EventEmitter {
     connect() {
         throw new Error('You are not running in OpenFin.');
     }
@@ -17718,12 +17742,12 @@ class MockWire extends events_1.EventEmitter {
         super();
     }
 }
-MockWire_1 = mockWire.MockWire = MockWire;
+StubWire_1 = stubWire.StubWire = StubWire;
 
 const fin$1 = ((typeof window !== 'undefined' && window?.fin) ||
     (() => {
-        const environment = new MockEnvironment_1();
-        const transport = new Transport_1(MockWire_1, environment, {
+        const environment = new StubEnvironment_1();
+        const transport = new Transport_1(StubWire_1, environment, {
             uuid: '',
             name: ''
         });

package/package.json

@@ -1,10 +1,10 @@
 {
     "name": "@openfin/core",
-    "version": "41.100.73",
+    "version": "41.100.79",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.md",
-    "main": "out/mock.js",
-    "types": "out/mock.d.ts",
+    "main": "out/stub.js",
+    "types": "out/stub.d.ts",
     "private": false,
     "scripts": {
         "prebuild": "rimraf ./out",