npm - @openfin/core - Versions diffs - 34.78.7 → 34.78.10 - Mend

@openfin/core 34.78.7 → 34.78.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/out/mock-alpha.d.ts CHANGED Viewed

@@ -52,6 +52,7 @@ declare type AddViewToStackOptions = {
 /**
  * Generated when an alert is fired and suppressed due to the customWindowAlert flag being true.
+ * @interface
  */
 declare type AlertRequestedEvent = NamedEvent & {
     type: 'alert-requested';
@@ -810,6 +811,7 @@ declare class Application extends EmitterBase<OpenFin_2.ApplicationEvent> {
 /**
  * Generated when an application has authenticated and is connected.
+ * @interface
  */
 declare type ApplicationConnectedEvent = IdentityEvent & {
     type: 'connected';
@@ -817,6 +819,7 @@ declare type ApplicationConnectedEvent = IdentityEvent & {
 /**
  * Generated when an application is created.
+ * @interface
  */
 declare type ApplicationCreatedEvent = IdentityEvent & {
     type: 'application-created';
@@ -831,11 +834,10 @@ declare type ApplicationCreatedEvent = IdentityEvent & {
  * * `url` is optional in both the app manifest {@link Application.ApplicationModule.start Application.start} and  but is usually given
  * (defaults to `"about:blank"` when omitted).
  *
- * _This jsdoc typedef mirrors the `ApplicationOption` TypeScript interface in `@types/openfin`._
- *
  * **IMPORTANT NOTE:**
  * This object inherits all the properties of the window creation {@link OpenFin.WindowCreationOptions options} object,
  * which will take priority over those of the same name that may be provided in `mainWindowOptions`.
+ * @interface
  */
 declare type ApplicationCreationOptions = Partial<ApplicationOptions> & {
     name: string;
@@ -843,7 +845,10 @@ declare type ApplicationCreationOptions = Partial<ApplicationOptions> & {
 };
 /**
- *  An Application event.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by an {@link Application}.  Events are
+ *  discriminated by {@link ApplicationEvent.type | their type}.  Event payloads unique to `Application` can be found
+ *  under the {@link OpenFin.ApplicationEvents} namespace (payloads inherited from propagated events are defined in the namespace
+ *  from which they propagate).
  */
 declare type ApplicationEvent = {
     topic: 'application';
@@ -903,6 +908,9 @@ declare type ApplicationInfo = {
     };
 };
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link Application} class, available under `fin.Application`.
+ */
 declare class ApplicationModule extends Base {
     /**
      * Asynchronously returns an Application object that represents an existing application.
@@ -1083,6 +1091,7 @@ declare class ApplicationModule extends Base {
 /**
  * The complete set of options for an application.
+ * @interface
  */
 declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
     /**
@@ -1276,6 +1285,10 @@ declare type AppProcessInfo = {
     entities: EntityProcessDetails[];
 };
+/**
+ * Generated when system app versioning is successfully completed.
+ * @interface
+ */
 declare type AppVersionCompleteEvent = {
     type: 'app-version-complete';
 } & AppVersionProgress;
@@ -1285,6 +1298,10 @@ declare type AppVersionError = {
     srcManifest: string;
 };
+/**
+ * Generated when none of fallback manifests is compatible to the system.
+ * @interface
+ */
 declare type AppVersionErrorEvent = {
     type: 'app-version-error';
 } & AppVersionError;
@@ -1306,6 +1323,10 @@ declare type AppVersionProgress = {
     srcManifest: string;
 };
+/**
+ * Generated during the progress of system app versioning.
+ * @interface
+ */
 declare type AppVersionProgressEvent = {
     type: 'app-version-progress';
 } & AppVersionProgress;
@@ -1319,6 +1340,10 @@ declare type AppVersionRuntimeInfo = {
     error: string | null;
 };
+/**
+ * Generated when checking a runtime availability.
+ * @interface
+ */
 declare type AppVersionRuntimeStatusEvent = {
     type: 'runtime-status';
 } & AppVersionRuntimeInfo;
@@ -1327,6 +1352,7 @@ declare type AppVersionRuntimeStatusEvent = {
 /**
  * Generated when a View is attached to a window.
+ * @interface
  */
 declare type AttachedEvent = BaseViewEvent & {
     type: 'attached';
@@ -1399,6 +1425,7 @@ declare interface AuthorizationPayload {
  *     }
  * });
  * ```
+ * @interface
  */
 declare type AuthRequestedEvent = NamedEvent & {
     type: 'auth-requested';
@@ -1453,6 +1480,7 @@ declare class Base {
 /**
  * A base Channel event.
+ * @interface
  */
 declare type BaseChannelEvent = NamedEvent & {
     channelName: string;
@@ -1519,6 +1547,7 @@ declare namespace BaseEvents {
 /**
  * The base frame event.
+ * @interface
  */
 declare type BaseFrameEvent = NamedEvent & {
     entityType: 'iframe';
@@ -1539,12 +1568,16 @@ declare type BaseUrlEvent = NamedEvent & {
 /**
  * A base View event.
+ * @interface
  */
 declare type BaseViewEvent = NamedEvent & {
     target: OpenFin_2.Identity;
     viewIdentity: OpenFin_2.Identity;
 };
+/**
+ * User decision of whether a Window or specific View should close when trying to prevent an unload.
+ */
 declare interface BeforeUnloadUserDecision {
     /**
      * Specifies if the Window should close.
@@ -1558,6 +1591,7 @@ declare interface BeforeUnloadUserDecision {
 /**
  * Generated at the beginning of a user-driven change to a window's size or position.
+ * @interface
  */
 declare type BeginUserBoundsChangingEvent = UserBoundsChangeEvent & {
     type: 'begin-user-bounds-changing';
@@ -1565,6 +1599,7 @@ declare type BeginUserBoundsChangingEvent = UserBoundsChangeEvent & {
 /**
  * Generated when a WebContents loses focus.
+ * @interface
  */
 declare type BlurredEvent = NamedEvent & {
     type: 'blurred';
@@ -1579,6 +1614,7 @@ declare type Bounds = {
 /**
  * Generated after changes in a window's size and/or position.
+ * @interface
  */
 declare type BoundsChangedEvent = BoundsChangeEvent & {
     type: 'bounds-changed';
@@ -1586,6 +1622,7 @@ declare type BoundsChangedEvent = BoundsChangeEvent & {
 /**
  * A general bounds change event without event type.
+ * @interface
  */
 declare type BoundsChangeEvent = NamedEvent & {
     changeType: 0 | 1 | 2;
@@ -1598,6 +1635,7 @@ declare type BoundsChangeEvent = NamedEvent & {
 /**
  * Generated during changes to a window's size and/or position.
+ * @interface
  */
 declare type BoundsChangingEvent = BoundsChangeEvent & {
     type: 'bounds-changing';
@@ -1640,6 +1678,7 @@ declare type Certificate = {
 /**
  * Generated when navigating to a URL that fails certificate validation.
+ * @interface
  */
 declare type CertificateErrorEvent = NamedEvent & {
     type: 'certificate-error';
@@ -1659,6 +1698,7 @@ declare type CertificatePrincipal = {
 /**
  * Generated when the certificate selection dialog is shown.
+ * @interface
  */
 declare type CertificateSelectionShownEvent = NamedEvent & {
     type: 'certificate-selection-shown';
@@ -1856,7 +1896,7 @@ declare type Channel_3 = OpenFin_2.Fin['InterApplicationBus']['Channel'];
 declare type ChannelAction = OpenFin_2.ChannelAction;
-declare type ChannelAction_2 = (payload: unknown, id: ProviderIdentity_8 | ClientIdentity_2) => unknown;
+declare type ChannelAction_2 = (payload: unknown, id: ProviderIdentity_7 | ClientIdentity_2) => unknown;
 declare class ChannelBase {
     protected subscriptions: Map<string, ChannelAction>;
@@ -2135,17 +2175,17 @@ declare class ChannelBase {
  * 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)}
@@ -2160,11 +2200,11 @@ declare class ChannelClient extends ChannelBase {
     /* Excluded from this release type: closeChannelByEndpointId */
     /* Excluded from this release type: handleProviderDisconnect */
     /* Excluded from this release type: __constructor */
-    protected processAction: (action: string, payload: any, senderIdentity: ProviderIdentity_3 | OpenFin_2.ClientIdentity) => Promise<any>;
+    protected processAction: (action: string, payload: any, senderIdentity: OpenFin_2.ProviderIdentity | OpenFin_2.ClientIdentity) => Promise<any>;
     /**
      * a read-only provider identity
      */
-    get providerIdentity(): ProviderIdentity_3;
+    get providerIdentity(): OpenFin_2.ProviderIdentity;
     /**
      * Dispatch the given action to the channel provider. Returns a promise that resolves with the response from
      * the provider for that action.
@@ -2231,6 +2271,7 @@ declare type ChannelClient_2 = OpenFin_2.ChannelClient;
 /**
  * Generated when a Channel client is connected.
+ * @interface
  */
 declare type ChannelConnectedEvent = BaseChannelEvent & {
     type: 'connected';
@@ -2239,6 +2280,7 @@ declare type ChannelConnectedEvent = BaseChannelEvent & {
 /**
  * Options provided on a client connection to a channel.
  *
+ * @interface
  */
 declare type ChannelConnectOptions = ChannelCreateOptions & {
     /**
@@ -2265,6 +2307,7 @@ declare type ChannelCreateOptions = {
 /**
  * Generated when a Channel client has disconnected.
+ * @interface
  */
 declare type ChannelDisconnectedEvent = BaseChannelEvent & {
     type: 'disconnected';
@@ -2290,33 +2333,35 @@ declare namespace ChannelEvents {
 }
 /**
- * A Channel event type.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Channel}.  Events are
+ *  discriminated by {@link ChannelEvent.type | their type}.  Event payloads unique to `Channel` can be found
+ *  under the {@link OpenFin.ChannelEvents} namespace.
  */
 declare type ChannelEventType = ChannelEvent['type'];
 declare type ChannelMiddleware = OpenFin_2.ChannelMiddleware;
-declare type ChannelMiddleware_2 = (topic: string, payload: unknown, senderIdentity: ProviderIdentity_8 | ClientIdentity_2) => Promise<unknown> | unknown;
+declare type ChannelMiddleware_2 = (topic: string, payload: unknown, senderIdentity: ProviderIdentity_7 | ClientIdentity_2) => Promise<unknown> | unknown;
 /**
  * Instance created to enable use of a channel as a provider. Allows for communication with the {@link ChannelClient ChannelClients} by invoking an action on
  * 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)}
@@ -2506,6 +2551,7 @@ declare interface ChannelStrategy<T extends unknown> {
 /**
  * Generated when a child content is blocked to load.
+ * @interface
  */
 declare type ChildContentBlockedEvent = ContentCreationRulesEvent & {
     type: 'child-content-blocked';
@@ -2513,6 +2559,7 @@ declare type ChildContentBlockedEvent = ContentCreationRulesEvent & {
 /**
  * Generated when a child content is loaded into a browser.
+ * @interface
  */
 declare type ChildContentOpenedInBrowserEvent = ContentCreationRulesEvent & {
     type: 'child-content-opened-in-browser';
@@ -2525,6 +2572,7 @@ declare interface ChildContentOptions {
 /**
  * Generated when a child View is created.
+ * @interface
  */
 declare type ChildViewCreatedEvent = ContentCreationRulesEvent & {
     type: 'child-view-created';
@@ -2536,6 +2584,7 @@ declare type ChildViewCreatedEvent = ContentCreationRulesEvent & {
 /**
  * Generated when a child Window is created.
+ * @interface
  */
 declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     type: 'child-window-created';
@@ -2560,9 +2609,9 @@ declare class ClassicStrategy implements ChannelStrategy<EndpointPayload> {
     private endpointId;
     private providerIdentity;
     constructor(wire: Transport, messageReceiver: MessageReceiver, endpointId: string, // Provider endpointId is channelId
-    providerIdentity: ProviderIdentity_5);
+    providerIdentity: ProviderIdentity_4);
     onEndpointDisconnect(endpointId: string, listener: () => void): void;
-    receive(listener: (action: string, payload: any, identity: OpenFin_2.ClientIdentity | OpenFin_2.ClientIdentityMultiRuntime | ProviderIdentity_5) => Promise<any>): void;
+    receive(listener: (action: string, payload: any, identity: OpenFin_2.ClientIdentity | OpenFin_2.ClientIdentityMultiRuntime | ProviderIdentity_4) => Promise<any>): void;
     send: (endpointId: string, action: string, payload: any) => Promise<any>;
     close: () => Promise<void>;
     closeEndpoint(endpointId: string): Promise<void>;
@@ -2595,12 +2644,16 @@ declare type ClickedMenuResult<T extends unknown = unknown> = {
     data: T;
 };
+/**
+ * @interface
+ */
 declare type ClientConnectionPayload = ClientIdentity_2 & ClientInfo;
 declare type ClientIdentity = OpenFin_2.ClientIdentity;
 /**
  * Identity of a channel client
+ * @interface
  */
 declare type ClientIdentity_2 = Identity_5 & {
     /**
@@ -2610,12 +2663,16 @@ declare type ClientIdentity_2 = Identity_5 & {
     isLocalEndpointId: boolean;
 };
+/**
+ * @interface
+ */
 declare type ClientIdentityMultiRuntime = ClientIdentity_2 & {
     runtimeUuid: string;
 };
 /**
  * Extended channel client information
+ * @interface
  */
 declare type ClientInfo = Omit<ClientIdentity_2, 'isLocalEndpointId'> & {
     /**
@@ -2807,6 +2864,7 @@ declare type ClipboardSelectionType = 'clipboard' | 'selection';
 /**
  * Generated when an application is closed.
+ * @interface
  */
 declare type ClosedEvent = IdentityEvent & {
     type: 'closed';
@@ -2823,6 +2881,9 @@ declare type CloseViewPayload = {
     view: Identity_5;
 };
+/**
+ * Represents the shape of payload that contains the Window Identity and related options.
+ */
 declare interface CloseWindowPayload {
     /**
      *
@@ -3205,6 +3266,9 @@ declare type ContentCreationRule<T = ContentCreationBehaviorNames> = {
     data?: unknown;
 };
+/**
+ * @interface
+ */
 declare type ContentCreationRulesEvent = NamedEvent & {
     /**
      * The absolute url which triggered this event.
@@ -3263,6 +3327,9 @@ declare type Context = {
     type: string;
 };
+/**
+ * @interface
+ */
 declare type ContextForIntent<MetadataType = any> = Context & {
     metadata?: MetadataType;
 };
@@ -3365,6 +3432,7 @@ declare type CpuInfo = {
 /**
  * Generated when an application has crashed.
+ * @interface
  */
 declare type CrashedEvent = NamedEvent & {
     type: 'crashed';
@@ -3384,6 +3452,9 @@ declare type CrashReporterOptions = {
     diagnosticsMode: boolean;
 };
+/**
+ * @interface
+ */
 declare type CrashReporterState = CrashReporterOptions & {
     /**
      * Whether the crash reporter is running
@@ -3394,6 +3465,7 @@ declare type CrashReporterState = CrashReporterOptions & {
 /**
  * Generated when a View is created.
+ * @interface
  */
 declare type CreatedEvent = BaseViewEvent & {
     type: 'created';
@@ -3411,6 +3483,9 @@ declare type CreateViewPayload = {
     targetView?: Identity_5;
 };
+/**
+ * @interface
+ */
 declare type CreateViewTarget = Identity_5 & {
     /**
      * If specified, view creation will not attach to a window and caller must
@@ -3450,6 +3525,7 @@ declare type DefaultDomainSettingsRule = {
 /**
  * Generated when the desktop icon is clicked while it's already running.
+ * @interface
  */
 declare type DesktopIconClickedEvent = BaseEvent & {
     type: 'desktop-icon-clicked';
@@ -3457,6 +3533,7 @@ declare type DesktopIconClickedEvent = BaseEvent & {
 /**
  * Generated when a View is destroyed.
+ * @interface
  */
 declare type DestroyedEvent = BaseViewEvent & {
     type: 'destroyed';
@@ -3464,6 +3541,7 @@ declare type DestroyedEvent = BaseViewEvent & {
 /**
  * Generated when a page's theme color changes. This is usually due to encountering a meta tag.
+ * @interface
  */
 declare type DidChangeThemeColorEvent = NamedEvent & {
     type: 'did-change-theme-color';
@@ -3471,6 +3549,7 @@ declare type DidChangeThemeColorEvent = NamedEvent & {
 /**
  * Generated when load failed.
+ * @interface
  */
 declare type DidFailLoadEvent = BaseLoadFailedEvent & {
     type: 'did-fail-load';
@@ -3478,11 +3557,15 @@ declare type DidFailLoadEvent = BaseLoadFailedEvent & {
 /**
  * Generated when the navigation is done, i.e. the spinner of the tab will stop spinning, and the onload event is dispatched.
+ * @interface
  */
 declare type DidFinishLoadEvent = NamedEvent & {
     type: 'did-finish-load';
 };
+/**
+ * @interface
+ */
 declare type DipRect = RectangleByEdgePositions & {
     dipRect: RectangleByEdgePositions;
     scaledRect: RectangleByEdgePositions;
@@ -3495,6 +3578,7 @@ declare type DipScaleRects = {
 /**
  * Generated after a change to a window's size and/or position is attempted while window movement is disabled.
+ * @interface
  */
 declare type DisabledMovementBoundsChangedEvent = BoundsChangeEvent & {
     type: 'disabled-movement-bounds-changed';
@@ -3502,12 +3586,13 @@ declare type DisabledMovementBoundsChangedEvent = BoundsChangeEvent & {
 /**
  * Generated while a change to a window's size and/or position is attempted while window movement is disabled.
+ * @interface
  */
 declare type DisabledMovementBoundsChangingEvent = BoundsChangeEvent & {
     type: 'disabled-movement-bounds-changing';
 };
-declare type DisconnectionListener = (providerIdentity: ProviderIdentity_3) => any;
+declare type DisconnectionListener = (providerIdentity: OpenFin_2.ProviderIdentity) => any;
 declare type DisconnectionListener_2 = (identity: ClientIdentity) => any;
@@ -3578,6 +3663,7 @@ declare type Dpi = {
 /**
  * Generated when a window has been embedded.
+ * @interface
  */
 declare type EmbeddedEvent = NamedEvent & {
     type: 'embedded';
@@ -3688,6 +3774,7 @@ declare class EmitterMap {
 /**
  * Generated when a window ends loading.
+ * @interface
  */
 declare type EndLoadEvent = NamedEvent & {
     type: 'end-load';
@@ -3695,7 +3782,7 @@ declare type EndLoadEvent = NamedEvent & {
     isMain: boolean;
 };
-declare type EndpointIdentity = OpenFin_2.ClientIdentity | ProviderIdentity_4;
+declare type EndpointIdentity = OpenFin_2.ClientIdentity | ProviderIdentity_3;
 declare type EndpointPayload = {
     endpointIdentity: EndpointIdentity;
@@ -3703,6 +3790,7 @@ declare type EndpointPayload = {
 /**
  * Generated at the end of a user-driven change to a window's size or position.
+ * @interface
  */
 declare type EndUserBoundsChangingEvent = UserBoundsChangeEvent & {
     type: 'end-user-bounds-changing';
@@ -3718,6 +3806,9 @@ declare type EntityInfo_2 = {
     entityType: EntityType;
 };
+/**
+ * @interface
+ */
 declare type EntityProcessDetails = FrameProcessDetails & {
     name: string;
     uuid: string;
@@ -3787,7 +3878,7 @@ declare interface Environment {
 declare type ErrorMiddleware = OpenFin_2.ErrorMiddleware;
-declare type ErrorMiddleware_2 = (topic: string, error: Error, id: ProviderIdentity_8 | ClientIdentity_2) => unknown;
+declare type ErrorMiddleware_2 = (topic: string, error: Error, id: ProviderIdentity_7 | ClientIdentity_2) => unknown;
 /**
  * This function converts JS errors into plain objects
@@ -3829,7 +3920,7 @@ declare type ExitCode = {
 /**
  * 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
@@ -3933,6 +4024,7 @@ declare class ExternalApplication extends EmitterBase<OpenFin_2.ExternalApplicat
 /**
  * Generated when an external application has authenticated and is connected.
+ * @interface
  */
 declare type ExternalApplicationConnectedEvent = BaseEvent & {
     type: 'connected';
@@ -3940,13 +4032,16 @@ declare type ExternalApplicationConnectedEvent = BaseEvent & {
 /**
  * Generated when an external application has disconnected.
+ * @interface
  */
 declare type ExternalApplicationDisconnectedEvent = BaseEvent & {
     type: 'disconnected';
 };
 /**
- * An external application event.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by an {@link ExternalApplication}.  Events are
+ *  discriminated by {@link ExternalApplicationEvent.type | their type}.  Event payloads unique to `ExternalApplication` can be found
+ *  under the {@link OpenFin.ExternalApplicationEvents} namespace.
  */
 declare type ExternalApplicationEvent = {
     topic: 'externalapplication';
@@ -3966,6 +4061,9 @@ declare type ExternalApplicationInfo = {
     parent: Identity_5;
 };
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link ExternalApplication} class, available under `fin.ExternalApplication`.
+ */
 declare class ExternalApplicationModule extends Base {
     /**
      * Asynchronously returns an External Application object that represents an external application.
@@ -4010,6 +4108,7 @@ declare type ExternalConnection = {
 /**
  * Generated when an external process has exited.
+ * @interface
  */
 declare type ExternalProcessExitedEvent = NamedEvent & {
     type: 'external-process-exited';
@@ -4048,6 +4147,7 @@ declare type ExternalProcessRequestType = {
 /**
  * Generated when an external process has started.
+ * @interface
  */
 declare type ExternalProcessStartedEvent = NamedEvent & {
     type: 'external-process-started';
@@ -4056,6 +4156,7 @@ declare type ExternalProcessStartedEvent = NamedEvent & {
 /**
  * Generated when page receives favicon urls.
+ * @interface
  */
 declare type FaviconUpdatedEvent = NamedEvent & {
     type: 'page-favicon-updated';
@@ -4073,6 +4174,7 @@ declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
 /**
  * Generated when a file download has completed.
+ * @interface
  */
 declare type FileDownloadCompletedEvent = FileDownloadEvent & {
     type: 'file-download-completed';
@@ -4081,6 +4183,7 @@ declare type FileDownloadCompletedEvent = FileDownloadEvent & {
 /**
  * A general file download event without event type.
+ * @interface
  */
 declare type FileDownloadEvent = {
     /**
@@ -4132,6 +4235,8 @@ declare type FileDownloadEvent = {
 /**
  * Generated when setFileDownloadLocation api is called.
  * @remarks This event will not include the file download location itself. In order to get the new file download location, the user will have to access the secured query API 'getFileDownloadLocation'.
+ *
+ * @interface
  */
 declare type FileDownloadLocationChangedEvent = NamedEvent & {
     type: 'file-download-location-changed';
@@ -4139,6 +4244,7 @@ declare type FileDownloadLocationChangedEvent = NamedEvent & {
 /**
  * Generated during file download progress.
+ * @interface
  */
 declare type FileDownloadProgressEvent = FileDownloadEvent & {
     type: 'file-download-progress';
@@ -4151,6 +4257,7 @@ declare type FileDownloadSettings = {
 /**
  * Generated when a file download has started.
+ * @interface
  */
 declare type FileDownloadStartedEvent = FileDownloadEvent & {
     type: 'file-download-started';
@@ -4238,6 +4345,7 @@ declare type FindIntentsByContextOptions<MetadataType = IntentMetadata> = {
 /**
  * Generated when a WebContents gains focus.
+ * @interface
  */
 declare type FocusedEvent = NamedEvent & {
     type: 'focused';
@@ -4245,6 +4353,7 @@ declare type FocusedEvent = NamedEvent & {
 /**
  * Generated when a result is available when calling findInPage.
+ * @interface
  */
 declare type FoundInPageEvent = NamedEvent & {
     type: 'found-in-page';
@@ -4383,6 +4492,7 @@ declare class _Frame extends EmitterBase<OpenFin_2.FrameEvent> {
 /**
  * Generated when a frame is connected.
+ * @interface
  */
 declare type FrameConnectedEvent = BaseFrameEvent & {
     type: 'connected';
@@ -4390,6 +4500,7 @@ declare type FrameConnectedEvent = BaseFrameEvent & {
 /**
  * Generated when a frame has disconnected.
+ * @interface
  */
 declare type FrameDisconnectedEvent = BaseFrameEvent & {
     type: 'disconnected';
@@ -4415,7 +4526,9 @@ declare namespace FrameEvents {
 }
 /**
- * A Frame event type.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link _Frame}.  Events are
+ *  discriminated by {@link _Frame.type | their type}.  Event payloads unique to `Frame` can be found
+ *  under the {@link OpenFin.FrameEvents} namespace.
  */
 declare type FrameEventType = FrameEvent['type'];
@@ -4427,6 +4540,9 @@ declare type FrameInfo = {
     parent: Identity_5;
 };
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link _Frame} class, available under `fin.Frame`.
+ */
 declare class _FrameModule extends Base {
     /**
      * Asynchronously returns a reference to the specified frame. The frame does not have to exist
@@ -4476,6 +4592,9 @@ declare class _FrameModule extends Base {
     getCurrentSync(): OpenFin_2.Frame;
 }
+/**
+ * @interface
+ */
 declare type FrameProcessDetails = ProcessDetails & {
     /**
      * Current URL associated with the process.
@@ -4619,7 +4738,9 @@ declare class GlobalHotkey extends EmitterBase<OpenFin_2.GlobalHotkeyEvent> {
 }
 /**
- * A global hotkey event.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by {@link GlobalHotkey}.  Events are
+ *  discriminated by {@link GlobalHotkeyEvent.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
+ *  under the {@link OpenFin.GlobalHotkeyEvents} namespace.
  */
 declare type GlobalHotkeyEvent = {
     topic: 'global-hotkey';
@@ -4640,18 +4761,11 @@ declare type GpuInfo = {
     name: string;
 };
-/**
- * Generated when a window has been hidden.
- */
-declare type HiddenEvent = NamedEvent & {
-    type: 'hidden';
-    reason: 'closing' | 'hide' | 'hide-on-close';
-};
 /**
  * Generated when a View is hidden.
+ * @interface
  */
-declare type HiddenEvent_2 = BaseViewEvent & {
+declare type HiddenEvent = BaseViewEvent & {
     type: 'hidden';
 };
@@ -4718,6 +4832,7 @@ declare type Hotkey = {
 /**
  * Generated when a keyboard shortcut defined in the `hotkeys` array in [View options](OpenFin.ViewOptions.html) is pressed inside the view.
  * @remarks For reference on keyboard event properties see [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent).
+ * @interface
  */
 declare type HotkeyEvent = BaseViewEvent & {
     type: 'hotkey';
@@ -4752,6 +4867,7 @@ declare type IdentityCall<AdditionalPayload = {}, Response = void> = ApiCall<Add
 /**
  * An Identity event.
+ * @interface
  */
 declare type IdentityEvent = BaseEvent & {
     uuid: string;
@@ -4764,6 +4880,7 @@ declare type IdentityEvent = BaseEvent & {
  * @remarks This method is continuously generated every minute while the user is in idle.
  * A user enters idle state when the computer is locked or when there has been no keyboard/mouse activity for 1 minute.
  * A user returns from idle state when the computer is unlocked or keyboard/mouse activity has resumed.
+ * @interface
  */
 declare type IdleEvent = {
     type: 'idle-state-changed';
@@ -4792,6 +4909,7 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata> = {
 /**
  * Generated when an application has initialized.
+ * @interface
  */
 declare type InitializedEvent = IdentityEvent & {
     type: 'initialized';
@@ -4822,6 +4940,7 @@ declare type InitPlatformOptions = {
 /**
  * Generated when the value of the element changes.
+ * @interface
  */
 declare type InputEvent_2 = {
     inputType: 'keyUp' | 'keyDown';
@@ -4975,6 +5094,9 @@ declare class InterApplicationBus extends Base {
 declare type InternalConnectConfig = ExistingConnectConfig | NewConnectConfig;
+/**
+ * Define whether to enable interop action logging.
+ */
 declare interface InteropActionLoggingOption {
     enabled: boolean;
 }
@@ -6344,6 +6466,138 @@ declare type LaunchIntoPlatformPayload = {
     manifest: any;
 };
+/**
+ *
+ * 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.
+ * }
+ * ```
+ */
 declare class Layout extends Base {
     #private;
     /* Excluded from this release type: init */
@@ -6524,6 +6778,7 @@ declare type LayoutEntityTypes = Exclude<GoldenLayout.ItemType, 'component' | 'r
 /**
  * Generated when a window and all of its layout's views have either finished or failed navigation.
+ * @interface
  */
 declare type LayoutInitializedEvent = NamedEvent & {
     type: 'layout-initialized';
@@ -6641,6 +6896,9 @@ declare class LayoutManager {
     private setComponentState;
 }
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link Layout} class, available under `fin.Platform.Layout`.
+ */
 declare class LayoutModule extends Base {
     #private;
     /**
@@ -6837,6 +7095,7 @@ declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 /**
  * Generated when a window and all of its layout's views have been created and can receive API calls.
+ * @interface
  */
 declare type LayoutReadyEvent = NamedEvent & {
     type: 'layout-ready';
@@ -6944,6 +7203,7 @@ declare type Manifest = {
 /**
  * Generated when the RVM notifies an application that the manifest has changed.
+ * @interface
  */
 declare type ManifestChangedEvent = IdentityEvent & {
     type: 'manifest-changed';
@@ -6987,6 +7247,7 @@ declare type MatchPattern = string;
 /**
  * Generated when a window is maximized.
+ * @interface
  */
 declare type MaximizedEvent = NamedEvent & {
     type: 'maximized';
@@ -7059,6 +7320,7 @@ declare type MessagingProtocols = ProtocolOffer['type'];
 /**
  * Generated when a window is minimized.
+ * @interface
  */
 declare type MinimizedEvent = NamedEvent & {
     type: 'minimized';
@@ -7104,6 +7366,7 @@ declare type MonitorDetails = {
  * Generated on changes of a monitor's size/location.
  * @remarks A monitor's size changes when the taskbar is resized or relocated.
  * The available space of a monitor defines a rectangle that is not occupied by the taskbar
+ * @interface
  */
 declare type MonitorEvent = OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
@@ -7451,6 +7714,7 @@ declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => v
 /**
  * A Name event.
+ * @interface
  */
 declare type NamedEvent = IdentityEvent & {
     name: string;
@@ -7462,6 +7726,7 @@ declare type NativeWindowIntegrationProviderAuthorization = {
 /**
  * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules.
+ * @interface
  */
 declare type NavigationRejectedEvent = NamedEvent & {
     type: 'navigation-rejected';
@@ -7482,6 +7747,9 @@ declare type NavigationRules = {
 declare type NewConnectConfig = ConfigWithUuid & ConfigWithRuntime;
+/**
+ * @interface
+ */
 declare type NonAppProcessDetails = ProcessDetails & {
     name: string;
 };
@@ -7505,6 +7773,7 @@ declare type NonPropagatedWindowEvent = NonPropagatedWebContentsEvent;
 /**
  * Generated when an application is not responding.
+ * @interface
  */
 declare type NotRespondingEvent = IdentityEvent & {
     type: 'not-responding';
@@ -7512,6 +7781,9 @@ declare type NotRespondingEvent = IdentityEvent & {
 declare type OnlyIfCompatible<A, B, D = OverlapsOnlyIfMatching<A, B>> = D extends Record<any, never> ? keyof D extends never ? A | B : never : A | B;
+/**
+ * @interface
+ */
 declare type Opacity = TransitionBase & {
     /**
      * The opacity from 0.0 (transparent) to 1.0 (normal).
@@ -7746,7 +8018,7 @@ declare namespace OpenFin_2 {
         ContextForIntent,
         InfoForIntentOptions,
         FindIntentsByContextOptions,
-        ProviderIdentity_8 as ProviderIdentity,
+        ProviderIdentity_7 as ProviderIdentity,
         RegisterUsageData,
         ViewsPreventingUnloadPayload,
         BeforeUnloadUserDecision,
@@ -7818,7 +8090,8 @@ declare namespace OpenFin_2 {
         InteropLoggingOptions,
         Me,
         CapturePageOptions,
-        ProcessLoggingOptions
+        ProcessLoggingOptions,
+        PositioningOptions
     }
 }
 export default OpenFin_2;
@@ -7834,6 +8107,7 @@ declare type OverrideCallback<T extends any = PlatformProvider, U extends T = T>
 /**
  * Generated when page title is set during navigation.
  * @remarks explicitSet is false when title is synthesized from file url.
+ * @interface
  */
 declare type PageTitleUpdatedEvent = NamedEvent & {
     type: 'page-title-updated';
@@ -7851,6 +8125,7 @@ declare type PayloadTypeByStrategy<T extends ChannelStrategy<unknown>> = T exten
 /**
  * Generated when window finishes loading. Provides performance and navigation data.
+ * @interface
  */
 declare type PerformanceReportEvent = Performance & NamedEvent & {
     type: 'performance-report';
@@ -8144,12 +8419,11 @@ declare class Platform extends EmitterBase<OpenFin_2.PlatformEvent> {
      */
     closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
     /**
-     * ***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
      */
     reparentView(viewIdentity: OpenFin_2.Identity, target: OpenFin_2.Identity): Promise<View>;
     /**
@@ -8489,6 +8763,7 @@ declare type Platform_2 = OpenFin_2.Platform;
 /**
  * Generated when a new Platform's API becomes responsive.
+ * @interface
  */
 declare type PlatformApiReadyEvent = BaseEvent & {
     topic: 'application';
@@ -8496,7 +8771,9 @@ declare type PlatformApiReadyEvent = BaseEvent & {
 };
 /**
- * A Platform event.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Platform}.  Events are
+ *  discriminated by {@link PlatformEvent.type | their type}.  Event payloads unique to `Platform` can be found
+ *  under the {@link OpenFin.PlatformEvents} namespace.
  */
 declare type PlatformEvent = ApplicationEvent | PlatformApiReadyEvent | PlatformSnapshotAppliedEvent;
@@ -8510,6 +8787,9 @@ declare namespace PlatformEvents {
     }
 }
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link Platform} class, available under `fin.Platform`.
+ */
 declare class PlatformModule extends Base {
     private _channel;
     Layout: LayoutModule;
@@ -8666,6 +8946,7 @@ declare class PlatformModule extends Base {
 /**
  * The options object required by {@link Platform.PlatformModule#start Platform.start}
  * Any {@link ApplicationOptions Application option} is also a valid platform option
+ * @interface
  */
 declare type PlatformOptions = ApplicationCreationOptions & {
     /**
@@ -9174,6 +9455,7 @@ declare interface PlatformProvider {
  * 3. If a window has a layout property, the 'layout-ready' event has fired
  *
  * _Note_ - In the case of using a custom provider, if a window has a layout property but does not call _Layout.init_ this event may not fire.
+ * @interface
  */
 declare type PlatformSnapshotAppliedEvent = BaseEvent & {
     topic: 'application';
@@ -9182,6 +9464,9 @@ declare type PlatformSnapshotAppliedEvent = BaseEvent & {
 declare type PlatformViewCreationOptions = Partial<ViewOptions>;
+/**
+ * @interface
+ */
 declare type PlatformWindowCreationOptions = Partial<WindowCreationOptions> & {
     updateStateIfExists?: boolean;
     reason?: WindowCreationReason;
@@ -9192,6 +9477,7 @@ declare type PlatformWindowCreationOptions = Partial<WindowCreationOptions> & {
  * Any {@link OpenFin.WindowCreationOptions Window option} is also a valid Default Window option
  * used by default in any window that is created in the current platform's scope.
  * Individual window options will override these defaults.
+ * @interface
  */
 declare type PlatformWindowOptions = WindowCreationOptions & {
     /**
@@ -9230,35 +9516,117 @@ declare type PopupBlurBehavior = 'modal' | PopupBaseBehavior;
 declare type PopupInteraction = 'clicked' | 'dismissed';
+/**
+ * Popup window options.
+ */
 declare interface PopupOptions {
+    /**
+     * Window creation options when using `showPopupWindow` to create a new window.
+     */
     initialOptions?: Optional<WindowCreationOptions, 'name'>;
+    /**
+     * Updatable window options applied to new and existing windows when shown as popups.
+     */
     additionalOptions?: UpdatableWindowOptions;
+    /**
+     * 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.
+     */
     name?: string;
+    /**
+     * Navigates to this `url` if showing an existing window as a popup, otherwise the newly created window will load this `url`.
+     */
     url?: string;
+    /**
+     * Height of the popup window in pixels (takes priority over `intialOptions` size properties).
+     * @defaultValue 300
+     */
     height?: number;
+    /**
+     * Width of the popup window in pixels (takes priority over `intialOptions` size properties).
+     * @defaultValue 300
+     */
     width?: number;
+    /**
+     * Left position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
+     * @defaultValue 0
+     */
     x?: number;
+    /**
+     * Top position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
+     * @defaultValue 0
+     */
     y?: number;
+    /**
+     * Determines what happens if the popup window is blurred.
+     * * 'modal' restricts resizing and positioning in the caller.
+     * * 'hide' hides the popup window on blur.
+     * * 'close' closes the popup window on blur.
+     * @defaultValue 'close'
+     */
     blurBehavior?: PopupBlurBehavior;
+    /**
+     * Determines what happens when the popup window calls `dispatchPopupResult`.
+     * * 'none' will do nothing.
+     * * 'hide' hides the popup window on `dispatchPopupResult`.
+     * * 'close' closes the popup window on `dispatchPopupResult`.
+     * @defaultValue 'close'
+     */
     resultDispatchBehavior?: PopupResultBehavior;
+    /**
+     * Hide the popup window instead of closing when `close` is called on it.
+     * <br>Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
+     * @defaultValue false
+     */
     hideOnClose?: boolean;
+    /**
+     * Determines if the popup window should or should not be focused when it is shown.
+     * @defaultValue true
+     */
     focus?: boolean;
+    /**
+     * Executed when the popup window is shown. Provides the popup window to the provided function, and allows for easy access the popup window for additional behavior customization.
+     */
     onPopupReady?: (popupWindow: _Window) => any;
+    /**
+     * Executed when this window's popup calls `dispatchPopupResult`.
+     * <br>Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
+     */
     onPopupResult?: (payload: PopupResult) => any;
 }
+/**
+ * The Popup result.
+ *
+ * @typeParam T - Type of data the Popup result contains
+ */
 declare interface PopupResult<T = any> {
+    /**
+     * `name` and `uuid` of the popup window that called dispatched this result.
+     */
     identity: {
         name: string;
         uuid: string;
     };
+    /**
+     * Result of the user interaction with the popup window.
+     */
     result: PopupInteraction;
+    /**
+     * Data passed to `dispatchPopupResult`.
+     */
     data?: T;
+    /**
+     * The last dispatch result.
+     */
     lastDispatchResult?: PopupResult;
 }
 declare type PopupResultBehavior = 'none' | PopupBaseBehavior;
+/**
+ * @interface
+ */
 declare type Position = TransitionBase & {
     /**
      * Defaults to the window's current left position in virtual screen coordinates.
@@ -9270,6 +9638,26 @@ declare type Position = TransitionBase & {
     top: number;
 };
+/**
+ * Leveraged by the following windowing apis to influence side effects of the positioning.
+ * - {@link  OpenFin.Window.moveBy}
+ * - {@link  OpenFin.Window.moveTo}
+ * - {@link  OpenFin.Window.setBounds}
+ * - {@link  OpenFin.Window.resizeBy}
+ * - {@link  OpenFin.Window.resizeTo}
+ * @example ```js
+ fin.me.setBounds({top: 50, left: 50, width: 200, height: 200}, {skipRestore: true})
+ ```
+ */
+declare interface PositioningOptions {
+    /**
+     * Windows Only.
+     * If set to true, will not restore a maximized window before setting the bounds.
+     * This will have the effect of the maximized window staying maximized and not immediately taking this new position.
+     */
+    skipRestore?: boolean;
+}
 /**
  * Context menu item with an implementation provided by OpenFin.
  */
@@ -9312,6 +9700,7 @@ declare type PreloadScriptInfoRunning = {
 /**
  * Generated after the execution of all of a window's preload scripts.
  * @remarks Contains information about all window's preload scripts' final states.
+ * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
     type: 'preload-script-state-changed';
@@ -9319,6 +9708,7 @@ declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent &
 /**
  * A general preload scripts state change event without event type.
+ * @interface
  */
 declare type PreloadScriptsStateChangeEvent = NamedEvent & {
     preloadScripts: (PreloadScriptInfoRunning & any)[];
@@ -9327,6 +9717,7 @@ declare type PreloadScriptsStateChangeEvent = NamedEvent & {
 /**
  * Generated during the execution of a window's preload script.
  * @remarks Contains information about a single window's preload script's state, for which the event has been raised.
+ * @interface
  */
 declare type PreloadScriptsStateChangingEvent = PreloadScriptsStateChangeEvent & {
     type: 'preload-script-state-changing';
@@ -9463,10 +9854,25 @@ declare type ProcessDetails = {
     pid: number;
 };
+/**
+ * Process logging options
+ */
 declare interface ProcessLoggingOptions {
+    /**
+     * Periodic Logging Interval (in seconds)
+     */
     interval?: number;
+    /**
+     * Outlier Detection options
+     */
     outlierDetection?: {
+        /**
+         * Outlier Interval (in seconds)
+         */
         interval?: number;
+        /**
+         * Number of Process Info entries to collect for outlier analysis
+         */
         entries?: number;
     };
 }
@@ -9709,6 +10115,25 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'set-domain-settings': ApiCall<OpenFin_2.ApplicationIdentity & {
         domainSettings: OpenFin_2.DefaultDomainSettings;
     }, void>;
+    'move-window-by': IdentityCall<WithPositioningOptions<{
+        deltaLeft: number;
+        deltaTop: number;
+    }>>;
+    'move-window': IdentityCall<WithPositioningOptions<{
+        left: number;
+        top: number;
+    }>>;
+    'resize-window-by': IdentityCall<WithPositioningOptions<{
+        deltaWidth: number;
+        deltaHeight: number;
+        anchor: OpenFin_2.AnchorType;
+    }>>;
+    'resize-window': IdentityCall<WithPositioningOptions<{
+        width: number;
+        height: number;
+        anchor: OpenFin_2.AnchorType;
+    }>>;
+    'set-window-bounds': IdentityCall<WithPositioningOptions<Partial<OpenFin_2.Bounds>>>;
 }
 declare interface ProtocolMapBase {
@@ -9740,12 +10165,11 @@ declare type ProviderIdentity_5 = OpenFin_2.ProviderIdentity;
 declare type ProviderIdentity_6 = OpenFin_2.ProviderIdentity;
-declare type ProviderIdentity_7 = OpenFin_2.ProviderIdentity;
 /**
  * Identity of a channel provider.
+ * @interface
  */
-declare type ProviderIdentity_8 = Identity_5 & {
+declare type ProviderIdentity_7 = Identity_5 & {
     /**
      * Identifier of the channel.
      */
@@ -9812,6 +10236,9 @@ declare type QueryPermissionResult = {
     rawValue?: unknown;
 };
+/**
+ * @interface
+ */
 declare type ReadImageClipboardRequest = BaseClipboardRequest & ImageFormatOptions;
 /**
@@ -9847,6 +10274,7 @@ declare type RectangleByEdgePositions = {
 /**
  * Generated when a hotkey has been registered with the operating system.
+ * @interface
  */
 declare type RegisteredEvent = BaseEvent & {
     type: 'registered';
@@ -9869,6 +10297,7 @@ declare type RegistryInfo_2 = {
 /**
  * Generated when a window has been reloaded.
+ * @interface
  */
 declare type ReloadedEvent = NamedEvent & {
     type: 'reloaded';
@@ -9954,6 +10383,7 @@ declare type ResizeRegion = {
 /**
  * Generated when an HTTP load was cancelled or failed.
+ * @interface
  */
 declare type ResourceLoadFailedEvent = BaseLoadFailedEvent & {
     type: 'resource-load-failed';
@@ -9961,6 +10391,7 @@ declare type ResourceLoadFailedEvent = BaseLoadFailedEvent & {
 /**
  * Generated when an HTTP resource request has received response details.
+ * @interface
  */
 declare type ResourceResponseReceivedEvent = NamedEvent & {
     type: 'resource-response-received';
@@ -9976,6 +10407,7 @@ declare type ResourceResponseReceivedEvent = NamedEvent & {
 /**
  * Generated when an application is responding.
+ * @interface
  */
 declare type RespondingEvent = IdentityEvent & {
     type: 'responding';
@@ -9989,7 +10421,10 @@ declare type RGB = {
     green: number;
 };
-declare type RoutingInfo = ProviderIdentity_3 & {
+/**
+ * @interface
+ */
+declare type RoutingInfo = OpenFin_2.ProviderIdentity & {
     endpointId: string;
 };
@@ -10015,7 +10450,7 @@ declare interface RTCProtocolOffer extends ProtocolPacketBase {
 declare class RTCStrategy implements ChannelStrategy<RTCStrategyEndpointPayload> {
     #private;
     onEndpointDisconnect(endpointId: string, listener: () => void): void;
-    receive(listener: (action: string, payload: any, identity: OpenFin_2.ClientIdentity | OpenFin_2.ClientIdentityMultiRuntime | ProviderIdentity_6) => Promise<any>): void;
+    receive(listener: (action: string, payload: any, identity: OpenFin_2.ClientIdentity | OpenFin_2.ClientIdentityMultiRuntime | ProviderIdentity_5) => Promise<any>): void;
     send: (endpointId: string, action: string, payload: any) => Promise<any>;
     close: () => Promise<void>;
     private getEndpointById;
@@ -10027,7 +10462,7 @@ declare class RTCStrategy implements ChannelStrategy<RTCStrategyEndpointPayload>
 }
 declare interface RTCStrategyEndpointPayload {
-    endpointIdentity: OpenFin_2.ClientIdentity | ProviderIdentity_6;
+    endpointIdentity: OpenFin_2.ClientIdentity | ProviderIdentity_5;
     rtc: RTCPacket;
 }
@@ -10035,6 +10470,7 @@ declare type RunRequestedEvent = OpenFin_2.ApplicationEvents.RunRequestedEvent;
 /**
  * Generated when Application.run() is called for an already running application.
+ * @interface
  */
 declare type RunRequestedEvent_2 = IdentityEvent & {
     type: 'run-requested';
@@ -10186,6 +10622,7 @@ declare type ServiceIdentifier = {
 /**
  * Generated on changes to a user’s local computer session.
+ * @interface
  */
 declare type SessionChangedEvent = {
     type: 'session-changed';
@@ -10236,12 +10673,16 @@ declare type ShortCutConfig = {
     systemStartup?: boolean;
 };
+/**
+ * @interface
+ */
 declare type ShortcutOverride = Hotkey & {
     command: string;
 };
 /**
  * Generated when a View is shown. This event will fire during creation of a View.
+ * @interface
  */
 declare type ShownEvent = BaseViewEvent & {
     type: 'shown';
@@ -10255,6 +10696,7 @@ declare type ShowPopupMenuOptions<T extends unknown = unknown> = {
 /**
  * _Platform Windows Only_. Enables views to be shown when a Platform Window is being resized by the user.
+ * @interface
  */
 declare type ShowViewOnWindowResizeOptions = ViewVisibilityOption & {
     /**
@@ -10271,6 +10713,9 @@ declare type ShowViewOnWindowResizeOptions = ViewVisibilityOption & {
     paintIntervalMs?: number;
 };
+/**
+ * @interface
+ */
 declare type Size = TransitionBase & {
     /**
      * Optional if height is present. Defaults to the window's current width.
@@ -10347,6 +10792,9 @@ declare class SnapshotSource<T = any> extends Base {
     applySnapshot(snapshot: T): Promise<void>;
 }
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link SnapshotSource} class, available under `fin.SnapshotSource`.
+ */
 declare class SnapshotSourceModule extends Base {
     /**
      * Initializes a SnapshotSource with the getSnapshot and applySnapshot methods defined.
@@ -10425,6 +10873,7 @@ declare type SplitterItem = GoldenLayout.ContentItem & {
 /**
  * Generated when an application has started.
+ * @interface
  */
 declare type StartedEvent = IdentityEvent & {
     type: 'started';
@@ -11883,7 +12332,10 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
 }
 /**
- * A system event.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link System}.  Events are
+ *  discriminated by {@link SystemEvent.type | their type}.  Event payloads unique to `System` can be found
+ *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
+ *  from which they propagate).
  */
 declare type SystemEvent = {
     topic: 'system';
@@ -12153,12 +12605,16 @@ declare type TargetApp = string | AppMetadata;
  * Generated when a View changes its window target.
  * @remarks This event will fire during creation of a View.
  * In that case, previousTarget identity will be the same as target identity.
+ * @interface
  */
 declare type TargetChangedEvent = BaseViewEvent & {
     type: 'target-changed';
     previousTarget: OpenFin_2.Identity;
 };
+/**
+ * @interface
+ */
 declare type TaskBar = DipScaleRects & {
     /**
      * Which edge of a monitor the taskbar is on
@@ -12281,6 +12737,7 @@ declare class Transport<MeType extends EntityType_3 = EntityType_3> extends Even
 /**
  * Generated when the tray icon is clicked.
+ * @interface
  */
 declare type TrayIconClickedEvent = IdentityEvent & {
     type: 'tray-icon-clicked';
@@ -12332,6 +12789,7 @@ declare interface TypedEventEmitter<Event extends {
 /**
  * Generated when a hotkey has been unregistered with the operating system.
+ * @interface
  */
 declare type UnregisteredEvent = BaseEvent & {
     type: 'unregistered';
@@ -12348,6 +12806,7 @@ declare type UpdatableWindowOptions = Partial<MutableWindowOptions>;
  * Generated when navigation or redirect is completed.
  * @remarks Also emitted for in-page navigations, examples of this occurring are when anchor links are clicked or when the DOM hashchange event is triggered, indicated by isInPage=true.
  * Note that navigating to a url with an anchor in it like http://openfin.co/#my-inpage-anchor will fire 2 events indicating the original navigation (isInPage=false) and then the in-page navigation event (isInPage=true).
+ * @interface
  */
 declare type UrlChangedEvent = BaseUrlEvent & ({
     isInPage: true;
@@ -12359,6 +12818,7 @@ declare type UrlChangedEvent = BaseUrlEvent & ({
 /**
  * A general user bounds change event without event type.
+ * @interface
  */
 declare type UserBoundsChangeEvent = NamedEvent & {
     height: number;
@@ -12370,6 +12830,7 @@ declare type UserBoundsChangeEvent = NamedEvent & {
 /**
  * Generated when a window's user movement becomes disabled.
+ * @interface
  */
 declare type UserMovementDisabledEvent = NamedEvent & {
     type: 'user-movement-disabled';
@@ -12377,6 +12838,7 @@ declare type UserMovementDisabledEvent = NamedEvent & {
 /**
  * Generated when a window's user movement becomes enabled.
+ * @interface
  */
 declare type UserMovementEnabledEvent = NamedEvent & {
     type: 'user-movement-enabled';
@@ -12949,6 +13411,7 @@ declare interface ViewComponent extends GoldenLayout.ContentItem {
  *
  * Note that `name` and `target` are the only required properties — albeit the `url` property is usually provided as well
  * (defaults to `"about:blank"` when omitted).
+ * @interface
  */
 declare type ViewCreationOptions = Partial<ViewOptions> & {
     name: string;
@@ -12961,6 +13424,7 @@ declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformVi
 /**
  * Generated when a window has a view detached from it.
  * @remarks Will fire when a view is destroyed in which case `target` will be null.
+ * @interface
  */
 declare type ViewDetachedEvent = NamedEvent & BaseViewEvent & {
     type: 'view-detached';
@@ -12968,7 +13432,9 @@ declare type ViewDetachedEvent = NamedEvent & BaseViewEvent & {
 };
 /**
- * A View event.
+ *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link View}.  Events are
+ *  discriminated by {@link ViewEvent.type | their type}.  Event payloads unique to `View` can be found
+ *  under the {@link OpenFin.ViewEvents} namespace (except for {@link OpenFin.WebContentsEvents | those shared with other WebContents}).
  */
 declare type ViewEvent = {
     topic: 'view';
@@ -12984,7 +13450,7 @@ declare namespace ViewEvents {
         AttachedEvent,
         CreatedEvent,
         DestroyedEvent,
-        HiddenEvent_2 as HiddenEvent,
+        HiddenEvent,
         HotkeyEvent,
         ShownEvent,
         WillPropagateViewEvent,
@@ -13009,6 +13475,9 @@ declare type ViewInfo = {
     favicons: string[];
 };
+/**
+ * Static namespace for OpenFin API methods that interact with the {@link View} class, available under `fin.View`.
+ */
 declare class ViewModule extends Base {
     /**
      * Creates a new View.
@@ -13091,6 +13560,7 @@ declare class ViewModule extends Base {
 /**
  * User-facing options for a view.
+ * @interface
  */
 declare type ViewOptions = ConstViewOptions & MutableViewOptions;
@@ -13128,6 +13598,9 @@ declare class ViewOverlay {
     setIgnoreViewMouseEvents(enabled: boolean): Promise<void>;
 }
+/**
+ * Represents the payload shape for Views that are trying to prevent an unload.
+ */
 declare interface ViewsPreventingUnloadPayload {
     /**
      * Specifies if the Window should close.
@@ -13151,6 +13624,9 @@ declare interface ViewsPreventingUnloadPayload {
     closeType: 'view' | 'window';
 }
+/**
+ * @interface
+ */
 declare type ViewState = ViewCreationOptions & {
     backgroundThrottling: boolean;
     componentName: 'view';
@@ -13158,6 +13634,9 @@ declare type ViewState = ViewCreationOptions & {
     minWidth?: number;
 };
+/**
+ * The statuses of views specifying which of them are trying to prevent an unload and which are not.
+ */
 declare interface ViewStatuses {
     /**
      * Identities of the Views that are preventing an unload.
@@ -14120,6 +14599,7 @@ declare type WebRequestHeader = {
 /**
  * Generated when a window is being moved by the user.
  * @remarks For use with monitor scaling that is not 100%. Bounds are given in DIP (adjusted for monitor scale factor).
+ * @interface
  */
 declare type WillMoveEvent = WillMoveOrResizeEvent & {
     type: 'will-move';
@@ -14127,6 +14607,7 @@ declare type WillMoveEvent = WillMoveOrResizeEvent & {
 /**
  * A general will-move or will-resize event without event type.
+ * @interface
  */
 declare type WillMoveOrResizeEvent = NamedEvent & {
     height: number;
@@ -14144,7 +14625,7 @@ declare type WillPropagateApplicationEvent = ClosedEvent | ApplicationConnectedE
 /**
  * A View event that does propagate to (republish on) parent topics.
  */
-declare type WillPropagateViewEvent = (WillPropagateWebContentsEvent & BaseViewEvent) | AttachedEvent | CreatedEvent | DestroyedEvent | HiddenEvent_2 | HotkeyEvent | ShownEvent | TargetChangedEvent;
+declare type WillPropagateViewEvent = (WillPropagateWebContentsEvent & BaseViewEvent) | AttachedEvent | CreatedEvent | DestroyedEvent | HiddenEvent | HotkeyEvent | ShownEvent | TargetChangedEvent;
 /**
  * A WebContents event that does propagate to (republish on) parent topics.
@@ -14154,10 +14635,11 @@ declare type WillPropagateWebContentsEvent = BlurredEvent | CertificateSelection
 /**
  * A Window event that does propagate to (republish on) parent topics.
  */
-declare type WillPropagateWindowEvent = WillPropagateWebContentsEvent | PropagatedViewAttachedEvent | ViewDetachedEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | WindowCloseRequestedEvent | WindowClosedEvent | WindowClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent | WindowHotkeyEvent | WindowInitializedEvent | LayoutInitializedEvent | LayoutReadyEvent | MaximizedEvent | MinimizedEvent | WindowOptionsChangedEvent_2 | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | WindowRestoredEvent | WindowShowRequestedEvent | WindowShownEvent | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillRedirectEvent | WillResizeEvent;
+declare type WillPropagateWindowEvent = WillPropagateWebContentsEvent | PropagatedViewAttachedEvent | ViewDetachedEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | WindowCloseRequestedEvent | WindowClosedEvent | WindowClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | WindowHiddenEvent | WindowHotkeyEvent | WindowInitializedEvent | LayoutInitializedEvent | LayoutReadyEvent | MaximizedEvent | MinimizedEvent | WindowOptionsChangedEvent_2 | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | WindowRestoredEvent | WindowShowRequestedEvent | WindowShownEvent | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillRedirectEvent | WillResizeEvent;
 /**
  * Generated when window is being redirected as per contentRedirect allowlist/denylist rules.
+ * @interface
  */
 declare type WillRedirectEvent = NamedEvent & {
     type: 'will-redirect';
@@ -14170,6 +14652,7 @@ declare type WillRedirectEvent = NamedEvent & {
  * Generated when a window is being resized by the user.
  * @remarks For use with monitor scaling that is not 100%. Bounds are given in DIP (adjusted for monitor scale factor).
  * The event will fire when a user resize is blocked by window options such as maxWidth or minHeight but not if the window is not resizable.
+ * @interface
  */
 declare type WillResizeEvent = WillMoveOrResizeEvent & {
     type: 'will-resize';
@@ -15241,7 +15724,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * moveBy(580, 300).then(() => console.log('Moved')).catch(err => console.log(err));
      * ```
      */
-    moveBy(deltaLeft: number, deltaTop: number): Promise<void>;
+    moveBy(deltaLeft: number, deltaTop: number, positioningOptions?: OpenFin_2.PositioningOptions): Promise<void>;
     /**
      * Moves the window to a specified location.
      * @param left The left position of the window
@@ -15267,7 +15750,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * moveTo(580, 300).then(() => console.log('Moved')).catch(err => console.log(err))
      * ```
      */
-    moveTo(left: number, top: number): Promise<void>;
+    moveTo(left: number, top: number, positioningOptions?: OpenFin_2.PositioningOptions): Promise<void>;
     /**
      * Resizes the window by a specified amount.
      * @param deltaWidth The change in the width of the window
@@ -15296,7 +15779,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * resizeBy(580, 300, 'top-right').then(() => console.log('Resized')).catch(err => console.log(err));
      * ```
      */
-    resizeBy(deltaWidth: number, deltaHeight: number, anchor: OpenFin_2.AnchorType): Promise<void>;
+    resizeBy(deltaWidth: number, deltaHeight: number, anchor: OpenFin_2.AnchorType, positioningOptions?: OpenFin_2.PositioningOptions): Promise<void>;
     /**
      * Resizes the window to the specified dimensions.
      * @param width The change in the width of the window
@@ -15325,7 +15808,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * resizeTo(580, 300, 'top-left').then(() => console.log('Resized')).catch(err => console.log(err));
      * ```
      */
-    resizeTo(width: number, height: number, anchor: OpenFin_2.AnchorType): Promise<void>;
+    resizeTo(width: number, height: number, anchor: OpenFin_2.AnchorType, positioningOptions?: OpenFin_2.PositioningOptions): Promise<void>;
     /**
      * Restores the window to its normal state (i.e., unminimized, unmaximized).
      *
@@ -15376,7 +15859,6 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
     setAsForeground(): Promise<void>;
     /**
      * 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
@@ -15403,7 +15885,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * }).then(() => console.log('Bounds set to window')).catch(err => console.log(err));
      * ```
      */
-    setBounds(bounds: Partial<OpenFin_2.Bounds>): Promise<void>;
+    setBounds(bounds: Partial<OpenFin_2.Bounds>, positioningOptions?: OpenFin_2.PositioningOptions): Promise<void>;
     /**
      * Shows the window if it is hidden.
      * @param force Show will be prevented from showing when force is false and
@@ -15612,6 +16094,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      */
     closePopupMenu(): Promise<void>;
     /**
+     * @PORTED
      * @typedef {object} PopupOptions@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`.
@@ -15629,6 +16112,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
              * @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@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.
@@ -15694,6 +16178,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when an alert is fired and suppressed due to the customWindowAlert flag being true.
+      * @interface
       */
      declare type WindowAlertRequestedEvent = NamedEvent & {
          type: 'window-alert-requested';
@@ -15701,6 +16186,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Returned from getBounds call. bottom and right are never used for setting.
+      * @interface
       */
      declare type WindowBounds = Bounds & {
          bottom: number;
@@ -15709,6 +16195,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a window has closed.
+      * @interface
       */
      declare type WindowClosedEvent = NamedEvent & {
          type: 'closed';
@@ -15717,6 +16204,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a window has been prevented from closing.
       * @remarks A window will be prevented from closing by default, either through the API or by a user when ‘close-requested’ has been subscribed to and the Window.close(force) flag is false.
+      * @interface
       */
      declare type WindowCloseRequestedEvent = NamedEvent & {
          type: 'close-requested';
@@ -15724,6 +16212,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a window has initiated the closing routine.
+      * @interface
       */
      declare type WindowClosingEvent = NamedEvent & {
          type: 'closing';
@@ -15731,6 +16220,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a child window is created.
+      * @interface
       */
      declare type WindowCreatedEvent = NamedEvent & {
          type: 'window-created';
@@ -15741,6 +16231,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
       *
       * Note that `name` is the only required property — albeit the `url` property is usually provided as well
       * (defaults to `"about:blank"` when omitted).
+      * @interface
       */
      declare type WindowCreationOptions = Partial<WindowOptions> & {
          name: string;
@@ -15767,7 +16258,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
           */
          name: string;
          /**
-          * The right-most coordinate of the window
+          * The right-most coordinate of the window.
           */
          right: number;
          state: string;
@@ -15783,13 +16274,16 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a child window ends loading.
+      * @interface
       */
      declare type WindowEndLoadEvent = NamedEvent & {
          type: 'window-end-load';
      };
      /**
-      * A Window event.
+      *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
+      *  discriminated by {@link WindowEvent.type | their type}.  Event payloads unique to `Window` can be found
+      *  under the {@link OpenFin.WindowEvents} namespace (except for {@link OpenFin.WebContentsEvents | those shared with other WebContents}).
       */
      declare type WindowEvent = {
          topic: 'window';
@@ -15807,7 +16301,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
              WindowOptionsChangedEvent_2 as WindowOptionsChangedEvent,
              ExternalProcessExitedEvent,
              ExternalProcessStartedEvent,
-             HiddenEvent,
+             WindowHiddenEvent,
              PreloadScriptInfoRunning,
              PreloadScriptInfo,
              PreloadScriptsStateChangeEvent,
@@ -15857,9 +16351,19 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
       */
      declare type WindowEventType = WindowEvent['type'];
+     /**
+      * Generated when a window has been hidden.
+      * @interface
+      */
+     declare type WindowHiddenEvent = NamedEvent & {
+         type: 'hidden';
+         reason: 'closing' | 'hide' | 'hide-on-close';
+     };
      /**
       * Generated when a keyboard shortcut defined in the `hotkeys` array in [Window options](OpenFin.WindowOptions.html) is pressed inside the window.
       * @remarks For reference on keyboard event properties see [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent).
+      * @interface
       */
      declare type WindowHotkeyEvent = InputEvent_2 & NamedEvent & {
          type: 'hotkey';
@@ -15875,11 +16379,15 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a window is initialized.
+      * @interface
       */
      declare type WindowInitializedEvent = NamedEvent & {
          type: 'initialized';
      };
+     /**
+      * Static namespace for OpenFin API methods that interact with the {@link _Window} class, available under `fin.Window`.
+      */
      declare class _WindowModule extends Base {
          /**
           * Asynchronously returns a Window object that represents an existing window.
@@ -15970,6 +16478,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a child window is not responding.
+      * @interface
       */
      declare type WindowNotRespondingEvent = NamedEvent & {
          type: 'window-not-responding';
@@ -15982,6 +16491,9 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
          };
      };
+     /**
+      * @interface
+      */
      declare type WindowOptions = MutableWindowOptions & ConstWindowOptions;
      declare type WindowOptionsChangedEvent = OpenFin_2.WindowEvents.WindowOptionsChangedEvent;
@@ -15989,6 +16501,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated after window options are changed using the window.updateOptions method.
       * @remarks Will not fire if the diff object is empty.
+      * @interface
       */
      declare type WindowOptionsChangedEvent_2 = NamedEvent & {
          type: 'options-changed';
@@ -16000,6 +16513,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a child window is responding.
+      * @interface
       */
      declare type WindowRespondingEvent = NamedEvent & {
          type: 'window-responding';
@@ -16007,6 +16521,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a window is displayed after having been minimized or when a window leaves the maximize state without minimizing.
+      * @interface
       */
      declare type WindowRestoredEvent = NamedEvent & {
          type: 'restored';
@@ -16014,6 +16529,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a hidden window has been shown.
+      * @interface
       */
      declare type WindowShownEvent = NamedEvent & {
          type: 'shown';
@@ -16022,6 +16538,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a window has been prevented from showing.
       * @remarks A window will be prevented from showing by default, either through the API or by a user when ‘show-requested’ has been subscribed to on the window or 'window-show-requested' on the parent application and the Window.show(force) flag is false.
+      * @interface
       */
      declare type WindowShowRequestedEvent = NamedEvent & {
          type: 'show-requested';
@@ -16029,6 +16546,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * Generated when a child window starts loading.
+      * @interface
       */
      declare type WindowStartLoadEvent = NamedEvent & {
          type: 'window-start-load';
@@ -16064,6 +16582,10 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /* Excluded from this release type: WithoutId */
+     declare type WithPositioningOptions<T extends {} = {}> = T & {
+         positioningOptions?: OpenFin_2.PositioningOptions;
+     };
      declare type WorkspacePlatformOptions = {
          /** Leaving this as any for now until we figure out what the shape should look like in Workspace */
          [key: string]: any;
@@ -16071,6 +16593,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * A generic request to write any supported data to the clipboard.
+      * @interface
       */
      declare type WriteAnyClipboardRequest = BaseClipboardRequest & {
          data: {
@@ -16089,6 +16612,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      /**
       * A request to write data to the clipboard.
+      * @interface
       */
      declare type WriteClipboardRequest = BaseClipboardRequest & {
          /**
@@ -16097,6 +16621,9 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
          data: string;
      };
+     /**
+      * @interface
+      */
      declare type WriteImageClipboardRequest = BaseClipboardRequest & {
          /**
           * Can be either a base64 string, or a DataURL string. If using DataURL, the