@openfin/core 33.77.4 → 33.77.6

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.js CHANGED
@@ -10,7 +10,251 @@ var mock = {};
10
10
 
11
11
  var OpenFin$1 = {};
12
12
 
13
- Object.defineProperty(OpenFin$1, "__esModule", { value: true });
13
+ var events$1 = {};
14
+
15
+ var application$1 = {};
16
+
17
+ /**
18
+ * Namespace for events that can be emitted by an {@link OpenFin.Application}. Includes events
19
+ * re-propagated from the {@link OpenFin.Window} (and, transitively, {@link OpenFin.View}) level, prefixed with `window-` (and also, if applicable, `view-`).
20
+ * For example, a view's "attached" event will fire as 'window-view-attached' at the application level.
21
+ *
22
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
23
+ *
24
+ * This namespace contains only payload shapes for events that are unique to `Application`. Events that propagate to `Application` from
25
+ * child {@link OpenFin.Window windows} and {@link OpenFin.View views} are defined in the {@link OpenFin.WindowEvents} and
26
+ * {@link OpenFin.ViewEvents} namespaces. For a list of valid string keys for *all* application events, see {@link Application.on Application.on}.
27
+ *
28
+ * {@link NativeApplicationEvent Native application events} (i.e. those that have not propagated from {@link OpenFin.ViewEvents Views}
29
+ * or {@link OpenFin.WindowEvents Windows} re-propagate to {@link OpenFin.SystemEvents System} with their type string prefixed with `application-`.
30
+ * {@link OpenFin.ApplicationEvents.ApplicationWindowEvent Application events that are tied to Windows but do not propagate from them}
31
+ * are propagated to `System` without any type string prefixing.
32
+ *
33
+ * "Requested" events (e.g. {@link RunRequestedEvent}) do not propagate.
34
+ *
35
+ * @packageDocumentation
36
+ */
37
+ Object.defineProperty(application$1, "__esModule", { value: true });
38
+
39
+ var base$1 = {};
40
+
41
+ /**
42
+ * Namespace for shared event payloads and utility types common to all event emitters.
43
+ *
44
+ * @packageDocumentation
45
+ */
46
+ Object.defineProperty(base$1, "__esModule", { value: true });
47
+
48
+ var externalApplication$1 = {};
49
+
50
+ /**
51
+ * Namespace for events that can be transmitted by an {@link OpenFin.ExternalApplication}.
52
+ *
53
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
54
+ *
55
+ * For a list of valid string keys for external application events, see {@link ExternalApplication.on ExternalApplication.on}.
56
+ *
57
+ * @packageDocumentation
58
+ */
59
+ Object.defineProperty(externalApplication$1, "__esModule", { value: true });
60
+
61
+ var frame$1 = {};
62
+
63
+ Object.defineProperty(frame$1, "__esModule", { value: true });
64
+
65
+ var globalHotkey$1 = {};
66
+
67
+ Object.defineProperty(globalHotkey$1, "__esModule", { value: true });
68
+
69
+ var platform$1 = {};
70
+
71
+ /**
72
+ *
73
+ * Namespace for events that can emitted by a {@link OpenFin.Platform}.
74
+ *
75
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
76
+ *
77
+ * The Platform `EventEmitter` is a superset of the {@link OpenFin.Application} `EventEmitter`,
78
+ * meaning it can listen to all {@link OpenFin.ApplicationEvents Application events} in addition to the
79
+ * Platform-specific events listed here. For a list of valid string keys for *all* platform events, see
80
+ * {@link Platform.on Platform.on}.
81
+ *
82
+ * @packageDocumentation
83
+ */
84
+ Object.defineProperty(platform$1, "__esModule", { value: true });
85
+
86
+ var system$1 = {};
87
+
88
+ /**
89
+ * Namespace for runtime-wide OpenFin events emitted by {@link System.System}. Includes events
90
+ * re-propagated from {@link OpenFin.Application}, {@link OpenFin.Window}, and {@link OpenFin.View} (prefixed with `application-`, `window-`, and `view-`). All
91
+ * event propagations are visible at the System level. Propagated events from WebContents (windows, views, frames) to the Application level will *not*
92
+ * transitively re-propagate to the System level, because they are already visible at the system level and contain the identity
93
+ * of the application. For example, an application's "closed" event will fire as 'application-closed' at the system level. A view's 'shown' event
94
+ * will be visible as 'view-shown' at the system level, but *not* as `application-window-view-shown`.
95
+ *
96
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
97
+ *
98
+ * This namespace contains only payload shapes for events that are unique to `System`. Events that propagate to `System` from
99
+ * child {@link OpenFin.Application applications}, {@link OpenFin.Window windows}, and {@link OpenFin.View views} are defined in the
100
+ * {@link OpenFin.ApplicationEvents}, {@link OpenFin.WindowEvents}, and {@link OpenFin.ViewEvents} namespaces. For a list of valid string keys for *all*
101
+ * system events, see {@link System.on System.on}.
102
+ *
103
+ * @packageDocumentation
104
+ */
105
+ Object.defineProperty(system$1, "__esModule", { value: true });
106
+
107
+ var view$1 = {};
108
+
109
+ /**
110
+ * Namespace for events that can be emitted by a {@link OpenFin.View}.
111
+ *
112
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
113
+ *
114
+ * This namespace contains only payload shapes for events that are unique to `View`. Events that are shared between all `WebContents`
115
+ * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}. For a list
116
+ * of valid string keys for *all* View events, see {@link View.on View.on}.
117
+ *
118
+ * View events propagate to their parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
119
+ * and {@link OpenFin.SystemEvents System} with an added `viewIdentity` property and their event types prefixed with `'view-'`.
120
+ *
121
+ * @packageDocumentation
122
+ */
123
+ Object.defineProperty(view$1, "__esModule", { value: true });
124
+
125
+ var webcontents = {};
126
+
127
+ /**
128
+ * Namespace for events shared by all OpenFin WebContents elements (i.e. {@link OpenFin.Window},
129
+ * {@link OpenFin.View}).
130
+ *
131
+ * WebContents events are divided into two groups: {@link WillPropagateWebContentsEvent} and {@link NonPropagatedWebContentsEvent}. Propagating events
132
+ * will re-emit on parent entities - e.g., a propagating event in a view will also be emitted on the view's
133
+ * parent window, and propagating events in a window will also be emitted on the window's parent {@link OpenFin.Application}.
134
+ *
135
+ * Non-propagating events will not re-emit on parent entities.
136
+ *
137
+ * @packageDocumentation
138
+ */
139
+ Object.defineProperty(webcontents, "__esModule", { value: true });
140
+
141
+ var window$2 = {};
142
+
143
+ /**
144
+ * Namespace for events that can be emitted by a {@link OpenFin.Window}.
145
+ *
146
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
147
+ *
148
+ * This namespace contains only payload shapes for events that are unique to `Window`. Events that are shared between all `WebContents`
149
+ * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}. Events that
150
+ * propagate from `View` are defined in {@link OpenFin.ViewEvents}. For a list of valid string keys for *all* Window events, see
151
+ * {@link Window.on Window.on}
152
+ *
153
+ * {@link OpenFin.WindowEvents.NativeWindowEvent Native window events} (i.e. those that are not propagated from a
154
+ * {@link OpenFin.ViewEvents View}) propagate to their parent {@link OpenFin.ApplicationEvents Application} and
155
+ * {@link OpenFin.SystemEvents System} with their event types prefixed with `'window-'`).
156
+ *
157
+ * "Requested" events (e.g. {@link AuthRequestedEvent}) do not propagate to `System. The {@link OpenFin.WindowEvents.WindowCloseRequestedEvent}
158
+ * does not propagate at all.
159
+ *
160
+ * @packageDocumentation
161
+ */
162
+ Object.defineProperty(window$2, "__esModule", { value: true });
163
+
164
+ /**
165
+ * Namespace for OpenFin event types. Each entity that emits OpenFin events has its own sub-namespace. Event payloads
166
+ * themselves are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
167
+ *
168
+ * #### Event emitters
169
+ *
170
+ * The following entities emit OpenFin events, and have corresponding sub-namespaces:
171
+ *
172
+ * * {@link OpenFin.Application}: {@link OpenFin.ApplicationEvents}
173
+ * * {@link OpenFin.ExternalApplication}: {@link OpenFin.ExternalApplicationEvents}
174
+ * * {@link OpenFin.Frame}: {@link OpenFin.FrameEvents}
175
+ * * {@link OpenFin.GlobalHotkey}: {@link OpenFin.GlobalHotkeyEvents}
176
+ * * {@link OpenFin.Platform}: {@link OpenFin.PlatformEvents}
177
+ * * {@link OpenFin.System}: {@link OpenFin.SystemEvents}
178
+ * * {@link OpenFin.View}: {@link OpenFin.ViewEvents}
179
+ * * {@link OpenFin.Window}: {@link OpenFin.WindowEvents}
180
+ *
181
+ * These `EventEmitter` entities share a common set of methods for interacting with the OpenFin event bus, which can be
182
+ * seen on the individual documentation pages for each entity type.
183
+ *
184
+ * Registering event handlers is an asynchronous operation. It is important to ensure that the returned Promises are awaited to reduce the
185
+ * risk of race conditions.
186
+ *
187
+ * When the `EventEmitter` receives an event from the browser process and emits on the renderer, all of the functions attached to that
188
+ * specific event are called synchronously. Any values returned by the called listeners are ignored and will be discarded. If the window document
189
+ * is destroyed by page navigation or reload, its registered event listeners will be removed.
190
+ *
191
+ * We recommend using Arrow Functions for event listeners to ensure the this scope is consistent with the original function context.
192
+ *
193
+ * Events re-propagate from smaller/more-local scopes to larger/more-global scopes. For example, an event emitted on a specific
194
+ * view will propagate to the window in which the view is embedded, and then to the application in which the window is running, and
195
+ * finally to the OpenFin runtime itself at the "system" level. For details on propagation semantics, see the namespace for
196
+ * the propagating (or propagated-to) entity.
197
+ *
198
+ * If you need the payload type for a specific type of event (especially propagated events), use the emitting topic's `EventPayload`
199
+ * (e.g. {@link WindowEvents.WindowEventPayload}) generic with the event's `type` string. For example, the payload of
200
+ * a {@link ViewEvents.CreatedEvent} after it has propagated to its parent {@link WindowEvents Window} can be found with
201
+ * `WindowEventPayload<'view-created'>`.
202
+ *
203
+ * @packageDocumentation
204
+ */
205
+ Object.defineProperty(events$1, "__esModule", { value: true });
206
+ events$1.WindowEvents = events$1.WebContentsEvents = events$1.ViewEvents = events$1.SystemEvents = events$1.PlatformEvents = events$1.GlobalHotkeyEvents = events$1.FrameEvents = events$1.ExternalApplicationEvents = events$1.BaseEvents = events$1.ApplicationEvents = void 0;
207
+ const ApplicationEvents = application$1;
208
+ events$1.ApplicationEvents = ApplicationEvents;
209
+ const BaseEvents = base$1;
210
+ events$1.BaseEvents = BaseEvents;
211
+ const ExternalApplicationEvents = externalApplication$1;
212
+ events$1.ExternalApplicationEvents = ExternalApplicationEvents;
213
+ const FrameEvents = frame$1;
214
+ events$1.FrameEvents = FrameEvents;
215
+ const GlobalHotkeyEvents = globalHotkey$1;
216
+ events$1.GlobalHotkeyEvents = GlobalHotkeyEvents;
217
+ const PlatformEvents = platform$1;
218
+ events$1.PlatformEvents = PlatformEvents;
219
+ const SystemEvents = system$1;
220
+ events$1.SystemEvents = SystemEvents;
221
+ const ViewEvents = view$1;
222
+ events$1.ViewEvents = ViewEvents;
223
+ const WebContentsEvents = webcontents;
224
+ events$1.WebContentsEvents = WebContentsEvents;
225
+ const WindowEvents = window$2;
226
+ events$1.WindowEvents = WindowEvents;
227
+
228
+ (function (exports) {
229
+ /**
230
+ * Top-level namespace for types referenced by the OpenFin API. Contains:
231
+ *
232
+ * * The type of the global `fin` entry point ({@link FinApi})
233
+ * * Classes that act as static namespaces returned from the `fin` global (e.g. {@link ApplicationModule}, accessible via `fin.Application`)
234
+ * * Instance classes that are returned from API calls (e.g. {@link Application}, accessible via `fin.Application.getCurrentSync()`)
235
+ * * Parameter shapes for API methods (e.g. {@link ApplicationOptions}, used in `fin.Application.start()`)
236
+ * * Event namespaces and payload union types (e.g. {@link ApplicationEvents} and {@link ApplicationEvent})
237
+ *
238
+ * @packageDocumentation
239
+ */
240
+ var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
241
+ if (k2 === undefined) k2 = k;
242
+ var desc = Object.getOwnPropertyDescriptor(m, k);
243
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
244
+ desc = { enumerable: true, get: function() { return m[k]; } };
245
+ }
246
+ Object.defineProperty(o, k2, desc);
247
+ }) : (function(o, m, k, k2) {
248
+ if (k2 === undefined) k2 = k;
249
+ o[k2] = m[k];
250
+ }));
251
+ var __exportStar = (commonjsGlobal && commonjsGlobal.__exportStar) || function(m, exports) {
252
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
253
+ };
254
+ Object.defineProperty(exports, "__esModule", { value: true });
255
+ // Deprecated shim to preserve v30 namespace names
256
+ __exportStar(events$1, exports);
257
+ } (OpenFin$1));
14
258
 
15
259
  var fin = {};
16
260
 
