@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.
@@ -517,6 +517,7 @@ declare class Application extends EmitterBase<OpenFin.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.ApplicationEvent> {
787
788
  getProcessInfo(): Promise<OpenFin.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.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 {
@@ -3218,8 +3222,9 @@ declare type ConstWindowOptions = {
3218
3222
  closeOnLastViewRemoved: boolean;
3219
3223
  /**
3220
3224
  * Centers the window in the primary monitor. This option overrides `defaultLeft` and `defaultTop`. When `saveWindowState` is `true`,
3221
- * this value will be ignored for subsequent launches in favor of the cached value. **NOTE:** On macOS _defaultCenter_ is
3222
- * somewhat above center vertically.
3225
+ * this value will be ignored for subsequent launches in favor of the cached value.
3226
+ *
3227
+ * **NOTE:** On macOS _defaultCenter_ is somewhat above center vertically.
3223
3228
  */
3224
3229
  defaultCentered: boolean;
3225
3230
  /**
@@ -3281,6 +3286,7 @@ declare type ConstWindowOptions = {
3281
3286
  * @defaultValue true
3282
3287
  *
3283
3288
  * Caches the location of the window.
3289
+ *
3284
3290
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3285
3291
  */
3286
3292
  saveWindowState: boolean;
@@ -3293,7 +3299,8 @@ declare type ConstWindowOptions = {
3293
3299
  * @defaultValue false
3294
3300
  *
3295
3301
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3296
- * _Note: Caveats of small windows are no Aero Snap and drag to/from maximize._
3302
+ *
3303
+ * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3297
3304
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3298
3305
  */
3299
3306
  smallWindow: boolean;
@@ -3409,7 +3416,8 @@ declare type ContentCreationRulesEvent = NamedEvent & {
3409
3416
  frameName: string;
3410
3417
  /**
3411
3418
  * The rule which triggered this event. May be undefined on `child-window-created` where no rule corresponds to the child Window creation.
3412
- * <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.
3419
+ *
3420
+ * 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.
3413
3421
  */
3414
3422
  rule: OpenFin.ContentCreationRule;
3415
3423
  /**
@@ -3878,9 +3886,7 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3878
3886
  protected identity: ApplicationIdentity;
3879
3887
  constructor(wire: Transport, topic: string, ...additionalAccessors: string[]);
3880
3888
  eventNames: () => (string | symbol)[];
3881
- emit: <EventType extends EmitterEventType>(eventType: EventType, payload: Extract<EmitterEvent, {
3882
- type: EventType;
3883
- }>, ...args: any[]) => boolean;
3889
+ /* Excluded from this release type: emit */
3884
3890
  private hasEmitter;
3885
3891
  private getOrCreateEmitter;
3886
3892
  listeners: (type: string | symbol) => Function[];
@@ -3889,6 +3895,8 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3889
3895
  protected deregisterEventListener: (eventType: EmitterEventType, options?: OpenFin.SubscriptionOptions) => Promise<void | EventEmitter>;
3890
3896
  /**
3891
3897
  * Adds a listener to the end of the listeners array for the specified event.
3898
+ *
3899
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3892
3900
  */
3893
3901
  on<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3894
3902
  /**
@@ -3897,15 +3905,21 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3897
3905
  addListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3898
3906
  /**
3899
3907
  * 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.
3908
+ *
3909
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3900
3910
  */
3901
3911
  once<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3902
3912
  /**
3903
3913
  * Adds a listener to the beginning of the listeners array for the specified event.
3914
+ *
3915
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3904
3916
  */
3905
3917
  prependListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3906
3918
  /**
3907
3919
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
3908
3920
  * after which it is removed. The listener is added to the beginning of the listeners array.
3921
+ *
3922
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
3909
3923
  */
3910
3924
  prependOnceListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin.SubscriptionOptions): Promise<this>;
3911
3925
  /**
@@ -4064,6 +4078,21 @@ declare type EventHandler<EmitterEvent extends BaseEvent, EventType extends stri
4064
4078
  type: EventType;
4065
4079
  }>, ...args: any[]) => void;
4066
4080
 
4081
+ declare namespace Events {
4082
+ export {
4083
+ ApplicationEvents,
4084
+ BaseEvents,
4085
+ ExternalApplicationEvents,
4086
+ FrameEvents,
4087
+ GlobalHotkeyEvents,
4088
+ PlatformEvents,
4089
+ SystemEvents,
4090
+ ViewEvents,
4091
+ WebContentsEvents,
4092
+ WindowEvents
4093
+ }
4094
+ }
4095
+
4067
4096
  /* Excluded from this release type: EventWithId */
4068
4097
 
4069
4098
  /* Excluded from this release type: ExcludeRequested */
@@ -4211,7 +4240,7 @@ declare type ExternalApplicationEvent = {
4211
4240
  topic: 'externalapplication';
4212
4241
  } & (ExternalApplicationConnectedEvent | ExternalApplicationDisconnectedEvent);
4213
4242
 
4214
- declare type ExternalApplicationEvent_2 = ExternalApplicationEvents.ExternalApplicationEvent;
4243
+ declare type ExternalApplicationEvent_2 = Events.ExternalApplicationEvents.ExternalApplicationEvent;
4215
4244
 
4216
4245
  declare namespace ExternalApplicationEvents {
4217
4246
  export {
@@ -4710,7 +4739,7 @@ declare type FrameEvent = {
4710
4739
  topic: 'frame';
4711
4740
  } & (FrameConnectedEvent | FrameDisconnectedEvent);
4712
4741
 
4713
- declare type FrameEvent_2 = FrameEvents.FrameEvent;
4742
+ declare type FrameEvent_2 = Events.FrameEvents.FrameEvent;
4714
4743
 
4715
4744
  declare namespace FrameEvents {
4716
4745
  export {
@@ -4953,7 +4982,7 @@ declare type GlobalHotkeyEvent = {
4953
4982
  hotkey: 'string';
4954
4983
  } & (RegisteredEvent | UnregisteredEvent);
4955
4984
 
4956
- declare type GlobalHotkeyEvent_2 = GlobalHotkeyEvents.GlobalHotkeyEvent;
4985
+ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
4957
4986
 
4958
4987
  declare namespace GlobalHotkeyEvents {
4959
4988
  export {
@@ -7099,6 +7128,7 @@ declare type LayoutItemConfig = {
7099
7128
  };
7100
7129
 
7101
7130
  declare class LayoutManager {
7131
+ #private;
7102
7132
  private readonly splitterController;
7103
7133
  private readonly tabDragController;
7104
7134
  private readonly layoutContentCache;
@@ -7991,8 +8021,9 @@ declare type MutableWindowOptions = {
7991
8021
  hotkeys: Hotkey[];
7992
8022
  /**
7993
8023
  * A URL for the icon to be shown in the window title bar and the taskbar.
7994
- * When omitted, inherits from the parent application._
7995
- * note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
8024
+ * When omitted, inherits from the parent application.
8025
+ *
8026
+ * Note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
7996
8027
  */
7997
8028
  icon: string;
7998
8029
  /**
@@ -8171,6 +8202,7 @@ declare namespace OpenFin {
8171
8202
  ExternalApplicationModule,
8172
8203
  _Frame as Frame,
8173
8204
  _FrameModule,
8205
+ GlobalHotkey,
8174
8206
  Channel,
8175
8207
  ChannelClient,
8176
8208
  ChannelProvider,
@@ -8189,6 +8221,7 @@ declare namespace OpenFin {
8189
8221
  InteropModule,
8190
8222
  SnapshotSource,
8191
8223
  SnapshotSourceModule,
8224
+ System,
8192
8225
  LayoutEntityDefinition,
8193
8226
  LayoutEntityTypes,
8194
8227
  LayoutPosition,
@@ -8440,16 +8473,7 @@ declare namespace OpenFin {
8440
8473
  AppVersionErrorEvent,
8441
8474
  AppVersionCompleteEvent,
8442
8475
  AppVersionRuntimeStatusEvent,
8443
- BaseEvents,
8444
- WebContentsEvents,
8445
- SystemEvents,
8446
- ApplicationEvents,
8447
- WindowEvents,
8448
- ViewEvents,
8449
- GlobalHotkeyEvents,
8450
- FrameEvents,
8451
- PlatformEvents,
8452
- ExternalApplicationEvents,
8476
+ Events,
8453
8477
  BaseEvent_2 as BaseEvent,
8454
8478
  WebContentsEvent_2 as WebContentsEvent,
8455
8479
  SystemEvent_2 as SystemEvent,
@@ -8474,7 +8498,17 @@ declare namespace OpenFin {
8474
8498
  ChannelClientConnectionListener,
8475
8499
  ChannelClientDisconnectionListener,
8476
8500
  ChannelProviderDisconnectionListener,
8477
- RoutingInfo
8501
+ RoutingInfo,
8502
+ ApplicationEvents,
8503
+ BaseEvents,
8504
+ ExternalApplicationEvents,
8505
+ FrameEvents,
8506
+ GlobalHotkeyEvents,
8507
+ PlatformEvents,
8508
+ SystemEvents,
8509
+ ViewEvents,
8510
+ WebContentsEvents,
8511
+ WindowEvents
8478
8512
  }
8479
8513
  }
8480
8514
  export default OpenFin;
@@ -8531,10 +8565,8 @@ declare type PickOfType<T extends Record<any, any>, TTarget> = {
8531
8565
 
8532
8566
  /** Manages the life cycle of windows and views in the application.
8533
8567
  *
8534
- * Enables taking snapshots of itself and applyi
8535
- * ng them to restore a previous configuration
8568
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
8536
8569
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
8537
- *
8538
8570
  */
8539
8571
  declare class Platform extends EmitterBase<OpenFin.PlatformEvent> {
8540
8572
  #private;
@@ -9163,7 +9195,7 @@ declare type PlatformApiReadyEvent = BaseEvent & {
9163
9195
  */
9164
9196
  declare type PlatformEvent = ApplicationEvent | PlatformApiReadyEvent | PlatformSnapshotAppliedEvent;
9165
9197
 
9166
- declare type PlatformEvent_2 = PlatformEvents.PlatformEvent;
9198
+ declare type PlatformEvent_2 = Events.PlatformEvents.PlatformEvent;
9167
9199
 
9168
9200
  declare namespace PlatformEvents {
9169
9201
  export {
@@ -9972,7 +10004,8 @@ declare type PopupOptions = {
9972
10004
  resultDispatchBehavior?: PopupResultBehavior;
9973
10005
  /**
9974
10006
  * Hide the popup window instead of closing when `close` is called on it.
9975
- * <br>Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
10007
+ *
10008
+ * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
9976
10009
  * @defaultValue false
9977
10010
  */
9978
10011
  hideOnClose?: boolean;
@@ -9987,7 +10020,8 @@ declare type PopupOptions = {
9987
10020
  onPopupReady?: (popupWindow: _Window) => any;
9988
10021
  /**
9989
10022
  * Executed when this window's popup calls `dispatchPopupResult`.
9990
- * <br>Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
10023
+ *
10024
+ * Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
9991
10025
  */
9992
10026
  onPopupResult?: (payload: PopupResult) => any;
9993
10027
  };
@@ -12309,7 +12343,8 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
12309
12343
  showDeveloperTools(identity: Identity_2): Promise<void>;
12310
12344
  /**
12311
12345
  * Attempt to close an external process. The process will be terminated if it
12312
- * has not closed after the elapsed timeout in milliseconds.<br>
12346
+ * has not closed after the elapsed timeout in milliseconds.
12347
+ *
12313
12348
  * Note: This method is restricted by default and must be enabled via
12314
12349
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12315
12350
  * @param options A object defined in the TerminateExternalRequestType interface
@@ -12341,7 +12376,8 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
12341
12376
  */
12342
12377
  updateProxySettings(options: ProxyConfig): Promise<void>;
12343
12378
  /**
12344
- * Downloads the given application asset<br>
12379
+ * Downloads the given application asset.
12380
+ *
12345
12381
  * Note: This method is restricted by default and must be enabled via
12346
12382
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
12347
12383
  * @param appAsset App asset object
@@ -12910,7 +12946,7 @@ declare type SystemEvent = {
12910
12946
  topic: 'system';
12911
12947
  } & (ExcludeRequested<PropagatedWindowEvent> | PropagatedViewEvent | PropagatedApplicationEvent | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleEvent | MonitorEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent);
12912
12948
 
12913
- declare type SystemEvent_2 = SystemEvents.SystemEvent;
12949
+ declare type SystemEvent_2 = Events.SystemEvents.SystemEvent;
12914
12950
 
12915
12951
  declare namespace SystemEvents {
12916
12952
  export {
@@ -14045,7 +14081,7 @@ declare type ViewEvent = {
14045
14081
  topic: 'view';
14046
14082
  } & (NonPropagatedViewEvent | WillPropagateViewEvent);
14047
14083
 
14048
- declare type ViewEvent_2 = ViewEvents.ViewEvent;
14084
+ declare type ViewEvent_2 = Events.ViewEvents.ViewEvent;
14049
14085
 
14050
14086
  declare namespace ViewEvents {
14051
14087
  export {
@@ -14478,7 +14514,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14478
14514
  /**
14479
14515
  * Navigates the WebContents to a specified URL.
14480
14516
  *
14481
- * @remarks The url must contain the protocol prefix such as http:// or https://.
14517
+ * Note: The url must contain the protocol prefix such as http:// or https://.
14482
14518
  * @param url - The URL to navigate the WebContents to.
14483
14519
  *
14484
14520
  * @example
@@ -14646,7 +14682,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14646
14682
  * Prints the WebContents.
14647
14683
  * @param options Printer Options
14648
14684
  *
14649
- * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
14685
+ * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
14650
14686
  * is empty and the default settings for printing.
14651
14687
  *
14652
14688
  * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -14670,7 +14706,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14670
14706
  * @param searchTerm Term to find in page
14671
14707
  * @param options Search options
14672
14708
  *
14673
- * @remarks By default, each subsequent call will highlight the next text that matches the search term.
14709
+ * Note: By default, each subsequent call will highlight the next text that matches the search term.
14674
14710
  *
14675
14711
  * Returns a promise with the results for the request. By subscribing to the
14676
14712
  * found-in-page event, you can get the results of this call as well.
@@ -14860,7 +14896,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
14860
14896
  /**
14861
14897
  * Retrieves the process information associated with a WebContents.
14862
14898
  *
14863
- * @remarks This includes any iframes associated with the WebContents
14899
+ * Note: This includes any iframes associated with the WebContents
14864
14900
  *
14865
14901
  * @example
14866
14902
  * View:
@@ -15030,7 +15066,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15030
15066
  /**
15031
15067
  * Shows a popup window.
15032
15068
  *
15033
- * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
15069
+ * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
15034
15070
  *
15035
15071
  * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
15036
15072
  * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -15038,7 +15074,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15038
15074
  * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
15039
15075
  * will be dismissed.
15040
15076
  *
15041
- * 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.
15077
+ * 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.
15042
15078
  *
15043
15079
  * @example
15044
15080
  *
@@ -15246,7 +15282,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
15246
15282
  */
15247
15283
  declare type WebContentsEvent = NonPropagatedWebContentsEvent | WillPropagateWebContentsEvent;
15248
15284
 
15249
- declare type WebContentsEvent_2 = WebContentsEvents.WebContentsEvent;
15285
+ declare type WebContentsEvent_2 = Events.WebContentsEvents.WebContentsEvent;
15250
15286
 
15251
15287
  declare namespace WebContentsEvents {
15252
15288
  export {
@@ -17003,7 +17039,7 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
17003
17039
  topic: 'window';
17004
17040
  } & (WillPropagateWindowEvent | NonPropagatedWindowEvent | PropagatedViewEvent);
17005
17041
 
17006
- declare type WindowEvent_2 = WindowEvents.WindowEvent;
17042
+ declare type WindowEvent_2 = Events.WindowEvents.WindowEvent;
17007
17043
 
17008
17044
  declare namespace WindowEvents {
17009
17045
  export {