@openfin/core 34.78.16 → 34.78.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/out/mock.d.ts CHANGED
@@ -523,6 +523,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
523
523
  /**
524
524
  * Sets or removes a custom JumpList for the application. Only applicable in Windows OS.
525
525
  * If categories is null the previously set custom JumpList (if any) will be replaced by the standard JumpList for the app (managed by Windows).
526
+ *
526
527
  * Note: If the "name" property is omitted it defaults to "tasks".
527
528
  * @param jumpListCategories An array of JumpList Categories to populate. If null, remove any existing JumpList configuration and set to Windows default.
528
529
  *
@@ -793,6 +794,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
793
794
  getProcessInfo(): Promise<OpenFin_2.AppProcessInfo>;
794
795
  /**
795
796
  * Sets file auto download location. It's only allowed in the same application.
797
+ *
796
798
  * Note: This method is restricted by default and must be enabled via
797
799
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
798
800
  * @param downloadLocation file auto download location
@@ -814,6 +816,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
814
816
  setFileDownloadLocation(downloadLocation: string): Promise<void>;
815
817
  /**
816
818
  * Gets file auto download location. It's only allowed in the same application. If file auto download location is not set, it will return the default location.
819
+ *
817
820
  * Note: This method is restricted by default and must be enabled via
818
821
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
819
822
  *
@@ -873,7 +876,7 @@ declare type ApplicationEvent = {
873
876
  topic: 'application';
874
877
  } & (PropagatedViewEvent | PropagatedWindowEvent | ApplicationWindowEvent | WillPropagateApplicationEvent);
875
878
 
876
- declare type ApplicationEvent_2 = ApplicationEvents.ApplicationEvent;
879
+ declare type ApplicationEvent_2 = Events.ApplicationEvents.ApplicationEvent;
877
880
 
878
881
  declare namespace ApplicationEvents {
879
882
  export {
@@ -1212,6 +1215,7 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1212
1215
  * @defaultValue false
1213
1216
  *
1214
1217
  * **Platforms Only.** Prevent the Platform Provider from quitting automatically when the last Platform Window is closed.
1218
+ *
1215
1219
  * Note: if the Platform Provider is showing, it won't close automatically.
1216
1220
  * If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.
1217
1221
  */
@@ -1646,7 +1650,7 @@ declare type BaseEvent = {
1646
1650
  type: string;
1647
1651
  };
1648
1652
 
1649
- declare type BaseEvent_2 = BaseEvents.BaseEvent;
1653
+ declare type BaseEvent_2 = Events.BaseEvents.BaseEvent;
1650
1654
 
