@thoughtspot/visual-embed-sdk 1.49.1 → 1.49.2

package/dist/tsembed.js

@@ -1,4 +1,4 @@
-/* @thoughtspot/visual-embed-sdk version 1.49.1 */
+/* @thoughtspot/visual-embed-sdk version 1.49.2 */
 'use client';
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
@@ -2249,11 +2249,30 @@
         /**
          * Navigate to a specific page in the embedded ThoughtSpot application.
          * This is the same as calling `appEmbed.navigateToPage(path, true)`.
-         * @param - `path` - the path to navigate to go forward or back. The path value can
-         * be a number; for example, `1`, `-1`.
+         *
+         * Accepts either a plain value or an object with `path`
+         * and an optional `replace` flag.
+         *
+         * @param data - A string path, a numeric history delta, or an object
+         *   `{ path: string | number, replace?: boolean }`.
+         *   - `path` — the route to navigate to, or a history delta such as `1`
+         *     or `-1` (calls `window.history.go()`).
+         *   - `replace` — when `true`, replaces the current history entry instead
+         *     of pushing a new one (uses `window.location.replace`).
+         *
          * @example
          * ```js
-         * appEmbed.navigateToPage(-1)
+         * // Preferred: use navigateToPage directly
+         * appEmbed.navigateToPage(-1);
+         *
+         * // Numeric delta — go back one step
+         * appEmbed.trigger(HostEvent.Navigate, -1);
+         *
+         * // String path — push a new history entry
+         * appEmbed.trigger(HostEvent.Navigate, 'home');
+         *
+         * // Object format — replace current history entry
+         * appEmbed.trigger(HostEvent.Navigate, { path: 'home', replace: true }); // SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
          * ```
          * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw
          */
@@ -4242,6 +4261,7 @@
         Param["EnableLiveboardDataCache"] = "enableLiveboardDataCache";
         Param["SpotterFileUploadEnabled"] = "spotterFileUploadEnabled";
         Param["SpotterFileUploadFileTypes"] = "spotterFileUploadFileTypes";
+        Param["IsStarterPromptsEnabled"] = "enableStarterPrompts";
     })(Param || (Param = {}));
     /**
      * ThoughtSpot application pages include actions and menu commands
@@ -4884,6 +4904,16 @@
          * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
          */
         Action["AddToFavorites"] = "addToFavorites";
+        /**
+         * Remove from Favorites option in home page v3 sidebar.
+         * Allows removing an object from the user's favorites list from home-page v3 sidebar.
+         * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+         * @example
+         * ```js
+         * disabledActions: [Action.RemoveFromFavorites]
+         * ```
+         */
+        Action["RemoveFromFavorites"] = "removeFromFavorites";
         /**
          * The edit icon on Liveboards (Classic experience).
          * @example
@@ -5941,6 +5971,20 @@
          * ```
          */
         Action["SpotterViz"] = "spotterViz";
+        /**
+         * The reference-mode toggle button inside the SpotterViz chat input.
+         * When users enable reference mode, clicking tiles, filters, or
+         * parameters adds them as chat context. Hide this action to remove
+         * the reference-mode capability entirely.
+         * Visible by default.
+         * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+         * @example
+         * ```js
+         * hiddenActions: [Action.SpotterVizReferenceMode]
+         * disabledActions: [Action.SpotterVizReferenceMode]
+         * ```
+         */
+        Action["SpotterVizReferenceMode"] = "spotterVizReferenceMode";
         /**
          * Clears browser cache and fetches new data for liveboard ChartViz Containers.
          * Requires `enableLiveboardDataCache` to be enabled.
@@ -6417,7 +6461,7 @@
         TableContentDensity["Compact"] = "COMPACT";
     })(exports.TableContentDensity || (exports.TableContentDensity = {}));
 
-    var version$1="1.49.1";var pkg = {version:version$1};
+    var version$1="1.49.2";var pkg = {version:version$1};
 
     const { version } = pkg;
 
@@ -6816,6 +6860,27 @@
     function getDOMNode(domSelector) {
         return typeof domSelector === 'string' ? document.querySelector(domSelector) : domSelector;
     }
+    /**
+     * Resolves a CSS selector to an element. `document.querySelector` cannot pierce
+     * shadow boundaries, so when the document lookup misses and a reference node is
+     * provided, this also searches the shadow root the reference node lives in —
+     * letting a selector target an element inside the same shadow root as the embed
+     * instead of silently falling back to the light DOM.
+     * @param selector CSS selector string.
+     * @param referenceNode Node whose shadow root is searched when the document lookup misses.
+     */
+    function querySelectorAcrossShadowRoot(selector, referenceNode) {
+        var _a;
+        const fromDocument = document.querySelector(selector);
+        if (fromDocument) {
+            return fromDocument;
+        }
+        const rootNode = (_a = referenceNode === null || referenceNode === void 0 ? void 0 : referenceNode.getRootNode) === null || _a === void 0 ? void 0 : _a.call(referenceNode);
+        if (typeof ShadowRoot !== 'undefined' && rootNode instanceof ShadowRoot) {
+            return rootNode.querySelector(selector);
+        }
+        return null;
+    }
     const deepMerge = (target, source) => merge(target, source);
     const getOperationNameFromQuery = (query) => {
         const regex = /(?:query|mutation)\s+(\w+)/;
@@ -19358,8 +19423,14 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 }
             }
             const channel = new MessageChannel();
