@openfin/core 34.78.73 → 34.78.75

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';
 };
 
@@ -5137,6 +5197,7 @@ declare type EntityTypeHelpers<T extends EntityType_2> = T extends 'view' ? {
 
 declare interface Environment {
     initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
+    applyLayoutSnapshot(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.InitLayoutOptions): Promise<void>;
     createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<void>;
     destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
     resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
@@ -5178,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).
  */
@@ -5193,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 = {
@@ -5202,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).
  */
@@ -5210,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'> & {
@@ -5227,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 = {
@@ -5250,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;
@@ -6282,6 +6340,7 @@ declare type GlobalHotkeyEvent_2 = Events.GlobalHotkeyEvents.GlobalHotkeyEvent;
 
 declare namespace GlobalHotkeyEvents {
     export {
+        BaseEvent_8 as BaseEvent,
         RegisteredEvent,
         UnregisteredEvent,
         Event_9 as Event,
@@ -6772,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;
@@ -7814,7 +7873,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -8970,16 +9029,17 @@ declare type LayoutIdentity = Identity_5 & {
 };
 
 /**
- * Generated when the window is created, and all of its layout's views have either finished or failed
- * navigation, once per layout. Does not emit for any layouts added via Layout.create() call.
+ * Generated after a layout is created and all of its views have either finished or failed navigation
+ * once per layout. Does not emit for layouts created using Layout.replace() API.
  * @interface
  */
 declare type LayoutInitializedEvent = BaseEvent_5 & {
     type: 'layout-initialized';
     layoutIdentity: OpenFin_2.LayoutIdentity;
-    ofViews: (OpenFin_2.Identity & {
+    ofViews: {
+        identity: OpenFin_2.Identity;
         entityType: 'view';
-    })[];
+    }[];
 };
 
 /**
@@ -9517,9 +9577,11 @@ declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
 declare type LayoutReadyEvent = BaseEvent_5 & {
     type: 'layout-ready';
     layoutIdentity: OpenFin_2.LayoutIdentity;
-    views: (OpenFin_2.Identity & {
+    views: {
+        identity: OpenFin_2.Identity;
         success: boolean;
-    })[];
+        error?: Error;
+    }[];
 };
 
 /**
@@ -9895,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
  */
@@ -10636,6 +10705,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10651,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,
@@ -13188,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';
 };
 
@@ -13610,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';
 };
@@ -15610,7 +15680,7 @@ declare namespace SystemEvents {
     export {
         NotRequested,
         ExcludeRequested,
-        BaseEvent_8 as BaseEvent,
+        BaseEvent_9 as BaseEvent,
         IdleStateChangedEvent,
         IdleEvent,
         MonitorInfoChangedEvent,
@@ -15696,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';
 };
 
@@ -16095,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 });
@@ -13039,24 +13046,16 @@ class LayoutModule extends base_1$5.Base {
                 throw new Error('Layout.init was already called, please use Layout.create to add additional layouts.');
             }
             __classPrivateFieldSet$4(this, _LayoutModule_layoutInitializationAttempted, true, "f");
+            // preload the client
+            await this.fin.Platform.getCurrentSync().getClient();
             __classPrivateFieldSet$4(this, _LayoutModule_layoutManager, await this.wire.environment.initLayoutManager(this.fin, this.wire, options), "f");
-            // apply the initial snapshot which in turn will call fin.Platform.Layout.create()
-            const platformClient = await this.fin.Platform.getCurrentSync().getClient();
-            const snapshot = await platformClient.dispatch('get-initial-layout-snapshot');
-            await __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").applyLayoutSnapshot(snapshot);
+            await this.wire.environment.applyLayoutSnapshot(this.fin, __classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), options);
             if (!options.layoutManagerOverride) {
                 // in single-layout case, we return the undocumented layoutManager type (deprecate with CORE-1081)
                 const layoutIdentity = { layoutName: layout_constants_1.DEFAULT_LAYOUT_KEY, ...this.fin.me.identity };
                 const layoutManager = await this.wire.environment.resolveLayout(__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
                 return Object.assign(this.wrapSync(layoutIdentity), { layoutManager });
             }
-            // warn user if they do not call create() in the next 30 seconds
-            setTimeout(() => {
-                if (__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f").size() === 0) {
-                    console.warn(`[Layout.init] Layout.init was called 30s ago, but no layouts have been created yet. Make sure you ` +
-                        `override LayoutManager.applyLayoutSnapshot, and then call fin.Platform.Layout.create()`);
-                }
-            }, 30000);
             return this.wrapSync(this.fin.me.identity);
         };
         /**
@@ -17122,6 +17121,9 @@ class MockEnvironment {
     initLayoutManager() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }
+    applyLayoutSnapshot() {
+        throw new Error(me_1.environmentUnsupportedMessage);
+    }
     async createLayout() {
         throw new Error(me_1.environmentUnsupportedMessage);
     }

package/package.json

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