@openfin/remote-adapter 36.79.12 → 36.79.15

package/out/remote-adapter-alpha.d.ts

@@ -4490,6 +4490,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;
 };
 
 /**
@@ -9446,6 +9472,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10166,6 +10199,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/remote-adapter-beta.d.ts

@@ -4490,6 +4490,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;
 };
 
 /**
@@ -9446,6 +9472,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10166,6 +10199,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/remote-adapter-public.d.ts

@@ -4490,6 +4490,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;
 };
 
 /**
@@ -9446,6 +9472,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10166,6 +10199,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/remote-adapter.d.ts

@@ -4533,6 +4533,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;
 };
 
 /**
@@ -9723,6 +9749,13 @@ declare type MonitorInfoChangedEvent = BaseEvent_9 & OpenFin.MonitorInfo & {
     type: 'monitor-info-changed';
 };
 
+/**
+ * @experimental
+ *
+ * Used to control view behavior for Layout.create API
+ */
+declare type MultiInstanceViewBehavior = 'reparent' | 'duplicate' | 'default';
+
 /**
  * @interface
  */
@@ -10465,6 +10498,7 @@ declare namespace OpenFin {
         LayoutManagerOverride,
         LayoutManager,
         CreateLayoutOptions,
+        MultiInstanceViewBehavior,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,

package/out/remote-adapter.js

@@ -12329,7 +12329,7 @@ var __classPrivateFieldSet$3 = (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;
@@ -12401,10 +12401,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$3(this, _LayoutModule_layoutManager, "f"), layoutIdentity);
-                return Object.assign(this.wrapSync(layoutIdentity), { layoutManager });
+                return __classPrivateFieldGet$3(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 be removed in v39.';
+            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
@@ -12514,7 +12535,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$3(this, _LayoutModule_layoutManager, "f")) {
         throw new Error(`You must call init before using the API ${method}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/remote-adapter",
-    "version": "36.79.12",
+    "version": "36.79.15",
     "description": "Establish intermachine runtime connections using webRTC.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,