+            // Close the messageChannel and resolve the promise if timeout.
+            const timeoutId = setTimeout(() => {
+                channel.port1.close();
+                res(new Error(ERROR_MESSAGE.TRIGGER_TIMED_OUT));
+            }, TRIGGER_TIMEOUT);
             channel.port1.onmessage = ({ data: responseData }) => {
                 var _a;
+                clearTimeout(timeoutId);
                 channel.port1.close();
                 const error = (responseData === null || responseData === void 0 ? void 0 : responseData.error) || ((_a = responseData === null || responseData === void 0 ? void 0 : responseData.data) === null || _a === void 0 ? void 0 : _a.error);
                 if (error) {
@@ -19369,11 +19440,6 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                     res(responseData);
                 }
             };
-            // Close the messageChannel and resolve the promise if timeout.
-            setTimeout(() => {
-                channel.port1.close();
-                res(new Error(ERROR_MESSAGE.TRIGGER_TIMED_OUT));
-            }, TRIGGER_TIMEOUT);
             return postIframeMessage(iFrame, { type: messageType, data, context }, thoughtSpotHost, channel);
         });
     }
@@ -20291,6 +20357,14 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
      */
     const THOUGHTSPOT_PARAM_PREFIX = 'ts-';
     const TS_EMBED_ID = '_thoughtspot-embed';
+    /**
+     * dataset key used to stash a custom preRenderContainer's original inline
+     * `position` while we override it to `relative`. Stored on the container (not
+     * per-instance) so the override can be reverted on destroy even when multiple
+     * pre-rendered embeds share the same container.
+     */
+    const PRERENDER_CONTAINER_ORIGINAL_POSITION_KEY = 'tsEmbedOriginalPosition';
+    const PRERENDER_WRAPPER_ID_PREFIX = 'tsEmbed-pre-render-wrapper-';
     /**
      * The event id map from v2 event names to v1 event id
      * v1 events are the classic embed events implemented in Blink v1
@@ -20326,6 +20400,8 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
              */
             this.shouldEncodeUrlQueryParams = false;
             this.defaultHiddenActions = [exports.Action.ReportError];
+            this.preRenderContainerEl = null;
+            this.containerScrollListener = null;
             /**
              * Handler for fullscreen change events
              */
@@ -21191,6 +21267,89 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             placeholder.id = id.placeHolder;
             return placeholder;
         }
