@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.
@@ -517,6 +517,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
517
517
  /**
518
518
  * Sets or removes a custom JumpList for the application. Only applicable in Windows OS.
519
519
  * If categories is null the previously set custom JumpList (if any) will be replaced by the standard JumpList for the app (managed by Windows).
520
+ *
520
521
  * Note: If the "name" property is omitted it defaults to "tasks".
521
522
  * @param jumpListCategories An array of JumpList Categories to populate. If null, remove any existing JumpList configuration and set to Windows default.
522
523
  *
@@ -787,6 +788,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
787
788
  getProcessInfo(): Promise<OpenFin_2.AppProcessInfo>;
788
789
  /**
789
790
  * Sets file auto download location. It's only allowed in the same application.
791
+ *
790
792
  * Note: This method is restricted by default and must be enabled via
791
793
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
792
794
  * @param downloadLocation file auto download location
@@ -808,6 +810,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
808
810
  setFileDownloadLocation(downloadLocation: string): Promise<void>;
809
811
  /**
810
812
  * 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.
813
+ *
811
814
  * Note: This method is restricted by default and must be enabled via
812
815
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
813
816
  *
@@ -867,7 +870,7 @@ declare type ApplicationEvent = {
867
870
  topic: 'application';
868
871
  } & (PropagatedViewEvent | PropagatedWindowEvent | ApplicationWindowEvent | WillPropagateApplicationEvent);
869
872
 
870
- declare type ApplicationEvent_2 = ApplicationEvents.ApplicationEvent;
873
+ declare type ApplicationEvent_2 = Events.ApplicationEvents.ApplicationEvent;
871
874
 
872
875
  declare namespace ApplicationEvents {
873
876
  export {
@@ -1206,6 +1209,7 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1206
1209
  * @defaultValue false
1207
1210
  *
1208
1211
  * **Platforms Only.** Prevent the Platform Provider from quitting automatically when the last Platform Window is closed.
1212
+ *
1209
1213
  * Note: if the Platform Provider is showing, it won't close automatically.
1210
1214
  * If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.
1211
1215
  */
@@ -1626,7 +1630,7 @@ declare type BaseEvent = {
1626
1630
  type: string;
1627
1631
  };
1628
1632
 
1629
- declare type BaseEvent_2 = BaseEvents.BaseEvent;
1633
+ declare type BaseEvent_2 = Events.BaseEvents.BaseEvent;
1630
1634
 
