@openfin/node-adapter 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.
@@ -523,6 +523,7 @@ declare class Application extends EmitterBase<OpenFin.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.ApplicationEvent> {
793
794
  getProcessInfo(): Promise<OpenFin.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.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 {
@@ -3312,8 +3316,9 @@ declare type ConstWindowOptions = {
3312
3316
  closeOnLastViewRemoved: boolean;
3313
3317
  /**
3314
3318
  * Centers the window in the primary monitor. This option overrides `defaultLeft` and `defaultTop`. When `saveWindowState` is `true`,
3315
- * this value will be ignored for subsequent launches in favor of the cached value. **NOTE:** On macOS _defaultCenter_ is
3316
- * somewhat above center vertically.
3319
+ * this value will be ignored for subsequent launches in favor of the cached value.
3320
+ *
3321
+ * **NOTE:** On macOS _defaultCenter_ is somewhat above center vertically.
3317
3322
  */
3318
3323
  defaultCentered: boolean;
3319
3324
  /**
@@ -3375,6 +3380,7 @@ declare type ConstWindowOptions = {
3375
3380
  * @defaultValue true
3376
3381
  *
3377
3382
  * Caches the location of the window.
3383
+ *
3378
3384
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3379
3385
  */
3380
3386
  saveWindowState: boolean;
@@ -3387,7 +3393,8 @@ declare type ConstWindowOptions = {
3387
3393
  * @defaultValue false
3388
3394
  *
3389
3395
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3390
- * _Note: Caveats of small windows are no Aero Snap and drag to/from maximize._
3396
+ *
3397
+ * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3391
3398
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3392
3399
  */
3393
3400
  smallWindow: boolean;
@@ -3503,7 +3510,8 @@ declare type ContentCreationRulesEvent = NamedEvent & {
3503
3510
  frameName: string;
3504
3511
  /**
3505
3512
  * The rule which triggered this event. May be undefined on `child-window-created` where no rule corresponds to the child Window creation.
3506
- * <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.
3513
+ *
3514
+ * 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.
3507
3515
  */
3508
3516
  rule: OpenFin.ContentCreationRule;
3509
3517
  /**
@@ -3972,6 +3980,9 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3972
3980
  protected identity: ApplicationIdentity;
3973
3981
  constructor(wire: Transport, topic: string, ...additionalAccessors: string[]);
3974
3982
  eventNames: () => (string | symbol)[];
3983
+ /**
3984
+ * @internal
3985
+ */
3975
3986
  emit: <EventType extends EmitterEventType>(eventType: EventType, payload: Extract<EmitterEvent, {
3976
3987
  type: EventType;
3977
3988
  }>, ...args: any[]) => boolean;
@@ -3983,6 +3994,8 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3983
3994
  protected deregisterEventListener: (eventType: EmitterEventType, options?: OpenFin.SubscriptionOptions) => Promise<void | EventEmitter>;
3984
3995
  /**
3985
3996
  * Adds a listener to the end of the listeners array for the specified event.
3997
+ *
3998
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3986
3999
  */
3987
4000
  on<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3988
4001
  /**
@@ -3991,15 +4004,21 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3991
4004
  addListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3992
4005
  /**
3993
4006
  * 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.
4007
+ *
4008
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3994
4009
  */
3995
4010
  once<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3996
4011
  /**
3997
4012
  * Adds a listener to the beginning of the listeners array for the specified event.
4013
+ *
4014
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3998
4015
  */
3999
4016
  prependListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
4000
4017
  /**
4001
4018
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
4002
4019
  * after which it is removed. The listener is added to the beginning of the listeners array.
4020
+ *
4021
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
4003
4022
  */
4004
4023
  prependOnceListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
4005
4024
  /**
@@ -4158,6 +4177,21 @@ declare type EventHandler<EmitterEvent extends BaseEvent, EventType extends stri
4158
4177
  type: EventType;
4159
4178
  }>, ...args: any[]) => void;
4160
4179
 
4180
+ declare namespace Events {
4181
+ export {
4182
+ ApplicationEvents,
4183
+ BaseEvents,
4184
+ ExternalApplicationEvents,
4185
+ FrameEvents,
4186
+ GlobalHotkeyEvents,
4187
+ PlatformEvents,
4188
+ SystemEvents,
4189
+ ViewEvents,
4190
+ WebContentsEvents,
4191
+ WindowEvents
4192
+ }
4193
+ }
4194
+
4161
4195
  /**
4162
4196
  * @internal
4163
4197
  */
@@ -4324,7 +4358,7 @@ declare type ExternalApplicationEvent = {
4324
4358
  topic: 'externalapplication';
4325
4359
  } & (ExternalApplicationConnectedEvent | ExternalApplicationDisconnectedEvent);
4326
4360
 
4327
- declare type ExternalApplicationEvent_2 = ExternalApplicationEvents.ExternalApplicationEvent;
4361
+ declare type ExternalApplicationEvent_2 = Events.ExternalApplicationEvents.ExternalApplicationEvent;
4328
4362
 
4329
4363
  declare namespace ExternalApplicationEvents {
4330
4364
  export {
@@ -4848,7 +4882,7 @@ declare type FrameEvent = {
4848
4882
  topic: 'frame';
4849
4883
  } & (FrameConnectedEvent | FrameDisconnectedEvent);
4850
4884
 
4851
- declare type FrameEvent_2 = FrameEvents.FrameEvent;
4885
+ declare type FrameEvent_2 = Events.FrameEvents.FrameEvent;
4852
4886
 
4853
4887
  declare namespace FrameEvents {
4854
4888
  export {
@@ -5094,7 +5128,7 @@ declare type GlobalHotkeyEvent = {
5094
5128
  hotkey: 'string';
5095
5129
  } & (RegisteredEvent | UnregisteredEvent);
5096
5130
 
5097
- declare type GlobalHotkeyEvent_2 = GlobalHotkeyEvents.GlobalHotkeyEvent;
5131
+ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
5098
5132
 
5099
5133
  declare namespace GlobalHotkeyEvents {
5100
5134
  export {
@@ -7381,6 +7415,7 @@ declare type LayoutItemConfig = {
7381
7415
  };
7382
7416
 
7383
7417
  declare class LayoutManager {
7418
+ #private;
7384
7419
  private readonly splitterController;
7385
7420
  private readonly tabDragController;
7386
7421
  private readonly layoutContentCache;
@@ -8438,8 +8473,9 @@ declare type MutableWindowOptions = {
8438
8473
  hotkeys: Hotkey[];
8439
8474
  /**
8440
8475
  * A URL for the icon to be shown in the window title bar and the taskbar.
8441
- * When omitted, inherits from the parent application._
8442
- * note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
8476
+ * When omitted, inherits from the parent application.
8477
+ *
8478
+ * Note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
8443
8479
  */
8444
8480
  icon: string;
8445
8481
  /**
@@ -8625,6 +8661,7 @@ declare namespace OpenFin {
8625
8661
  ExternalApplicationModule,
8626
8662
  _Frame as Frame,
8627
8663
  _FrameModule,
8664
+ GlobalHotkey,
8628
8665
  Channel,
8629
8666
  ChannelClient,
8630
8667
  ChannelProvider,
@@ -8643,6 +8680,7 @@ declare namespace OpenFin {
8643
8680
  InteropModule,
8644
8681
  SnapshotSource,
8645
8682
  SnapshotSourceModule,
8683
+ System,
8646
8684
  LayoutEntityDefinition,
8647
8685
  LayoutEntityTypes,
8648
8686
  LayoutPosition,
@@ -8894,16 +8932,7 @@ declare namespace OpenFin {
8894
8932
  AppVersionErrorEvent,
8895
8933
  AppVersionCompleteEvent,
8896
8934
  AppVersionRuntimeStatusEvent,
8897
- BaseEvents,
8898
- WebContentsEvents,
8899
- SystemEvents,
8900
- ApplicationEvents,
8901
- WindowEvents,
8902
- ViewEvents,
8903
- GlobalHotkeyEvents,
8904
- FrameEvents,
8905
- PlatformEvents,
8906
- ExternalApplicationEvents,
8935
+ Events,
8907
8936
  BaseEvent_2 as BaseEvent,
8908
8937
  WebContentsEvent_2 as WebContentsEvent,
8909
8938
  SystemEvent_2 as SystemEvent,
@@ -8928,7 +8957,17 @@ declare namespace OpenFin {
8928
8957
  ChannelClientConnectionListener,
8929
8958
  ChannelClientDisconnectionListener,
8930
8959
  ChannelProviderDisconnectionListener,
8931
- RoutingInfo
8960
+ RoutingInfo,
8961
+ ApplicationEvents,
8962
+ BaseEvents,
8963
+ ExternalApplicationEvents,
8964
+ FrameEvents,
8965
+ GlobalHotkeyEvents,
8966
+ PlatformEvents,
8967
+ SystemEvents,
8968
+ ViewEvents,
8969
+ WebContentsEvents,
8970
+ WindowEvents
8932
8971
  }
8933
8972
  }
8934
8973
  export default OpenFin;
@@ -8985,10 +9024,8 @@ declare type PickOfType<T extends Record<any, any>, TTarget> = {
8985
9024
 
8986
9025
  /** Manages the life cycle of windows and views in the application.
8987
9026
  *
8988
- * Enables taking snapshots of itself and applyi
8989
- * ng them to restore a previous configuration
9027
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
8990
9028
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
8991
- *
8992
9029
  */
8993
9030
  declare class Platform extends EmitterBase<OpenFin.PlatformEvent> {
8994
9031
  #private;
@@ -9647,7 +9684,7 @@ declare type PlatformApiReadyEvent = BaseEvent & {
9647
9684
  */
9648
9685
  declare type PlatformEvent = ApplicationEvent | PlatformApiReadyEvent | PlatformSnapshotAppliedEvent;
9649
9686
 
9650
- declare type PlatformEvent_2 = PlatformEvents.PlatformEvent;
9687
+ declare type PlatformEvent_2 = Events.PlatformEvents.PlatformEvent;
9651
9688
 
9652
9689
  declare namespace PlatformEvents {
9653
9690
  export {
@@ -10495,7 +10532,8 @@ declare type PopupOptions = {
10495
10532
  resultDispatchBehavior?: PopupResultBehavior;
10496
10533
  /**
10497
10534
  * Hide the popup window instead of closing when `close` is called on it.
10498
- * <br>Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
10535
+ *
10536
+ * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
10499
10537
  * @defaultValue false
10500
10538
  */
10501
10539
  hideOnClose?: boolean;
@@ -10510,7 +10548,8 @@ declare type PopupOptions = {
10510
10548
  onPopupReady?: (popupWindow: _Window) => any;
10511
10549
  /**
10512
10550
  * Executed when this window's popup calls `dispatchPopupResult`.
10513
- * <br>Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
10551
+ *
10552
+ * Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
10514
10553
  */
10515
10554
  onPopupResult?: (payload: PopupResult) => any;
10516
10555
  };
@@ -12838,7 +12877,8 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
12838
12877
  showDeveloperTools(identity: Identity_2): Promise<void>;
12839
12878
  /**
12840
12879
  * Attempt to close an external process. The process will be terminated if it
12841
- * has not closed after the elapsed timeout in milliseconds.<br>
12880
+ * has not closed after the elapsed timeout in milliseconds.
12881
+ *
12842
12882
  * Note: This method is restricted by default and must be enabled via
12843
12883
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12844
12884
  * @param options A object defined in the TerminateExternalRequestType interface
@@ -12870,7 +12910,8 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
12870
12910
  */
12871
12911
  updateProxySettings(options: ProxyConfig): Promise<void>;
12872
12912
  /**
12873
- * Downloads the given application asset<br>
12913
+ * Downloads the given application asset.
12914
+ *
12874
12915
  * Note: This method is restricted by default and must be enabled via
12875
12916
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12876
12917
  * @param appAsset App asset object
@@ -13439,7 +13480,7 @@ declare type SystemEvent = {
13439
13480
  topic: 'system';
13440
13481
  } & (ExcludeRequested<PropagatedWindowEvent> | PropagatedViewEvent | PropagatedApplicationEvent | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleEvent | MonitorEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent);
13441
13482
 
13442
- declare type SystemEvent_2 = SystemEvents.SystemEvent;
13483
+ declare type SystemEvent_2 = Events.SystemEvents.SystemEvent;
13443
13484
 
13444
13485
  declare namespace SystemEvents {
13445
13486
  export {
@@ -14668,7 +14709,7 @@ declare type ViewEvent = {
14668
14709
  topic: 'view';
14669
14710
  } & (NonPropagatedViewEvent | WillPropagateViewEvent);
14670
14711
 
14671
- declare type ViewEvent_2 = ViewEvents.ViewEvent;
14712
+ declare type ViewEvent_2 = Events.ViewEvents.ViewEvent;
14672
14713
 
14673
14714
  declare namespace ViewEvents {
14674
14715
  export {
@@ -15101,7 +15142,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15101
15142
  /**
15102
15143
  * Navigates the WebContents to a specified URL.
15103
15144
  *
15104
- * @remarks The url must contain the protocol prefix such as http:// or https://.
15145
+ * Note: The url must contain the protocol prefix such as http:// or https://.
15105
15146
  * @param url - The URL to navigate the WebContents to.
15106
15147
  *
15107
15148
  * @example
@@ -15269,7 +15310,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15269
15310
  * Prints the WebContents.
15270
15311
  * @param options Printer Options
15271
15312
  *
15272
- * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
15313
+ * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
15273
15314
  * is empty and the default settings for printing.
15274
15315
  *
15275
15316
  * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -15293,7 +15334,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15293
15334
  * @param searchTerm Term to find in page
15294
15335
  * @param options Search options
15295
15336
  *
15296
- * @remarks By default, each subsequent call will highlight the next text that matches the search term.
15337
+ * Note: By default, each subsequent call will highlight the next text that matches the search term.
15297
15338
  *
15298
15339
  * Returns a promise with the results for the request. By subscribing to the
15299
15340
  * found-in-page event, you can get the results of this call as well.
@@ -15483,7 +15524,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15483
15524
  /**
15484
15525
  * Retrieves the process information associated with a WebContents.
15485
15526
  *
15486
- * @remarks This includes any iframes associated with the WebContents
15527
+ * Note: This includes any iframes associated with the WebContents
15487
15528
  *
15488
15529
  * @example
15489
15530
  * View:
@@ -15653,7 +15694,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15653
15694
  /**
15654
15695
  * Shows a popup window.
15655
15696
  *
15656
- * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
15697
+ * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
15657
15698
  *
15658
15699
  * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
15659
15700
  * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -15661,7 +15702,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15661
15702
  * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
15662
15703
  * will be dismissed.
15663
15704
  *
15664
- * 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.
15705
+ * 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.
15665
15706
  *
15666
15707
  * @example
15667
15708
  *
@@ -15869,7 +15910,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15869
15910
  */
15870
15911
  declare type WebContentsEvent = NonPropagatedWebContentsEvent | WillPropagateWebContentsEvent;
15871
15912
 
15872
- declare type WebContentsEvent_2 = WebContentsEvents.WebContentsEvent;
15913
+ declare type WebContentsEvent_2 = Events.WebContentsEvents.WebContentsEvent;
15873
15914
 
15874
15915
  declare namespace WebContentsEvents {
15875
15916
  export {
@@ -17710,7 +17751,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
17710
17751
  topic: 'window';
17711
17752
  } & (WillPropagateWindowEvent | NonPropagatedWindowEvent | PropagatedViewEvent);
17712
17753
 
17713
- declare type WindowEvent_2 = WindowEvents.WindowEvent;
17754
+ declare type WindowEvent_2 = Events.WindowEvents.WindowEvent;
17714
17755
 
17715
17756
  declare namespace WindowEvents {
17716
17757
  export {