@openfin/core 34.78.7 → 34.78.8

package/out/mock.js

@@ -2,6 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var require$$0 = require('events');
 var require$$3 = require('lodash');
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -10,489 +11,253 @@ var mock = {};
 
 var OpenFin$1 = {};
 
-Object.defineProperty(OpenFin$1, "__esModule", { value: true });
+var events = {};
 
-var fin = {};
-
-var eventsExports = {};
-var events = {
-  get exports(){ return eventsExports; },
-  set exports(v){ eventsExports = v; },
-};
-
-var R = typeof Reflect === 'object' ? Reflect : null;
-var ReflectApply = R && typeof R.apply === 'function'
-  ? R.apply
-  : function ReflectApply(target, receiver, args) {
-    return Function.prototype.apply.call(target, receiver, args);
-  };
-
-var ReflectOwnKeys;
-if (R && typeof R.ownKeys === 'function') {
-  ReflectOwnKeys = R.ownKeys;
-} else if (Object.getOwnPropertySymbols) {
-  ReflectOwnKeys = function ReflectOwnKeys(target) {
-    return Object.getOwnPropertyNames(target)
-      .concat(Object.getOwnPropertySymbols(target));
-  };
-} else {
-  ReflectOwnKeys = function ReflectOwnKeys(target) {
-    return Object.getOwnPropertyNames(target);
-  };
-}
-
-function ProcessEmitWarning(warning) {
-  if (console && console.warn) console.warn(warning);
-}
-
-var NumberIsNaN = Number.isNaN || function NumberIsNaN(value) {
-  return value !== value;
-};
-
-function EventEmitter() {
-  EventEmitter.init.call(this);
-}
-events.exports = EventEmitter;
-eventsExports.once = once;
-
-// Backwards-compat with node 0.10.x
-EventEmitter.EventEmitter = EventEmitter;
-
-EventEmitter.prototype._events = undefined;
-EventEmitter.prototype._eventsCount = 0;
-EventEmitter.prototype._maxListeners = undefined;
-
-// By default EventEmitters will print a warning if more than 10 listeners are
-// added to it. This is a useful default which helps finding memory leaks.
-var defaultMaxListeners = 10;
-
-function checkListener(listener) {
-  if (typeof listener !== 'function') {
-    throw new TypeError('The "listener" argument must be of type Function. Received type ' + typeof listener);
-  }
-}
-
-Object.defineProperty(EventEmitter, 'defaultMaxListeners', {
-  enumerable: true,
-  get: function() {
-    return defaultMaxListeners;
-  },
-  set: function(arg) {
-    if (typeof arg !== 'number' || arg < 0 || NumberIsNaN(arg)) {
-      throw new RangeError('The value of "defaultMaxListeners" is out of range. It must be a non-negative number. Received ' + arg + '.');
-    }
-    defaultMaxListeners = arg;
-  }
-});
-
-EventEmitter.init = function() {
-
-  if (this._events === undefined ||
-      this._events === Object.getPrototypeOf(this)._events) {
-    this._events = Object.create(null);
-    this._eventsCount = 0;
-  }
-
-  this._maxListeners = this._maxListeners || undefined;
-};
-
-// Obviously not all Emitters should be limited to 10. This function allows
-// that to be increased. Set to zero for unlimited.
-EventEmitter.prototype.setMaxListeners = function setMaxListeners(n) {
-  if (typeof n !== 'number' || n < 0 || NumberIsNaN(n)) {
-    throw new RangeError('The value of "n" is out of range. It must be a non-negative number. Received ' + n + '.');
-  }
-  this._maxListeners = n;
-  return this;
-};
-
-function _getMaxListeners(that) {
-  if (that._maxListeners === undefined)
-    return EventEmitter.defaultMaxListeners;
-  return that._maxListeners;
-}
-
-EventEmitter.prototype.getMaxListeners = function getMaxListeners() {
-  return _getMaxListeners(this);
-};
-
-EventEmitter.prototype.emit = function emit(type) {
-  var args = [];
-  for (var i = 1; i < arguments.length; i++) args.push(arguments[i]);
-  var doError = (type === 'error');
-
-  var events = this._events;
-  if (events !== undefined)
-    doError = (doError && events.error === undefined);
-  else if (!doError)
-    return false;
-
-  // If there is no 'error' event listener then throw.
-  if (doError) {
-    var er;
-    if (args.length > 0)
-      er = args[0];
-    if (er instanceof Error) {
-      // Note: The comments on the `throw` lines are intentional, they show
-      // up in Node's output if this results in an unhandled exception.
-      throw er; // Unhandled 'error' event
-    }
-    // At least give some kind of context to the user
-    var err = new Error('Unhandled error.' + (er ? ' (' + er.message + ')' : ''));
-    err.context = er;
-    throw err; // Unhandled 'error' event
-  }
-
-  var handler = events[type];
-
-  if (handler === undefined)
-    return false;
-
-  if (typeof handler === 'function') {
-    ReflectApply(handler, this, args);
-  } else {
-    var len = handler.length;
-    var listeners = arrayClone(handler, len);
-    for (var i = 0; i < len; ++i)
-      ReflectApply(listeners[i], this, args);
-  }
-
-  return true;
-};
-
-function _addListener(target, type, listener, prepend) {
-  var m;
-  var events;
-  var existing;
-
-  checkListener(listener);
-
-  events = target._events;
-  if (events === undefined) {
-    events = target._events = Object.create(null);
-    target._eventsCount = 0;
-  } else {
-    // To avoid recursion in the case that type === "newListener"! Before
-    // adding it to the listeners, first emit "newListener".
-    if (events.newListener !== undefined) {
-      target.emit('newListener', type,
-                  listener.listener ? listener.listener : listener);
-
-      // Re-assign `events` because a newListener handler could have caused the
-      // this._events to be assigned to a new object
-      events = target._events;
-    }
-    existing = events[type];
-  }
-
-  if (existing === undefined) {
-    // Optimize the case of one listener. Don't need the extra array object.
-    existing = events[type] = listener;
-    ++target._eventsCount;
-  } else {
-    if (typeof existing === 'function') {
-      // Adding the second element, need to change to array.
-      existing = events[type] =
-        prepend ? [listener, existing] : [existing, listener];
-      // If we've already got an array, just append.
-    } else if (prepend) {
-      existing.unshift(listener);
-    } else {
-      existing.push(listener);
-    }
-
-    // Check for listener leak
-    m = _getMaxListeners(target);
-    if (m > 0 && existing.length > m && !existing.warned) {
-      existing.warned = true;
-      // No error code for this since it is a Warning
-      // eslint-disable-next-line no-restricted-syntax
-      var w = new Error('Possible EventEmitter memory leak detected. ' +
-                          existing.length + ' ' + String(type) + ' listeners ' +
-                          'added. Use emitter.setMaxListeners() to ' +
-                          'increase limit');
-      w.name = 'MaxListenersExceededWarning';
-      w.emitter = target;
-      w.type = type;
-      w.count = existing.length;
-      ProcessEmitWarning(w);
-    }
-  }
-
-  return target;
-}
-
-EventEmitter.prototype.addListener = function addListener(type, listener) {
-  return _addListener(this, type, listener, false);
-};
-
-EventEmitter.prototype.on = EventEmitter.prototype.addListener;
-
-EventEmitter.prototype.prependListener =
-    function prependListener(type, listener) {
-      return _addListener(this, type, listener, true);
-    };
-
-function onceWrapper() {
-  if (!this.fired) {
-    this.target.removeListener(this.type, this.wrapFn);
-    this.fired = true;
-    if (arguments.length === 0)
-      return this.listener.call(this.target);
-    return this.listener.apply(this.target, arguments);
-  }
-}
+var application$1 = {};
 