+        /**
+         * Resolves the configured preRenderContainer to a live element, falling
+         * back to `document.body`. A string selector is re-queried on every call so
+         * a remounted container (E.g.: React replacing the node) resolves to the
+         * fresh element; an element passed directly cannot be re-resolved.
+         */
+        resolvePreRenderContainerTarget() {
+            var _a;
+            const containerConfig = this.viewConfig.preRenderContainer;
+            let container = null;
+            if (typeof containerConfig === 'string') {
+                try {
+                    // Resolve against the host's shadow root too, so a selector can
+                    // target a container inside the same shadow DOM as the embed —
+                    // document.querySelector alone cannot pierce shadow boundaries.
+                    container = querySelectorAcrossShadowRoot(containerConfig, this.hostElement);
+                }
+                catch (e) {
+                    logger$3.error(`Invalid CSS selector for preRenderContainer: ${containerConfig}`, e);
+                }
+            }
+            else if (containerConfig) {
+                container = containerConfig;
+            }
+            return (_a = container) !== null && _a !== void 0 ? _a : document.body;
+        }
+        /**
+         * Makes the container a positioning context for the absolutely positioned
+         * wrapper, stashing the original inline `position` on the element (once) so
+         * destroy() can restore it exactly, leaving no trace. Recording it on the
+         * element rather than per-instance lets the override be reverted even when
+         * embeds share the same container.
+         */
+        applyPreRenderContainerPositioning(container) {
+            if (container === document.body) {
+                return;
+            }
+            const pos = window.getComputedStyle(container).position;
+            if (pos === 'static') {
+                if (container.dataset[PRERENDER_CONTAINER_ORIGINAL_POSITION_KEY] === undefined) {
+                    container.dataset[PRERENDER_CONTAINER_ORIGINAL_POSITION_KEY] = container.style.position;
+                }
+                container.style.position = 'relative';
+            }
+        }
+        /**
+         * Re-attaches the wrapper to a live container when the previously resolved
+         * one has been detached or no longer holds the wrapper — e.g. the host app
+         * remounted a custom preRenderContainer, which would otherwise leave a stale
+         * reference and collapse the wrapper. Only string selectors can be
+         * re-resolved; a container passed as an element is left untouched.
+         */
+        reconcilePreRenderContainer() {
+            const wrapper = this.preRenderWrapper;
+            const stored = this.preRenderContainerEl;
+            // Nothing to reconcile until this instance resolved its container.
+            if (!wrapper || !stored) {
+                return;
+            }
+            const storedIsLive = stored === document.body || document.contains(stored);
+            if (storedIsLive && stored.contains(wrapper)) {
+                return;
+            }
+            const resolved = this.resolvePreRenderContainerTarget();
+            // Re-resolution yielded the same (still stale) element — nothing we can
+            // do, e.g. a detached container passed as an HTMLElement.
+            if (resolved === stored && stored.contains(wrapper)) {
+                return;
+            }
+            if (this.containerScrollListener && stored !== resolved) {
+                if (stored !== document.body) {
+                    stored.removeEventListener('scroll', this.containerScrollListener);
+                }
+                if (resolved !== document.body) {
+                    resolved.addEventListener('scroll', this.containerScrollListener);
+                }
+            }
+            this.applyPreRenderContainerPositioning(resolved);
+            if (wrapper.parentNode !== resolved) {
+                resolved.appendChild(wrapper);
+            }
+            this.preRenderContainerEl = resolved;
+        }
         insertIntoDOMForPreRender(child) {
             const preRenderChild = this.createPreRenderChild(child);
             const preRenderWrapper = this.createPreRenderWrapper();
@@ -21210,7 +21369,10 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             else {
                 this.hidePreRender();
             }
-            document.body.appendChild(preRenderWrapper);
+            const targetContainer = this.resolvePreRenderContainerTarget();
+            this.preRenderContainerEl = targetContainer;
+            this.applyPreRenderContainerPositioning(targetContainer);
+            targetContainer.appendChild(preRenderWrapper);
         }
         insertIntoDOM(child) {
             var _a;
@@ -21649,6 +21811,50 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             tsParams = tsParams ? `?${tsParams}` : '';
             return tsParams;
         }
