@thoughtspot/visual-embed-sdk 1.46.1 → 1.46.2

package/src/embed/conversation.ts

@@ -2,7 +2,7 @@ import isUndefined from 'lodash/isUndefined';
 import { ERROR_MESSAGE } from '../errors';
 import { Param, BaseViewConfig, RuntimeFilter, RuntimeParameter, ErrorDetailsTypes, EmbedErrorCodes } from '../types';
 import { TsEmbed } from './ts-embed';
-import { getQueryParamString, getFilterQuery, getRuntimeParameters, validateHttpUrl, setParamIfDefined } from '../utils';
+import { getQueryParamString, getFilterQuery, getRuntimeParameters, validateHttpUrl, setParamIfDefined, resolveEnablePastConversationsSidebar } from '../utils';
 
 /**
  * Configuration for search options
@@ -18,82 +18,82 @@ export interface SearchOptions {
  * Configuration for the Spotter sidebar.
  * Can be used in SpotterEmbed and AppEmbed.
  * @group Embed components
- * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+ * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
  */
 export interface SpotterSidebarViewConfig {
     /**
      * Controls the visibility of the past conversations sidebar.
      * @default false
-     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     enablePastConversationsSidebar?: boolean;
     /**
      * Custom title text for the sidebar header.
      * Defaults to translated "Spotter" text.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterSidebarTitle?: string;
     /**
      * Boolean to set the default expanded state of the sidebar.
      * @default false
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterSidebarDefaultExpanded?: boolean;
     /**
      * Custom label text for the rename action in the conversation edit menu.
      * Defaults to translated "Rename" text.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterChatRenameLabel?: string;
     /**
      * Custom label text for the delete action in the conversation edit menu.
      * Defaults to translated "DELETE" text.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterChatDeleteLabel?: string;
     /**
      * Custom title text for the delete conversation confirmation modal.
      * Defaults to translated "Delete chat" text.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterDeleteConversationModalTitle?: string;
     /**
      * Custom message text for the past conversation banner alert.
      * Defaults to translated alert message.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterPastConversationAlertMessage?: string;
     /**
      * Custom URL for the documentation/best practices link.
      * Defaults to ThoughtSpot docs URL based on release version.
      * Note: URL must include the protocol (e.g., `https://www.example.com`).
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterDocumentationUrl?: string;
     /**
      * Custom label text for the best practices button in the footer.
      * Defaults to translated "Best Practices" text.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterBestPracticesLabel?: string;
     /**
      * Number of conversations to fetch per batch when loading conversation history.
      * @default 30
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterConversationsBatchSize?: number;
     /**
      * Custom title text for the "New Chat" button in the sidebar.
      * Defaults to translated "New Chat" text.
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterNewChatButtonTitle?: string;
 }
 
 /**
  * Configuration for customizing Spotter chat UI branding.
- * @group Embed components
  * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
+ * @group Embed components
  */
 export interface SpotterChatViewConfig {
     /**
@@ -133,6 +133,7 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * but still display the selected data source.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -140,13 +141,13 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    disableSourceSelection : true,
      * })
      * ```
-     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      */
     disableSourceSelection?: boolean;
     /**
      * hideSourceSelection : Hide data source selection
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -154,15 +155,14 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    hideSourceSelection : true,
      * })
      * ```
-     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      */
     hideSourceSelection?: boolean;
     /**
      * Flag to control Data panel experience
      *
      * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
+     * @deprecated from SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
      * @default true
-     * @deprecated from SDK 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
      * @example
      * ```js
      * // Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
@@ -179,6 +179,7 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * default is false.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.36.0 | ThoughtSpot: 10.5.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -186,7 +187,6 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    showSpotterLimitations : true,
      * })
      * ```
-     * @version SDK: 1.36.0 | ThoughtSpot: 10.5.0.cl
      */
     showSpotterLimitations?: boolean;
     /**
@@ -194,6 +194,7 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * the initial screen of the conversation.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -201,7 +202,6 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    hideSampleQuestions : true,
      * })
      * ```
-     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      */
     hideSampleQuestions?: boolean;
     /**
@@ -209,6 +209,7 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * visualization, or Liveboard.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -222,7 +223,6 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *       ],
      * })
      * ```
-     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
      */
     runtimeFilters?: RuntimeFilter[];
     /**
@@ -233,14 +233,15 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * (default behavior before SDK 1.45.0).
      *
      * Supported embed types: `SpotterEmbed`
-     * @default true
      * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
+     * @default true
      */
     excludeRuntimeFiltersfromURL?: boolean;
     /**
      * The list of runtime parameters to apply to the conversation.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -253,7 +254,6 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *       ],
      * })
      * ```
-     * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
      */
     runtimeParameters?: RuntimeParameter[];
     /**
@@ -264,14 +264,15 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * the iframe URL instead (default behavior before SDK 1.45.0).
      *
      * Supported embed types: `SpotterEmbed`
-     * @default true
      * @version SDK: 1.41.0 | ThoughtSpot: 10.13.0.cl
+     * @default true
      */
     excludeRuntimeParametersfromURL?: boolean;
     /**
      * updatedSpotterChatPrompt : Controls the updated spotter chat prompt.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      * @default false
      * @example
      * ```js
@@ -280,17 +281,30 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    updatedSpotterChatPrompt : true,
      * })
      * ```
-     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      */
     updatedSpotterChatPrompt?: boolean;
+    /**
+     * Controls the visibility of the past conversations sidebar.
+     *
+     * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @deprecated from SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
+     * Use `spotterSidebarConfig.enablePastConversationsSidebar`.
+     * @default false
+     */
+    enablePastConversationsSidebar?: boolean;
     /**
      * Configuration for the Spotter sidebar UI customization.
      *
      * Supported embed types: `SpotterEmbed`, `AppEmbed`
+     * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
-     *    ... //other embed view config
+     *    worksheetId: 'worksheet-id',
+     *    // Deprecated standalone flag (backward compatibility)
+     *    enablePastConversationsSidebar: false,
+     *    // Recommended config; this value takes precedence
      *    spotterSidebarConfig: {
      *        enablePastConversationsSidebar: true,
      *        spotterSidebarTitle: 'My Conversations',
@@ -298,7 +312,6 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    },
      * })
      * ```
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
      */
     spotterSidebarConfig?: SpotterSidebarViewConfig;
     /**
@@ -306,6 +319,7 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      * branding in tool response cards.
      *
      * Supported embed types: `SpotterEmbed`
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * const embed = new SpotterEmbed('#tsEmbed', {
@@ -316,15 +330,14 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, 'primaryAct
      *    },
      * })
      * ```
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterChatConfig?: SpotterChatViewConfig;
 }
 
 /**
  * The configuration for the embedded spotterEmbed options.
- * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * Use {@link SpotterEmbedViewConfig} instead
+ * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * @group Embed components
  */
 // eslint-disable-next-line @typescript-eslint/no-empty-object-type
@@ -332,6 +345,7 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {}
 
 /**
  * Embed ThoughtSpot AI Conversation.
+ * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
  * @group Embed components
  * @example
  * ```js
@@ -343,7 +357,6 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {}
  * });
  * conversation.render();
  * ```
- * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
  */
 export class SpotterEmbed extends TsEmbed {
     constructor(container: HTMLElement, protected viewConfig: SpotterEmbedViewConfig) {
@@ -376,7 +389,7 @@ export class SpotterEmbed extends TsEmbed {
 
         // Extract sidebar config properties
         const {
-            enablePastConversationsSidebar,
+            enablePastConversationsSidebar: sidebarEnablePastConversationsSidebar,
             spotterSidebarTitle,
             spotterSidebarDefaultExpanded,
             spotterChatRenameLabel,
@@ -388,6 +401,10 @@ export class SpotterEmbed extends TsEmbed {
             spotterConversationsBatchSize,
             spotterNewChatButtonTitle,
         } = spotterSidebarConfig || {};
+        const resolvedEnablePastConversationsSidebar = resolveEnablePastConversationsSidebar({
+            spotterSidebarConfigValue: sidebarEnablePastConversationsSidebar,
+            standaloneValue: this.viewConfig.enablePastConversationsSidebar,
+        });
 
         if (!worksheetId) {
             this.handleError({
@@ -407,6 +424,12 @@ export class SpotterEmbed extends TsEmbed {
         setParamIfDefined(queryParams, Param.ShowSpotterLimitations, showSpotterLimitations, true);
         setParamIfDefined(queryParams, Param.HideSampleQuestions, hideSampleQuestions, true);
         setParamIfDefined(queryParams, Param.UpdatedSpotterChatPrompt, updatedSpotterChatPrompt, true);
+        setParamIfDefined(
+            queryParams,
+            Param.EnablePastConversationsSidebar,
+            resolvedEnablePastConversationsSidebar,
+            true,
+        );
         setParamIfDefined(queryParams, Param.SpotterSidebarDefaultExpanded, spotterSidebarDefaultExpanded, true);
 
         // String params
@@ -456,16 +479,10 @@ export class SpotterEmbed extends TsEmbed {
             excludeRuntimeFiltersfromURL,
             runtimeParameters,
             excludeRuntimeParametersfromURL,
-            spotterSidebarConfig,
         } = this.viewConfig;
         const path = 'insights/conv-assist';
         const queryParams = this.getEmbedParamsObject();
 
-        const enablePastConversationsSidebar = spotterSidebarConfig?.enablePastConversationsSidebar;
-        if (!isUndefined(enablePastConversationsSidebar)) {
-            queryParams[Param.EnablePastConversationsSidebar] = !!enablePastConversationsSidebar;
-        }
-
         let query = '';
         const queryParamsString = getQueryParamString(queryParams, true);
         if (queryParamsString) {
@@ -500,8 +517,9 @@ export class SpotterEmbed extends TsEmbed {
 
 /**
  * Embed ThoughtSpot AI Conversation.
- * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * Use {@link SpotterEmbed} instead
+ * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
+ * @deprecated from SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
  * @group Embed components
  * @example
  * ```js
@@ -513,7 +531,6 @@ export class SpotterEmbed extends TsEmbed {
  * });
  * conversation.render();
  * ```
- * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
  */
 export class ConversationEmbed extends SpotterEmbed {
     constructor(container: HTMLElement, protected viewConfig: ConversationViewConfig) {

package/src/embed/liveboard.spec.ts

@@ -169,7 +169,7 @@ describe('Liveboard/viz embed tests', () => {
         });
     });
 
-    test('should set isLiveboardStylingAndGroupingEnabled to true in url', async () => {
+    test('should set isLiveboardStylingAndGroupingEnabled to true in url (deprecated, use isLiveboardMasterpiecesEnabled)', async () => {
         const liveboardEmbed = new LiveboardEmbed(getRootEl(), {
             isLiveboardStylingAndGroupingEnabled: true,
             ...defaultViewConfig,

package/src/embed/liveboard.ts

@@ -49,9 +49,9 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * Setting `fullHeight` to `false` fetches visualizations
      * incrementally as users scroll the page to view the charts and tables.
      *
-     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed', {
@@ -62,14 +62,14 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      */
     fullHeight?: boolean;
     /**
-     * This is the minimum height(in pixels) for a full-height Liveboard.
+     * This is the minimum height (in pixels) for a full-height Liveboard.
      * Setting this height helps resolve issues with empty Liveboards and
      * other screens navigable from a Liveboard.
      *
      * Supported embed types: `LiveboardEmbed`
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
-     * @default 500
      * @deprecated Use `minimumHeight` instead.
+     * @default 500
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed', {
@@ -98,7 +98,9 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      */
     minimumHeight?: number;
     /**
-     * @Deprecated If set to true, the context menu in visualizations will be enabled.
+     * If set to true, the context menu in visualizations will be enabled.
+     * @version SDK: 1.1.0 | ThoughtSpot: 8.1.0.sw
+     * @deprecated this option is deprecated.
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
@@ -106,7 +108,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    enableVizTransformations:true,
      * })
      * ```
-     * @version: SDK: 1.1.0 | ThoughtSpot: 8.1.0.sw
      */
     enableVizTransformations?: boolean;
     /**
@@ -119,8 +120,9 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
      *    ... //other embed view config
-     *    liveboardId:id of liveboard,
+     *    liveboardId:'id of liveboard',
      * })
+     * ```
      */
     liveboardId?: string;
     /**
@@ -173,6 +175,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *       'f547ec54-2a37-4516-a222-2b06719af726'
      *     ]
      * })
+     * ```
      */
     visibleVizs?: string[];
     /**
@@ -200,6 +203,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * Specify the tab ID.
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
@@ -207,7 +211,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    activeTabId:'id-1234',
      * })
      * ```
-     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     activeTabId?: string;
     /**
@@ -216,6 +219,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * that includes specific filter selections.
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
@@ -224,7 +228,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    activeTabId: 'tab-guid',
      * })
      * ```
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      */
     personalizedViewId?: string;
     /**
@@ -245,13 +248,14 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * Show a preview image of the visualization before the visualization loads.
      * Only works for visualizations embeds with a viz id.
      *
-     * Also, viz snashot should be enabled in the ThoughtSpot instance.
+     * Also, viz snapshot should be enabled in the ThoughtSpot instance.
      * Contact ThoughtSpot support to enable this feature.
      *
-     * Since, this will show preview images, be careful that it may show
+     * Since this will show preview images, be careful that it may show
      * undesired data to the user when using row level security.
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
@@ -261,7 +265,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * });
      * embed.render();
      * ```
-     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl
      */
     showPreviewLoader?: boolean;
     /**
@@ -269,13 +272,14 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *
      * Supported embed types: `LiveboardEmbed`
      * @hidden
-     * @version SDK: 1.35.0 | ThoughtSpot:10.6.0.cl
+     * @version SDK: 1.35.0 | ThoughtSpot: 10.6.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
      *    ... //other embed view config
-     *    oAuthPollingInterval: value in milliseconds,
+     *    oAuthPollingInterval: 30000,
      * })
+     * ```
      */
     oAuthPollingInterval?: number;
 
@@ -284,36 +288,39 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *
      * Supported embed types: `LiveboardEmbed`
      * @hidden
-     * @version SDK: 1.35.0 | ThoughtSpot:10.6.0.cl
+     * @version SDK: 1.35.0 | ThoughtSpot: 10.6.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
      *    ... //other embed view config
      *    isForceRedirect: false,
      * })
+     * ```
      */
     isForceRedirect?: boolean;
 
     /**
      * The source connection ID for authentication.
-     * @hidden
-     * @version SDK: 1.35.0 | ThoughtSpot:10.6.0.cl
      *
      * Supported embed types: `LiveboardEmbed`
+     * @hidden
+     * @version SDK: 1.35.0 | ThoughtSpot: 10.6.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
      *    ... //other embed view config
      *    dataSourceId: '',
      * })
+     * ```
      */
     dataSourceId?: string;
     /**
-     * The list of tab IDs to hide from the embedded.
-     * This Tabs will be hidden from their respective LBs.
-     * Use this to hide an tabID.
+     * The list of tab IDs to hide from the embedded Liveboard.
+     * These tabs will be hidden from their respective Liveboards.
+     * Use this to hide a tab ID.
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 10.1.0.sw
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
@@ -324,7 +331,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *   ]
      * });
      * ```
-     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 10.1.0.sw
      */
     hiddenTabs?: string[];
     /**
@@ -348,7 +354,8 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      */
     visibleTabs?: string[];
     /**
-     * This flag is used to enable/disable the styling and grouping in a Liveboard
+     * This flag is used to enable/disable the styling and grouping in a Liveboard. Use {@link isLiveboardMasterpiecesEnabled} instead.
+     * @deprecated This flag is deprecated.
      *
      * Supported embed types: `LiveboardEmbed`, `AppEmbed`
      * @type {boolean}
@@ -414,6 +421,9 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
     /**
      * This flag is used to enable the full height lazy load data.
      *
+     * @type {boolean}
+     * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+     * @default false
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed-container', {
@@ -422,33 +432,29 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    lazyLoadingForFullHeight: true,
      * })
      * ```
-     *
-     * @type {boolean}
-     * @default false
-     * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
      */
     lazyLoadingForFullHeight?: boolean;
     /**
      * The margin to be used for lazy loading.
      *
      * For example, if the margin is set to '10px',
-     * the visualization will be loaded 10px before the its top edge is visible in the
+     * the visualization will be loaded 10px before its top edge is visible in the
      * viewport.
      *
      * The format is similar to CSS margin.
      *
+     * @type {string}
+     * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed-container', {
      *    // ...other options
      *    fullHeight: true,
      *    lazyLoadingForFullHeight: true,
-     *   // Using 0px, the visualization will be only loaded when its visible in the viewport.
+     *   // Using 0px, the visualization will be only loaded when it's visible in the viewport.
      *    lazyLoadingMargin: '0px',
      * })
      * ```
-     * @type {string}
-     * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
      */
     lazyLoadingMargin?: string;
     /**
@@ -456,6 +462,8 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * of the spotter underneath the chat input.
      * default is false.
      *
+     * @type {boolean}
+     * @version SDK: 1.41.1 | ThoughtSpot: 10.5.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#embed-container', {
@@ -463,14 +471,13 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    showSpotterLimitations: true,
      * })
      * ```
-     * @type {boolean}
-     * @version SDK: 1.41.1 | ThoughtSpot: 10.5.0.cl
      */
     showSpotterLimitations?: boolean;
     /**
      * updatedSpotterChatPrompt : Controls the updated spotter chat prompt.
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      * @default false
      * @example
      * ```js
@@ -479,7 +486,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    updatedSpotterChatPrompt : true,
      * })
      * ```
-     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      */
     updatedSpotterChatPrompt?: boolean;
     /**
@@ -487,6 +493,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * branding in tool response cards.
      *
      * Supported embed types: `LiveboardEmbed`
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * const embed = new LiveboardEmbed('#tsEmbed', {
@@ -497,7 +504,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      *    },
      * })
      * ```
-     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      */
     spotterChatConfig?: SpotterChatViewConfig;
 }
@@ -506,6 +512,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
  * Embed a ThoughtSpot Liveboard or visualization. When rendered it already
  * waits for the authentication to complete, so you need not wait for
  * `AuthStatus.SUCCESS`.
+ * @group Embed components
  * @example
  * ```js
  * import { .. } from '@thoughtspot/visual-embed-sdk';
@@ -515,7 +522,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
  * // .. other params here.
  * })
  * ```
- * @group Embed components
  */
 export class LiveboardEmbed extends V1Embed {
     protected viewConfig: LiveboardViewConfig;