@openfin/core 31.74.31 → 32.75.1

package/src/api/platform/Instance.js

@@ -7,6 +7,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _Platform_connectToProvider;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Platform = void 0;
+/* eslint-disable import/prefer-default-export, no-undef */
 const base_1 = require("../base");
 const validate_1 = require("../../util/validate");
 // Reuse clients to avoid overwriting already-registered client in provider
@@ -78,7 +79,7 @@ class Platform extends base_1.EmitterBase {
         const response = await client.dispatch('create-view', {
             target,
             opts: viewOptions,
-            targetView,
+            targetView
         });
         if (!response || (0, validate_1.validateIdentity)(response.identity)) {
             throw new Error(`When overwriting the createView call, please return an object that has a valid 'identity' property: ${JSON.stringify(response)}`);

package/src/api/platform/layout/Factory.d.ts

@@ -1,6 +1,6 @@
 import type * as OpenFin from '../../../OpenFin';
-import { Layout } from './Instance';
 import { Base } from '../../base';
+import { Layout } from './Instance';
 type InitLayoutOptions = OpenFin.InitLayoutOptions;
 /**
  * @PORTED

package/src/api/platform/layout/Factory.js

@@ -10,19 +10,12 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     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_layoutManager;
+var _LayoutModule_layoutInitializationAttempted;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LayoutModule = void 0;
 /* eslint-disable no-undef, import/prefer-default-export */
-const tab_drag_controller_1 = require("./controllers/tab-drag-controller");
-const Instance_1 = require("./Instance");
 const base_1 = require("../../base");
-const splitter_controller_1 = require("./controllers/splitter-controller");
-const view_overlay_1 = require("./utils/view-overlay");
-const api_exposer_1 = require("../../api-exposer");
-const layout_entities_controller_1 = require("./controllers/layout-entities-controller");
-const layout_constants_1 = require("./layout.constants");
-const layout_content_cache_1 = require("./controllers/layout-content-cache");
+const Instance_1 = require("./Instance");
 /**
  * @PORTED
  * InitLayoutOptions interface
@@ -90,7 +83,7 @@ const layout_content_cache_1 = require("./controllers/layout-content-cache");
 class LayoutModule extends base_1.Base {
     constructor() {
         super(...arguments);
-        _LayoutModule_layoutManager.set(this, void 0);
+        _LayoutModule_layoutInitializationAttempted.set(this, false);
         /**
          * Initialize the window's Layout.  Must be called from a custom window that has a 'layout' option set upon creation of that window.
          * If a containerId is not provided, this method attempts to find an element with the id `layout-container`.
@@ -109,36 +102,11 @@ class LayoutModule extends base_1.Base {
             if (!this.fin.me.isWindow) {
                 throw new Error('Layout.init can only be called from a Window context.');
             }
-            else if (__classPrivateFieldGet(this, _LayoutModule_layoutManager, "f")) {
+            else if (__classPrivateFieldGet(this, _LayoutModule_layoutInitializationAttempted, "f")) {
                 throw new Error('Layout for this window already initialized, please use Layout.replace call to replace the layout.');
             }
-            // We need to go through environment to make sure it is only imported/bundled in OpenFin.
-            const ManagerConstructor = await this.wire.environment.getManagerConstructor();
-            const viewOverlay = new view_overlay_1.ViewOverlay(this.wire);
-            const splitterController = new splitter_controller_1.SplitterController(viewOverlay);
-            const tabDragController = new tab_drag_controller_1.TabDragController(viewOverlay);
-            const contentItemCache = new layout_content_cache_1.LayoutContentCache();
-            __classPrivateFieldSet(this, _LayoutModule_layoutManager, new ManagerConstructor(splitterController, tabDragController, contentItemCache), "f");
-            // @ts-expect-error - layout warning here for backwards compatibility, can remove layout check in .52
-            let { layout, containerId } = options;
-            if (layout) {
-                console.warn(`We recommend using a layout in window options.
-                This layout has not been sanitized and unexpected behavior can occur.`);
-            }
-            layout = layout || (await this.fin.Window.getCurrentSync().getOptions()).layout;
-            containerId = containerId || 'layout-container';
-            const container = document.getElementById(containerId);
-            // Should we error here if there is no container? Getting a typescript complaint on createLayout
-            // override here
-            // pull createChannelConnection out of LayoutManager and setup channel connections here using layoutmanager instance methods?
-            await __classPrivateFieldGet(this, _LayoutModule_layoutManager, "f").initManager();
-            await __classPrivateFieldGet(this, _LayoutModule_layoutManager, "f").createLayout(layout, container);
-            const { client, ofWindow } = ManagerConstructor.getClientAndWindow(__classPrivateFieldGet(this, _LayoutModule_layoutManager, "f"));
-            // expose LayoutEntitiesController instance for API consumption
-            const channelStrategy = new api_exposer_1.ChannelsExposer(client);
-            await new api_exposer_1.ApiExposer(channelStrategy).exposeInstance(new layout_entities_controller_1.LayoutEntitiesController(__classPrivateFieldGet(this, _LayoutModule_layoutManager, "f"), contentItemCache), { id: layout_constants_1.LAYOUT_CONTROLLER_ID });
-            // Adding this to the returned instance undocumented/typed for Browser.
-            return Object.assign(this.getCurrentSync(), { layoutManager: __classPrivateFieldGet(this, _LayoutModule_layoutManager, "f") });
+            __classPrivateFieldSet(this, _LayoutModule_layoutInitializationAttempted, true, "f");
+            return this.wire.environment.initLayout(this.fin, this.wire, options);
         };
     }
     /**
@@ -203,4 +171,4 @@ class LayoutModule extends base_1.Base {
     }
 }
 exports.LayoutModule = LayoutModule;
-_LayoutModule_layoutManager = new WeakMap();
+_LayoutModule_layoutInitializationAttempted = new WeakMap();

package/src/api/platform/layout/Instance.js

@@ -114,6 +114,9 @@ class Layout extends base_1.Base {
      * @return {Promise<TabStack | ColumnOrRow>}
      */
     async getRootItem() {
+        this.wire.sendAction('layout-get-root-item').catch(() => {
+            // don't expose
+        });
         const client = await __classPrivateFieldGet(this, _Layout_layoutClient, "f").getValue();
         const root = await client.getRoot();
         return layout_entities_1.LayoutNode.getEntity(root, client);

package/src/api/platform/layout/controllers/layout-entities-controller.d.ts

@@ -9,7 +9,9 @@ type ViewCreationOrReference = OpenFin.Identity | OpenFin.PlatformViewCreationOp
 export declare class LayoutEntitiesController {
     private layoutManager;
     private layoutContentCache;
+    private wire;
     constructor(layoutManager: any, layoutContentCache: LayoutContentCache);
+    private analytics;
     /**
      * @internal
      * @returns the root contentItem of the layout.
@@ -86,6 +88,7 @@ export declare class LayoutEntitiesController {
      * @throws If the view does not exist, fails to create, or the stack does not exist.
      */
     addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, { index }?: OpenFin.AddViewToStackOptions) => Promise<OpenFin.Identity>;
+    private findViewInStack;
     /**
      * @internal
      * Removes a view from the given stack. If it's the only view, the stack will be destroyed, unless window creation
@@ -101,15 +104,16 @@ export declare class LayoutEntitiesController {
      * Creates a new adjacent 'stack' and adds the views to it at the specified position
      * @param targetId Entity id of the content item to add a stack adjacent to it
      * @param views List of identities or view creation options of the views to include in the stack
-     * @param options Creation options, defaults to position: 'right'
+     * @param options Creation options, defaults to { position: 'right' }
      * @returns the Entity Id of the new stack
      */
-    createAdjacentStack: (targetId: string, views: ViewCreationOrReference[], options: {
+    createAdjacentStack: (targetId: string, views: ViewCreationOrReference[], { position }?: {
         position?: OpenFin.LayoutPosition;
     }) => Promise<string>;
     getAdjacentStacks: ({ targetId, edge }: {
         targetId: string;
         edge: OpenFin.LayoutPosition;
     }) => Promise<Pick<OpenFin.LayoutEntityDefinition, 'entityId'>[]>;
+    setStackActiveView: (stackEntityId: string, viewIdentity: OpenFin.Identity) => Promise<void>;
 }
 export {};

package/src/api/platform/layout/controllers/layout-entities-controller.js

@@ -20,11 +20,17 @@ class LayoutEntitiesController {
     layoutManager, layoutContentCache) {
         this.layoutManager = layoutManager;
         this.layoutContentCache = layoutContentCache;
+        this.analytics = (topic) => {
+            this.wire.sendAction(`layout-controller-${topic}`).catch(() => {
+                // don't expose
+            });
+        };
         /**
          * @internal
          * @returns the root contentItem of the layout.
          */
         this.getRoot = () => {
+            this.analytics('get-root');
             const root = this.layoutManager.layout.root.contentItems[0];
             return {
                 // TODO: fix typing
@@ -41,6 +47,7 @@ class LayoutEntitiesController {
          */
         this.getStackByView = async (view) => {
             var _a, _b, _c, _d;
+            this.analytics('get-stack-by-view');
             const viewComponent = this.layoutManager.getViewComponent(view);
             if (!viewComponent || ((_b = (_a = viewComponent.container) === null || _a === void 0 ? void 0 : _a.parent) === null || _b === void 0 ? void 0 : _b.parent.type) !== 'stack') {
                 return undefined;
@@ -63,6 +70,7 @@ class LayoutEntitiesController {
          * @throws if the content item associated with the entity id does not exist or is not a stack.
          */
         this.getStackViews = (id) => {
+            this.analytics('get-stack-views');
             const stack = this.layoutContentCache.getContentItemOrThrow(id, ['stack']);
             const views = stack.contentItems.map((ci) => {
                 var _a;
@@ -80,6 +88,7 @@ class LayoutEntitiesController {
          */
         this.isRoot = (id) => {
             var _a;
+            this.analytics('is-root');
             const ci = this.layoutContentCache.getContentItemOrThrow(id);
             return !!((_a = ci.parent) === null || _a === void 0 ? void 0 : _a.isRoot);
         };
@@ -90,6 +99,7 @@ class LayoutEntitiesController {
          * @returns True if the content item exists and belongs to the layout.
          */
         this.exists = (entityId) => {
+            this.analytics('exists');
             return this.layoutContentCache.hasKey(entityId);
         };
         /**
@@ -109,6 +119,7 @@ class LayoutEntitiesController {
          * @throws If the view does not exist, fails to create, or the stack does not exist.
          */
         this.addViewToStack = async (stackEntityId, viewCreationOrReference, { index } = { index: 0 }) => {
+            this.analytics('add-view-to-stack');
             const currentStack = this.layoutContentCache.getContentItemOrThrow(stackEntityId);
             if (index && index > currentStack.contentItems.length + 1) {
                 throw new Error(`Index '${index}' out of range, please exclude the index or specify a number between 0 and ${currentStack.contentItems.length}`);
@@ -123,6 +134,9 @@ class LayoutEntitiesController {
             });
             return identity;
         };
+        this.findViewInStack = (stack, viewIdentity) => {
+            return stack.contentItems.find((ci) => { var _a, _b; return ((_b = (_a = ci.config) === null || _a === void 0 ? void 0 : _a.componentState) === null || _b === void 0 ? void 0 : _b.name) === viewIdentity.name; });
+        };
         /**
          * @internal
          * Removes a view from the given stack. If it's the only view, the stack will be destroyed, unless window creation
@@ -133,9 +147,11 @@ class LayoutEntitiesController {
          * @throws If the stack does not exist or the view does not exist or belong to the stack.
          */
         this.removeViewFromStack = async (stackEntityId, view) => {
-            const views = this.getStackViews(stackEntityId);
-            if (!views.find((existingView) => existingView.name === view.name)) {
-                throw new Error(`Tried to remove a view ('${view.name}') which does not exist in the stack.`);
+            this.analytics('remove-view-from-stack');
+            const stack = this.layoutContentCache.getContentItemOrThrow(stackEntityId, ['stack']);
+            const viewInstance = this.findViewInStack(stack, view);
+            if (!viewInstance) {
+                throw new Error(`Tried to remove a view ('${view.name}') which does not belong to the stack.`);
             }
             await this.layoutManager.platform.closeView(view);
         };
@@ -144,14 +160,14 @@ class LayoutEntitiesController {
          * Creates a new adjacent 'stack' and adds the views to it at the specified position
          * @param targetId Entity id of the content item to add a stack adjacent to it
          * @param views List of identities or view creation options of the views to include in the stack
-         * @param options Creation options, defaults to position: 'right'
+         * @param options Creation options, defaults to { position: 'right' }
          * @returns the Entity Id of the new stack
          */
-        this.createAdjacentStack = async (targetId, views, options) => {
-            if (views.length === 0) {
-                throw new Error('Cannot create stack with empty view array.');
+        this.createAdjacentStack = async (targetId, views, { position = 'right' } = {}) => {
+            this.analytics('create-adjacent-stack');
+            if (!Array.isArray(views) || views.length === 0) {
+                throw new Error('The parameter "views" must be an array with at least 1 element.');
             }
-            const { position = 'right' } = options;
             if (!['top', 'bottom', 'left', 'right'].includes(position)) {
                 throw new Error(`Invalid position '${position}' specified.`);
             }
@@ -176,12 +192,23 @@ class LayoutEntitiesController {
             return entityId;
         };
         this.getAdjacentStacks = async ({ targetId, edge }) => {
+            this.analytics('get-adjacent-stacks');
             const contentItem = this.layoutContentCache.getContentItemOrThrow(targetId);
             // call utils helper to traverse and return adjacent stacks
             return (0, layout_traversal_1.getAdjacentStacks)(contentItem, edge).map((stack) => ({
                 entityId: this.layoutContentCache.getOrCreateEntityId(stack),
             }));
         };
+        this.setStackActiveView = async (stackEntityId, viewIdentity) => {
+            this.analytics('set-stack-active-view');
+            const stack = this.layoutContentCache.getContentItemOrThrow(stackEntityId, ['stack']);
+            const view = this.findViewInStack(stack, viewIdentity);
+            if (!view) {
+                throw new Error(`Tried to set a view ('${viewIdentity.name}') as active when it does not belong to the stack.`);
+            }
+            stack.setActiveContentItem(view, true);
+        };
+        this.wire = this.layoutManager.platform.wire;
     }
     /**
      * @internal
@@ -192,6 +219,7 @@ class LayoutEntitiesController {
      * @throws if the entity associated with {@link id} is not in the entity cache, does not belogn to a layout, or is not a column/row.
      */
     getContent(id) {
+        this.analytics('get-content');
         const ci = this.layoutContentCache.getContentItemOrThrow(id, ['column', 'row']);
         return ci.contentItems.map((item) => ({
             type: item.type,
@@ -208,6 +236,7 @@ class LayoutEntitiesController {
      * content item or has been removed from the layout entirely.
      */
     getParent(id) {
+        this.analytics('get-parent');
         const ci = this.layoutContentCache.getContentItemOrThrow(id);
         if (ci.parent && !ci.parent.isRoot && ci.parent.contentItems.includes(ci)) {
             return {
@@ -252,4 +281,7 @@ __decorate([
 __decorate([
     (0, decorators_1.expose)()
 ], LayoutEntitiesController.prototype, "getAdjacentStacks", void 0);
+__decorate([
+    (0, decorators_1.expose)()
+], LayoutEntitiesController.prototype, "setStackActiveView", void 0);
 exports.LayoutEntitiesController = LayoutEntitiesController;

package/src/api/platform/layout/entities/layout-entities.d.ts

@@ -1,25 +1,27 @@
 import type * as OpenFin from '../../../../OpenFin';
 import { LayoutEntitiesClient } from '../shapes';
 /**
+ * @ignore
  * @internal
  * Supplies an ApiClient for {@link LayoutEntitiesController} and helper methods
  * for the entities {@link TabStack} AND {@link ColumnOrRow} to use.
  */
 export declare abstract class LayoutNode {
     #private;
-    /** @internal */
-    protected constructor(client: LayoutEntitiesClient, entityId: string);
     /**
      * @internal
-     * The type of this node, one of: 'row' | 'column' | 'stack';
+     * @ignore
      */
-    readonly abstract type: OpenFin.LayoutEntityTypes;
+    protected constructor(client: LayoutEntitiesClient, entityId: string);
+    abstract readonly type: OpenFin.LayoutEntityTypes;
     /**
      * @internal
+     * @ignore
      * This instance's unique id used when calling the layout-entities-controller api client
      */
     protected readonly entityId: string;
     /**
+     * @ignore
      * @internal
      * Encapsulates Api consumption of {@link LayoutEntitiesController} with a relayed dispatch
      * @param client
@@ -29,51 +31,83 @@ export declare abstract class LayoutNode {
      */
     static newLayoutEntitiesClient: (client: OpenFin.ChannelClient, controllerId: string, identity: OpenFin.Identity) => Promise<LayoutEntitiesClient>;
     static getEntity: (definition: OpenFin.LayoutEntityDefinition, client: LayoutEntitiesClient) => ColumnOrRow | TabStack;
+    isRoot: () => Promise<boolean>;
+    exists: () => Promise<boolean>;
+    getParent: () => Promise<ColumnOrRow | TabStack | undefined>;
+    createAdjacentStack: (views: OpenFin.PlatformViewCreationOptions[], options: {
+        position?: OpenFin.LayoutPosition;
+    }) => Promise<TabStack>;
+    getAdjacentStacks: (edge: OpenFin.LayoutPosition) => Promise<TabStack[]>;
+}
+/**
+ * @typedef {string} LayoutPosition
+ * @summary Represents the position of an item in a layout relative to another. Possible values are 'top', 'bottom', 'left' and 'right'.
+ */
+/**
+ * @typedef {object} StackCreationOptions
+ * @summary Stack creation options.
+ * @property {LayoutPosition} [position] - The position to create the new {@link TabStack} in, relative to the given adjacent {@link TabStack}. Defaults to 'right'.
+ */
+/**
+ * @typedef {object} TabStack~AddViewOptions
+ * @summary Options to use when adding a view to a {@link TabStack}
+ * @property {number} [index] - Insertion index when adding the view. Defaults to 0.
+ */
+/**
+ * A TabStack is used to manage the state of a stack of tabs within an OpenFin Layout.
+ */
+export declare class TabStack extends LayoutNode {
+    #private;
     /**
-     * Determines if this {@link ColumnOrRow} or {@link TabStack} is the top level content item in the current layout.
-     * @returns Promise resolving true if this is the root, or false otherwise.
+     * Determines if this {@link TabStack} is the top level content item in the current layout.
+     * @function isRoot
+     * @memberof TabStack
+     * @instance
+     * @tutorial TabStack.isRoot
+     * @return {Promise<boolean>} Resolves true if this TabStack is the top level content item, or false if it is not.
      */
-    isRoot: () => Promise<boolean>;
     /**
-     * Determines if this {@link ColumnOrRow} or {@link TabStack} is the top level
-     * content item in the current layout.
-     * @returns Promise resolving true if this is the root, or false otherwise.
+     * Determines if this  {@link TabStack} exists.
+     * @function exists
+     * @instance
+     * @memberof TabStack
+     * @tutorial TabStack.exists
+     * @return {Promise<boolean>} Resolves true if this is the TabStack exists, or false if it has been destroyed.
      */
-    exists: () => Promise<boolean>;
     /**
-     * Retrieves the parent {@link ColumnOrRow} or {@link TabStack} of this item, if one exists.
-     * @returns Promise resolving with the {@link ColumnOrRow} or {@link TabStack} that contains this item, or undefined if this is the root content item.
+     * Retrieves the parent {@link ColumnOrRow} of this {@link TabStack}, if one exists.
+     * @function getParent
+     * @instance
+     * @memberof TabStack
+     * @tutorial TabStack.getParent
+     * @return {Promise<ColumnOrRow | TabStack | undefined>} Promise resolving with the {@link ColumnOrRow} that contains this item, or undefined if this {@link TabStack} is the root content item or does not exist.
      */
-    getParent: () => Promise<ColumnOrRow | TabStack | undefined>;
     /**
-     * Given a list of view creation options or references and a layout position, creates an adjacent {@link TabStack}
+     * Returns all the adjacent stacks that share an edge with the given {@link TabStack}.
+     * @function getAdjacentStacks
+     * @instance
+     * @memberof TabStack
+     * @param  {LayoutPosition} edge - Edge to check for any adjacent stacks.
+     * @returns {Promise<TabStack[]>}
+     * @tutorial TabStack.getAdjacentStacks
+     */
+    /**
+     * Given a list of view creation options or references and a layout position, creates a {@link TabStack} adjacent to the current {@link TabStack}
      *
      * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
      * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
      * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
      *
-     * @param views List of identities or view creation options of the views to include in the stack
-     * @param options Creation options, defaults to position: 'right'
-     * @returns an instance of {@link TabStack} containing the given views
+     * @function createAdjacentStack
+     * @instance
+     * @memberof TabStack
+     * @param {View~options} views - List of identities or view creation options of the views to include in the stack
+     * @param {StackCreationOptions} options - Creation options.
+     * @returns {Promise<TabStack>} The created TabStack.
+     * @tutorial TabStack.createAdjacentStack
      * @experimental
      */
-    createAdjacentStack: (views: OpenFin.PlatformViewCreationOptions[], options: {
-        position?: OpenFin.LayoutPosition;
-    }) => Promise<TabStack>;
-    /**
-     * Finds the immediate adjacent layout item given an edge Position
-     * @param edgePosition
-     * @returns either {@link TabStack} or {@link ColumnOrRow} that was found, or `undefined` if there is no item with that edgePosition
-     */
-    getAdjacentStacks: (edge: OpenFin.LayoutPosition) => Promise<TabStack[]>;
-}
-/**
- * A {@link TabStack} is used to manage the state of a TabStack within an OpenFin Layout and
- * traverse to its parent Content Item.
- */
-export declare class TabStack extends LayoutNode {
-    #private;
     /** @internal */
     constructor(client: LayoutEntitiesClient, entityId: string);
     /**
@@ -88,8 +122,9 @@ export declare class TabStack extends LayoutNode {
      * If that happens and then getViews() is called, it will return the identities in a different order than
      * than the currently rendered tab order.
      *
-     * @returns Resolves with a list containing the {@link OpenFin.Identity identities} of each view belonging to the {@link TabStack}.
+     * @returns {Promise<Identity[]>} Resolves with a list containing the {@link OpenFin.Identity identities} of each view belonging to the {@link TabStack}.
      * @throws If the {@link TabStack} has been destroyed.
+     * @tutorial TabStack.getViews
      * @experimental
      */
     getViews: () => Promise<OpenFin.Identity[]>;
@@ -99,28 +134,93 @@ export declare class TabStack extends LayoutNode {
      * Known Issue: If adding a view overflows the tab-container, the added view will be set as active
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      *
-     * @param view The identity of an existing view to add, or options to create a view.
-     * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
-     * @returns Resolves with the {@link OpenFin.Identity identity} of the added view.
+     * @param {View~options} view The identity of an existing view to add, or options to create a view.
+     * @param {TabStack~AddViewOptions} options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
+     * @returns {Promise<identity>} Resolves with the {@link OpenFin.Identity identity} of the added view.
      * @throws If the view does not exist or fails to create.
      * @throws If the {@link TabStack} has been destroyed.
+     * @tutorial TabStack.addView
      * @experimental
      */
     addView: (view: OpenFin.Identity | OpenFin.PlatformViewCreationOptions, options?: OpenFin.AddViewToStackOptions) => Promise<OpenFin.Identity>;
     /**
      * Removes a view from this {@link TabStack}.
-     * @param view {@link OpenFin.Identiy Identity} of the view to remove.
+     * @param {Identity} view - Identity of the view to remove.
      * @throws If the view does not exist or does not belong to the stack.
      * @throws If the {@link TabStack} has been destroyed.
+     * @return {Promise<void>}
+     * @tutorial TabStack.removeView
      */
     removeView: (view: OpenFin.Identity) => Promise<void>;
+    /**
+     * Sets the active view of the {@link TabStack} without focusing it.
+     * @param {Identity} view - Identity of the view to activate.
+     * @returns {Promise<void>} Promise which resolves with void once the view has been activated.
+     * @throws If the {@link TabStack} has been destroyed.
+     * @throws If the view does not exist.
+     * @tutorial TabStack.setActiveView
+     * @experimental
+     */
+    setActiveView: (view: OpenFin.Identity) => Promise<void>;
 }
 /**
- * A {@link ColumnOrRow} is used to manage the state of a ColumnOrRow within an OpenFin Layout.
+ * A ColumnOrRow is used to manage the state of Column and Rows within an OpenFin Layout.
  */
 export declare class ColumnOrRow extends LayoutNode {
     #private;
-    /** @internal */
+    /**
+     * Determines if this {@link ColumnOrRow} is the top level content item in the current layout.
+     * @function isRoot
+     * @memberof ColumnOrRow
+     * @instance
+     * @tutorial ColumnOrRow.isRoot
+     * @return {Promise<boolean>} Resolves true if this TabStack is the top level content item, or false if it is not.
+     */
+    /**
+     * Determines if this  {@link ColumnOrRow} exists.
+     * @function exists
+     * @instance
+     * @memberof ColumnOrRow
+     * @tutorial ColumnOrRow.exists
+     * @return {Promise<boolean>} Resolves true if the TabStack exists, or false if it has been destroyed.
+     */
+    /**
+     * Retrieves the parent {@link ColumnOrRow} of this {@link ColumnOrRow}, if one exists.
+     * @function getParent
+     * @instance
+     * @memberof ColumnOrRow
+     * @tutorial ColumnOrRow.getParent
+     * @return {Promise<ColumnOrRow | undefined>} Promise resolving with the {@link ColumnOrRow} that contains this item, or undefined if this {@link ColumnOrRow} does not exist or is the root content item.
+     */
+    /**
+     * Returns all the adjacent stacks that share an edge with the given {@link ColumnOrRow}.
+     * @function getAdjacentStacks
+     * @instance
+     * @memberof ColumnOrRow
+     * @param  {LayoutPosition} edge - Edge to check for any adjacent stacks.
+     * @returns {Promise<TabStack[]>}
+     * @tutorial ColumnOrRow.getAdjacentStacks
+     */
+    /**
+     * Given a list of view creation options or references and a layout position, creates a {@link TabStack} adjacent to the given {@link ColumnOrRow}
+     *
+     * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
+     * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
+     * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
+     *
+     * @function createAdjacentStack
+     * @instance
+     * @memberof ColumnOrRow
+     * @param {View~options} views - List of identities or view creation options of the views to include in the stack
+     * @param {StackCreationOptions} options - Creation options.
+     * @returns {Promise<TabStack>} The created TabStack
+     * @tutorial ColumnOrRow.createAdjacentStack
+     * @experimental
+     */
+    /**
+     * @internal
+     */
     constructor(client: LayoutEntitiesClient, entityId: string, type: 'row' | 'column');
     /**
      * The type of this {@link ColumnOrRow}. Either 'row' or 'column'.
@@ -128,7 +228,8 @@ export declare class ColumnOrRow extends LayoutNode {
     readonly type: 'column' | 'row';
     /**
      * Retrieves a list of all content items belonging to this {@link ColumnOrRow} in order of appearance.
-     * @returns Resolves with a list containing {@link ColumnOrRow} and {@link TabStack} items belonging to this {@link ColumnOrRow}.
+     * @returns {Promise<Array<ColumnOrRow | TabStack>>} Resolves with a list containing {@link ColumnOrRow} and {@link TabStack} items belonging to this {@link ColumnOrRow}.
+     * @tutorial ColumnOrRow.getContent
      */
     getContent: () => Promise<(ColumnOrRow | TabStack)[]>;
 }