@thoughtspot/visual-embed-sdk 1.50.0 → 1.51.0-test

package/src/embed/app.ts

@@ -10,6 +10,7 @@
 
 import { logger } from '../utils/logger';
 import { calculateVisibleElementData, getEffectiveClippingAncestors, getQueryParamString, getScrollableAncestors, isUndefined, isValidCssMargin, setParamIfDefined } from '../utils';
+import { DEFAULT_LAZY_LOADING_MARGIN } from '../config';
 import {
     Param,
     DOMSelector,
@@ -22,8 +23,8 @@ import {
     SpotterFileUploadFileTypes,
 } from '../types';
 import { V1Embed } from './ts-embed';
-import { SpotterChatViewConfig, SpotterSidebarViewConfig } from './conversation';
-import { buildSpotterSidebarAppInitData } from './spotter-utils';
+import { SpotterChatViewConfig, SpotterSidebarViewConfig, SpotterQueryMode, SpotterShareConversationConfig, StarterPromptsConfig } from './conversation';
+import { buildSpotterSidebarAppInitData, buildSpotterShareConversationAppInitData, buildStarterPromptsAppInitData } from './spotter-utils';
 import { SpotterVizConfig, buildSpotterVizAppInitData } from './spotter-viz-utils';
 
 /**
@@ -63,6 +64,14 @@ export enum Page {
      *  Monitor Alerts Page
      */
     Monitor = 'monitor',
+    /**
+     * Collections listing page
+     */
+    Collections = 'collections',
+    /**
+     * Liveboard schedules listing page
+     */
+    LiveboardSchedules = 'liveboard-schedules',
 }
 
 /**
@@ -111,6 +120,9 @@ export enum HomePage {
     /**
      * Modular (v2) introduces the updated Modular Home Experience.
      * It serves as the foundational version of the home page.
+     * Use {@link HomePage.ModularWithStylingChanges} (V3) or
+     * {@link HomePage.Focused} (V4) instead.
+     * @deprecated V1 and V2 home page experiences are deprecated.
      */
     Modular = 'v2',
     /**
@@ -120,7 +132,7 @@ export enum HomePage {
     ModularWithStylingChanges = 'v3',
     /**
      * Focused (v4) introduces the V4 homepage experience
-     * in which Watchlist and recents and incorporated together 
+     * in which Watchlist and recents and incorporated together
      * to form a more focused homepage.
      * Pre-requisite : spotter enablement
      * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
@@ -187,13 +199,14 @@ export interface AppViewConfig extends AllEmbedViewConfig {
     showPrimaryNavbar?: boolean;
     /**
      * Control the visibility of the left navigation panel on the home page
-     * in the V2 and V3 navigation and home page experience.
+     * in the V3 and V4 navigation and home page experience.
      * If `showPrimaryNavbar` is true, that is, if the Global and Homepage
      * navigation bars are visible, this flag will only hide the left navigation bar
      * on the home page.
      * The `showPrimaryNavbar` flag takes precedence over the `hideHomepageLeftNav`.
      *
-     * **Note**: This attribute is not supported in the classic (V1) experience.
+     * **Note**: The classic (V1) and Modular (V2) home page experiences are
+     * deprecated. This attribute applies to V3 and V4 home page experiences.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
@@ -259,11 +272,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
     hideHamburger?: boolean;
     /**
      * Control the visibility of the object search
-     * on the top navigation bar in the
-     * V2 and V3 navigation experience.
+     * on the top navigation bar in the V3 navigation experience.
      *
-     * **Note**: This attribute is not supported
-     * in the classic (V1) experience.
+     * **Note**: The classic (V1) and V2 navigation experiences are
+     * deprecated. This attribute applies to the V3 navigation experience.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -281,8 +293,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * Control the visibility of the notification icon
      * on the top navigation bar in V3 navigation experience.
      *
-     * **Note**: This attribute is not supported
-     * in the classic (V1) and V2 experience modes.
+     * **Note**: The classic (V1) and V2 experience modes are deprecated.
+     * This attribute applies to the V3 experience.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -297,14 +309,14 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      */
     hideNotification?: boolean;
     /**
-     * Control the visibility of the application selection menu
-     * in the top navigation bar in the V2 experience.
+     * Control the visibility of the application selection menu.
      * In the V3 experience, it shows or hides application selection
      * icons on the left navigation panel.
      * By default, the application selection menu and icons are
      * shown in the UI.
      *
-     * **Note**: This attribute is not supported in the classic (V1) experience.
+     * **Note**: The classic (V1) and V2 experiences are deprecated.
+     * This attribute applies to the V3 experience.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
@@ -322,7 +334,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * Control the visibility of the Org switcher button on the nav-bar.
      * By default, the Org switcher button is shown.
      *
-     * **Note**: This attribute is not supported in the classic (V1) experience.
+     * **Note**: The classic (V1) experience is deprecated. This attribute
+     * applies to V2 (deprecated), V3 and V4 experiences.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
@@ -463,6 +476,11 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * `false` fetches visualizations incrementally as
      * users scroll the page to view the charts and tables.
      *
+     * From SDK 1.52.0, enabling `fullHeight` also turns on
+     * {@link lazyLoadingForFullHeight} and
+     * {@link enableScrollableContainerLazyLoading}, so visualizations load as
+     * they scroll into view. Set either flag to `false` to opt out.
+     *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.21.0 | ThoughtSpot: 9.4.0.cl, 9.4.0-sw
      * @example
@@ -481,6 +499,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
      * @default false
+     * Use the discoveryExperience.homePage option with
+     * {@link HomePage.ModularWithStylingChanges} (V3) or
+     * {@link HomePage.Focused} (V4) instead.
+     * @deprecated The V1 and V2 home page experiences are deprecated.
      * @example
      * ```js
      * const embed = new AppEmbed('#tsEmbed', {
@@ -616,11 +638,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
     /**
      * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
      * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
-     * This feature is GA from version 26.5.0.cl. It is disabled by default in embed deployments.
+     * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.8.0.cl.
      *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @type {boolean}
      * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     * @default true
      * @example
      * ```js
      * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -634,10 +657,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 
     /**
      * This flag is used to enable/disable the XLSX/CSV download option for Liveboards
+     * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.6.0.cl
      *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @type {boolean}
      * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @default true
      * @example
      * ```js
      * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -651,10 +676,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 
     /**
      * This flag is used to enable/disable the granular XLSX/CSV schedules feature
+     * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.6.0.cl
      *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @type {boolean}
      * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     * @default true
      * @example
      * ```js
      * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -667,11 +694,17 @@ export interface AppViewConfig extends AllEmbedViewConfig {
     isGranularXLSXCSVSchedulesEnabled?: boolean;
 
     /**
-     * This flag is used to enable the full height lazy load data.
+     * Loads visualizations only as they scroll into the viewport, instead of
+     * loading the whole full-height Liveboard at once.
+     *
+     * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
+     * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
+     * set explicitly. Set it to `false` to load every visualization upfront.
+     * The flag has no effect unless `fullHeight` is enabled.
      *
      * @type {boolean}
      * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
-     * @default false
+     * @default true when `fullHeight` is enabled, from SDK 1.52.0
      * @example
      * ```js
      * const embed = new AppEmbed('#embed-container', {
@@ -683,28 +716,44 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      */
     lazyLoadingForFullHeight?: boolean;
     /**
-     * This flag is used to enable container-aware full height lazy loading.
+     * Computes the visible region of the embed against its scrollable and
+     * clipping ancestors, instead of treating the browser window as the only
+     * viewport, and tracks scroll and resize on those ancestors.
      *
-     * Use this when the embed is rendered inside a scrollable or clipping
-     * container instead of relying on the browser window as the only viewport.
+     * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
+     * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
+     * set explicitly. Set it to `false` when the page scrolls with the window
+     * and the embed has no clipping ancestor, to skip the extra ancestor
+     * tracking.
      *
      * @type {boolean}
-     * @default false
+     * @default true when `fullHeight` is enabled, from SDK 1.52.0
      * @hidden
      */
     enableScrollableContainerLazyLoading?: boolean;
 
     /**
-     * The margin to be used for lazy loading.
+     * How far outside the viewport a visualization starts loading, when
+     * {@link lazyLoadingForFullHeight} is enabled.
      *
      * For example, if the margin is set to '10px',
      * the visualization will be loaded 10px before its top edge is visible in the
      * viewport.
      *
-     * The format is similar to CSS margin.
+     * The format is similar to CSS margin, so `'500px 0px'` extends the
+     * prefetch 500px above and below the viewport and not sideways. Accepted
+     * units are `px`, `em`, `rem`, `%`, `vh` and `vw`, plus bare `0` and
+     * `auto`; an invalid value is logged and ignored.
+     *
+     * From SDK 1.52.0 this defaults to `'500px 0px'` — roughly one
+     * visualization ahead of the scroll position, so a chart has usually
+     * finished loading by the time it scrolls into view. Use a smaller margin
+     * to cut warehouse queries further, or `'0px'` to load a visualization
+     * only once it is actually visible.
      *
      * @type {string}
      * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+     * @default '500px 0px' when `fullHeight` is enabled, from SDK 1.52.0
      * @example
      * ```js
      * const embed = new AppEmbed('#embed-container', {
@@ -733,6 +782,40 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * ```
      */
     updatedSpotterChatPrompt?: boolean;
