@openfin/core 35.79.3 → 35.79.5

package/out/mock-alpha.d.ts

@@ -1192,6 +1192,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3722,6 +3726,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4362,6 +4370,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;
 };
 
 /**
@@ -6547,6 +6581,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7450,7 +7491,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9258,6 +9299,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -9760,6 +9808,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9977,6 +10026,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10994,10 +11044,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/mock-beta.d.ts

@@ -1192,6 +1192,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3722,6 +3726,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4362,6 +4370,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;
 };
 
 /**
@@ -6547,6 +6581,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7450,7 +7491,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9258,6 +9299,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -9760,6 +9808,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9977,6 +10026,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10994,10 +11044,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/mock-public.d.ts

@@ -1192,6 +1192,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3722,6 +3726,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4362,6 +4370,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;
 };
 
 /**
@@ -6547,6 +6581,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7450,7 +7491,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9258,6 +9299,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -9760,6 +9808,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9977,6 +10026,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -10994,10 +11044,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/mock.d.ts

@@ -1198,6 +1198,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
      * Define the {@link https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads file download rules} and domain-based api injection rules.
      */
     domainSettings: DomainSettings;
+    /**
+     * The permissions for secured APIs.
+     */
+    permissions?: Partial<Permissions_2>;
     /**
      * @defaultValue false
      *
@@ -3765,6 +3769,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. Use { <option>: false } to disable a specific <option>. All inheritable properties will be inherited by default if omitted."
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4405,6 +4413,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;
 };
 
 /**
@@ -6625,6 +6659,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -7543,7 +7584,7 @@ declare type InteropBrokerDisconnectionEvent = {
  * @interface
  */
 declare type InteropBrokerOptions = {
-    contextGroups?: ContextGroupInfo;
+    contextGroups?: ContextGroupInfo[];
     logging?: InteropLoggingOptions;
 };
 
@@ -9535,6 +9576,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_8 & OpenFin_2.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10059,6 +10107,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10276,6 +10325,7 @@ declare namespace OpenFin_2 {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -11326,10 +11376,6 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
-    /**
-     * The permissions for secured APIs.
-     */
-    permissions?: Partial<Permissions_2>;
 };
 
 /**

package/out/mock.js

@@ -257,7 +257,7 @@ events.WindowEvents = WindowEvents;
 	__exportStar(events, exports); 
 } (OpenFin$1));
 
-var fin = {};
+var fin$1 = {};
 
 var system = {};
 
@@ -11880,7 +11880,7 @@ var __classPrivateFieldSet$4 = (commonjsGlobal && commonjsGlobal.__classPrivateF
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_getSafeLayoutManager;
+var _LayoutModule_instances, _LayoutModule_layoutInitializationAttempted, _LayoutModule_layoutManager, _LayoutModule_getLayoutManagerSpy, _LayoutModule_getSafeLayoutManager;
 Object.defineProperty(Factory$2, "__esModule", { value: true });
 Factory$2.LayoutModule = void 0;
 const base_1$5 = base;
@@ -11952,10 +11952,31 @@ class LayoutModule extends base_1$5.Base {
                 // 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 });
+                return __classPrivateFieldGet$4(this, _LayoutModule_getLayoutManagerSpy, "f").call(this, layoutIdentity, layoutManager);
             }
             return this.wrapSync(this.fin.me.identity);
         };
+        _LayoutModule_getLayoutManagerSpy.set(this, (layoutIdentity, layoutManager) => {
+            const msg = '[Layout] You are using a deprecated property `layoutManager` - it will throw if you access it starting in v37.';
+            const managerProxy = new Proxy(layoutManager, {
+                get(target, key) {
+                    console.warn(`[Layout-mgr-proxy] accessing ${key.toString()}`);
+                    console.warn(msg);
+                    return target[key];
+                }
+            });
+            const layout = Object.assign(this.wrapSync(layoutIdentity), { layoutManager: managerProxy });
+            const layoutProxy = new Proxy(layout, {
+                get(target, key) {
+                    if (key === 'layoutManager') {
+                        console.warn(`[Layout-proxy] accessing ${key.toString()}`);
+                        console.warn(msg);
+                    }
+                    return target[key];
+                }
+            });
+            return layoutProxy;
+        });
         /**
          * Returns the layout manager for the current window
          * @returns
@@ -12065,7 +12086,7 @@ class LayoutModule extends base_1$5.Base {
     }
 }
 Factory$2.LayoutModule = LayoutModule;
-_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_getSafeLayoutManager = function _LayoutModule_getSafeLayoutManager(method) {
+_LayoutModule_layoutInitializationAttempted = new WeakMap(), _LayoutModule_layoutManager = new WeakMap(), _LayoutModule_getLayoutManagerSpy = new WeakMap(), _LayoutModule_instances = new WeakSet(), _LayoutModule_getSafeLayoutManager = function _LayoutModule_getSafeLayoutManager(method) {
     if (!__classPrivateFieldGet$4(this, _LayoutModule_layoutManager, "f")) {
         throw new Error(`You must call init before using the API ${method}`);
     }
@@ -12179,6 +12200,9 @@ class PlatformModule extends base_1$4.Base {
      * @experimental
      */
     async init(options) {
+        if (!fin.__internal_.isPlatform || fin.me.name !== fin.me.uuid) {
+            throw new Error('fin.Platform.init should only be called from a custom platform provider running in the main window of the application.');
+        }
         return this.wire.environment.initPlatform(this.fin, options);
     }
     /**
@@ -15453,8 +15477,8 @@ Factory.SnapshotSourceModule = SnapshotSourceModule;
 	__exportStar(Instance, exports); 
 } (snapshotSource));
 
-Object.defineProperty(fin, "__esModule", { value: true });
-fin.Fin = void 0;
+Object.defineProperty(fin$1, "__esModule", { value: true });
+fin$1.Fin = void 0;
 const events_1$3 = require$$0;
 // Import from the file rather than the directory in case someone consuming types is using module resolution other than "node"
 const index_1 = system;
@@ -15500,7 +15524,7 @@ class Fin extends events_1$3.EventEmitter {
         });
     }
 }
-fin.Fin = Fin;
+fin$1.Fin = Fin;
 
 var transport = {};
 
@@ -15955,7 +15979,7 @@ mockWire.MockWire = MockWire;
 Object.defineProperty(mock, "__esModule", { value: true });
 exports.fin = mock.fin = void 0;
 const OpenFin = OpenFin$1;
-const fin_1 = fin;
+const fin_1 = fin$1;
 const transport_1 = transport;
 const mockEnvironment_1 = mockEnvironment;
 const mockWire_1 = mockWire;

package/package.json

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