@@ -561,6 +805,13 @@ class Base {
561
805
  get fin() {
562
806
  return this.wire.getFin();
563
807
  }
808
+ /**
809
+ * Provides access to the OpenFin representation of the current code context (usually a document
810
+ * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
811
+ *
812
+ * Useful for debugging in the devtools console, where this will intelligently type itself based
813
+ * on the context in which the devtools panel was opened.
814
+ */
564
815
  get me() {
565
816
  return this.wire.me;
566
817
  }
@@ -595,6 +846,9 @@ class EmitterBase extends Base {
595
846
  this.topic = topic;
596
847
  _EmitterBase_emitterAccessor.set(this, void 0);
597
848
  this.eventNames = () => (this.hasEmitter() ? this.getOrCreateEmitter().eventNames() : []);
849
+ /**
850
+ * @internal
851
+ */
598
852
  this.emit = (eventType, payload, ...args) => {
599
853
  return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
600
854
  };
@@ -637,16 +891,13 @@ class EmitterBase extends Base {
637
891
  // This will only be reached if unsubscribe from event that does not exist but do not want to error here
638
892
  return Promise.resolve();
639
893
  };
640
- this.addListener = this.on;
641
894
  __classPrivateFieldSet$d(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
642
895
  this.listeners = (event) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(event) : [];
643
896
  }
644
897
  /**
645
898
  * Adds a listener to the end of the listeners array for the specified event.
646
899
  *
647
- * @param eventType
648
- * @param listener
649
- * @param options
900
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
650
901
  */
651
902
  async on(eventType, listener, options) {
652
903
  await this.registerEventListener(eventType, options, (emitter) => {
@@ -656,12 +907,16 @@ class EmitterBase extends Base {
656
907
  });
657
908
  return this;
658
909
  }
910
+ /**
911
+ * Adds a listener to the end of the listeners array for the specified event.
912
+ */
913
+ async addListener(eventType, listener, options) {
914
+ return this.on(eventType, listener, options);
915
+ }
659
916
  /**
660
917
  * 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.
661
918
  *
662
- * @param eventType
663
- * @param listener
664
- * @param options
919
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
665
920
  */
666
921
  async once(eventType, listener, options) {
667
922
  const deregister = () => this.deregisterEventListener(eventType);
@@ -677,9 +932,7 @@ class EmitterBase extends Base {
677
932
  /**
678
933
  * Adds a listener to the beginning of the listeners array for the specified event.
679
934
  *
680
- * @param eventType
681
- * @param listener
682
- * @param options
935
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
683
936
  */
684
937
  async prependListener(eventType, listener, options) {
685
938
  await this.registerEventListener(eventType, options, (emitter) => {
@@ -693,9 +946,7 @@ class EmitterBase extends Base {
693
946
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
694
947
  * after which it is removed. The listener is added to the beginning of the listeners array.
695
948
  *
696
- * @param eventType
697
- * @param listener
698
- * @param options
949
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
699
950
  */
700
951
  async prependOnceListener(eventType, listener, options) {
701
952
  const deregister = () => this.deregisterEventListener(eventType);
@@ -712,10 +963,6 @@ class EmitterBase extends Base {
712
963
  * Remove a listener from the listener array for the specified event.
713
964
  *
714
965
  * @remarks Caution: Calling this method changes the array indices in the listener array behind the listener.
715
- *
716
- * @param eventType
717
- * @param listener
718
- * @param options
719
966
  */
720
967
  async removeListener(eventType, listener, options) {
721
968
  const emitter = await this.deregisterEventListener(eventType, options);
@@ -742,7 +989,6 @@ class EmitterBase extends Base {
742
989
  /**
743
990
  * Removes all listeners, or those of the specified event.
744
991
  *
745
- * @param eventType
746
992
  */
747
993
  async removeAllListeners(eventType) {
748
994
  const removeByEvent = async (event) => {
@@ -883,15 +1129,35 @@ var view = {};
883
1129
 
884
1130
  var Factory$6 = {};
885
1131
 
1132
+ var warnings = {};
1133
+
1134
+ Object.defineProperty(warnings, "__esModule", { value: true });
1135
+ warnings.handleDeprecatedWarnings = void 0;
1136
+ const handleDeprecatedWarnings = (options) => {
1137
+ var _a, _b, _c, _d;
1138
+ if (((_a = options.contentNavigation) === null || _a === void 0 ? void 0 : _a.whitelist) ||
1139
+ ((_b = options.contentNavigation) === null || _b === void 0 ? void 0 : _b.blacklist) ||
1140
+ ((_c = options.contentRedirect) === null || _c === void 0 ? void 0 : _c.whitelist) ||
1141
+ ((_d = options.contentRedirect) === null || _d === void 0 ? void 0 : _d.blacklist)) {
1142
+ console.warn(`The properties 'whitelist' and 'blacklist' have been marked as deprecated and will be removed in a future version. Please use 'allowlist' and 'denylist'.`);
1143
+ }
1144
+ };
1145
+ warnings.handleDeprecatedWarnings = handleDeprecatedWarnings;
1146
+
886
1147
  var hasRequiredFactory$3;
887
1148
 
888
1149
  function requireFactory$3 () {
889
1150
  if (hasRequiredFactory$3) return Factory$6;
890
1151
  hasRequiredFactory$3 = 1;
891
1152
  Object.defineProperty(Factory$6, "__esModule", { value: true });
1153
+ Factory$6.ViewModule = void 0;
892
1154
  const base_1 = base;
893
1155
  const validate_1 = validate;
894
1156
  const index_1 = requireView();
1157
+ const warnings_1 = warnings;
1158
+ /**
1159
+ * Static namespace for OpenFin API methods that interact with the {@link View} class, available under `fin.View`.
1160
+ */
895
1161
  class ViewModule extends base_1.Base {
896
1162
  /**
897
1163
  * Creates a new View.
@@ -920,13 +1186,13 @@ function requireFactory$3 () {
920
1186
  * ```
921
1187
  * Note that created views needs to navigate somewhere for them to actually render a website.
922
1188
  * @experimental
923
- * @static
924
1189
  */
925
1190
  async create(options) {
926
1191
  const { uuid } = this.wire.me;
927
1192
  if (!options.name || typeof options.name !== 'string') {
928
1193
  throw new Error('Please provide a name property as a string in order to create a View.');
929
1194
  }
1195
+ (0, warnings_1.handleDeprecatedWarnings)(options);
930
1196
  if (this.wire.environment.childViews) {
931
1197
  await this.wire.environment.createChildContent({
932
1198
  entityType: 'view',
@@ -940,7 +1206,6 @@ function requireFactory$3 () {
940
1206
  }
941
1207
  /**
942
1208
  * Asynchronously returns a View object that represents an existing view.
943
- * @param identity
944
1209
  *
945
1210
  * @example
946
1211
  * ```js
@@ -949,7 +1214,6 @@ function requireFactory$3 () {
949
1214
  * .catch(err => console.log(err));
950
1215
  * ```
951
1216
  * @experimental
952
- * @static
953
1217
  */
954
1218
  async wrap(identity) {
955
1219
  this.wire.sendAction('view-wrap');
@@ -961,7 +1225,6 @@ function requireFactory$3 () {
961
1225
  }
962
1226
  /**
963
1227
  * Synchronously returns a View object that represents an existing view.
964
- * @param identity
965
1228
  *
966
1229
  * @example
967
1230
  * ```js
@@ -969,7 +1232,6 @@ function requireFactory$3 () {
969
1232
  * await view.hide();
970
1233
  * ```
971
1234
  * @experimental
972
- * @static
973
1235
  */
974
1236
  wrapSync(identity) {
975
1237
  this.wire.sendAction('view-wrap-sync').catch((e) => {
@@ -992,7 +1254,6 @@ function requireFactory$3 () {
992
1254
  *
993
1255
  * ```
994
1256
  * @experimental
995
- * @static
996
1257
  */
997
1258
  getCurrent() {
998
1259
  this.wire.sendAction('view-get-current').catch((e) => {
@@ -1014,7 +1275,6 @@ function requireFactory$3 () {
1014
1275
  *
1015
1276
  * ```
1016
1277
  * @experimental
1017
- * @static
1018
1278
  */
1019
1279
  getCurrentSync() {
1020
1280
  this.wire.sendAction('view-get-current-sync').catch((e) => {
@@ -1027,7 +1287,7 @@ function requireFactory$3 () {
1027
1287
  return this.wrapSync({ uuid, name });
1028
1288
  }
1029
1289
  }
1030
- Factory$6.default = ViewModule;
1290
+ Factory$6.ViewModule = ViewModule;
1031
1291
  return Factory$6;
1032
1292
  }
1033
1293
 
@@ -1859,6 +2119,10 @@ Object.defineProperty(main, "__esModule", { value: true });
1859
2119
  main.WebContents = void 0;
1860
2120
  const base_1$k = base;
1861
2121
  class WebContents extends base_1$k.EmitterBase {
2122
+ /**
2123
+ * @param identity The identity of the {@link OpenFin.WebContentsEvents WebContents}.
2124
+ * @param entityType The type of the {@link OpenFin.WebContentsEvents WebContents}.
2125
+ */
1862
2126
  constructor(wire, identity, entityType) {
1863
2127
  super(wire, entityType, identity.uuid, identity.name);
1864
2128
  this.identity = identity;
@@ -1866,10 +2130,7 @@ class WebContents extends base_1$k.EmitterBase {
1866
2130
  }
1867
2131
  /**
1868
2132
  * Gets a base64 encoded image of all or part of the WebContents.
1869
- * @function capturePage
1870
2133
  * @param options Options for the capturePage call.
1871
- * @memberOf View
1872
- * @instance
1873
2134
  *
1874
2135
  * @example
1875
2136
  *
@@ -1914,6 +2175,11 @@ class WebContents extends base_1$k.EmitterBase {
1914
2175
  * }
1915
2176
  * console.log(await wnd.capturePage(options));
1916
2177
  * ```
2178
+ *
2179
+ * @remarks
2180
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2181
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2182
+ * {@link OpenFin.WebContentsEvents event namespace}.
1917
2183
  */
1918
2184
  capturePage(options) {
1919
2185
  return this.wire.sendAction('capture-page', { options, ...this.identity }).then(({ payload }) => payload.data);
@@ -1922,9 +2188,6 @@ class WebContents extends base_1$k.EmitterBase {
1922
2188
  * Executes Javascript on the WebContents, restricted to contents you own or contents owned by
1923
2189
  * applications you have created.
1924
2190
  * @param code JavaScript code to be executed on the view.
1925
- * @function executeJavaScript
1926
- * @memberOf View
1927
- * @instance
1928
2191
  *
1929
2192
  * @example
1930
2193
  * View:
@@ -1952,6 +2215,10 @@ class WebContents extends base_1$k.EmitterBase {
1952
2215
  *
1953
2216
  * executeJavaScript(`console.log('Hello, Openfin')`).then(() => console.log('Javascript excuted')).catch(err => console.log(err));
1954
2217
  * ```
2218
+ * @remarks
2219
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2220
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2221
+ * {@link OpenFin.WebContentsEvents event namespace}.
1955
2222
  */
1956
2223
  executeJavaScript(code) {
1957
2224
  return this.wire
@@ -1960,9 +2227,6 @@ class WebContents extends base_1$k.EmitterBase {
1960
2227
  }
1961
2228
  /**
1962
2229
  * Returns the zoom level of the WebContents.
1963
- * @function getZoomLevel
1964
- * @memberOf View
1965
- * @instance
1966
2230
  *
1967
2231
  * @example
1968
2232
  * View:
@@ -1994,6 +2258,10 @@ class WebContents extends base_1$k.EmitterBase {
1994
2258
  *
1995
2259
  * getZoomLevel().then(zoomLevel => console.log(zoomLevel)).catch(err => console.log(err));
1996
2260
  * ```
2261
+ * @remarks
2262
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2263
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2264
+ * {@link OpenFin.WebContentsEvents event namespace}.
1997
2265
  */
1998
2266
  getZoomLevel() {
1999
2267
  return this.wire.sendAction('get-zoom-level', this.identity).then(({ payload }) => payload.data);
@@ -2001,9 +2269,6 @@ class WebContents extends base_1$k.EmitterBase {
2001
2269
  /**
2002
2270
  * Sets the zoom level of the WebContents.
2003
2271
  * @param level The zoom level
2004
- * @function setZoomLevel
2005
- * @memberOf View
2006
- * @instance
2007
2272
  *
2008
2273
  * @example
2009
2274
  * View:
@@ -2035,6 +2300,10 @@ class WebContents extends base_1$k.EmitterBase {
2035
2300
  *
2036
2301
  * setZoomLevel(4).then(() => console.log('Setting a zoom level')).catch(err => console.log(err));
2037
2302
  * ```
2303
+ * @remarks
2304
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2305
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2306
+ * {@link OpenFin.WebContentsEvents event namespace}.
2038
2307
  */
2039
2308
  setZoomLevel(level) {
2040
2309
  return this.wire.sendAction('set-zoom-level', { ...this.identity, level }).then(() => undefined);
@@ -2042,12 +2311,9 @@ class WebContents extends base_1$k.EmitterBase {
2042
2311
  /**
2043
2312
  * Navigates the WebContents to a specified URL.
2044
2313
  *
2045
- * @remarks The url must contain the protocol prefix such as http:// or https://.
2314
+ * Note: The url must contain the protocol prefix such as http:// or https://.
2046
2315
  * @param url - The URL to navigate the WebContents to.
2047
2316
  *
2048
- * @function navigate
2049
- * @memberof View
2050
- * @instance
2051
2317
  * @example
2052
2318
  * View:
2053
2319
  * ```js
@@ -2075,15 +2341,16 @@ class WebContents extends base_1$k.EmitterBase {
2075
2341
  * navigate().then(() => console.log('Navigate to tutorial')).catch(err => console.log(err));
2076
2342
  * ```
2077
2343
  * @experimental
2344
+ * @remarks
2345
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2346
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2347
+ * {@link OpenFin.WebContentsEvents event namespace}.
2078
2348
  */
2079
2349
  navigate(url) {
2080
2350
  return this.wire.sendAction('navigate-window', { ...this.identity, url }).then(() => undefined);
2081
2351
  }
2082
2352
  /**
2083
2353
  * Navigates the WebContents back one page.
2084
- * @function navigateBack
2085
- * @memberOf View
2086
- * @instance
2087
2354
  *
2088
2355
  * @example
2089
2356
  * View:
@@ -2105,15 +2372,16 @@ class WebContents extends base_1$k.EmitterBase {
2105
2372
  * }
2106
2373
  * navigateBack().then(() => console.log('Navigated back')).catch(err => console.log(err));
2107
2374
  * ```
2375
+ * @remarks
2376
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2377
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2378
+ * {@link OpenFin.WebContentsEvents event namespace}.
2108
2379
  */
2109
2380
  navigateBack() {
2110
2381
  return this.wire.sendAction('navigate-window-back', { ...this.identity }).then(() => undefined);
2111
2382
  }
2112
2383
  /**
2113
2384
  * Navigates the WebContents forward one page.
2114
- * @function navigateForward
2115
- * @memberOf View
2116
- * @instance
2117
2385
  *
2118
2386
  * @example
2119
2387
  * View:
@@ -2137,15 +2405,16 @@ class WebContents extends base_1$k.EmitterBase {
2137
2405
  * }
2138
2406
  * navigateForward().then(() => console.log('Navigated forward')).catch(err => console.log(err));
2139
2407
  * ```
2408
+ * @remarks
2409
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2410
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2411
+ * {@link OpenFin.WebContentsEvents event namespace}.
2140
2412
  */
2141
2413
  async navigateForward() {
2142
2414
  await this.wire.sendAction('navigate-window-forward', { ...this.identity });
2143
2415
  }
2144
2416
  /**
2145
2417
  * Stops any current navigation the WebContents is performing.
2146
- * @function stopNavigation
2147
- * @memberOf View
2148
- * @instance
2149
2418
  *
2150
2419
  * @example
2151
2420
  * View:
@@ -2167,15 +2436,16 @@ class WebContents extends base_1$k.EmitterBase {
2167
2436
  * }
2168
2437
  * stopNavigation().then(() => console.log('you shall not navigate')).catch(err => console.log(err));
2169
2438
  * ```
2439
+ * @remarks
2440
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2441
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2442
+ * {@link OpenFin.WebContentsEvents event namespace}.
2170
2443
  */
2171
2444
  stopNavigation() {
2172
2445
  return this.wire.sendAction('stop-window-navigation', { ...this.identity }).then(() => undefined);
2173
2446
  }
2174
2447
  /**
2175
2448
  * Reloads the WebContents
2176
- * @function reload
2177
- * @memberOf View
2178
- * @instance
2179
2449
  *
2180
2450
  * @example
2181
2451
  * View:
@@ -2207,6 +2477,10 @@ class WebContents extends base_1$k.EmitterBase {
2207
2477
  * console.log('Reloaded window')
2208
2478
  * }).catch(err => console.log(err));
2209
2479
  * ```
2480
+ * @remarks
2481
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2482
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2483
+ * {@link OpenFin.WebContentsEvents event namespace}.
2210
2484
  */
2211
2485
  reload(ignoreCache = false) {
2212
2486
  return this.wire
@@ -2219,11 +2493,8 @@ class WebContents extends base_1$k.EmitterBase {
2219
2493
  /**
2220
2494
  * Prints the WebContents.
2221
2495
  * @param options Printer Options
2222
- * @function print
2223
- * @memberOf View
2224
- * @instance
2225
2496
  *
2226
- * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
2497
+ * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
2227
2498
  * is empty and the default settings for printing.
2228
2499
  *
2229
2500
  * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -2236,6 +2507,10 @@ class WebContents extends base_1$k.EmitterBase {
2236
2507
  * console.log('print call has been sent to the system');
2237
2508
  * });
2238
2509
  * ```
2510
+ * @remarks
2511
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2512
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2513
+ * {@link OpenFin.WebContentsEvents event namespace}.
2239
2514
  */
2240
2515
  print(options = {}) {
2241
2516
  return this.wire.sendAction('print', { ...this.identity, options }).then(() => undefined);
@@ -2244,11 +2519,8 @@ class WebContents extends base_1$k.EmitterBase {
2244
2519
  * Find and highlight text on a page.
2245
2520
  * @param searchTerm Term to find in page
2246
2521
  * @param options Search options
2247
- * @function findInPage
2248
- * @memberOf View
2249
- * @instance
2250
2522
  *
2251
- * @remarks By default, each subsequent call will highlight the next text that matches the search term.
2523
+ * Note: By default, each subsequent call will highlight the next text that matches the search term.
2252
2524
  *
2253
2525
  * Returns a promise with the results for the request. By subscribing to the
2254
2526
  * found-in-page event, you can get the results of this call as well.
@@ -2283,6 +2555,10 @@ class WebContents extends base_1$k.EmitterBase {
2283
2555
  * console.log(result)
2284
2556
  * });
2285
2557
  * ```
2558
+ * @remarks
2559
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2560
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2561
+ * {@link OpenFin.WebContentsEvents event namespace}.
2286
2562
  */
2287
2563
  findInPage(searchTerm, options) {
2288
2564
  return this.wire
@@ -2326,6 +2602,10 @@ class WebContents extends base_1$k.EmitterBase {
2326
2602
  * console.log(results);
2327
2603
  * });
2328
2604
  * ```
2605
+ * @remarks
2606
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2607
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2608
+ * {@link OpenFin.WebContentsEvents event namespace}.
2329
2609
  */
2330
2610
  stopFindInPage(action) {
2331
2611
  return this.wire.sendAction('stop-find-in-page', { ...this.identity, action }).then(() => undefined);
@@ -2333,9 +2613,6 @@ class WebContents extends base_1$k.EmitterBase {
2333
2613
  /**
2334
2614
  * Returns an array with all system printers
2335
2615
  * @deprecated use System.getPrinters instead
2336
- * @function getPrinters
2337
- * @memberOf View
2338
- * @instance
2339
2616
  *
2340
2617
  * @example
2341
2618
  * View:
@@ -2371,6 +2648,10 @@ class WebContents extends base_1$k.EmitterBase {
2371
2648
  * console.log(err);
2372
2649
  * });
2373
2650
  * ```
2651
+ * @remarks
2652
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2653
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2654
+ * {@link OpenFin.WebContentsEvents event namespace}.
2374
2655
  */
2375
2656
  getPrinters() {
2376
2657
  return this.wire.sendAction('get-printers', { ...this.identity }).then(({ payload }) => payload.data);
@@ -2378,10 +2659,6 @@ class WebContents extends base_1$k.EmitterBase {
2378
2659
  /**
2379
2660
  * Gives focus to the WebContents.
2380
2661
  *
2381
- * @function focus
2382
- * @emits focused
2383
- * @memberOf Window
2384
- * @instance
2385
2662
  * @example
2386
2663
  * ```js
2387
2664
  * async function focusWindow() {
@@ -2397,15 +2674,16 @@ class WebContents extends base_1$k.EmitterBase {
2397
2674
  *
2398
2675
  * focusWindow().then(() => console.log('Window focused')).catch(err => console.log(err));
2399
2676
  * ```
2677
+ * @remarks
2678
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2679
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2680
+ * {@link OpenFin.WebContentsEvents event namespace}.
2400
2681
  */
2401
2682
  async focus({ emitSynthFocused } = { emitSynthFocused: true }) {
2402
2683
  await this.wire.sendAction('focus-window', { emitSynthFocused, ...this.identity });
2403
2684
  }
2404
2685
  /**
2405
2686
  * Shows the Chromium Developer Tools
2406
- * @function showDeveloperTools
2407
- * @memberOf View
2408
- * @instance
2409
2687
  *
2410
2688
  * @example
2411
2689
  * View:
@@ -2431,6 +2709,10 @@ class WebContents extends base_1$k.EmitterBase {
2431
2709
  * .then(() => console.log('Showing dev tools'))
2432
2710
  * .catch(err => console.error(err));
2433
2711
  * ```
2712
+ * @remarks
2713
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2714
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2715
+ * {@link OpenFin.WebContentsEvents event namespace}.
2434
2716
  */
2435
2717
  async showDeveloperTools() {
2436
2718
  // Note this hits the system action map in core state for legacy reasons.
@@ -2439,11 +2721,7 @@ class WebContents extends base_1$k.EmitterBase {
2439
2721
  /**
2440
2722
  * Retrieves the process information associated with a WebContents.
2441
2723
  *
2442
- * @remarks This includes any iframes associated with the WebContents
2443
- *
2444
- * @function getProcessInfo
2445
- * @memberOf View
2446
- * @instance
2724
+ * Note: This includes any iframes associated with the WebContents
2447
2725
  *
2448
2726
  * @example
2449
2727
  * View:
@@ -2457,6 +2735,10 @@ class WebContents extends base_1$k.EmitterBase {
2457
2735
  * const win = await fin.Window.getCurrent();
2458
2736
  * const processInfo = await win.getProcessInfo();
2459
2737
  * ```
2738
+ * @remarks
2739
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2740
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2741
+ * {@link OpenFin.WebContentsEvents event namespace}.
2460
2742
  */
2461
2743
  async getProcessInfo() {
2462
2744
  const { payload: { data } } = await this.wire.sendAction('get-process-info', this.identity);
@@ -2464,9 +2746,6 @@ class WebContents extends base_1$k.EmitterBase {
2464
2746
  }
2465
2747
  /**
2466
2748
  * Retrieves information on all Shared Workers.
2467
- * @function getSharedWorkers
2468
- * @memberOf View
2469
- * @instance
2470
2749
  *
2471
2750
  * @example
2472
2751
  * View:
@@ -2495,15 +2774,16 @@ class WebContents extends base_1$k.EmitterBase {
2495
2774
  * const win = await fin.Window.create(winOption);
2496
2775
  * const sharedWorkers = await win.getSharedWorkers();
2497
2776
  * ```
2777
+ * @remarks
2778
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2779
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2780
+ * {@link OpenFin.WebContentsEvents event namespace}.
2498
2781
  */
2499
2782
  async getSharedWorkers() {
2500
2783
  return this.wire.sendAction('get-shared-workers', this.identity).then(({ payload }) => payload.data);
2501
2784
  }
2502
2785
  /**
2503
2786
  * Opens the developer tools for the shared worker context.
2504
- * @function inspectSharedWorker
2505
- * @memberOf View
2506
- * @instance
2507
2787
  *
2508
2788
  * @example
2509
2789
  * View:
@@ -2532,6 +2812,10 @@ class WebContents extends base_1$k.EmitterBase {
2532
2812
  * const win = await fin.Window.create(winOption);
2533
2813
  * await win.inspectSharedWorker();
2534
2814
  * ```
2815
+ * @remarks
2816
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2817
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2818
+ * {@link OpenFin.WebContentsEvents event namespace}.
2535
2819
  */
2536
2820
  async inspectSharedWorker() {
2537
2821
  await this.wire.sendAction('inspect-shared-worker', { ...this.identity });
@@ -2539,9 +2823,6 @@ class WebContents extends base_1$k.EmitterBase {
2539
2823
  /**
2540
2824
  * Inspects the shared worker based on its ID.
2541
2825
  * @param workerId - The id of the shared worker.
2542
- * @function inspectSharedWorkerById
2543
- * @memberOf View
2544
- * @instance
2545
2826
  *
2546
2827
  * @example
2547
2828
  * View:
@@ -2572,15 +2853,16 @@ class WebContents extends base_1$k.EmitterBase {
2572
2853
  * const sharedWorkers = await win.getSharedWorkers();
2573
2854
  * await win.inspectSharedWorkerById(sharedWorkers[0].id);
2574
2855
  * ```
2856
+ * @remarks
2857
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2858
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2859
+ * {@link OpenFin.WebContentsEvents event namespace}.
2575
2860
  */
2576
2861
  async inspectSharedWorkerById(workerId) {
2577
2862
  await this.wire.sendAction('inspect-shared-worker-by-id', { ...this.identity, workerId });
2578
2863
  }
2579
2864
  /**
2580
2865
  * Opens the developer tools for the service worker context.
2581
- * @function inspectServiceWorker
2582
- * @memberOf View
2583
- * @instance
2584
2866
  *
2585
2867
  * @example
2586
2868
  * View:
@@ -2609,6 +2891,10 @@ class WebContents extends base_1$k.EmitterBase {
2609
2891
  * const win = await fin.Window.create(winOption);
2610
2892
  * await win.inspectServiceWorker();
2611
2893
  * ```
2894
+ * @remarks
2895
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2896
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2897
+ * {@link OpenFin.WebContentsEvents event namespace}.
2612
2898
  */
2613
2899
  async inspectServiceWorker() {
2614
2900
  await this.wire.sendAction('inspect-service-worker', { ...this.identity });
@@ -2616,7 +2902,7 @@ class WebContents extends base_1$k.EmitterBase {
2616
2902
  /**
2617
2903
  * Shows a popup window.
2618
2904
  *
2619
- * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
2905
+ * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
2620
2906
  *
2621
2907
  * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
2622
2908
  * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -2624,7 +2910,7 @@ class WebContents extends base_1$k.EmitterBase {
2624
2910
  * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
2625
2911
  * will be dismissed.
2626
2912
  *
2627
- * 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.
2913
+ * 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.
2628
2914
  *
2629
2915
  * @example
2630
2916
  *
@@ -2819,11 +3105,10 @@ class WebContents extends base_1$k.EmitterBase {
2819
3105
  * onPopupReady: popupWindowCallback;
2820
3106
  * });
2821
3107
  * ```
2822
- * @function showPopupWindow
2823
- * @memberOf View
2824
- * @instance
2825
- * @param options
2826
- *
3108
+ * @remarks
3109
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
3110
+ * We do not expose an explicit superclass for this functionality, but it does have its own
3111
+ * {@link OpenFin.WebContentsEvents event namespace}.
2827
3112
  */
2828
3113
  async showPopupWindow(options) {
2829
3114
  this.wire.sendAction(`${this.entityType}-show-popup-window`, this.identity).catch(() => {
@@ -3108,7 +3393,6 @@ function requireInstance$2 () {
3108
3393
  * Attaches the current view to the given window identity.
3109
3394
  * Identity must be the identity of a window in the same application.
3110
3395
  * This detaches the view from its current window, and sets the view to be destroyed when its new window closes.
3111
- * @param target {Identity}
3112
3396
  *
3113
3397
  * @example
3114
3398
  * ```js
@@ -3237,7 +3521,6 @@ function requireInstance$2 () {
3237
3521
  };
3238
3522
  /**
3239
3523
  * Sets the bounds (top, left, width, height) of the view relative to its window.
3240
- * @param bounds {ViewBounds}
3241
3524
  *
3242
3525
  * @remarks View position is relative to the bounds of the window.
3243
3526
  * ({top: 0, left: 0} represents the top left corner of the window)
@@ -3402,7 +3685,6 @@ function requireInstance$2 () {
3402
3685
  };
3403
3686
  /**
3404
3687
  * Updates the view's options.
3405
- * @param options
3406
3688
  *
3407
3689
  * @example
3408
3690
  * ```js
@@ -3443,7 +3725,6 @@ function requireInstance$2 () {
3443
3725
  /**
3444
3726
  * Retrieves the window the view is currently attached to.
3445
3727
  *
3446
- * @experimental
3447
3728
  * @example
3448
3729
  * ```js
3449
3730
  * const view = fin.View.wrapSync({ uuid: 'viewUuid', name: 'viewName' });
@@ -3451,6 +3732,7 @@ function requireInstance$2 () {
3451
3732
  * .then(win => console.log('current window', win))
3452
3733
  * .catch(err => console.log(err));)
3453
3734
  * ```
3735
+ * @experimental
3454
3736
  */
3455
3737
  this.getCurrentWindow = async () => {
3456
3738
  const { payload: { data } } = await this.wire.sendAction('get-view-window', { ...this.identity });
@@ -3556,10 +3838,6 @@ function requireInstance$2 () {
3556
3838
  /**
3557
3839
  * Focuses the view
3558
3840
  *
3559
- * @function focus
3560
- * @memberof View
3561
- * @emits focused
3562
- * @instance
3563
3841
  * @example
3564
3842
  * ```js
3565
3843
  * const view = fin.View.wrapSync({ uuid: 'viewUuid', name: 'viewName' });
@@ -3601,16 +3879,17 @@ function requireView () {
3601
3879
  };
3602
3880
  Object.defineProperty(exports, "__esModule", { value: true });
3603
3881
  /**
3604
- * Entry point for the OpenFin View namespace.
3882
+ * Entry points for the OpenFin `View` API (`fin.View`).
3883
+ *
3884
+ * * {@link ViewModule} contains static members of the `View` API, accessible through `fin.View`.
3885
+ * * {@link View} describes an instance of an OpenFin View, e.g. as returned by `fin.View.getCurrent`.
3605
3886
  *
3606
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "ViewModule" is used for
3607
- * the module containing static members of the `View` namespace (available under `fin.View`), while `View` documents
3608
- * instances of the OpenFin `View` class.
3887
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
3888
+ * both of these were documented on the same page.
3609
3889
  *
3610
3890
  * @packageDocumentation
3611
3891
  */
3612
- const Factory_1 = requireFactory$3();
3613
- exports.default = Factory_1.default;
3892
+ __exportStar(requireFactory$3(), exports);
3614
3893
  __exportStar(requireInstance$2(), exports);
3615
3894
  } (view));
3616
3895
  return view;
@@ -4099,6 +4378,7 @@ function requireInstance$1 () {
4099
4378
  /**
4100
4379
  * Sets or removes a custom JumpList for the application. Only applicable in Windows OS.
4101
4380
  * If categories is null the previously set custom JumpList (if any) will be replaced by the standard JumpList for the app (managed by Windows).
4381
+ *
4102
4382
  * Note: If the "name" property is omitted it defaults to "tasks".
4103
4383
  * @param jumpListCategories An array of JumpList Categories to populate. If null, remove any existing JumpList configuration and set to Windows default.
4104
4384
  *
@@ -4399,6 +4679,7 @@ function requireInstance$1 () {
4399
4679
  }
4400
4680
  /**
4401
4681
  * Sets file auto download location. It's only allowed in the same application.
4682
+ *
4402
4683
  * Note: This method is restricted by default and must be enabled via
4403
4684
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
4404
4685
  * @param downloadLocation file auto download location
@@ -4424,6 +4705,7 @@ function requireInstance$1 () {
4424
4705
  }
4425
4706
  /**
4426
4707
  * 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.
4708
+ *
4427
4709
  * Note: This method is restricted by default and must be enabled via
4428
4710
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
4429
4711
  *
@@ -4450,13 +4732,16 @@ function requireFactory$2 () {
4450
4732
  if (hasRequiredFactory$2) return Factory$7;
4451
4733
  hasRequiredFactory$2 = 1;
4452
4734
  Object.defineProperty(Factory$7, "__esModule", { value: true });
4735
+ Factory$7.ApplicationModule = void 0;
4453
4736
  const base_1 = base;
4454
4737
  const validate_1 = validate;
4455
4738
  const Instance_1 = requireInstance$1();
4739
+ /**
4740
+ * Static namespace for OpenFin API methods that interact with the {@link Application} class, available under `fin.Application`.
4741
+ */
4456
4742
  class ApplicationModule extends base_1.Base {
4457
4743
  /**
4458
4744
  * Asynchronously returns an Application object that represents an existing application.
4459
- * @param identity
4460
4745
  *
4461
4746
  * @example
4462
4747
  *
@@ -4467,7 +4752,6 @@ function requireFactory$2 () {
4467
4752
  * .catch(err => console.log(err));
4468
4753
  * ```
4469
4754
  *
4470
- * @static
4471
4755
  */
4472
4756
  async wrap(identity) {
4473
4757
  this.wire.sendAction('wrap-application').catch((e) => {
@@ -4481,7 +4765,6 @@ function requireFactory$2 () {
4481
4765
  }
4482
4766
  /**
4483
4767
  * Synchronously returns an Application object that represents an existing application.
4484
- * @param identity
4485
4768
  *
4486
4769
  * @example
4487
4770
  *
@@ -4490,7 +4773,6 @@ function requireFactory$2 () {
4490
4773
  * await app.close();
4491
4774
  * ```
4492
4775
  *
4493
- * @static
4494
4776
  */
4495
4777
  wrapSync(identity) {
4496
4778
  this.wire.sendAction('wrap-application-sync').catch((e) => {
@@ -4515,8 +4797,6 @@ function requireFactory$2 () {
4515
4797
  }
4516
4798
  /**
4517
4799
  * DEPRECATED method to create a new Application. Use {@link Application.ApplicationModule.start Application.start} instead.
4518
- * @param appOptions
4519
- *
4520
4800
  *
4521
4801
  * @example
4522
4802
  *
@@ -4545,7 +4825,6 @@ function requireFactory$2 () {
4545
4825
  }
4546
4826
  /**
4547
4827
  * Creates and starts a new Application.
4548
- * @param appOptions
4549
4828
  *
4550
4829
  * @example
4551
4830
  *
@@ -4561,8 +4840,6 @@ function requireFactory$2 () {
4561
4840
  * start().then(() => console.log('Application is running')).catch(err => console.log(err));
4562
4841
  * ```
4563
4842
  *
4564
- *
4565
- * @static
4566
4843
  */
4567
4844
  async start(appOptions) {
4568
4845
  this.wire.sendAction('start-application').catch((e) => {
@@ -4575,10 +4852,8 @@ function requireFactory$2 () {
4575
4852
  /**
4576
4853
  * Asynchronously starts a batch of applications given an array of application identifiers and manifestUrls.
4577
4854
  * Returns once the RVM is finished attempting to launch the applications.
4578
- * @param applications
4579
4855
  * @param opts - Parameters that the RVM will use.
4580
4856
  *
4581
- * @static
4582
4857
  * @example
4583
4858
  *
4584
4859
  * ```js
@@ -4630,8 +4905,6 @@ function requireFactory$2 () {
4630
4905
  * });
4631
4906
  *
4632
4907
  * ```
4633
- *
4634
- * @static
4635
4908
  */
4636
4909
  getCurrent() {
4637
4910
  this.wire.sendAction('get-current-application').catch((e) => {
@@ -4657,8 +4930,6 @@ function requireFactory$2 () {
4657
4930
  * });
4658
4931
  *
4659
4932
  * ```
4660
- *
4661
- * @static
4662
4933
  */
4663
4934
  getCurrentSync() {
4664
4935
  this.wire.sendAction('get-current-application-sync').catch((e) => {
@@ -4679,8 +4950,6 @@ function requireFactory$2 () {
4679
4950
  * // For a local manifest file:
4680
4951
  * fin.Application.startFromManifest('file:///C:/somefolder/app.json').then(app => console.log('App is running')).catch(err => console.log(err));
4681
4952
  * ```
4682
- *
4683
- * @static
4684
4953
  */
4685
4954
  async startFromManifest(manifestUrl, opts) {
4686
4955
  this.wire.sendAction('application-start-from-manifest').catch((e) => {
@@ -4725,7 +4994,7 @@ function requireFactory$2 () {
4725
4994
  });
4726
4995
  }
4727
4996
  }
4728
- Factory$7.default = ApplicationModule;
4997
+ Factory$7.ApplicationModule = ApplicationModule;
4729
4998
  return Factory$7;
4730
4999
  }
4731
5000
 
@@ -4751,17 +5020,18 @@ function requireApplication () {
4751
5020
  };
4752
5021
  Object.defineProperty(exports, "__esModule", { value: true });
4753
5022
  /**
4754
- * Entry point for the OpenFin Application namespace.
5023
+ * Entry points for the OpenFin `Application` API (`fin.Application`).
5024
+ *
5025
+ * * {@link ApplicationModule} contains static members of the `Application` API, accessible through `fin.Application`.
5026
+ * * {@link Application} describes an instance of an OpenFin Application, e.g. as returned by `fin.Application.getCurrent`.
4755
5027
  *
4756
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "ApplicationModule" is used for
4757
- * the module containing static members of the `Application` namespace (available under `fin.Application`), while `Application` documents
4758
- * instances of the OpenFin `Application` class.
5028
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
5029
+ * both of these were documented on the same page.
4759
5030
  *
4760
5031
  * @packageDocumentation
4761
5032
  */
4762
- const Factory_1 = requireFactory$2();
5033
+ __exportStar(requireFactory$2(), exports);
4763
5034
  __exportStar(requireInstance$1(), exports);
4764
- exports.default = Factory_1.default;
4765
5035
  } (application));
4766
5036
  return application;
4767
5037
  }
@@ -4780,6 +5050,7 @@ function requireInstance () {
4780
5050
  const application_1 = requireApplication();
4781
5051
  const main_1 = main;
4782
5052
  const view_1 = requireView();
5053
+ const warnings_1 = warnings;
4783
5054
  /**
4784
5055
  * @PORTED
4785
5056
  * @typedef { object } Margins
@@ -4886,7 +5157,7 @@ function requireInstance () {
4886
5157
  * alphaMask turns anything of matching RGB value transparent.
4887
5158
  * <br>
4888
5159
  * Caveats:
4889
- * * runtime key --disable-gpu is required. Note: Unclear behavior on remote Desktop support
5160
+ * * Runtime flags --disable-gpu and --allow-unsafe-compositing are required. Note: Unclear behavior on remote Desktop support
4890
5161
  * * User cannot click-through transparent regions
4891
5162
  * * Not supported on Mac
4892
5163
  * * Windows Aero must be enabled
@@ -5074,6 +5345,7 @@ function requireInstance () {
5074
5345
  * A flag that specifies how transparent the window will be.
5075
5346
  * Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
5076
5347
  * This value is clamped between `0.0` and `1.0`.
5348
+ * * In software composition mode, the runtime flag --allow-unsafe-compositing is required.
5077
5349
  *
5078
5350
  * @property {preloadScript[]} [preloadScripts] - _Inheritable_
5079
5351
  * A list of scripts that are eval'ed before other scripts in the page. When omitted, _inherits_
@@ -5263,7 +5535,6 @@ function requireInstance () {
5263
5535
  */
5264
5536
  constructor(wire, identity) {
5265
5537
  super(wire, identity, 'window');
5266
- this.identity = identity;
5267
5538
  }
5268
5539
  /**
5269
5540
  * Adds a listener to the end of the listeners array for the specified event.
@@ -5389,6 +5660,7 @@ function requireInstance () {
5389
5660
  if (options.autoShow === undefined) {
5390
5661
  options.autoShow = true;
5391
5662
  }
5663
+ (0, warnings_1.handleDeprecatedWarnings)(options);
5392
5664
  const windowCreation = this.wire.environment.createChildContent({ entityType: 'window', options });
5393
5665
  Promise.all([pageResponse, windowCreation])
5394
5666
  .then((resolvedArr) => {
@@ -6094,11 +6366,12 @@ function requireInstance () {
6094
6366
  * moveBy(580, 300).then(() => console.log('Moved')).catch(err => console.log(err));
6095
6367
  * ```
6096
6368
  */
6097
- moveBy(deltaLeft, deltaTop) {
6369
+ moveBy(deltaLeft, deltaTop, positioningOptions) {
6098
6370
  return this.wire
6099
6371
  .sendAction('move-window-by', {
6100
6372
  deltaLeft,
6101
6373
  deltaTop,
6374
+ positioningOptions,
6102
6375
  ...this.identity
6103
6376
  })
6104
6377
  .then(() => undefined);
@@ -6128,11 +6401,12 @@ function requireInstance () {
6128
6401
  * moveTo(580, 300).then(() => console.log('Moved')).catch(err => console.log(err))
6129
6402
  * ```
6130
6403
  */
6131
- moveTo(left, top) {
6404
+ moveTo(left, top, positioningOptions) {
6132
6405
  return this.wire
6133
6406
  .sendAction('move-window', {
6134
6407
  left,
6135
6408
  top,
6409
+ positioningOptions,
6136
6410
  ...this.identity
6137
6411
  })
6138
6412
  .then(() => undefined);
@@ -6165,12 +6439,13 @@ function requireInstance () {
6165
6439
  * resizeBy(580, 300, 'top-right').then(() => console.log('Resized')).catch(err => console.log(err));
6166
6440
  * ```
6167
6441
  */
6168
- resizeBy(deltaWidth, deltaHeight, anchor) {
6442
+ resizeBy(deltaWidth, deltaHeight, anchor, positioningOptions) {
6169
6443
  return this.wire
6170
6444
  .sendAction('resize-window-by', {
6171
6445
  deltaWidth: Math.floor(deltaWidth),
6172
6446
  deltaHeight: Math.floor(deltaHeight),
6173
6447
  anchor,
6448
+ positioningOptions,
6174
6449
  ...this.identity
6175
6450
  })
6176
6451
  .then(() => undefined);
@@ -6203,12 +6478,13 @@ function requireInstance () {
6203
6478
  * resizeTo(580, 300, 'top-left').then(() => console.log('Resized')).catch(err => console.log(err));
6204
6479
  * ```
6205
6480
  */
6206
- resizeTo(width, height, anchor) {
6481
+ resizeTo(width, height, anchor, positioningOptions) {
6207
6482
  return this.wire
6208
6483
  .sendAction('resize-window', {
6209
6484
  width: Math.floor(width),
6210
6485
  height: Math.floor(height),
6211
6486
  anchor,
6487
+ positioningOptions,
6212
6488
  ...this.identity
6213
6489
  })
6214
6490
  .then(() => undefined);
@@ -6267,7 +6543,6 @@ function requireInstance () {
6267
6543
  }
6268
6544
  /**
6269
6545
  * Sets the window's size and position.
6270
- * @property { Bounds } bounds This is a * @type {string} name - name of the window.object that holds the propertys of
6271
6546
  *
6272
6547
  * @example
6273
6548
  * ```js
@@ -6294,8 +6569,10 @@ function requireInstance () {
6294
6569
  * }).then(() => console.log('Bounds set to window')).catch(err => console.log(err));
6295
6570
  * ```
6296
6571
  */
6297
- setBounds(bounds) {
6298
- return this.wire.sendAction('set-window-bounds', { ...bounds, ...this.identity }).then(() => undefined);
6572
+ setBounds(bounds, positioningOptions) {
6573
+ return this.wire
6574
+ .sendAction('set-window-bounds', { ...bounds, ...this.identity, positioningOptions })
6575
+ .then(() => undefined);
6299
6576
  }
6300
6577
  /**
6301
6578
  * Shows the window if it is hidden.
@@ -6437,7 +6714,10 @@ function requireInstance () {
6437
6714
  * Calling this method will close previously opened menus.
6438
6715
  * @experimental
6439
6716
  * @param options
6440
- *
6717
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
6718
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
6719
+ * of all possible data shapes for the entire menu, and the click handler should process
6720
+ * these with a "reducer" pattern.
6441
6721
  * @example
6442
6722
  * This could be used to show a drop down menu over views in a platform window:
6443
6723
  * ```js
@@ -6527,6 +6807,7 @@ function requireInstance () {
6527
6807
  return this.wire.sendAction('close-popup-menu', { ...this.identity }).then(() => undefined);
6528
6808
  }
6529
6809
  /**
6810
+ * @PORTED
6530
6811
  * @typedef {object} PopupOptions
6531
6812
  * @property {string} [name] - If a window with this `name` exists, it will be shown as a popup. Otherwise, a new window with this `name` will be created. If this `name` is undefined, `initialOptions.name` will be used. If this `name` and `intialOptions.name` are both undefined, a `name` will be generated.
6532
6813
  * @property {string} [url] - Navigates to this `url` if showing an existing window as a popup, otherwise the newly created window will load this `url`.
@@ -6544,6 +6825,7 @@ function requireInstance () {
6544
6825
  * @property {boolean} [hideOnClose] - Hide the popup window instead of closing whenever `close` is called on it. Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
6545
6826
  */
6546
6827
  /**
6828
+ * @PORTED
6547
6829
  * @typedef {object} PopupResult
6548
6830
  * @property {Identity} identity - `name` and `uuid` of the popup window that called dispatched this result.
6549
6831
  * @property {'clicked' | 'dismissed'} result - Result of the user interaction with the popup window.
@@ -6633,13 +6915,16 @@ function requireFactory$1 () {
6633
6915
  if (hasRequiredFactory$1) return Factory$8;
6634
6916
  hasRequiredFactory$1 = 1;
6635
6917
  Object.defineProperty(Factory$8, "__esModule", { value: true });
6918
+ Factory$8._WindowModule = void 0;
6636
6919
  const base_1 = base;
6637
6920
  const validate_1 = validate;
6638
6921
  const Instance_1 = requireInstance();
6922
+ /**
6923
+ * Static namespace for OpenFin API methods that interact with the {@link _Window} class, available under `fin.Window`.
6924
+ */
6639
6925
  class _WindowModule extends base_1.Base {
6640
6926
  /**
6641
6927
  * Asynchronously returns a Window object that represents an existing window.
6642
- * @param identity
6643
6928
  *
6644
6929
  * @example
6645
6930
  * ```js
@@ -6656,7 +6941,6 @@ function requireFactory$1 () {
6656
6941
  * .then(win => console.log('wrapped window'))
6657
6942
  * .catch(err => console.log(err));
6658
6943
  * ```
6659
- * @static
6660
6944
  */
6661
6945
  async wrap(identity) {
6662
6946
  this.wire.sendAction('window-wrap').catch((e) => {
@@ -6670,7 +6954,6 @@ function requireFactory$1 () {
6670
6954
  }
6671
6955
  /**
6672
6956
  * Synchronously returns a Window object that represents an existing window.
6673
- * @param identity
6674
6957
  *
6675
6958
  * @example
6676
6959
  * ```js
@@ -6686,7 +6969,6 @@ function requireFactory$1 () {
6686
6969
  * await createWin();
6687
6970
  * let win = fin.Window.wrapSync({ uuid: 'app-1', name: 'myApp' });
6688
6971
  * ```
6689
- * @static
6690
6972
  */
6691
6973
  wrapSync(identity) {
6692
6974
  this.wire.sendAction('window-wrap-sync').catch((e) => {
@@ -6718,7 +7000,6 @@ function requireFactory$1 () {
6718
7000
  *
6719
7001
  * createWindow().then(() => console.log('Window is created')).catch(err => console.log(err));
6720
7002
  * ```
6721
- * @static
6722
7003
  */
6723
7004
  create(options) {
6724
7005
  this.wire.sendAction('create-window').catch((e) => {
@@ -6737,7 +7018,6 @@ function requireFactory$1 () {
6737
7018
  * .catch(err => console.log(err));
6738
7019
  *
6739
7020
  * ```
6740
- * @static
6741
7021
  */
6742
7022
  getCurrent() {
6743
7023
  this.wire.sendAction('get-current-window').catch((e) => {
@@ -6759,7 +7039,6 @@ function requireFactory$1 () {
6759
7039
  * console.log(info);
6760
7040
  *
6761
7041
  * ```
6762
- * @static
6763
7042
  */
6764
7043
  getCurrentSync() {
6765
7044
  this.wire.sendAction('get-current-window-sync').catch((e) => {
@@ -6772,7 +7051,7 @@ function requireFactory$1 () {
6772
7051
  return this.wrapSync({ uuid, name });
6773
7052
  }
6774
7053
  }
6775
- Factory$8.default = _WindowModule;
7054
+ Factory$8._WindowModule = _WindowModule;
6776
7055
  return Factory$8;
6777
7056
  }
6778
7057
 
@@ -6798,24 +7077,33 @@ function requireWindow () {
6798
7077
  };
6799
7078
  Object.defineProperty(exports, "__esModule", { value: true });
6800
7079
  /**
6801
- * Entry point for the OpenFin Window namespace.
7080
+ * Entry points for the OpenFin `Window` API (`fin.Window`).
6802
7081
  *
6803
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "WindowModule" is used for
6804
- * the module containing static members of the `Window` namespace (available under `fin.Window`), while `Window` documents
6805
- * instances of the OpenFin `Window` class.
7082
+ * * {@link _WindowModule} contains static members of the `Window` API, accessible through `fin.Window`.
7083
+ * * {@link _Window} describes an instance of an OpenFin Window, e.g. as returned by `fin.Window.getCurrent`.
6806
7084
  *
6807
- * Because the `Window` name aliases a DOM entity, the documentation pipeline prefixes the name with an underscore.
7085
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
7086
+ * both of these were documented on the same page.
7087
+ *
7088
+ * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
6808
7089
  *
6809
7090
  * @packageDocumentation
6810
7091
  */
6811
- const Factory_1 = requireFactory$1();
6812
- exports.default = Factory_1.default;
7092
+ __exportStar(requireFactory$1(), exports);
6813
7093
  __exportStar(requireInstance(), exports);
6814
7094
  } (window$1));
6815
7095
  return window$1;
6816
7096
  }
6817
7097
 
7098
+ /**
7099
+ * Entry point for the OpenFin `System` API (`fin.System`).
7100
+ *
7101
+ * * {@link System} contains static members of the `System` API (available under `fin.System`)
7102
+ *
7103
+ * @packageDocumentation
7104
+ */
6818
7105
  Object.defineProperty(system, "__esModule", { value: true });
7106
+ system.System = void 0;
6819
7107
  const base_1$j = base;
6820
7108
  const transport_errors_1$1 = transportErrors;
6821
7109
  const window_1 = requireWindow();
@@ -7131,7 +7419,6 @@ class System extends base_1$j.EmitterBase {
7131
7419
  * ```js
7132
7420
  * fin.System.getUniqueUserId().then(id => console.log(id)).catch(err => console.log(err));
7133
7421
  * ```
7134
- * @static
7135
7422
  */
7136
7423
  getUniqueUserId() {
7137
7424
  return this.wire.sendAction('get-unique-user-id').then(({ payload }) => payload.data);
@@ -7822,7 +8109,8 @@ class System extends base_1$j.EmitterBase {
7822
8109
  }
7823
8110
  /**
7824
8111
  * Attempt to close an external process. The process will be terminated if it
7825
- * has not closed after the elapsed timeout in milliseconds.<br>
8112
+ * has not closed after the elapsed timeout in milliseconds.
8113
+ *
7826
8114
  * Note: This method is restricted by default and must be enabled via
7827
8115
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
7828
8116
  * @param options A object defined in the TerminateExternalRequestType interface
@@ -7858,7 +8146,8 @@ class System extends base_1$j.EmitterBase {
7858
8146
  return this.wire.sendAction('update-proxy', options).then(() => undefined);
7859
8147
  }
7860
8148
  /**
7861
- * Downloads the given application asset<br>
8149
+ * Downloads the given application asset.
8150
+ *
7862
8151
  * Note: This method is restricted by default and must be enabled via
7863
8152
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
7864
8153
  * @param appAsset App asset object
@@ -8402,7 +8691,6 @@ class System extends base_1$j.EmitterBase {
8402
8691
  * }
8403
8692
  * });
8404
8693
  * ```
8405
- * @static
8406
8694
  */
8407
8695
  async launchManifest(manifestUrl, opts = {}) {
8408
8696
  const { subscribe, ..._sendOpts } = opts;
@@ -8662,7 +8950,7 @@ class System extends base_1$j.EmitterBase {
8662
8950
  await this.wire.sendAction('set-domain-settings', { domainSettings, ...this.identity });
8663
8951
  }
8664
8952
  }
8665
- system.default = System;
8953
+ system.System = System;
8666
8954
 
8667
8955
  var interappbus = {};
8668
8956
 
@@ -9073,6 +9361,7 @@ var __classPrivateFieldSet$b = (commonjsGlobal && commonjsGlobal.__classPrivateF
9073
9361
  };
9074
9362
  var _ChannelClient_protectedObj, _ChannelClient_strategy, _ChannelClient_close;
9075
9363
  Object.defineProperty(client, "__esModule", { value: true });
9364
+ client.ChannelClient = void 0;
9076
9365
  const channel_1$1 = channel;
9077
9366
  const channelClientsByEndpointId = new Map();
9078
9367
  /**
@@ -9081,17 +9370,17 @@ const channelClientsByEndpointId = new Map();
9081
9370
  * provider via {@link ChannelClient#dispatch dispatch} and to listen for communication
9082
9371
  * from the provider by registering an action via {@link ChannelClient#register register}.
9083
9372
  *
9084
- * Synchronous Methods:
9373
+ * ### Synchronous Methods:
9085
9374
  * * {@link ChannelClient#onDisconnection onDisconnection(listener)}
9086
9375
  * * {@link ChannelClient#register register(action, listener)}
9087
9376
  * * {@link ChannelClient#remove remove(action)}
9088
9377
  *
9089
- * Asynchronous Methods:
9378
+ * ### Asynchronous Methods:
9090
9379
  * * {@link ChannelClient#disconnect disconnect()}
9091
9380
  * * {@link ChannelClient#dispatch dispatch(action, payload)}
9092
9381
  *
9093
- * Middleware:
9094
- * <br>Middleware functions receive the following arguments: (action, payload, senderId).
9382
+ * ### Middleware:
9383
+ * Middleware functions receive the following arguments: (action, payload, senderId).
9095
9384
  * The return value of the middleware function will be passed on as the payload from beforeAction, to the action listener, to afterAction
9096
9385
  * unless it is undefined, in which case the original payload is used. Middleware can be used for side effects.
9097
9386
  * * {@link ChannelClient#setDefaultAction setDefaultAction(middleware)}
@@ -9238,7 +9527,7 @@ class ChannelClient extends channel_1$1.ChannelBase {
9238
9527
  });
9239
9528
  }
9240
9529
  }
9241
- client.default = ChannelClient;
9530
+ client.ChannelClient = ChannelClient;
9242
9531
  _ChannelClient_protectedObj = new WeakMap(), _ChannelClient_strategy = new WeakMap(), _ChannelClient_close = new WeakMap();
9243
9532
 
9244
9533
  var connectionManager = {};
@@ -9781,20 +10070,20 @@ const runtimeVersioning_1 = runtimeVersioning;
9781
10070
  * a single client via {@link ChannelProvider#dispatch dispatch} or all clients via {@link ChannelProvider#publish publish}
9782
10071
  * and to listen for communication from clients by registering an action via {@link ChannelProvider#register register}.
9783
10072
  *
9784
- * Synchronous Methods:
10073
+ * ### Synchronous Methods:
9785
10074
  * * {@link ChannelProvider#onConnection onConnection(listener)}
9786
10075
  * * {@link ChannelProvider#onDisconnection onDisconnection(listener)}
9787
10076
  * * {@link ChannelProvider#publish publish(action, payload)}
9788
10077
  * * {@link ChannelProvider#register register(action, listener)}
9789
10078
  * * {@link ChannelProvider#remove remove(action)}
9790
10079
  *
9791
- * Asynchronous Methods:
10080
+ * ### Asynchronous Methods:
9792
10081
  * * {@link ChannelProvider#destroy destroy()}
9793
10082
  * * {@link ChannelProvider#dispatch dispatch(to, action, payload)}
9794
10083
  * * {@link ChannelProvider#getAllClientInfo getAllClientInfo()}
9795
10084
  *
9796
- * Middleware:
9797
- * <br>Middleware functions receive the following arguments: (action, payload, senderId).
10085
+ * ### Middleware:
10086
+ * Middleware functions receive the following arguments: (action, payload, senderId).
9798
10087
  * The return value of the middleware function will be passed on as the payload from beforeAction, to the action listener, to afterAction
9799
10088
  * unless it is undefined, in which case the most recently defined payload is used. Middleware can be used for side effects.
9800
10089
  * * {@link ChannelProvider#setDefaultAction setDefaultAction(middleware)}
@@ -10163,7 +10452,7 @@ class MessageReceiver extends base_1$h.Base {
10163
10452
  const endpointIdFromPreviousConnection = this.latestEndpointIdByChannelId.get(channelId);
10164
10453
  if (endpointIdFromPreviousConnection) {
10165
10454
  // Not convinced by this way of doing things, but pushing up for now.
10166
- client_1$1.default.closeChannelByEndpointId(endpointIdFromPreviousConnection);
10455
+ client_1$1.ChannelClient.closeChannelByEndpointId(endpointIdFromPreviousConnection);
10167
10456
  // eslint-disable-next-line no-console
10168
10457
  console.warn('You have created a second connection to an older provider. First connection has been removed from the clientMap');
10169
10458
  // eslint-disable-next-line no-console
@@ -10524,6 +10813,15 @@ class ConnectionManager extends base_1$g.Base {
10524
10813
  connectionManager.ConnectionManager = ConnectionManager;
10525
10814
  _ConnectionManager_messageReceiver = new WeakMap(), _ConnectionManager_rtcConnectionManager = new WeakMap();
10526
10815
 
10816
+ /**
10817
+ * Entry points for the `Channel` subset of the `InterApplicationBus` API (`fin.InterApplicationBus.Channel`).
10818
+ *
10819
+ * * {@link Channel} contains static members of the `Channel` API, accessible through `fin.InterApplicationBus.Channel`.
10820
+ * * {@link OpenFin.ChannelClient} describes a client of a channel, e.g. as returned by `fin.InterApplicationBus.Channel.connect`.
10821
+ * * {@link OpenFin.ChannelProvider} describes a provider of a channel, e.g. as returned by `fin.InterApplicationBus.Channel.create`.
10822
+ *
10823
+ * @packageDocumentation
10824
+ */
10527
10825
  var __classPrivateFieldSet$5 = (commonjsGlobal && commonjsGlobal.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
10528
10826
  if (kind === "m") throw new TypeError("Private method is not writable");
10529
10827
  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -10584,7 +10882,7 @@ class Channel extends base_1$f.EmitterBase {
10584
10882
  _Channel_readyToConnect.set(this, new lazy_1$1.AsyncRetryableLazy(async () => {
10585
10883
  await Promise.all([
10586
10884
  this.on('disconnected', (eventPayload) => {
10587
- client_1.default.handleProviderDisconnect(eventPayload);
10885
+ client_1.ChannelClient.handleProviderDisconnect(eventPayload);
10588
10886
  }),
10589
10887
  this.on('connected', (...args) => {
10590
10888
  __classPrivateFieldGet$7(this, _Channel_internalEmitter, "f").emit('connected', ...args);
@@ -10775,7 +11073,7 @@ class Channel extends base_1$f.EmitterBase {
10775
11073
  };
10776
11074
  const routingInfo = await this.safeConnect(channelName, opts.wait, connectPayload);
10777
11075
  const strategy = await __classPrivateFieldGet$7(this, _Channel_connectionManager, "f").createClientStrategy(rtcPacket, routingInfo);
10778
- const channel = new client_1.default(routingInfo, this.wire, strategy);
11076
+ const channel = new client_1.ChannelClient(routingInfo, this.wire, strategy);
10779
11077
  // It is the client's responsibility to handle endpoint disconnection to the provider.
10780
11078
  // If the endpoint dies, the client will force a disconnection through the core.
10781
11079
  // The provider does not care about endpoint disconnection.
@@ -10787,7 +11085,7 @@ class Channel extends base_1$f.EmitterBase {
10787
11085
  console.warn(`Something went wrong during disconnect for client with uuid: ${routingInfo.uuid} / name: ${routingInfo.name} / endpointId: ${routingInfo.endpointId}.`);
10788
11086
  }
10789
11087
  finally {
10790
- client_1.default.handleProviderDisconnect(routingInfo);
11088
+ client_1.ChannelClient.handleProviderDisconnect(routingInfo);
10791
11089
  }
10792
11090
  });
10793
11091
  return channel;
@@ -10858,7 +11156,14 @@ channel$1.Channel = Channel;
10858
11156
  _Channel_connectionManager = new WeakMap(), _Channel_internalEmitter = new WeakMap(), _Channel_readyToConnect = new WeakMap();
10859
11157
 
10860
11158
  Object.defineProperty(interappbus, "__esModule", { value: true });
10861
- interappbus.InterAppPayload = void 0;
11159
+ interappbus.InterAppPayload = interappbus.InterApplicationBus = void 0;
11160
+ /**
11161
+ * Entry point for the OpenFin `InterApplicationBus` API (`fin.InterApplicationBus`).
11162
+ *
11163
+ * * {@link InterApplicationBus} contains static members of the `InterApplicationBus` API, accessible through `fin.InterApplicationBus`.
11164
+ *
11165
+ * @packageDocumentation
11166
+ */
10862
11167
  const events_1$4 = eventsExports;
10863
11168
  const base_1$e = base;
10864
11169
  const ref_counter_1 = refCounter;
@@ -11050,7 +11355,7 @@ class InterApplicationBus extends base_1$e.Base {
11050
11355
  return true;
11051
11356
  }
11052
11357
  }
11053
- interappbus.default = InterApplicationBus;
11358
+ interappbus.InterApplicationBus = InterApplicationBus;
11054
11359
  /**
11055
11360
  * @internal
11056
11361
  */
@@ -11067,7 +11372,15 @@ function createKey(...toHash) {
11067
11372
 
11068
11373
  var clipboard = {};
11069
11374
 
11375
+ /**
11376
+ * Entry point for the OpenFin `Clipboard` API (`fin.Clipboard`).
11377
+ *
11378
+ * * {@link Clipboard} contains static members of the `Clipboard` API, accessible through `fin.Clipboard`.
11379
+ *
11380
+ * @packageDocumentation
11381
+ */
11070
11382
  Object.defineProperty(clipboard, "__esModule", { value: true });
11383
+ clipboard.Clipboard = void 0;
11071
11384
  const base_1$d = base;
11072
11385
  /**
11073
11386
  * @PORTED
@@ -11265,7 +11578,7 @@ class Clipboard extends base_1$d.Base {
11265
11578
  return payload.data;
11266
11579
  }
11267
11580
  }
11268
- clipboard.default = Clipboard;
11581
+ clipboard.Clipboard = Clipboard;
11269
11582
 
11270
11583
  var externalApplication = {};
11271
11584
 
@@ -11280,7 +11593,7 @@ const base_1$c = base;
11280
11593
  /**
11281
11594
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
11282
11595
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
11283
- * Discovery of connections is provided by <a href="tutorial-System.getAllExternalApplications.html">getAllExternalApplications.</a>
11596
+ * Discovery of connections is provided by {@link System.System.getAllExternalApplications getAllExternalApplications}.</a>
11284
11597
  *
11285
11598
  * Processes that can be wrapped as `ExternalApplication`s include the following:
11286
11599
  * - Processes which have connected to an OpenFin runtime via an adapter
@@ -11391,8 +11704,12 @@ class ExternalApplication extends base_1$c.EmitterBase {
11391
11704
  Instance$4.ExternalApplication = ExternalApplication;
11392
11705
 
11393
11706
  Object.defineProperty(Factory$5, "__esModule", { value: true });
11707
+ Factory$5.ExternalApplicationModule = void 0;
11394
11708
  const base_1$b = base;
11395
11709
  const Instance_1$4 = Instance$4;
11710
+ /**
11711
+ * Static namespace for OpenFin API methods that interact with the {@link ExternalApplication} class, available under `fin.ExternalApplication`.
11712
+ */
11396
11713
  class ExternalApplicationModule extends base_1$b.Base {
11397
11714
  /**
11398
11715
  * Asynchronously returns an External Application object that represents an external application.
@@ -11406,7 +11723,6 @@ class ExternalApplicationModule extends base_1$b.Base {
11406
11723
  * .then(extApp => console.log('wrapped external application'))
11407
11724
  * .catch(err => console.log(err));
11408
11725
  * ```
11409
- * @static
11410
11726
  */
11411
11727
  wrap(uuid) {
11412
11728
  this.wire.sendAction('external-application-wrap').catch((e) => {
@@ -11426,7 +11742,6 @@ class ExternalApplicationModule extends base_1$b.Base {
11426
11742
  * const info = await extApp.getInfo();
11427
11743
  * console.log(info);
11428
11744
  * ```
11429
- * @static
11430
11745
  */
11431
11746
  wrapSync(uuid) {
11432
11747
  this.wire.sendAction('external-application-wrap-sync').catch((e) => {
@@ -11435,18 +11750,9 @@ class ExternalApplicationModule extends base_1$b.Base {
11435
11750
  return new Instance_1$4.ExternalApplication(this.wire, { uuid });
11436
11751
  }
11437
11752
  }
11438
- Factory$5.default = ExternalApplicationModule;
11753
+ Factory$5.ExternalApplicationModule = ExternalApplicationModule;
11439
11754
 
11440
11755
  (function (exports) {
11441
- /**
11442
- * Entry point for the OpenFin ExternalApplication namespace.
11443
- *
11444
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "ExternalApplicationModule" is used for
11445
- * the module containing static members of the `ExternalApplication` namespace (available under `fin.ExternalApplication`), while `ExternalApplication`
11446
- * documents instances of the OpenFin `ExternalApplication` class.
11447
- *
11448
- * @packageDocumentation
11449
- */
11450
11756
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
11451
11757
  if (k2 === undefined) k2 = k;
11452
11758
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -11462,8 +11768,18 @@ Factory$5.default = ExternalApplicationModule;
11462
11768
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
11463
11769
  };
11464
11770
  Object.defineProperty(exports, "__esModule", { value: true });
11465
- const Factory_1 = Factory$5;
11466
- exports.default = Factory_1.default;
11771
+ /**
11772
+ * Entry points for the OpenFin `ExternalApplication` API (`fin.ExternalApplication`).
11773
+ *
11774
+ * * {@link ExternalApplicationModule} contains static members of the `ExternalApplication` type, accessible through `fin.ExternalApplication`.
11775
+ * * {@link ExternalApplication} describes an instance of an OpenFin ExternalApplication, e.g. as returned by `fin.ExternalApplication.getCurrent`.
11776
+ *
11777
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
11778
+ * both of these were documented on the same page.
11779
+ *
11780
+ * @packageDocumentation
11781
+ */
11782
+ __exportStar(Factory$5, exports);
11467
11783
  __exportStar(Instance$4, exports);
11468
11784
  } (externalApplication));
11469
11785
 
@@ -11617,9 +11933,13 @@ class _Frame extends base_1$a.EmitterBase {
11617
11933
  Instance$3._Frame = _Frame;
11618
11934
 
11619
11935
  Object.defineProperty(Factory$4, "__esModule", { value: true });
11936
+ Factory$4._FrameModule = void 0;
11620
11937
  const base_1$9 = base;
11621
11938
  const validate_1$2 = validate;
11622
11939
  const Instance_1$3 = Instance$3;
11940
+ /**
11941
+ * Static namespace for OpenFin API methods that interact with the {@link _Frame} class, available under `fin.Frame`.
11942
+ */
11623
11943
  class _FrameModule extends base_1$9.Base {
11624
11944
  /**
11625
11945
  * Asynchronously returns a reference to the specified frame. The frame does not have to exist
@@ -11631,7 +11951,6 @@ class _FrameModule extends base_1$9.Base {
11631
11951
  * .then(frm => console.log('wrapped frame'))
11632
11952
  * .catch(err => console.log(err));
11633
11953
  * ```
11634
- * @static
11635
11954
  */
11636
11955
  async wrap(identity) {
11637
11956
  this.wire.sendAction('frame-wrap').catch((e) => {
@@ -11653,7 +11972,6 @@ class _FrameModule extends base_1$9.Base {
11653
11972
  * const info = await frm.getInfo();
11654
11973
  * console.log(info);
11655
11974
  * ```
11656
- * @static
11657
11975
  */
11658
11976
  wrapSync(identity) {
11659
11977
  this.wire.sendAction('frame-wrap-sync').catch((e) => {
@@ -11674,7 +11992,6 @@ class _FrameModule extends base_1$9.Base {
11674
11992
  * .then(frm => console.log('current frame'))
11675
11993
  * .catch(err => console.log(err));
11676
11994
  * ```
11677
- * @static
11678
11995
  */
11679
11996
  getCurrent() {
11680
11997
  this.wire.sendAction('frame-get-current').catch((e) => {
@@ -11691,7 +12008,6 @@ class _FrameModule extends base_1$9.Base {
11691
12008
  * const info = await frm.getInfo();
11692
12009
  * console.log(info);
11693
12010
  * ```
11694
- * @static
11695
12011
  */
11696
12012
  getCurrentSync() {
11697
12013
  this.wire.sendAction('frame-get-current-sync').catch((e) => {
@@ -11700,17 +12016,19 @@ class _FrameModule extends base_1$9.Base {
11700
12016
  return new Instance_1$3._Frame(this.wire, this.wire.environment.getCurrentEntityIdentity());
11701
12017
  }
11702
12018
  }
11703
- Factory$4.default = _FrameModule;
12019
+ Factory$4._FrameModule = _FrameModule;
11704
12020
 
11705
12021
  (function (exports) {
11706
12022
  /**
11707
- * Entry point for the OpenFin Frame namespace.
12023
+ * Entry points for the OpenFin `Frame` API (`fin.Frame`).
12024
+ *
12025
+ * * {@link _FrameModule} contains static members of the `Frame` API, accessible through `fin.Frame`.
12026
+ * * {@link _Frame} describes an instance of an OpenFin Frame, e.g. as returned by `fin.Frame.getCurrent`.
11708
12027
  *
11709
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "FrameModule" is used for
11710
- * the module containing static members of the `Frame` namespace (available under `fin.Frame`), while `Frame` documents
11711
- * instances of the OpenFin `Frame` class.
12028
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
12029
+ * both of these were documented on the same page.
11712
12030
  *
11713
- * Because the `Frame` name aliases a DOM entity, the documentation pipeline prefixes the name with an underscore.
12031
+ * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
11714
12032
  *
11715
12033
  * @packageDocumentation
11716
12034
  */
@@ -11729,14 +12047,14 @@ Factory$4.default = _FrameModule;
11729
12047
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
11730
12048
  };
11731
12049
  Object.defineProperty(exports, "__esModule", { value: true });
11732
- const Factory_1 = Factory$4;
11733
- exports.default = Factory_1.default;
12050
+ __exportStar(Factory$4, exports);
11734
12051
  __exportStar(Instance$3, exports);
11735
12052
  } (frame));
11736
12053
 
11737
12054
  var globalHotkey = {};
11738
12055
 
11739
12056
  Object.defineProperty(globalHotkey, "__esModule", { value: true });
12057
+ globalHotkey.GlobalHotkey = void 0;
11740
12058
  const base_1$8 = base;
11741
12059
  /**
11742
12060
  * The GlobalHotkey module can register/unregister a global hotkeys.
@@ -11866,7 +12184,7 @@ class GlobalHotkey extends base_1$8.EmitterBase {
11866
12184
  return data;
11867
12185
  }
11868
12186
  }
11869
- globalHotkey.default = GlobalHotkey;
12187
+ globalHotkey.GlobalHotkey = GlobalHotkey;
11870
12188
 
11871
12189
  var platform = {};
11872
12190
 
@@ -11889,10 +12207,8 @@ const validate_1$1 = validate;
11889
12207
  const clientMap = new Map();
11890
12208
  /** Manages the life cycle of windows and views in the application.
11891
12209
  *
11892
- * Enables taking snapshots of itself and applyi
11893
- * ng them to restore a previous configuration
12210
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
11894
12211
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
11895
- *
11896
12212
  */
11897
12213
  class Platform extends base_1$7.EmitterBase {
11898
12214
  /**
@@ -12251,12 +12567,11 @@ class Platform extends base_1$7.EmitterBase {
12251
12567
  });
12252
12568
  }
12253
12569
  /**
12254
- * ***DEPRECATED - please use Platform.createView.***
12570
+ * ***DEPRECATED - please use {@link Platform.createView Platform.createView}.***
12255
12571
  * Reparents a specified view in a new target window.
12256
12572
  * @param viewIdentity View identity
12257
12573
  * @param target new owner window identity
12258
12574
  *
12259
- * @tutorial Platform.createView
12260
12575
  */
12261
12576
  async reparentView(viewIdentity, target) {
12262
12577
  var _a;
@@ -12750,6 +13065,138 @@ const base_1$6 = base;
12750
13065
  const common_utils_1 = commonUtils;
12751
13066
  const layout_entities_1 = layoutEntities;
12752
13067
  const layout_constants_1 = layout_constants;
13068
+ /**
13069
+ *
13070
+ * Layouts give app providers the ability to embed multiple views in a single window. The Layout namespace
13071
+ * enables the initialization and manipulation of a window's Layout. A Layout will
13072
+ * emit events locally on the DOM element representing the layout-container.
13073
+ *
13074
+ *
13075
+ * ### Layout.DOMEvents
13076
+ *
13077
+ * When a Layout is created, it emits events onto the DOM element representing the Layout container.
13078
+ * This Layout container is the DOM element referenced by containerId in {@link Layout.LayoutModule#init Layout.init}.
13079
+ * You can use the built-in event emitter to listen to these events using [addEventListener](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener).
13080
+ * The events are emitted synchronously and only in the process where the Layout exists.
13081
+ * Any values returned by the called listeners are ignored and will be discarded.
13082
+ * If the target DOM element is destroyed, any events that have been set up on that element will be destroyed.
13083
+ *
13084
+ * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
13085
+ *
13086
+ * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
13087
+ * Adds a listener to the end of the listeners array for the specified event.
13088
+ * @example
13089
+ * ```js
13090
+ * const myLayoutContainer = document.getElementById('layout-container');
13091
+ *
13092
+ * myLayoutContainer.addEventListener('tab-created', function(event) {
13093
+ * const { tabSelector } = event.detail;
13094
+ * const tabElement = document.getElementById(tabSelector);
13095
+ * const existingColor = tabElement.style.backgroundColor;
13096
+ * tabElement.style.backgroundColor = "red";
13097
+ * setTimeout(() => {
13098
+ * tabElement.style.backgroundColor = existingColor;
13099
+ * }, 2000);
13100
+ * });
13101
+ * ```
13102
+ *
13103
+ * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
13104
+ * Adds a listener to the end of the listeners array for the specified event.
13105
+ * @example
13106
+ * ```js
13107
+ * const myLayoutContainer = document.getElementById('layout-container');
13108
+ *
13109
+ * const listener = function(event) {
13110
+ * console.log(event.detail);
13111
+ * console.log('container-created event fired once, removing listener');
13112
+ * myLayoutContainer.removeEventListener('container-created', listener);
13113
+ * };
13114
+ *
13115
+ * myLayoutContainer.addEventListener('container-created', listener);
13116
+ * ```
13117
+ *
13118
+ * ### Supported event types are:
13119
+ *
13120
+ * * tab-created
13121
+ * * container-created
13122
+ * * layout-state-changed
13123
+ * * tab-closed
13124
+ * * tab-dropped
13125
+ *
13126
+ * ### Layout DOM Node Events
13127
+ *
13128
+ * #### tab-created
13129
+ * Generated when a tab is created. As a user drags and drops tabs within window, new tabs are created. A single view may have multiple tabs created and destroyed during its lifetime attached to a single window.
13130
+ * ```js
13131
+ * // The response has the following shape in event.detail:
13132
+ * {
13133
+ * containerSelector: "container-component_A",
13134
+ * name: "component_A",
13135
+ * tabSelector: "tab-component_A",
13136
+ * topic: "openfin-DOM-event",
13137
+ * type: "tab-created",
13138
+ * uuid: "OpenFin POC"
13139
+ * }
13140
+ * ```
13141
+ *
13142
+ * #### container-created
13143
+ * Generated when a container is created. A single view will have only one container during its lifetime attached to a single window and the container's lifecycle is tied to the view. To discover when the container is destroyed, please listen to view-detached event.
13144
+ * ```js
13145
+ * // The response has the following shape in event.detail:
13146
+ * {
13147
+ * containerSelector: "container-component_A",
13148
+ * name: "component_A",
13149
+ * tabSelector: "tab-component_A",
13150
+ * topic: "openfin-DOM-event",
13151
+ * type: "container-created",
13152
+ * uuid: "OpenFin POC"
13153
+ * }
13154
+ * ```
13155
+ *
13156
+ * ### layout-state-changed
13157
+ * Generated when the state of the layout changes in any way, such as a view added/removed/replaced. Note that this event can fire frequently as the underlying layout can change multiple components from all kinds of changes (resizing for example). Given this, it is recommended to debounce this event and then you can use the {@link Layout#getConfig Layout.getConfig} API to retrieve the most up-to-date state.
13158
+ * ```js
13159
+ * // The response has the following shape in event.detail
13160
+ * {
13161
+ * containerSelector: "container-component_A",
13162
+ * name: "component_A",
13163
+ * tabSelector: "tab-component_A",
13164
+ * topic: "openfin-DOM-event",
13165
+ * type: "layout-state-changed",
13166
+ * uuid: "OpenFin POC"
13167
+ * }
13168
+ * ```
13169
+ *
13170
+ * #### tab-closed
13171
+ * Generated when a tab is closed.
13172
+ * ```js
13173
+ * // The response has the following shape in event.detail:
13174
+ * {
13175
+ * containerSelector: "container-component_A",
13176
+ * name: "component_A",
13177
+ * tabSelector: "tab-component_A",
13178
+ * topic: "openfin-DOM-event",
13179
+ * type: "tab-closed",
13180
+ * uuid: "OpenFin POC",
13181
+ * url: "http://openfin.co" // The url of the view that was closed.
13182
+ * }
13183
+ * ```
13184
+ *
13185
+ * #### tab-dropped
13186
+ * Generated when a tab is dropped.
13187
+ * ```js
13188
+ * // The response has the following shape in event.detail:
13189
+ * {
13190
+ * containerSelector: "container-component_A",
13191
+ * name: "component_A",
13192
+ * tabSelector: "tab-component_A",
13193
+ * topic: "openfin-DOM-event",
13194
+ * type: "tab-dropped",
13195
+ * uuid: "OpenFin POC",
13196
+ * url: "http://openfin.co" // The url of the view linked to the dropped tab.
13197
+ * }
13198
+ * ```
13199
+ */
12753
13200
  class Layout extends base_1$6.Base {
12754
13201
  /**
12755
13202
  * @internal
@@ -12977,20 +13424,50 @@ Factory$2.LayoutModule = void 0;
12977
13424
  /* eslint-disable no-undef, import/prefer-default-export */
12978
13425
  const base_1$5 = base;
12979
13426
  const Instance_1$2 = Instance$1;
13427
+ /**
13428
+ * Static namespace for OpenFin API methods that interact with the {@link Layout} class, available under `fin.Platform.Layout`.
13429
+ */
12980
13430
  class LayoutModule extends base_1$5.Base {
12981
13431
  constructor() {
12982
13432
  super(...arguments);
12983
13433
  _LayoutModule_layoutInitializationAttempted.set(this, false);
12984
13434
  /**
12985
- * Initialize the window's Layout. Must be called from a custom window that has a 'layout' option set upon creation of that window.
13435
+ * Initialize the window's Layout.
13436
+ *
13437
+ * @remarks Must be called from a custom window that has a 'layout' option set upon creation of that window.
12986
13438
  * If a containerId is not provided, this method attempts to find an element with the id `layout-container`.
12987
- * A Layout will <a href="tutorial-Layout.DOMEvents.html">emit events locally</a> on the DOM element representing the layout-container.
13439
+ * A Layout will emit events locally on the DOM element representing the layout-container.
12988
13440
  * In order to capture the relevant events during Layout initiation, set up the listeners on the DOM element prior to calling `init`.
12989
13441
  * @param options - Layout init options.
12990
13442
  *
12991
- * @static
12992
13443
  * @experimental
12993
- * @tutorial Layout.init
13444
+ *
13445
+ * @example
13446
+ * ```js
13447
+ * // If no options are included, the layout in the window options is initialized in an element with the id `layout-container`
13448
+ * const layout = await fin.Platform.Layout.init();
13449
+ * ```
13450
+ * <br>
13451
+ *
13452
+ * ```js
13453
+ * const containerId = 'my-custom-container-id';
13454
+ *
13455
+ * const myLayoutContainer = document.getElementById(containerId);
13456
+ *
13457
+ * myLayoutContainer.addEventListener('tab-created', function(event) {
13458
+ * const { tabSelector } = event.detail;
13459
+ * const tabElement = document.getElementById(tabSelector);
13460
+ * const existingColor = tabElement.style.backgroundColor;
13461
+ * tabElement.style.backgroundColor = "red";
13462
+ * setTimeout(() => {
13463
+ * tabElement.style.backgroundColor = existingColor;
13464
+ * }, 2000);
13465
+ * });
13466
+ *
13467
+ * // initialize the layout into an existing HTML element with the div `my-custom-container-id`
13468
+ * // the window must have been created with a layout in its window options
13469
+ * const layout = await fin.Platform.Layout.init({ containerId });
13470
+ * ```
12994
13471
  */
12995
13472
  this.init = async (options = {}) => {
12996
13473
  this.wire.sendAction('layout-init').catch((e) => {
@@ -13008,7 +13485,6 @@ class LayoutModule extends base_1$5.Base {
13008
13485
  }
13009
13486
  /**
13010
13487
  * Asynchronously returns a Layout object that represents a Window's layout.
13011
- * @param identity
13012
13488
  *
13013
13489
  * @example
13014
13490
  * ```js
@@ -13025,9 +13501,7 @@ class LayoutModule extends base_1$5.Base {
13025
13501
  * // Use wrapped instance to control layout, e.g.:
13026
13502
  * const layoutConfig = await layout.getConfig();
13027
13503
  * ```
13028
- * @static
13029
13504
  */
13030
- // eslint-disable-next-line class-methods-use-this
13031
13505
  async wrap(identity) {
13032
13506
  this.wire.sendAction('layout-wrap').catch((e) => {
13033
13507
  // don't expose
@@ -13036,7 +13510,6 @@ class LayoutModule extends base_1$5.Base {
13036
13510
  }
13037
13511
  /**
13038
13512
  * Synchronously returns a Layout object that represents a Window's layout.
13039
- * @param identity
13040
13513
  *
13041
13514
  * @example
13042
13515
  * ```js
@@ -13053,9 +13526,7 @@ class LayoutModule extends base_1$5.Base {
13053
13526
  * // Use wrapped instance to control layout, e.g.:
13054
13527
  * const layoutConfig = await layout.getConfig();
13055
13528
  * ```
13056
- * @static
13057
13529
  */
13058
- // eslint-disable-next-line class-methods-use-this
13059
13530
  wrapSync(identity) {
13060
13531
  this.wire.sendAction('layout-wrap-sync').catch((e) => {
13061
13532
  // don't expose
@@ -13071,7 +13542,6 @@ class LayoutModule extends base_1$5.Base {
13071
13542
  * // Use wrapped instance to control layout, e.g.:
13072
13543
  * const layoutConfig = await layout.getConfig();
13073
13544
  * ```
13074
- * @static
13075
13545
  */
13076
13546
  async getCurrent() {
13077
13547
  this.wire.sendAction('layout-get-current').catch((e) => {
@@ -13095,7 +13565,6 @@ class LayoutModule extends base_1$5.Base {
13095
13565
  * // Use wrapped instance to control layout, e.g.:
13096
13566
  * const layoutConfig = await layout.getConfig();
13097
13567
  * ```
13098
- * @static
13099
13568
  */
13100
13569
  getCurrentSync() {
13101
13570
  this.wire.sendAction('layout-get-current-sync').catch((e) => {
@@ -13113,13 +13582,16 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap();
13113
13582
 
13114
13583
  (function (exports) {
13115
13584
  /**
13116
- * Entry point for the OpenFin Layout namespace.
13585
+ * Entry point for the OpenFin `Layout` subset of the `Platform` API (`fin.Platform.Layout`).
13117
13586
  *
13118
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "LayoutModule" is used for
13119
- * the module containing static members of the `Layout` namespace (available under `fin.Platform.Layout`), while `Layout` documents
13120
- * instances of the OpenFin `Layout` class.
13587
+ * * {@link LayoutModule} contains static members of the `Layout` API, accessible through `fin.Platform.Layout`.
13588
+ * * {@link Layout} describes an instance of an OpenFin Layout, e.g. as returned by `fin.Platform.Layout.getCurrent`.
13589
+ *
13590
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
13591
+ * both of these were documented on the same page.
13121
13592
  *
13122
13593
  * @packageDocumentation
13594
+ *
13123
13595
  */
13124
13596
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
13125
13597
  if (k2 === undefined) k2 = k;
@@ -13141,9 +13613,13 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap();
13141
13613
  } (layout));
13142
13614
 
13143
13615
  Object.defineProperty(Factory$3, "__esModule", { value: true });
13616
+ Factory$3.PlatformModule = void 0;
13144
13617
  const base_1$4 = base;
13145
13618
  const Instance_1$1 = Instance$2;
13146
13619
  const index_1$1 = layout;
13620
+ /**
13621
+ * Static namespace for OpenFin API methods that interact with the {@link Platform} class, available under `fin.Platform`.
13622
+ */
13147
13623
  class PlatformModule extends base_1$4.Base {
13148
13624
  /**
13149
13625
  * @internal
@@ -13209,14 +13685,12 @@ class PlatformModule extends base_1$4.Base {
13209
13685
  * fin.Platform.init({overrideCallback});
13210
13686
  * ```
13211
13687
  * @experimental
13212
- * @static
13213
13688
  */
13214
13689
  async init(options) {
13215
13690
  return this.wire.environment.initPlatform(this.fin, options);
13216
13691
  }
13217
13692
  /**
13218
13693
  * Asynchronously returns a Platform object that represents an existing platform.
13219
- * @param identity
13220
13694
  *
13221
13695
  * @example
13222
13696
  * ```js
@@ -13225,7 +13699,6 @@ class PlatformModule extends base_1$4.Base {
13225
13699
  * // Use wrapped instance to control layout, e.g.:
13226
13700
  * const snapshot = await platform.getSnapshot();
13227
13701
  * ```
13228
- * @static
13229
13702
  */
13230
13703
  async wrap(identity) {
13231
13704
  this.wire.sendAction('platform-wrap').catch((e) => {
@@ -13235,7 +13708,6 @@ class PlatformModule extends base_1$4.Base {
13235
13708
  }
13236
13709
  /**
13237
13710
  * Synchronously returns a Platform object that represents an existing platform.
13238
- * @param identity
13239
13711
  *
13240
13712
  * @example
13241
13713
  * ```js
@@ -13244,7 +13716,6 @@ class PlatformModule extends base_1$4.Base {
13244
13716
  * // Use wrapped instance to control layout, e.g.:
13245
13717
  * const snapshot = await platform.getSnapshot();
13246
13718
  * ```
13247
- * @static
13248
13719
  */
13249
13720
  wrapSync(identity) {
13250
13721
  this.wire.sendAction('platform-wrap-sync').catch((e) => {
@@ -13261,7 +13732,6 @@ class PlatformModule extends base_1$4.Base {
13261
13732
  * // Use wrapped instance to control layout, e.g.:
13262
13733
  * const snapshot = await platform.getSnapshot();
13263
13734
  * ```
13264
- * @static
13265
13735
  */
13266
13736
  async getCurrent() {
13267
13737
  this.wire.sendAction('platform-get-current').catch((e) => {
@@ -13278,7 +13748,6 @@ class PlatformModule extends base_1$4.Base {
13278
13748
  * // Use wrapped instance to control layout, e.g.:
13279
13749
  * const snapshot = await platform.getSnapshot();
13280
13750
  * ```
13281
- * @static
13282
13751
  */
13283
13752
  getCurrentSync() {
13284
13753
  this.wire.sendAction('platform-get-current-sync').catch((e) => {
@@ -13289,7 +13758,6 @@ class PlatformModule extends base_1$4.Base {
13289
13758
  /**
13290
13759
  * Creates and starts a Platform and returns a wrapped and running Platform instance. The wrapped Platform methods can
13291
13760
  * be used to launch content into the platform. Promise will reject if the platform is already running.
13292
- * @param platformOptions
13293
13761
  *
13294
13762
  * @example
13295
13763
  * ```js
@@ -13310,7 +13778,6 @@ class PlatformModule extends base_1$4.Base {
13310
13778
  * console.error(e);
13311
13779
  * }
13312
13780
  * ```
13313
- * @static
13314
13781
  */
13315
13782
  start(platformOptions) {
13316
13783
  this.wire.sendAction('platform-start').catch((e) => {
@@ -13355,7 +13822,6 @@ class PlatformModule extends base_1$4.Base {
13355
13822
  * console.error(e);
13356
13823
  * }
13357
13824
  * ```
13358
- * @static
13359
13825
  */
13360
13826
  startFromManifest(manifestUrl, opts) {
13361
13827
  this.wire.sendAction('platform-start-from-manifest').catch((e) => {
@@ -13378,18 +13844,9 @@ class PlatformModule extends base_1$4.Base {
13378
13844
  });
13379
13845
  }
13380
13846
  }
13381
- Factory$3.default = PlatformModule;
13847
+ Factory$3.PlatformModule = PlatformModule;
13382
13848
 
13383
13849
  (function (exports) {
13384
- /**
13385
- * Entry point for the OpenFin Platform namespace.
13386
- *
13387
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "PlatformModule" is used for
13388
- * the module containing static members of the `Platform` namespace (available under `fin.Platform`), while `Platform` documents
13389
- * instances of the OpenFin `Platform` class.
13390
- *
13391
- * @packageDocumentation
13392
- */
13393
13850
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
13394
13851
  if (k2 === undefined) k2 = k;
13395
13852
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -13405,8 +13862,18 @@ Factory$3.default = PlatformModule;
13405
13862
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
13406
13863
  };
13407
13864
  Object.defineProperty(exports, "__esModule", { value: true });
13408
- const Factory_1 = Factory$3;
13409
- exports.default = Factory_1.default;
13865
+ /**
13866
+ * Entry points for the OpenFin `Platform` API (`fin.Platform`)
13867
+ *
13868
+ * * {@link PlatformModule} contains static members of the `Platform` API, accessible through `fin.Platform`.
13869
+ * * {@link Platform} describes an instance of an OpenFin Platform, e.g. as returned by `fin.Platform.getCurrent`.
13870
+ *
13871
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
13872
+ * both of these were documented on the same page.
13873
+ *
13874
+ * @packageDocumentation
13875
+ */
13876
+ __exportStar(Factory$3, exports);
13410
13877
  __exportStar(Instance$2, exports);
13411
13878
  } (platform));
13412
13879
 
@@ -14654,7 +15121,8 @@ function requireInteropBroker () {
14654
15121
  * ```
14655
15122
  */
14656
15123
  // eslint-disable-next-line class-methods-use-this
14657
- async handleFiredIntent(intent, clientIdentity) {
15124
+ async handleFiredIntent(intent, clientIdentity // TODO(CORE-811): remove inline intersected type
15125
+ ) {
14658
15126
  const warning = (0, utils_1.generateOverrideWarning)('fdc3.raiseIntent', 'InteropBroker.handleFiredIntent', clientIdentity, 'interopClient.fireIntent');
14659
15127
  console.warn(warning);
14660
15128
  throw new Error(utils_1.BROKER_ERRORS.fireIntent);
@@ -14721,7 +15189,7 @@ function requireInteropBroker () {
14721
15189
  * More information on the AppIntent type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/AppIntent).
14722
15190
  *
14723
15191
  * @param options
14724
- * @param clientIdentity Identity of the Client making the request.
15192
+ * @param clientIdentity Identity of the Client making the request.
14725
15193
  *
14726
15194
  * @example
14727
15195
  * ```js
@@ -14738,7 +15206,8 @@ function requireInteropBroker () {
14738
15206
  * ```
14739
15207
  */
14740
15208
  // eslint-disable-next-line class-methods-use-this
14741
- async handleInfoForIntent(options, clientIdentity) {
15209
+ async handleInfoForIntent(options, clientIdentity // TODO(CORE-811): remove inline intersected type
15210
+ ) {
14742
15211
  const warning = (0, utils_1.generateOverrideWarning)('fdc3.findIntent', 'InteropBroker.handleInfoForIntent', clientIdentity, 'interopClient.getInfoForIntent');
14743
15212
  console.warn(warning);
14744
15213
  throw new Error(utils_1.BROKER_ERRORS.getInfoForIntent);
@@ -14784,7 +15253,8 @@ function requireInteropBroker () {
14784
15253
  * ```
14785
15254
  */
14786
15255
  // eslint-disable-next-line class-methods-use-this
14787
- async handleInfoForIntentsByContext(context, clientIdentity) {
15256
+ async handleInfoForIntentsByContext(context, clientIdentity // TODO(CORE-811): remove inline intersected type
15257
+ ) {
14788
15258
  const warning = (0, utils_1.generateOverrideWarning)('fdc3.findIntentsByContext', 'InteropBroker.handleInfoForIntentsByContext', clientIdentity, 'interopClient.getInfoForIntentsByContext');
14789
15259
  console.warn(warning);
14790
15260
  throw new Error(utils_1.BROKER_ERRORS.getInfoForIntentsByContext);
@@ -14810,7 +15280,7 @@ function requireInteropBroker () {
14810
15280
  * More information on the IntentResolution type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/IntentResolution).
14811
15281
  *
14812
15282
  * @param contextForIntent Data passed between entities and applications.
14813
- * @param clientIdentity Identity of the Client making the request.
15283
+ * @param clientIdentity Identity of the Client making the request.
14814
15284
  *
14815
15285
  * @example
14816
15286
  * ```js
@@ -14871,7 +15341,7 @@ function requireInteropBroker () {
14871
15341
  /**
14872
15342
  * Responsible for resolving the fdc3.findInstances call.
14873
15343
  * Must be overridden
14874
- * @param app AppIdentifier that was passed to fdc3.findInstances
15344
+ * @param app AppIdentifier that was passed to fdc3.findInstances
14875
15345
  * @param clientIdentity Identity of the Client making the request.
14876
15346
  */
14877
15347
  // eslint-disable-next-line class-methods-use-this
@@ -14906,7 +15376,7 @@ function requireInteropBroker () {
14906
15376
  * fin.Platform.init({
14907
15377
  * interopOverride: async (InteropBroker) => {
14908
15378
  * class Override extends InteropBroker {
14909
- * async invokeContextHandler(options, clientIdentity) {
15379
+ * async invokeContextHandler(clientIdentity, handlerId, context) {
14910
15380
  * return super.invokeContextHandler(clientIdentity, handlerId, {
14911
15381
  * ...context,
14912
15382
  * contextMetadata: {
@@ -14946,7 +15416,7 @@ function requireInteropBroker () {
14946
15416
  * fin.Platform.init({
14947
15417
  * interopOverride: async (InteropBroker) => {
14948
15418
  * class Override extends InteropBroker {
14949
- * async invokeIntentHandler(options, clientIdentity) {
15419
+ * async invokeIntentHandler(clientIdentity, handlerId, context) {
14950
15420
  * const { context } = intent;
14951
15421
  * return super.invokeIntentHandler(clientIdentity, handlerId, {
14952
15422
  * ...intent,
@@ -15285,7 +15755,8 @@ function requireInteropBroker () {
15285
15755
  }
15286
15756
  // Setup Channel Connection Logic
15287
15757
  wireChannel(channel) {
15288
- channel.onConnection(async (clientIdentity, payload) => {
15758
+ channel.onConnection(async (clientIdentity, // TODO(CORE-811): remove inline intersected type
15759
+ payload) => {
15289
15760
  if (!(await this.isConnectionAuthorized(clientIdentity, payload))) {
15290
15761
  throw new Error(`Connection not authorized for ${clientIdentity.uuid}, ${clientIdentity.name}`);
15291
15762
  }
@@ -16212,6 +16683,7 @@ function requireFactory () {
16212
16683
  if (hasRequiredFactory) return Factory$1;
16213
16684
  hasRequiredFactory = 1;
16214
16685
  Object.defineProperty(Factory$1, "__esModule", { value: true });
16686
+ Factory$1.InteropModule = void 0;
16215
16687
  const lodash_1 = require$$3;
16216
16688
  const inaccessibleObject_1 = inaccessibleObject;
16217
16689
  const base_1 = base;
@@ -16248,7 +16720,6 @@ function requireFactory () {
16248
16720
  * const contextGroups = await interopBroker.getContextGroups();
16249
16721
  * console.log(contextGroups);
16250
16722
  * ```
16251
- * @static
16252
16723
  */
16253
16724
  async init(name, override = defaultOverride) {
16254
16725
  var _a;
@@ -16306,7 +16777,6 @@ function requireFactory () {
16306
16777
  * const contextGroupInfo = await client.getInfoForContextGroup();
16307
16778
  * console.log(contextGroupInfo);
16308
16779
  * ```
16309
- * @static
16310
16780
  */
16311
16781
  connectSync(name, interopConfig) {
16312
16782
  this.wire.sendAction('interop-connect-sync').catch(() => {
@@ -16315,7 +16785,7 @@ function requireFactory () {
16315
16785
  return new InteropClient_1.InteropClient(this.wire, name, interopConfig);
16316
16786
  }
16317
16787
  }
16318
- Factory$1.default = InteropModule;
16788
+ Factory$1.InteropModule = InteropModule;
16319
16789
  return Factory$1;
16320
16790
  }
16321
16791
 
@@ -16326,10 +16796,10 @@ function requireInterop () {
16326
16796
  hasRequiredInterop = 1;
16327
16797
  (function (exports) {
16328
16798
  /**
16329
- * Entry point for the OpenFin Interop namespace.
16799
+ * Entry point for the OpenFin `Interop` API (`fin.Interop`).
16330
16800
  *
16331
- * "InteropModule" contains static members of the `Interop` namespace (available under `fin.Interop`), while `InteropClient` and
16332
- * `InteropBroker` document instances of their respective classes.
16801
+ * * {@link InteropModule} contains static members of the `Interop` API (available under `fin.Interop`)
16802
+ * * {@link InteropClient} and {@link InteropBroker} document instances of their respective classes.
16333
16803
  *
16334
16804
  * @packageDocumentation
16335
16805
  */
@@ -16348,8 +16818,7 @@ function requireInterop () {
16348
16818
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
16349
16819
  };
16350
16820
  Object.defineProperty(exports, "__esModule", { value: true });
16351
- const Factory_1 = requireFactory();
16352
- exports.default = Factory_1.default;
16821
+ __exportStar(requireFactory(), exports);
16353
16822
  __exportStar(InteropClient$1, exports);
16354
16823
  __exportStar(requireInteropBroker(), exports);
16355
16824
  } (interop));
@@ -16391,6 +16860,8 @@ const connectionMap = new Map();
16391
16860
  /**
16392
16861
  * Enables configuring a SnapshotSource with custom getSnapshot and applySnapshot methods.
16393
16862
  *
16863
+ * @typeParam Snapshot Implementation-defined shape of an application snapshot. Allows
16864
+ * custom snapshot implementations for legacy applications to define their own snapshot format.
16394
16865
  */
16395
16866
  class SnapshotSource extends base_1$1.Base {
16396
16867
  /**
@@ -16525,13 +16996,19 @@ Instance.SnapshotSource = SnapshotSource;
16525
16996
  _SnapshotSource_identity = new WeakMap(), _SnapshotSource_getConnection = new WeakMap(), _SnapshotSource_getClient = new WeakMap(), _SnapshotSource_startConnection = new WeakMap(), _SnapshotSource_setUpConnectionListener = new WeakMap();
16526
16997
 
16527
16998
  Object.defineProperty(Factory, "__esModule", { value: true });
16999
+ Factory.SnapshotSourceModule = void 0;
16528
17000
  const base_1 = base;
16529
17001
  const Instance_1 = Instance;
16530
17002
  const utils_1 = utils;
17003
+ /**
17004
+ * Static namespace for OpenFin API methods that interact with the {@link SnapshotSource} class, available under `fin.SnapshotSource`.
17005
+ */
16531
17006
  class SnapshotSourceModule extends base_1.Base {
16532
17007
  /**
16533
17008
  * Initializes a SnapshotSource with the getSnapshot and applySnapshot methods defined.
16534
- * @param provider
17009
+ *
17010
+ * @typeParam Snapshot Implementation-defined shape of an application snapshot. Allows
17011
+ * custom snapshot implementations for legacy applications to define their own snapshot format.
16535
17012
  *
16536
17013
  * @example
16537
17014
  * ```js
@@ -16548,7 +17025,7 @@ class SnapshotSourceModule extends base_1.Base {
16548
17025
  *
16549
17026
  * await fin.SnapshotSource.init(snapshotProvider);
16550
17027
  * ```
16551
- * @static
17028
+ *
16552
17029
  */
16553
17030
  async init(provider) {
16554
17031
  this.wire.sendAction('snapshot-source-init').catch((e) => {
@@ -16568,7 +17045,6 @@ class SnapshotSourceModule extends base_1.Base {
16568
17045
  }
16569
17046
  /**
16570
17047
  * Synchronously returns a SnapshotSource object that represents the current SnapshotSource.
16571
- * @param identity
16572
17048
  *
16573
17049
  * @example
16574
17050
  * ```js
@@ -16576,7 +17052,6 @@ class SnapshotSourceModule extends base_1.Base {
16576
17052
  * // Use wrapped instance's getSnapshot method, e.g.:
16577
17053
  * const snapshot = await snapshotSource.getSnapshot();
16578
17054
  * ```
16579
- * @static
16580
17055
  */
16581
17056
  wrapSync(identity) {
16582
17057
  this.wire.sendAction('snapshot-source-wrap-sync').catch((e) => {
@@ -16586,7 +17061,6 @@ class SnapshotSourceModule extends base_1.Base {
16586
17061
  }
16587
17062
  /**
16588
17063
  * Asynchronously returns a SnapshotSource object that represents the current SnapshotSource.
16589
- * @param identity
16590
17064
  *
16591
17065
  * @example
16592
17066
  * ```js
@@ -16594,7 +17068,6 @@ class SnapshotSourceModule extends base_1.Base {
16594
17068
  * // Use wrapped instance's getSnapshot method, e.g.:
16595
17069
  * const snapshot = await snapshotSource.getSnapshot();
16596
17070
  * ```
16597
- * @static
16598
17071
  */
16599
17072
  async wrap(identity) {
16600
17073
  this.wire.sendAction('snapshot-source-wrap').catch((e) => {
@@ -16603,15 +17076,17 @@ class SnapshotSourceModule extends base_1.Base {
16603
17076
  return this.wrapSync(identity);
16604
17077
  }
16605
17078
  }
16606
- Factory.default = SnapshotSourceModule;
17079
+ Factory.SnapshotSourceModule = SnapshotSourceModule;
16607
17080
 
16608
17081
  (function (exports) {
16609
17082
  /**
16610
- * Entry point for the OpenFin SnapshotSource namespace.
17083
+ * Entry points for the OpenFin `SnapshotSource` API (`fin.SnapshotSource`).
16611
17084
  *
16612
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "SnapshotSourceModule" is used for
16613
- * the module containing static members of the `SnapshotSource` namespace (available under `fin.SnapshotSource`), while `SnapshotSource` documents
16614
- * instances of the OpenFin `SnapshotSource` class.
17085
+ * * {@link SnapshotSourceModule} contains static members of the `SnapshotSource` API, accessible through `fin.SnapshotSource`.
17086
+ * * {@link SnapshotSource} describes an instance of an OpenFin SnapshotSource, e.g. as returned by `fin.SnapshotSource.wrap`.
17087
+ *
17088
+ * These are separate code entities, and are documented separately. In the [previous version of the API documentation](https://cdn.openfin.co/docs/javascript/canary/index.html),
17089
+ * both of these were documented on the same page.
16615
17090
  *
16616
17091
  * @packageDocumentation
16617
17092
  */
@@ -16630,12 +17105,12 @@ Factory.default = SnapshotSourceModule;
16630
17105
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
16631
17106
  };
16632
17107
  Object.defineProperty(exports, "__esModule", { value: true });
16633
- const Factory_1 = Factory;
16634
- exports.default = Factory_1.default;
17108
+ __exportStar(Factory, exports);
16635
17109
  __exportStar(Instance, exports);
16636
17110
  } (snapshotSource));
16637
17111
 
16638
17112
  Object.defineProperty(fin, "__esModule", { value: true });
17113
+ fin.Fin = void 0;
16639
17114
  const events_1$3 = eventsExports;
16640
17115
  // Import from the file rather than the directory in case someone consuming types is using module resolution other than "node"
16641
17116
  const index_1 = system;
@@ -16651,6 +17126,9 @@ const index_10 = platform;
16651
17126
  const me_1$2 = me;
16652
17127
  const interop_1 = requireInterop();
16653
17128
  const snapshot_source_1 = snapshotSource;
17129
+ /**
17130
+ * @internal
17131
+ */
16654
17132
  class Fin extends events_1$3.EventEmitter {
16655
17133
  /**
16656
17134
  * @internal
@@ -16658,18 +17136,18 @@ class Fin extends events_1$3.EventEmitter {
16658
17136
  constructor(wire) {
16659
17137
  super();
16660
17138
  this.wire = wire;
16661
- this.System = new index_1.default(wire);
16662
- this.Window = new index_2.default(wire);
16663
- this.Application = new index_3.default(wire);
16664
- this.InterApplicationBus = new index_4.default(wire);
16665
- this.Clipboard = new index_5.default(wire);
16666
- this.ExternalApplication = new index_6.default(wire);
16667
- this.Frame = new index_7.default(wire);
16668
- this.GlobalHotkey = new index_8.default(wire);
16669
- this.Platform = new index_10.default(wire, this.InterApplicationBus.Channel);
16670
- this.View = new index_9.default(wire);
16671
- this.Interop = new interop_1.default(wire);
16672
- this.SnapshotSource = new snapshot_source_1.default(wire);
17139
+ this.System = new index_1.System(wire);
17140
+ this.Window = new index_2._WindowModule(wire);
17141
+ this.Application = new index_3.ApplicationModule(wire);
17142
+ this.InterApplicationBus = new index_4.InterApplicationBus(wire);
17143
+ this.Clipboard = new index_5.Clipboard(wire);
17144
+ this.ExternalApplication = new index_6.ExternalApplicationModule(wire);
17145
+ this.Frame = new index_7._FrameModule(wire);
17146
+ this.GlobalHotkey = new index_8.GlobalHotkey(wire);
17147
+ this.Platform = new index_10.PlatformModule(wire, this.InterApplicationBus.Channel);
17148
+ this.View = new index_9.ViewModule(wire);
17149
+ this.Interop = new interop_1.InteropModule(wire);
17150
+ this.SnapshotSource = new snapshot_source_1.SnapshotSourceModule(wire);
16673
17151
  wire.registerFin(this);
16674
17152
  this.me = (0, me_1$2.getMe)(wire);
16675
17153
  // Handle disconnect events
@@ -16678,7 +17156,7 @@ class Fin extends events_1$3.EventEmitter {
16678
17156
  });
16679
17157
  }
16680
17158
  }
16681
- fin.default = Fin;
17159
+ fin.Fin = Fin;
16682
17160
 
16683
17161
  var transport = {};
16684
17162
 
@@ -17118,7 +17596,7 @@ exports.fin = mock.fin = ((typeof window !== 'undefined' && (window === null ||
17118
17596
  uuid: '',
17119
17597
  name: ''
17120
17598
  });
17121
- return new fin_1.default(transport);
17599
+ return new fin_1.Fin(transport);
17122
17600
  })());
17123
17601
  var _default = mock.default = OpenFin;
17124
17602