+    /**
+     * showSpotterRadiance : Controls the radiance on the Spotter page.
+     *
+     * Supported embed types: `AppEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @default false
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... //other embed view config
+     *    showSpotterRadiance : true,
+     * })
+     * ```
+     */
+    showSpotterRadiance?: boolean;
+    /**
+     * Sets the default query mode when Spotter loads — Fast Search or
+     * Research Mode. Applies fresh on every new session for this embed
+     * instance only; it does not persist as a user preference and does
+     * not affect other embeds or native ThoughtSpot usage.
+     * Only applicable when navigating to Spotter within the app.
+     *
+     * Supported embed types: `AppEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @default SpotterQueryMode.FAST_SEARCH
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... //other embed view config
+     *    defaultQueryMode: SpotterQueryMode.RESEARCH,
+     * })
+     * ```
+     */
+    defaultQueryMode?: SpotterQueryMode;
     /**
      * Controls the visibility of the past conversations sidebar.
      *
@@ -758,6 +841,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      *    spotterSidebarConfig: {
      *        enablePastConversationsSidebar: true,
      *        spotterSidebarTitle: 'My Conversations',
+     *        // Opt in to pin/unpin conversations in embedded Spotter
+     *        spotterChatPinConfig: {
+     *            enabled: true,
+     *        },
      *    },
      * })
      * ```
@@ -781,6 +868,49 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * ```
      */
     spotterChatConfig?: SpotterChatViewConfig;