1651
1655
  declare namespace BaseEvents {
1652
1656
  export {
@@ -3308,8 +3312,9 @@ declare type ConstWindowOptions = {
3308
3312
  closeOnLastViewRemoved: boolean;
3309
3313
  /**
3310
3314
  * Centers the window in the primary monitor. This option overrides `defaultLeft` and `defaultTop`. When `saveWindowState` is `true`,
3311
- * this value will be ignored for subsequent launches in favor of the cached value. **NOTE:** On macOS _defaultCenter_ is
3312
- * somewhat above center vertically.
3315
+ * this value will be ignored for subsequent launches in favor of the cached value.
3316
+ *
3317
+ * **NOTE:** On macOS _defaultCenter_ is somewhat above center vertically.
3313
3318
  */
3314
3319
  defaultCentered: boolean;
3315
3320
  /**
@@ -3371,6 +3376,7 @@ declare type ConstWindowOptions = {
3371
3376
  * @defaultValue true
3372
3377
  *
3373
3378
  * Caches the location of the window.
3379
+ *
3374
3380
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3375
3381
  */
3376
3382
  saveWindowState: boolean;
@@ -3383,7 +3389,8 @@ declare type ConstWindowOptions = {
3383
3389
  * @defaultValue false
3384
3390
  *
3385
3391
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3386
- * _Note: Caveats of small windows are no Aero Snap and drag to/from maximize._
3392
+ *
3393
+ * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3387
3394
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3388
3395
  */
3389
3396
  smallWindow: boolean;
@@ -3499,7 +3506,8 @@ declare type ContentCreationRulesEvent = NamedEvent & {
3499
3506
  frameName: string;
3500
3507
  /**
3501
3508
  * The rule which triggered this event. May be undefined on `child-window-created` where no rule corresponds to the child Window creation.
3502
- * <br>Note: It is only defined if the rules engine found a match for a user-supplied rule, not in the case of an api call or the default behavior.
3509
+ *
3510
+ * Note: It is only defined if the rules engine found a match for a user-supplied rule, not in the case of an api call or the default behavior.
3503
3511
  */
3504
3512
  rule: OpenFin_2.ContentCreationRule;
3505
3513
  /**
@@ -3968,6 +3976,9 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3968
3976
  protected identity: ApplicationIdentity;
3969
3977
  constructor(wire: Transport, topic: string, ...additionalAccessors: string[]);
3970
3978
  eventNames: () => (string | symbol)[];
3979
+ /**
3980
+ * @internal
3981
+ */
3971
3982
  emit: <EventType extends EmitterEventType>(eventType: EventType, payload: Extract<EmitterEvent, {
3972
3983
  type: EventType;
3973
3984
  }>, ...args: any[]) => boolean;
@@ -3979,6 +3990,8 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3979
3990
  protected deregisterEventListener: (eventType: EmitterEventType, options?: OpenFin_2.SubscriptionOptions) => Promise<void | EventEmitter>;
3980
3991
  /**
3981
3992
  * Adds a listener to the end of the listeners array for the specified event.
3993
+ *
3994
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3982
3995
  */
3983
3996
  on<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3984
3997
  /**
@@ -3987,15 +4000,21 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3987
4000
  addListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3988
4001
  /**
3989
4002
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
4003
+ *
4004
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3990
4005
  */
3991
4006
  once<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3992
4007
  /**
3993
4008
  * Adds a listener to the beginning of the listeners array for the specified event.
4009
+ *
4010
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3994
4011
  */
3995
4012
  prependListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3996
4013
  /**
3997
4014
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
3998
4015
  * after which it is removed. The listener is added to the beginning of the listeners array.
4016
+ *
4017
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3999
4018
  */
4000
4019
  prependOnceListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
4001
4020
  /**
@@ -4154,6 +4173,21 @@ declare type EventHandler<EmitterEvent extends BaseEvent, EventType extends stri
4154
4173
  type: EventType;
4155
4174
  }>, ...args: any[]) => void;
4156
4175
 
4176
+ declare namespace Events {
4177
+ export {
4178
+ ApplicationEvents,
4179
+ BaseEvents,
4180
+ ExternalApplicationEvents,
4181
+ FrameEvents,
4182
+ GlobalHotkeyEvents,
4183
+ PlatformEvents,
4184
+ SystemEvents,
4185
+ ViewEvents,
4186
+ WebContentsEvents,
4187
+ WindowEvents
4188
+ }
4189
+ }
4190
+
4157
4191
  /**
4158
4192
  * @internal
4159
4193
  */
@@ -4320,7 +4354,7 @@ declare type ExternalApplicationEvent = {
4320
4354
  topic: 'externalapplication';
4321
4355
  } & (ExternalApplicationConnectedEvent | ExternalApplicationDisconnectedEvent);
4322
4356
 
4323
- declare type ExternalApplicationEvent_2 = ExternalApplicationEvents.ExternalApplicationEvent;
4357
+ declare type ExternalApplicationEvent_2 = Events.ExternalApplicationEvents.ExternalApplicationEvent;
4324
4358
 
4325
4359
  declare namespace ExternalApplicationEvents {
4326
4360
  export {
@@ -4818,7 +4852,7 @@ declare type FrameEvent = {
4818
4852
  topic: 'frame';
4819
4853
  } & (FrameConnectedEvent | FrameDisconnectedEvent);
4820
4854
 
4821
- declare type FrameEvent_2 = FrameEvents.FrameEvent;
4855
+ declare type FrameEvent_2 = Events.FrameEvents.FrameEvent;
4822
4856
 
4823
4857
  declare namespace FrameEvents {
4824
4858
  export {
@@ -5064,7 +5098,7 @@ declare type GlobalHotkeyEvent = {
5064
5098
  hotkey: 'string';
5065
5099
  } & (RegisteredEvent | UnregisteredEvent);
5066
5100
 
5067
- declare type GlobalHotkeyEvent_2 = GlobalHotkeyEvents.GlobalHotkeyEvent;
5101
+ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
5068
5102
 
5069
5103
  declare namespace GlobalHotkeyEvents {
5070
5104
  export {
@@ -7349,6 +7383,7 @@ declare type LayoutItemConfig = {
7349
7383
  };
7350
7384
 
7351
7385
  declare class LayoutManager {
7386
+ #private;
7352
7387
  private readonly splitterController;
7353
7388
  private readonly tabDragController;
7354
7389
  private readonly layoutContentCache;
@@ -8406,8 +8441,9 @@ declare type MutableWindowOptions = {
8406
8441
  hotkeys: Hotkey[];
8407
8442
  /**
8408
8443
  * A URL for the icon to be shown in the window title bar and the taskbar.
8409
- * When omitted, inherits from the parent application._
8410
- * note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
8444
+ * When omitted, inherits from the parent application.
8445
+ *
8446
+ * Note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
8411
8447
  */
8412
8448
  icon: string;
8413
8449
  /**
@@ -8593,6 +8629,7 @@ declare namespace OpenFin_2 {
8593
8629
  ExternalApplicationModule,
8594
8630
  _Frame as Frame,
8595
8631
  _FrameModule,
8632
+ GlobalHotkey,
8596
8633
  Channel,
8597
8634
  ChannelClient,
8598
8635
  ChannelProvider,
@@ -8611,6 +8648,7 @@ declare namespace OpenFin_2 {
8611
8648
  InteropModule,
8612
8649
  SnapshotSource,
8613
8650
  SnapshotSourceModule,
8651
+ System,
8614
8652
  LayoutEntityDefinition,
8615
8653
  LayoutEntityTypes,
8616
8654
  LayoutPosition,
@@ -8862,16 +8900,7 @@ declare namespace OpenFin_2 {
8862
8900
  AppVersionErrorEvent,
8863
8901
  AppVersionCompleteEvent,
8864
8902
  AppVersionRuntimeStatusEvent,
8865
- BaseEvents,
8866
- WebContentsEvents,
8867
- SystemEvents,
8868
- ApplicationEvents,
8869
- WindowEvents,
8870
- ViewEvents,
8871
- GlobalHotkeyEvents,
8872
- FrameEvents,
8873
- PlatformEvents,
8874
- ExternalApplicationEvents,
8903
+ Events,
8875
8904
  BaseEvent_2 as BaseEvent,
8876
8905
  WebContentsEvent_2 as WebContentsEvent,
8877
8906
  SystemEvent_2 as SystemEvent,
@@ -8896,7 +8925,17 @@ declare namespace OpenFin_2 {
8896
8925
  ChannelClientConnectionListener,
8897
8926
  ChannelClientDisconnectionListener,
8898
8927
  ChannelProviderDisconnectionListener,
8899
- RoutingInfo
8928
+ RoutingInfo,
8929
+ ApplicationEvents,
8930
+ BaseEvents,
8931
+ ExternalApplicationEvents,
8932
+ FrameEvents,
8933
+ GlobalHotkeyEvents,
8934
+ PlatformEvents,
8935
+ SystemEvents,
8936
+ ViewEvents,
8937
+ WebContentsEvents,
8938
+ WindowEvents
8900
8939
  }
8901
8940
  }
8902
8941
  export default OpenFin_2;
@@ -8953,10 +8992,8 @@ declare type PickOfType<T extends Record<any, any>, TTarget> = {
8953
8992
 
8954
8993
  /** Manages the life cycle of windows and views in the application.
8955
8994
  *
8956
- * Enables taking snapshots of itself and applyi
8957
- * ng them to restore a previous configuration
8995
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
8958
8996
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
8959
- *
8960
8997
  */
8961
8998
  declare class Platform extends EmitterBase<OpenFin_2.PlatformEvent> {
8962
8999
  #private;
@@ -9615,7 +9652,7 @@ declare type PlatformApiReadyEvent = BaseEvent & {
9615
9652
  */
9616
9653
  declare type PlatformEvent = ApplicationEvent | PlatformApiReadyEvent | PlatformSnapshotAppliedEvent;
9617
9654
 
9618
- declare type PlatformEvent_2 = PlatformEvents.PlatformEvent;
9655
+ declare type PlatformEvent_2 = Events.PlatformEvents.PlatformEvent;
9619
9656
 
9620
9657
  declare namespace PlatformEvents {
9621
9658
  export {
@@ -10463,7 +10500,8 @@ declare type PopupOptions = {
10463
10500
  resultDispatchBehavior?: PopupResultBehavior;
10464
10501
  /**
10465
10502
  * Hide the popup window instead of closing when `close` is called on it.
10466
- * <br>Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
10503
+ *
10504
+ * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
10467
10505
  * @defaultValue false
10468
10506
  */
10469
10507
  hideOnClose?: boolean;
@@ -10478,7 +10516,8 @@ declare type PopupOptions = {
10478
10516
  onPopupReady?: (popupWindow: _Window) => any;
10479
10517
  /**
10480
10518
  * Executed when this window's popup calls `dispatchPopupResult`.
10481
- * <br>Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
10519
+ *
10520
+ * Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
10482
10521
  */
10483
10522
  onPopupResult?: (payload: PopupResult) => any;
10484
10523
  };
@@ -12806,7 +12845,8 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
12806
12845
  showDeveloperTools(identity: Identity_2): Promise<void>;
12807
12846
  /**
12808
12847
  * Attempt to close an external process. The process will be terminated if it
12809
- * has not closed after the elapsed timeout in milliseconds.<br>
12848
+ * has not closed after the elapsed timeout in milliseconds.
12849
+ *
12810
12850
  * Note: This method is restricted by default and must be enabled via
12811
12851
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12812
12852
  * @param options A object defined in the TerminateExternalRequestType interface
@@ -12838,7 +12878,8 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
12838
12878
  */
12839
12879
  updateProxySettings(options: ProxyConfig): Promise<void>;
12840
12880
  /**
12841
- * Downloads the given application asset<br>
12881
+ * Downloads the given application asset.
12882
+ *
12842
12883
  * Note: This method is restricted by default and must be enabled via
12843
12884
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12844
12885
  * @param appAsset App asset object
@@ -13407,7 +13448,7 @@ declare type SystemEvent = {
13407
13448
  topic: 'system';
13408
13449
  } & (ExcludeRequested<PropagatedWindowEvent> | PropagatedViewEvent | PropagatedApplicationEvent | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleEvent | MonitorEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent);
13409
13450
 
13410
- declare type SystemEvent_2 = SystemEvents.SystemEvent;
13451
+ declare type SystemEvent_2 = Events.SystemEvents.SystemEvent;
13411
13452
 
13412
13453
  declare namespace SystemEvents {
13413
13454
  export {
@@ -14636,7 +14677,7 @@ declare type ViewEvent = {
14636
14677
  topic: 'view';
14637
14678
  } & (NonPropagatedViewEvent | WillPropagateViewEvent);
14638
14679
 
14639
- declare type ViewEvent_2 = ViewEvents.ViewEvent;
14680
+ declare type ViewEvent_2 = Events.ViewEvents.ViewEvent;
14640
14681
 
14641
14682
  declare namespace ViewEvents {
14642
14683
  export {
@@ -15069,7 +15110,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15069
15110
  /**
15070
15111
  * Navigates the WebContents to a specified URL.
15071
15112
  *
15072
- * @remarks The url must contain the protocol prefix such as http:// or https://.
15113
+ * Note: The url must contain the protocol prefix such as http:// or https://.
15073
15114
  * @param url - The URL to navigate the WebContents to.
15074
15115
  *
15075
15116
  * @example
@@ -15237,7 +15278,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15237
15278
  * Prints the WebContents.
15238
15279
  * @param options Printer Options
15239
15280
  *
15240
- * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
15281
+ * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
15241
15282
  * is empty and the default settings for printing.
15242
15283
  *
15243
15284
  * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -15261,7 +15302,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15261
15302
  * @param searchTerm Term to find in page
15262
15303
  * @param options Search options
15263
15304
  *
15264
- * @remarks By default, each subsequent call will highlight the next text that matches the search term.
15305
+ * Note: By default, each subsequent call will highlight the next text that matches the search term.
15265
15306
  *
15266
15307
  * Returns a promise with the results for the request. By subscribing to the
15267
15308
  * found-in-page event, you can get the results of this call as well.
@@ -15451,7 +15492,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15451
15492
  /**
15452
15493
  * Retrieves the process information associated with a WebContents.
15453
15494
  *
15454
- * @remarks This includes any iframes associated with the WebContents
15495
+ * Note: This includes any iframes associated with the WebContents
15455
15496
  *
15456
15497
  * @example
15457
15498
  * View:
@@ -15621,7 +15662,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15621
15662
  /**
15622
15663
  * Shows a popup window.
15623
15664
  *
15624
- * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
15665
+ * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
15625
15666
  *
15626
15667
  * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
15627
15668
  * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -15629,7 +15670,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15629
15670
  * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
15630
15671
  * will be dismissed.
15631
15672
  *
15632
- * NOTE: in the case where the window being shown as a popup needs to be created, it is a child of the caller view's parent window.
15673
+ * Note: in the case where the window being shown as a popup needs to be created, it is a child of the caller view's parent window.
15633
15674
  *
15634
15675
  * @example
15635
15676
  *
@@ -15837,7 +15878,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15837
15878
  */
15838
15879
  declare type WebContentsEvent = NonPropagatedWebContentsEvent | WillPropagateWebContentsEvent;
15839
15880
 
15840
- declare type WebContentsEvent_2 = WebContentsEvents.WebContentsEvent;
15881
+ declare type WebContentsEvent_2 = Events.WebContentsEvents.WebContentsEvent;
15841
15882
 
15842
15883
  declare namespace WebContentsEvents {
15843
15884
  export {
@@ -17678,7 +17719,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
17678
17719
  topic: 'window';
17679
17720
  } & (WillPropagateWindowEvent | NonPropagatedWindowEvent | PropagatedViewEvent);
17680
17721
 
17681
- declare type WindowEvent_2 = WindowEvents.WindowEvent;
17722
+ declare type WindowEvent_2 = Events.WindowEvents.WindowEvent;
17682
17723
 
17683
17724
  declare namespace WindowEvents {
17684
17725
  export {