-function _onceWrap(target, type, listener) {
-  var state = { fired: false, wrapFn: undefined, target: target, type: type, listener: listener };
-  var wrapped = onceWrapper.bind(state);
-  wrapped.listener = listener;
-  state.wrapFn = wrapped;
-  return wrapped;
-}
-
-EventEmitter.prototype.once = function once(type, listener) {
-  checkListener(listener);
-  this.on(type, _onceWrap(this, type, listener));
-  return this;
-};
-
-EventEmitter.prototype.prependOnceListener =
-    function prependOnceListener(type, listener) {
-      checkListener(listener);
-      this.prependListener(type, _onceWrap(this, type, listener));
-      return this;
-    };
-
-// Emits a 'removeListener' event if and only if the listener was removed.
-EventEmitter.prototype.removeListener =
-    function removeListener(type, listener) {
-      var list, events, position, i, originalListener;
-
-      checkListener(listener);
-
-      events = this._events;
-      if (events === undefined)
-        return this;
-
-      list = events[type];
-      if (list === undefined)
-        return this;
-
-      if (list === listener || list.listener === listener) {
-        if (--this._eventsCount === 0)
-          this._events = Object.create(null);
-        else {
-          delete events[type];
-          if (events.removeListener)
-            this.emit('removeListener', type, list.listener || listener);
-        }
-      } else if (typeof list !== 'function') {
-        position = -1;
-
-        for (i = list.length - 1; i >= 0; i--) {
-          if (list[i] === listener || list[i].listener === listener) {
-            originalListener = list[i].listener;
-            position = i;
-            break;
-          }
-        }
-
-        if (position < 0)
-          return this;
-
-        if (position === 0)
-          list.shift();
-        else {
-          spliceOne(list, position);
-        }
-
-        if (list.length === 1)
-          events[type] = list[0];
-
-        if (events.removeListener !== undefined)
-          this.emit('removeListener', type, originalListener || listener);
-      }
-
-      return this;
-    };
-
-EventEmitter.prototype.off = EventEmitter.prototype.removeListener;
-
-EventEmitter.prototype.removeAllListeners =
-    function removeAllListeners(type) {
-      var listeners, events, i;
-
-      events = this._events;
-      if (events === undefined)
-        return this;
-
-      // not listening for removeListener, no need to emit
-      if (events.removeListener === undefined) {
-        if (arguments.length === 0) {
-          this._events = Object.create(null);
-          this._eventsCount = 0;
-        } else if (events[type] !== undefined) {
-          if (--this._eventsCount === 0)
-            this._events = Object.create(null);
-          else
-            delete events[type];
-        }
-        return this;
-      }
-
-      // emit removeListener for all listeners on all events
-      if (arguments.length === 0) {
-        var keys = Object.keys(events);
-        var key;
-        for (i = 0; i < keys.length; ++i) {
-          key = keys[i];
-          if (key === 'removeListener') continue;
-          this.removeAllListeners(key);
-        }
-        this.removeAllListeners('removeListener');
-        this._events = Object.create(null);
-        this._eventsCount = 0;
-        return this;
-      }
+/**
+ * Namespace for events that can be emitted by an {@link OpenFin.Application}.  Includes events
+ * re-propagated from the {@link OpenFin.Window} (and, transitively, {@link OpenFin.View}) level, prefixed with `window-` (and also, if applicable, `view-`).
+ * For example, a view's "attached" event will fire as 'window-view-attached' at the application level.
+ *
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * This namespace contains only payload shapes for events that are unique to `Application`.  Events that propagate to `Application` from
+ * child {@link OpenFin.Window windows} and {@link OpenFin.View views} are defined in the {@link OpenFin.WindowEvents} and
+ * {@link OpenFin.ViewEvents} namespaces.  For a list of valid string keys for *all* application events, see {@link Application.on Application.on}.
+ *
+ * {@link ApplicationSourcedEvent Application-sourced events} (i.e. those that have not propagated from {@link OpenFin.ViewEvents Views}
+ * or {@link OpenFin.WindowEvents Windows} re-propagate to {@link OpenFin.SystemEvents System} with their type string prefixed with `application-`.
+ * {@link ApplicationWindowEvent Application events that are tied to Windows but do not propagate from them}
+ * are propagated to `System` without any type string prefixing.
+ *
+ * "Requested" events (e.g. {@link RunRequestedEvent}) do not propagate.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(application$1, "__esModule", { value: true });
 
-      listeners = events[type];
+var base$1 = {};
 
-      if (typeof listeners === 'function') {
-        this.removeListener(type, listeners);
-      } else if (listeners !== undefined) {
-        // LIFO order
-        for (i = listeners.length - 1; i >= 0; i--) {
-          this.removeListener(type, listeners[i]);
-        }
-      }
-
-      return this;
-    };
+/**
+ * Namespace for shared event payloads and utility types common to all event emitters.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(base$1, "__esModule", { value: true });
 
-function _listeners(target, type, unwrap) {
-  var events = target._events;
+var externalApplication$1 = {};
 
-  if (events === undefined)
-    return [];
+/**
+ * Namespace for events that can be transmitted by an {@link OpenFin.ExternalApplication}.
+ *
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * For a list of valid string keys for external application events, see {@link ExternalApplication.on ExternalApplication.on}.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(externalApplication$1, "__esModule", { value: true });
 
-  var evlistener = events[type];
-  if (evlistener === undefined)
-    return [];
+var frame$1 = {};
 
-  if (typeof evlistener === 'function')
-    return unwrap ? [evlistener.listener || evlistener] : [evlistener];
+Object.defineProperty(frame$1, "__esModule", { value: true });
 
-  return unwrap ?
-    unwrapListeners(evlistener) : arrayClone(evlistener, evlistener.length);
-}
+var globalHotkey$1 = {};
 
-EventEmitter.prototype.listeners = function listeners(type) {
-  return _listeners(this, type, true);
-};
+Object.defineProperty(globalHotkey$1, "__esModule", { value: true });
 
-EventEmitter.prototype.rawListeners = function rawListeners(type) {
-  return _listeners(this, type, false);
-};
+var platform$1 = {};
 
-EventEmitter.listenerCount = function(emitter, type) {
-  if (typeof emitter.listenerCount === 'function') {
-    return emitter.listenerCount(type);
-  } else {
-    return listenerCount.call(emitter, type);
-  }
-};
-
-EventEmitter.prototype.listenerCount = listenerCount;
-function listenerCount(type) {
-  var events = this._events;
+/**
+ *
+ * Namespace for events that can emitted by a {@link OpenFin.Platform}.
+ *
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * The Platform `EventEmitter` is a superset of the {@link OpenFin.Application} `EventEmitter`,
+ * meaning it can listen to all {@link OpenFin.ApplicationEvents Application events} in addition to the
+ * Platform-specific events listed here.  For a list of valid string keys for *all* platform events, see
+ * {@link Platform.on Platform.on}.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(platform$1, "__esModule", { value: true });
 
-  if (events !== undefined) {
-    var evlistener = events[type];
+var system$1 = {};
 
-    if (typeof evlistener === 'function') {
-      return 1;
-    } else if (evlistener !== undefined) {
-      return evlistener.length;
-    }
-  }
+/**
+ * Namespace for runtime-wide OpenFin events emitted by {@link System.System}.  Includes events
+ * re-propagated from {@link OpenFin.Application}, {@link OpenFin.Window}, and {@link OpenFin.View} (prefixed with `application-`, `window-`, and `view-`).  All
+ * event propagations are visible at the System level. Propagated events from WebContents (windows, views, frames) to the Application level will *not*
+ * transitively re-propagate to the System level, because they are already visible at the system level and contain the identity
+ * of the application.  For example, an application's "closed" event will fire as 'application-closed' at the system level.  A view's 'shown' event
+ * will be visible as 'view-shown' at the system level, but *not* as `application-window-view-shown`.
+ *
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * This namespace contains only payload shapes for events that are unique to `System`.  Events that propagate to `System` from
+ * child {@link OpenFin.Application applications}, {@link OpenFin.Window windows}, and {@link OpenFin.View views} are defined in the
+ * {@link OpenFin.ApplicationEvents}, {@link OpenFin.WindowEvents}, and {@link OpenFin.ViewEvents} namespaces.  For a list of valid string keys for *all*
+ * system events, see {@link System.on System.on}.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(system$1, "__esModule", { value: true });
 
-  return 0;
-}
+var view$1 = {};
 
-EventEmitter.prototype.eventNames = function eventNames() {
-  return this._eventsCount > 0 ? ReflectOwnKeys(this._events) : [];
-};
+/**
+ * Namespace for events that can be emitted by a {@link OpenFin.View}.
+ *
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * This namespace contains only payload shapes for events that are unique to `View`.  Events that are shared between all `WebContents`
+ * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}.  For a list
+ * of valid string keys for *all* View events, see {@link View.on View.on}.
+ *
+ * View events propagate to their parent {@link OpenFin.WindowEvents Window}, {@link OpenFin.ApplicationEvents Application},
+ * and {@link OpenFin.SystemEvents System} with an added `viewIdentity` property and their event types prefixed with `'view-'`.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(view$1, "__esModule", { value: true });
 
-function arrayClone(arr, n) {
-  var copy = new Array(n);
-  for (var i = 0; i < n; ++i)
-    copy[i] = arr[i];
-  return copy;
-}
+var webcontents = {};
 
-function spliceOne(list, index) {
-  for (; index + 1 < list.length; index++)
-    list[index] = list[index + 1];
-  list.pop();
-}
+/**
+ * Namespace for events shared by all OpenFin WebContents elements (i.e. {@link OpenFin.Window},
+ * {@link OpenFin.View}).
+ *
+ * WebContents events are divided into two groups: {@link WillPropagateWebContentsEvent} and {@link NonPropagatedWebContentsEvent}.  Propagating events
+ * will re-emit on parent entities - e.g., a propagating event in a view will also be emitted on the view's
+ * parent window, and propagating events in a window will also be emitted on the window's parent {@link OpenFin.Application}.
+ *
+ * Non-propagating events will not re-emit on parent entities.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(webcontents, "__esModule", { value: true });
 
-function unwrapListeners(arr) {
-  var ret = new Array(arr.length);
-  for (var i = 0; i < ret.length; ++i) {
-    ret[i] = arr[i].listener || arr[i];
-  }
-  return ret;
-}
+var window$2 = {};
 
-function once(emitter, name) {
-  return new Promise(function (resolve, reject) {
-    function errorListener(err) {
-      emitter.removeListener(name, resolver);
-      reject(err);
-    }
+/**
+ * Namespace for events that can be emitted by a {@link OpenFin.Window}.
+ *
+ * Event payloads are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * This namespace contains only payload shapes for events that are unique to `Window`.  Events that are shared between all `WebContents`
+ * (i.e. {@link OpenFin.Window}, {@link OpenFin.View}) are defined in {@link OpenFin.WebContentsEvents}. Events that
+ * propagate from `View` are defined in {@link OpenFin.ViewEvents}. For a list of valid string keys for *all* Window events, see
+ * {@link Window.on Window.on}
+ *
+ * {@link OpenFin.WindowEvents.WindowSourcedEvent Window-sourced events} (i.e. those that are not propagated from a
+ * {@link OpenFin.ViewEvents View}) propagate to their parent {@link OpenFin.ApplicationEvents Application} and
+ * {@link OpenFin.SystemEvents System} with their event types prefixed with `'window-'`).
+ *
+ * "Requested" events (e.g. {@link AuthRequestedEvent}) do not propagate to `System.  The {@link OpenFin.WindowEvents.WindowCloseRequestedEvent}
+ * does not propagate at all.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(window$2, "__esModule", { value: true });
 
-    function resolver() {
-      if (typeof emitter.removeListener === 'function') {
-        emitter.removeListener('error', errorListener);
-      }
-      resolve([].slice.call(arguments));
-    }
-    eventTargetAgnosticAddListener(emitter, name, resolver, { once: true });
-    if (name !== 'error') {
-      addErrorHandlerIfEventEmitter(emitter, errorListener, { once: true });
-    }
-  });
-}
+/**
+ * Namespace for OpenFin event types. Each entity that emits OpenFin events has its own sub-namespace. Event payloads
+ * themselves are documented as interfaces, while algebraic helper types and derived types are documented as type aliases.
+ *
+ * #### Event emitters
+ *
+ * The following entities emit OpenFin events, and have corresponding sub-namespaces:
+ *
+ * * {@link OpenFin.Application}: {@link OpenFin.ApplicationEvents}
+ * * {@link OpenFin.ExternalApplication}: {@link OpenFin.ExternalApplicationEvents}
+ * * {@link OpenFin.Frame}: {@link OpenFin.FrameEvents}
+ * * {@link OpenFin.GlobalHotkey}: {@link OpenFin.GlobalHotkeyEvents}
+ * * {@link OpenFin.Platform}: {@link OpenFin.PlatformEvents}
+ * * {@link OpenFin.System}: {@link OpenFin.SystemEvents}
+ * * {@link OpenFin.View}: {@link OpenFin.ViewEvents}
+ * * {@link OpenFin.Window}: {@link OpenFin.WindowEvents}
+ *
+ * These `EventEmitter` entities share a common set of methods for interacting with the OpenFin event bus, which can be
+ * seen on the individual documentation pages for each entity type.
+ *
+ * Registering event handlers is an asynchronous operation. It is important to ensure that the returned Promises are awaited to reduce the
+ * risk of race conditions.
+ *
+ * When the `EventEmitter` receives an event from the browser process and emits on the renderer, all of the functions attached to that
+ * specific event are called synchronously. Any values returned by the called listeners are ignored and will be discarded.  If the window document
+ * is destroyed by page navigation or reload, its registered event listeners will be removed.
+ *
+ * We recommend using Arrow Functions for event listeners to ensure the this scope is consistent with the original function context.
+ *
+ * Events re-propagate from smaller/more-local scopes to larger/more-global scopes.  For example, an event emitted on a specific
+ * view will propagate to the window in which the view is embedded, and then to the application in which the window is running, and
+ * finally to the OpenFin runtime itself at the "system" level.  For details on propagation semantics, see the namespace for
+ * the propagating (or propagated-to) entity.
+ *
+ * If you need the payload type for a specific type of event (especially propagated events), use the emitting topic's `Payload` generic
+ * (e.g. {@link WindowEvents.Payload}) with the event's `type` string.  For example, the payload of
+ * a {@link ViewEvents.CreatedEvent} after it has propagated to its parent {@link WindowEvents Window} can be found with
+ * `WindowEvents.Payload<'view-created'>`.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(events, "__esModule", { value: true });
+events.WindowEvents = events.WebContentsEvents = events.ViewEvents = events.SystemEvents = events.PlatformEvents = events.GlobalHotkeyEvents = events.FrameEvents = events.ExternalApplicationEvents = events.BaseEvents = events.ApplicationEvents = void 0;
+const ApplicationEvents = application$1;
+events.ApplicationEvents = ApplicationEvents;
+const BaseEvents = base$1;
+events.BaseEvents = BaseEvents;
+const ExternalApplicationEvents = externalApplication$1;
+events.ExternalApplicationEvents = ExternalApplicationEvents;
+const FrameEvents = frame$1;
+events.FrameEvents = FrameEvents;
+const GlobalHotkeyEvents = globalHotkey$1;
+events.GlobalHotkeyEvents = GlobalHotkeyEvents;
+const PlatformEvents = platform$1;
+events.PlatformEvents = PlatformEvents;
+const SystemEvents = system$1;
+events.SystemEvents = SystemEvents;
+const ViewEvents = view$1;
+events.ViewEvents = ViewEvents;
+const WebContentsEvents = webcontents;
+events.WebContentsEvents = WebContentsEvents;
+const WindowEvents = window$2;
+events.WindowEvents = WindowEvents;
 
-function addErrorHandlerIfEventEmitter(emitter, handler, flags) {
-  if (typeof emitter.on === 'function') {
-    eventTargetAgnosticAddListener(emitter, 'error', handler, flags);
-  }
-}
+(function (exports) {
+	/**
+	 * Top-level namespace for types referenced by the OpenFin API.  Contains:
+	 *
+	 * * The type of the global `fin` entry point ({@link FinApi})
+	 * * Classes that act as static namespaces returned from the `fin` global (e.g. {@link ApplicationModule}, accessible via `fin.Application`)
+	 * * Instance classes that are returned from API calls (e.g. {@link Application}, accessible via `fin.Application.getCurrentSync()`)
+	 * * Parameter shapes for API methods (e.g. {@link ApplicationOptions}, used in `fin.Application.start()`)
+	 * * Event namespaces and payload union types (e.g. {@link ApplicationEvents} and {@link ApplicationEvent})
+	 *
+	 * @packageDocumentation
+	 */
+	var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+	    if (k2 === undefined) k2 = k;
+	    var desc = Object.getOwnPropertyDescriptor(m, k);
+	    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+	      desc = { enumerable: true, get: function() { return m[k]; } };
+	    }
+	    Object.defineProperty(o, k2, desc);
+	}) : (function(o, m, k, k2) {
+	    if (k2 === undefined) k2 = k;
+	    o[k2] = m[k];
+	}));
+	var __exportStar = (commonjsGlobal && commonjsGlobal.__exportStar) || function(m, exports) {
+	    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+	};
+	Object.defineProperty(exports, "__esModule", { value: true });
+	// Deprecated shim to preserve v30 namespace names
+	__exportStar(events, exports); 
+} (OpenFin$1));
 
-function eventTargetAgnosticAddListener(emitter, name, listener, flags) {
-  if (typeof emitter.on === 'function') {
-    if (flags.once) {
-      emitter.once(name, listener);
-    } else {
-      emitter.on(name, listener);
-    }
-  } else if (typeof emitter.addEventListener === 'function') {
-    // EventTarget does not have `error` event semantics like Node
-    // EventEmitters, we do not listen for `error` events here.
-    emitter.addEventListener(name, function wrapListener(arg) {
-      // IE does not have builtin `{ once: true }` support so we
-      // have to do it manually.
-      if (flags.once) {
-        emitter.removeEventListener(name, wrapListener);
-      }
-      listener(arg);
-    });
-  } else {
-    throw new TypeError('The "emitter" argument must be of type EventEmitter. Received type ' + typeof emitter);
-  }
-}
+var fin = {};
 
 var system = {};
 