1631
1635
  declare namespace BaseEvents {
1632
1636
  export {
@@ -3214,8 +3218,9 @@ declare type ConstWindowOptions = {
3214
3218
  closeOnLastViewRemoved: boolean;
3215
3219
  /**
3216
3220
  * Centers the window in the primary monitor. This option overrides `defaultLeft` and `defaultTop`. When `saveWindowState` is `true`,
3217
- * this value will be ignored for subsequent launches in favor of the cached value. **NOTE:** On macOS _defaultCenter_ is
3218
- * somewhat above center vertically.
3221
+ * this value will be ignored for subsequent launches in favor of the cached value.
3222
+ *
3223
+ * **NOTE:** On macOS _defaultCenter_ is somewhat above center vertically.
3219
3224
  */
3220
3225
  defaultCentered: boolean;
3221
3226
  /**
@@ -3277,6 +3282,7 @@ declare type ConstWindowOptions = {
3277
3282
  * @defaultValue true
3278
3283
  *
3279
3284
  * Caches the location of the window.
3285
+ *
3280
3286
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3281
3287
  */
3282
3288
  saveWindowState: boolean;
@@ -3289,7 +3295,8 @@ declare type ConstWindowOptions = {
3289
3295
  * @defaultValue false
3290
3296
  *
3291
3297
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3292
- * _Note: Caveats of small windows are no Aero Snap and drag to/from maximize._
3298
+ *
3299
+ * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3293
3300
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3294
3301
  */
3295
3302
  smallWindow: boolean;
@@ -3405,7 +3412,8 @@ declare type ContentCreationRulesEvent = NamedEvent & {
3405
3412
  frameName: string;
3406
3413
  /**
3407
3414
  * The rule which triggered this event. May be undefined on `child-window-created` where no rule corresponds to the child Window creation.
3408
- * <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.
3415
+ *
3416
+ * 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.
3409
3417
  */
3410
3418
  rule: OpenFin_2.ContentCreationRule;
3411
3419
  /**
@@ -3874,9 +3882,7 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3874
3882
  protected identity: ApplicationIdentity;
3875
3883
  constructor(wire: Transport, topic: string, ...additionalAccessors: string[]);
3876
3884
  eventNames: () => (string | symbol)[];
3877
- emit: <EventType extends EmitterEventType>(eventType: EventType, payload: Extract<EmitterEvent, {
3878
- type: EventType;
3879
- }>, ...args: any[]) => boolean;
3885
+ /* Excluded from this release type: emit */
3880
3886
  private hasEmitter;
3881
3887
  private getOrCreateEmitter;
3882
3888
  listeners: (type: string | symbol) => Function[];
@@ -3885,6 +3891,8 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3885
3891
  protected deregisterEventListener: (eventType: EmitterEventType, options?: OpenFin_2.SubscriptionOptions) => Promise<void | EventEmitter>;
3886
3892
  /**
3887
3893
  * Adds a listener to the end of the listeners array for the specified event.
3894
+ *
3895
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3888
3896
  */
3889
3897
  on<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3890
3898
  /**
@@ -3893,15 +3901,21 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3893
3901
  addListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3894
3902
  /**
3895
3903
  * 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.
3904
+ *
3905
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3896
3906
  */
3897
3907
  once<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3898
3908
  /**
3899
3909
  * Adds a listener to the beginning of the listeners array for the specified event.
3910
+ *
3911
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3900
3912
  */
3901
3913
  prependListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3902
3914
  /**
3903
3915
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
3904
3916
  * after which it is removed. The listener is added to the beginning of the listeners array.
3917
+ *
3918
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3905
3919
  */
3906
3920
  prependOnceListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3907
3921
  /**
@@ -4060,6 +4074,21 @@ declare type EventHandler<EmitterEvent extends BaseEvent, EventType extends stri
4060
4074
  type: EventType;
4061
4075
  }>, ...args: any[]) => void;
4062
4076
 
4077
+ declare namespace Events {
4078
+ export {
4079
+ ApplicationEvents,
4080
+ BaseEvents,
4081
+ ExternalApplicationEvents,
4082
+ FrameEvents,
4083
+ GlobalHotkeyEvents,
4084
+ PlatformEvents,
4085
+ SystemEvents,
4086
+ ViewEvents,
4087
+ WebContentsEvents,
4088
+ WindowEvents
4089
+ }
4090
+ }
4091
+
4063
4092
  /* Excluded from this release type: EventWithId */
4064
4093
 
4065
4094
  /* Excluded from this release type: ExcludeRequested */
@@ -4207,7 +4236,7 @@ declare type ExternalApplicationEvent = {
4207
4236
  topic: 'externalapplication';
4208
4237
  } & (ExternalApplicationConnectedEvent | ExternalApplicationDisconnectedEvent);
4209
4238
 
4210
- declare type ExternalApplicationEvent_2 = ExternalApplicationEvents.ExternalApplicationEvent;
4239
+ declare type ExternalApplicationEvent_2 = Events.ExternalApplicationEvents.ExternalApplicationEvent;
4211
4240
 
4212
4241
  declare namespace ExternalApplicationEvents {
4213
4242
  export {
@@ -4702,7 +4731,7 @@ declare type FrameEvent = {
4702
4731
  topic: 'frame';
4703
4732
  } & (FrameConnectedEvent | FrameDisconnectedEvent);
4704
4733
 
4705
- declare type FrameEvent_2 = FrameEvents.FrameEvent;
4734
+ declare type FrameEvent_2 = Events.FrameEvents.FrameEvent;
4706
4735
 
4707
4736
  declare namespace FrameEvents {
4708
4737
  export {
@@ -4945,7 +4974,7 @@ declare type GlobalHotkeyEvent = {
4945
4974
  hotkey: 'string';
4946
4975
  } & (RegisteredEvent | UnregisteredEvent);
4947
4976
 
4948
- declare type GlobalHotkeyEvent_2 = GlobalHotkeyEvents.GlobalHotkeyEvent;
4977
+ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
4949
4978
 
4950
4979
  declare namespace GlobalHotkeyEvents {
4951
4980
  export {
@@ -7089,6 +7118,7 @@ declare type LayoutItemConfig = {
7089
7118
  };
7090
7119
 
7091
7120
  declare class LayoutManager {
7121
+ #private;
7092
7122
  private readonly splitterController;
7093
7123
  private readonly tabDragController;
7094
7124
  private readonly layoutContentCache;
@@ -7981,8 +8011,9 @@ declare type MutableWindowOptions = {
7981
8011
  hotkeys: Hotkey[];
7982
8012
  /**
7983
8013
  * A URL for the icon to be shown in the window title bar and the taskbar.
7984
- * When omitted, inherits from the parent application._
7985
- * note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
8014
+ * When omitted, inherits from the parent application.
8015
+ *
8016
+ * Note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
7986
8017
  */
7987
8018
  icon: string;
7988
8019
  /**
@@ -8161,6 +8192,7 @@ declare namespace OpenFin_2 {
8161
8192
  ExternalApplicationModule,
8162
8193
  _Frame as Frame,
8163
8194
  _FrameModule,
8195
+ GlobalHotkey,
8164
8196
  Channel,
8165
8197
  ChannelClient,
8166
8198
  ChannelProvider,
@@ -8179,6 +8211,7 @@ declare namespace OpenFin_2 {
8179
8211
  InteropModule,
8180
8212
  SnapshotSource,
8181
8213
  SnapshotSourceModule,
8214
+ System,
8182
8215
  LayoutEntityDefinition,
8183
8216
  LayoutEntityTypes,
8184
8217
  LayoutPosition,
@@ -8430,16 +8463,7 @@ declare namespace OpenFin_2 {
8430
8463
  AppVersionErrorEvent,
8431
8464
  AppVersionCompleteEvent,
8432
8465
  AppVersionRuntimeStatusEvent,
8433
- BaseEvents,
8434
- WebContentsEvents,
8435
- SystemEvents,
8436
- ApplicationEvents,
8437
- WindowEvents,
8438
- ViewEvents,
8439
- GlobalHotkeyEvents,
8440
- FrameEvents,
8441
- PlatformEvents,
8442
- ExternalApplicationEvents,
8466
+ Events,
8443
8467
  BaseEvent_2 as BaseEvent,
8444
8468
  WebContentsEvent_2 as WebContentsEvent,
8445
8469
  SystemEvent_2 as SystemEvent,
@@ -8464,7 +8488,17 @@ declare namespace OpenFin_2 {
8464
8488
  ChannelClientConnectionListener,
8465
8489
  ChannelClientDisconnectionListener,
8466
8490
  ChannelProviderDisconnectionListener,
8467
- RoutingInfo
8491
+ RoutingInfo,
8492
+ ApplicationEvents,
8493
+ BaseEvents,
8494
+ ExternalApplicationEvents,
8495
+ FrameEvents,
8496
+ GlobalHotkeyEvents,
8497
+ PlatformEvents,
8498
+ SystemEvents,
8499
+ ViewEvents,
8500
+ WebContentsEvents,
8501
+ WindowEvents
8468
8502
  }
8469
8503
  }
8470
8504
  export default OpenFin_2;
@@ -8521,10 +8555,8 @@ declare type PickOfType<T extends Record<any, any>, TTarget> = {
8521
8555
 
8522
8556
  /** Manages the life cycle of windows and views in the application.
8523
8557
  *
8524
- * Enables taking snapshots of itself and applyi
8525
- * ng them to restore a previous configuration
8558
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
8526
8559
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
8527
- *
8528
8560
  */
8529
8561
  declare class Platform extends EmitterBase<OpenFin_2.PlatformEvent> {
8530
8562
  #private;
@@ -9153,7 +9185,7 @@ declare type PlatformApiReadyEvent = BaseEvent & {
9153
9185
  */
9154
9186
  declare type PlatformEvent = ApplicationEvent | PlatformApiReadyEvent | PlatformSnapshotAppliedEvent;
9155
9187
 
9156
- declare type PlatformEvent_2 = PlatformEvents.PlatformEvent;
9188
+ declare type PlatformEvent_2 = Events.PlatformEvents.PlatformEvent;
9157
9189
 
9158
9190
  declare namespace PlatformEvents {
9159
9191
  export {
@@ -9962,7 +9994,8 @@ declare type PopupOptions = {
9962
9994
  resultDispatchBehavior?: PopupResultBehavior;
9963
9995
  /**
9964
9996
  * Hide the popup window instead of closing when `close` is called on it.
9965
- * <br>Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
9997
+ *
9998
+ * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
9966
9999
  * @defaultValue false
9967
10000
  */
9968
10001
  hideOnClose?: boolean;
@@ -9977,7 +10010,8 @@ declare type PopupOptions = {
9977
10010
  onPopupReady?: (popupWindow: _Window) => any;
9978
10011
  /**
9979
10012
  * Executed when this window's popup calls `dispatchPopupResult`.
9980
- * <br>Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
10013
+ *
10014
+ * Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
9981
10015
  */
9982
10016
  onPopupResult?: (payload: PopupResult) => any;
9983
10017
  };
@@ -12299,7 +12333,8 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
12299
12333
  showDeveloperTools(identity: Identity_2): Promise<void>;
12300
12334
  /**
12301
12335
  * Attempt to close an external process. The process will be terminated if it
12302
- * has not closed after the elapsed timeout in milliseconds.<br>
12336
+ * has not closed after the elapsed timeout in milliseconds.
12337
+ *
12303
12338
  * Note: This method is restricted by default and must be enabled via
12304
12339
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12305
12340
  * @param options A object defined in the TerminateExternalRequestType interface
@@ -12331,7 +12366,8 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
12331
12366
  */
12332
12367
  updateProxySettings(options: ProxyConfig): Promise<void>;
12333
12368
  /**
12334
- * Downloads the given application asset<br>
12369
+ * Downloads the given application asset.
12370
+ *
12335
12371
  * Note: This method is restricted by default and must be enabled via
12336
12372
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12337
12373
  * @param appAsset App asset object
@@ -12900,7 +12936,7 @@ declare type SystemEvent = {
12900
12936
  topic: 'system';
12901
12937
  } & (ExcludeRequested<PropagatedWindowEvent> | PropagatedViewEvent | PropagatedApplicationEvent | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleEvent | MonitorEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent);
12902
12938
 
12903
- declare type SystemEvent_2 = SystemEvents.SystemEvent;
12939
+ declare type SystemEvent_2 = Events.SystemEvents.SystemEvent;
12904
12940
 
12905
12941
  declare namespace SystemEvents {
12906
12942
  export {
@@ -14035,7 +14071,7 @@ declare type ViewEvent = {
14035
14071
  topic: 'view';
14036
14072
  } & (NonPropagatedViewEvent | WillPropagateViewEvent);
14037
14073
 
14038
- declare type ViewEvent_2 = ViewEvents.ViewEvent;
14074
+ declare type ViewEvent_2 = Events.ViewEvents.ViewEvent;
14039
14075
 
14040
14076
  declare namespace ViewEvents {
14041
14077
  export {
@@ -14468,7 +14504,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14468
14504
  /**
14469
14505
  * Navigates the WebContents to a specified URL.
14470
14506
  *
14471
- * @remarks The url must contain the protocol prefix such as http:// or https://.
14507
+ * Note: The url must contain the protocol prefix such as http:// or https://.
14472
14508
  * @param url - The URL to navigate the WebContents to.
14473
14509
  *
14474
14510
  * @example
@@ -14636,7 +14672,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14636
14672
  * Prints the WebContents.
14637
14673
  * @param options Printer Options
14638
14674
  *
14639
- * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
14675
+ * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
14640
14676
  * is empty and the default settings for printing.
14641
14677
  *
14642
14678
  * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -14660,7 +14696,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14660
14696
  * @param searchTerm Term to find in page
14661
14697
  * @param options Search options
14662
14698
  *
14663
- * @remarks By default, each subsequent call will highlight the next text that matches the search term.
14699
+ * Note: By default, each subsequent call will highlight the next text that matches the search term.
14664
14700
  *
14665
14701
  * Returns a promise with the results for the request. By subscribing to the
14666
14702
  * found-in-page event, you can get the results of this call as well.
@@ -14850,7 +14886,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14850
14886
  /**
14851
14887
  * Retrieves the process information associated with a WebContents.
14852
14888
  *
14853
- * @remarks This includes any iframes associated with the WebContents
14889
+ * Note: This includes any iframes associated with the WebContents
14854
14890
  *
14855
14891
  * @example
14856
14892
  * View:
@@ -15020,7 +15056,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15020
15056
  /**
15021
15057
  * Shows a popup window.
15022
15058
  *
15023
- * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
15059
+ * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
15024
15060
  *
15025
15061
  * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
15026
15062
  * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -15028,7 +15064,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15028
15064
  * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
15029
15065
  * will be dismissed.
15030
15066
  *
15031
- * 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.
15067
+ * 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.
15032
15068
  *
15033
15069
  * @example
15034
15070
  *
@@ -15236,7 +15272,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15236
15272
  */
15237
15273
  declare type WebContentsEvent = NonPropagatedWebContentsEvent | WillPropagateWebContentsEvent;
15238
15274
 
15239
- declare type WebContentsEvent_2 = WebContentsEvents.WebContentsEvent;
15275
+ declare type WebContentsEvent_2 = Events.WebContentsEvents.WebContentsEvent;
15240
15276
 
15241
15277
  declare namespace WebContentsEvents {
15242
15278
  export {
@@ -16993,7 +17029,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16993
17029
  topic: 'window';
16994
17030
  } & (WillPropagateWindowEvent | NonPropagatedWindowEvent | PropagatedViewEvent);
16995
17031
 
16996
- declare type WindowEvent_2 = WindowEvents.WindowEvent;
17032
+ declare type WindowEvent_2 = Events.WindowEvents.WindowEvent;
16997
17033
 
16998
17034
  declare namespace WindowEvents {
16999
17035
  export {