@openfin/node-adapter 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.
@@ -30,12 +30,16 @@ function _mergeNamespaces(n, m) {
30
30
 
31
31
  var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
32
32
 
33
+ function getDefaultExportFromCjs (x) {
34
+ return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
35
+ }
36
+
33
37
  var main$1 = {};
34
38
 
35
39
  var fin = {};
36
40
 
37
41
  var eventsExports = {};
38
- var events = {
42
+ var events$1 = {
39
43
  get exports(){ return eventsExports; },
40
44
  set exports(v){ eventsExports = v; },
41
45
  };
@@ -72,7 +76,7 @@ var NumberIsNaN = Number.isNaN || function NumberIsNaN(value) {
72
76
  function EventEmitter() {
73
77
  EventEmitter.init.call(this);
74
78
  }
75
- events.exports = EventEmitter;
79
+ events$1.exports = EventEmitter;
76
80
  eventsExports.once = once;
77
81
 
78
82
  // Backwards-compat with node 0.10.x
@@ -514,9 +518,9 @@ function eventTargetAgnosticAddListener(emitter, name, listener, flags) {
514
518
  }
515
519
  }
516
520
 
517
- var system = {};
521
+ var system$1 = {};
518
522
 
519
- var base = {};
523
+ var base$1 = {};
520
524
 
521
525
  var promises = {};
522
526
 
@@ -559,8 +563,8 @@ var __classPrivateFieldGet$f = (commonjsGlobal && commonjsGlobal.__classPrivateF
559
563
  return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
560
564
  };
561
565
  var _EmitterBase_emitterAccessor;
562
- Object.defineProperty(base, "__esModule", { value: true });
563
- base.Reply = base.EmitterBase = base.Base = void 0;
566
+ Object.defineProperty(base$1, "__esModule", { value: true });
567
+ base$1.Reply = base$1.EmitterBase = base$1.Base = void 0;
564
568
  const promises_1$2 = promises;
565
569
  class Base {
566
570
  /**
@@ -581,11 +585,18 @@ class Base {
581
585
  get fin() {
582
586
  return this.wire.getFin();
583
587
  }
588
+ /**
589
+ * Provides access to the OpenFin representation of the current code context (usually a document
590
+ * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
591
+ *
592
+ * Useful for debugging in the devtools console, where this will intelligently type itself based
593
+ * on the context in which the devtools panel was opened.
594
+ */
584
595
  get me() {
585
596
  return this.wire.me;
586
597
  }
587
598
  }
588
- base.Base = Base;
599
+ base$1.Base = Base;
589
600
  /**
590
601
  * An entity that emits OpenFin events.
591
602
  *
@@ -615,6 +626,9 @@ class EmitterBase extends Base {
615
626
  this.topic = topic;
616
627
  _EmitterBase_emitterAccessor.set(this, void 0);
617
628
  this.eventNames = () => (this.hasEmitter() ? this.getOrCreateEmitter().eventNames() : []);
629
+ /**
630
+ * @internal
631
+ */
618
632
  this.emit = (eventType, payload, ...args) => {
619
633
  return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
620
634
  };
@@ -657,16 +671,13 @@ class EmitterBase extends Base {
657
671
  // This will only be reached if unsubscribe from event that does not exist but do not want to error here
658
672
  return Promise.resolve();
659
673
  };
660
- this.addListener = this.on;
661
674
  __classPrivateFieldSet$d(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
662
675
  this.listeners = (event) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(event) : [];
663
676
  }
664
677
  /**
665
678
  * Adds a listener to the end of the listeners array for the specified event.
666
679
  *
667
- * @param eventType
668
- * @param listener
669
- * @param options
680
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
670
681
  */
671
682
  async on(eventType, listener, options) {
672
683
  await this.registerEventListener(eventType, options, (emitter) => {
@@ -676,12 +687,16 @@ class EmitterBase extends Base {
676
687
  });
677
688
  return this;
678
689
  }
690
+ /**
691
+ * Adds a listener to the end of the listeners array for the specified event.
692
+ */
693
+ async addListener(eventType, listener, options) {
694
+ return this.on(eventType, listener, options);
695
+ }
679
696
  /**
680
697
  * 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.
681
698
  *
682
- * @param eventType
683
- * @param listener
684
- * @param options
699
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
685
700
  */
686
701
  async once(eventType, listener, options) {
687
702
  const deregister = () => this.deregisterEventListener(eventType);
@@ -697,9 +712,7 @@ class EmitterBase extends Base {
697
712
  /**
698
713
  * Adds a listener to the beginning of the listeners array for the specified event.
699
714
  *
700
- * @param eventType
701
- * @param listener
702
- * @param options
715
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
703
716
  */
704
717
  async prependListener(eventType, listener, options) {
705
718
  await this.registerEventListener(eventType, options, (emitter) => {
@@ -713,9 +726,7 @@ class EmitterBase extends Base {
713
726
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
714
727
  * after which it is removed. The listener is added to the beginning of the listeners array.
715
728
  *
716
- * @param eventType
717
- * @param listener
718
- * @param options
729
+ * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
719
730
  */
720
731
  async prependOnceListener(eventType, listener, options) {
721
732
  const deregister = () => this.deregisterEventListener(eventType);
@@ -732,10 +743,6 @@ class EmitterBase extends Base {
732
743
  * Remove a listener from the listener array for the specified event.
733
744
  *
734
745
  * @remarks Caution: Calling this method changes the array indices in the listener array behind the listener.
735
- *
736
- * @param eventType
737
- * @param listener
738
- * @param options
739
746
  */
740
747
  async removeListener(eventType, listener, options) {
741
748
  const emitter = await this.deregisterEventListener(eventType, options);
@@ -762,7 +769,6 @@ class EmitterBase extends Base {
762
769
  /**
763
770
  * Removes all listeners, or those of the specified event.
764
771
  *
765
- * @param eventType
766
772
  */
767
773
  async removeAllListeners(eventType) {
768
774
  const removeByEvent = async (event) => {
@@ -787,11 +793,11 @@ class EmitterBase extends Base {
787
793
  }
788
794
  }
789
795
  }
790
- base.EmitterBase = EmitterBase;
796
+ base$1.EmitterBase = EmitterBase;
791
797
  _EmitterBase_emitterAccessor = new WeakMap();
792
798
  class Reply {
793
799
  }
794
- base.Reply = Reply;
800
+ base$1.Reply = Reply;
795
801
 
796
802
  var transportErrors = {};
797
803
 
@@ -874,7 +880,7 @@ class RuntimeError extends Error {
874
880
  }
875
881
  transportErrors.RuntimeError = RuntimeError;
876
882
 
877
- var window$1 = {};
883
+ var window$2 = {};
878
884
 
879
885
  var Factory$8 = {};
880
886
 
@@ -893,25 +899,45 @@ validate.validateIdentity = validateIdentity;
893
899
 
894
900
  var Instance$7 = {};
895
901
 
896
- var application = {};
902
+ var application$1 = {};
897
903
 
898
904
  var Factory$7 = {};
899
905
 
900
906
  var Instance$6 = {};
901
907
 
902
- var view = {};
908
+ var view$1 = {};
903
909
 
904
910
  var Factory$6 = {};
905
911
 
912
+ var warnings = {};
913
+
914
+ Object.defineProperty(warnings, "__esModule", { value: true });
915
+ warnings.handleDeprecatedWarnings = void 0;
916
+ const handleDeprecatedWarnings = (options) => {
917
+ var _a, _b, _c, _d;
918
+ if (((_a = options.contentNavigation) === null || _a === void 0 ? void 0 : _a.whitelist) ||
919
+ ((_b = options.contentNavigation) === null || _b === void 0 ? void 0 : _b.blacklist) ||
920
+ ((_c = options.contentRedirect) === null || _c === void 0 ? void 0 : _c.whitelist) ||
921
+ ((_d = options.contentRedirect) === null || _d === void 0 ? void 0 : _d.blacklist)) {
922
+ 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'.`);
923
+ }
924
+ };
925
+ warnings.handleDeprecatedWarnings = handleDeprecatedWarnings;
926
+
906
927
  var hasRequiredFactory$3;
907
928
 
908
929
  function requireFactory$3 () {
909
930
  if (hasRequiredFactory$3) return Factory$6;
910
931
  hasRequiredFactory$3 = 1;
911
932
  Object.defineProperty(Factory$6, "__esModule", { value: true });
912
- const base_1 = base;
933
+ Factory$6.ViewModule = void 0;
934
+ const base_1 = base$1;
913
935
  const validate_1 = validate;
914
936
  const index_1 = requireView();
937
+ const warnings_1 = warnings;
938
+ /**
939
+ * Static namespace for OpenFin API methods that interact with the {@link View} class, available under `fin.View`.
940
+ */
915
941
  class ViewModule extends base_1.Base {
916
942
  /**
917
943
  * Creates a new View.
@@ -940,13 +966,13 @@ function requireFactory$3 () {
940
966
  * ```
941
967
  * Note that created views needs to navigate somewhere for them to actually render a website.
942
968
  * @experimental
943
- * @static
944
969
  */
945
970
  async create(options) {
946
971
  const { uuid } = this.wire.me;
947
972
  if (!options.name || typeof options.name !== 'string') {
948
973
  throw new Error('Please provide a name property as a string in order to create a View.');
949
974
  }
975
+ (0, warnings_1.handleDeprecatedWarnings)(options);
950
976
  if (this.wire.environment.childViews) {
951
977
  await this.wire.environment.createChildContent({
952
978
  entityType: 'view',
@@ -960,7 +986,6 @@ function requireFactory$3 () {
960
986
  }
961
987
  /**
962
988
  * Asynchronously returns a View object that represents an existing view.
963
- * @param identity
964
989
  *
965
990
  * @example
966
991
  * ```js
@@ -969,7 +994,6 @@ function requireFactory$3 () {
969
994
  * .catch(err => console.log(err));
970
995
  * ```
971
996
  * @experimental
972
- * @static
973
997
  */
974
998
  async wrap(identity) {
975
999
  this.wire.sendAction('view-wrap');
@@ -981,7 +1005,6 @@ function requireFactory$3 () {
981
1005
  }
982
1006
  /**
983
1007
  * Synchronously returns a View object that represents an existing view.
984
- * @param identity
985
1008
  *
986
1009
  * @example
987
1010
  * ```js
@@ -989,7 +1012,6 @@ function requireFactory$3 () {
989
1012
  * await view.hide();
990
1013
  * ```
991
1014
  * @experimental
992
- * @static
993
1015
  */
994
1016
  wrapSync(identity) {
995
1017
  this.wire.sendAction('view-wrap-sync').catch((e) => {
@@ -1012,7 +1034,6 @@ function requireFactory$3 () {
1012
1034
  *
1013
1035
  * ```
1014
1036
  * @experimental
1015
- * @static
1016
1037
  */
1017
1038
  getCurrent() {
1018
1039
  this.wire.sendAction('view-get-current').catch((e) => {
@@ -1034,7 +1055,6 @@ function requireFactory$3 () {
1034
1055
  *
1035
1056
  * ```
1036
1057
  * @experimental
1037
- * @static
1038
1058
  */
1039
1059
  getCurrentSync() {
1040
1060
  this.wire.sendAction('view-get-current-sync').catch((e) => {
@@ -1047,7 +1067,7 @@ function requireFactory$3 () {
1047
1067
  return this.wrapSync({ uuid, name });
1048
1068
  }
1049
1069
  }
1050
- Factory$6.default = ViewModule;
1070
+ Factory$6.ViewModule = ViewModule;
1051
1071
  return Factory$6;
1052
1072
  }
1053
1073
 
@@ -1877,8 +1897,12 @@ var main = {};
1877
1897
 
1878
1898
  Object.defineProperty(main, "__esModule", { value: true });
1879
1899
  main.WebContents = void 0;
1880
- const base_1$k = base;
1900
+ const base_1$k = base$1;
1881
1901
  class WebContents extends base_1$k.EmitterBase {
1902
+ /**
1903
+ * @param identity The identity of the {@link OpenFin.WebContentsEvents WebContents}.
1904
+ * @param entityType The type of the {@link OpenFin.WebContentsEvents WebContents}.
1905
+ */
1882
1906
  constructor(wire, identity, entityType) {
1883
1907
  super(wire, entityType, identity.uuid, identity.name);
1884
1908
  this.identity = identity;
@@ -1886,10 +1910,7 @@ class WebContents extends base_1$k.EmitterBase {
1886
1910
  }
1887
1911
  /**
1888
1912
  * Gets a base64 encoded image of all or part of the WebContents.
1889
- * @function capturePage
1890
1913
  * @param options Options for the capturePage call.
1891
- * @memberOf View
1892
- * @instance
1893
1914
  *
1894
1915
  * @example
1895
1916
  *
@@ -1934,6 +1955,11 @@ class WebContents extends base_1$k.EmitterBase {
1934
1955
  * }
1935
1956
  * console.log(await wnd.capturePage(options));
1936
1957
  * ```
1958
+ *
1959
+ * @remarks
1960
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
1961
+ * We do not expose an explicit superclass for this functionality, but it does have its own
1962
+ * {@link OpenFin.WebContentsEvents event namespace}.
1937
1963
  */
1938
1964
  capturePage(options) {
1939
1965
  return this.wire.sendAction('capture-page', { options, ...this.identity }).then(({ payload }) => payload.data);
@@ -1942,9 +1968,6 @@ class WebContents extends base_1$k.EmitterBase {
1942
1968
  * Executes Javascript on the WebContents, restricted to contents you own or contents owned by
1943
1969
  * applications you have created.
1944
1970
  * @param code JavaScript code to be executed on the view.
1945
- * @function executeJavaScript
1946
- * @memberOf View
1947
- * @instance
1948
1971
  *
1949
1972
  * @example
1950
1973
  * View:
@@ -1972,6 +1995,10 @@ class WebContents extends base_1$k.EmitterBase {
1972
1995
  *
1973
1996
  * executeJavaScript(`console.log('Hello, Openfin')`).then(() => console.log('Javascript excuted')).catch(err => console.log(err));
1974
1997
  * ```
1998
+ * @remarks
1999
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2000
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2001
+ * {@link OpenFin.WebContentsEvents event namespace}.
1975
2002
  */
1976
2003
  executeJavaScript(code) {
1977
2004
  return this.wire
@@ -1980,9 +2007,6 @@ class WebContents extends base_1$k.EmitterBase {
1980
2007
  }
1981
2008
  /**
1982
2009
  * Returns the zoom level of the WebContents.
1983
- * @function getZoomLevel
1984
- * @memberOf View
1985
- * @instance
1986
2010
  *
1987
2011
  * @example
1988
2012
  * View:
@@ -2014,6 +2038,10 @@ class WebContents extends base_1$k.EmitterBase {
2014
2038
  *
2015
2039
  * getZoomLevel().then(zoomLevel => console.log(zoomLevel)).catch(err => console.log(err));
2016
2040
  * ```
2041
+ * @remarks
2042
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2043
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2044
+ * {@link OpenFin.WebContentsEvents event namespace}.
2017
2045
  */
2018
2046
  getZoomLevel() {
2019
2047
  return this.wire.sendAction('get-zoom-level', this.identity).then(({ payload }) => payload.data);
@@ -2021,9 +2049,6 @@ class WebContents extends base_1$k.EmitterBase {
2021
2049
  /**
2022
2050
  * Sets the zoom level of the WebContents.
2023
2051
  * @param level The zoom level
2024
- * @function setZoomLevel
2025
- * @memberOf View
2026
- * @instance
2027
2052
  *
2028
2053
  * @example
2029
2054
  * View:
@@ -2055,6 +2080,10 @@ class WebContents extends base_1$k.EmitterBase {
2055
2080
  *
2056
2081
  * setZoomLevel(4).then(() => console.log('Setting a zoom level')).catch(err => console.log(err));
2057
2082
  * ```
2083
+ * @remarks
2084
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2085
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2086
+ * {@link OpenFin.WebContentsEvents event namespace}.
2058
2087
  */
2059
2088
  setZoomLevel(level) {
2060
2089
  return this.wire.sendAction('set-zoom-level', { ...this.identity, level }).then(() => undefined);
@@ -2062,12 +2091,9 @@ class WebContents extends base_1$k.EmitterBase {
2062
2091
  /**
2063
2092
  * Navigates the WebContents to a specified URL.
2064
2093
  *
2065
- * @remarks The url must contain the protocol prefix such as http:// or https://.
2094
+ * Note: The url must contain the protocol prefix such as http:// or https://.
2066
2095
  * @param url - The URL to navigate the WebContents to.
2067
2096
  *
2068
- * @function navigate
2069
- * @memberof View
2070
- * @instance
2071
2097
  * @example
2072
2098
  * View:
2073
2099
  * ```js
@@ -2095,15 +2121,16 @@ class WebContents extends base_1$k.EmitterBase {
2095
2121
  * navigate().then(() => console.log('Navigate to tutorial')).catch(err => console.log(err));
2096
2122
  * ```
2097
2123
  * @experimental
2124
+ * @remarks
2125
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2126
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2127
+ * {@link OpenFin.WebContentsEvents event namespace}.
2098
2128
  */
2099
2129
  navigate(url) {
2100
2130
  return this.wire.sendAction('navigate-window', { ...this.identity, url }).then(() => undefined);
2101
2131
  }
2102
2132
  /**
2103
2133
  * Navigates the WebContents back one page.
2104
- * @function navigateBack
2105
- * @memberOf View
2106
- * @instance
2107
2134
  *
2108
2135
  * @example
2109
2136
  * View:
@@ -2125,15 +2152,16 @@ class WebContents extends base_1$k.EmitterBase {
2125
2152
  * }
2126
2153
  * navigateBack().then(() => console.log('Navigated back')).catch(err => console.log(err));
2127
2154
  * ```
2155
+ * @remarks
2156
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2157
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2158
+ * {@link OpenFin.WebContentsEvents event namespace}.
2128
2159
  */
2129
2160
  navigateBack() {
2130
2161
  return this.wire.sendAction('navigate-window-back', { ...this.identity }).then(() => undefined);
2131
2162
  }
2132
2163
  /**
2133
2164
  * Navigates the WebContents forward one page.
2134
- * @function navigateForward
2135
- * @memberOf View
2136
- * @instance
2137
2165
  *
2138
2166
  * @example
2139
2167
  * View:
@@ -2157,15 +2185,16 @@ class WebContents extends base_1$k.EmitterBase {
2157
2185
  * }
2158
2186
  * navigateForward().then(() => console.log('Navigated forward')).catch(err => console.log(err));
2159
2187
  * ```
2188
+ * @remarks
2189
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2190
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2191
+ * {@link OpenFin.WebContentsEvents event namespace}.
2160
2192
  */
2161
2193
  async navigateForward() {
2162
2194
  await this.wire.sendAction('navigate-window-forward', { ...this.identity });
2163
2195
  }
2164
2196
  /**
2165
2197
  * Stops any current navigation the WebContents is performing.
2166
- * @function stopNavigation
2167
- * @memberOf View
2168
- * @instance
2169
2198
  *
2170
2199
  * @example
2171
2200
  * View:
@@ -2187,15 +2216,16 @@ class WebContents extends base_1$k.EmitterBase {
2187
2216
  * }
2188
2217
  * stopNavigation().then(() => console.log('you shall not navigate')).catch(err => console.log(err));
2189
2218
  * ```
2219
+ * @remarks
2220
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2221
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2222
+ * {@link OpenFin.WebContentsEvents event namespace}.
2190
2223
  */
2191
2224
  stopNavigation() {
2192
2225
  return this.wire.sendAction('stop-window-navigation', { ...this.identity }).then(() => undefined);
2193
2226
  }
2194
2227
  /**
2195
2228
  * Reloads the WebContents
2196
- * @function reload
2197
- * @memberOf View
2198
- * @instance
2199
2229
  *
2200
2230
  * @example
2201
2231
  * View:
@@ -2227,6 +2257,10 @@ class WebContents extends base_1$k.EmitterBase {
2227
2257
  * console.log('Reloaded window')
2228
2258
  * }).catch(err => console.log(err));
2229
2259
  * ```
2260
+ * @remarks
2261
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2262
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2263
+ * {@link OpenFin.WebContentsEvents event namespace}.
2230
2264
  */
2231
2265
  reload(ignoreCache = false) {
2232
2266
  return this.wire
@@ -2239,11 +2273,8 @@ class WebContents extends base_1$k.EmitterBase {
2239
2273
  /**
2240
2274
  * Prints the WebContents.
2241
2275
  * @param options Printer Options
2242
- * @function print
2243
- * @memberOf View
2244
- * @instance
2245
2276
  *
2246
- * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
2277
+ * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
2247
2278
  * is empty and the default settings for printing.
2248
2279
  *
2249
2280
  * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -2256,6 +2287,10 @@ class WebContents extends base_1$k.EmitterBase {
2256
2287
  * console.log('print call has been sent to the system');
2257
2288
  * });
2258
2289
  * ```
2290
+ * @remarks
2291
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2292
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2293
+ * {@link OpenFin.WebContentsEvents event namespace}.
2259
2294
  */
2260
2295
  print(options = {}) {
2261
2296
  return this.wire.sendAction('print', { ...this.identity, options }).then(() => undefined);
@@ -2264,11 +2299,8 @@ class WebContents extends base_1$k.EmitterBase {
2264
2299
  * Find and highlight text on a page.
2265
2300
  * @param searchTerm Term to find in page
2266
2301
  * @param options Search options
2267
- * @function findInPage
2268
- * @memberOf View
2269
- * @instance
2270
2302
  *
2271
- * @remarks By default, each subsequent call will highlight the next text that matches the search term.
2303
+ * Note: By default, each subsequent call will highlight the next text that matches the search term.
2272
2304
  *
2273
2305
  * Returns a promise with the results for the request. By subscribing to the
2274
2306
  * found-in-page event, you can get the results of this call as well.
@@ -2303,6 +2335,10 @@ class WebContents extends base_1$k.EmitterBase {
2303
2335
  * console.log(result)
2304
2336
  * });
2305
2337
  * ```
2338
+ * @remarks
2339
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2340
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2341
+ * {@link OpenFin.WebContentsEvents event namespace}.
2306
2342
  */
2307
2343
  findInPage(searchTerm, options) {
2308
2344
  return this.wire
@@ -2346,6 +2382,10 @@ class WebContents extends base_1$k.EmitterBase {
2346
2382
  * console.log(results);
2347
2383
  * });
2348
2384
  * ```
2385
+ * @remarks
2386
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2387
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2388
+ * {@link OpenFin.WebContentsEvents event namespace}.
2349
2389
  */
2350
2390
  stopFindInPage(action) {
2351
2391
  return this.wire.sendAction('stop-find-in-page', { ...this.identity, action }).then(() => undefined);
@@ -2353,9 +2393,6 @@ class WebContents extends base_1$k.EmitterBase {
2353
2393
  /**
2354
2394
  * Returns an array with all system printers
2355
2395
  * @deprecated use System.getPrinters instead
2356
- * @function getPrinters
2357
- * @memberOf View
2358
- * @instance
2359
2396
  *
2360
2397
  * @example
2361
2398
  * View:
@@ -2391,6 +2428,10 @@ class WebContents extends base_1$k.EmitterBase {
2391
2428
  * console.log(err);
2392
2429
  * });
2393
2430
  * ```
2431
+ * @remarks
2432
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2433
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2434
+ * {@link OpenFin.WebContentsEvents event namespace}.
2394
2435
  */
2395
2436
  getPrinters() {
2396
2437
  return this.wire.sendAction('get-printers', { ...this.identity }).then(({ payload }) => payload.data);
@@ -2398,10 +2439,6 @@ class WebContents extends base_1$k.EmitterBase {
2398
2439
  /**
2399
2440
  * Gives focus to the WebContents.
2400
2441
  *
2401
- * @function focus
2402
- * @emits focused
2403
- * @memberOf Window
2404
- * @instance
2405
2442
  * @example
2406
2443
  * ```js
2407
2444
  * async function focusWindow() {
@@ -2417,15 +2454,16 @@ class WebContents extends base_1$k.EmitterBase {
2417
2454
  *
2418
2455
  * focusWindow().then(() => console.log('Window focused')).catch(err => console.log(err));
2419
2456
  * ```
2457
+ * @remarks
2458
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2459
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2460
+ * {@link OpenFin.WebContentsEvents event namespace}.
2420
2461
  */
2421
2462
  async focus({ emitSynthFocused } = { emitSynthFocused: true }) {
2422
2463
  await this.wire.sendAction('focus-window', { emitSynthFocused, ...this.identity });
2423
2464
  }
2424
2465
  /**
2425
2466
  * Shows the Chromium Developer Tools
2426
- * @function showDeveloperTools
2427
- * @memberOf View
2428
- * @instance
2429
2467
  *
2430
2468
  * @example
2431
2469
  * View:
@@ -2451,6 +2489,10 @@ class WebContents extends base_1$k.EmitterBase {
2451
2489
  * .then(() => console.log('Showing dev tools'))
2452
2490
  * .catch(err => console.error(err));
2453
2491
  * ```
2492
+ * @remarks
2493
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2494
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2495
+ * {@link OpenFin.WebContentsEvents event namespace}.
2454
2496
  */
2455
2497
  async showDeveloperTools() {
2456
2498
  // Note this hits the system action map in core state for legacy reasons.
@@ -2459,11 +2501,7 @@ class WebContents extends base_1$k.EmitterBase {
2459
2501
  /**
2460
2502
  * Retrieves the process information associated with a WebContents.
2461
2503
  *
2462
- * @remarks This includes any iframes associated with the WebContents
2463
- *
2464
- * @function getProcessInfo
2465
- * @memberOf View
2466
- * @instance
2504
+ * Note: This includes any iframes associated with the WebContents
2467
2505
  *
2468
2506
  * @example
2469
2507
  * View:
@@ -2477,6 +2515,10 @@ class WebContents extends base_1$k.EmitterBase {
2477
2515
  * const win = await fin.Window.getCurrent();
2478
2516
  * const processInfo = await win.getProcessInfo();
2479
2517
  * ```
2518
+ * @remarks
2519
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2520
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2521
+ * {@link OpenFin.WebContentsEvents event namespace}.
2480
2522
  */
2481
2523
  async getProcessInfo() {
2482
2524
  const { payload: { data } } = await this.wire.sendAction('get-process-info', this.identity);
@@ -2484,9 +2526,6 @@ class WebContents extends base_1$k.EmitterBase {
2484
2526
  }
2485
2527
  /**
2486
2528
  * Retrieves information on all Shared Workers.
2487
- * @function getSharedWorkers
2488
- * @memberOf View
2489
- * @instance
2490
2529
  *
2491
2530
  * @example
2492
2531
  * View:
@@ -2515,15 +2554,16 @@ class WebContents extends base_1$k.EmitterBase {
2515
2554
  * const win = await fin.Window.create(winOption);
2516
2555
  * const sharedWorkers = await win.getSharedWorkers();
2517
2556
  * ```
2557
+ * @remarks
2558
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2559
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2560
+ * {@link OpenFin.WebContentsEvents event namespace}.
2518
2561
  */
2519
2562
  async getSharedWorkers() {
2520
2563
  return this.wire.sendAction('get-shared-workers', this.identity).then(({ payload }) => payload.data);
2521
2564
  }
2522
2565
  /**
2523
2566
  * Opens the developer tools for the shared worker context.
2524
- * @function inspectSharedWorker
2525
- * @memberOf View
2526
- * @instance
2527
2567
  *
2528
2568
  * @example
2529
2569
  * View:
@@ -2552,6 +2592,10 @@ class WebContents extends base_1$k.EmitterBase {
2552
2592
  * const win = await fin.Window.create(winOption);
2553
2593
  * await win.inspectSharedWorker();
2554
2594
  * ```
2595
+ * @remarks
2596
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2597
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2598
+ * {@link OpenFin.WebContentsEvents event namespace}.
2555
2599
  */
2556
2600
  async inspectSharedWorker() {
2557
2601
  await this.wire.sendAction('inspect-shared-worker', { ...this.identity });
@@ -2559,9 +2603,6 @@ class WebContents extends base_1$k.EmitterBase {
2559
2603
  /**
2560
2604
  * Inspects the shared worker based on its ID.
2561
2605
  * @param workerId - The id of the shared worker.
2562
- * @function inspectSharedWorkerById
2563
- * @memberOf View
2564
- * @instance
2565
2606
  *
2566
2607
  * @example
2567
2608
  * View:
@@ -2592,15 +2633,16 @@ class WebContents extends base_1$k.EmitterBase {
2592
2633
  * const sharedWorkers = await win.getSharedWorkers();
2593
2634
  * await win.inspectSharedWorkerById(sharedWorkers[0].id);
2594
2635
  * ```
2636
+ * @remarks
2637
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2638
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2639
+ * {@link OpenFin.WebContentsEvents event namespace}.
2595
2640
  */
2596
2641
  async inspectSharedWorkerById(workerId) {
2597
2642
  await this.wire.sendAction('inspect-shared-worker-by-id', { ...this.identity, workerId });
2598
2643
  }
2599
2644
  /**
2600
2645
  * Opens the developer tools for the service worker context.
2601
- * @function inspectServiceWorker
2602
- * @memberOf View
2603
- * @instance
2604
2646
  *
2605
2647
  * @example
2606
2648
  * View:
@@ -2629,6 +2671,10 @@ class WebContents extends base_1$k.EmitterBase {
2629
2671
  * const win = await fin.Window.create(winOption);
2630
2672
  * await win.inspectServiceWorker();
2631
2673
  * ```
2674
+ * @remarks
2675
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2676
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2677
+ * {@link OpenFin.WebContentsEvents event namespace}.
2632
2678
  */
2633
2679
  async inspectServiceWorker() {
2634
2680
  await this.wire.sendAction('inspect-service-worker', { ...this.identity });
@@ -2636,7 +2682,7 @@ class WebContents extends base_1$k.EmitterBase {
2636
2682
  /**
2637
2683
  * Shows a popup window.
2638
2684
  *
2639
- * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
2685
+ * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
2640
2686
  *
2641
2687
  * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
2642
2688
  * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -2644,7 +2690,7 @@ class WebContents extends base_1$k.EmitterBase {
2644
2690
  * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
2645
2691
  * will be dismissed.
2646
2692
  *
2647
- * 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.
2693
+ * 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.
2648
2694
  *
2649
2695
  * @example
2650
2696
  *
@@ -2839,11 +2885,10 @@ class WebContents extends base_1$k.EmitterBase {
2839
2885
  * onPopupReady: popupWindowCallback;
2840
2886
  * });
2841
2887
  * ```
2842
- * @function showPopupWindow
2843
- * @memberOf View
2844
- * @instance
2845
- * @param options
2846
- *
2888
+ * @remarks
2889
+ * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
2890
+ * We do not expose an explicit superclass for this functionality, but it does have its own
2891
+ * {@link OpenFin.WebContentsEvents event namespace}.
2847
2892
  */
2848
2893
  async showPopupWindow(options) {
2849
2894
  this.wire.sendAction(`${this.entityType}-show-popup-window`, this.identity).catch(() => {
@@ -3128,7 +3173,6 @@ function requireInstance$2 () {
3128
3173
  * Attaches the current view to the given window identity.
3129
3174
  * Identity must be the identity of a window in the same application.
3130
3175
  * This detaches the view from its current window, and sets the view to be destroyed when its new window closes.
3131
- * @param target {Identity}
3132
3176
  *
3133
3177
  * @example
3134
3178
  * ```js
@@ -3257,7 +3301,6 @@ function requireInstance$2 () {
3257
3301
  };
3258
3302
  /**
3259
3303
  * Sets the bounds (top, left, width, height) of the view relative to its window.
3260
- * @param bounds {ViewBounds}
3261
3304
  *
3262
3305
  * @remarks View position is relative to the bounds of the window.
3263
3306
  * ({top: 0, left: 0} represents the top left corner of the window)
@@ -3422,7 +3465,6 @@ function requireInstance$2 () {
3422
3465
  };
3423
3466
  /**
3424
3467
  * Updates the view's options.
3425
- * @param options
3426
3468
  *
3427
3469
  * @example
3428
3470
  * ```js
@@ -3463,7 +3505,6 @@ function requireInstance$2 () {
3463
3505
  /**
3464
3506
  * Retrieves the window the view is currently attached to.
3465
3507
  *
3466
- * @experimental
3467
3508
  * @example
3468
3509
  * ```js
3469
3510
  * const view = fin.View.wrapSync({ uuid: 'viewUuid', name: 'viewName' });
@@ -3471,6 +3512,7 @@ function requireInstance$2 () {
3471
3512
  * .then(win => console.log('current window', win))
3472
3513
  * .catch(err => console.log(err));)
3473
3514
  * ```
3515
+ * @experimental
3474
3516
  */
3475
3517
  this.getCurrentWindow = async () => {
3476
3518
  const { payload: { data } } = await this.wire.sendAction('get-view-window', { ...this.identity });
@@ -3576,10 +3618,6 @@ function requireInstance$2 () {
3576
3618
  /**
3577
3619
  * Focuses the view
3578
3620
  *
3579
- * @function focus
3580
- * @memberof View
3581
- * @emits focused
3582
- * @instance
3583
3621
  * @example
3584
3622
  * ```js
3585
3623
  * const view = fin.View.wrapSync({ uuid: 'viewUuid', name: 'viewName' });
@@ -3602,7 +3640,7 @@ function requireInstance$2 () {
3602
3640
  var hasRequiredView;
3603
3641
 
3604
3642
  function requireView () {
3605
- if (hasRequiredView) return view;
3643
+ if (hasRequiredView) return view$1;
3606
3644
  hasRequiredView = 1;
3607
3645
  (function (exports) {
3608
3646
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -3621,19 +3659,20 @@ function requireView () {
3621
3659
  };
3622
3660
  Object.defineProperty(exports, "__esModule", { value: true });
3623
3661
  /**
3624
- * Entry point for the OpenFin View namespace.
3662
+ * Entry points for the OpenFin `View` API (`fin.View`).
3663
+ *
3664
+ * * {@link ViewModule} contains static members of the `View` API, accessible through `fin.View`.
3665
+ * * {@link View} describes an instance of an OpenFin View, e.g. as returned by `fin.View.getCurrent`.
3625
3666
  *
3626
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "ViewModule" is used for
3627
- * the module containing static members of the `View` namespace (available under `fin.View`), while `View` documents
3628
- * instances of the OpenFin `View` class.
3667
+ * 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),
3668
+ * both of these were documented on the same page.
3629
3669
  *
3630
3670
  * @packageDocumentation
3631
3671
  */
3632
- const Factory_1 = requireFactory$3();
3633
- exports.default = Factory_1.default;
3672
+ __exportStar(requireFactory$3(), exports);
3634
3673
  __exportStar(requireInstance$2(), exports);
3635
- } (view));
3636
- return view;
3674
+ } (view$1));
3675
+ return view$1;
3637
3676
  }
3638
3677
 
3639
3678
  var hasRequiredInstance$1;
@@ -3644,7 +3683,7 @@ function requireInstance$1 () {
3644
3683
  Object.defineProperty(Instance$6, "__esModule", { value: true });
3645
3684
  Instance$6.Application = void 0;
3646
3685
  /* eslint-disable import/prefer-default-export */
3647
- const base_1 = base;
3686
+ const base_1 = base$1;
3648
3687
  const window_1 = requireWindow();
3649
3688
  const view_1 = requireView();
3650
3689
  /**
@@ -4119,6 +4158,7 @@ function requireInstance$1 () {
4119
4158
  /**
4120
4159
  * Sets or removes a custom JumpList for the application. Only applicable in Windows OS.
4121
4160
  * If categories is null the previously set custom JumpList (if any) will be replaced by the standard JumpList for the app (managed by Windows).
4161
+ *
4122
4162
  * Note: If the "name" property is omitted it defaults to "tasks".
4123
4163
  * @param jumpListCategories An array of JumpList Categories to populate. If null, remove any existing JumpList configuration and set to Windows default.
4124
4164
  *
@@ -4419,6 +4459,7 @@ function requireInstance$1 () {
4419
4459
  }
4420
4460
  /**
4421
4461
  * Sets file auto download location. It's only allowed in the same application.
4462
+ *
4422
4463
  * Note: This method is restricted by default and must be enabled via
4423
4464
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
4424
4465
  * @param downloadLocation file auto download location
@@ -4444,6 +4485,7 @@ function requireInstance$1 () {
4444
4485
  }
4445
4486
  /**
4446
4487
  * 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.
4488
+ *
4447
4489
  * Note: This method is restricted by default and must be enabled via
4448
4490
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
4449
4491
  *
@@ -4470,13 +4512,16 @@ function requireFactory$2 () {
4470
4512
  if (hasRequiredFactory$2) return Factory$7;
4471
4513
  hasRequiredFactory$2 = 1;
4472
4514
  Object.defineProperty(Factory$7, "__esModule", { value: true });
4473
- const base_1 = base;
4515
+ Factory$7.ApplicationModule = void 0;
4516
+ const base_1 = base$1;
4474
4517
  const validate_1 = validate;
4475
4518
  const Instance_1 = requireInstance$1();
4519
+ /**
4520
+ * Static namespace for OpenFin API methods that interact with the {@link Application} class, available under `fin.Application`.
4521
+ */
4476
4522
  class ApplicationModule extends base_1.Base {
4477
4523
  /**
4478
4524
  * Asynchronously returns an Application object that represents an existing application.
4479
- * @param identity
4480
4525
  *
4481
4526
  * @example
4482
4527
  *
@@ -4487,7 +4532,6 @@ function requireFactory$2 () {
4487
4532
  * .catch(err => console.log(err));
4488
4533
  * ```
4489
4534
  *
4490
- * @static
4491
4535
  */
4492
4536
  async wrap(identity) {
4493
4537
  this.wire.sendAction('wrap-application').catch((e) => {
@@ -4501,7 +4545,6 @@ function requireFactory$2 () {
4501
4545
  }
4502
4546
  /**
4503
4547
  * Synchronously returns an Application object that represents an existing application.
4504
- * @param identity
4505
4548
  *
4506
4549
  * @example
4507
4550
  *
@@ -4510,7 +4553,6 @@ function requireFactory$2 () {
4510
4553
  * await app.close();
4511
4554
  * ```
4512
4555
  *
4513
- * @static
4514
4556
  */
4515
4557
  wrapSync(identity) {
4516
4558
  this.wire.sendAction('wrap-application-sync').catch((e) => {
@@ -4535,8 +4577,6 @@ function requireFactory$2 () {
4535
4577
  }
4536
4578
  /**
4537
4579
  * DEPRECATED method to create a new Application. Use {@link Application.ApplicationModule.start Application.start} instead.
4538
- * @param appOptions
4539
- *
4540
4580
  *
4541
4581
  * @example
4542
4582
  *
@@ -4565,7 +4605,6 @@ function requireFactory$2 () {
4565
4605
  }
4566
4606
  /**
4567
4607
  * Creates and starts a new Application.
4568
- * @param appOptions
4569
4608
  *
4570
4609
  * @example
4571
4610
  *
@@ -4581,8 +4620,6 @@ function requireFactory$2 () {
4581
4620
  * start().then(() => console.log('Application is running')).catch(err => console.log(err));
4582
4621
  * ```
4583
4622
  *
4584
- *
4585
- * @static
4586
4623
  */
4587
4624
  async start(appOptions) {
4588
4625
  this.wire.sendAction('start-application').catch((e) => {
@@ -4595,10 +4632,8 @@ function requireFactory$2 () {
4595
4632
  /**
4596
4633
  * Asynchronously starts a batch of applications given an array of application identifiers and manifestUrls.
4597
4634
  * Returns once the RVM is finished attempting to launch the applications.
4598
- * @param applications
4599
4635
  * @param opts - Parameters that the RVM will use.
4600
4636
  *
4601
- * @static
4602
4637
  * @example
4603
4638
  *
4604
4639
  * ```js
@@ -4650,8 +4685,6 @@ function requireFactory$2 () {
4650
4685
  * });
4651
4686
  *
4652
4687
  * ```
4653
- *
4654
- * @static
4655
4688
  */
4656
4689
  getCurrent() {
4657
4690
  this.wire.sendAction('get-current-application').catch((e) => {
@@ -4677,8 +4710,6 @@ function requireFactory$2 () {
4677
4710
  * });
4678
4711
  *
4679
4712
  * ```
4680
- *
4681
- * @static
4682
4713
  */
4683
4714
  getCurrentSync() {
4684
4715
  this.wire.sendAction('get-current-application-sync').catch((e) => {
@@ -4699,8 +4730,6 @@ function requireFactory$2 () {
4699
4730
  * // For a local manifest file:
4700
4731
  * fin.Application.startFromManifest('file:///C:/somefolder/app.json').then(app => console.log('App is running')).catch(err => console.log(err));
4701
4732
  * ```
4702
- *
4703
- * @static
4704
4733
  */
4705
4734
  async startFromManifest(manifestUrl, opts) {
4706
4735
  this.wire.sendAction('application-start-from-manifest').catch((e) => {
@@ -4745,14 +4774,14 @@ function requireFactory$2 () {
4745
4774
  });
4746
4775
  }
4747
4776
  }
4748
- Factory$7.default = ApplicationModule;
4777
+ Factory$7.ApplicationModule = ApplicationModule;
4749
4778
  return Factory$7;
4750
4779
  }
4751
4780
 
4752
4781
  var hasRequiredApplication;
4753
4782
 
4754
4783
  function requireApplication () {
4755
- if (hasRequiredApplication) return application;
4784
+ if (hasRequiredApplication) return application$1;
4756
4785
  hasRequiredApplication = 1;
4757
4786
  (function (exports) {
4758
4787
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -4771,19 +4800,20 @@ function requireApplication () {
4771
4800
  };
4772
4801
  Object.defineProperty(exports, "__esModule", { value: true });
4773
4802
  /**
4774
- * Entry point for the OpenFin Application namespace.
4803
+ * Entry points for the OpenFin `Application` API (`fin.Application`).
4804
+ *
4805
+ * * {@link ApplicationModule} contains static members of the `Application` API, accessible through `fin.Application`.
4806
+ * * {@link Application} describes an instance of an OpenFin Application, e.g. as returned by `fin.Application.getCurrent`.
4775
4807
  *
4776
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "ApplicationModule" is used for
4777
- * the module containing static members of the `Application` namespace (available under `fin.Application`), while `Application` documents
4778
- * instances of the OpenFin `Application` class.
4808
+ * 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),
4809
+ * both of these were documented on the same page.
4779
4810
  *
4780
4811
  * @packageDocumentation
4781
4812
  */
4782
- const Factory_1 = requireFactory$2();
4813
+ __exportStar(requireFactory$2(), exports);
4783
4814
  __exportStar(requireInstance$1(), exports);
4784
- exports.default = Factory_1.default;
4785
- } (application));
4786
- return application;
4815
+ } (application$1));
4816
+ return application$1;
4787
4817
  }
4788
4818
 
4789
4819
  var hasRequiredInstance;
@@ -4800,6 +4830,7 @@ function requireInstance () {
4800
4830
  const application_1 = requireApplication();
4801
4831
  const main_1 = main;
4802
4832
  const view_1 = requireView();
4833
+ const warnings_1 = warnings;
4803
4834
  /**
4804
4835
  * @PORTED
4805
4836
  * @typedef { object } Margins
@@ -4906,7 +4937,7 @@ function requireInstance () {
4906
4937
  * alphaMask turns anything of matching RGB value transparent.
4907
4938
  * <br>
4908
4939
  * Caveats:
4909
- * * runtime key --disable-gpu is required. Note: Unclear behavior on remote Desktop support
4940
+ * * Runtime flags --disable-gpu and --allow-unsafe-compositing are required. Note: Unclear behavior on remote Desktop support
4910
4941
  * * User cannot click-through transparent regions
4911
4942
  * * Not supported on Mac
4912
4943
  * * Windows Aero must be enabled
@@ -5094,6 +5125,7 @@ function requireInstance () {
5094
5125
  * A flag that specifies how transparent the window will be.
5095
5126
  * Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
5096
5127
  * This value is clamped between `0.0` and `1.0`.
5128
+ * * In software composition mode, the runtime flag --allow-unsafe-compositing is required.
5097
5129
  *
5098
5130
  * @property {preloadScript[]} [preloadScripts] - _Inheritable_
5099
5131
  * A list of scripts that are eval'ed before other scripts in the page. When omitted, _inherits_
@@ -5283,7 +5315,6 @@ function requireInstance () {
5283
5315
  */
5284
5316
  constructor(wire, identity) {
5285
5317
  super(wire, identity, 'window');
5286
- this.identity = identity;
5287
5318
  }
5288
5319
  /**
5289
5320
  * Adds a listener to the end of the listeners array for the specified event.
@@ -5409,6 +5440,7 @@ function requireInstance () {
5409
5440
  if (options.autoShow === undefined) {
5410
5441
  options.autoShow = true;
5411
5442
  }
5443
+ (0, warnings_1.handleDeprecatedWarnings)(options);
5412
5444
  const windowCreation = this.wire.environment.createChildContent({ entityType: 'window', options });
5413
5445
  Promise.all([pageResponse, windowCreation])
5414
5446
  .then((resolvedArr) => {
@@ -6114,11 +6146,12 @@ function requireInstance () {
6114
6146
  * moveBy(580, 300).then(() => console.log('Moved')).catch(err => console.log(err));
6115
6147
  * ```
6116
6148
  */
6117
- moveBy(deltaLeft, deltaTop) {
6149
+ moveBy(deltaLeft, deltaTop, positioningOptions) {
6118
6150
  return this.wire
6119
6151
  .sendAction('move-window-by', {
6120
6152
  deltaLeft,
6121
6153
  deltaTop,
6154
+ positioningOptions,
6122
6155
  ...this.identity
6123
6156
  })
6124
6157
  .then(() => undefined);
@@ -6148,11 +6181,12 @@ function requireInstance () {
6148
6181
  * moveTo(580, 300).then(() => console.log('Moved')).catch(err => console.log(err))
6149
6182
  * ```
6150
6183
  */
6151
- moveTo(left, top) {
6184
+ moveTo(left, top, positioningOptions) {
6152
6185
  return this.wire
6153
6186
  .sendAction('move-window', {
6154
6187
  left,
6155
6188
  top,
6189
+ positioningOptions,
6156
6190
  ...this.identity
6157
6191
  })
6158
6192
  .then(() => undefined);
@@ -6185,12 +6219,13 @@ function requireInstance () {
6185
6219
  * resizeBy(580, 300, 'top-right').then(() => console.log('Resized')).catch(err => console.log(err));
6186
6220
  * ```
6187
6221
  */
6188
- resizeBy(deltaWidth, deltaHeight, anchor) {
6222
+ resizeBy(deltaWidth, deltaHeight, anchor, positioningOptions) {
6189
6223
  return this.wire
6190
6224
  .sendAction('resize-window-by', {
6191
6225
  deltaWidth: Math.floor(deltaWidth),
6192
6226
  deltaHeight: Math.floor(deltaHeight),
6193
6227
  anchor,
6228
+ positioningOptions,
6194
6229
  ...this.identity
6195
6230
  })
6196
6231
  .then(() => undefined);
@@ -6223,12 +6258,13 @@ function requireInstance () {
6223
6258
  * resizeTo(580, 300, 'top-left').then(() => console.log('Resized')).catch(err => console.log(err));
6224
6259
  * ```
6225
6260
  */
6226
- resizeTo(width, height, anchor) {
6261
+ resizeTo(width, height, anchor, positioningOptions) {
6227
6262
  return this.wire
6228
6263
  .sendAction('resize-window', {
6229
6264
  width: Math.floor(width),
6230
6265
  height: Math.floor(height),
6231
6266
  anchor,
6267
+ positioningOptions,
6232
6268
  ...this.identity
6233
6269
  })
6234
6270
  .then(() => undefined);
@@ -6287,7 +6323,6 @@ function requireInstance () {
6287
6323
  }
6288
6324
  /**
6289
6325
  * Sets the window's size and position.
6290
- * @property { Bounds } bounds This is a * @type {string} name - name of the window.object that holds the propertys of
6291
6326
  *
6292
6327
  * @example
6293
6328
  * ```js
@@ -6314,8 +6349,10 @@ function requireInstance () {
6314
6349
  * }).then(() => console.log('Bounds set to window')).catch(err => console.log(err));
6315
6350
  * ```
6316
6351
  */
6317
- setBounds(bounds) {
6318
- return this.wire.sendAction('set-window-bounds', { ...bounds, ...this.identity }).then(() => undefined);
6352
+ setBounds(bounds, positioningOptions) {
6353
+ return this.wire
6354
+ .sendAction('set-window-bounds', { ...bounds, ...this.identity, positioningOptions })
6355
+ .then(() => undefined);
6319
6356
  }
6320
6357
  /**
6321
6358
  * Shows the window if it is hidden.
@@ -6457,7 +6494,10 @@ function requireInstance () {
6457
6494
  * Calling this method will close previously opened menus.
6458
6495
  * @experimental
6459
6496
  * @param options
6460
- *
6497
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
6498
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
6499
+ * of all possible data shapes for the entire menu, and the click handler should process
6500
+ * these with a "reducer" pattern.
6461
6501
  * @example
6462
6502
  * This could be used to show a drop down menu over views in a platform window:
6463
6503
  * ```js
@@ -6547,6 +6587,7 @@ function requireInstance () {
6547
6587
  return this.wire.sendAction('close-popup-menu', { ...this.identity }).then(() => undefined);
6548
6588
  }
6549
6589
  /**
6590
+ * @PORTED
6550
6591
  * @typedef {object} PopupOptions
6551
6592
  * @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.
6552
6593
  * @property {string} [url] - Navigates to this `url` if showing an existing window as a popup, otherwise the newly created window will load this `url`.
@@ -6564,6 +6605,7 @@ function requireInstance () {
6564
6605
  * @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.
6565
6606
  */
6566
6607
  /**
6608
+ * @PORTED
6567
6609
  * @typedef {object} PopupResult
6568
6610
  * @property {Identity} identity - `name` and `uuid` of the popup window that called dispatched this result.
6569
6611
  * @property {'clicked' | 'dismissed'} result - Result of the user interaction with the popup window.
@@ -6653,13 +6695,16 @@ function requireFactory$1 () {
6653
6695
  if (hasRequiredFactory$1) return Factory$8;
6654
6696
  hasRequiredFactory$1 = 1;
6655
6697
  Object.defineProperty(Factory$8, "__esModule", { value: true });
6656
- const base_1 = base;
6698
+ Factory$8._WindowModule = void 0;
6699
+ const base_1 = base$1;
6657
6700
  const validate_1 = validate;
6658
6701
  const Instance_1 = requireInstance();
6702
+ /**
6703
+ * Static namespace for OpenFin API methods that interact with the {@link _Window} class, available under `fin.Window`.
6704
+ */
6659
6705
  class _WindowModule extends base_1.Base {
6660
6706
  /**
6661
6707
  * Asynchronously returns a Window object that represents an existing window.
6662
- * @param identity
6663
6708
  *
6664
6709
  * @example
6665
6710
  * ```js
@@ -6676,7 +6721,6 @@ function requireFactory$1 () {
6676
6721
  * .then(win => console.log('wrapped window'))
6677
6722
  * .catch(err => console.log(err));
6678
6723
  * ```
6679
- * @static
6680
6724
  */
6681
6725
  async wrap(identity) {
6682
6726
  this.wire.sendAction('window-wrap').catch((e) => {
@@ -6690,7 +6734,6 @@ function requireFactory$1 () {
6690
6734
  }
6691
6735
  /**
6692
6736
  * Synchronously returns a Window object that represents an existing window.
6693
- * @param identity
6694
6737
  *
6695
6738
  * @example
6696
6739
  * ```js
@@ -6706,7 +6749,6 @@ function requireFactory$1 () {
6706
6749
  * await createWin();
6707
6750
  * let win = fin.Window.wrapSync({ uuid: 'app-1', name: 'myApp' });
6708
6751
  * ```
6709
- * @static
6710
6752
  */
6711
6753
  wrapSync(identity) {
6712
6754
  this.wire.sendAction('window-wrap-sync').catch((e) => {
@@ -6738,7 +6780,6 @@ function requireFactory$1 () {
6738
6780
  *
6739
6781
  * createWindow().then(() => console.log('Window is created')).catch(err => console.log(err));
6740
6782
  * ```
6741
- * @static
6742
6783
  */
6743
6784
  create(options) {
6744
6785
  this.wire.sendAction('create-window').catch((e) => {
@@ -6757,7 +6798,6 @@ function requireFactory$1 () {
6757
6798
  * .catch(err => console.log(err));
6758
6799
  *
6759
6800
  * ```
6760
- * @static
6761
6801
  */
6762
6802
  getCurrent() {
6763
6803
  this.wire.sendAction('get-current-window').catch((e) => {
@@ -6779,7 +6819,6 @@ function requireFactory$1 () {
6779
6819
  * console.log(info);
6780
6820
  *
6781
6821
  * ```
6782
- * @static
6783
6822
  */
6784
6823
  getCurrentSync() {
6785
6824
  this.wire.sendAction('get-current-window-sync').catch((e) => {
@@ -6792,14 +6831,14 @@ function requireFactory$1 () {
6792
6831
  return this.wrapSync({ uuid, name });
6793
6832
  }
6794
6833
  }
6795
- Factory$8.default = _WindowModule;
6834
+ Factory$8._WindowModule = _WindowModule;
6796
6835
  return Factory$8;
6797
6836
  }
6798
6837
 
6799
6838
  var hasRequiredWindow;
6800
6839
 
6801
6840
  function requireWindow () {
6802
- if (hasRequiredWindow) return window$1;
6841
+ if (hasRequiredWindow) return window$2;
6803
6842
  hasRequiredWindow = 1;
6804
6843
  (function (exports) {
6805
6844
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -6818,25 +6857,34 @@ function requireWindow () {
6818
6857
  };
6819
6858
  Object.defineProperty(exports, "__esModule", { value: true });
6820
6859
  /**
6821
- * Entry point for the OpenFin Window namespace.
6860
+ * Entry points for the OpenFin `Window` API (`fin.Window`).
6861
+ *
6862
+ * * {@link _WindowModule} contains static members of the `Window` API, accessible through `fin.Window`.
6863
+ * * {@link _Window} describes an instance of an OpenFin Window, e.g. as returned by `fin.Window.getCurrent`.
6822
6864
  *
6823
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "WindowModule" is used for
6824
- * the module containing static members of the `Window` namespace (available under `fin.Window`), while `Window` documents
6825
- * instances of the OpenFin `Window` class.
6865
+ * 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),
6866
+ * both of these were documented on the same page.
6826
6867
  *
6827
- * Because the `Window` name aliases a DOM entity, the documentation pipeline prefixes the name with an underscore.
6868
+ * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
6828
6869
  *
6829
6870
  * @packageDocumentation
6830
6871
  */
6831
- const Factory_1 = requireFactory$1();
6832
- exports.default = Factory_1.default;
6872
+ __exportStar(requireFactory$1(), exports);
6833
6873
  __exportStar(requireInstance(), exports);
6834
- } (window$1));
6835
- return window$1;
6874
+ } (window$2));
6875
+ return window$2;
6836
6876
  }
6837
6877
 
6838
- Object.defineProperty(system, "__esModule", { value: true });
6839
- const base_1$j = base;
6878
+ /**
6879
+ * Entry point for the OpenFin `System` API (`fin.System`).
6880
+ *
6881
+ * * {@link System} contains static members of the `System` API (available under `fin.System`)
6882
+ *
6883
+ * @packageDocumentation
6884
+ */
6885
+ Object.defineProperty(system$1, "__esModule", { value: true });
6886
+ system$1.System = void 0;
6887
+ const base_1$j = base$1;
6840
6888
  const transport_errors_1$2 = transportErrors;
6841
6889
  const window_1 = requireWindow();
6842
6890
  const events_1$6 = eventsExports;
@@ -7151,7 +7199,6 @@ class System extends base_1$j.EmitterBase {
7151
7199
  * ```js
7152
7200
  * fin.System.getUniqueUserId().then(id => console.log(id)).catch(err => console.log(err));
7153
7201
  * ```
7154
- * @static
7155
7202
  */
7156
7203
  getUniqueUserId() {
7157
7204
  return this.wire.sendAction('get-unique-user-id').then(({ payload }) => payload.data);
@@ -7842,7 +7889,8 @@ class System extends base_1$j.EmitterBase {
7842
7889
  }
7843
7890
  /**
7844
7891
  * Attempt to close an external process. The process will be terminated if it
7845
- * has not closed after the elapsed timeout in milliseconds.<br>
7892
+ * has not closed after the elapsed timeout in milliseconds.
7893
+ *
7846
7894
  * Note: This method is restricted by default and must be enabled via
7847
7895
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
7848
7896
  * @param options A object defined in the TerminateExternalRequestType interface
@@ -7878,7 +7926,8 @@ class System extends base_1$j.EmitterBase {
7878
7926
  return this.wire.sendAction('update-proxy', options).then(() => undefined);
7879
7927
  }
7880
7928
  /**
7881
- * Downloads the given application asset<br>
7929
+ * Downloads the given application asset.
7930
+ *
7882
7931
  * Note: This method is restricted by default and must be enabled via
7883
7932
  * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
7884
7933
  * @param appAsset App asset object
@@ -8422,7 +8471,6 @@ class System extends base_1$j.EmitterBase {
8422
8471
  * }
8423
8472
  * });
8424
8473
  * ```
8425
- * @static
8426
8474
  */
8427
8475
  async launchManifest(manifestUrl, opts = {}) {
8428
8476
  const { subscribe, ..._sendOpts } = opts;
@@ -8682,7 +8730,7 @@ class System extends base_1$j.EmitterBase {
8682
8730
  await this.wire.sendAction('set-domain-settings', { domainSettings, ...this.identity });
8683
8731
  }
8684
8732
  }
8685
- system.default = System;
8733
+ system$1.System = System;
8686
8734
 
8687
8735
  var interappbus = {};
8688
8736
 
@@ -9093,6 +9141,7 @@ var __classPrivateFieldSet$b = (commonjsGlobal && commonjsGlobal.__classPrivateF
9093
9141
  };
9094
9142
  var _ChannelClient_protectedObj, _ChannelClient_strategy, _ChannelClient_close;
9095
9143
  Object.defineProperty(client, "__esModule", { value: true });
9144
+ client.ChannelClient = void 0;
9096
9145
  const channel_1$1 = channel;
9097
9146
  const channelClientsByEndpointId = new Map();
9098
9147
  /**
@@ -9101,17 +9150,17 @@ const channelClientsByEndpointId = new Map();
9101
9150
  * provider via {@link ChannelClient#dispatch dispatch} and to listen for communication
9102
9151
  * from the provider by registering an action via {@link ChannelClient#register register}.
9103
9152
  *
9104
- * Synchronous Methods:
9153
+ * ### Synchronous Methods:
9105
9154
  * * {@link ChannelClient#onDisconnection onDisconnection(listener)}
9106
9155
  * * {@link ChannelClient#register register(action, listener)}
9107
9156
  * * {@link ChannelClient#remove remove(action)}
9108
9157
  *
9109
- * Asynchronous Methods:
9158
+ * ### Asynchronous Methods:
9110
9159
  * * {@link ChannelClient#disconnect disconnect()}
9111
9160
  * * {@link ChannelClient#dispatch dispatch(action, payload)}
9112
9161
  *
9113
- * Middleware:
9114
- * <br>Middleware functions receive the following arguments: (action, payload, senderId).
9162
+ * ### Middleware:
9163
+ * Middleware functions receive the following arguments: (action, payload, senderId).
9115
9164
  * The return value of the middleware function will be passed on as the payload from beforeAction, to the action listener, to afterAction
9116
9165
  * unless it is undefined, in which case the original payload is used. Middleware can be used for side effects.
9117
9166
  * * {@link ChannelClient#setDefaultAction setDefaultAction(middleware)}
@@ -9258,7 +9307,7 @@ class ChannelClient extends channel_1$1.ChannelBase {
9258
9307
  });
9259
9308
  }
9260
9309
  }
9261
- client.default = ChannelClient;
9310
+ client.ChannelClient = ChannelClient;
9262
9311
  _ChannelClient_protectedObj = new WeakMap(), _ChannelClient_strategy = new WeakMap(), _ChannelClient_close = new WeakMap();
9263
9312
 
9264
9313
  var connectionManager = {};
@@ -9623,7 +9672,7 @@ var iceManager = {};
9623
9672
 
9624
9673
  Object.defineProperty(iceManager, "__esModule", { value: true });
9625
9674
  iceManager.RTCICEManager = void 0;
9626
- const base_1$i = base;
9675
+ const base_1$i = base$1;
9627
9676
  /*
9628
9677
  Singleton that facilitates Offer and Answer exchange required for establishing RTC connections.
9629
9678
  */
@@ -9801,20 +9850,20 @@ const runtimeVersioning_1 = runtimeVersioning;
9801
9850
  * a single client via {@link ChannelProvider#dispatch dispatch} or all clients via {@link ChannelProvider#publish publish}
9802
9851
  * and to listen for communication from clients by registering an action via {@link ChannelProvider#register register}.
9803
9852
  *
9804
- * Synchronous Methods:
9853
+ * ### Synchronous Methods:
9805
9854
  * * {@link ChannelProvider#onConnection onConnection(listener)}
9806
9855
  * * {@link ChannelProvider#onDisconnection onDisconnection(listener)}
9807
9856
  * * {@link ChannelProvider#publish publish(action, payload)}
9808
9857
  * * {@link ChannelProvider#register register(action, listener)}
9809
9858
  * * {@link ChannelProvider#remove remove(action)}
9810
9859
  *
9811
- * Asynchronous Methods:
9860
+ * ### Asynchronous Methods:
9812
9861
  * * {@link ChannelProvider#destroy destroy()}
9813
9862
  * * {@link ChannelProvider#dispatch dispatch(to, action, payload)}
9814
9863
  * * {@link ChannelProvider#getAllClientInfo getAllClientInfo()}
9815
9864
  *
9816
- * Middleware:
9817
- * <br>Middleware functions receive the following arguments: (action, payload, senderId).
9865
+ * ### Middleware:
9866
+ * Middleware functions receive the following arguments: (action, payload, senderId).
9818
9867
  * The return value of the middleware function will be passed on as the payload from beforeAction, to the action listener, to afterAction
9819
9868
  * unless it is undefined, in which case the most recently defined payload is used. Middleware can be used for side effects.
9820
9869
  * * {@link ChannelProvider#setDefaultAction setDefaultAction(middleware)}
@@ -10123,7 +10172,7 @@ var messageReceiver = {};
10123
10172
  Object.defineProperty(messageReceiver, "__esModule", { value: true });
10124
10173
  messageReceiver.MessageReceiver = void 0;
10125
10174
  const client_1$1 = client;
10126
- const base_1$h = base;
10175
+ const base_1$h = base$1;
10127
10176
  /*
10128
10177
  This is a singleton (per fin object) tasked with routing messages coming off the ipc to the correct endpoint.
10129
10178
  It needs to be a singleton because there can only be one per wire. It tracks both clients and providers' processAction passed in via the strategy.
@@ -10183,7 +10232,7 @@ class MessageReceiver extends base_1$h.Base {
10183
10232
  const endpointIdFromPreviousConnection = this.latestEndpointIdByChannelId.get(channelId);
10184
10233
  if (endpointIdFromPreviousConnection) {
10185
10234
  // Not convinced by this way of doing things, but pushing up for now.
10186
- client_1$1.default.closeChannelByEndpointId(endpointIdFromPreviousConnection);
10235
+ client_1$1.ChannelClient.closeChannelByEndpointId(endpointIdFromPreviousConnection);
10187
10236
  // eslint-disable-next-line no-console
10188
10237
  console.warn('You have created a second connection to an older provider. First connection has been removed from the clientMap');
10189
10238
  // eslint-disable-next-line no-console
@@ -10313,7 +10362,7 @@ var _ConnectionManager_messageReceiver, _ConnectionManager_rtcConnectionManager;
10313
10362
  Object.defineProperty(connectionManager, "__esModule", { value: true });
10314
10363
  connectionManager.ConnectionManager = void 0;
10315
10364
  const exhaustive_1 = exhaustive;
10316
- const base_1$g = base;
10365
+ const base_1$g = base$1;
10317
10366
  const strategy_1 = strategy$2;
10318
10367
  const strategy_2 = strategy$1;
10319
10368
  const ice_manager_1 = iceManager;
@@ -10544,6 +10593,15 @@ class ConnectionManager extends base_1$g.Base {
10544
10593
  connectionManager.ConnectionManager = ConnectionManager;
10545
10594
  _ConnectionManager_messageReceiver = new WeakMap(), _ConnectionManager_rtcConnectionManager = new WeakMap();
10546
10595
 
10596
+ /**
10597
+ * Entry points for the `Channel` subset of the `InterApplicationBus` API (`fin.InterApplicationBus.Channel`).
10598
+ *
10599
+ * * {@link Channel} contains static members of the `Channel` API, accessible through `fin.InterApplicationBus.Channel`.
10600
+ * * {@link OpenFin.ChannelClient} describes a client of a channel, e.g. as returned by `fin.InterApplicationBus.Channel.connect`.
10601
+ * * {@link OpenFin.ChannelProvider} describes a provider of a channel, e.g. as returned by `fin.InterApplicationBus.Channel.create`.
10602
+ *
10603
+ * @packageDocumentation
10604
+ */
10547
10605
  var __classPrivateFieldSet$5 = (commonjsGlobal && commonjsGlobal.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
10548
10606
  if (kind === "m") throw new TypeError("Private method is not writable");
10549
10607
  if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -10561,7 +10619,7 @@ channel$1.Channel = void 0;
10561
10619
  /* eslint-disable no-console */
10562
10620
  const events_1$5 = eventsExports;
10563
10621
  const lazy_1$1 = lazy;
10564
- const base_1$f = base;
10622
+ const base_1$f = base$1;
10565
10623
  const client_1 = client;
10566
10624
  const connection_manager_1 = connectionManager;
10567
10625
  const provider_1 = provider;
@@ -10604,7 +10662,7 @@ class Channel extends base_1$f.EmitterBase {
10604
10662
  _Channel_readyToConnect.set(this, new lazy_1$1.AsyncRetryableLazy(async () => {
10605
10663
  await Promise.all([
10606
10664
  this.on('disconnected', (eventPayload) => {
10607
- client_1.default.handleProviderDisconnect(eventPayload);
10665
+ client_1.ChannelClient.handleProviderDisconnect(eventPayload);
10608
10666
  }),
10609
10667
  this.on('connected', (...args) => {
10610
10668
  __classPrivateFieldGet$7(this, _Channel_internalEmitter, "f").emit('connected', ...args);
@@ -10795,7 +10853,7 @@ class Channel extends base_1$f.EmitterBase {
10795
10853
  };
10796
10854
  const routingInfo = await this.safeConnect(channelName, opts.wait, connectPayload);
10797
10855
  const strategy = await __classPrivateFieldGet$7(this, _Channel_connectionManager, "f").createClientStrategy(rtcPacket, routingInfo);
10798
- const channel = new client_1.default(routingInfo, this.wire, strategy);
10856
+ const channel = new client_1.ChannelClient(routingInfo, this.wire, strategy);
10799
10857
  // It is the client's responsibility to handle endpoint disconnection to the provider.
10800
10858
  // If the endpoint dies, the client will force a disconnection through the core.
10801
10859
  // The provider does not care about endpoint disconnection.
@@ -10807,7 +10865,7 @@ class Channel extends base_1$f.EmitterBase {
10807
10865
  console.warn(`Something went wrong during disconnect for client with uuid: ${routingInfo.uuid} / name: ${routingInfo.name} / endpointId: ${routingInfo.endpointId}.`);
10808
10866
  }
10809
10867
  finally {
10810
- client_1.default.handleProviderDisconnect(routingInfo);
10868
+ client_1.ChannelClient.handleProviderDisconnect(routingInfo);
10811
10869
  }
10812
10870
  });
10813
10871
  return channel;
@@ -10878,9 +10936,16 @@ channel$1.Channel = Channel;
10878
10936
  _Channel_connectionManager = new WeakMap(), _Channel_internalEmitter = new WeakMap(), _Channel_readyToConnect = new WeakMap();
10879
10937
 
10880
10938
  Object.defineProperty(interappbus, "__esModule", { value: true });
10881
- interappbus.InterAppPayload = void 0;
10939
+ interappbus.InterAppPayload = interappbus.InterApplicationBus = void 0;
10940
+ /**
10941
+ * Entry point for the OpenFin `InterApplicationBus` API (`fin.InterApplicationBus`).
10942
+ *
10943
+ * * {@link InterApplicationBus} contains static members of the `InterApplicationBus` API, accessible through `fin.InterApplicationBus`.
10944
+ *
10945
+ * @packageDocumentation
10946
+ */
10882
10947
  const events_1$4 = eventsExports;
10883
- const base_1$e = base;
10948
+ const base_1$e = base$1;
10884
10949
  const ref_counter_1 = refCounter;
10885
10950
  const index_1$2 = channel$1;
10886
10951
  const validate_1$3 = validate;
@@ -11070,7 +11135,7 @@ class InterApplicationBus extends base_1$e.Base {
11070
11135
  return true;
11071
11136
  }
11072
11137
  }
11073
- interappbus.default = InterApplicationBus;
11138
+ interappbus.InterApplicationBus = InterApplicationBus;
11074
11139
  /**
11075
11140
  * @internal
11076
11141
  */
@@ -11087,8 +11152,16 @@ function createKey(...toHash) {
11087
11152
 
11088
11153
  var clipboard = {};
11089
11154
 
11155
+ /**
11156
+ * Entry point for the OpenFin `Clipboard` API (`fin.Clipboard`).
11157
+ *
11158
+ * * {@link Clipboard} contains static members of the `Clipboard` API, accessible through `fin.Clipboard`.
11159
+ *
11160
+ * @packageDocumentation
11161
+ */
11090
11162
  Object.defineProperty(clipboard, "__esModule", { value: true });
11091
- const base_1$d = base;
11163
+ clipboard.Clipboard = void 0;
11164
+ const base_1$d = base$1;
11092
11165
  /**
11093
11166
  * @PORTED
11094
11167
  * WriteRequestType interface
@@ -11285,9 +11358,9 @@ class Clipboard extends base_1$d.Base {
11285
11358
  return payload.data;
11286
11359
  }
11287
11360
  }
11288
- clipboard.default = Clipboard;
11361
+ clipboard.Clipboard = Clipboard;
11289
11362
 
11290
- var externalApplication = {};
11363
+ var externalApplication$1 = {};
11291
11364
 
11292
11365
  var Factory$5 = {};
11293
11366
 
@@ -11296,11 +11369,11 @@ var Instance$4 = {};
11296
11369
  Object.defineProperty(Instance$4, "__esModule", { value: true });
11297
11370
  Instance$4.ExternalApplication = void 0;
11298
11371
  /* eslint-disable import/prefer-default-export */
11299
- const base_1$c = base;
11372
+ const base_1$c = base$1;
11300
11373
  /**
11301
11374
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
11302
11375
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
11303
- * Discovery of connections is provided by <a href="tutorial-System.getAllExternalApplications.html">getAllExternalApplications.</a>
11376
+ * Discovery of connections is provided by {@link System.System.getAllExternalApplications getAllExternalApplications}.</a>
11304
11377
  *
11305
11378
  * Processes that can be wrapped as `ExternalApplication`s include the following:
11306
11379
  * - Processes which have connected to an OpenFin runtime via an adapter
@@ -11411,8 +11484,12 @@ class ExternalApplication extends base_1$c.EmitterBase {
11411
11484
  Instance$4.ExternalApplication = ExternalApplication;
11412
11485
 
11413
11486
  Object.defineProperty(Factory$5, "__esModule", { value: true });
11414
- const base_1$b = base;
11487
+ Factory$5.ExternalApplicationModule = void 0;
11488
+ const base_1$b = base$1;
11415
11489
  const Instance_1$4 = Instance$4;
11490
+ /**
11491
+ * Static namespace for OpenFin API methods that interact with the {@link ExternalApplication} class, available under `fin.ExternalApplication`.
11492
+ */
11416
11493
  class ExternalApplicationModule extends base_1$b.Base {
11417
11494
  /**
11418
11495
  * Asynchronously returns an External Application object that represents an external application.
@@ -11426,7 +11503,6 @@ class ExternalApplicationModule extends base_1$b.Base {
11426
11503
  * .then(extApp => console.log('wrapped external application'))
11427
11504
  * .catch(err => console.log(err));
11428
11505
  * ```
11429
- * @static
11430
11506
  */
11431
11507
  wrap(uuid) {
11432
11508
  this.wire.sendAction('external-application-wrap').catch((e) => {
@@ -11446,7 +11522,6 @@ class ExternalApplicationModule extends base_1$b.Base {
11446
11522
  * const info = await extApp.getInfo();
11447
11523
  * console.log(info);
11448
11524
  * ```
11449
- * @static
11450
11525
  */
11451
11526
  wrapSync(uuid) {
11452
11527
  this.wire.sendAction('external-application-wrap-sync').catch((e) => {
@@ -11455,18 +11530,9 @@ class ExternalApplicationModule extends base_1$b.Base {
11455
11530
  return new Instance_1$4.ExternalApplication(this.wire, { uuid });
11456
11531
  }
11457
11532
  }
11458
- Factory$5.default = ExternalApplicationModule;
11533
+ Factory$5.ExternalApplicationModule = ExternalApplicationModule;
11459
11534
 
11460
11535
  (function (exports) {
11461
- /**
11462
- * Entry point for the OpenFin ExternalApplication namespace.
11463
- *
11464
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "ExternalApplicationModule" is used for
11465
- * the module containing static members of the `ExternalApplication` namespace (available under `fin.ExternalApplication`), while `ExternalApplication`
11466
- * documents instances of the OpenFin `ExternalApplication` class.
11467
- *
11468
- * @packageDocumentation
11469
- */
11470
11536
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
11471
11537
  if (k2 === undefined) k2 = k;
11472
11538
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -11482,12 +11548,22 @@ Factory$5.default = ExternalApplicationModule;
11482
11548
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
11483
11549
  };
11484
11550
  Object.defineProperty(exports, "__esModule", { value: true });
11485
- const Factory_1 = Factory$5;
11486
- exports.default = Factory_1.default;
11551
+ /**
11552
+ * Entry points for the OpenFin `ExternalApplication` API (`fin.ExternalApplication`).
11553
+ *
11554
+ * * {@link ExternalApplicationModule} contains static members of the `ExternalApplication` type, accessible through `fin.ExternalApplication`.
11555
+ * * {@link ExternalApplication} describes an instance of an OpenFin ExternalApplication, e.g. as returned by `fin.ExternalApplication.getCurrent`.
11556
+ *
11557
+ * 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),
11558
+ * both of these were documented on the same page.
11559
+ *
11560
+ * @packageDocumentation
11561
+ */
11562
+ __exportStar(Factory$5, exports);
11487
11563
  __exportStar(Instance$4, exports);
11488
- } (externalApplication));
11564
+ } (externalApplication$1));
11489
11565
 
11490
- var frame = {};
11566
+ var frame$1 = {};
11491
11567
 
11492
11568
  var Factory$4 = {};
11493
11569
 
@@ -11496,7 +11572,7 @@ var Instance$3 = {};
11496
11572
  Object.defineProperty(Instance$3, "__esModule", { value: true });
11497
11573
  Instance$3._Frame = void 0;
11498
11574
  /* eslint-disable import/prefer-default-export */
11499
- const base_1$a = base;
11575
+ const base_1$a = base$1;
11500
11576
  /**
11501
11577
  * An iframe represents an embedded HTML page within a parent HTML page. Because this embedded page
11502
11578
  * has its own DOM and global JS context (which may or may not be linked to that of the parent depending
@@ -11637,9 +11713,13 @@ class _Frame extends base_1$a.EmitterBase {
11637
11713
  Instance$3._Frame = _Frame;
11638
11714
 
11639
11715
  Object.defineProperty(Factory$4, "__esModule", { value: true });
11640
- const base_1$9 = base;
11716
+ Factory$4._FrameModule = void 0;
11717
+ const base_1$9 = base$1;
11641
11718
  const validate_1$2 = validate;
11642
11719
  const Instance_1$3 = Instance$3;
11720
+ /**
11721
+ * Static namespace for OpenFin API methods that interact with the {@link _Frame} class, available under `fin.Frame`.
11722
+ */
11643
11723
  class _FrameModule extends base_1$9.Base {
11644
11724
  /**
11645
11725
  * Asynchronously returns a reference to the specified frame. The frame does not have to exist
@@ -11651,7 +11731,6 @@ class _FrameModule extends base_1$9.Base {
11651
11731
  * .then(frm => console.log('wrapped frame'))
11652
11732
  * .catch(err => console.log(err));
11653
11733
  * ```
11654
- * @static
11655
11734
  */
11656
11735
  async wrap(identity) {
11657
11736
  this.wire.sendAction('frame-wrap').catch((e) => {
@@ -11673,7 +11752,6 @@ class _FrameModule extends base_1$9.Base {
11673
11752
  * const info = await frm.getInfo();
11674
11753
  * console.log(info);
11675
11754
  * ```
11676
- * @static
11677
11755
  */
11678
11756
  wrapSync(identity) {
11679
11757
  this.wire.sendAction('frame-wrap-sync').catch((e) => {
@@ -11694,7 +11772,6 @@ class _FrameModule extends base_1$9.Base {
11694
11772
  * .then(frm => console.log('current frame'))
11695
11773
  * .catch(err => console.log(err));
11696
11774
  * ```
11697
- * @static
11698
11775
  */
11699
11776
  getCurrent() {
11700
11777
  this.wire.sendAction('frame-get-current').catch((e) => {
@@ -11711,7 +11788,6 @@ class _FrameModule extends base_1$9.Base {
11711
11788
  * const info = await frm.getInfo();
11712
11789
  * console.log(info);
11713
11790
  * ```
11714
- * @static
11715
11791
  */
11716
11792
  getCurrentSync() {
11717
11793
  this.wire.sendAction('frame-get-current-sync').catch((e) => {
@@ -11720,17 +11796,19 @@ class _FrameModule extends base_1$9.Base {
11720
11796
  return new Instance_1$3._Frame(this.wire, this.wire.environment.getCurrentEntityIdentity());
11721
11797
  }
11722
11798
  }
11723
- Factory$4.default = _FrameModule;
11799
+ Factory$4._FrameModule = _FrameModule;
11724
11800
 
11725
11801
  (function (exports) {
11726
11802
  /**
11727
- * Entry point for the OpenFin Frame namespace.
11803
+ * Entry points for the OpenFin `Frame` API (`fin.Frame`).
11804
+ *
11805
+ * * {@link _FrameModule} contains static members of the `Frame` API, accessible through `fin.Frame`.
11806
+ * * {@link _Frame} describes an instance of an OpenFin Frame, e.g. as returned by `fin.Frame.getCurrent`.
11728
11807
  *
11729
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "FrameModule" is used for
11730
- * the module containing static members of the `Frame` namespace (available under `fin.Frame`), while `Frame` documents
11731
- * instances of the OpenFin `Frame` class.
11808
+ * 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),
11809
+ * both of these were documented on the same page.
11732
11810
  *
11733
- * Because the `Frame` name aliases a DOM entity, the documentation pipeline prefixes the name with an underscore.
11811
+ * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
11734
11812
  *
11735
11813
  * @packageDocumentation
11736
11814
  */
@@ -11749,15 +11827,15 @@ Factory$4.default = _FrameModule;
11749
11827
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
11750
11828
  };
11751
11829
  Object.defineProperty(exports, "__esModule", { value: true });
11752
- const Factory_1 = Factory$4;
11753
- exports.default = Factory_1.default;
11830
+ __exportStar(Factory$4, exports);
11754
11831
  __exportStar(Instance$3, exports);
11755
- } (frame));
11832
+ } (frame$1));
11756
11833
 
11757
- var globalHotkey = {};
11834
+ var globalHotkey$1 = {};
11758
11835
 
11759
- Object.defineProperty(globalHotkey, "__esModule", { value: true });
11760
- const base_1$8 = base;
11836
+ Object.defineProperty(globalHotkey$1, "__esModule", { value: true });
11837
+ globalHotkey$1.GlobalHotkey = void 0;
11838
+ const base_1$8 = base$1;
11761
11839
  /**
11762
11840
  * The GlobalHotkey module can register/unregister a global hotkeys.
11763
11841
  *
@@ -11886,9 +11964,9 @@ class GlobalHotkey extends base_1$8.EmitterBase {
11886
11964
  return data;
11887
11965
  }
11888
11966
  }
11889
- globalHotkey.default = GlobalHotkey;
11967
+ globalHotkey$1.GlobalHotkey = GlobalHotkey;
11890
11968
 
11891
- var platform = {};
11969
+ var platform$1 = {};
11892
11970
 
11893
11971
  var Factory$3 = {};
11894
11972
 
@@ -11903,16 +11981,14 @@ var _Platform_connectToProvider;
11903
11981
  Object.defineProperty(Instance$2, "__esModule", { value: true });
11904
11982
  Instance$2.Platform = void 0;
11905
11983
  /* eslint-disable import/prefer-default-export, no-undef */
11906
- const base_1$7 = base;
11984
+ const base_1$7 = base$1;
11907
11985
  const validate_1$1 = validate;
11908
11986
  // Reuse clients to avoid overwriting already-registered client in provider
11909
11987
  const clientMap = new Map();
11910
11988
  /** Manages the life cycle of windows and views in the application.
11911
11989
  *
11912
- * Enables taking snapshots of itself and applyi
11913
- * ng them to restore a previous configuration
11990
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
11914
11991
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
11915
- *
11916
11992
  */
11917
11993
  class Platform extends base_1$7.EmitterBase {
11918
11994
  /**
@@ -12271,12 +12347,11 @@ class Platform extends base_1$7.EmitterBase {
12271
12347
  });
12272
12348
  }
12273
12349
  /**
12274
- * ***DEPRECATED - please use Platform.createView.***
12350
+ * ***DEPRECATED - please use {@link Platform.createView Platform.createView}.***
12275
12351
  * Reparents a specified view in a new target window.
12276
12352
  * @param viewIdentity View identity
12277
12353
  * @param target new owner window identity
12278
12354
  *
12279
- * @tutorial Platform.createView
12280
12355
  */
12281
12356
  async reparentView(viewIdentity, target) {
12282
12357
  var _a;
@@ -12766,10 +12841,142 @@ Object.defineProperty(Instance$1, "__esModule", { value: true });
12766
12841
  Instance$1.Layout = void 0;
12767
12842
  const lazy_1 = lazy;
12768
12843
  const validate_1 = validate;
12769
- const base_1$6 = base;
12844
+ const base_1$6 = base$1;
12770
12845
  const common_utils_1 = commonUtils;
12771
12846
  const layout_entities_1 = layoutEntities;
12772
12847
  const layout_constants_1 = layout_constants;
12848
+ /**
12849
+ *
12850
+ * Layouts give app providers the ability to embed multiple views in a single window. The Layout namespace
12851
+ * enables the initialization and manipulation of a window's Layout. A Layout will
12852
+ * emit events locally on the DOM element representing the layout-container.
12853
+ *
12854
+ *
12855
+ * ### Layout.DOMEvents
12856
+ *
12857
+ * When a Layout is created, it emits events onto the DOM element representing the Layout container.
12858
+ * This Layout container is the DOM element referenced by containerId in {@link Layout.LayoutModule#init Layout.init}.
12859
+ * 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).
12860
+ * The events are emitted synchronously and only in the process where the Layout exists.
12861
+ * Any values returned by the called listeners are ignored and will be discarded.
12862
+ * If the target DOM element is destroyed, any events that have been set up on that element will be destroyed.
12863
+ *
12864
+ * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
12865
+ *
12866
+ * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
12867
+ * Adds a listener to the end of the listeners array for the specified event.
12868
+ * @example
12869
+ * ```js
12870
+ * const myLayoutContainer = document.getElementById('layout-container');
12871
+ *
12872
+ * myLayoutContainer.addEventListener('tab-created', function(event) {
12873
+ * const { tabSelector } = event.detail;
12874
+ * const tabElement = document.getElementById(tabSelector);
12875
+ * const existingColor = tabElement.style.backgroundColor;
12876
+ * tabElement.style.backgroundColor = "red";
12877
+ * setTimeout(() => {
12878
+ * tabElement.style.backgroundColor = existingColor;
12879
+ * }, 2000);
12880
+ * });
12881
+ * ```
12882
+ *
12883
+ * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
12884
+ * Adds a listener to the end of the listeners array for the specified event.
12885
+ * @example
12886
+ * ```js
12887
+ * const myLayoutContainer = document.getElementById('layout-container');
12888
+ *
12889
+ * const listener = function(event) {
12890
+ * console.log(event.detail);
12891
+ * console.log('container-created event fired once, removing listener');
12892
+ * myLayoutContainer.removeEventListener('container-created', listener);
12893
+ * };
12894
+ *
12895
+ * myLayoutContainer.addEventListener('container-created', listener);
12896
+ * ```
12897
+ *
12898
+ * ### Supported event types are:
12899
+ *
12900
+ * * tab-created
12901
+ * * container-created
12902
+ * * layout-state-changed
12903
+ * * tab-closed
12904
+ * * tab-dropped
12905
+ *
12906
+ * ### Layout DOM Node Events
12907
+ *
12908
+ * #### tab-created
12909
+ * 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.
12910
+ * ```js
12911
+ * // The response has the following shape in event.detail:
12912
+ * {
12913
+ * containerSelector: "container-component_A",
12914
+ * name: "component_A",
12915
+ * tabSelector: "tab-component_A",
12916
+ * topic: "openfin-DOM-event",
12917
+ * type: "tab-created",
12918
+ * uuid: "OpenFin POC"
12919
+ * }
12920
+ * ```
12921
+ *
12922
+ * #### container-created
12923
+ * 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.
12924
+ * ```js
12925
+ * // The response has the following shape in event.detail:
12926
+ * {
12927
+ * containerSelector: "container-component_A",
12928
+ * name: "component_A",
12929
+ * tabSelector: "tab-component_A",
12930
+ * topic: "openfin-DOM-event",
12931
+ * type: "container-created",
12932
+ * uuid: "OpenFin POC"
12933
+ * }
12934
+ * ```
12935
+ *
12936
+ * ### layout-state-changed
12937
+ * 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.
12938
+ * ```js
12939
+ * // The response has the following shape in event.detail
12940
+ * {
12941
+ * containerSelector: "container-component_A",
12942
+ * name: "component_A",
12943
+ * tabSelector: "tab-component_A",
12944
+ * topic: "openfin-DOM-event",
12945
+ * type: "layout-state-changed",
12946
+ * uuid: "OpenFin POC"
12947
+ * }
12948
+ * ```
12949
+ *
12950
+ * #### tab-closed
12951
+ * Generated when a tab is closed.
12952
+ * ```js
12953
+ * // The response has the following shape in event.detail:
12954
+ * {
12955
+ * containerSelector: "container-component_A",
12956
+ * name: "component_A",
12957
+ * tabSelector: "tab-component_A",
12958
+ * topic: "openfin-DOM-event",
12959
+ * type: "tab-closed",
12960
+ * uuid: "OpenFin POC",
12961
+ * url: "http://openfin.co" // The url of the view that was closed.
12962
+ * }
12963
+ * ```
12964
+ *
12965
+ * #### tab-dropped
12966
+ * Generated when a tab is dropped.
12967
+ * ```js
12968
+ * // The response has the following shape in event.detail:
12969
+ * {
12970
+ * containerSelector: "container-component_A",
12971
+ * name: "component_A",
12972
+ * tabSelector: "tab-component_A",
12973
+ * topic: "openfin-DOM-event",
12974
+ * type: "tab-dropped",
12975
+ * uuid: "OpenFin POC",
12976
+ * url: "http://openfin.co" // The url of the view linked to the dropped tab.
12977
+ * }
12978
+ * ```
12979
+ */
12773
12980
  class Layout extends base_1$6.Base {
12774
12981
  /**
12775
12982
  * @internal
@@ -12995,22 +13202,52 @@ var _LayoutModule_layoutInitializationAttempted;
12995
13202
  Object.defineProperty(Factory$2, "__esModule", { value: true });
12996
13203
  Factory$2.LayoutModule = void 0;
12997
13204
  /* eslint-disable no-undef, import/prefer-default-export */
12998
- const base_1$5 = base;
13205
+ const base_1$5 = base$1;
12999
13206
  const Instance_1$2 = Instance$1;
13207
+ /**
13208
+ * Static namespace for OpenFin API methods that interact with the {@link Layout} class, available under `fin.Platform.Layout`.
13209
+ */
13000
13210
  class LayoutModule extends base_1$5.Base {
13001
13211
  constructor() {
13002
13212
  super(...arguments);
13003
13213
  _LayoutModule_layoutInitializationAttempted.set(this, false);
13004
13214
  /**
13005
- * Initialize the window's Layout. Must be called from a custom window that has a 'layout' option set upon creation of that window.
13215
+ * Initialize the window's Layout.
13216
+ *
13217
+ * @remarks Must be called from a custom window that has a 'layout' option set upon creation of that window.
13006
13218
  * If a containerId is not provided, this method attempts to find an element with the id `layout-container`.
13007
- * A Layout will <a href="tutorial-Layout.DOMEvents.html">emit events locally</a> on the DOM element representing the layout-container.
13219
+ * A Layout will emit events locally on the DOM element representing the layout-container.
13008
13220
  * In order to capture the relevant events during Layout initiation, set up the listeners on the DOM element prior to calling `init`.
13009
13221
  * @param options - Layout init options.
13010
13222
  *
13011
- * @static
13012
13223
  * @experimental
13013
- * @tutorial Layout.init
13224
+ *
13225
+ * @example
13226
+ * ```js
13227
+ * // If no options are included, the layout in the window options is initialized in an element with the id `layout-container`
13228
+ * const layout = await fin.Platform.Layout.init();
13229
+ * ```
13230
+ * <br>
13231
+ *
13232
+ * ```js
13233
+ * const containerId = 'my-custom-container-id';
13234
+ *
13235
+ * const myLayoutContainer = document.getElementById(containerId);
13236
+ *
13237
+ * myLayoutContainer.addEventListener('tab-created', function(event) {
13238
+ * const { tabSelector } = event.detail;
13239
+ * const tabElement = document.getElementById(tabSelector);
13240
+ * const existingColor = tabElement.style.backgroundColor;
13241
+ * tabElement.style.backgroundColor = "red";
13242
+ * setTimeout(() => {
13243
+ * tabElement.style.backgroundColor = existingColor;
13244
+ * }, 2000);
13245
+ * });
13246
+ *
13247
+ * // initialize the layout into an existing HTML element with the div `my-custom-container-id`
13248
+ * // the window must have been created with a layout in its window options
13249
+ * const layout = await fin.Platform.Layout.init({ containerId });
13250
+ * ```
13014
13251
  */
13015
13252
  this.init = async (options = {}) => {
13016
13253
  this.wire.sendAction('layout-init').catch((e) => {
@@ -13028,7 +13265,6 @@ class LayoutModule extends base_1$5.Base {
13028
13265
  }
13029
13266
  /**
13030
13267
  * Asynchronously returns a Layout object that represents a Window's layout.
13031
- * @param identity
13032
13268
  *
13033
13269
  * @example
13034
13270
  * ```js
@@ -13045,9 +13281,7 @@ class LayoutModule extends base_1$5.Base {
13045
13281
  * // Use wrapped instance to control layout, e.g.:
13046
13282
  * const layoutConfig = await layout.getConfig();
13047
13283
  * ```
13048
- * @static
13049
13284
  */
13050
- // eslint-disable-next-line class-methods-use-this
13051
13285
  async wrap(identity) {
13052
13286
  this.wire.sendAction('layout-wrap').catch((e) => {
13053
13287
  // don't expose
@@ -13056,7 +13290,6 @@ class LayoutModule extends base_1$5.Base {
13056
13290
  }
13057
13291
  /**
13058
13292
  * Synchronously returns a Layout object that represents a Window's layout.
13059
- * @param identity
13060
13293
  *
13061
13294
  * @example
13062
13295
  * ```js
@@ -13073,9 +13306,7 @@ class LayoutModule extends base_1$5.Base {
13073
13306
  * // Use wrapped instance to control layout, e.g.:
13074
13307
  * const layoutConfig = await layout.getConfig();
13075
13308
  * ```
13076
- * @static
13077
13309
  */
13078
- // eslint-disable-next-line class-methods-use-this
13079
13310
  wrapSync(identity) {
13080
13311
  this.wire.sendAction('layout-wrap-sync').catch((e) => {
13081
13312
  // don't expose
@@ -13091,7 +13322,6 @@ class LayoutModule extends base_1$5.Base {
13091
13322
  * // Use wrapped instance to control layout, e.g.:
13092
13323
  * const layoutConfig = await layout.getConfig();
13093
13324
  * ```
13094
- * @static
13095
13325
  */
13096
13326
  async getCurrent() {
13097
13327
  this.wire.sendAction('layout-get-current').catch((e) => {
@@ -13115,7 +13345,6 @@ class LayoutModule extends base_1$5.Base {
13115
13345
  * // Use wrapped instance to control layout, e.g.:
13116
13346
  * const layoutConfig = await layout.getConfig();
13117
13347
  * ```
13118
- * @static
13119
13348
  */
13120
13349
  getCurrentSync() {
13121
13350
  this.wire.sendAction('layout-get-current-sync').catch((e) => {
@@ -13133,13 +13362,16 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap();
13133
13362
 
13134
13363
  (function (exports) {
13135
13364
  /**
13136
- * Entry point for the OpenFin Layout namespace.
13365
+ * Entry point for the OpenFin `Layout` subset of the `Platform` API (`fin.Platform.Layout`).
13366
+ *
13367
+ * * {@link LayoutModule} contains static members of the `Layout` API, accessible through `fin.Platform.Layout`.
13368
+ * * {@link Layout} describes an instance of an OpenFin Layout, e.g. as returned by `fin.Platform.Layout.getCurrent`.
13137
13369
  *
13138
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "LayoutModule" is used for
13139
- * the module containing static members of the `Layout` namespace (available under `fin.Platform.Layout`), while `Layout` documents
13140
- * instances of the OpenFin `Layout` class.
13370
+ * 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),
13371
+ * both of these were documented on the same page.
13141
13372
  *
13142
13373
  * @packageDocumentation
13374
+ *
13143
13375
  */
13144
13376
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
13145
13377
  if (k2 === undefined) k2 = k;
@@ -13161,9 +13393,13 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap();
13161
13393
  } (layout));
13162
13394
 
13163
13395
  Object.defineProperty(Factory$3, "__esModule", { value: true });
13164
- const base_1$4 = base;
13396
+ Factory$3.PlatformModule = void 0;
13397
+ const base_1$4 = base$1;
13165
13398
  const Instance_1$1 = Instance$2;
13166
13399
  const index_1$1 = layout;
13400
+ /**
13401
+ * Static namespace for OpenFin API methods that interact with the {@link Platform} class, available under `fin.Platform`.
13402
+ */
13167
13403
  class PlatformModule extends base_1$4.Base {
13168
13404
  /**
13169
13405
  * @internal
@@ -13229,14 +13465,12 @@ class PlatformModule extends base_1$4.Base {
13229
13465
  * fin.Platform.init({overrideCallback});
13230
13466
  * ```
13231
13467
  * @experimental
13232
- * @static
13233
13468
  */
13234
13469
  async init(options) {
13235
13470
  return this.wire.environment.initPlatform(this.fin, options);
13236
13471
  }
13237
13472
  /**
13238
13473
  * Asynchronously returns a Platform object that represents an existing platform.
13239
- * @param identity
13240
13474
  *
13241
13475
  * @example
13242
13476
  * ```js
@@ -13245,7 +13479,6 @@ class PlatformModule extends base_1$4.Base {
13245
13479
  * // Use wrapped instance to control layout, e.g.:
13246
13480
  * const snapshot = await platform.getSnapshot();
13247
13481
  * ```
13248
- * @static
13249
13482
  */
13250
13483
  async wrap(identity) {
13251
13484
  this.wire.sendAction('platform-wrap').catch((e) => {
@@ -13255,7 +13488,6 @@ class PlatformModule extends base_1$4.Base {
13255
13488
  }
13256
13489
  /**
13257
13490
  * Synchronously returns a Platform object that represents an existing platform.
13258
- * @param identity
13259
13491
  *
13260
13492
  * @example
13261
13493
  * ```js
@@ -13264,7 +13496,6 @@ class PlatformModule extends base_1$4.Base {
13264
13496
  * // Use wrapped instance to control layout, e.g.:
13265
13497
  * const snapshot = await platform.getSnapshot();
13266
13498
  * ```
13267
- * @static
13268
13499
  */
13269
13500
  wrapSync(identity) {
13270
13501
  this.wire.sendAction('platform-wrap-sync').catch((e) => {
@@ -13281,7 +13512,6 @@ class PlatformModule extends base_1$4.Base {
13281
13512
  * // Use wrapped instance to control layout, e.g.:
13282
13513
  * const snapshot = await platform.getSnapshot();
13283
13514
  * ```
13284
- * @static
13285
13515
  */
13286
13516
  async getCurrent() {
13287
13517
  this.wire.sendAction('platform-get-current').catch((e) => {
@@ -13298,7 +13528,6 @@ class PlatformModule extends base_1$4.Base {
13298
13528
  * // Use wrapped instance to control layout, e.g.:
13299
13529
  * const snapshot = await platform.getSnapshot();
13300
13530
  * ```
13301
- * @static
13302
13531
  */
13303
13532
  getCurrentSync() {
13304
13533
  this.wire.sendAction('platform-get-current-sync').catch((e) => {
@@ -13309,7 +13538,6 @@ class PlatformModule extends base_1$4.Base {
13309
13538
  /**
13310
13539
  * Creates and starts a Platform and returns a wrapped and running Platform instance. The wrapped Platform methods can
13311
13540
  * be used to launch content into the platform. Promise will reject if the platform is already running.
13312
- * @param platformOptions
13313
13541
  *
13314
13542
  * @example
13315
13543
  * ```js
@@ -13330,7 +13558,6 @@ class PlatformModule extends base_1$4.Base {
13330
13558
  * console.error(e);
13331
13559
  * }
13332
13560
  * ```
13333
- * @static
13334
13561
  */
13335
13562
  start(platformOptions) {
13336
13563
  this.wire.sendAction('platform-start').catch((e) => {
@@ -13375,7 +13602,6 @@ class PlatformModule extends base_1$4.Base {
13375
13602
  * console.error(e);
13376
13603
  * }
13377
13604
  * ```
13378
- * @static
13379
13605
  */
13380
13606
  startFromManifest(manifestUrl, opts) {
13381
13607
  this.wire.sendAction('platform-start-from-manifest').catch((e) => {
@@ -13398,18 +13624,9 @@ class PlatformModule extends base_1$4.Base {
13398
13624
  });
13399
13625
  }
13400
13626
  }
13401
- Factory$3.default = PlatformModule;
13627
+ Factory$3.PlatformModule = PlatformModule;
13402
13628
 
13403
13629
  (function (exports) {
13404
- /**
13405
- * Entry point for the OpenFin Platform namespace.
13406
- *
13407
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "PlatformModule" is used for
13408
- * the module containing static members of the `Platform` namespace (available under `fin.Platform`), while `Platform` documents
13409
- * instances of the OpenFin `Platform` class.
13410
- *
13411
- * @packageDocumentation
13412
- */
13413
13630
  var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
13414
13631
  if (k2 === undefined) k2 = k;
13415
13632
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -13425,10 +13642,20 @@ Factory$3.default = PlatformModule;
13425
13642
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
13426
13643
  };
13427
13644
  Object.defineProperty(exports, "__esModule", { value: true });
13428
- const Factory_1 = Factory$3;
13429
- exports.default = Factory_1.default;
13645
+ /**
13646
+ * Entry points for the OpenFin `Platform` API (`fin.Platform`)
13647
+ *
13648
+ * * {@link PlatformModule} contains static members of the `Platform` API, accessible through `fin.Platform`.
13649
+ * * {@link Platform} describes an instance of an OpenFin Platform, e.g. as returned by `fin.Platform.getCurrent`.
13650
+ *
13651
+ * 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),
13652
+ * both of these were documented on the same page.
13653
+ *
13654
+ * @packageDocumentation
13655
+ */
13656
+ __exportStar(Factory$3, exports);
13430
13657
  __exportStar(Instance$2, exports);
13431
- } (platform));
13658
+ } (platform$1));
13432
13659
 
13433
13660
  var me = {};
13434
13661
 
@@ -13436,9 +13663,9 @@ var me = {};
13436
13663
  Object.defineProperty(exports, "__esModule", { value: true });
13437
13664
  exports.getMe = exports.getBaseMe = exports.environmentUnsupportedMessage = void 0;
13438
13665
  const view_1 = requireView();
13439
- const frame_1 = frame;
13666
+ const frame_1 = frame$1;
13440
13667
  const window_1 = requireWindow();
13441
- const external_application_1 = externalApplication;
13668
+ const external_application_1 = externalApplication$1;
13442
13669
  exports.environmentUnsupportedMessage = 'You are not running in OpenFin.';
13443
13670
  function getBaseMe(entityType, uuid, name) {
13444
13671
  const entityTypeHelpers = {
@@ -14099,7 +14326,7 @@ function requireInteropBroker () {
14099
14326
  hasRequiredInteropBroker = 1;
14100
14327
  Object.defineProperty(InteropBroker, "__esModule", { value: true });
14101
14328
  InteropBroker.InteropBroker = void 0;
14102
- const base_1 = base;
14329
+ const base_1 = base$1;
14103
14330
  const SessionContextGroupBroker_1 = requireSessionContextGroupBroker();
14104
14331
  const utils_1 = utils$1;
14105
14332
  const lodash_1 = require$$3;
@@ -14674,7 +14901,8 @@ function requireInteropBroker () {
14674
14901
  * ```
14675
14902
  */
14676
14903
  // eslint-disable-next-line class-methods-use-this
14677
- async handleFiredIntent(intent, clientIdentity) {
14904
+ async handleFiredIntent(intent, clientIdentity // TODO(CORE-811): remove inline intersected type
14905
+ ) {
14678
14906
  const warning = (0, utils_1.generateOverrideWarning)('fdc3.raiseIntent', 'InteropBroker.handleFiredIntent', clientIdentity, 'interopClient.fireIntent');
14679
14907
  console.warn(warning);
14680
14908
  throw new Error(utils_1.BROKER_ERRORS.fireIntent);
@@ -14741,7 +14969,7 @@ function requireInteropBroker () {
14741
14969
  * More information on the AppIntent type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/AppIntent).
14742
14970
  *
14743
14971
  * @param options
14744
- * @param clientIdentity Identity of the Client making the request.
14972
+ * @param clientIdentity Identity of the Client making the request.
14745
14973
  *
14746
14974
  * @example
14747
14975
  * ```js
@@ -14758,7 +14986,8 @@ function requireInteropBroker () {
14758
14986
  * ```
14759
14987
  */
14760
14988
  // eslint-disable-next-line class-methods-use-this
14761
- async handleInfoForIntent(options, clientIdentity) {
14989
+ async handleInfoForIntent(options, clientIdentity // TODO(CORE-811): remove inline intersected type
14990
+ ) {
14762
14991
  const warning = (0, utils_1.generateOverrideWarning)('fdc3.findIntent', 'InteropBroker.handleInfoForIntent', clientIdentity, 'interopClient.getInfoForIntent');
14763
14992
  console.warn(warning);
14764
14993
  throw new Error(utils_1.BROKER_ERRORS.getInfoForIntent);
@@ -14804,7 +15033,8 @@ function requireInteropBroker () {
14804
15033
  * ```
14805
15034
  */
14806
15035
  // eslint-disable-next-line class-methods-use-this
14807
- async handleInfoForIntentsByContext(context, clientIdentity) {
15036
+ async handleInfoForIntentsByContext(context, clientIdentity // TODO(CORE-811): remove inline intersected type
15037
+ ) {
14808
15038
  const warning = (0, utils_1.generateOverrideWarning)('fdc3.findIntentsByContext', 'InteropBroker.handleInfoForIntentsByContext', clientIdentity, 'interopClient.getInfoForIntentsByContext');
14809
15039
  console.warn(warning);
14810
15040
  throw new Error(utils_1.BROKER_ERRORS.getInfoForIntentsByContext);
@@ -14830,7 +15060,7 @@ function requireInteropBroker () {
14830
15060
  * More information on the IntentResolution type can be found in the [FDC3 documentation](https://fdc3.finos.org/docs/api/ref/IntentResolution).
14831
15061
  *
14832
15062
  * @param contextForIntent Data passed between entities and applications.
14833
- * @param clientIdentity Identity of the Client making the request.
15063
+ * @param clientIdentity Identity of the Client making the request.
14834
15064
  *
14835
15065
  * @example
14836
15066
  * ```js
@@ -14891,7 +15121,7 @@ function requireInteropBroker () {
14891
15121
  /**
14892
15122
  * Responsible for resolving the fdc3.findInstances call.
14893
15123
  * Must be overridden
14894
- * @param app AppIdentifier that was passed to fdc3.findInstances
15124
+ * @param app AppIdentifier that was passed to fdc3.findInstances
14895
15125
  * @param clientIdentity Identity of the Client making the request.
14896
15126
  */
14897
15127
  // eslint-disable-next-line class-methods-use-this
@@ -14926,7 +15156,7 @@ function requireInteropBroker () {
14926
15156
  * fin.Platform.init({
14927
15157
  * interopOverride: async (InteropBroker) => {
14928
15158
  * class Override extends InteropBroker {
14929
- * async invokeContextHandler(options, clientIdentity) {
15159
+ * async invokeContextHandler(clientIdentity, handlerId, context) {
14930
15160
  * return super.invokeContextHandler(clientIdentity, handlerId, {
14931
15161
  * ...context,
14932
15162
  * contextMetadata: {
@@ -14966,7 +15196,7 @@ function requireInteropBroker () {
14966
15196
  * fin.Platform.init({
14967
15197
  * interopOverride: async (InteropBroker) => {
14968
15198
  * class Override extends InteropBroker {
14969
- * async invokeIntentHandler(options, clientIdentity) {
15199
+ * async invokeIntentHandler(clientIdentity, handlerId, context) {
14970
15200
  * const { context } = intent;
14971
15201
  * return super.invokeIntentHandler(clientIdentity, handlerId, {
14972
15202
  * ...intent,
@@ -15305,7 +15535,8 @@ function requireInteropBroker () {
15305
15535
  }
15306
15536
  // Setup Channel Connection Logic
15307
15537
  wireChannel(channel) {
15308
- channel.onConnection(async (clientIdentity, payload) => {
15538
+ channel.onConnection(async (clientIdentity, // TODO(CORE-811): remove inline intersected type
15539
+ payload) => {
15309
15540
  if (!(await this.isConnectionAuthorized(clientIdentity, payload))) {
15310
15541
  throw new Error(`Connection not authorized for ${clientIdentity.uuid}, ${clientIdentity.name}`);
15311
15542
  }
@@ -15429,7 +15660,7 @@ var __classPrivateFieldGet$3 = (commonjsGlobal && commonjsGlobal.__classPrivateF
15429
15660
  };
15430
15661
  var _SessionContextGroupClient_clientPromise;
15431
15662
  Object.defineProperty(SessionContextGroupClient$1, "__esModule", { value: true });
15432
- const base_1$3 = base;
15663
+ const base_1$3 = base$1;
15433
15664
  const utils_1$3 = utils$1;
15434
15665
  class SessionContextGroupClient extends base_1$3.Base {
15435
15666
  constructor(wire, client, id) {
@@ -15516,7 +15747,7 @@ var __classPrivateFieldGet$2 = (commonjsGlobal && commonjsGlobal.__classPrivateF
15516
15747
  var _InteropClient_clientPromise, _InteropClient_sessionContextGroups;
15517
15748
  Object.defineProperty(InteropClient$1, "__esModule", { value: true });
15518
15749
  InteropClient$1.InteropClient = void 0;
15519
- const base_1$2 = base;
15750
+ const base_1$2 = base$1;
15520
15751
  const SessionContextGroupClient_1 = SessionContextGroupClient$1;
15521
15752
  const utils_1$2 = utils$1;
15522
15753
  /**
@@ -16185,39 +16416,46 @@ class InteropClient extends base_1$2.Base {
16185
16416
  InteropClient$1.InteropClient = InteropClient;
16186
16417
  _InteropClient_clientPromise = new WeakMap(), _InteropClient_sessionContextGroups = new WeakMap();
16187
16418
 
16188
- var overrideCheck$1 = {};
16419
+ var overrideCheck = {};
16189
16420
 
16190
- Object.defineProperty(overrideCheck$1, "__esModule", { value: true });
16191
- overrideCheck$1.overrideCheck = overrideCheck$1.getDefaultViewFdc3VersionFromAppInfo = void 0;
16192
- const InteropBroker_1 = requireInteropBroker();
16193
- function getDefaultViewFdc3VersionFromAppInfo({ manifest, initialOptions }) {
16194
- var _a, _b, _c, _d;
16195
- const setVersion = (_c = (_b = (_a = manifest.platform) === null || _a === void 0 ? void 0 : _a.defaultViewOptions) === null || _b === void 0 ? void 0 : _b.fdc3InteropApi) !== null && _c !== void 0 ? _c : (_d = initialOptions.defaultViewOptions) === null || _d === void 0 ? void 0 : _d.fdc3InteropApi;
16196
- return ['1.2', '2.0'].includes(setVersion !== null && setVersion !== void 0 ? setVersion : '') ? setVersion : undefined;
16197
- }
16198
- overrideCheck$1.getDefaultViewFdc3VersionFromAppInfo = getDefaultViewFdc3VersionFromAppInfo;
16199
- // TODO: Unit test this
16200
- function overrideCheck(overriddenBroker, fdc3InteropApi) {
16201
- if (fdc3InteropApi && fdc3InteropApi === '2.0') {
16202
- const mustOverrideAPIs = [
16203
- 'fdc3HandleFindInstances',
16204
- 'handleInfoForIntent',
16205
- 'handleInfoForIntentsByContext',
16206
- 'fdc3HandleGetAppMetadata',
16207
- 'fdc3HandleGetInfo',
16208
- 'fdc3HandleOpen',
16209
- 'handleFiredIntent',
16210
- 'handleFiredIntentForContext'
16211
- ];
16212
- const notOverridden = mustOverrideAPIs.filter((api) => {
16213
- return overriddenBroker[api] === InteropBroker_1.InteropBroker.prototype[api];
16214
- });
16215
- if (notOverridden.length > 0) {
16216
- console.warn(`WARNING: FDC3 2.0 has been set as a default option for Views in this Platform, but the required InteropBroker APIs for FDC3 2.0 compliance have not all been overridden.\nThe following APIs need to be overridden:\n${notOverridden.join('\n')}`);
16217
- }
16218
- }
16421
+ var hasRequiredOverrideCheck;
16422
+
16423
+ function requireOverrideCheck () {
16424
+ if (hasRequiredOverrideCheck) return overrideCheck;
16425
+ hasRequiredOverrideCheck = 1;
16426
+ Object.defineProperty(overrideCheck, "__esModule", { value: true });
16427
+ overrideCheck.overrideCheck = overrideCheck.getDefaultViewFdc3VersionFromAppInfo = void 0;
16428
+ const InteropBroker_1 = requireInteropBroker();
16429
+ function getDefaultViewFdc3VersionFromAppInfo({ manifest, initialOptions }) {
16430
+ var _a, _b, _c, _d;
16431
+ const setVersion = (_c = (_b = (_a = manifest.platform) === null || _a === void 0 ? void 0 : _a.defaultViewOptions) === null || _b === void 0 ? void 0 : _b.fdc3InteropApi) !== null && _c !== void 0 ? _c : (_d = initialOptions.defaultViewOptions) === null || _d === void 0 ? void 0 : _d.fdc3InteropApi;
16432
+ return ['1.2', '2.0'].includes(setVersion !== null && setVersion !== void 0 ? setVersion : '') ? setVersion : undefined;
16433
+ }
16434
+ overrideCheck.getDefaultViewFdc3VersionFromAppInfo = getDefaultViewFdc3VersionFromAppInfo;
16435
+ // TODO: Unit test this
16436
+ function overrideCheck$1(overriddenBroker, fdc3InteropApi) {
16437
+ if (fdc3InteropApi && fdc3InteropApi === '2.0') {
16438
+ const mustOverrideAPIs = [
16439
+ 'fdc3HandleFindInstances',
16440
+ 'handleInfoForIntent',
16441
+ 'handleInfoForIntentsByContext',
16442
+ 'fdc3HandleGetAppMetadata',
16443
+ 'fdc3HandleGetInfo',
16444
+ 'fdc3HandleOpen',
16445
+ 'handleFiredIntent',
16446
+ 'handleFiredIntentForContext'
16447
+ ];
16448
+ const notOverridden = mustOverrideAPIs.filter((api) => {
16449
+ return overriddenBroker[api] === InteropBroker_1.InteropBroker.prototype[api];
16450
+ });
16451
+ if (notOverridden.length > 0) {
16452
+ console.warn(`WARNING: FDC3 2.0 has been set as a default option for Views in this Platform, but the required InteropBroker APIs for FDC3 2.0 compliance have not all been overridden.\nThe following APIs need to be overridden:\n${notOverridden.join('\n')}`);
16453
+ }
16454
+ }
16455
+ }
16456
+ overrideCheck.overrideCheck = overrideCheck$1;
16457
+ return overrideCheck;
16219
16458
  }
16220
- overrideCheck$1.overrideCheck = overrideCheck;
16221
16459
 
16222
16460
  var hasRequiredFactory;
16223
16461
 
@@ -16225,12 +16463,13 @@ function requireFactory () {
16225
16463
  if (hasRequiredFactory) return Factory$1;
16226
16464
  hasRequiredFactory = 1;
16227
16465
  Object.defineProperty(Factory$1, "__esModule", { value: true });
16466
+ Factory$1.InteropModule = void 0;
16228
16467
  const lodash_1 = require$$3;
16229
16468
  const inaccessibleObject_1 = inaccessibleObject;
16230
- const base_1 = base;
16469
+ const base_1 = base$1;
16231
16470
  const InteropBroker_1 = requireInteropBroker();
16232
16471
  const InteropClient_1 = InteropClient$1;
16233
- const overrideCheck_1 = overrideCheck$1;
16472
+ const overrideCheck_1 = requireOverrideCheck();
16234
16473
  const common_utils_1 = commonUtils;
16235
16474
  const defaultOverride = (Class) => new Class();
16236
16475
  const BrokerParamAccessError = 'You have attempted to use or modify InteropBroker parameters, which is not allowed. You are likely using an older InteropBroker override scheme. Please consult our Interop docs for guidance on migrating to the new override scheme.';
@@ -16261,7 +16500,6 @@ function requireFactory () {
16261
16500
  * const contextGroups = await interopBroker.getContextGroups();
16262
16501
  * console.log(contextGroups);
16263
16502
  * ```
16264
- * @static
16265
16503
  */
16266
16504
  async init(name, override = defaultOverride) {
16267
16505
  var _a;
@@ -16319,7 +16557,6 @@ function requireFactory () {
16319
16557
  * const contextGroupInfo = await client.getInfoForContextGroup();
16320
16558
  * console.log(contextGroupInfo);
16321
16559
  * ```
16322
- * @static
16323
16560
  */
16324
16561
  connectSync(name, interopConfig) {
16325
16562
  this.wire.sendAction('interop-connect-sync').catch(() => {
@@ -16328,7 +16565,7 @@ function requireFactory () {
16328
16565
  return new InteropClient_1.InteropClient(this.wire, name, interopConfig);
16329
16566
  }
16330
16567
  }
16331
- Factory$1.default = InteropModule;
16568
+ Factory$1.InteropModule = InteropModule;
16332
16569
  return Factory$1;
16333
16570
  }
16334
16571
 
@@ -16339,10 +16576,10 @@ function requireInterop () {
16339
16576
  hasRequiredInterop = 1;
16340
16577
  (function (exports) {
16341
16578
  /**
16342
- * Entry point for the OpenFin Interop namespace.
16579
+ * Entry point for the OpenFin `Interop` API (`fin.Interop`).
16343
16580
  *
16344
- * "InteropModule" contains static members of the `Interop` namespace (available under `fin.Interop`), while `InteropClient` and
16345
- * `InteropBroker` document instances of their respective classes.
16581
+ * * {@link InteropModule} contains static members of the `Interop` API (available under `fin.Interop`)
16582
+ * * {@link InteropClient} and {@link InteropBroker} document instances of their respective classes.
16346
16583
  *
16347
16584
  * @packageDocumentation
16348
16585
  */
@@ -16361,8 +16598,7 @@ function requireInterop () {
16361
16598
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
16362
16599
  };
16363
16600
  Object.defineProperty(exports, "__esModule", { value: true });
16364
- const Factory_1 = requireFactory();
16365
- exports.default = Factory_1.default;
16601
+ __exportStar(requireFactory(), exports);
16366
16602
  __exportStar(InteropClient$1, exports);
16367
16603
  __exportStar(requireInteropBroker(), exports);
16368
16604
  } (interop));
@@ -16398,12 +16634,14 @@ var _SnapshotSource_identity, _SnapshotSource_getConnection, _SnapshotSource_get
16398
16634
  Object.defineProperty(Instance, "__esModule", { value: true });
16399
16635
  Instance.SnapshotSource = void 0;
16400
16636
  /* eslint-disable @typescript-eslint/no-non-null-assertion */
16401
- const base_1$1 = base;
16637
+ const base_1$1 = base$1;
16402
16638
  const utils_1$1 = utils;
16403
16639
  const connectionMap = new Map();
16404
16640
  /**
16405
16641
  * Enables configuring a SnapshotSource with custom getSnapshot and applySnapshot methods.
16406
16642
  *
16643
+ * @typeParam Snapshot Implementation-defined shape of an application snapshot. Allows
16644
+ * custom snapshot implementations for legacy applications to define their own snapshot format.
16407
16645
  */
16408
16646
  class SnapshotSource extends base_1$1.Base {
16409
16647
  /**
@@ -16538,13 +16776,19 @@ Instance.SnapshotSource = SnapshotSource;
16538
16776
  _SnapshotSource_identity = new WeakMap(), _SnapshotSource_getConnection = new WeakMap(), _SnapshotSource_getClient = new WeakMap(), _SnapshotSource_startConnection = new WeakMap(), _SnapshotSource_setUpConnectionListener = new WeakMap();
16539
16777
 
16540
16778
  Object.defineProperty(Factory, "__esModule", { value: true });
16541
- const base_1 = base;
16779
+ Factory.SnapshotSourceModule = void 0;
16780
+ const base_1 = base$1;
16542
16781
  const Instance_1 = Instance;
16543
16782
  const utils_1 = utils;
16783
+ /**
16784
+ * Static namespace for OpenFin API methods that interact with the {@link SnapshotSource} class, available under `fin.SnapshotSource`.
16785
+ */
16544
16786
  class SnapshotSourceModule extends base_1.Base {
16545
16787
  /**
16546
16788
  * Initializes a SnapshotSource with the getSnapshot and applySnapshot methods defined.
16547
- * @param provider
16789
+ *
16790
+ * @typeParam Snapshot Implementation-defined shape of an application snapshot. Allows
16791
+ * custom snapshot implementations for legacy applications to define their own snapshot format.
16548
16792
  *
16549
16793
  * @example
16550
16794
  * ```js
@@ -16561,7 +16805,7 @@ class SnapshotSourceModule extends base_1.Base {
16561
16805
  *
16562
16806
  * await fin.SnapshotSource.init(snapshotProvider);
16563
16807
  * ```
16564
- * @static
16808
+ *
16565
16809
  */
16566
16810
  async init(provider) {
16567
16811
  this.wire.sendAction('snapshot-source-init').catch((e) => {
@@ -16581,7 +16825,6 @@ class SnapshotSourceModule extends base_1.Base {
16581
16825
  }
16582
16826
  /**
16583
16827
  * Synchronously returns a SnapshotSource object that represents the current SnapshotSource.
16584
- * @param identity
16585
16828
  *
16586
16829
  * @example
16587
16830
  * ```js
@@ -16589,7 +16832,6 @@ class SnapshotSourceModule extends base_1.Base {
16589
16832
  * // Use wrapped instance's getSnapshot method, e.g.:
16590
16833
  * const snapshot = await snapshotSource.getSnapshot();
16591
16834
  * ```
16592
- * @static
16593
16835
  */
16594
16836
  wrapSync(identity) {
16595
16837
  this.wire.sendAction('snapshot-source-wrap-sync').catch((e) => {
@@ -16599,7 +16841,6 @@ class SnapshotSourceModule extends base_1.Base {
16599
16841
  }
16600
16842
  /**
16601
16843
  * Asynchronously returns a SnapshotSource object that represents the current SnapshotSource.
16602
- * @param identity
16603
16844
  *
16604
16845
  * @example
16605
16846
  * ```js
@@ -16607,7 +16848,6 @@ class SnapshotSourceModule extends base_1.Base {
16607
16848
  * // Use wrapped instance's getSnapshot method, e.g.:
16608
16849
  * const snapshot = await snapshotSource.getSnapshot();
16609
16850
  * ```
16610
- * @static
16611
16851
  */
16612
16852
  async wrap(identity) {
16613
16853
  this.wire.sendAction('snapshot-source-wrap').catch((e) => {
@@ -16616,15 +16856,17 @@ class SnapshotSourceModule extends base_1.Base {
16616
16856
  return this.wrapSync(identity);
16617
16857
  }
16618
16858
  }
16619
- Factory.default = SnapshotSourceModule;
16859
+ Factory.SnapshotSourceModule = SnapshotSourceModule;
16620
16860
 
16621
16861
  (function (exports) {
16622
16862
  /**
16623
- * Entry point for the OpenFin SnapshotSource namespace.
16863
+ * Entry points for the OpenFin `SnapshotSource` API (`fin.SnapshotSource`).
16624
16864
  *
16625
- * Because TypeDoc does not currently support multiple modules with the same name, the module alias "SnapshotSourceModule" is used for
16626
- * the module containing static members of the `SnapshotSource` namespace (available under `fin.SnapshotSource`), while `SnapshotSource` documents
16627
- * instances of the OpenFin `SnapshotSource` class.
16865
+ * * {@link SnapshotSourceModule} contains static members of the `SnapshotSource` API, accessible through `fin.SnapshotSource`.
16866
+ * * {@link SnapshotSource} describes an instance of an OpenFin SnapshotSource, e.g. as returned by `fin.SnapshotSource.wrap`.
16867
+ *
16868
+ * 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),
16869
+ * both of these were documented on the same page.
16628
16870
  *
16629
16871
  * @packageDocumentation
16630
16872
  */
@@ -16643,27 +16885,30 @@ Factory.default = SnapshotSourceModule;
16643
16885
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
16644
16886
  };
16645
16887
  Object.defineProperty(exports, "__esModule", { value: true });
16646
- const Factory_1 = Factory;
16647
- exports.default = Factory_1.default;
16888
+ __exportStar(Factory, exports);
16648
16889
  __exportStar(Instance, exports);
16649
16890
  } (snapshotSource));
16650
16891
 
16651
16892
  Object.defineProperty(fin, "__esModule", { value: true });
16893
+ fin.Fin = void 0;
16652
16894
  const events_1$3 = eventsExports;
16653
16895
  // Import from the file rather than the directory in case someone consuming types is using module resolution other than "node"
16654
- const index_1 = system;
16896
+ const index_1 = system$1;
16655
16897
  const index_2 = requireWindow();
16656
16898
  const index_3 = requireApplication();
16657
16899
  const index_4 = interappbus;
16658
16900
  const index_5 = clipboard;
16659
- const index_6 = externalApplication;
16660
- const index_7 = frame;
16661
- const index_8 = globalHotkey;
16901
+ const index_6 = externalApplication$1;
16902
+ const index_7 = frame$1;
16903
+ const index_8 = globalHotkey$1;
16662
16904
  const index_9 = requireView();
16663
- const index_10 = platform;
16905
+ const index_10 = platform$1;
16664
16906
  const me_1$1 = me;
16665
16907
  const interop_1 = requireInterop();
16666
16908
  const snapshot_source_1 = snapshotSource;
16909
+ /**
16910
+ * @internal
16911
+ */
16667
16912
  class Fin extends events_1$3.EventEmitter {
16668
16913
  /**
16669
16914
  * @internal
@@ -16671,18 +16916,18 @@ class Fin extends events_1$3.EventEmitter {
16671
16916
  constructor(wire) {
16672
16917
  super();
16673
16918
  this.wire = wire;
16674
- this.System = new index_1.default(wire);
16675
- this.Window = new index_2.default(wire);
16676
- this.Application = new index_3.default(wire);
16677
- this.InterApplicationBus = new index_4.default(wire);
16678
- this.Clipboard = new index_5.default(wire);
16679
- this.ExternalApplication = new index_6.default(wire);
16680
- this.Frame = new index_7.default(wire);
16681
- this.GlobalHotkey = new index_8.default(wire);
16682
- this.Platform = new index_10.default(wire, this.InterApplicationBus.Channel);
16683
- this.View = new index_9.default(wire);
16684
- this.Interop = new interop_1.default(wire);
16685
- this.SnapshotSource = new snapshot_source_1.default(wire);
16919
+ this.System = new index_1.System(wire);
16920
+ this.Window = new index_2._WindowModule(wire);
16921
+ this.Application = new index_3.ApplicationModule(wire);
16922
+ this.InterApplicationBus = new index_4.InterApplicationBus(wire);
16923
+ this.Clipboard = new index_5.Clipboard(wire);
16924
+ this.ExternalApplication = new index_6.ExternalApplicationModule(wire);
16925
+ this.Frame = new index_7._FrameModule(wire);
16926
+ this.GlobalHotkey = new index_8.GlobalHotkey(wire);
16927
+ this.Platform = new index_10.PlatformModule(wire, this.InterApplicationBus.Channel);
16928
+ this.View = new index_9.ViewModule(wire);
16929
+ this.Interop = new interop_1.InteropModule(wire);
16930
+ this.SnapshotSource = new snapshot_source_1.SnapshotSourceModule(wire);
16686
16931
  wire.registerFin(this);
16687
16932
  this.me = (0, me_1$1.getMe)(wire);
16688
16933
  // Handle disconnect events
@@ -16691,7 +16936,7 @@ class Fin extends events_1$3.EventEmitter {
16691
16936
  });
16692
16937
  }
16693
16938
  }
16694
- fin.default = Fin;
16939
+ fin.Fin = Fin;
16695
16940
 
16696
16941
  var wire = {};
16697
16942
 
@@ -17993,7 +18238,7 @@ function requireMain () {
17993
18238
  Object.defineProperty(exports, "__esModule", { value: true });
17994
18239
  exports.ChannelProvider = exports.ChannelClient = exports.Frame = exports.View = exports.System = exports.Window = exports.Application = exports.Fin = exports.launch = exports.connect = void 0;
17995
18240
  const fin_1 = fin;
17996
- exports.Fin = fin_1.default;
18241
+ Object.defineProperty(exports, "Fin", { enumerable: true, get: function () { return fin_1.Fin; } });
17997
18242
  const index_1 = requireApplication();
17998
18243
  Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return index_1.Application; } });
17999
18244
  const window_1 = requireWindow();
@@ -18001,13 +18246,13 @@ function requireMain () {
18001
18246
  const view_1 = requireView();
18002
18247
  Object.defineProperty(exports, "View", { enumerable: true, get: function () { return view_1.View; } });
18003
18248
  const client_1 = client;
18004
- exports.ChannelClient = client_1.default;
18249
+ Object.defineProperty(exports, "ChannelClient", { enumerable: true, get: function () { return client_1.ChannelClient; } });
18005
18250
  const provider_1 = provider;
18006
18251
  Object.defineProperty(exports, "ChannelProvider", { enumerable: true, get: function () { return provider_1.ChannelProvider; } });
18007
- const frame_1 = frame;
18252
+ const frame_1 = frame$1;
18008
18253
  Object.defineProperty(exports, "Frame", { enumerable: true, get: function () { return frame_1._Frame; } });
18009
- const system_1 = system;
18010
- exports.System = system_1.default;
18254
+ const system_1 = system$1;
18255
+ Object.defineProperty(exports, "System", { enumerable: true, get: function () { return system_1.System; } });
18011
18256
  const wire_1 = wire;
18012
18257
  const node_env_1 = requireNodeEnv();
18013
18258
  const transport_1 = transport;
@@ -18024,7 +18269,7 @@ function requireMain () {
18024
18269
  name: (_a = normalized.name) !== null && _a !== void 0 ? _a : normalized.uuid
18025
18270
  });
18026
18271
  await wire.connect(normalized);
18027
- return new fin_1.default(wire);
18272
+ return new fin_1.Fin(wire);
18028
18273
  }
18029
18274
  exports.connect = connect;
18030
18275
  async function launch(config) {
@@ -18042,15 +18287,261 @@ function requireMain () {
18042
18287
 
18043
18288
  var mainExports = requireMain();
18044
18289
 
18045
- var OpenFin$1 = {};
18290
+ var OpenFin$2 = {};
18291
+
18292
+ var events = {};
18293
+
18294
+ var application = {};
18295
+
18296
+ /**
18297
+ * Namespace for events that can be emitted by an {@link OpenFin.Application}. Includes events
18298
+ * re-propagated from the {@link OpenFin.Window} (and, transitively, {@link OpenFin.View}) level, prefixed with `window-` (and also, if applicable, `view-`).
18299
+ * For example, a view's "attached" event will fire as 'window-view-attached' at the application level.
18300
+ *
18301
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18302
+ *
18303
+ * This namespace contains only payload shapes for events that are unique to `Application`. Events that propagate to `Application` from
18304
+ * child {@link OpenFin.Window windows} and {@link OpenFin.View views} are defined in the {@link OpenFin.WindowEvents} and
18305
+ * {@link OpenFin.ViewEvents} namespaces. For a list of valid string keys for *all* application events, see {@link Application.on Application.on}.
18306
+ *
18307
+ * {@link NativeApplicationEvent Native application events} (i.e. those that have not propagated from {@link OpenFin.ViewEvents Views}
18308
+ * or {@link OpenFin.WindowEvents Windows} re-propagate to {@link OpenFin.SystemEvents System} with their type string prefixed with `application-`.
18309
+ * {@link OpenFin.ApplicationEvents.ApplicationWindowEvent Application events that are tied to Windows but do not propagate from them}
18310
+ * are propagated to `System` without any type string prefixing.
18311
+ *
18312
+ * "Requested" events (e.g. {@link RunRequestedEvent}) do not propagate.
18313
+ *
18314
+ * @packageDocumentation
18315
+ */
18316
+ Object.defineProperty(application, "__esModule", { value: true });
18317
+
18318
+ var base = {};
18319
+
18320
+ /**
18321
+ * Namespace for shared event payloads and utility types common to all event emitters.
18322
+ *
18323
+ * @packageDocumentation
18324
+ */
18325
+ Object.defineProperty(base, "__esModule", { value: true });
18326
+
18327
+ var externalApplication = {};
18328
+
18329
+ /**
18330
+ * Namespace for events that can be transmitted by an {@link OpenFin.ExternalApplication}.
18331
+ *
18332
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18333
+ *
18334
+ * For a list of valid string keys for external application events, see {@link ExternalApplication.on ExternalApplication.on}.
18335
+ *
18336
+ * @packageDocumentation
18337
+ */
18338
+ Object.defineProperty(externalApplication, "__esModule", { value: true });
18339
+
18340
+ var frame = {};
18341
+
18342
+ Object.defineProperty(frame, "__esModule", { value: true });
18343
+
18344
+ var globalHotkey = {};
18345
+
18346
+ Object.defineProperty(globalHotkey, "__esModule", { value: true });
18347
+
18348
+ var platform = {};
18349
+
18350
+ /**
18351
+ *
18352
+ * Namespace for events that can emitted by a {@link OpenFin.Platform}.
18353
+ *
18354
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18355
+ *
18356
+ * The Platform `EventEmitter` is a superset of the {@link OpenFin.Application} `EventEmitter`,
18357
+ * meaning it can listen to all {@link OpenFin.ApplicationEvents Application events} in addition to the
18358
+ * Platform-specific events listed here. For a list of valid string keys for *all* platform events, see
18359
+ * {@link Platform.on Platform.on}.
18360
+ *
18361
+ * @packageDocumentation
18362
+ */
18363
+ Object.defineProperty(platform, "__esModule", { value: true });
18364
+
18365
+ var system = {};
18366
+
18367
+ /**
18368
+ * Namespace for runtime-wide OpenFin events emitted by {@link System.System}. Includes events
18369
+ * re-propagated from {@link OpenFin.Application}, {@link OpenFin.Window}, and {@link OpenFin.View} (prefixed with `application-`, `window-`, and `view-`). All
18370
+ * event propagations are visible at the System level. Propagated events from WebContents (windows, views, frames) to the Application level will *not*
18371
+ * transitively re-propagate to the System level, because they are already visible at the system level and contain the identity
18372
+ * of the application. For example, an application's "closed" event will fire as 'application-closed' at the system level. A view's 'shown' event
18373
+ * will be visible as 'view-shown' at the system level, but *not* as `application-window-view-shown`.
18374
+ *
18375
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18376
+ *
18377
+ * This namespace contains only payload shapes for events that are unique to `System`. Events that propagate to `System` from
18378
+ * child {@link OpenFin.Application applications}, {@link OpenFin.Window windows}, and {@link OpenFin.View views} are defined in the
18379
+ * {@link OpenFin.ApplicationEvents}, {@link OpenFin.WindowEvents}, and {@link OpenFin.ViewEvents} namespaces. For a list of valid string keys for *all*
18380
+ * system events, see {@link System.on System.on}.
18381
+ *
18382
+ * @packageDocumentation
18383
+ */
18384
+ Object.defineProperty(system, "__esModule", { value: true });
18385
+
18386
+ var view = {};
18387
+
18388
+ /**
18389
+ * Namespace for events that can be emitted by a {@link OpenFin.View}.
18390
+ *
18391
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18392
+ *
18393
+ * This namespace contains only payload shapes for events that are unique to `View`. Events that are shared between all `WebContents`
18394
+ * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}. For a list
18395
+ * of valid string keys for *all* View events, see {@link View.on View.on}.
18396
+ *
18397
+ * View events propagate to their parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
18398
+ * and {@link OpenFin.SystemEvents System} with an added `viewIdentity` property and their event types prefixed with `'view-'`.
18399
+ *
18400
+ * @packageDocumentation
18401
+ */
18402
+ Object.defineProperty(view, "__esModule", { value: true });
18403
+
18404
+ var webcontents = {};
18405
+
18406
+ /**
18407
+ * Namespace for events shared by all OpenFin WebContents elements (i.e. {@link OpenFin.Window},
18408
+ * {@link OpenFin.View}).
18409
+ *
18410
+ * WebContents events are divided into two groups: {@link WillPropagateWebContentsEvent} and {@link NonPropagatedWebContentsEvent}. Propagating events
18411
+ * will re-emit on parent entities - e.g., a propagating event in a view will also be emitted on the view's
18412
+ * parent window, and propagating events in a window will also be emitted on the window's parent {@link OpenFin.Application}.
18413
+ *
18414
+ * Non-propagating events will not re-emit on parent entities.
18415
+ *
18416
+ * @packageDocumentation
18417
+ */
18418
+ Object.defineProperty(webcontents, "__esModule", { value: true });
18419
+
18420
+ var window$1 = {};
18421
+
18422
+ /**
18423
+ * Namespace for events that can be emitted by a {@link OpenFin.Window}.
18424
+ *
18425
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18426
+ *
18427
+ * This namespace contains only payload shapes for events that are unique to `Window`. Events that are shared between all `WebContents`
18428
+ * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}. Events that
18429
+ * propagate from `View` are defined in {@link OpenFin.ViewEvents}. For a list of valid string keys for *all* Window events, see
18430
+ * {@link Window.on Window.on}
18431
+ *
18432
+ * {@link OpenFin.WindowEvents.NativeWindowEvent Native window events} (i.e. those that are not propagated from a
18433
+ * {@link OpenFin.ViewEvents View}) propagate to their parent {@link OpenFin.ApplicationEvents Application} and
18434
+ * {@link OpenFin.SystemEvents System} with their event types prefixed with `'window-'`).
18435
+ *
18436
+ * "Requested" events (e.g. {@link AuthRequestedEvent}) do not propagate to `System. The {@link OpenFin.WindowEvents.WindowCloseRequestedEvent}
18437
+ * does not propagate at all.
18438
+ *
18439
+ * @packageDocumentation
18440
+ */
18441
+ Object.defineProperty(window$1, "__esModule", { value: true });
18442
+
18443
+ /**
18444
+ * Namespace for OpenFin event types. Each entity that emits OpenFin events has its own sub-namespace. Event payloads
18445
+ * themselves are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
18446
+ *
18447
+ * #### Event emitters
18448
+ *
18449
+ * The following entities emit OpenFin events, and have corresponding sub-namespaces:
18450
+ *
18451
+ * * {@link OpenFin.Application}: {@link OpenFin.ApplicationEvents}
18452
+ * * {@link OpenFin.ExternalApplication}: {@link OpenFin.ExternalApplicationEvents}
18453
+ * * {@link OpenFin.Frame}: {@link OpenFin.FrameEvents}
18454
+ * * {@link OpenFin.GlobalHotkey}: {@link OpenFin.GlobalHotkeyEvents}
18455
+ * * {@link OpenFin.Platform}: {@link OpenFin.PlatformEvents}
18456
+ * * {@link OpenFin.System}: {@link OpenFin.SystemEvents}
18457
+ * * {@link OpenFin.View}: {@link OpenFin.ViewEvents}
18458
+ * * {@link OpenFin.Window}: {@link OpenFin.WindowEvents}
18459
+ *
18460
+ * These `EventEmitter` entities share a common set of methods for interacting with the OpenFin event bus, which can be
18461
+ * seen on the individual documentation pages for each entity type.
18462
+ *
18463
+ * Registering event handlers is an asynchronous operation. It is important to ensure that the returned Promises are awaited to reduce the
18464
+ * risk of race conditions.
18465
+ *
18466
+ * When the `EventEmitter` receives an event from the browser process and emits on the renderer, all of the functions attached to that
18467
+ * specific event are called synchronously. Any values returned by the called listeners are ignored and will be discarded. If the window document
18468
+ * is destroyed by page navigation or reload, its registered event listeners will be removed.
18469
+ *
18470
+ * We recommend using Arrow Functions for event listeners to ensure the this scope is consistent with the original function context.
18471
+ *
18472
+ * Events re-propagate from smaller/more-local scopes to larger/more-global scopes. For example, an event emitted on a specific
18473
+ * view will propagate to the window in which the view is embedded, and then to the application in which the window is running, and
18474
+ * finally to the OpenFin runtime itself at the "system" level. For details on propagation semantics, see the namespace for
18475
+ * the propagating (or propagated-to) entity.
18476
+ *
18477
+ * If you need the payload type for a specific type of event (especially propagated events), use the emitting topic's `EventPayload`
18478
+ * (e.g. {@link WindowEvents.WindowEventPayload}) generic with the event's `type` string. For example, the payload of
18479
+ * a {@link ViewEvents.CreatedEvent} after it has propagated to its parent {@link WindowEvents Window} can be found with
18480
+ * `WindowEventPayload<'view-created'>`.
18481
+ *
18482
+ * @packageDocumentation
18483
+ */
18484
+ Object.defineProperty(events, "__esModule", { value: true });
18485
+ events.WindowEvents = events.WebContentsEvents = events.ViewEvents = events.SystemEvents = events.PlatformEvents = events.GlobalHotkeyEvents = events.FrameEvents = events.ExternalApplicationEvents = events.BaseEvents = events.ApplicationEvents = void 0;
18486
+ const ApplicationEvents = application;
18487
+ events.ApplicationEvents = ApplicationEvents;
18488
+ const BaseEvents = base;
18489
+ events.BaseEvents = BaseEvents;
18490
+ const ExternalApplicationEvents = externalApplication;
18491
+ events.ExternalApplicationEvents = ExternalApplicationEvents;
18492
+ const FrameEvents = frame;
18493
+ events.FrameEvents = FrameEvents;
18494
+ const GlobalHotkeyEvents = globalHotkey;
18495
+ events.GlobalHotkeyEvents = GlobalHotkeyEvents;
18496
+ const PlatformEvents = platform;
18497
+ events.PlatformEvents = PlatformEvents;
18498
+ const SystemEvents = system;
18499
+ events.SystemEvents = SystemEvents;
18500
+ const ViewEvents = view;
18501
+ events.ViewEvents = ViewEvents;
18502
+ const WebContentsEvents = webcontents;
18503
+ events.WebContentsEvents = WebContentsEvents;
18504
+ const WindowEvents = window$1;
18505
+ events.WindowEvents = WindowEvents;
18506
+
18507
+ (function (exports) {
18508
+ /**
18509
+ * Top-level namespace for types referenced by the OpenFin API. Contains:
18510
+ *
18511
+ * * The type of the global `fin` entry point ({@link FinApi})
18512
+ * * Classes that act as static namespaces returned from the `fin` global (e.g. {@link ApplicationModule}, accessible via `fin.Application`)
18513
+ * * Instance classes that are returned from API calls (e.g. {@link Application}, accessible via `fin.Application.getCurrentSync()`)
18514
+ * * Parameter shapes for API methods (e.g. {@link ApplicationOptions}, used in `fin.Application.start()`)
18515
+ * * Event namespaces and payload union types (e.g. {@link ApplicationEvents} and {@link ApplicationEvent})
18516
+ *
18517
+ * @packageDocumentation
18518
+ */
18519
+ var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
18520
+ if (k2 === undefined) k2 = k;
18521
+ var desc = Object.getOwnPropertyDescriptor(m, k);
18522
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
18523
+ desc = { enumerable: true, get: function() { return m[k]; } };
18524
+ }
18525
+ Object.defineProperty(o, k2, desc);
18526
+ }) : (function(o, m, k, k2) {
18527
+ if (k2 === undefined) k2 = k;
18528
+ o[k2] = m[k];
18529
+ }));
18530
+ var __exportStar = (commonjsGlobal && commonjsGlobal.__exportStar) || function(m, exports) {
18531
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
18532
+ };
18533
+ Object.defineProperty(exports, "__esModule", { value: true });
18534
+ // Deprecated shim to preserve v30 namespace names
18535
+ __exportStar(events, exports);
18536
+ } (OpenFin$2));
18046
18537
 
18047
- Object.defineProperty(OpenFin$1, "__esModule", { value: true });
18538
+ var OpenFin = /*@__PURE__*/getDefaultExportFromCjs(OpenFin$2);
18048
18539
 
18049
- var OpenFin = /*#__PURE__*/_mergeNamespaces({
18540
+ var OpenFin$1 = /*#__PURE__*/_mergeNamespaces({
18050
18541
  __proto__: null,
18051
- default: OpenFin$1
18052
- }, [OpenFin$1]);
18542
+ default: OpenFin
18543
+ }, [OpenFin$2]);
18053
18544
 
18054
18545
  exports.connect = mainExports.connect;
18055
- exports.default = OpenFin;
18546
+ exports.default = OpenFin$1;
18056
18547
  exports.launch = mainExports.launch;