+        /**
+         * Reverts the custom preRenderContainer's `position` to the value it had
+         * before we overrode it to `relative` (see insertIntoDOMForPreRender).
+         *
+         * We restore the original inline value rather than forcing `static`, and we
+         * skip the restore if another preRender wrapper is still mounted inside the
+         * same container — a shared container still needs the positioning context.
+         */
+        restorePreRenderContainerPosition() {
+            const container = this.preRenderContainerEl;
+            if (!container || container === document.body) {
+                return;
+            }
+            // Drop our reference up front so a destroyed embed never pins a
+            // detached container in memory; restoration uses the local handle.
+            this.preRenderContainerEl = null;
+            const originalPosition = container.dataset[PRERENDER_CONTAINER_ORIGINAL_POSITION_KEY];
+            if (originalPosition === undefined) {
+                // We never overrode this container's position; nothing to restore.
+                return;
+            }
+            // This instance's own wrapper has already been removed by now, so any
+            // match here belongs to another embed still sharing the container — it
+            // continues to rely on the positioning context, so leave it in place.
+            const hasOtherWrapper = container.querySelector(`[id^="${PRERENDER_WRAPPER_ID_PREFIX}"]`);
+            if (hasOtherWrapper) {
+                return;
+            }
+            container.style.position = originalPosition;
+            delete container.dataset[PRERENDER_CONTAINER_ORIGINAL_POSITION_KEY];
+        }
+        /**
+         * Detaches and clears the container scroll listener, if one is attached.
+         */
+        removeContainerScrollListener() {
+            if (!this.containerScrollListener) {
+                return;
+            }
+            const customContainer = this.preRenderContainerEl && this.preRenderContainerEl !== document.body
+                ? this.preRenderContainerEl
+                : null;
+            customContainer === null || customContainer === void 0 ? void 0 : customContainer.removeEventListener('scroll', this.containerScrollListener);
+            this.containerScrollListener = null;
+        }
         /**
          * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
          * @version SDK: 1.19.1 | ThoughtSpot: *
@@ -21657,8 +21863,10 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             var _a, _b, _c;
             try {
                 this.removeFullscreenChangeHandler();
+                this.removeContainerScrollListener();
                 this.unsubscribeToEvents();
                 (_a = this.preRenderWrapper) === null || _a === void 0 ? void 0 : _a.remove();
+                this.restorePreRenderContainerPosition();
                 if (!this.isRendered) {
                     return;
                 }
@@ -21768,15 +21976,19 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 }
                 this.hostElement.appendChild(this.insertedDomEl);
                 this.syncPreRenderStyle();
+                const customContainer = this.preRenderContainerEl && this.preRenderContainerEl !== document.body
+                    ? this.preRenderContainerEl
+                    : null;
+                if (customContainer && !this.containerScrollListener) {
+                    this.containerScrollListener = () => this.syncPreRenderStyle();
+                    customContainer.addEventListener('scroll', this.containerScrollListener);
+                }
                 if (!this.viewConfig.doNotTrackPreRenderSize) {
                     const observeTarget = (_a = this.insertedDomEl) !== null && _a !== void 0 ? _a : this.hostElement;
                     this.resizeObserver = new ResizeObserver((entries) => {
                         entries.forEach((entry) => {
-                            if (entry.contentRect && entry.target === observeTarget) {
-                                setStyleProperties(this.preRenderWrapper, {
-                                    width: `${entry.contentRect.width}px`,
-                                    height: `${entry.contentRect.height}px`,
-                                });
+                            if (entry.target === observeTarget) {
+                                this.syncPreRenderStyle();
                             }
                         });
                     });
@@ -21808,14 +22020,24 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
          * is not defined or not found.
          */
         syncPreRenderStyle() {
+            var _a;
             if (!this.isPreRenderConnected() || !this.getPreRenderPlaceHolderElement()) {
                 logger$3.error(ERROR_MESSAGE.SYNC_STYLE_CALLED_BEFORE_RENDER);
                 return;
             }
+            // Self-heal if the resolved container was remounted/detached, so we
+            // never measure a stale node (which would collapse the wrapper).
+            this.reconcilePreRenderContainer();
             const elBoundingClient = this.getPreRenderPlaceHolderElement().getBoundingClientRect();
+            const containerEl = this.preRenderContainerEl && this.preRenderContainerEl !== document.body
+                ? this.preRenderContainerEl
+                : null;
+            const containerRect = (_a = containerEl === null || containerEl === void 0 ? void 0 : containerEl.getBoundingClientRect()) !== null && _a !== void 0 ? _a : { x: 0, y: 0 };
+            const scrollX = containerEl ? containerEl.scrollLeft : window.scrollX;
+            const scrollY = containerEl ? containerEl.scrollTop : window.scrollY;
             setStyleProperties(this.preRenderWrapper, {
-                top: `${elBoundingClient.y + window.scrollY}px`,
-                left: `${elBoundingClient.x + window.scrollX}px`,
+                top: `${elBoundingClient.y - containerRect.y + scrollY}px`,
+                left: `${elBoundingClient.x - containerRect.x + scrollX}px`,
                 width: `${elBoundingClient.width}px`,
                 height: `${elBoundingClient.height}px`,
                 position: 'absolute',
@@ -21842,6 +22064,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
                 overflow: 'hidden',
             };
             setStyleProperties(this.preRenderWrapper, preRenderHideStyles);
+            this.removeContainerScrollListener();
             if (this.resizeObserver) {
                 this.resizeObserver.disconnect();
             }
@@ -21860,7 +22083,7 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
          */
         getPreRenderIds() {
             return {
-                wrapper: `tsEmbed-pre-render-wrapper-${this.viewConfig.preRenderId}`,
+                wrapper: `${PRERENDER_WRAPPER_ID_PREFIX}${this.viewConfig.preRenderId}`,
                 child: `tsEmbed-pre-render-child-${this.viewConfig.preRenderId}`,
                 placeHolder: `tsEmbed-pre-render-placeholder-${this.viewConfig.preRenderId}`,
             };
@@ -22297,12 +22520,15 @@ mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies:
             }
             // Handle spotterChatConfig params
             if (spotterChatConfig) {
-                const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, } = spotterChatConfig;
+                const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, enableStarterPrompts, } = spotterChatConfig;
                 setParamIfDefined(params, Param.HideToolResponseCardBranding, hideToolResponseCardBranding, true);
                 setParamIfDefined(params, Param.ToolResponseCardBrandingLabel, toolResponseCardBrandingLabel);
                 if (spotterFileUploadEnabled !== undefined) {
                     params[Param.SpotterFileUploadEnabled] = spotterFileUploadEnabled;
                 }
+                if (enableStarterPrompts !== undefined) {
+                    params[Param.IsStarterPromptsEnabled] = enableStarterPrompts;
+                }
                 if (spotterFileUploadFileTypes !== undefined) {
                     params[Param.SpotterFileUploadFileTypes] = JSON.stringify(spotterFileUploadFileTypes);
                 }
@@ -22858,12 +23084,15 @@ query GetEurekaVizSnapshots(
             }
             // Handle spotterChatConfig params
             if (spotterChatConfig) {
-                const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, } = spotterChatConfig;
+                const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, enableStarterPrompts, } = spotterChatConfig;
                 setParamIfDefined(params, Param.HideToolResponseCardBranding, hideToolResponseCardBranding, true);
                 setParamIfDefined(params, Param.ToolResponseCardBrandingLabel, toolResponseCardBrandingLabel);
                 if (spotterFileUploadEnabled !== undefined) {
                     params[Param.SpotterFileUploadEnabled] = spotterFileUploadEnabled;
                 }