+    /**
+     * Configuration for the Spotter conversation sharing feature.
+     *
+     * Supported embed types: `AppEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... //other embed view config
+     *    spotterShareConversationConfig: {
+     *        enableShareConversation: true,
+     *    },
+     * })
+     * ```
+     */
+    spotterShareConversationConfig?: SpotterShareConversationConfig;
+    /**
+     * Sets the default data sources (Models) for the Spotter experience shown on
+     * the home page of the full app embed. Accepts a list of Model GUIDs to
+     * preselect the data sources available to Spotter, or the literal
+     * `'auto_mode'` sentinel to load Spotter with the "Auto" model selected by
+     * default. This is consistent with how `worksheetId: 'auto_mode'` enables
+     * Auto mode in `SpotterEmbed`.
+     *
+     * **Note**: If `'auto_mode'` is included alongside one or more Model GUIDs,
+     * `'auto_mode'` takes precedence and is selected by default.
+     *
+     * **Note**: `'auto_mode'` requires the Spotter 3 experience with data source
+     * discovery enabled on your instance, and a Spotter-enabled home page (for
+     * example, `discoveryExperience.homePage: HomePage.Focused`).
+     *
+     * Supported embed types: `AppEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.10.0.cl
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... // other embed view config
+     *    discoveryExperience: { homePage: HomePage.Focused },
+     *    spotterDataSources: ['model-guid-1', 'model-guid-2'], // or ['auto_mode']
+     * })
+     * ```
+     */
+    spotterDataSources?: string[];
     /**
      * Configuration for the SpotterViz interface shown on the Liveboard.
      * Customize the brand name, description, chat input placeholder,
@@ -799,12 +929,17 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      *        inputChatPlaceholder: 'Ask a question...',
      *        hideStarterPrompts: false,
      *        customStarterPrompts: [{ id: '1', displayText: 'Top products', fullPrompt: 'What are the top products by revenue?' }],
-     *        // loaderHeadline and loaderTips require SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+     *        // The options below require SDK: 1.51.0
      *        loaderHeadline: 'Crunching the numbers...',
      *        loaderTips: [
      *            { label: 'Tip', text: 'try asking about revenue by region' },
      *            { label: 'Tip', text: 'use natural language' },
      *        ],
+     *        liveboardBrandName: 'Reports',
+     *        spotterBrandName: 'Analyst',
+     *        insightTileBrandName: 'Insight card',
+     *        insightTileViewPlanLabel: 'View plan',
+     *        insightTileLoaderText: 'Generating insight',
      *    },
      * })
      * ```
@@ -871,6 +1006,22 @@ export interface AppViewConfig extends AllEmbedViewConfig {
      * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
      */
     visualOverrides?: VisualizationOverrides;