@@ -561,6 +326,13 @@ class Base {
     get fin() {
         return this.wire.getFin();
     }
+    /**
+     * Provides access to the OpenFin representation of the current code context (usually a document
+     * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
+     *
+     * Useful for debugging in the devtools console, where this will intelligently type itself based
+     * on the context in which the devtools panel was opened.
+     */
     get me() {
         return this.wire.me;
     }
@@ -595,6 +367,9 @@ class EmitterBase extends Base {
         this.topic = topic;
         _EmitterBase_emitterAccessor.set(this, void 0);
         this.eventNames = () => (this.hasEmitter() ? this.getOrCreateEmitter().eventNames() : []);
+        /**
+         * @internal
+         */
         this.emit = (eventType, payload, ...args) => {
             return this.hasEmitter() ? this.getOrCreateEmitter().emit(eventType, payload, ...args) : false;
         };
@@ -637,16 +412,13 @@ class EmitterBase extends Base {
             // This will only be reached if unsubscribe from event that does not exist but do not want to error here
             return Promise.resolve();
         };
-        this.addListener = this.on;
         __classPrivateFieldSet$d(this, _EmitterBase_emitterAccessor, [topic, ...additionalAccessors], "f");
         this.listeners = (event) => this.hasEmitter() ? this.getOrCreateEmitter().listeners(event) : [];
     }
     /**
      * Adds a listener to the end of the listeners array for the specified event.
      *
-     * @param eventType
-     * @param listener
-     * @param options
+     * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
      */
     async on(eventType, listener, options) {
         await this.registerEventListener(eventType, options, (emitter) => {
@@ -656,12 +428,16 @@ class EmitterBase extends Base {
         });
         return this;
     }
+    /**
+     * Adds a listener to the end of the listeners array for the specified event.
+     */
+    async addListener(eventType, listener, options) {
+        return this.on(eventType, listener, options);
+    }
     /**
      * 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.
      *
-     * @param eventType
-     * @param listener
-     * @param options
+     * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
      */
     async once(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
@@ -677,9 +453,7 @@ class EmitterBase extends Base {
     /**
      * Adds a listener to the beginning of the listeners array for the specified event.
      *
-     * @param eventType
-     * @param listener
-     * @param options
+     * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
      */
     async prependListener(eventType, listener, options) {
         await this.registerEventListener(eventType, options, (emitter) => {
@@ -693,9 +467,7 @@ class EmitterBase extends Base {
      * 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. The listener is added to the beginning of the listeners array.
      *
-     * @param eventType
-     * @param listener
-     * @param options
+     * @remarks Event payloads are documented in the {@link OpenFin.Events} namespace.
      */
     async prependOnceListener(eventType, listener, options) {
         const deregister = () => this.deregisterEventListener(eventType);
@@ -712,10 +484,6 @@ class EmitterBase extends Base {
      * Remove a listener from the listener array for the specified event.
      *
      * @remarks Caution: Calling this method changes the array indices in the listener array behind the listener.
-     *
-     * @param eventType
-     * @param listener
-     * @param options
      */
     async removeListener(eventType, listener, options) {
         const emitter = await this.deregisterEventListener(eventType, options);
@@ -742,7 +510,6 @@ class EmitterBase extends Base {
     /**
      * Removes all listeners, or those of the specified event.
      *
-     * @param eventType
      */
     async removeAllListeners(eventType) {
         const removeByEvent = async (event) => {
@@ -804,7 +571,7 @@ class InternalError extends Error {
         const { message, name, stack, ...rest } = err;
         super(message);
         this.name = name || 'Error';
-        this.stack = stack !== null && stack !== void 0 ? stack : this.toString();
+        this.stack = stack ?? this.toString();
         Object.keys(rest).forEach(key => {
             this[key] = rest[key];
         });
@@ -813,7 +580,6 @@ class InternalError extends Error {
 // For documentation of the error methods being used see here: https://v8.dev/docs/stack-trace-api
 class RuntimeError extends Error {
     static getCallSite(callsToRemove = 0) {
-        var _a, _b;
         const length = Error.stackTraceLimit;
         const realCallsToRemove = callsToRemove + 1; // remove this call;
         Error.stackTraceLimit = length + realCallsToRemove;
@@ -822,7 +588,7 @@ class RuntimeError extends Error {
         // This will be called when we access the `stack` property
         Error.prepareStackTrace = (_, stack) => stack;
         // stack is optional in non chromium contexts
-        const stack = (_b = (_a = new Error().stack) === null || _a === void 0 ? void 0 : _a.slice(realCallsToRemove)) !== null && _b !== void 0 ? _b : [];
+        const stack = new Error().stack?.slice(realCallsToRemove) ?? [];
         Error.prepareStackTrace = _prepareStackTrace;
         Error.stackTraceLimit = length;
         return stack;
@@ -844,7 +610,7 @@ class RuntimeError extends Error {
         const { reason, error } = payload;
         super(reason);
         this.name = 'RuntimeError';
-        if (error === null || error === void 0 ? void 0 : error.stack) {
+        if (error?.stack) {
             this.cause = new InternalError(error);
         }
         if (callSites) {
@@ -883,6 +649,20 @@ var view = {};
 
 var Factory$6 = {};
 
+var warnings = {};
+
+Object.defineProperty(warnings, "__esModule", { value: true });
+warnings.handleDeprecatedWarnings = void 0;
+const handleDeprecatedWarnings = (options) => {
+    if (options.contentNavigation?.whitelist ||
+        options.contentNavigation?.blacklist ||
+        options.contentRedirect?.whitelist ||
+        options.contentRedirect?.blacklist) {
+        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'.`);
+    }
+};
+warnings.handleDeprecatedWarnings = handleDeprecatedWarnings;
+
 var hasRequiredFactory$3;
 
 function requireFactory$3 () {
@@ -893,6 +673,10 @@ function requireFactory$3 () {
 	const base_1 = base;
 	const validate_1 = validate;
 	const index_1 = requireView();
+	const warnings_1 = warnings;
+	/**
+	 * Static namespace for OpenFin API methods that interact with the {@link View} class, available under `fin.View`.
+	 */
 	class ViewModule extends base_1.Base {
 	    /**
 	     * Creates a new View.
@@ -927,6 +711,7 @@ function requireFactory$3 () {
 	        if (!options.name || typeof options.name !== 'string') {
 	            throw new Error('Please provide a name property as a string in order to create a View.');
 	        }
+	        (0, warnings_1.handleDeprecatedWarnings)(options);
 	        if (this.wire.environment.childViews) {
 	            await this.wire.environment.createChildContent({
 	                entityType: 'view',
@@ -1214,7 +999,7 @@ class ChannelsExposer {
         this.exposeFunction = async (target, config) => {
             const { key, options, meta } = config;
             const { id } = meta;
-            const action = `${id}.${(options === null || options === void 0 ? void 0 : options.action) || key}`;
+            const action = `${id}.${options?.action || key}`;
             await this.channelProviderOrClient.register(action, async ({ args }) => {
                 return target(...args);
             });
@@ -1245,7 +1030,7 @@ channelsExposer.ChannelsExposer = ChannelsExposer;
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	__exportStar(channelsConsumer, exports);
-	__exportStar(channelsExposer, exports);
+	__exportStar(channelsExposer, exports); 
 } (openfinChannels));
 
 (function (exports) {
@@ -1264,7 +1049,7 @@ channelsExposer.ChannelsExposer = ChannelsExposer;
 	    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
-	__exportStar(openfinChannels, exports);
+	__exportStar(openfinChannels, exports); 
 } (strategies));
 
 (function (exports) {
@@ -1286,7 +1071,7 @@ channelsExposer.ChannelsExposer = ChannelsExposer;
 	__exportStar(apiConsumer, exports);
 	__exportStar(apiExposer, exports);
 	__exportStar(strategies, exports);
-	__exportStar(decorators, exports);
+	__exportStar(decorators, exports); 
 } (apiExposer$1));
 
 var channelApiRelay = {};
@@ -1527,14 +1312,14 @@ _LayoutNode_client = new WeakMap();
 /**
  * @ignore
  * @internal
- * Encapsulates Api consumption of {@link LayoutEntitiesController} with a relayed dispatch
+ * Encapsulates Api consumption of {@link LayoutEntitiesClient} with a relayed dispatch
  * @param client
  * @param controllerId
  * @param identity
  * @returns a new instance of {@link LayoutEntitiesClient} with bound to the controllerId
  */
 LayoutNode.newLayoutEntitiesClient = async (client, controllerId, identity) => {
-    const dispatch = (0, channel_api_relay_1.createRelayedDispatch)(client, identity, 'layout-relay', 'You are trying to interact with a layout component on a window that has been destroyed.');
+    const dispatch = (0, channel_api_relay_1.createRelayedDispatch)(client, identity, 'layout-relay', 'You are trying to interact with a layout component on a window that does not exist or has been destroyed.');
     const consumer = new api_exposer_1.ApiConsumer(new api_exposer_1.ChannelsConsumer({ dispatch }));
     return consumer.consume({ id: controllerId });
 };
@@ -1844,8 +1629,9 @@ _ColumnOrRow_client = new WeakMap();
 var layout_constants = {};
 
 Object.defineProperty(layout_constants, "__esModule", { value: true });
-layout_constants.LAYOUT_CONTROLLER_ID = void 0;
+layout_constants.DEFAULT_LAYOUT_KEY = layout_constants.LAYOUT_CONTROLLER_ID = void 0;
 layout_constants.LAYOUT_CONTROLLER_ID = 'layout-entities';
+layout_constants.DEFAULT_LAYOUT_KEY = 'default';
 
 var main = {};
 
@@ -1853,6 +1639,10 @@ Object.defineProperty(main, "__esModule", { value: true });
 main.WebContents = void 0;
 const base_1$k = base;
 class WebContents extends base_1$k.EmitterBase {
+    /**
+     * @param identity The identity of the {@link OpenFin.WebContentsEvents WebContents}.
+     * @param entityType The type of the {@link OpenFin.WebContentsEvents WebContents}.
+     */
     constructor(wire, identity, entityType) {
         super(wire, entityType, identity.uuid, identity.name);
         this.identity = identity;
@@ -1905,6 +1695,11 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * console.log(await wnd.capturePage(options));
      * ```
+     *
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     capturePage(options) {
         return this.wire.sendAction('capture-page', { options, ...this.identity }).then(({ payload }) => payload.data);
@@ -1940,6 +1735,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * executeJavaScript(`console.log('Hello, Openfin')`).then(() => console.log('Javascript excuted')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     executeJavaScript(code) {
         return this.wire
@@ -1979,6 +1778,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * getZoomLevel().then(zoomLevel => console.log(zoomLevel)).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     getZoomLevel() {
         return this.wire.sendAction('get-zoom-level', this.identity).then(({ payload }) => payload.data);
@@ -2017,6 +1820,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * setZoomLevel(4).then(() => console.log('Setting a  zoom level')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     setZoomLevel(level) {
         return this.wire.sendAction('set-zoom-level', { ...this.identity, level }).then(() => undefined);
@@ -2024,7 +1831,7 @@ class WebContents extends base_1$k.EmitterBase {
     /**
      * Navigates the WebContents to a specified URL.
      *
-     * @remarks The url must contain the protocol prefix such as http:// or https://.
+     * Note: The url must contain the protocol prefix such as http:// or https://.
      * @param url - The URL to navigate the WebContents to.
      *
      * @example
@@ -2054,6 +1861,10 @@ class WebContents extends base_1$k.EmitterBase {
      * navigate().then(() => console.log('Navigate to tutorial')).catch(err => console.log(err));
      * ```
      * @experimental
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     navigate(url) {
         return this.wire.sendAction('navigate-window', { ...this.identity, url }).then(() => undefined);
@@ -2081,6 +1892,10 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * navigateBack().then(() => console.log('Navigated back')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     navigateBack() {
         return this.wire.sendAction('navigate-window-back', { ...this.identity }).then(() => undefined);
@@ -2110,6 +1925,10 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * navigateForward().then(() => console.log('Navigated forward')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async navigateForward() {
         await this.wire.sendAction('navigate-window-forward', { ...this.identity });
@@ -2137,6 +1956,10 @@ class WebContents extends base_1$k.EmitterBase {
      * }
      * stopNavigation().then(() => console.log('you shall not navigate')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     stopNavigation() {
         return this.wire.sendAction('stop-window-navigation', { ...this.identity }).then(() => undefined);
@@ -2174,6 +1997,10 @@ class WebContents extends base_1$k.EmitterBase {
      * 		console.log('Reloaded window')
      * }).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     reload(ignoreCache = false) {
         return this.wire
@@ -2187,7 +2014,7 @@ class WebContents extends base_1$k.EmitterBase {
      * Prints the WebContents.
      * @param options Printer Options
      *
-     * @remarks When `silent` is set to `true`, the API will pick the system's default printer if deviceName
+     * Note: When `silent` is set to `true`, the API will pick the system's default printer if deviceName
      * is empty and the default settings for printing.
      *
      * Use the CSS style `page-break-before: always;` to force print to a new page.
@@ -2200,6 +2027,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     console.log('print call has been sent to the system');
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     print(options = {}) {
         return this.wire.sendAction('print', { ...this.identity, options }).then(() => undefined);
@@ -2209,7 +2040,7 @@ class WebContents extends base_1$k.EmitterBase {
      * @param searchTerm Term to find in page
      * @param options Search options
      *
-     * @remarks By default, each subsequent call will highlight the next text that matches the search term.
+     * Note: By default, each subsequent call will highlight the next text that matches the search term.
      *
      * Returns a promise with the results for the request. By subscribing to the
      * found-in-page event, you can get the results of this call as well.
@@ -2244,6 +2075,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     console.log(result)
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     findInPage(searchTerm, options) {
         return this.wire
@@ -2287,6 +2122,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     console.log(results);
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     stopFindInPage(action) {
         return this.wire.sendAction('stop-find-in-page', { ...this.identity, action }).then(() => undefined);
@@ -2329,6 +2168,10 @@ class WebContents extends base_1$k.EmitterBase {
      *         console.log(err);
      *     });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     getPrinters() {
         return this.wire.sendAction('get-printers', { ...this.identity }).then(({ payload }) => payload.data);
@@ -2351,6 +2194,10 @@ class WebContents extends base_1$k.EmitterBase {
      *
      * focusWindow().then(() => console.log('Window focused')).catch(err => console.log(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async focus({ emitSynthFocused } = { emitSynthFocused: true }) {
         await this.wire.sendAction('focus-window', { emitSynthFocused, ...this.identity });
@@ -2382,6 +2229,10 @@ class WebContents extends base_1$k.EmitterBase {
      * .then(() => console.log('Showing dev tools'))
      * .catch(err => console.error(err));
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async showDeveloperTools() {
         // Note this hits the system action map in core state for legacy reasons.
@@ -2390,7 +2241,7 @@ class WebContents extends base_1$k.EmitterBase {
     /**
      * Retrieves the process information associated with a WebContents.
      *
-     * @remarks This includes any iframes associated with the WebContents
+     * Note: This includes any iframes associated with the WebContents
      *
      * @example
      * View:
@@ -2404,6 +2255,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.getCurrent();
      *     const processInfo = await win.getProcessInfo();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async getProcessInfo() {
         const { payload: { data } } = await this.wire.sendAction('get-process-info', this.identity);
@@ -2439,6 +2294,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.create(winOption);
      *     const sharedWorkers = await win.getSharedWorkers();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async getSharedWorkers() {
         return this.wire.sendAction('get-shared-workers', this.identity).then(({ payload }) => payload.data);
@@ -2473,6 +2332,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.create(winOption);
      *     await win.inspectSharedWorker();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async inspectSharedWorker() {
         await this.wire.sendAction('inspect-shared-worker', { ...this.identity });
@@ -2510,6 +2373,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const sharedWorkers = await win.getSharedWorkers();
      *     await win.inspectSharedWorkerById(sharedWorkers[0].id);
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async inspectSharedWorkerById(workerId) {
         await this.wire.sendAction('inspect-shared-worker-by-id', { ...this.identity, workerId });
@@ -2544,6 +2411,10 @@ class WebContents extends base_1$k.EmitterBase {
      *     const win = await fin.Window.create(winOption);
      *     await win.inspectServiceWorker();
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async inspectServiceWorker() {
         await this.wire.sendAction('inspect-service-worker', { ...this.identity });
@@ -2551,7 +2422,7 @@ class WebContents extends base_1$k.EmitterBase {
     /**
      * Shows a popup window.
      *
-     * @remarks If this WebContents is a view and its attached window has a popup open, this will close it.
+     * Note: If this WebContents is a view and its attached window has a popup open, this will close it.
      *
      * Shows a popup window. Including a `name` in `options` will attempt to show an existing window as a popup, if
      * that window doesn't exist or no `name` is included a window will be created. If the caller view or the caller
@@ -2559,7 +2430,7 @@ class WebContents extends base_1$k.EmitterBase {
      * open popup window before showing the new popup window. Also, if the caller view is destroyed or detached, the popup
      * will be dismissed.
      *
-     * 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.
+     * 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.
      *
      * @example
      *
@@ -2754,12 +2625,16 @@ class WebContents extends base_1$k.EmitterBase {
      *     onPopupReady: popupWindowCallback;
      * });
      * ```
+     * @remarks
+     * `WebContents` refers to shared functionality between {@link OpenFin.Window} and {@link OpenFin.View}.
+     * We do not expose an explicit superclass for this functionality, but it does have its own
+     * {@link OpenFin.WebContentsEvents event namespace}.
      */
     async showPopupWindow(options) {
         this.wire.sendAction(`${this.entityType}-show-popup-window`, this.identity).catch(() => {
             // we do not want to expose this error, just continue if this analytics-only call fails
         });
-        if (options === null || options === void 0 ? void 0 : options.onPopupReady) {
+        if (options?.onPopupReady) {
             const readyListener = async ({ popupName }) => {
                 try {
                     const popupWindow = this.fin.Window.wrapSync({ uuid: this.fin.me.uuid, name: popupName });
@@ -2778,8 +2653,8 @@ class WebContents extends base_1$k.EmitterBase {
                 ...options,
                 // Internal use only.
                 // @ts-expect-error
-                hasResultCallback: !!(options === null || options === void 0 ? void 0 : options.onPopupResult),
-                hasReadyCallback: !!(options === null || options === void 0 ? void 0 : options.onPopupReady)
+                hasResultCallback: !!options?.onPopupResult,
+                hasReadyCallback: !!options?.onPopupReady
             },
             ...this.identity
         });
@@ -2804,7 +2679,7 @@ class WebContents extends base_1$k.EmitterBase {
             }
             return popupResult;
         };
-        if (options === null || options === void 0 ? void 0 : options.onPopupResult) {
+        if (options?.onPopupResult) {
             const dispatchResultListener = async (payload) => {
                 await options.onPopupResult(normalizePopupResult(payload));
             };
@@ -3130,6 +3005,49 @@ function requireInstance$2 () {
 	        this.show = async () => {
 	            await this.wire.sendAction('show-view', { ...this.identity });
 	        };
+	        /**
+	         * Sets the bounds (top, left, width, height) of the view relative to its window and shows it if it is hidden.
+	         * This method ensures the view is both positioned and showing. It will reposition a visible view and both show and reposition a hidden view.
+	         *
+	         * @remarks View position is relative to the bounds of the window.
+	         * ({top: 0, left: 0} represents the top left corner of the window)
+	         *
+	         * @example
+	         * ```js
+	         * let view;
+	         * async function createView() {
+	         *     const me = await fin.Window.getCurrent();
+	         *     return fin.View.create({
+	         *         name: 'viewNameSetBounds',
+	         *         target: me.identity,
+	         *         bounds: {top: 10, left: 10, width: 200, height: 200}
+	         *     });
+	         * }
+	         *
+	         * async function showViewAt() {
+	         *     view = await createView();
+	         *     console.log('View created.');
+	         *
+	         *     await view.navigate('https://google.com');
+	         *     console.log('View navigated to given url.');
+	         *
+	         *     await view.showAt({
+	         *         top: 100,
+	         *         left: 100,
+	         *         width: 300,
+	         *         height: 300
+	         *     });
+	         * }
+	         *
+	         * showViewAt()
+	         *     .then(() => console.log('View set to new bounds and shown.'))
+	         *     .catch(err => console.log(err));
+	         * ```
+	         * @experimental
+	         */
+	        this.showAt = async (bounds) => {
+	            await this.wire.sendAction('show-view-at', { bounds, ...this.identity });
+	        };
 	        /**
 	         * Hides the current view if it is currently visible.
 	         *
@@ -3289,8 +3207,24 @@ function requireInstance$2 () {
 	            this.wire.sendAction('view-get-parent-layout', { ...this.identity }).catch(() => {
 	                // don't expose
 	            });
-	            const currentWindow = await this.getCurrentWindow();
-	            return currentWindow.getLayout();
+	            const layoutWindow = await this.getCurrentWindow();
+	            try {
+	                const providerChannelClient = await __classPrivateFieldGet(this, _View_providerChannelClient, "f").getValue();
+	                const client = await layout_entities_1.LayoutNode.newLayoutEntitiesClient(providerChannelClient, layout_constants_1.LAYOUT_CONTROLLER_ID, layoutWindow.identity);
+	                const layoutIdentity = await client.getLayoutIdentityForViewOrThrow(this.identity);
+	                return this.fin.Platform.Layout.wrap(layoutIdentity);
+	            }
+	            catch (e) {
+	                const allowedErrors = [
+	                    'No action registered at target for',
+	                    'getLayoutIdentityForViewOrThrow is not a function'
+	                ];
+	                if (!allowedErrors.some((m) => e.message.includes(m))) {
+	                    throw e;
+	                }
+	                // fallback logic for missing endpoint
+	                return this.fin.Platform.Layout.wrap(layoutWindow.identity);
+	            }
 	        };
 	        /**
 	         * Gets the View's options.
@@ -3524,9 +3458,9 @@ function requireView () {
 		};
 		Object.defineProperty(exports, "__esModule", { value: true });
 		/**
-		 * Entry points for the OpenFin `View` API.
+		 * Entry points for the OpenFin `View` API (`fin.View`).
 		 *
-		 * * {@link ViewModule} contains static methods relating to the `View` type, accessible through `fin.View`.
+		 * * {@link ViewModule} contains static members of the `View` API, accessible through `fin.View`.
 		 * * {@link View} describes an instance of an OpenFin View, e.g. as returned by `fin.View.getCurrent`.
 		 *
 		 * 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),
@@ -3535,8 +3469,8 @@ function requireView () {
 		 * @packageDocumentation
 		 */
 		__exportStar(requireFactory$3(), exports);
-		__exportStar(requireInstance$2(), exports);
-} (view));
+		__exportStar(requireInstance$2(), exports); 
+	} (view));
 	return view;
 }
 
@@ -4023,6 +3957,7 @@ function requireInstance$1 () {
 	    /**
 	     * Sets or removes a custom JumpList for the application. Only applicable in Windows OS.
 	     * If categories is null the previously set custom JumpList (if any) will be replaced by the standard JumpList for the app (managed by Windows).
+	     *
 	     * Note: If the "name" property is omitted it defaults to "tasks".
 	     * @param jumpListCategories An array of JumpList Categories to populate. If null, remove any existing JumpList configuration and set to Windows default.
 	     *
@@ -4323,6 +4258,7 @@ function requireInstance$1 () {
 	    }
 	    /**
 	     * Sets file auto download location. It's only allowed in the same application.
+	     *
 	     * Note: This method is restricted by default and must be enabled via
 	     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
 	     * @param downloadLocation file auto download location
@@ -4348,6 +4284,7 @@ function requireInstance$1 () {
 	    }
 	    /**
 	     * 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.
+	     *
 	     * Note: This method is restricted by default and must be enabled via
 	     * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
 	     *
@@ -4378,6 +4315,9 @@ function requireFactory$2 () {
 	const base_1 = base;
 	const validate_1 = validate;
 	const Instance_1 = requireInstance$1();
+	/**
+	 * Static namespace for OpenFin API methods that interact with the {@link Application} class, available under `fin.Application`.
+	 */
 	class ApplicationModule extends base_1.Base {
 	    /**
 	     * Asynchronously returns an Application object that represents an existing application.
@@ -4659,9 +4599,9 @@ function requireApplication () {
 		};
 		Object.defineProperty(exports, "__esModule", { value: true });
 		/**
-		 * Entry points for the OpenFin `Application` API.
+		 * Entry points for the OpenFin `Application` API (`fin.Application`).
 		 *
-		 * * {@link ApplicationModule} contains static methods relating to the `Application` type, accessible through `fin.Application`.
+		 * * {@link ApplicationModule} contains static members of the `Application` API, accessible through `fin.Application`.
 		 * * {@link Application} describes an instance of an OpenFin Application, e.g. as returned by `fin.Application.getCurrent`.
 		 *
 		 * 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),
@@ -4670,8 +4610,8 @@ function requireApplication () {
 		 * @packageDocumentation
 		 */
 		__exportStar(requireFactory$2(), exports);
-		__exportStar(requireInstance$1(), exports);
-} (application));
+		__exportStar(requireInstance$1(), exports); 
+	} (application));
 	return application;
 }
 
@@ -4689,6 +4629,7 @@ function requireInstance () {
 	const application_1 = requireApplication();
 	const main_1 = main;
 	const view_1 = requireView();
+	const warnings_1 = warnings;
 	/**
 	 * @PORTED
 	 * @typedef { object } Margins
@@ -5173,7 +5114,6 @@ function requireInstance () {
 	     */
 	    constructor(wire, identity) {
 	        super(wire, identity, 'window');
-	        this.identity = identity;
 	    }
 	    /**
 	     * Adds a listener to the end of the listeners array for the specified event.
@@ -5299,6 +5239,7 @@ function requireInstance () {
 	            if (options.autoShow === undefined) {
 	                options.autoShow = true;
 	            }
+	            (0, warnings_1.handleDeprecatedWarnings)(options);
 	            const windowCreation = this.wire.environment.createChildContent({ entityType: 'window', options });
 	            Promise.all([pageResponse, windowCreation])
 	                .then((resolvedArr) => {
@@ -5715,15 +5656,15 @@ function requireInstance () {
 	     * ```
 	     * @experimental
 	     */
-	    async getLayout() {
+	    async getLayout(layoutIdentity) {
 	        this.wire.sendAction('window-get-layout', this.identity).catch((e) => {
 	            // don't expose
 	        });
 	        const opts = await this.getOptions();
-	        if (!opts.layout) {
+	        if (!opts.layout || !opts.layoutSnapshot) {
 	            throw new Error('Window does not have a Layout');
 	        }
-	        return this.fin.Platform.Layout.wrap(this.identity);
+	        return this.fin.Platform.Layout.wrap(layoutIdentity ?? this.identity);
 	    }
 	    /**
 	     * Gets the current settings of the window.
@@ -6004,11 +5945,12 @@ function requireInstance () {
 	     * moveBy(580, 300).then(() => console.log('Moved')).catch(err => console.log(err));
 	     * ```
 	     */
-	    moveBy(deltaLeft, deltaTop) {
+	    moveBy(deltaLeft, deltaTop, positioningOptions) {
 	        return this.wire
 	            .sendAction('move-window-by', {
 	            deltaLeft,
 	            deltaTop,
+	            positioningOptions,
 	            ...this.identity
 	        })
 	            .then(() => undefined);
@@ -6038,11 +5980,12 @@ function requireInstance () {
 	     * moveTo(580, 300).then(() => console.log('Moved')).catch(err => console.log(err))
 	     * ```
 	     */
-	    moveTo(left, top) {
+	    moveTo(left, top, positioningOptions) {
 	        return this.wire
 	            .sendAction('move-window', {
 	            left,
 	            top,
+	            positioningOptions,
 	            ...this.identity
 	        })
 	            .then(() => undefined);
@@ -6075,12 +6018,13 @@ function requireInstance () {
 	     * resizeBy(580, 300, 'top-right').then(() => console.log('Resized')).catch(err => console.log(err));
 	     * ```
 	     */
-	    resizeBy(deltaWidth, deltaHeight, anchor) {
+	    resizeBy(deltaWidth, deltaHeight, anchor, positioningOptions) {
 	        return this.wire
 	            .sendAction('resize-window-by', {
 	            deltaWidth: Math.floor(deltaWidth),
 	            deltaHeight: Math.floor(deltaHeight),
 	            anchor,
+	            positioningOptions,
 	            ...this.identity
 	        })
 	            .then(() => undefined);
@@ -6113,12 +6057,13 @@ function requireInstance () {
 	     * resizeTo(580, 300, 'top-left').then(() => console.log('Resized')).catch(err => console.log(err));
 	     * ```
 	     */
-	    resizeTo(width, height, anchor) {
+	    resizeTo(width, height, anchor, positioningOptions) {
 	        return this.wire
 	            .sendAction('resize-window', {
 	            width: Math.floor(width),
 	            height: Math.floor(height),
 	            anchor,
+	            positioningOptions,
 	            ...this.identity
 	        })
 	            .then(() => undefined);
@@ -6177,7 +6122,6 @@ function requireInstance () {
 	    }
 	    /**
 	     * Sets the window's size and position.
-	     * @property { Bounds } bounds This is a * @type {string} name - name of the window.object that holds the propertys of
 	     *
 	     * @example
 	     * ```js
@@ -6204,8 +6148,10 @@ function requireInstance () {
 	     * }).then(() => console.log('Bounds set to window')).catch(err => console.log(err));
 	     * ```
 	     */
-	    setBounds(bounds) {
-	        return this.wire.sendAction('set-window-bounds', { ...bounds, ...this.identity }).then(() => undefined);
+	    setBounds(bounds, positioningOptions) {
+	        return this.wire
+	            .sendAction('set-window-bounds', { ...bounds, ...this.identity, positioningOptions })
+	            .then(() => undefined);
 	    }
 	    /**
 	     * Shows the window if it is hidden.
@@ -6347,7 +6293,10 @@ function requireInstance () {
 	     * Calling this method will close previously opened menus.
 	     * @experimental
 	     * @param options
-	     *
+	     * @typeParam Data User-defined shape for data returned upon menu item click.  Should be a
+	     * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
+	     * of all possible data shapes for the entire menu, and the click handler should process
+	     * these with a "reducer" pattern.
 	     * @example
 	     * This could be used to show a drop down menu over views in a platform window:
 	     * ```js
@@ -6437,6 +6386,7 @@ function requireInstance () {
 	        return this.wire.sendAction('close-popup-menu', { ...this.identity }).then(() => undefined);
 	    }
 	    /**
+	     * @PORTED
 	     * @typedef {object} PopupOptions
 	     * @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.
 	     * @property {string} [url] - Navigates to this `url` if showing an existing window as a popup, otherwise the newly created window will load this `url`.
@@ -6454,6 +6404,7 @@ function requireInstance () {
 	     * @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.
 	     */
 	    /**
+	     * @PORTED
 	     * @typedef {object} PopupResult
 	     * @property {Identity} identity - `name` and `uuid` of the popup window that called dispatched this result.
 	     * @property {'clicked' | 'dismissed'} result - Result of the user interaction with the popup window.
@@ -6547,6 +6498,9 @@ function requireFactory$1 () {
 	const base_1 = base;
 	const validate_1 = validate;
 	const Instance_1 = requireInstance();
+	/**
+	 * Static namespace for OpenFin API methods that interact with the {@link _Window} class, available under `fin.Window`.
+	 */
 	class _WindowModule extends base_1.Base {
 	    /**
 	     * Asynchronously returns a Window object that represents an existing window.
@@ -6702,9 +6656,9 @@ function requireWindow () {
 		};
 		Object.defineProperty(exports, "__esModule", { value: true });
 		/**
-		 * Entry points for the OpenFin `Window` API.
+		 * Entry points for the OpenFin `Window` API (`fin.Window`).
 		 *
-		 * * {@link _WindowModule} contains static methods relating to the `Window` type, accessible through `fin.Window`.
+		 * * {@link _WindowModule} contains static members of the `Window` API, accessible through `fin.Window`.
 		 * * {@link _Window} describes an instance of an OpenFin Window, e.g. as returned by `fin.Window.getCurrent`.
 		 *
 		 * 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),
@@ -6715,17 +6669,24 @@ function requireWindow () {
 		 * @packageDocumentation
 		 */
 		__exportStar(requireFactory$1(), exports);
-		__exportStar(requireInstance(), exports);
-} (window$1));
+		__exportStar(requireInstance(), exports); 
+	} (window$1));
 	return window$1;
 }
 
+/**
+ * Entry point for the OpenFin `System` API (`fin.System`).
+ *
+ * * {@link System} contains static members of the `System` API (available under `fin.System`)
+ *
+ * @packageDocumentation
+ */
 Object.defineProperty(system, "__esModule", { value: true });
 system.System = void 0;
 const base_1$j = base;
 const transport_errors_1$1 = transportErrors;
 const window_1 = requireWindow();
-const events_1$6 = eventsExports;
+const events_1$6 = require$$0;
 /**
  * An object representing the core of OpenFin Runtime. Allows the developer
  * to perform system-level actions, such as accessing logs, viewing processes,
@@ -7695,6 +7656,59 @@ class System extends base_1$j.EmitterBase {
     openUrlWithBrowser(url) {
         return this.wire.sendAction('open-url-with-browser', { url }).then(() => undefined);
     }
+    /**
+     * Creates a new registry entry under the HKCU root Windows registry key if the given custom protocol name doesn't exist or
+     * overwrites the existing registry entry if the given custom protocol name already exists.
+     *
+     * Note: This method is restricted by default and must be enabled via
+     * {@link https://developers.openfin.co/docs/api-security API security settings}. It requires RVM 12 or higher version.
+     *
+     *
+     * @remarks These protocols are reserved and cannot be registered:
+     * - fin
+     * - fins
+     * - openfin
+     * - URI Schemes registered with {@link https://en.wikipedia.org/wiki/List_of_URI_schemes#Official_IANA-registered_schemes IANA}
+     *
+     * @throws if a given custom protocol failed to be registered.
+     * @throws if a manifest URL contains the '%1' string.
+     * @throws if a manifest URL contains a query string parameter which name equals to the Protocol Launch Request Parameter Name.
+     * @throws if the full length of the command string that is to be written to the registry exceeds 2048 bytes.
+     *
+     * @example
+     * ```js
+     * fin.System.registerCustomProtocol({protocolName:'protocol1'}).then(console.log).catch(console.error);
+     * ```
+     */
+    async registerCustomProtocol(options) {
+        if (typeof options !== 'object') {
+            throw new Error('Must provide an object with a `protocolName` property having a string value.');
+        }
+        await this.wire.sendAction('register-custom-protocol', options);
+    }
+    /**
+     * Removes the registry entry for a given custom protocol.
+     *
+     * Note: This method is restricted by default and must be enabled via
+     * {@link https://developers.openfin.co/docs/api-security API security settings}. It requires RVM 12 or higher version.
+     *
+     *
+     * @remarks These protocols are reserved and cannot be unregistered:
+     * - fin
+     * - fins
+     * - openfin
+     * - URI Schemes registered with {@link https://en.wikipedia.org/wiki/List_of_URI_schemes#Official_IANA-registered_schemes IANA}
+     *
+     * @throws if a protocol entry failed to be removed in registry.
+     *
+     * @example
+     * ```js
+     * await fin.System.unregisterCustomProtocol('protocol1');
+     * ```
+     */
+    async unregisterCustomProtocol(protocolName) {
+        await this.wire.sendAction('unregister-custom-protocol', { protocolName });
+    }
     /**
      * Removes the process entry for the passed UUID obtained from a prior call
      * of fin.System.launchExternalProcess().
@@ -7727,7 +7741,8 @@ class System extends base_1$j.EmitterBase {
     }
     /**
      * Attempt to close an external process. The process will be terminated if it
-     * has not closed after the elapsed timeout in milliseconds.<br>
+     * has not closed after the elapsed timeout in milliseconds.
+     *
      * Note: This method is restricted by default and must be enabled via
      * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
      * @param options A object defined in the TerminateExternalRequestType interface
@@ -7763,7 +7778,8 @@ class System extends base_1$j.EmitterBase {
         return this.wire.sendAction('update-proxy', options).then(() => undefined);
     }
     /**
-     * Downloads the given application asset<br>
+     * Downloads the given application asset.
+     *
      * Note: This method is restricted by default and must be enabled via
      * <a href="https://developers.openfin.co/docs/api-security">API security settings</a>.
      * @param appAsset App asset object
@@ -8657,7 +8673,7 @@ class ChannelBase {
         try {
             const mainAction = this.subscriptions.has(topic)
                 ? this.subscriptions.get(topic)
-                : (currentPayload, id) => { var _a; return ((_a = this.defaultAction) !== null && _a !== void 0 ? _a : ChannelBase.defaultAction)(topic, currentPayload, id); };
+                : (currentPayload, id) => (this.defaultAction ?? ChannelBase.defaultAction)(topic, currentPayload, id);
             const preActionProcessed = this.preAction ? await this.preAction(topic, payload, senderIdentity) : payload;
             const actionProcessed = await mainAction(preActionProcessed, senderIdentity);
             return this.postAction ? await this.postAction(topic, actionProcessed, senderIdentity) : actionProcessed;
@@ -8986,17 +9002,17 @@ const channelClientsByEndpointId = new Map();
  * provider via {@link ChannelClient#dispatch dispatch} and to listen for communication
  * from the provider by registering an action via {@link ChannelClient#register register}.
  *
- * Synchronous Methods:
+ * ### Synchronous Methods:
  *  * {@link ChannelClient#onDisconnection onDisconnection(listener)}
  *  * {@link ChannelClient#register register(action, listener)}
  *  * {@link ChannelClient#remove remove(action)}
  *
- * Asynchronous Methods:
+ * ### Asynchronous Methods:
  *  * {@link ChannelClient#disconnect disconnect()}
  *  * {@link ChannelClient#dispatch dispatch(action, payload)}
  *
- * Middleware:
- * <br>Middleware functions receive the following arguments: (action, payload, senderId).
+ * ### Middleware:
+ * Middleware functions receive the following arguments: (action, payload, senderId).
  * The return value of the middleware function will be passed on as the payload from beforeAction, to the action listener, to afterAction
  * unless it is undefined, in which case the original payload is used.  Middleware can be used for side effects.
  *  * {@link ChannelClient#setDefaultAction setDefaultAction(middleware)}
@@ -9190,7 +9206,6 @@ class ClassicStrategy {
         // connection problems occur
         _ClassicStrategy_pendingMessagesByEndpointId.set(this, new Map);
         this.send = async (endpointId, action, payload) => {
-            var _a;
             const to = __classPrivateFieldGet$c(this, _ClassicStrategy_endpointIdentityMap, "f").get(endpointId);
             if (!to) {
                 throw new Error(`Could not locate routing info for endpoint ${endpointId}`);
@@ -9210,13 +9225,12 @@ class ClassicStrategy {
                 action,
                 payload
             });
-            (_a = __classPrivateFieldGet$c(this, _ClassicStrategy_pendingMessagesByEndpointId, "f").get(endpointId)) === null || _a === void 0 ? void 0 : _a.add(p);
+            __classPrivateFieldGet$c(this, _ClassicStrategy_pendingMessagesByEndpointId, "f").get(endpointId)?.add(p);
             const raw = await p.catch((error) => {
                 throw new Error(error.message);
             }).finally(() => {
-                var _a;
                 // clean up the pending promise
-                (_a = __classPrivateFieldGet$c(this, _ClassicStrategy_pendingMessagesByEndpointId, "f").get(endpointId)) === null || _a === void 0 ? void 0 : _a.delete(p);
+                __classPrivateFieldGet$c(this, _ClassicStrategy_pendingMessagesByEndpointId, "f").get(endpointId)?.delete(p);
             });
             return raw.payload.data.result;
         };
@@ -9237,8 +9251,8 @@ class ClassicStrategy {
         const id = __classPrivateFieldGet$c(this, _ClassicStrategy_endpointIdentityMap, "f").get(endpointId);
         __classPrivateFieldGet$c(this, _ClassicStrategy_endpointIdentityMap, "f").delete(endpointId);
         const pendingSet = __classPrivateFieldGet$c(this, _ClassicStrategy_pendingMessagesByEndpointId, "f").get(endpointId);
-        pendingSet === null || pendingSet === void 0 ? void 0 : pendingSet.forEach((p) => {
-            const errorMsg = `Channel connection with identity uuid: ${id === null || id === void 0 ? void 0 : id.uuid} / name: ${id === null || id === void 0 ? void 0 : id.name} / endpointId: ${endpointId} no longer connected.`;
+        pendingSet?.forEach((p) => {
+            const errorMsg = `Channel connection with identity uuid: ${id?.uuid} / name: ${id?.name} / endpointId: ${endpointId} no longer connected.`;
             p.cancel(new Error(errorMsg));
         });
     }
@@ -9250,9 +9264,8 @@ class ClassicStrategy {
         __classPrivateFieldGet$c(this, _ClassicStrategy_pendingMessagesByEndpointId, "f").set(endpointId, new Set());
     }
     isValidEndpointPayload(payload) {
-        var _a, _b;
-        return (typeof ((_a = payload === null || payload === void 0 ? void 0 : payload.endpointIdentity) === null || _a === void 0 ? void 0 : _a.endpointId) === 'string' ||
-            typeof ((_b = payload === null || payload === void 0 ? void 0 : payload.endpointIdentity) === null || _b === void 0 ? void 0 : _b.channelId) === 'string');
+        return (typeof payload?.endpointIdentity?.endpointId === 'string' ||
+            typeof payload?.endpointIdentity?.channelId === 'string');
     }
 }
 strategy$2.ClassicStrategy = ClassicStrategy;
@@ -9329,13 +9342,12 @@ class RTCEndpoint {
             this.rtc.rtcClient.close();
         };
         this.rtc.channels.response.addEventListener('message', (e) => {
-            var _a;
             let { data } = e;
             if (e.data instanceof ArrayBuffer) {
                 data = new TextDecoder().decode(e.data);
             }
             const { messageId, payload, success, error } = JSON.parse(data);
-            const { resolve, reject } = (_a = this.responseMap.get(messageId)) !== null && _a !== void 0 ? _a : {};
+            const { resolve, reject } = this.responseMap.get(messageId) ?? {};
             if (resolve && reject) {
                 this.responseMap.delete(messageId);
                 if (success) {
@@ -9584,9 +9596,8 @@ class RTCICEManager extends base_1$i.EmitterBase {
         const rtcConnectionId = Math.random().toString();
         const rtcClient = this.createRtcPeer();
         rtcClient.addEventListener('icecandidate', async (e) => {
-            var _a;
             if (e.candidate) {
-                await this.raiseClientIce(rtcConnectionId, { candidate: (_a = e.candidate) === null || _a === void 0 ? void 0 : _a.toJSON() });
+                await this.raiseClientIce(rtcConnectionId, { candidate: e.candidate?.toJSON() });
             }
         });
         await this.listenForProviderIce(rtcConnectionId, async (payload) => {
@@ -9611,9 +9622,8 @@ class RTCICEManager extends base_1$i.EmitterBase {
         const requestChannelPromise = RTCICEManager.createDataChannelPromise('request', rtcClient);
         const responseChannelPromise = RTCICEManager.createDataChannelPromise('response', rtcClient);
         rtcClient.addEventListener('icecandidate', async (e) => {
-            var _a;
             if (e.candidate) {
-                await this.raiseProviderIce(rtcConnectionId, { candidate: (_a = e.candidate) === null || _a === void 0 ? void 0 : _a.toJSON() });
+                await this.raiseProviderIce(rtcConnectionId, { candidate: e.candidate?.toJSON() });
             }
         });
         await this.listenForClientIce(rtcConnectionId, async (payload) => {
@@ -9686,20 +9696,20 @@ const runtimeVersioning_1 = runtimeVersioning;
  * a single client via {@link ChannelProvider#dispatch dispatch} or all clients via {@link ChannelProvider#publish publish}
  * and to listen for communication from clients by registering an action via {@link ChannelProvider#register register}.
  *
- * Synchronous Methods:
+ * ### Synchronous Methods:
  *  * {@link ChannelProvider#onConnection onConnection(listener)}
  *  * {@link ChannelProvider#onDisconnection onDisconnection(listener)}
  *  * {@link ChannelProvider#publish publish(action, payload)}
  *  * {@link ChannelProvider#register register(action, listener)}
  *  * {@link ChannelProvider#remove remove(action)}
  *
- * Asynchronous Methods:
+ * ### Asynchronous Methods:
  *  * {@link ChannelProvider#destroy destroy()}
  *  * {@link ChannelProvider#dispatch dispatch(to, action, payload)}
  *  * {@link ChannelProvider#getAllClientInfo getAllClientInfo()}
  *
- * Middleware:
- * <br>Middleware functions receive the following arguments: (action, payload, senderId).
+ * ### Middleware:
+ * Middleware functions receive the following arguments: (action, payload, senderId).
  * The return value of the middleware function will be passed on as the payload from beforeAction, to the action listener, to afterAction
  * unless it is undefined, in which case the most recently defined payload is used.  Middleware can be used for side effects.
  *  * {@link ChannelProvider#setDefaultAction setDefaultAction(middleware)}
@@ -9795,8 +9805,7 @@ class ChannelProvider extends channel_1.ChannelBase {
      * ```
      */
     dispatch(to, action, payload) {
-        var _a;
-        const endpointId = (_a = to.endpointId) !== null && _a !== void 0 ? _a : this.getEndpointIdForOpenFinId(to, action);
+        const endpointId = to.endpointId ?? this.getEndpointIdForOpenFinId(to, action);
         if (endpointId && __classPrivateFieldGet$9(this, _ChannelProvider_strategy, "f").isEndpointConnected(endpointId)) {
             return __classPrivateFieldGet$9(this, _ChannelProvider_strategy, "f").send(endpointId, action, payload);
         }
@@ -9972,13 +9981,12 @@ class ChannelProvider extends channel_1.ChannelBase {
         }
     }
     getEndpointIdForOpenFinId(clientIdentity, action) {
-        var _a;
         const matchingConnections = this.connections.filter((c) => c.name === clientIdentity.name && c.uuid === clientIdentity.uuid);
         if (matchingConnections.length >= 2) {
             const protectedObj = __classPrivateFieldGet$9(this, _ChannelProvider_protectedObj, "f");
             const { uuid, name } = clientIdentity;
-            const providerUuid = protectedObj === null || protectedObj === void 0 ? void 0 : protectedObj.providerIdentity.uuid;
-            const providerName = protectedObj === null || protectedObj === void 0 ? void 0 : protectedObj.providerIdentity.name;
+            const providerUuid = protectedObj?.providerIdentity.uuid;
+            const providerName = protectedObj?.providerIdentity.name;
             // eslint-disable-next-line no-console
             console.warn(`WARNING: Dispatch call may have unintended results. The "to" argument of your dispatch call is missing the
                 "endpointId" parameter. The identity you are dispatching to ({uuid: ${uuid}, name: ${name}})
@@ -9986,7 +9994,7 @@ class ChannelProvider extends channel_1.ChannelBase {
                 ({uuid: ${providerUuid}, name: ${providerName}}) will only be processed by the most recently-created client.`);
         }
         // Pop to return the most recently created endpointId.
-        return (_a = matchingConnections.pop()) === null || _a === void 0 ? void 0 : _a.endpointId;
+        return matchingConnections.pop()?.endpointId;
     }
     // eslint-disable-next-line class-methods-use-this
     static clientIdentityIncludesEndpointId(subscriptionIdentity) {
@@ -10029,9 +10037,10 @@ class MessageReceiver extends base_1$h.Base {
         wire.registerMessageHandler(this.onmessage.bind(this));
     }
     async processChannelMessage(msg) {
-        var _a, _b;
         const { senderIdentity, providerIdentity, action, ackToSender, payload, intendedTargetIdentity } = msg.payload;
-        const key = (_b = (_a = intendedTargetIdentity.channelId) !== null && _a !== void 0 ? _a : intendedTargetIdentity.endpointId) !== null && _b !== void 0 ? _b : this.latestEndpointIdByChannelId.get(providerIdentity.channelId); // No endpointId was passed, make best attempt
+        const key = intendedTargetIdentity.channelId ?? // The recipient is a provider
+            intendedTargetIdentity.endpointId ?? // The recipient is a client
+            this.latestEndpointIdByChannelId.get(providerIdentity.channelId); // No endpointId was passed, make best attempt
         const handler = this.endpointMap.get(key);
         if (!handler) {
             ackToSender.payload.success = false;
@@ -10111,12 +10120,9 @@ class ProtocolManager {
             return supported;
         };
         this.getCompatibleProtocols = (providerProtocols, clientOffer) => {
-            const supported = clientOffer.supportedProtocols.filter((clientProtocol) => providerProtocols.some((providerProtocol) => {
-                var _a;
-                return providerProtocol.type === clientProtocol.type &&
-                    clientProtocol.version >= providerProtocol.minimumVersion &&
-                    providerProtocol.version >= ((_a = clientProtocol.minimumVersion) !== null && _a !== void 0 ? _a : 0);
-            }));
+            const supported = clientOffer.supportedProtocols.filter((clientProtocol) => providerProtocols.some((providerProtocol) => providerProtocol.type === clientProtocol.type &&
+                clientProtocol.version >= providerProtocol.minimumVersion &&
+                providerProtocol.version >= (clientProtocol.minimumVersion ?? 0)));
             return supported.slice(0, clientOffer.maxProtocols);
         };
     }
@@ -10241,7 +10247,7 @@ class ConnectionManager extends base_1$g.Base {
     }
     createProvider(options, providerIdentity) {
         const opts = Object.assign(this.wire.environment.getDefaultChannelOptions().create, options || {});
-        const protocols = this.protocolManager.getProviderProtocols(opts === null || opts === void 0 ? void 0 : opts.protocols);
+        const protocols = this.protocolManager.getProviderProtocols(opts?.protocols);
         const createSingleStrategy = (stratType) => {
             switch (stratType) {
                 case 'rtc':
@@ -10278,7 +10284,7 @@ class ConnectionManager extends base_1$g.Base {
         return channel;
     }
     async createClientOffer(options) {
-        const protocols = this.protocolManager.getClientProtocols(options === null || options === void 0 ? void 0 : options.protocols);
+        const protocols = this.protocolManager.getClientProtocols(options?.protocols);
         let rtcPacket;
         const supportedProtocols = await Promise.all(protocols.map(async (type) => {
             switch (type) {
@@ -10306,14 +10312,13 @@ class ConnectionManager extends base_1$g.Base {
         };
     }
     async createClientStrategy(rtcPacket, routingInfo) {
-        var _a;
         if (!routingInfo.endpointId) {
             routingInfo.endpointId = this.wire.environment.getNextMessageId();
             // For New Clients connecting to Old Providers. To prevent multi-dispatching and publishing, we delete previously-connected
             // clients that are in the same context as the newly-connected client.
             __classPrivateFieldGet$8(this, _ConnectionManager_messageReceiver, "f").checkForPreviousClientConnection(routingInfo.channelId);
         }
-        const answer = (_a = routingInfo.answer) !== null && _a !== void 0 ? _a : {
+        const answer = routingInfo.answer ?? {
             supportedProtocols: [{ type: 'classic', version: 1 }]
         };
         const createStrategyFromAnswer = async (protocol) => {
@@ -10371,7 +10376,7 @@ class ConnectionManager extends base_1$g.Base {
             if (!(provider instanceof provider_1$1.ChannelProvider)) {
                 throw Error('Cannot connect to a channel client');
             }
-            const offer = clientOffer !== null && clientOffer !== void 0 ? clientOffer : {
+            const offer = clientOffer ?? {
                 supportedProtocols: [{ type: 'classic', version: 1 }],
                 maxProtocols: 1
             };
@@ -10429,6 +10434,15 @@ class ConnectionManager extends base_1$g.Base {
 connectionManager.ConnectionManager = ConnectionManager;
 _ConnectionManager_messageReceiver = new WeakMap(), _ConnectionManager_rtcConnectionManager = new WeakMap();
 
+/**
+ * Entry points for the `Channel` subset of the `InterApplicationBus` API (`fin.InterApplicationBus.Channel`).
+ *
+ * * {@link Channel} contains static members of the `Channel` API, accessible through `fin.InterApplicationBus.Channel`.
+ * * {@link OpenFin.ChannelClient} describes a client of a channel, e.g. as returned by `fin.InterApplicationBus.Channel.connect`.
+ * * {@link OpenFin.ChannelProvider} describes a provider of a channel, e.g. as returned by `fin.InterApplicationBus.Channel.create`.
+ *
+ * @packageDocumentation
+ */
 var __classPrivateFieldSet$5 = (commonjsGlobal && commonjsGlobal.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -10444,7 +10458,7 @@ var _Channel_connectionManager, _Channel_internalEmitter, _Channel_readyToConnec
 Object.defineProperty(channel$1, "__esModule", { value: true });
 channel$1.Channel = void 0;
 /* eslint-disable no-console */
-const events_1$5 = eventsExports;
+const events_1$5 = require$$0;
 const lazy_1$1 = lazy;
 const base_1$f = base;
 const client_1 = client;
@@ -10764,7 +10778,14 @@ _Channel_connectionManager = new WeakMap(), _Channel_internalEmitter = new WeakM
 
 Object.defineProperty(interappbus, "__esModule", { value: true });
 interappbus.InterAppPayload = interappbus.InterApplicationBus = void 0;
-const events_1$4 = eventsExports;
+/**
+ * Entry point for the OpenFin `InterApplicationBus` API (`fin.InterApplicationBus`).
+ *
+ * * {@link InterApplicationBus} contains static members of the `InterApplicationBus` API, accessible through `fin.InterApplicationBus`.
+ *
+ * @packageDocumentation
+ */
+const events_1$4 = require$$0;
 const base_1$e = base;
 const ref_counter_1 = refCounter;
 const index_1$2 = channel$1;
@@ -10972,6 +10993,13 @@ function createKey(...toHash) {
 
 var clipboard = {};
 
+/**
+ * Entry point for the OpenFin `Clipboard` API (`fin.Clipboard`).
+ *
+ * * {@link Clipboard} contains static members of the `Clipboard` API, accessible through `fin.Clipboard`.
+ *
+ * @packageDocumentation
+ */
 Object.defineProperty(clipboard, "__esModule", { value: true });
 clipboard.Clipboard = void 0;
 const base_1$d = base;
@@ -11186,7 +11214,7 @@ const base_1$c = base;
 /**
  * An ExternalApplication object representing native language adapter connections to the runtime. Allows
  * the developer to listen to {@link OpenFin.ExternalApplicationEvents external application events}.
- * Discovery of connections is provided by <a href="tutorial-System.getAllExternalApplications.html">getAllExternalApplications.</a>
+ * Discovery of connections is provided by {@link System.System.getAllExternalApplications getAllExternalApplications}.</a>
  *
  * Processes that can be wrapped as `ExternalApplication`s include the following:
  * - Processes which have connected to an OpenFin runtime via an adapter
@@ -11300,6 +11328,9 @@ Object.defineProperty(Factory$5, "__esModule", { value: true });
 Factory$5.ExternalApplicationModule = void 0;
 const base_1$b = base;
 const Instance_1$4 = Instance$4;
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link ExternalApplication} class, available under `fin.ExternalApplication`.
+ */
 class ExternalApplicationModule extends base_1$b.Base {
     /**
      * Asynchronously returns an External Application object that represents an external application.
@@ -11359,9 +11390,9 @@ Factory$5.ExternalApplicationModule = ExternalApplicationModule;
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	/**
-	 * Entry points for the OpenFin `ExternalApplication` API.
+	 * Entry points for the OpenFin `ExternalApplication` API (`fin.ExternalApplication`).
 	 *
-	 * * {@link ExternalApplicationModule} contains static methods relating to the `ExternalApplication` type, accessible through `fin.ExternalApplication`.
+	 * * {@link ExternalApplicationModule} contains static members of the `ExternalApplication` type, accessible through `fin.ExternalApplication`.
 	 * * {@link ExternalApplication} describes an instance of an OpenFin ExternalApplication, e.g. as returned by `fin.ExternalApplication.getCurrent`.
 	 *
 	 * 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),
@@ -11370,7 +11401,7 @@ Factory$5.ExternalApplicationModule = ExternalApplicationModule;
 	 * @packageDocumentation
 	 */
 	__exportStar(Factory$5, exports);
-	__exportStar(Instance$4, exports);
+	__exportStar(Instance$4, exports); 
 } (externalApplication));
 
 var frame = {};
@@ -11527,6 +11558,9 @@ Factory$4._FrameModule = void 0;
 const base_1$9 = base;
 const validate_1$2 = validate;
 const Instance_1$3 = Instance$3;
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link _Frame} class, available under `fin.Frame`.
+ */
 class _FrameModule extends base_1$9.Base {
     /**
      * Asynchronously returns a reference to the specified frame. The frame does not have to exist
@@ -11607,12 +11641,12 @@ Factory$4._FrameModule = _FrameModule;
 
 (function (exports) {
 	/**
-	 * Entry points for the OpenFin `Frame` API.
+	 * Entry points for the OpenFin `Frame` API (`fin.Frame`).
 	 *
-	 * * {@link _FrameModule} contains static methods relating to the `Frame` type, accessible through `fin.Frame`.
+	 * * {@link _FrameModule} contains static members of the `Frame` API, accessible through `fin.Frame`.
 	 * * {@link _Frame} describes an instance of an OpenFin Frame, e.g. as returned by `fin.Frame.getCurrent`.
 	 *
-	 * 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),
+	 * 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),
 	 * both of these were documented on the same page.
 	 *
 	 * Underscore prefixing of OpenFin types that alias DOM entities will be fixed in a future version.
@@ -11635,7 +11669,7 @@ Factory$4._FrameModule = _FrameModule;
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	__exportStar(Factory$4, exports);
-	__exportStar(Instance$3, exports);
+	__exportStar(Instance$3, exports); 
 } (frame));
 
 var globalHotkey = {};
@@ -11658,6 +11692,8 @@ class GlobalHotkey extends base_1$8.EmitterBase {
      * Registers a global hotkey with the operating system.
      * @param hotkey a hotkey string
      * @param listener called when the registered hotkey is pressed by the user.
+     * @throws If the `hotkey` is reserved, see list below.
+     * @throws if the `hotkey` is already registered by another application.
      *
      * @remarks The `hotkey` parameter expects an electron compatible [accelerator](https://github.com/electron/electron/blob/master/docs/api/accelerator.md) and the `listener` will be called if the `hotkey` is pressed by the user.
      * If successfull, the hotkey will be 'claimed' by the application, meaning that this register call can be called multiple times from within the same application but will fail if another application has registered the hotkey.
@@ -11750,7 +11786,7 @@ class GlobalHotkey extends base_1$8.EmitterBase {
         return undefined;
     }
     /**
-     * Checks if a given hotkey has been registered
+     * Checks if a given hotkey has been registered by an application within the current runtime.
      * @param hotkey a hotkey string
      *
      * @example
@@ -11794,10 +11830,8 @@ const validate_1$1 = validate;
 const clientMap = new Map();
 /** Manages the life cycle of windows and views in the application.
  *
- * Enables taking snapshots of itself and applyi
- * ng them to restore a previous configuration
+ * Enables taking snapshots of itself and applying them to restore a previous configuration
  * as well as listen to {@link OpenFin.PlatformEvents platform events}.
- *
  */
 class Platform extends base_1$7.EmitterBase {
     /**
@@ -12156,15 +12190,13 @@ class Platform extends base_1$7.EmitterBase {
         });
     }
     /**
-     * ***DEPRECATED - please use Platform.createView.***
+     * ***DEPRECATED - please use {@link Platform.createView Platform.createView}.***
      * Reparents a specified view in a new target window.
      * @param viewIdentity View identity
      * @param target new owner window identity
      *
-     * @tutorial Platform.createView
      */
     async reparentView(viewIdentity, target) {
-        var _a;
         // eslint-disable-next-line no-console
         console.warn('Platform.reparentView has been deprecated, please use Platform.createView');
         this.wire.sendAction('platform-reparent-view', this.identity).catch((e) => {
@@ -12172,7 +12204,7 @@ class Platform extends base_1$7.EmitterBase {
         });
         const normalizedViewIdentity = {
             ...viewIdentity,
-            uuid: (_a = viewIdentity.uuid) !== null && _a !== void 0 ? _a : this.identity.uuid
+            uuid: viewIdentity.uuid ?? this.identity.uuid
         };
         const view = await this.fin.View.wrap(normalizedViewIdentity);
         const viewOptions = await view.getOptions();
@@ -12655,6 +12687,138 @@ const base_1$6 = base;
 const common_utils_1 = commonUtils;
 const layout_entities_1 = layoutEntities;
 const layout_constants_1 = layout_constants;
+/**
+ *
+ * Layouts give app providers the ability to embed multiple views in a single window. The Layout namespace
+ * enables the initialization and manipulation of a window's Layout. A Layout will
+ * emit events locally on the DOM element representing the layout-container.
+ *
+ *
+ * ### Layout.DOMEvents
+ *
+ * When a Layout is created, it emits events onto the DOM element representing the Layout container.
+ * This Layout container is the DOM element referenced by containerId in {@link Layout.LayoutModule#init Layout.init}.
+ * 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).
+ * The events are emitted synchronously and only in the process where the Layout exists.
+ * Any values returned by the called listeners are ignored and will be discarded.
+ * If the target DOM element is destroyed, any events that have been set up on that element will be destroyed.
+ *
+ * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
+ *
+ * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
+ * Adds a listener to the end of the listeners array for the specified event.
+ * @example
+ * ```js
+ * const myLayoutContainer = document.getElementById('layout-container');
+ *
+ * myLayoutContainer.addEventListener('tab-created', function(event) {
+ *      const { tabSelector } = event.detail;
+ *      const tabElement = document.getElementById(tabSelector);
+ *      const existingColor = tabElement.style.backgroundColor;
+ *      tabElement.style.backgroundColor = "red";
+ *      setTimeout(() => {
+ *          tabElement.style.backgroundColor = existingColor;
+ *      }, 2000);
+ * });
+ * ```
+ *
+ * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
+ * Adds a listener to the end of the listeners array for the specified event.
+ * @example
+ * ```js
+ * const myLayoutContainer = document.getElementById('layout-container');
+ *
+ * const listener = function(event) {
+ *     console.log(event.detail);
+ *     console.log('container-created event fired once, removing listener');
+ *     myLayoutContainer.removeEventListener('container-created', listener);
+ * };
+ *
+ * myLayoutContainer.addEventListener('container-created', listener);
+ * ```
+ *
+ * ### Supported event types are:
+ *
+ * * tab-created
+ * * container-created
+ * * layout-state-changed
+ * * tab-closed
+ * * tab-dropped
+ *
+ * ### Layout DOM Node Events
+ *
+ * #### tab-created
+ * 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.
+ * ```js
+ * // The response has the following shape in event.detail:
+ * {
+ *     containerSelector: "container-component_A",
+ *     name: "component_A",
+ *     tabSelector: "tab-component_A",
+ *     topic: "openfin-DOM-event",
+ *     type: "tab-created",
+ *     uuid: "OpenFin POC"
+ * }
+ * ```
+ *
+ * #### container-created
+ * 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.
+ * ```js
+ * // The response has the following shape in event.detail:
+ * {
+ *     containerSelector: "container-component_A",
+ *     name: "component_A",
+ *     tabSelector: "tab-component_A",
+ *     topic: "openfin-DOM-event",
+ *     type: "container-created",
+ *     uuid: "OpenFin POC"
+ * }
+ * ```
+ *
+ * ### layout-state-changed
+ * 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.
+ * ```js
+ * // The response has the following shape in event.detail
+ * {
+ *     containerSelector: "container-component_A",
+ *     name: "component_A",
+ *     tabSelector: "tab-component_A",
+ *     topic: "openfin-DOM-event",
+ *     type: "layout-state-changed",
+ *     uuid: "OpenFin POC"
+ * }
+ * ```
+ *
+ * #### tab-closed
+ * Generated when a tab is closed.
+ * ```js
+ * // The response has the following shape in event.detail:
+ * {
+ *     containerSelector: "container-component_A",
+ *     name: "component_A",
+ *     tabSelector: "tab-component_A",
+ *     topic: "openfin-DOM-event",
+ *     type: "tab-closed",
+ *     uuid: "OpenFin POC",
+ *     url: "http://openfin.co"   // The url of the view that was closed.
+ * }
+ * ```
+ *
+ * #### tab-dropped
+ * Generated when a tab is dropped.
+ * ```js
+ * // The response has the following shape in event.detail:
+ * {
+ *     containerSelector: "container-component_A",
+ *     name: "component_A",
+ *     tabSelector: "tab-component_A",
+ *     topic: "openfin-DOM-event",
+ *     type: "tab-dropped",
+ *     uuid: "OpenFin POC",
+ *     url: "http://openfin.co"    // The url of the view linked to the dropped tab.
+ * }
+ * ```
+ */
 class Layout extends base_1$6.Base {
     /**
      * @internal
@@ -12828,10 +12992,30 @@ class Layout extends base_1$6.Base {
             // don't expose
         });
         const client = await this.platform.getClient();
+        console.log(`Layout::toConfig() called!`);
         return client.dispatch('get-frame-snapshot', {
             target: this.identity
         });
     }
+    /**
+     * Retrieves the attached views in current window layout.
+     *
+     * @example
+     * ```js
+     * const layout = fin.Platform.Layout.getCurrentSync();
+     * const views = await layout.getCurrentViews();
+     * ```
+     */
+    async getCurrentViews() {
+        this.wire.sendAction('layout-get-views').catch((e) => {
+            // don't expose
+        });
+        const client = await this.platform.getClient();
+        const viewIdentities = await client.dispatch('get-layout-views', {
+            target: this.identity
+        });
+        return viewIdentities.map((identity) => this.fin.View.wrapSync(identity));
+    }
     /**
      * Retrieves the top level content item of the layout.
      *
@@ -12858,7 +13042,7 @@ class Layout extends base_1$6.Base {
             // don't expose
         });
         const client = await __classPrivateFieldGet$5(this, _Layout_layoutClient, "f").getValue();
-        const root = await client.getRoot();
+        const root = await client.getRoot(this.identity);
         return layout_entities_1.LayoutNode.getEntity(root, client);
     }
 }
@@ -12876,16 +13060,20 @@ var __classPrivateFieldSet$4 = (commonjsGlobal && commonjsGlobal.__classPrivateF
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _LayoutModule_layoutInitializationAttempted;
+var _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager;
 Object.defineProperty(Factory$2, "__esModule", { value: true });
 Factory$2.LayoutModule = void 0;
 /* eslint-disable no-undef, import/prefer-default-export */
 const base_1$5 = base;
 const Instance_1$2 = Instance$1;
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link Layout} class, available under `fin.Platform.Layout`.
+ */
 class LayoutModule extends base_1$5.Base {
     constructor() {
         super(...arguments);
         _LayoutModule_layoutInitializationAttempted.set(this, false);
+        _LayoutModule_layoutManager.set(this, null);
         /**
          * Initialize the window's Layout.
          *
@@ -12935,7 +13123,17 @@ class LayoutModule extends base_1$5.Base {
                 throw new Error('Layout for this window already initialized, please use Layout.replace call to replace the layout.');
             }
             __classPrivateFieldSet$4(this, _LayoutModule_layoutInitializationAttempted, true, "f");
-            return this.wire.environment.initLayout(this.fin, this.wire, options);
+            // TODO: remove this.wire and always use this.fin
+            __classPrivateFieldSet$4(this, _LayoutModule_layoutManager, await this.wire.environment.initLayout(this.fin, this.wire, options), "f");
+            // TODO: if create() wasn't called, warn!! aka, if lm.getLayouts().length === 0
+            const layoutInstance = await __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").resolveLayout();
+            const layout = this.wrapSync(layoutInstance.identity);
+            // Adding this to the returned instance undocumented/typed for Browser
+            // TODO: if not overridden, then return layoutManager: layoutInstance
+            return Object.assign(layout, { layoutManager: layoutInstance });
+        };
+        this.getCurrentLayoutManagerSync = () => {
+            return __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f");
         };
     }
     /**
@@ -13033,13 +13231,13 @@ class LayoutModule extends base_1$5.Base {
     }
 }
 Factory$2.LayoutModule = LayoutModule;
-_LayoutModule_layoutInitializationAttempted = new WeakMap();
+_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap();
 
 (function (exports) {
 	/**
-	 * Entry point for the OpenFin `Layout` namespace.
+	 * Entry point for the OpenFin `Layout` subset of the `Platform` API (`fin.Platform.Layout`).
 	 *
-	 * * {@link LayoutModule} contains static methods relating to the `Layout` type, accessible through `fin.Platform.Layout`.
+	 * * {@link LayoutModule} contains static members of the `Layout` API, accessible through `fin.Platform.Layout`.
 	 * * {@link Layout} describes an instance of an OpenFin Layout, e.g. as returned by `fin.Platform.Layout.getCurrent`.
 	 *
 	 * 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),
@@ -13047,131 +13245,6 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap();
 	 *
 	 * @packageDocumentation
 	 *
-	 *
-	 * ### Layout.DOMEvents
-	 *
-	 * When a Layout is created, it emits events onto the DOM element representing the Layout container.
-	 * This Layout container is the DOM element referenced by containerId in {@link Layout.LayoutModule#init Layout.init}.
-	 * 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).
-	 * The events are emitted synchronously and only in the process where the Layout exists.
-	 * Any values returned by the called listeners are ignored and will be discarded.
-	 * If the target DOM element is destroyed, any events that have been set up on that element will be destroyed.
-	 *
-	 * @remarks The built-in event emitter is not an OpenFin event emitter so it doesn't share propagation semantics.
-	 *
-	 * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener addEventListener(type, listener [, options]);}
-	 * Adds a listener to the end of the listeners array for the specified event.
-	 * @example
-	 * ```js
-	 * const myLayoutContainer = document.getElementById('layout-container');
-	 *
-	 * myLayoutContainer.addEventListener('tab-created', function(event) {
-	 *      const { tabSelector } = event.detail;
-	 *      const tabElement = document.getElementById(tabSelector);
-	 *      const existingColor = tabElement.style.backgroundColor;
-	 *      tabElement.style.backgroundColor = "red";
-	 *      setTimeout(() => {
-	 *          tabElement.style.backgroundColor = existingColor;
-	 *      }, 2000);
-	 * });
-	 * ```
-	 *
-	 * #### {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener removeEventListener(type, listener [, options]);}
-	 * Adds a listener to the end of the listeners array for the specified event.
-	 * @example
-	 * ```js
-	 * const myLayoutContainer = document.getElementById('layout-container');
-	 *
-	 * const listener = function(event) {
-	 *     console.log(event.detail);
-	 *     console.log('container-created event fired once, removing listener');
-	 *     myLayoutContainer.removeEventListener('container-created', listener);
-	 * };
-	 *
-	 * myLayoutContainer.addEventListener('container-created', listener);
-	 * ```
-	 *
-	 * ### Supported event types are:
-	 *
-	 * * tab-created
-	 * * container-created
-	 * * layout-state-changed
-	 * * tab-closed
-	 * * tab-dropped
-	 *
-	 * ### Layout DOM Node Events
-	 *
-	 * #### tab-created
-	 * 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.
-	 * ```js
-	 * // The response has the following shape in event.detail:
-	 * {
-	 *     containerSelector: "container-component_A",
-	 *     name: "component_A",
-	 *     tabSelector: "tab-component_A",
-	 *     topic: "openfin-DOM-event",
-	 *     type: "tab-created",
-	 *     uuid: "OpenFin POC"
-	 * }
-	 * ```
-	 *
-	 * #### container-created
-	 * 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.
-	 * ```js
-	 * // The response has the following shape in event.detail:
-	 * {
-	 *     containerSelector: "container-component_A",
-	 *     name: "component_A",
-	 *     tabSelector: "tab-component_A",
-	 *     topic: "openfin-DOM-event",
-	 *     type: "container-created",
-	 *     uuid: "OpenFin POC"
-	 * }
-	 * ```
-	 *
-	 * ### layout-state-changed
-	 * 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.
-	 * ```js
-	 * // The response has the following shape in event.detail
-	 * {
-	 *     containerSelector: "container-component_A",
-	 *     name: "component_A",
-	 *     tabSelector: "tab-component_A",
-	 *     topic: "openfin-DOM-event",
-	 *     type: "layout-state-changed",
-	 *     uuid: "OpenFin POC"
-	 * }
-	 * ```
-	 *
-	 * #### tab-closed
-	 * Generated when a tab is closed.
-	 * ```js
-	 * // The response has the following shape in event.detail:
-	 * {
-	 *     containerSelector: "container-component_A",
-	 *     name: "component_A",
-	 *     tabSelector: "tab-component_A",
-	 *     topic: "openfin-DOM-event",
-	 *     type: "tab-closed",
-	 *     uuid: "OpenFin POC",
-	 *     url: "http://openfin.co"   // The url of the view that was closed.
-	 * }
-	 * ```
-	 *
-	 * #### tab-dropped
-	 * Generated when a tab is dropped.
-	 * ```js
-	 * // The response has the following shape in event.detail:
-	 * {
-	 *     containerSelector: "container-component_A",
-	 *     name: "component_A",
-	 *     tabSelector: "tab-component_A",
-	 *     topic: "openfin-DOM-event",
-	 *     type: "tab-dropped",
-	 *     uuid: "OpenFin POC",
-	 *     url: "http://openfin.co"    // The url of the view linked to the dropped tab.
-	 * }
-	 * ```
 	 */
 	var __createBinding = (commonjsGlobal && commonjsGlobal.__createBinding) || (Object.create ? (function(o, m, k, k2) {
 	    if (k2 === undefined) k2 = k;
@@ -13189,7 +13262,7 @@ _LayoutModule_layoutInitializationAttempted = new WeakMap();
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	__exportStar(Factory$2, exports);
-	__exportStar(Instance$1, exports);
+	__exportStar(Instance$1, exports); 
 } (layout));
 
 Object.defineProperty(Factory$3, "__esModule", { value: true });
@@ -13197,6 +13270,9 @@ Factory$3.PlatformModule = void 0;
 const base_1$4 = base;
 const Instance_1$1 = Instance$2;
 const index_1$1 = layout;
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link Platform} class, available under `fin.Platform`.
+ */
 class PlatformModule extends base_1$4.Base {
     /**
      * @internal
@@ -13440,9 +13516,9 @@ Factory$3.PlatformModule = PlatformModule;
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	/**
-	 * Entry points for the OpenFin `Platform` API.
+	 * Entry points for the OpenFin `Platform` API (`fin.Platform`)
 	 *
-	 * * {@link PlatformModule} contains static methods relating to the `Platform` type, accessible through `fin.Platform`.
+	 * * {@link PlatformModule} contains static members of the `Platform` API, accessible through `fin.Platform`.
 	 * * {@link Platform} describes an instance of an OpenFin Platform, e.g. as returned by `fin.Platform.getCurrent`.
 	 *
 	 * 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),
@@ -13451,7 +13527,7 @@ Factory$3.PlatformModule = PlatformModule;
 	 * @packageDocumentation
 	 */
 	__exportStar(Factory$3, exports);
-	__exportStar(Instance$2, exports);
+	__exportStar(Instance$2, exports); 
 } (platform));
 
 var me = {};
@@ -13589,7 +13665,7 @@ var me = {};
 	            };
 	    }
 	}
-	exports.getMe = getMe;
+	exports.getMe = getMe; 
 } (me));
 
 var interop = {};
@@ -13692,9 +13768,8 @@ function requireSessionContextGroupBroker () {
 	        this.lastContext = context;
 	        const clientSubscriptionStates = Array.from(this.clients.values());
 	        clientSubscriptionStates.forEach((client) => {
-	            var _a;
 	            // eslint-disable-next-line no-unused-expressions
-	            (_a = client.contextHandlers.get(context.type)) === null || _a === void 0 ? void 0 : _a.forEach((handlerId) => {
+	            client.contextHandlers.get(context.type)?.forEach((handlerId) => {
 	                this.provider.dispatch(client.clientIdentity, handlerId, context);
 	            });
 	            if (client.globalHandler) {
@@ -13828,7 +13903,7 @@ var utils$1 = {};
 	        }
 	    };
 	};
-	exports.wrapIntentHandler = wrapIntentHandler;
+	exports.wrapIntentHandler = wrapIntentHandler; 
 } (utils$1));
 
 var PrivateChannelProvider = {};
@@ -14301,10 +14376,10 @@ function requireInteropBroker () {
 	        this.getProvider = getProvider;
 	        this.interopClients = new Map();
 	        this.contextGroupsById = new Map();
-	        if (options === null || options === void 0 ? void 0 : options.contextGroups) {
+	        if (options?.contextGroups) {
 	            contextGroups = options.contextGroups;
 	        }
-	        if (options === null || options === void 0 ? void 0 : options.logging) {
+	        if (options?.logging) {
 	            this.logging = options.logging;
 	        }
 	        this.intentClientMap = new Map();
@@ -14439,18 +14514,17 @@ function requireInteropBroker () {
 	     *
 	     */
 	    getCurrentContext(getCurrentContextOptions, clientIdentity) {
-	        var _a;
 	        this.wire.sendAction('interop-broker-get-current-context').catch((e) => {
 	            // don't expose, analytics-only call
 	        });
 	        const clientState = this.getClientState(clientIdentity);
-	        if (!(clientState === null || clientState === void 0 ? void 0 : clientState.contextGroupId)) {
+	        if (!clientState?.contextGroupId) {
 	            throw new Error('You must be a member of a context group to call getCurrentContext');
 	        }
 	        const { contextGroupId } = clientState;
 	        const contextGroupState = this.contextGroupsById.get(contextGroupId);
 	        const lastContextType = this.lastContextMap.get(contextGroupId);
-	        const contextType = (_a = getCurrentContextOptions === null || getCurrentContextOptions === void 0 ? void 0 : getCurrentContextOptions.contextType) !== null && _a !== void 0 ? _a : lastContextType;
+	        const contextType = getCurrentContextOptions?.contextType ?? lastContextType;
 	        return contextGroupState && contextType ? contextGroupState.get(contextType) : undefined;
 	    }
 	    /*
@@ -15101,10 +15175,9 @@ function requireInteropBroker () {
 	    }
 	    // Used to restore interop broker state in snapshots.
 	    applySnapshot(snapshot, options) {
-	        var _a;
-	        const contextGroupStates = (_a = snapshot === null || snapshot === void 0 ? void 0 : snapshot.interopSnapshotDetails) === null || _a === void 0 ? void 0 : _a.contextGroupStates;
+	        const contextGroupStates = snapshot?.interopSnapshotDetails?.contextGroupStates;
 	        if (contextGroupStates) {
-	            if (!(options === null || options === void 0 ? void 0 : options.closeExistingWindows)) {
+	            if (!options?.closeExistingWindows) {
 	                this.updateExistingClients(contextGroupStates);
 	            }
 	            this.rehydrateContextGroupStates(contextGroupStates);
@@ -15155,7 +15228,7 @@ function requireInteropBroker () {
 	    contextHandlerRegistered({ contextType, handlerId }, clientIdentity) {
 	        const handlerInfo = { contextType, handlerId };
 	        const clientState = this.getClientState(clientIdentity);
-	        clientState === null || clientState === void 0 ? void 0 : clientState.contextHandlers.set(handlerId, handlerInfo);
+	        clientState?.contextHandlers.set(handlerId, handlerInfo);
 	        if (clientState && clientState.contextGroupId) {
 	            const { contextGroupId } = clientState;
 	            const contextGroupMap = this.contextGroupsById.get(contextGroupId);
@@ -15177,7 +15250,7 @@ function requireInteropBroker () {
 	    async intentHandlerRegistered(payload, clientIdentity) {
 	        const { handlerId } = payload;
 	        const clientIntentInfo = this.intentClientMap.get(clientIdentity.name);
-	        const handlerInfo = clientIntentInfo === null || clientIntentInfo === void 0 ? void 0 : clientIntentInfo.get(handlerId);
+	        const handlerInfo = clientIntentInfo?.get(handlerId);
 	        if (!clientIntentInfo) {
 	            this.intentClientMap.set(clientIdentity.name, new Map());
 	            const newHandlerInfoMap = this.intentClientMap.get(clientIdentity.name);
@@ -15346,8 +15419,8 @@ function requireInteropBroker () {
 	                clientIdentity
 	            };
 	            // Only allow the client to join a contextGroup that actually exists.
-	            if ((payload === null || payload === void 0 ? void 0 : payload.currentContextGroup) && this.contextGroupsById.has(payload.currentContextGroup)) {
-	                clientSubscriptionState.contextGroupId = payload === null || payload === void 0 ? void 0 : payload.currentContextGroup;
+	            if (payload?.currentContextGroup && this.contextGroupsById.has(payload.currentContextGroup)) {
+	                clientSubscriptionState.contextGroupId = payload?.currentContextGroup;
 	            }
 	            this.interopClients.set(clientIdentity.endpointId, clientSubscriptionState);
 	        });
@@ -15365,17 +15438,15 @@ function requireInteropBroker () {
 	            this.clientDisconnected(clientIdentity);
 	        });
 	        channel.beforeAction(async (action, payload, clientIdentity) => {
-	            var _a, _b;
 	            if (!(await this.isActionAuthorized(action, payload, clientIdentity))) {
 	                throw new Error(`Action (${action}) not authorized for ${clientIdentity.uuid}, ${clientIdentity.name}`);
 	            }
-	            if ((_b = (_a = this.logging) === null || _a === void 0 ? void 0 : _a.beforeAction) === null || _b === void 0 ? void 0 : _b.enabled) {
+	            if (this.logging?.beforeAction?.enabled) {
 	                console.log(action, payload, clientIdentity);
 	            }
 	        });
 	        channel.afterAction((action, payload, clientIdentity) => {
-	            var _a, _b;
-	            if ((_b = (_a = this.logging) === null || _a === void 0 ? void 0 : _a.afterAction) === null || _b === void 0 ? void 0 : _b.enabled) {
+	            if (this.logging?.afterAction?.enabled) {
 	                console.log(action, payload, clientIdentity);
 	            }
 	        });
@@ -16224,9 +16295,8 @@ function requireOverrideCheck () {
 	overrideCheck.overrideCheck = overrideCheck.getDefaultViewFdc3VersionFromAppInfo = void 0;
 	const InteropBroker_1 = requireInteropBroker();
 	function getDefaultViewFdc3VersionFromAppInfo({ manifest, initialOptions }) {
-	    var _a, _b, _c, _d;
-	    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;
-	    return ['1.2', '2.0'].includes(setVersion !== null && setVersion !== void 0 ? setVersion : '') ? setVersion : undefined;
+	    const setVersion = manifest.platform?.defaultViewOptions?.fdc3InteropApi ?? initialOptions.defaultViewOptions?.fdc3InteropApi;
+	    return ['1.2', '2.0'].includes(setVersion ?? '') ? setVersion : undefined;
 	}
 	overrideCheck.getDefaultViewFdc3VersionFromAppInfo = getDefaultViewFdc3VersionFromAppInfo;
 	// TODO: Unit test this
@@ -16299,13 +16369,12 @@ function requireFactory () {
 	     * ```
 	     */
 	    async init(name, override = defaultOverride) {
-	        var _a;
 	        this.wire.sendAction('interop-init').catch(() => {
 	            // don't expose, analytics-only call
 	        });
 	        // Allows for manifest-level configuration, without having to override. (e.g. specifying custom context groups)
 	        const options = await this.fin.Application.getCurrentSync().getInfo();
-	        const opts = (_a = options.initialOptions.interopBrokerConfiguration) !== null && _a !== void 0 ? _a : {};
+	        const opts = options.initialOptions.interopBrokerConfiguration ?? {};
 	        const objectThatThrows = (0, inaccessibleObject_1.createUnusableObject)(BrokerParamAccessError);
 	        const warningOptsClone = (0, inaccessibleObject_1.createWarningObject)(BrokerParamAccessError, (0, lodash_1.cloneDeep)(opts));
 	        let provider;
@@ -16373,9 +16442,9 @@ function requireInterop () {
 	hasRequiredInterop = 1;
 	(function (exports) {
 		/**
-		 * Entry point for the OpenFin Interop namespace.
+		 * Entry point for the OpenFin `Interop` API (`fin.Interop`).
 		 *
-		 * * {@link InteropModule} contains static members of the `Interop` namespace (available under `fin.Interop`)
+		 * * {@link InteropModule} contains static members of the `Interop` API (available under `fin.Interop`)
 		 * * {@link InteropClient} and {@link InteropBroker} document instances of their respective classes.
 		 *
 		 * @packageDocumentation
@@ -16397,8 +16466,8 @@ function requireInterop () {
 		Object.defineProperty(exports, "__esModule", { value: true });
 		__exportStar(requireFactory(), exports);
 		__exportStar(InteropClient$1, exports);
-		__exportStar(requireInteropBroker(), exports);
-} (interop));
+		__exportStar(requireInteropBroker(), exports); 
+	} (interop));
 	return interop;
 }
 
@@ -16437,6 +16506,8 @@ const connectionMap = new Map();
 /**
  * Enables configuring a SnapshotSource with custom getSnapshot and applySnapshot methods.
  *
+ * @typeParam Snapshot Implementation-defined shape of an application snapshot.  Allows
+ * custom snapshot implementations for legacy applications to define their own snapshot format.
  */
 class SnapshotSource extends base_1$1.Base {
     /**
@@ -16575,10 +16646,16 @@ Factory.SnapshotSourceModule = void 0;
 const base_1 = base;
 const Instance_1 = Instance;
 const utils_1 = utils;
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link SnapshotSource} class, available under `fin.SnapshotSource`.
+ */
 class SnapshotSourceModule extends base_1.Base {
     /**
      * Initializes a SnapshotSource with the getSnapshot and applySnapshot methods defined.
      *
+     * @typeParam Snapshot Implementation-defined shape of an application snapshot.  Allows
+     * custom snapshot implementations for legacy applications to define their own snapshot format.
+     *
      * @example
      * ```js
      * const snapshotProvider = {
@@ -16594,6 +16671,7 @@ class SnapshotSourceModule extends base_1.Base {
      *
      * await fin.SnapshotSource.init(snapshotProvider);
      * ```
+     *
      */
     async init(provider) {
         this.wire.sendAction('snapshot-source-init').catch((e) => {
@@ -16648,10 +16726,10 @@ Factory.SnapshotSourceModule = SnapshotSourceModule;
 
 (function (exports) {
 	/**
-	 * Entry points for the OpenFin `SnapshotSource` API.
+	 * Entry points for the OpenFin `SnapshotSource` API (`fin.SnapshotSource`).
 	 *
-	 * * {@link SnapshotSourceModule} contains static methods relating to the `SnapshotSource` type, accessible through `fin.SnapshotSource`.
-	 * * {@link SnapshotSource} describes an instance of an OpenFin SnapshotSource, e.g. as returned by `fin.SnapshotSource.getCurrent`.
+	 * * {@link SnapshotSourceModule} contains static members of the `SnapshotSource` API, accessible through `fin.SnapshotSource`.
+	 * * {@link SnapshotSource} describes an instance of an OpenFin SnapshotSource, e.g. as returned by `fin.SnapshotSource.wrap`.
 	 *
 	 * 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),
 	 * both of these were documented on the same page.
@@ -16674,12 +16752,12 @@ Factory.SnapshotSourceModule = SnapshotSourceModule;
 	};
 	Object.defineProperty(exports, "__esModule", { value: true });
 	__exportStar(Factory, exports);
-	__exportStar(Instance, exports);
+	__exportStar(Instance, exports); 
 } (snapshotSource));
 
 Object.defineProperty(fin, "__esModule", { value: true });
 fin.Fin = void 0;
-const events_1$3 = eventsExports;
+const events_1$3 = require$$0;
 // Import from the file rather than the directory in case someone consuming types is using module resolution other than "node"
 const index_1 = system;
 const index_2 = requireWindow();
@@ -16694,6 +16772,9 @@ const index_10 = platform;
 const me_1$2 = me;
 const interop_1 = requireInterop();
 const snapshot_source_1 = snapshotSource;
+/**
+ * @internal
+ */
 class Fin extends events_1$3.EventEmitter {
     /**
      * @internal
@@ -16728,7 +16809,7 @@ var transport = {};
 var wire = {};
 
 Object.defineProperty(wire, "__esModule", { value: true });
-wire.isInternalConnectConfig = wire.isPortDiscoveryConfig = wire.isNewConnectConfig = wire.isRemoteConfig = wire.isExistingConnectConfig = wire.isExternalConfig = void 0;
+wire.isInternalConnectConfig = wire.isPortDiscoveryConfig = wire.isNewConnectConfig = wire.isConfigWithReceiver = wire.isRemoteConfig = wire.isExistingConnectConfig = wire.isExternalConfig = void 0;
 function isExternalConfig(config) {
     if (typeof config.manifestUrl === 'string') {
         return true;
@@ -16744,6 +16825,10 @@ function isRemoteConfig(config) {
     return isExistingConnectConfig(config) && typeof config.token === 'string';
 }
 wire.isRemoteConfig = isRemoteConfig;
+function isConfigWithReceiver(config) {
+    return typeof config.receiver === 'object' && isRemoteConfig({ ...config, address: '' });
+}
+wire.isConfigWithReceiver = isConfigWithReceiver;
 function hasUuid(config) {
     return typeof config.uuid === 'string';
 }
@@ -16769,7 +16854,7 @@ var emitterMap = {};
 
 Object.defineProperty(emitterMap, "__esModule", { value: true });
 emitterMap.EmitterMap = void 0;
-const events_1$2 = eventsExports;
+const events_1$2 = require$$0;
 class EmitterMap {
     constructor() {
         this.storage = new Map();
@@ -16851,7 +16936,7 @@ var __classPrivateFieldGet = (commonjsGlobal && commonjsGlobal.__classPrivateFie
 var _Transport_wire, _Transport_fin;
 Object.defineProperty(transport, "__esModule", { value: true });
 transport.Transport = void 0;
-const events_1$1 = eventsExports;
+const events_1$1 = require$$0;
 const wire_1 = wire;
 const transport_errors_1 = transportErrors;
 const eventAggregator_1 = eventAggregator;
@@ -16893,13 +16978,13 @@ class Transport extends events_1$1.EventEmitter {
     }
     getFin() {
         if (!__classPrivateFieldGet(this, _Transport_fin, "f")) {
-            throw new Error("No Fin object registered for this transport");
+            throw new Error('No Fin object registered for this transport');
         }
         return __classPrivateFieldGet(this, _Transport_fin, "f");
     }
     registerFin(_fin) {
         if (__classPrivateFieldGet(this, _Transport_fin, "f")) {
-            throw new Error("Fin object has already been registered for this transport");
+            throw new Error('Fin object has already been registered for this transport');
         }
         __classPrivateFieldSet(this, _Transport_fin, _fin, "f");
     }
@@ -16908,6 +16993,10 @@ class Transport extends events_1$1.EventEmitter {
         return wire.shutdown();
     }
     async connect(config) {
+        if ((0, wire_1.isConfigWithReceiver)(config)) {
+            await __classPrivateFieldGet(this, _Transport_wire, "f").connect(config.receiver);
+            return this.authorize(config);
+        }
         if ((0, wire_1.isRemoteConfig)(config)) {
             return this.connectRemote(config);
         }
@@ -16921,14 +17010,14 @@ class Transport extends events_1$1.EventEmitter {
         return undefined;
     }
     async connectRemote(config) {
-        await __classPrivateFieldGet(this, _Transport_wire, "f").connect(config.address, this.environment.getWsConstructor());
+        await __classPrivateFieldGet(this, _Transport_wire, "f").connect(new (this.environment.getWsConstructor())(config.address));
         return this.authorize(config);
     }
     async connectByPort(config) {
         const { address, uuid } = config;
         const reqAuthPayload = { ...config, type: 'file-token' };
         const wire = __classPrivateFieldGet(this, _Transport_wire, "f");
-        await wire.connect(address, this.environment.getWsConstructor());
+        await wire.connect(new (this.environment.getWsConstructor())(config.address));
         const requestExtAuthRet = await this.sendAction('request-external-authorization', {
             uuid,
             type: 'file-token'
@@ -16948,7 +17037,9 @@ class Transport extends events_1$1.EventEmitter {
             throw new transport_errors_1.RuntimeError(requestAuthRet.payload);
         }
     }
-    sendAction(action, payload = {}, uncorrelated = false) {
+    sendAction(action, payload = {}, uncorrelated = false
+    // specialResponse type is only used for 'requestAuthorization'
+    ) {
         // eslint-disable-next-line @typescript-eslint/no-empty-function
         let cancel = () => { };
         // We want the callsite from the caller of this function, not from here.
@@ -16998,7 +17089,10 @@ class Transport extends events_1$1.EventEmitter {
             this.uncorrelatedListener = resolve;
         }
         else if (this.wireListeners.has(id)) {
-            handleNack({ reason: 'Duplicate handler id', error: (0, errors_1.errorToPOJO)(new transport_errors_1.DuplicateCorrelationError(String(id))) });
+            handleNack({
+                reason: 'Duplicate handler id',
+                error: (0, errors_1.errorToPOJO)(new transport_errors_1.DuplicateCorrelationError(String(id)))
+            });
         }
         else {
             this.wireListeners.set(id, { resolve, handleNack });
@@ -17123,9 +17217,9 @@ var mockWire = {};
 
 Object.defineProperty(mockWire, "__esModule", { value: true });
 mockWire.MockWire = void 0;
-const events_1 = eventsExports;
+const events_1 = require$$0;
 class MockWire extends events_1.EventEmitter {
-    connect(address) {
+    connect() {
         throw new Error('You are not running in OpenFin.');
     }
     connectSync() {
@@ -17154,7 +17248,7 @@ const fin_1 = fin;
 const transport_1 = transport;
 const mockEnvironment_1 = mockEnvironment;
 const mockWire_1 = mockWire;
-exports.fin = mock.fin = ((typeof window !== 'undefined' && (window === null || window === void 0 ? void 0 : window.fin)) ||
+exports.fin = mock.fin = ((typeof window !== 'undefined' && window?.fin) ||
     (() => {
         const environment = new mockEnvironment_1.MockEnvironment();
         const transport = new transport_1.Transport(mockWire_1.MockWire, environment, {