+                if (enableStarterPrompts !== undefined) {
+                    params[Param.IsStarterPromptsEnabled] = enableStarterPrompts;
+                }
                 if (spotterFileUploadFileTypes !== undefined) {
                     params[Param.SpotterFileUploadFileTypes] = JSON.stringify(spotterFileUploadFileTypes);
                 }
@@ -23982,10 +24211,11 @@ query SendMessage($params: Input_convassist_SendMessageRequest) {
             setParamIfDefined(queryParams, Param.EnableStopAnswerGenerationEmbed, enableStopAnswerGenerationEmbed, true);
             // Handle spotterChatConfig params
             if (spotterChatConfig) {
-                const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, } = spotterChatConfig;
+                const { hideToolResponseCardBranding, toolResponseCardBrandingLabel, spotterFileUploadEnabled, spotterFileUploadFileTypes, enableStarterPrompts, } = spotterChatConfig;
                 setParamIfDefined(queryParams, Param.HideToolResponseCardBranding, hideToolResponseCardBranding, true);
                 setParamIfDefined(queryParams, Param.ToolResponseCardBrandingLabel, toolResponseCardBrandingLabel);
                 setParamIfDefined(queryParams, Param.SpotterFileUploadEnabled, spotterFileUploadEnabled, true);
+                setParamIfDefined(queryParams, Param.IsStarterPromptsEnabled, enableStarterPrompts, true);
                 if (spotterFileUploadFileTypes !== undefined) {
                     queryParams[Param.SpotterFileUploadFileTypes] = JSON.stringify(spotterFileUploadFileTypes);
                 }

package/dist/visual-embed-sdk-react-full.d.ts

@@ -961,6 +961,23 @@ export interface CustomCssVariables {
 	 * header underline, left panel border, thinking step connector and dots.
 	 */
 	"--ts-var-spotterviz-border-color"?: string;
+	/**
+	 * Background color of the reference-mode toggle button in the SpotterViz
+	 * chat input when it is unselected and the user hovers over it.
+	 */
+	"--ts-var-spotterviz-reference-icon-hover-background"?: string;
+	/**
+	 * Icon color for the reference-mode selected state — applies to
+	 * both the toggle button when active and the icon badge on each
+	 * referenced-entity chip in the chat input.
+	 */
+	"--ts-var-spotterviz-reference-icon-selected-color"?: string;
+	/**
+	 * Background color for the reference-mode selected state — applies to
+	 * both the reference mode toggle button when active and the icon badge
+	 * on each referenced-entity chip in the chat input.
+	 */
+	"--ts-var-spotterviz-reference-icon-selected-background"?: string;
 }
 export interface SessionInterface {
 	sessionId: string;
@@ -2170,6 +2187,45 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * ```
 	 */
 	doNotTrackPreRenderSize?: boolean;
+	/**
+	 * The DOM element or CSS selector string specifying the container into which
+	 * the pre-rendered wrapper is inserted. Defaults to `document.body` when not
+	 * specified.
+	 *
+	 * **When to use a target container:** set this when the pre-render should
+	 * live somewhere other than `document.body` — for example when `<body>` has
+	 * `overflow: hidden` and scrolling is handled by an inner element, or when
+	 * you need the wrapper to sit inside a specific stacking/positioning context.
+	 * The wrapper is positioned to track the embedding element within this
+	 * container, so choose the scrollable/positioned ancestor you want it
+	 * aligned to.
+	 *
+	 * **Pass a stable container:** the wrapper is mounted into the resolved
+	 * container once, during `preRender()`. The container must stay mounted for
+	 * the lifetime of the pre-render — if the host app unmounts and remounts it
+	 * (for example React replacing the node), the wrapper is orphaned on the
+	 * detached node. Mount the container above the part of the tree that
+	 * re-renders so its identity is stable. Prefer a CSS selector string over a
+	 * raw element: a selector can be re-resolved to the fresh node on the next
+	 * reposition, whereas an element reference cannot be recovered once detached.
+	 *
+	 * When the embed host lives inside a Shadow DOM, a selector string is
+	 * resolved against that shadow root as well (since `document.querySelector`
+	 * cannot pierce shadow boundaries); pass the element directly if the
+	 * container lives in a different root.
+	 *
+	 * @type {string | HTMLElement}
+	 * @version SDK: 1.49.2 | ThoughtSpot: *
+	 * @example
+	 * ```js
+	 * const embed = new LiveboardEmbed('#tsEmbed', {
+	 *   preRenderId: 'my-liveboard',
+	 *   // Prefer a selector for a stable, scrollable container.
+	 *   preRenderContainer: '#my-scroll-container',
+	 * });
+	 * ```
+	 */
+	preRenderContainer?: string | HTMLElement;
 	/**
 	 * Enable the V2 shell. This can provide performance benefits
 	 * due to a lighter-weight shell.
@@ -5115,11 +5171,30 @@ export declare enum HostEvent {
 	/**
 	 * Navigate to a specific page in the embedded ThoughtSpot application.
 	 * This is the same as calling `appEmbed.navigateToPage(path, true)`.
-	 * @param - `path` - the path to navigate to go forward or back. The path value can
-	 * be a number; for example, `1`, `-1`.
+	 *
+	 * Accepts either a plain value or an object with `path`
+	 * and an optional `replace` flag.
+	 *
+	 * @param data - A string path, a numeric history delta, or an object
+	 *   `{ path: string | number, replace?: boolean }`.
+	 *   - `path` — the route to navigate to, or a history delta such as `1`
+	 *     or `-1` (calls `window.history.go()`).
+	 *   - `replace` — when `true`, replaces the current history entry instead
+	 *     of pushing a new one (uses `window.location.replace`).
+	 *
 	 * @example
 	 * ```js
-	 * appEmbed.navigateToPage(-1)
+	 * // Preferred: use navigateToPage directly
+	 * appEmbed.navigateToPage(-1);
+	 *
+	 * // Numeric delta — go back one step
+	 * appEmbed.trigger(HostEvent.Navigate, -1);
+	 *
+	 * // String path — push a new history entry
+	 * appEmbed.trigger(HostEvent.Navigate, 'home');
+	 *
+	 * // Object format — replace current history entry
+	 * appEmbed.trigger(HostEvent.Navigate, { path: 'home', replace: true }); // SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
 	 * ```
 	 * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw
 	 */
@@ -7592,6 +7667,16 @@ export declare enum Action {
 	 * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
 	 */
 	AddToFavorites = "addToFavorites",
+	/**
+	 * Remove from Favorites option in home page v3 sidebar.
+	 * Allows removing an object from the user's favorites list from home-page v3 sidebar.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.RemoveFromFavorites]
+	 * ```
+	 */
+	RemoveFromFavorites = "removeFromFavorites",
 	/**
 	 * The edit icon on Liveboards (Classic experience).
 	 * @example
@@ -8649,6 +8734,20 @@ export declare enum Action {
 	 * ```
 	 */
 	SpotterViz = "spotterViz",
+	/**
+	 * The reference-mode toggle button inside the SpotterViz chat input.
+	 * When users enable reference mode, clicking tiles, filters, or
+	 * parameters adds them as chat context. Hide this action to remove
+	 * the reference-mode capability entirely.
+	 * Visible by default.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterVizReferenceMode]
+	 * disabledActions: [Action.SpotterVizReferenceMode]
+	 * ```
+	 */
+	SpotterVizReferenceMode = "spotterVizReferenceMode",
 	/**
 	 * Clears browser cache and fetches new data for liveboard ChartViz Containers.
 	 * Requires `enableLiveboardDataCache` to be enabled.
@@ -9968,6 +10067,8 @@ declare class TsEmbed {
 	private shouldEncodeUrlQueryParams;
 	private defaultHiddenActions;
 	private resizeObserver;
+	private preRenderContainerEl;
+	private containerScrollListener;
 	protected hostEventClient: HostEventClient;
 	protected isReadyForRenderPromise: Promise<void>;
 	protected shouldWaitForRenderPromise: boolean;
@@ -10135,6 +10236,29 @@ declare class TsEmbed {
 	 * aligned with the host layout.
 	 */
 	private createPreRenderPlaceholder;
+	/**
+	 * Resolves the configured preRenderContainer to a live element, falling
+	 * back to `document.body`. A string selector is re-queried on every call so
+	 * a remounted container (E.g.: React replacing the node) resolves to the
+	 * fresh element; an element passed directly cannot be re-resolved.
+	 */
+	private resolvePreRenderContainerTarget;
+	/**
+	 * Makes the container a positioning context for the absolutely positioned
+	 * wrapper, stashing the original inline `position` on the element (once) so
+	 * destroy() can restore it exactly, leaving no trace. Recording it on the
+	 * element rather than per-instance lets the override be reverted even when
+	 * embeds share the same container.
+	 */
+	private applyPreRenderContainerPositioning;
+	/**
+	 * Re-attaches the wrapper to a live container when the previously resolved
+	 * one has been detached or no longer holds the wrapper — e.g. the host app
+	 * remounted a custom preRenderContainer, which would otherwise leave a stale
+	 * reference and collapse the wrapper. Only string selectors can be
+	 * re-resolved; a container passed as an element is left untouched.
+	 */
+	private reconcilePreRenderContainer;
 	protected insertIntoDOMForPreRender(child: string | Node): void;
 	private showPreRenderByDefault;
 	protected insertIntoDOM(child: string | Node): void;
@@ -10347,6 +10471,19 @@ declare class TsEmbed {
 	getThoughtSpotPostUrlParams(additionalParams?: {
 		[key: string]: string | number;
 	}): string;
+	/**
+	 * Reverts the custom preRenderContainer's `position` to the value it had
+	 * before we overrode it to `relative` (see insertIntoDOMForPreRender).
+	 *
+	 * We restore the original inline value rather than forcing `static`, and we
+	 * skip the restore if another preRender wrapper is still mounted inside the
+	 * same container — a shared container still needs the positioning context.
+	 */
+	private restorePreRenderContainerPosition;
+	/**
+	 * Detaches and clears the container scroll listener, if one is attached.
+	 */
+	private removeContainerScrollListener;
 	/**
 	 * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
 	 * @version SDK: 1.19.1 | ThoughtSpot: *
@@ -11021,6 +11158,14 @@ export interface SpotterChatViewConfig {
 	 * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
 	 */
 	spotterFileUploadFileTypes?: SpotterFileUploadFileTypes;
+	/**
+	 * Enables starter prompts in the Spotter chat interface.
+	 *
+	 * Supported embed types: SpotterEmbed, LiveboardEmbed, AppEmbed
+	 * @version SDK: 1.51.0 | ThoughtSpot: 26.8.0.cl
+	 * @default false
+	 */
+	enableStarterPrompts?: boolean;
 }
 /**
  * The configuration for the embedded spotterEmbed options.