@openfin/core 34.78.74 → 34.78.76

package/out/mock-alpha.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
 };
@@ -875,7 +884,7 @@ declare type ApplicationConnectedEvent = ConnectedEvent_2;
  * Generated when an application is created.
  * @interface
  */
-declare type ApplicationCreatedEvent = BaseEvent_8 & BaseEvents.IdentityEvent & {
+declare type ApplicationCreatedEvent = BaseEvent_9 & BaseEvents.IdentityEvent & {
     type: 'application-created';
 };
 
@@ -1733,13 +1742,30 @@ declare type BaseContentCreationRule = {
 /**
  * A base OpenFin event.  All OpenFin event payloads extend this type.
  *
+ * OpenFin events are jointly discriminated by their {@link topic} and {@link type} keys.  Within each
+ * `topic`, the `type` key is unique.
+ *
  * @interface
  */
 declare type BaseEvent = {
+    /**
+     * The "kebab-case" classname of the {@link OpenFin.Events emitter} that raised the event.
+     *
+     * @remarks {@link OpenFin.Frame} is represented as `iframe`.
+     */
     topic: string;
+    /**
+     * The type of event that was raised.  Equal to the typename of the event payload in "kebab case".
+     *
+     * @remarks Guaranteed to be unique within each {@link topic}, but can be repeated
+     * between topics (e.g. {@link OpenFin.WebContentsEvents.CrashedEvent WebContentsEvents.CrashedEvent} and
+     * {@link OpenFin.ApplicationEvents.CrashedEvent ApplicationEvents.CrashedEvent}).
+     */
     type: string;
 };
 
+declare type BaseEvent_10 = Events.BaseEvents.BaseEvent;
+
 /**
  * A base Channel event.
  * @interface
@@ -1792,14 +1818,22 @@ declare type BaseEvent_7 = NamedEvent & {
 };
 
 /**
- * Base type for events emitting on the `system` topic
+ * Base type for events emitting on the `global-hotkey` topic.
+ *
  * @interface
  */
 declare type BaseEvent_8 = BaseEvents.BaseEvent & {
-    topic: 'system';
+    topic: 'global-hotkey';
+    hotkey: string;
 };
 
-declare type BaseEvent_9 = Events.BaseEvents.BaseEvent;
+/**
+ * Base type for events emitting on the `system` topic
+ * @interface
+ */
+declare type BaseEvent_9 = BaseEvents.BaseEvent & {
+    topic: 'system';
+};
 
 declare namespace BaseEvents {
     export {
@@ -4450,6 +4484,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -4598,7 +4658,7 @@ declare interface DesktopAgent_2 {
  * Generated when the desktop icon is clicked while it's already running.
  * @interface
  */
-declare type DesktopIconClickedEvent = BaseEvent_8 & {
+declare type DesktopIconClickedEvent = BaseEvent_9 & {
     type: 'desktop-icon-clicked';
 };
 
@@ -5131,14 +5191,14 @@ declare type ErrorPlainObject = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Platform` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Platform` can be found
  *  under the {@link OpenFin.PlatformEvents} namespace.
  */
 declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotAppliedEvent;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5146,7 +5206,7 @@ declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>>
 
 /**
  * [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 Event.type | their type}.  Event payloads unique to `Channel` can be found
+ * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
  * under the {@link OpenFin.ChannelEvents} namespace.
  */
 declare type Event_2 = {
@@ -5155,7 +5215,7 @@ declare type Event_2 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Application` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5163,7 +5223,7 @@ declare type Event_3 = ViewEvents.PropagatedEvent<'application'> | WindowEvents.
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `View` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_4 = (WebContentsEvents.Event<'view'> & {
@@ -5180,21 +5240,21 @@ declare type Event_5<Topic extends string> = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Window` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_6 = WindowSourcedEvent | WindowViewEvent | ViewEvents.PropagatedEvent<'window'>;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `ExternalApplication` can be found
  *  under the {@link OpenFin.ExternalApplicationEvents} namespace.
  */
 declare type Event_7 = ConnectedEvent_3 | DisconnectedEvent_2;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Frame` can be found
  *  under the {@link OpenFin.FrameEvents} namespace.
  */
 declare type Event_8 = {
@@ -5203,13 +5263,10 @@ declare type Event_8 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
  *  under the {@link OpenFin.GlobalHotkeyEvents} namespace.
  */
-declare type Event_9 = {
-    topic: 'global-hotkey';
-    hotkey: 'string';
-} & (RegisteredEvent | UnregisteredEvent);
+declare type Event_9 = RegisteredEvent | UnregisteredEvent;
 
 declare class EventAggregator extends EmitterMap {
     dispatchEvent: (message: Message<any>) => boolean;
@@ -6208,6 +6265,7 @@ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
 
 declare namespace GlobalHotkeyEvents {
     export {
+        BaseEvent_8 as BaseEvent,
         RegisteredEvent,
         UnregisteredEvent,
         Event_9 as Event,
@@ -6695,7 +6753,7 @@ declare type IdleEvent = IdleStateChangedEvent;
  * A user returns from idle state when the computer is unlocked or keyboard/mouse activity has resumed.
  * @interface
  */
-declare type IdleStateChangedEvent = BaseEvent_8 & {
+declare type IdleStateChangedEvent = BaseEvent_9 & {
     type: 'idle-state-changed';
     elapsedTime: number;
     isIdle: boolean;
@@ -7722,7 +7780,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9622,10 +9680,17 @@ declare type MonitorInfo = {
  * The available space of a monitor defines a rectangle that is not occupied by the taskbar
  * @interface
  */
-declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
+declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10341,6 +10406,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10356,7 +10422,7 @@ declare namespace OpenFin_2 {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
-        BaseEvent_9 as BaseEvent,
+        BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
         ApplicationEvent_2 as ApplicationEvent,
@@ -12815,7 +12881,7 @@ declare type RectangleByEdgePositions = {
  * Generated when a hotkey has been registered with the operating system.
  * @interface
  */
-declare type RegisteredEvent = BaseEvent & {
+declare type RegisteredEvent = BaseEvent_8 & {
     type: 'registered';
 };
 
@@ -13237,7 +13303,7 @@ declare type ServiceIdentifier = {
  * Generated on changes to a user’s local computer session.
  * @interface
  */
-declare type SessionChangedEvent = BaseEvent_8 & {
+declare type SessionChangedEvent = BaseEvent_9 & {
     type: 'session-changed';
     reason: 'lock' | 'unlock' | 'remote-connect' | 'remote-disconnect' | 'unknown';
 };
@@ -15231,7 +15297,7 @@ declare namespace SystemEvents {
     export {
         NotRequested,
         ExcludeRequested,
-        BaseEvent_8 as BaseEvent,
+        BaseEvent_9 as BaseEvent,
         IdleStateChangedEvent,
         IdleEvent,
         MonitorInfoChangedEvent,
@@ -15709,7 +15775,7 @@ declare interface TypedEventEmitter<Event extends {
  * Generated when a hotkey has been unregistered with the operating system.
  * @interface
  */
-declare type UnregisteredEvent = BaseEvent & {
+declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 

package/out/mock-beta.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
 };
@@ -875,7 +884,7 @@ declare type ApplicationConnectedEvent = ConnectedEvent_2;
  * Generated when an application is created.
  * @interface
  */
-declare type ApplicationCreatedEvent = BaseEvent_8 & BaseEvents.IdentityEvent & {
+declare type ApplicationCreatedEvent = BaseEvent_9 & BaseEvents.IdentityEvent & {
     type: 'application-created';
 };
 
@@ -1733,13 +1742,30 @@ declare type BaseContentCreationRule = {
 /**
  * A base OpenFin event.  All OpenFin event payloads extend this type.
  *
+ * OpenFin events are jointly discriminated by their {@link topic} and {@link type} keys.  Within each
+ * `topic`, the `type` key is unique.
+ *
  * @interface
  */
 declare type BaseEvent = {
+    /**
+     * The "kebab-case" classname of the {@link OpenFin.Events emitter} that raised the event.
+     *
+     * @remarks {@link OpenFin.Frame} is represented as `iframe`.
+     */
     topic: string;
+    /**
+     * The type of event that was raised.  Equal to the typename of the event payload in "kebab case".
+     *
+     * @remarks Guaranteed to be unique within each {@link topic}, but can be repeated
+     * between topics (e.g. {@link OpenFin.WebContentsEvents.CrashedEvent WebContentsEvents.CrashedEvent} and
+     * {@link OpenFin.ApplicationEvents.CrashedEvent ApplicationEvents.CrashedEvent}).
+     */
     type: string;
 };
 
+declare type BaseEvent_10 = Events.BaseEvents.BaseEvent;
+
 /**
  * A base Channel event.
  * @interface
@@ -1792,14 +1818,22 @@ declare type BaseEvent_7 = NamedEvent & {
 };
 
 /**
- * Base type for events emitting on the `system` topic
+ * Base type for events emitting on the `global-hotkey` topic.
+ *
  * @interface
  */
 declare type BaseEvent_8 = BaseEvents.BaseEvent & {
-    topic: 'system';
+    topic: 'global-hotkey';
+    hotkey: string;
 };
 
-declare type BaseEvent_9 = Events.BaseEvents.BaseEvent;
+/**
+ * Base type for events emitting on the `system` topic
+ * @interface
+ */
+declare type BaseEvent_9 = BaseEvents.BaseEvent & {
+    topic: 'system';
+};
 
 declare namespace BaseEvents {
     export {
@@ -4450,6 +4484,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -4598,7 +4658,7 @@ declare interface DesktopAgent_2 {
  * Generated when the desktop icon is clicked while it's already running.
  * @interface
  */
-declare type DesktopIconClickedEvent = BaseEvent_8 & {
+declare type DesktopIconClickedEvent = BaseEvent_9 & {
     type: 'desktop-icon-clicked';
 };
 
@@ -5131,14 +5191,14 @@ declare type ErrorPlainObject = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Platform` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Platform` can be found
  *  under the {@link OpenFin.PlatformEvents} namespace.
  */
 declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotAppliedEvent;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5146,7 +5206,7 @@ declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>>
 
 /**
  * [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 Event.type | their type}.  Event payloads unique to `Channel` can be found
+ * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
  * under the {@link OpenFin.ChannelEvents} namespace.
  */
 declare type Event_2 = {
@@ -5155,7 +5215,7 @@ declare type Event_2 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Application` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5163,7 +5223,7 @@ declare type Event_3 = ViewEvents.PropagatedEvent<'application'> | WindowEvents.
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `View` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_4 = (WebContentsEvents.Event<'view'> & {
@@ -5180,21 +5240,21 @@ declare type Event_5<Topic extends string> = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Window` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_6 = WindowSourcedEvent | WindowViewEvent | ViewEvents.PropagatedEvent<'window'>;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `ExternalApplication` can be found
  *  under the {@link OpenFin.ExternalApplicationEvents} namespace.
  */
 declare type Event_7 = ConnectedEvent_3 | DisconnectedEvent_2;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Frame` can be found
  *  under the {@link OpenFin.FrameEvents} namespace.
  */
 declare type Event_8 = {
@@ -5203,13 +5263,10 @@ declare type Event_8 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
  *  under the {@link OpenFin.GlobalHotkeyEvents} namespace.
  */
-declare type Event_9 = {
-    topic: 'global-hotkey';
-    hotkey: 'string';
-} & (RegisteredEvent | UnregisteredEvent);
+declare type Event_9 = RegisteredEvent | UnregisteredEvent;
 
 declare class EventAggregator extends EmitterMap {
     dispatchEvent: (message: Message<any>) => boolean;
@@ -6208,6 +6265,7 @@ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
 
 declare namespace GlobalHotkeyEvents {
     export {
+        BaseEvent_8 as BaseEvent,
         RegisteredEvent,
         UnregisteredEvent,
         Event_9 as Event,
@@ -6695,7 +6753,7 @@ declare type IdleEvent = IdleStateChangedEvent;
  * A user returns from idle state when the computer is unlocked or keyboard/mouse activity has resumed.
  * @interface
  */
-declare type IdleStateChangedEvent = BaseEvent_8 & {
+declare type IdleStateChangedEvent = BaseEvent_9 & {
     type: 'idle-state-changed';
     elapsedTime: number;
     isIdle: boolean;
@@ -7722,7 +7780,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9622,10 +9680,17 @@ declare type MonitorInfo = {
  * The available space of a monitor defines a rectangle that is not occupied by the taskbar
  * @interface
  */
-declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
+declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10341,6 +10406,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10356,7 +10422,7 @@ declare namespace OpenFin_2 {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
-        BaseEvent_9 as BaseEvent,
+        BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
         ApplicationEvent_2 as ApplicationEvent,
@@ -12815,7 +12881,7 @@ declare type RectangleByEdgePositions = {
  * Generated when a hotkey has been registered with the operating system.
  * @interface
  */
-declare type RegisteredEvent = BaseEvent & {
+declare type RegisteredEvent = BaseEvent_8 & {
     type: 'registered';
 };
 
@@ -13237,7 +13303,7 @@ declare type ServiceIdentifier = {
  * Generated on changes to a user’s local computer session.
  * @interface
  */
-declare type SessionChangedEvent = BaseEvent_8 & {
+declare type SessionChangedEvent = BaseEvent_9 & {
     type: 'session-changed';
     reason: 'lock' | 'unlock' | 'remote-connect' | 'remote-disconnect' | 'unknown';
 };
@@ -15231,7 +15297,7 @@ declare namespace SystemEvents {
     export {
         NotRequested,
         ExcludeRequested,
-        BaseEvent_8 as BaseEvent,
+        BaseEvent_9 as BaseEvent,
         IdleStateChangedEvent,
         IdleEvent,
         MonitorInfoChangedEvent,
@@ -15709,7 +15775,7 @@ declare interface TypedEventEmitter<Event extends {
  * Generated when a hotkey has been unregistered with the operating system.
  * @interface
  */
-declare type UnregisteredEvent = BaseEvent & {
+declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 

package/out/mock-public.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
 };
@@ -875,7 +884,7 @@ declare type ApplicationConnectedEvent = ConnectedEvent_2;
  * Generated when an application is created.
  * @interface
  */
-declare type ApplicationCreatedEvent = BaseEvent_8 & BaseEvents.IdentityEvent & {
+declare type ApplicationCreatedEvent = BaseEvent_9 & BaseEvents.IdentityEvent & {
     type: 'application-created';
 };
 
@@ -1733,13 +1742,30 @@ declare type BaseContentCreationRule = {
 /**
  * A base OpenFin event.  All OpenFin event payloads extend this type.
  *
+ * OpenFin events are jointly discriminated by their {@link topic} and {@link type} keys.  Within each
+ * `topic`, the `type` key is unique.
+ *
  * @interface
  */
 declare type BaseEvent = {
+    /**
+     * The "kebab-case" classname of the {@link OpenFin.Events emitter} that raised the event.
+     *
+     * @remarks {@link OpenFin.Frame} is represented as `iframe`.
+     */
     topic: string;
+    /**
+     * The type of event that was raised.  Equal to the typename of the event payload in "kebab case".
+     *
+     * @remarks Guaranteed to be unique within each {@link topic}, but can be repeated
+     * between topics (e.g. {@link OpenFin.WebContentsEvents.CrashedEvent WebContentsEvents.CrashedEvent} and
+     * {@link OpenFin.ApplicationEvents.CrashedEvent ApplicationEvents.CrashedEvent}).
+     */
     type: string;
 };
 
+declare type BaseEvent_10 = Events.BaseEvents.BaseEvent;
+
 /**
  * A base Channel event.
  * @interface
@@ -1792,14 +1818,22 @@ declare type BaseEvent_7 = NamedEvent & {
 };
 
 /**
- * Base type for events emitting on the `system` topic
+ * Base type for events emitting on the `global-hotkey` topic.
+ *
  * @interface
  */
 declare type BaseEvent_8 = BaseEvents.BaseEvent & {
-    topic: 'system';
+    topic: 'global-hotkey';
+    hotkey: string;
 };
 
-declare type BaseEvent_9 = Events.BaseEvents.BaseEvent;
+/**
+ * Base type for events emitting on the `system` topic
+ * @interface
+ */
+declare type BaseEvent_9 = BaseEvents.BaseEvent & {
+    topic: 'system';
+};
 
 declare namespace BaseEvents {
     export {
@@ -4450,6 +4484,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -4598,7 +4658,7 @@ declare interface DesktopAgent_2 {
  * Generated when the desktop icon is clicked while it's already running.
  * @interface
  */
-declare type DesktopIconClickedEvent = BaseEvent_8 & {
+declare type DesktopIconClickedEvent = BaseEvent_9 & {
     type: 'desktop-icon-clicked';
 };
 
@@ -5131,14 +5191,14 @@ declare type ErrorPlainObject = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Platform` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Platform` can be found
  *  under the {@link OpenFin.PlatformEvents} namespace.
  */
 declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotAppliedEvent;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5146,7 +5206,7 @@ declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>>
 
 /**
  * [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 Event.type | their type}.  Event payloads unique to `Channel` can be found
+ * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
  * under the {@link OpenFin.ChannelEvents} namespace.
  */
 declare type Event_2 = {
@@ -5155,7 +5215,7 @@ declare type Event_2 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Application` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5163,7 +5223,7 @@ declare type Event_3 = ViewEvents.PropagatedEvent<'application'> | WindowEvents.
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `View` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_4 = (WebContentsEvents.Event<'view'> & {
@@ -5180,21 +5240,21 @@ declare type Event_5<Topic extends string> = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Window` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_6 = WindowSourcedEvent | WindowViewEvent | ViewEvents.PropagatedEvent<'window'>;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `ExternalApplication` can be found
  *  under the {@link OpenFin.ExternalApplicationEvents} namespace.
  */
 declare type Event_7 = ConnectedEvent_3 | DisconnectedEvent_2;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Frame` can be found
  *  under the {@link OpenFin.FrameEvents} namespace.
  */
 declare type Event_8 = {
@@ -5203,13 +5263,10 @@ declare type Event_8 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
  *  under the {@link OpenFin.GlobalHotkeyEvents} namespace.
  */
-declare type Event_9 = {
-    topic: 'global-hotkey';
-    hotkey: 'string';
-} & (RegisteredEvent | UnregisteredEvent);
+declare type Event_9 = RegisteredEvent | UnregisteredEvent;
 
 declare class EventAggregator extends EmitterMap {
     dispatchEvent: (message: Message<any>) => boolean;
@@ -6208,6 +6265,7 @@ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
 
 declare namespace GlobalHotkeyEvents {
     export {
+        BaseEvent_8 as BaseEvent,
         RegisteredEvent,
         UnregisteredEvent,
         Event_9 as Event,
@@ -6695,7 +6753,7 @@ declare type IdleEvent = IdleStateChangedEvent;
  * A user returns from idle state when the computer is unlocked or keyboard/mouse activity has resumed.
  * @interface
  */
-declare type IdleStateChangedEvent = BaseEvent_8 & {
+declare type IdleStateChangedEvent = BaseEvent_9 & {
     type: 'idle-state-changed';
     elapsedTime: number;
     isIdle: boolean;
@@ -7722,7 +7780,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9622,10 +9680,17 @@ declare type MonitorInfo = {
  * The available space of a monitor defines a rectangle that is not occupied by the taskbar
  * @interface
  */
-declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
+declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10341,6 +10406,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10356,7 +10422,7 @@ declare namespace OpenFin_2 {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
-        BaseEvent_9 as BaseEvent,
+        BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
         ApplicationEvent_2 as ApplicationEvent,
@@ -12815,7 +12881,7 @@ declare type RectangleByEdgePositions = {
  * Generated when a hotkey has been registered with the operating system.
  * @interface
  */
-declare type RegisteredEvent = BaseEvent & {
+declare type RegisteredEvent = BaseEvent_8 & {
     type: 'registered';
 };
 
@@ -13237,7 +13303,7 @@ declare type ServiceIdentifier = {
  * Generated on changes to a user’s local computer session.
  * @interface
  */
-declare type SessionChangedEvent = BaseEvent_8 & {
+declare type SessionChangedEvent = BaseEvent_9 & {
     type: 'session-changed';
     reason: 'lock' | 'unlock' | 'remote-connect' | 'remote-disconnect' | 'unknown';
 };
@@ -15231,7 +15297,7 @@ declare namespace SystemEvents {
     export {
         NotRequested,
         ExcludeRequested,
-        BaseEvent_8 as BaseEvent,
+        BaseEvent_9 as BaseEvent,
         IdleStateChangedEvent,
         IdleEvent,
         MonitorInfoChangedEvent,
@@ -15709,7 +15775,7 @@ declare interface TypedEventEmitter<Event extends {
  * Generated when a hotkey has been unregistered with the operating system.
  * @interface
  */
-declare type UnregisteredEvent = BaseEvent & {
+declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 

package/out/mock.d.ts

@@ -88,12 +88,21 @@ declare type Api = {
     iframe?: {
         /**
          * Inject OpenFin API into cross-origin iframes
+         *
+         * @defaultValue false
          */
         crossOriginInjection?: boolean;
         /**
          * Inject OpenFin API into same-origin iframes
+         *
+         * @defaultValue true
          */
         sameOriginInjection?: boolean;
+        /**
+         * @deprecated Shared names should not be used; support is provided purely for back-compat reasons.
+         *
+         * When `true`, iframes will have the same name as their parent WebContents.
+         */
         enableDeprecatedSharedName?: boolean;
     };
 };
@@ -881,7 +890,7 @@ declare type ApplicationConnectedEvent = ConnectedEvent_2;
  * Generated when an application is created.
  * @interface
  */
-declare type ApplicationCreatedEvent = BaseEvent_8 & BaseEvents.IdentityEvent & {
+declare type ApplicationCreatedEvent = BaseEvent_9 & BaseEvents.IdentityEvent & {
     type: 'application-created';
 };
 
@@ -1753,13 +1762,30 @@ declare type BaseContentCreationRule = {
 /**
  * A base OpenFin event.  All OpenFin event payloads extend this type.
  *
+ * OpenFin events are jointly discriminated by their {@link topic} and {@link type} keys.  Within each
+ * `topic`, the `type` key is unique.
+ *
  * @interface
  */
 declare type BaseEvent = {
+    /**
+     * The "kebab-case" classname of the {@link OpenFin.Events emitter} that raised the event.
+     *
+     * @remarks {@link OpenFin.Frame} is represented as `iframe`.
+     */
     topic: string;
+    /**
+     * The type of event that was raised.  Equal to the typename of the event payload in "kebab case".
+     *
+     * @remarks Guaranteed to be unique within each {@link topic}, but can be repeated
+     * between topics (e.g. {@link OpenFin.WebContentsEvents.CrashedEvent WebContentsEvents.CrashedEvent} and
+     * {@link OpenFin.ApplicationEvents.CrashedEvent ApplicationEvents.CrashedEvent}).
+     */
     type: string;
 };
 
+declare type BaseEvent_10 = Events.BaseEvents.BaseEvent;
+
 /**
  * A base Channel event.
  * @interface
@@ -1812,14 +1838,22 @@ declare type BaseEvent_7 = NamedEvent & {
 };
 
 /**
- * Base type for events emitting on the `system` topic
+ * Base type for events emitting on the `global-hotkey` topic.
+ *
  * @interface
  */
 declare type BaseEvent_8 = BaseEvents.BaseEvent & {
-    topic: 'system';
+    topic: 'global-hotkey';
+    hotkey: string;
 };
 
-declare type BaseEvent_9 = Events.BaseEvents.BaseEvent;
+/**
+ * Base type for events emitting on the `system` topic
+ * @interface
+ */
+declare type BaseEvent_9 = BaseEvents.BaseEvent & {
+    topic: 'system';
+};
 
 declare namespace BaseEvents {
     export {
@@ -4493,6 +4527,32 @@ declare type CreateLayoutOptions = {
     container: HTMLElement;
     layoutName: string;
     layout: LayoutOptions;
+    /**
+     * @defaultValue 'default'
+     *
+     * Controls the View behavior for the given `layout` property. Note
+     * that the selected behavior only applies to unnamed Views or
+     * Views with the prefix `internal-generated-`. In all cases, if any
+     * View in the `layout` does not already exist, it will be created
+     * with a name that starts with `internal-generated-`.
+     *
+     * When set to `reparent`, Views prefixed with `internal-generated-` will
+     * be reparented to the current Window and added to this new Layout.
+     * Use this option when you need to transfer an existing Layout between Windows.
+     *
+     * When set to 'duplicate', Views prefixed with `internal-generated-` will
+     * be duplicated with new generated names. Use this option when you need
+     * to clone a Layout to any Window.
+     *
+     * When set to `default` or omitted, the Layout will attempt to re-use
+     * existing Views only if they are attached to the current Window or
+     * the Provider Window. Set to `default` or omit this option when creating
+     * Layouts as part of implementing the LayoutManager::applyLayoutSnapshot
+     * override. Note that during applyLayoutSnapshot, Views are created and
+     * attached to the Provider while the Window is being created, so it's
+     * important to not 'duplicate' Views in this workflow.
+     */
+    multiInstanceViewBehavior?: MultiInstanceViewBehavior;
 };
 
 /**
@@ -4641,7 +4701,7 @@ declare interface DesktopAgent_2 {
  * Generated when the desktop icon is clicked while it's already running.
  * @interface
  */
-declare type DesktopIconClickedEvent = BaseEvent_8 & {
+declare type DesktopIconClickedEvent = BaseEvent_9 & {
     type: 'desktop-icon-clicked';
 };
 
@@ -5179,14 +5239,14 @@ declare type ErrorPlainObject = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Platform` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Platform` can be found
  *  under the {@link OpenFin.PlatformEvents} namespace.
  */
 declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotAppliedEvent;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5194,7 +5254,7 @@ declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>>
 
 /**
  * [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 Event.type | their type}.  Event payloads unique to `Channel` can be found
+ * discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Channel` can be found
  * under the {@link OpenFin.ChannelEvents} namespace.
  */
 declare type Event_2 = {
@@ -5203,7 +5263,7 @@ declare type Event_2 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Application` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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).
  */
@@ -5211,7 +5271,7 @@ declare type Event_3 = ViewEvents.PropagatedEvent<'application'> | WindowEvents.
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `View` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_4 = (WebContentsEvents.Event<'view'> & {
@@ -5228,21 +5288,21 @@ declare type Event_5<Topic extends string> = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `Window` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.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 Event_6 = WindowSourcedEvent | WindowViewEvent | ViewEvents.PropagatedEvent<'window'>;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `ExternalApplication` can be found
  *  under the {@link OpenFin.ExternalApplicationEvents} namespace.
  */
 declare type Event_7 = ConnectedEvent_3 | DisconnectedEvent_2;
 
 /**
  *  [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
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `Frame` can be found
  *  under the {@link OpenFin.FrameEvents} namespace.
  */
 declare type Event_8 = {
@@ -5251,13 +5311,10 @@ declare type Event_8 = {
 
 /**
  *  [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 Event.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
+ *  discriminated by {@link BaseEvents.BaseEvent.type | their type}.  Event payloads unique to `GlobalHotkey` can be found
  *  under the {@link OpenFin.GlobalHotkeyEvents} namespace.
  */
-declare type Event_9 = {
-    topic: 'global-hotkey';
-    hotkey: 'string';
-} & (RegisteredEvent | UnregisteredEvent);
+declare type Event_9 = RegisteredEvent | UnregisteredEvent;
 
 declare class EventAggregator extends EmitterMap {
     dispatchEvent: (message: Message<any>) => boolean;
@@ -6283,6 +6340,7 @@ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
 
 declare namespace GlobalHotkeyEvents {
     export {
+        BaseEvent_8 as BaseEvent,
         RegisteredEvent,
         UnregisteredEvent,
         Event_9 as Event,
@@ -6773,7 +6831,7 @@ declare type IdleEvent = IdleStateChangedEvent;
  * A user returns from idle state when the computer is unlocked or keyboard/mouse activity has resumed.
  * @interface
  */
-declare type IdleStateChangedEvent = BaseEvent_8 & {
+declare type IdleStateChangedEvent = BaseEvent_9 & {
     type: 'idle-state-changed';
     elapsedTime: number;
     isIdle: boolean;
@@ -7815,7 +7873,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9899,10 +9957,17 @@ declare type MonitorInfo = {
  * The available space of a monitor defines a rectangle that is not occupied by the taskbar
  * @interface
  */
-declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
+declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10640,6 +10705,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10655,7 +10721,7 @@ declare namespace OpenFin_2 {
         AppVersionCompleteEvent,
         AppVersionRuntimeStatusEvent,
         Events,
-        BaseEvent_9 as BaseEvent,
+        BaseEvent_10 as BaseEvent,
         WebContentsEvent_2 as WebContentsEvent,
         SystemEvent_2 as SystemEvent,
         ApplicationEvent_2 as ApplicationEvent,
@@ -13192,7 +13258,7 @@ declare type RectangleByEdgePositions = {
  * Generated when a hotkey has been registered with the operating system.
  * @interface
  */
-declare type RegisteredEvent = BaseEvent & {
+declare type RegisteredEvent = BaseEvent_8 & {
     type: 'registered';
 };
 
@@ -13614,7 +13680,7 @@ declare type ServiceIdentifier = {
  * Generated on changes to a user’s local computer session.
  * @interface
  */
-declare type SessionChangedEvent = BaseEvent_8 & {
+declare type SessionChangedEvent = BaseEvent_9 & {
     type: 'session-changed';
     reason: 'lock' | 'unlock' | 'remote-connect' | 'remote-disconnect' | 'unknown';
 };
@@ -15614,7 +15680,7 @@ declare namespace SystemEvents {
     export {
         NotRequested,
         ExcludeRequested,
-        BaseEvent_8 as BaseEvent,
+        BaseEvent_9 as BaseEvent,
         IdleStateChangedEvent,
         IdleEvent,
         MonitorInfoChangedEvent,
@@ -15700,7 +15766,7 @@ declare type SystemProcessInfo = {
  * Generated when system shutdown or log off.
  * @internal
  */
-declare type SystemShutdownEvent = BaseEvent_8 & {
+declare type SystemShutdownEvent = BaseEvent_9 & {
     type: 'system-shutdown';
 };
 
@@ -16099,7 +16165,7 @@ declare interface TypedEventEmitter<Event extends {
  * Generated when a hotkey has been unregistered with the operating system.
  * @interface
  */
-declare type UnregisteredEvent = BaseEvent & {
+declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 

package/out/mock.js

@@ -65,6 +65,16 @@ Object.defineProperty(frame$1, "__esModule", { value: true });
 
 var globalHotkey$1 = {};
 
+/**
+ *
+ * Namespace for events that can be transmitted by {@link GlobalHotkey.GlobalHotkey}.
+ *
+ * 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 global hotkey events, see {@link GlobalHotkey.GlobalHotkey.on GlobalHotkey.on}.
+ *
+ * @packageDocumentation
+ */
 Object.defineProperty(globalHotkey$1, "__esModule", { value: true });
 
 var platform$1 = {};
@@ -129,12 +139,9 @@ var webcontents = {};
  * 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
+ * WebContents 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 });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "34.78.74",
+    "version": "34.78.76",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.md",
     "main": "out/mock.js",