+
+    /**
+     * updatedSpotterExperience : Controls the updated Spotter experience.
+     *
+     * Supported embed types: `AppEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @default false
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... //other embed view config
+     *    updatedSpotterExperience : true,
+     * })
+     * ```
+     */
+    updatedSpotterExperience?: boolean;
 }
 
 /**
@@ -881,6 +1032,8 @@ export interface AppEmbedAppInitData extends DefaultAppInitData {
     embedParams?: {
         spotterSidebarConfig?: SpotterSidebarViewConfig;
         spotterVizConfig?: SpotterVizConfig;
+        spotterShareConversationConfig?: SpotterShareConversationConfig;
+        starterPrompts?: StarterPromptsConfig;
     };
 }
 
@@ -901,6 +1054,16 @@ export class AppEmbed extends V1Embed {
         viewConfig.embedComponentType = 'AppEmbed';
         super(domSelector, viewConfig);
         if (this.viewConfig.fullHeight === true) {
+            if (this.viewConfig.lazyLoadingForFullHeight === undefined) {
+                this.viewConfig.lazyLoadingForFullHeight = true;
+            }
+            if (this.viewConfig.enableScrollableContainerLazyLoading === undefined) {
+                this.viewConfig.enableScrollableContainerLazyLoading = true;
+            }
+            if (this.viewConfig.lazyLoadingMargin === undefined) {
+                this.viewConfig.lazyLoadingMargin = DEFAULT_LAZY_LOADING_MARGIN;
+            }
+
             this.on(EmbedEvent.RouteChange, this.setIframeHeightForNonEmbedLiveboard);
             this.on(EmbedEvent.EmbedHeight, this.updateIFrameHeight);
             this.on(EmbedEvent.EmbedIframeCenter, this.embedIframeCenter);
@@ -930,7 +1093,9 @@ export class AppEmbed extends V1Embed {
             this.viewConfig,
             this.handleError.bind(this),
         );
-        return buildSpotterVizAppInitData(sidebarInitData, this.viewConfig);
+        const vizInitData = buildSpotterVizAppInitData(sidebarInitData, this.viewConfig);
+        const shareInitData = buildSpotterShareConversationAppInitData(vizInitData, this.viewConfig);
+        return buildStarterPromptsAppInitData(shareInitData, this.viewConfig);
     }
 
     /**
@@ -938,6 +1103,11 @@ export class AppEmbed extends V1Embed {
      * embedded Liveboard or visualization.
      */
     protected getEmbedParams() {
+        const params = this.getEmbedParamsObject();
+        return getQueryParamString(params, true);
+    }
+
+    protected getEmbedParamsObject() {
         const {
             tag,
             hideTagFilterChips,
@@ -954,44 +1124,51 @@ export class AppEmbed extends V1Embed {
             newConnectionsExperience,
             fullHeight,
             dataPanelV2 = true,
+            updatedSpotterExperience,
             hideLiveboardHeader = false,
             showLiveboardTitle = true,
             showLiveboardDescription = true,
             showMaskedFilterChip = false,
-            isLiveboardMasterpiecesEnabled = false,
+            isLiveboardMasterpiecesEnabled,
             newChartsLibrary,
             hideHomepageLeftNav = false,
-            modularHomeExperience = false,
+            modularHomeExperience,
             isLiveboardHeaderSticky = true,
             enableAskSage,
             collapseSearchBarInitially = false,
             enable2ColumnLayout,
+            isLiveboardAlwaysOn12ColLayout,
             enableCustomColumnGroups = false,
             dataPanelCustomGroupsAccordionInitialState = DataPanelCustomColumnGroupsAccordionState.EXPAND_ALL,
             collapseSearchBar = true,
-            isLiveboardCompactHeaderEnabled = false,
+            isLiveboardCompactHeaderEnabled,
             showLiveboardVerifiedBadge = true,
             showLiveboardReverifyBanner = true,
-            hideIrrelevantChipsInLiveboardTabs = false,
-            isEnhancedFilterInteractivityEnabled = false,
+            hideIrrelevantChipsInLiveboardTabs,
+            isEnhancedFilterInteractivityEnabled,
             homePageSearchBarMode,
             isUnifiedSearchExperienceEnabled = true,
             enablePendoHelp = true,
             discoveryExperience,
-            coverAndFilterOptionInPDF = false,
+            coverAndFilterOptionInPDF,
             isLiveboardStylingAndGroupingEnabled,
+            liveboardGutter,
             isPNGInScheduledEmailsEnabled = false,
-            isLiveboardXLSXCSVDownloadEnabled = false,
-            isGranularXLSXCSVSchedulesEnabled = false,
+            isLiveboardXLSXCSVDownloadEnabled,
+            isGranularXLSXCSVSchedulesEnabled,
             isCentralizedLiveboardFilterUXEnabled = false,
+            isScopedLiveboardFilteringEnabled,
             isLinkParametersEnabled,
             updatedSpotterChatPrompt,
+            showSpotterRadiance,
+            defaultQueryMode,
             enableStopAnswerGenerationEmbed,
             spotterChatConfig,
+            spotterDataSources,
             minimumHeight,
             isThisPeriodInDateFiltersEnabled,
             enableHomepageAnnouncement = false,
-            isContinuousLiveboardPDFEnabled = false,
+            isContinuousLiveboardPDFEnabled,
             enableLiveboardDataCache,
         } = this.viewConfig;
 
@@ -1004,31 +1181,52 @@ export class AppEmbed extends V1Embed {
         params[Param.ShowLiveboardTitle] = showLiveboardTitle;
         params[Param.ShowLiveboardDescription] = !!showLiveboardDescription;
         params[Param.ShowMaskedFilterChip] = showMaskedFilterChip;
-        params[Param.IsLiveboardMasterpiecesEnabled] = isLiveboardMasterpiecesEnabled;
+        if (!isUndefined(isLiveboardMasterpiecesEnabled)) {
+            params[Param.IsLiveboardMasterpiecesEnabled] = isLiveboardMasterpiecesEnabled;
+        }
         if (newChartsLibrary !== undefined) {
             params[Param.EnableNewChartLibrary] = newChartsLibrary;
         }
         params[Param.LiveboardHeaderSticky] = isLiveboardHeaderSticky;
         params[Param.IsFullAppEmbed] = true;
-        params[Param.LiveboardHeaderV2] = isLiveboardCompactHeaderEnabled;
-        params[Param.IsEnhancedFilterInteractivityEnabled] = isEnhancedFilterInteractivityEnabled;
+        if (!isUndefined(isLiveboardCompactHeaderEnabled)) {
+            params[Param.LiveboardHeaderV2] = isLiveboardCompactHeaderEnabled;
+        }
+        if (!isUndefined(isEnhancedFilterInteractivityEnabled)) {
+            params[Param.IsEnhancedFilterInteractivityEnabled] =
+                isEnhancedFilterInteractivityEnabled;
+        }
         params[Param.ShowLiveboardVerifiedBadge] = showLiveboardVerifiedBadge;
         params[Param.ShowLiveboardReverifyBanner] = showLiveboardReverifyBanner;
-        params[Param.HideIrrelevantFiltersInTab] = hideIrrelevantChipsInLiveboardTabs;
+        if (!isUndefined(hideIrrelevantChipsInLiveboardTabs)) {
+            params[Param.HideIrrelevantFiltersInTab] = hideIrrelevantChipsInLiveboardTabs;
+        }
         if (isUnifiedSearchExperienceEnabled !== undefined) {
             params[Param.IsUnifiedSearchExperienceEnabled] = isUnifiedSearchExperienceEnabled;
         }
-        params[Param.CoverAndFilterOptionInPDF] = !!coverAndFilterOptionInPDF;
+        if (!isUndefined(coverAndFilterOptionInPDF)) {
+            params[Param.CoverAndFilterOptionInPDF] = !!coverAndFilterOptionInPDF;
+        }
 
         params = this.getBaseQueryParams(params);
 
         if (!isUndefined(updatedSpotterChatPrompt)) {
             params[Param.UpdatedSpotterChatPrompt] = !!updatedSpotterChatPrompt;
         }
+        if (!isUndefined(showSpotterRadiance)) {
+            params[Param.ShowSpotterRadiance] = !!showSpotterRadiance;
+        }
+        if (!isUndefined(defaultQueryMode)) {
+            params[Param.DefaultQueryMode] = defaultQueryMode;
+        }
         if (!isUndefined(enableStopAnswerGenerationEmbed)) {
             params[Param.EnableStopAnswerGenerationEmbed] = !!enableStopAnswerGenerationEmbed;
         }
 
+        if (spotterDataSources && spotterDataSources.length) {
+            params[Param.SpotterDataSources] = JSON.stringify(spotterDataSources);
+        }
+
         // Handle spotterChatConfig params
         if (spotterChatConfig) {
             const {
@@ -1037,6 +1235,7 @@ export class AppEmbed extends V1Embed {
                 spotterFileUploadEnabled,
                 spotterFileUploadFileTypes,
                 enableStarterPrompts,
+                openSpotterOnLiveboardByDefault,
             } = spotterChatConfig;
 
             setParamIfDefined(params, Param.HideToolResponseCardBranding, hideToolResponseCardBranding, true);
@@ -1047,11 +1246,18 @@ export class AppEmbed extends V1Embed {
             if (enableStarterPrompts !== undefined) {
                 params[Param.IsStarterPromptsEnabled] = enableStarterPrompts;
             }
+            if (openSpotterOnLiveboardByDefault !== undefined) {
+                params[Param.OpenSpotterOnLiveboardByDefault] = openSpotterOnLiveboardByDefault;
+            }
             if (spotterFileUploadFileTypes !== undefined) {
                 params[Param.SpotterFileUploadFileTypes] = JSON.stringify(spotterFileUploadFileTypes);
             }
         }
 
+        if (!isUndefined(updatedSpotterExperience)) {
+            params[Param.UpdatedSpotterExperience] = !!updatedSpotterExperience;
+        }
+
         if (hideObjectSearch) {
             params[Param.HideObjectSearch] = !!hideObjectSearch;
         }
@@ -1095,6 +1301,9 @@ export class AppEmbed extends V1Embed {
         if (enable2ColumnLayout !== undefined) {
             params[Param.Enable2ColumnLayout] = enable2ColumnLayout;
         }
+        if (isLiveboardAlwaysOn12ColLayout !== undefined) {
+            params[Param.IsLiveboardAlwaysOn12ColLayout] = isLiveboardAlwaysOn12ColLayout;
+        }
 
         if (enableAskSage) {
             params[Param.enableAskSage] = enableAskSage;
@@ -1114,6 +1323,10 @@ export class AppEmbed extends V1Embed {
             ] = isLiveboardStylingAndGroupingEnabled;
         }
 
+        if (liveboardGutter !== undefined) {
+            params[Param.LiveboardGutter] = liveboardGutter;
+        }
+
         if (isPNGInScheduledEmailsEnabled !== undefined) {
             params[Param.isPNGInScheduledEmailsEnabled] = isPNGInScheduledEmailsEnabled;
         }
@@ -1140,6 +1353,12 @@ export class AppEmbed extends V1Embed {
             ] = isCentralizedLiveboardFilterUXEnabled;
         }
 
+        if (isScopedLiveboardFilteringEnabled !== undefined) {
+            params[
+                Param.isScopedLiveboardFilteringEnabled
+            ] = isScopedLiveboardFilteringEnabled;
+        }
+
         if (isThisPeriodInDateFiltersEnabled !== undefined) {
             params[Param.IsThisPeriodInDateFiltersEnabled] = isThisPeriodInDateFiltersEnabled;
         }
@@ -1160,7 +1379,6 @@ export class AppEmbed extends V1Embed {
 
         params[Param.DataPanelV2Enabled] = dataPanelV2;
         params[Param.HideHomepageLeftNav] = hideHomepageLeftNav;
-        params[Param.ModularHomeExperienceEnabled] = modularHomeExperience;
         params[Param.CollapseSearchBarInitially] = collapseSearchBarInitially || collapseSearchBar;
         params[Param.EnableCustomColumnGroups] = enableCustomColumnGroups;
         if (dataPanelCustomGroupsAccordionInitialState
@@ -1181,41 +1399,21 @@ export class AppEmbed extends V1Embed {
             params[Param.ModularHomeExperienceEnabled] = modularHomeExperience;
         }
 
-        // Set navigation to v2 by default to avoid problems like the app
-        // switcher (9-dot menu) not showing when v3 navigation is turned on
-        // at the cluster level.
-        // To use v3 navigation, we must manually set the discoveryExperience
-        // settings.
-        params[Param.NavigationVersion] = 'v2';
-        // Set homePageVersion to v2 by default to reset the LD flag value
-        // for the homepageVersion.
-        params[Param.HomepageVersion] = 'v2';
-        if (discoveryExperience) {
-            // primaryNavbarVersion v3 will enabled the new left navigation
-            if (discoveryExperience.primaryNavbarVersion === PrimaryNavbarVersion.Sliding) {
-                params[Param.NavigationVersion] = discoveryExperience.primaryNavbarVersion;
-                // Enable the modularHomeExperience when Sliding is enabled.
-                params[Param.ModularHomeExperienceEnabled] = true;
-            }
-
-            // homePage v2 will enable the modular home page
-            // and it will override the modularHomeExperience value
-            if (discoveryExperience.homePage === HomePage.Modular) {
-                params[Param.ModularHomeExperienceEnabled] = true;
-            }
-
-            // ModularWithStylingChanges (v3) introduces the styling changes
-            // to the Modular Homepage.
-            // v3 will be the base version of homePageVersion.
-            if (discoveryExperience.homePage === HomePage.ModularWithStylingChanges) {
-                params[Param.HomepageVersion] = HomePage.ModularWithStylingChanges;
-            }
+        // Navigation V1/V2 and home page V1/V2 are deprecated. V3 is now the
+        // default experience, Need to send navigationVersion=v3 and
+        // homepageVersion=v3 even when the no discoveryExperience / 
+        // modularHomeExperience config is set. Without these
+        // params, older TSA versions (< 26.7) fall back to V2 for nav and
+        // home page, so the defaults must be sent explicitly from the SDK.
+        params[Param.NavigationVersion] = PrimaryNavbarVersion.Sliding;
+        params[Param.HomepageVersion] = HomePage.ModularWithStylingChanges;
 
+        if (discoveryExperience) {
             // listPageVersion can be changed to v2 or v3
             if (discoveryExperience.listPageVersion !== undefined) {
                 params[Param.ListPageVersion] = discoveryExperience.listPageVersion;
             }
-
+            
             if (discoveryExperience.homePage === HomePage.Focused) {
                 params[Param.HomepageVersion] = HomePage.Focused;
                 // The Focused (V4) homepage experience requires the updated
@@ -1227,9 +1425,7 @@ export class AppEmbed extends V1Embed {
             }
         }
 
-        const queryParams = getQueryParamString(params, true);
-
-        return queryParams;
+        return params;
     }
 
     private sendFullHeightLazyLoadData = () => {
@@ -1332,6 +1528,10 @@ export class AppEmbed extends V1Embed {
                 return modularHomeExperience ? 'home/spotiq-analysis' : 'insights/results';
             case Page.Monitor:
                 return modularHomeExperience ? 'home/monitor-alerts' : 'insights/monitor-alerts';
+            case Page.Collections:
+                return 'collections';
+            case Page.LiveboardSchedules:
+                return 'home/liveboard-schedules';
             case Page.Home:
             default:
                 return 'home';
@@ -1372,7 +1572,8 @@ export class AppEmbed extends V1Embed {
             logger.log('Please call render before invoking this method');
             return;
         }
-        if (noReload) {
+        const overrideHistoryState = this.viewConfig?.overrideHistoryState;
+        if (noReload || overrideHistoryState) {
             this.trigger(HostEvent.Navigate, path);
         } else {
             if (typeof path !== 'string') {