@thoughtspot/visual-embed-sdk 1.48.0 → 1.49.0

package/lib/src/visual-embed-sdk.d.ts

@@ -820,6 +820,146 @@ export interface CustomCssVariables {
 	 * Background color of the color palette in the Liveboard styling panel.
 	 */
 	"--ts-var-liveboard-styling-color-palette-background"?: string;
+	/**
+	 * Main panel background of the SpotterViz.
+	 */
+	"--ts-var-spotterviz-panel-background"?: string;
+	/**
+	 * Background color of the chat input field in SpotterViz.
+	 */
+	"--ts-var-spotterviz-input-background"?: string;
+	/**
+	 * Placeholder text color of the chat input field in SpotterViz.
+	 */
+	"--ts-var-spotterviz-input-placeholder-color"?: string;
+	/**
+	 * CTA color of the chat input field in SpotterViz.
+	 */
+	"--ts-var-spotterviz-input-cta-color"?: string;
+	/**
+	 * CTA hover color of the chat input field in SpotterViz.
+	 */
+	"--ts-var-spotterviz-input-cta-hover-color"?: string;
+	/**
+	 * Text color for the SpotterViz label in the empty state, displayed below
+	 * the SpotterViz icon.
+	 */
+	"--ts-var-spotterviz-emptystate-spotterviz-color"?: string;
+	/**
+	 * Background color of the starter prompt cards in SpotterViz.
+	 */
+	"--ts-var-spotterviz-prompt-card-background"?: string;
+	/**
+	 * Background hover color of the starter prompt cards in SpotterViz.
+	 */
+	"--ts-var-spotterviz-prompt-card-hover-background"?: string;
+	/**
+	 * Primary text color in SpotterViz, also used for tool response text,
+	 * upvote/downvote buttons, and other primary content.
+	 */
+	"--ts-var-spotterviz-text-primary"?: string;
+	/**
+	 * Secondary text color in SpotterViz.
+	 */
+	"--ts-var-spotterviz-text-secondary"?: string;
+	/**
+	 * Background color of the user chat message bubble in SpotterViz.
+	 */
+	"--ts-var-spotterviz-message-background"?: string;
+	/**
+	 * Hover color for the user chat message expand button in SpotterViz.
+	 */
+	"--ts-var-spotterviz-usermessage-icon-hover"?: string;
+	/**
+	 * Background color of the user chat message expand button in SpotterViz.
+	 */
+	"--ts-var-spotterviz-usermessage-icon-background"?: string;
+	/**
+	 * Color of the thinking step header when in progress in SpotterViz.
+	 */
+	"--ts-var-spotterviz-thinking-inprogress-header-color"?: string;
+	/**
+	 * Color of the thinking step header when completed in SpotterViz.
+	 */
+	"--ts-var-spotterviz-thinking-completed-header-color"?: string;
+	/**
+	 * Color of the final completion indicator icon shown when all work is done.
+	 * The last green dot which is shown when work is done.
+	 */
+	"--ts-var-spotterviz-thinking-work-done-icon-color"?: string;
+	/**
+	 * Hover background color for the working/work done CTA in SpotterViz.
+	 */
+	"--ts-var-spotterviz-thinking-cta-hover-background"?: string;
+	/**
+	 * Background color of tool call panels in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-call-background"?: string;
+	/**
+	 * Color of tool titles and icons in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-title-color"?: string;
+	/**
+	 * Border color of tool call panels in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-border-color"?: string;
+	/**
+	 * Background color of the JSON input panel inside a tool call in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-json-input-background"?: string;
+	/**
+	 * Background color of the upvote/downvote feedback buttons in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-feedback-button-background"?: string;
+	/**
+	 * Hover background color of the upvote/downvote feedback buttons in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-feedback-button-hover"?: string;
+	/**
+	 * Text color of the JSON input panel inside a tool call in SpotterViz.
+	 */
+	"--ts-var-spotterviz-tool-json-input-color"?: string;
+	/**
+	 * Background color of the last checkpoint section in SpotterViz.
+	 */
+	"--ts-var-spotterviz-last-checkpoint-background"?: string;
+	/**
+	 * Border color of the last checkpoint section in SpotterViz.
+	 */
+	"--ts-var-spotterviz-last-checkpoint-border"?: string;
+	/**
+	 * Border color of the Liveboard edit header toolbar.
+	 */
+	"--ts-var-liveboard-edit-toolbar-border"?: string;
+	/**
+	 * Background color of the selected section in the Liveboard edit header toolbar.
+	 */
+	"--ts-var-liveboard-edit-toolbar-selected-background"?: string;
+	/**
+	 * Text color of the selected section in the Liveboard edit header toolbar.
+	 */
+	"--ts-var-liveboard-edit-toolbar-selected-text-color"?: string;
+	/**
+	 * Text color of unselected items in the Liveboard edit header toolbar.
+	 */
+	"--ts-var-liveboard-edit-toolbar-text"?: string;
+	/**
+	 * Hover background color of unselected items in the Liveboard edit header toolbar.
+	 */
+	"--ts-var-liveboard-edit-toolbar-hover-background"?: string;
+	/**
+	 * Hover text color of unselected items in the Liveboard edit header toolbar.
+	 */
+	"--ts-var-liveboard-edit-toolbar-hover-text-color"?: string;
+	/**
+	 * Text color of the SpotterViz footer.
+	 */
+	"--ts-var-spotterviz-footer-text-color"?: string;
+	/**
+	 * Shared border color used throughout SpotterViz: input box, user message,
+	 * header underline, left panel border, thinking step connector and dots.
+	 */
+	"--ts-var-spotterviz-border-color"?: string;
 }
 export interface SessionInterface {
 	sessionId: string;
@@ -2116,6 +2256,14 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * This flag can be used to disable links inside the embedded app,
 	 * and disable redirection of links in a new tab.
 	 *
+	 * Note: When set to `true`, this flag automatically disables
+	 * {@link enableLinkOverridesV2} for the
+	 * embed session. The two features are mutually exclusive — link
+	 * overrides mutate anchors (delete `href`, attach a JS click handler),
+	 * which breaks native browser behavior (Cmd/Ctrl+Click, middle-click,
+	 * right-click "Open in new tab") when combined with the disable flag.
+	 * The disable flag preserves native anchor semantics instead.
+	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.32.1 | ThoughtSpot: 10.3.0.cl
 	 * @example
@@ -2151,8 +2299,13 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * Flag to override the *Open Link in New Tab* context
 	 * menu option.
 	 *
-	 * For improved link override handling, use
-	 * {@link enableLinkOverridesV2} instead.
+	 * Note: Setting this flag implicitly enables
+	 * {@link enableLinkOverridesV2}. V1 is auto-upgraded to
+	 * V2 to ensure consistent link-override behavior; the
+	 * legacy V1-only path is no longer used in isolation.
+	 *
+	 * Note: This flag is ignored when
+	 * {@link disableRedirectionLinksInNewTab} is `true`.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
 	 * `SearchEmbed`, `SpotterAgentEmbed`,
@@ -2178,6 +2331,9 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * alongside this flag for backward compatibility with
 	 * older ThoughtSpot versions.
 	 *
+	 * Note: This flag is ignored when
+	 * {@link disableRedirectionLinksInNewTab} is `true`.
+	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
 	 * `SearchEmbed`, `SpotterAgentEmbed`,
 	 * `SpotterEmbed`, `SearchBarEmbed`
@@ -2450,8 +2606,21 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 */
 	useHostEventsV2?: boolean;
 }
-export interface AutoMCPFrameRendererViewConfig extends BaseViewConfig {
-}
+/**
+ * Configuration for {@link startAutoMCPFrameRenderer}.
+ *
+ * Extends {@link BaseViewConfig} but omits params that are not applicable
+ * to the auto-frame renderer:
+ * - `preRenderId` / `usePrerenderedIfAvailable` / `doNotTrackPreRenderSize` —
+ *   the renderer always replaces a live iframe in-place; prerender pools are not used.
+ * - `insertAsSibling` — insertion is always a same-position `replaceWith`; the
+ *   container-append path is never taken.
+ * - `primaryAction` — a Liveboard/AppEmbed-specific feature; the renderer renders
+ *   whatever route the MCP server specifies.
+ * - `enableV2Shell_experimental` — the renderer always uses the v2 URL format;
+ *   this flag has no effect.
+ */
+export type AutoMCPFrameRendererViewConfig = Omit<BaseViewConfig, "preRenderId" | "usePrerenderedIfAvailable" | "doNotTrackPreRenderSize" | "insertAsSibling" | "primaryAction" | "enableV2Shell_experimental">;
 /**
  * The configuration object for Home page embeds configs.
  */
@@ -3396,38 +3565,54 @@ export enum EmbedEvent {
 	 */
 	VizPointClick = "vizPointClick",
 	/**
-	 * An error has occurred. This event is fired for the following error types:
+	 * Fired when an error occurs in the embedded component.
 	 *
+	 * **Important:** This event fires for many reasons — including internal
+	 * validation warnings (e.g. `HOST_EVENT_VALIDATION`), configuration issues,
+	 * and transient errors that ThoughtSpot already handles gracefully inside the
+	 * iframe. **Do not call `embed.destroy()` or unmount the embed component on
+	 * every error.** Doing so will tear down the iframe and abort all in-flight
+	 * requests, causing the embed to fail entirely.
+	 *
+	 * Only treat the following codes as unrecoverable:
+	 * - `INIT_ERROR` — SDK was not initialised before render
+	 * - `LOGIN_FAILED` — authentication could not be completed
+	 *
+	 * All other error codes should be logged and inspected, not acted upon
+	 * destructively.
+	 *
+	 * **Note:** There is currently no dedicated event for a true unrecoverable
+	 * crash. A future `EmbedEvent.FatalError` event is planned to give customers
+	 * a clean signal for when the embed cannot recover and needs to be torn down.
+	 *
+	 * Error types include:
 	 * `API` - API call failure.
-	 * `FULLSCREEN` - Error when presenting a Liveboard or visualization in full screen
-	 * mode. `SINGLE_VALUE_FILTER` - Error due to multiple values in the single value
-	 * filter. `NON_EXIST_FILTER` - Error due to a non-existent filter.
-	 * `INVALID_DATE_VALUE` - Invalid date value error.
-	 * `INVALID_OPERATOR` - Use of invalid operator during filter application.
+	 * `FULLSCREEN` - Error when presenting a Liveboard in full screen mode.
+	 * `VALIDATION_ERROR` - Internal host event or configuration validation warning.
 	 *
 	 * For more information, see https://developers.thoughtspot.com/docs/events-app-integration#errorType
 	 * @returns error - An error object or message
 	 * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
 	 * @example
 	 * ```js
-	 * // API error
-	 * SearchEmbed.on(EmbedEvent.Error, (error) => {
-	 *   console.log(error);
-	 *  // { type: "Error", data: { errorType: "API", error: { message: '...', error: '...' } } }
-	 *  // { errorType: "API", message: '...', code: '...' } new format
+	 * // Recommended pattern — only destroy on truly fatal errors
+	 * embed.on(EmbedEvent.Error, (error) => {
+	 *   const FATAL_CODES = ['INIT_ERROR', 'LOGIN_FAILED'];
+	 *   if (FATAL_CODES.includes(error.data?.code)) {
+	 *     embed.destroy();
+	 *     return;
+	 *   }
+	 *   // Log all other errors — do not destroy
+	 *   console.warn('Embed error (non-fatal):', error);
 	 * });
 	 * ```
 	 * @example
 	 * ```js
-	 * // Fullscreen error (Errors during presenting of a liveboard)
-	 * LiveboardEmbed.on(EmbedEvent.Error, (error) => {
+	 * // API error
+	 * SearchEmbed.on(EmbedEvent.Error, (error) => {
 	 *   console.log(error);
-	 *   // { type: "Error", data: { errorType: "FULLSCREEN", error: {
-	 *   //   message: "Fullscreen API is not enabled",
-	 *   //   stack: "..."
-	 *   // } }}
-	 *   // { errorType: "FULLSCREEN", message: "Fullscreen API is not enabled", code: '...' } new format
-	 * })
+	 *   // { errorType: "API", message: '...', code: '...' }
+	 * });
 	 * ```
 	 */
 	Error = "Error",
@@ -4628,7 +4813,103 @@ export enum EmbedEvent {
 	 * ```
 	 * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
 	 */
-	SendTestScheduleEmail = "sendTestScheduleEmail"
+	SendTestScheduleEmail = "sendTestScheduleEmail",
+	/**
+	 * Emitted when the SpotterViz panel mounts in embed mode.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizInit, (payload) => {
+	 *     console.log('SpotterViz initialized', payload);
+	 *     // payload: { liveboardId: string }
+	 * })
+	 * ```
+	 */
+	SpotterVizInit = "SpotterVizInit",
+	/**
+	 * Emitted when the user submits a prompt in the SpotterViz panel.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizQueryTriggered, (payload) => {
+	 *     console.log('SpotterViz query triggered', payload);
+	 *     // payload: { query: string, sessionId: string }
+	 * })
+	 * ```
+	 */
+	SpotterVizQueryTriggered = "SpotterVizQueryTriggered",
+	/**
+	 * Emitted when the SpotterViz agent finishes responding.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizResponseComplete, (payload) => {
+	 *     console.log('SpotterViz response complete', payload);
+	 *     // payload: { sessionId: string, messageId: string }
+	 * })
+	 * ```
+	 */
+	SpotterVizResponseComplete = "SpotterVizResponseComplete",
+	/**
+	 * Emitted when a checkpoint is created in the SpotterViz panel.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizCheckpointCreated, (payload) => {
+	 *     console.log('SpotterViz checkpoint created', payload);
+	 *     // payload: { checkpointId: string, source: string, label: string }
+	 * })
+	 * ```
+	 */
+	SpotterVizCheckpointCreated = "SpotterVizCheckpointCreated",
+	/**
+	 * Emitted when a checkpoint is restored in the SpotterViz panel.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizCheckpointRestored, (payload) => {
+	 *     console.log('SpotterViz checkpoint restored', payload);
+	 *     // payload: { checkpointId: string, newGenNumber: number }
+	 * })
+	 * ```
+	 */
+	SpotterVizCheckpointRestored = "SpotterVizCheckpointRestored",
+	/**
+	 * Emitted when an error occurs in the SpotterViz panel.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizError, (payload) => {
+	 *     console.log('SpotterViz error', payload);
+	 * })
+	 * ```
+	 */
+	SpotterVizError = "SpotterVizError",
+	/**
+	 * Emitted when the SpotterViz panel is closed.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.SpotterVizClosed, (payload) => {
+	 *     console.log('SpotterViz panel closed', payload);
+	 * })
+	 * ```
+	 */
+	SpotterVizClosed = "SpotterVizClosed",
+	/**
+	 * Emitted when a user clicks the **Refresh** button in the
+	 * Liveboard header. Requires `enableLiveboardDataCache`
+	 * to be enabled.
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.RefreshLiveboardBrowserCache, (payload) => {
+	 *     console.log('Liveboard browser cache refreshed', payload);
+	 *     // payload: { liveboardId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+	 */
+	RefreshLiveboardBrowserCache = "refreshLiveboardBrowserCache"
 }
 /**
  * Event types that can be triggered by the host application
@@ -6698,7 +6979,38 @@ export enum HostEvent {
 	 * ```
 	 * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
 	 */
-	SendTestScheduleEmail = "sendTestScheduleEmail"
+	SendTestScheduleEmail = "sendTestScheduleEmail",
+	/**
+	 * Sends a user message (prompt) to the SpotterViz panel programmatically.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @param query - the prompt text to send.
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.SpotterVizSendUserMessage, {
+	 *     query: 'Show me revenue by region',
+	 * });
+	 * ```
+	 */
+	SpotterVizSendUserMessage = "SpotterVizSendUserMessage",
+	/**
+	 * Initializes a new SpotterViz conversation.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.InitSpotterVizConversation);
+	 * ```
+	 */
+	InitSpotterVizConversation = "InitSpotterVizConversation",
+	/**
+	 * Clears browser cache and fetches new data for liveboard ChartViz Containers.
+	 * Requires `enableLiveboardDataCache` to be enabled.
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.RefreshLiveboardBrowserCache);
+	 * ```
+	 * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+	 */
+	RefreshLiveboardBrowserCache = "refreshLiveboardBrowserCache"
 }
 /**
  * The different visual modes that the data sources panel within
@@ -6718,6 +7030,13 @@ export enum DataSourceVisualMode {
 	 */
 	Expanded = "expand"
 }
+/**
+ * Configuration for allowed file types in Spotter file upload.
+ * @group Embed components
+ */
+export type SpotterFileUploadFileTypes = {
+	types?: string[];
+};
 /**
  * ThoughtSpot application pages include actions and menu commands
  * for various user-initiated operations. These actions are represented
@@ -7054,6 +7373,20 @@ export enum Action {
 	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
 	 */
 	DownloadLiveboardAsContinuousPDF = "downloadLiveboardAsContinuousPDF",
+	/**
+	 * The Download Liveboard as A4 PDF menu action on a Liveboard.
+	 * Allows downloading the entire Liveboard as an A4 PDF.
+	 * Requires {@link Action.DownloadLiveboard} as a parent action when
+	 * {@link LiveboardViewConfig.isLiveboardXLSXCSVDownloadEnabled} or
+	 * {@link LiveboardViewConfig.isContinuousLiveboardPDFEnabled} flags are enabled.
+	 * Use this instead of {@link Action.DownloadAsPdf} when either flag is on.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.DownloadLiveboardAsA4Pdf]
+	 * ```
+	 */
+	DownloadLiveboardAsA4Pdf = "downloadLiveboardAsA4Pdf",
 	/**
 	 * The **Download Liveboard as XLSX** menu action on a Liveboard.
 	 * Allows downloading the entire Liveboard as an XLSX file.
@@ -8365,7 +8698,51 @@ export enum Action {
 	 * ```
 	 * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
 	 */
-	SendTestScheduleEmail = "sendTestScheduleEmail"
+	SendTestScheduleEmail = "sendTestScheduleEmail",
+	/**
+	 * The thumbs up/down feedback buttons in the SpotterViz panel.
+	 * Visible by default.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterVizFeedback]
+	 * disabledActions: [Action.SpotterVizFeedback]
+	 * ```
+	 */
+	SpotterVizFeedback = "spotterVizFeedback",
+	/**
+	 * The version restore button on checkpoint cards in the SpotterViz panel.
+	 * Visible by default.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterVizCheckpointRestore]
+	 * disabledActions: [Action.SpotterVizCheckpointRestore]
+	 * ```
+	 */
+	SpotterVizCheckpointRestore = "spotterVizCheckpointRestore",
+	/**
+	 * The **SpotterViz** button in the top edit header.
+	 * Visible by default.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterViz]
+	 * disabledActions: [Action.SpotterViz]
+	 * ```
+	 */
+	SpotterViz = "spotterViz",
+	/**
+	 * Clears browser cache and fetches new data for liveboard ChartViz Containers.
+	 * Requires `enableLiveboardDataCache` to be enabled.
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.RefreshLiveboardBrowserCache]
+	 * hiddenActions: [Action.RefreshLiveboardBrowserCache]
+	 * ```
+	 * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+	 */
+	RefreshLiveboardBrowserCache = "refreshLiveboardBrowserCache"
 }
 export enum PrefetchFeatures {
 	FullApp = "FullApp",
@@ -9596,7 +9973,7 @@ class TsEmbed {
 	/**
 	 * The DOM node where the ThoughtSpot app is to be embedded.
 	 */
-	protected el: HTMLElement;
+	protected hostElement: HTMLElement;
 	/**
 	 * The key to store the embed instance in the DOM node
 	 */
@@ -9652,6 +10029,7 @@ class TsEmbed {
 	private resizeObserver;
 	protected hostEventClient: HostEventClient;
 	protected isReadyForRenderPromise: Promise<void>;
+	protected shouldWaitForRenderPromise: boolean;
 	/**
 	 * Handler for fullscreen change events
 	 */
@@ -9785,6 +10163,10 @@ class TsEmbed {
 	protected getEmbedParamsObject(): Record<any, any>;
 	protected getRootIframeSrc(): string;
 	protected createIframeEl(frameSrc: string): HTMLIFrameElement;
+	/**
+	 * Returns true if this embed instance is configured for pre-rendering.
+	 */
+	protected isPreRenderEmbed(): boolean;
 	protected handleInsertionIntoDOM(child: string | Node): void;
 	/**
 	 * Renders the embedded ThoughtSpot app in an iframe and sets up
@@ -9795,9 +10177,23 @@ class TsEmbed {
 	protected createPreRenderWrapper(): HTMLDivElement;
 	protected preRenderWrapper: HTMLElement;
 	protected preRenderChild: HTMLElement;
+	/**
+	 * Checks for an existing pre-rendered component and connects to it.
+	 *
+	 * If a matching pre-rendered component is found in the DOM, this method
+	 * sets the internal properties of the embed object to reference it.
+	 *
+	 * @returns True if a connection was successfully established, false otherwise.
+	 */
 	protected connectPreRendered(): boolean;
-	protected isPreRenderAvailable(): boolean;
+	protected isPreRenderConnected(): boolean;
 	protected createPreRenderChild(child: string | Node): HTMLElement;
+	/**
+	 * Creates the in-flow placeholder div inserted into the host element when
+	 * showPreRender() is called. The wrapper observes this element to stay
+	 * aligned with the host layout.
+	 */
+	private createPreRenderPlaceholder;
 	protected insertIntoDOMForPreRender(child: string | Node): void;
 	private showPreRenderByDefault;
 	protected insertIntoDOM(child: string | Node): void;
@@ -9894,10 +10290,10 @@ class TsEmbed {
 	 */
 	private triggerEventOnPort;
 	/**
-	* @hidden
-	* Internal state to track if the embed container is loaded.
-	* This is used to trigger events after the embed container is loaded.
-	*/
+	 * @hidden
+	 * Internal state to track if the embed container is loaded.
+	 * This is used to trigger events after the embed container is loaded.
+	 */
 	isEmbedContainerLoaded: boolean;
 	/**
 	 * @hidden
@@ -9954,33 +10350,33 @@ class TsEmbed {
 	getIframeSrc(): string;
 	protected handleRenderForPrerender(): Promise<TsEmbed>;
 	/**
-	* Context object for the embedded component.
-	* @returns {ContextObject} The current context object containing the page type and object ids.
-	* @example
-	* ```js
-	* const context = await embed.getCurrentContext();
-	* console.log(context);
-	*
-	* // Example output
-	* {
-	*   stack: [
-	*     {
-	*       name: 'Liveboard',
-	*       type: ContextType.Liveboard,
-	*       objectIds: {
-	*         liveboardId: '123',
-	*       },
-	*     },
-	*   ],
-	*   currentContext: {
-	*     name: 'Liveboard',
-	*     type: ContextType.Liveboard,
-	*     objectIds: {
-	*       liveboardId: '123',
-	*     },
-	*   },
-	* }
-	* ```
+	 * Context object for the embedded component.
+	 * @returns {ContextObject} The current context object containing the page type and object ids.
+	 * @example
+	 * ```js
+	 * const context = await embed.getCurrentContext();
+	 * console.log(context);
+	 *
+	 * // Example output
+	 * {
+	 *   stack: [
+	 *     {
+	 *       name: 'Liveboard',
+	 *       type: ContextType.Liveboard,
+	 *       objectIds: {
+	 *         liveboardId: '123',
+	 *       },
+	 *     },
+	 *   ],
+	 *   currentContext: {
+	 *     name: 'Liveboard',
+	 *     type: ContextType.Liveboard,
+	 *     objectIds: {
+	 *       liveboardId: '123',
+	 *     },
+	 *   },
+	 * }
+	 * ```
 	 * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
 	 */
 	getCurrentContext(): Promise<ContextObject>;
@@ -10025,14 +10421,14 @@ class TsEmbed {
 	 */
 	prerenderGeneric(): Promise<any>;
 	protected beforePrerenderVisible(): void;
-	private validatePreRenderViewConfig;
 	/**
-	 * Displays the PreRender component.
-	 * If the component is not preRendered, it attempts to create and render it.
-	 * Also, synchronizes the style of the PreRender component with the embedding
-	 * element.
+	 * Displays the pre-rendered component inside the host element.
+	 * If the component has not been pre-rendered yet, it initiates rendering first.
+	 * Inserts a placeholder element into the host and positions the pre-render
+	 * wrapper to overlay it.
 	 */
 	showPreRender(): Promise<TsEmbed>;
+	protected getPreRenderPlaceHolderElement(): HTMLDivElement;
 	/**
 	 * Synchronizes the style properties of the PreRender component with the embedding
 	 * element. This function adjusts the position, width, and height of the PreRender
@@ -10057,6 +10453,7 @@ class TsEmbed {
 	getPreRenderIds(): {
 		wrapper: string;
 		child: string;
+		placeHolder: string;
 	};
 	/**
 	 * Returns the answerService which can be used to make arbitrary graphql calls on top
@@ -10214,6 +10611,21 @@ export interface SpotterChatViewConfig {
 	 * External MCP tool branding is not affected.
 	 */
 	toolResponseCardBrandingLabel?: string;
+	/**
+	 * Enables file upload in the Spotter chat interface.
+	 *
+	 * Supported embed types: `SpotterEmbed`, `LiveboardEmbed`, `AppEmbed`
+	 * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
+	 * @default false
+	 */
+	spotterFileUploadEnabled?: boolean;
+	/**
+	 * Restricts the allowed file types for Spotter file upload.
+	 *
+	 * Supported embed types: `SpotterEmbed`, `LiveboardEmbed`, `AppEmbed`
+	 * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
+	 */
+	spotterFileUploadFileTypes?: SpotterFileUploadFileTypes;
 }
 /**
  * The configuration for the embedded spotterEmbed options.
@@ -10517,6 +10929,82 @@ export class ConversationEmbed extends SpotterEmbed {
 	protected viewConfig: ConversationViewConfig;
 	constructor(container: HTMLElement, viewConfig: ConversationViewConfig);
 }
+/**
+ * Defines starter prompts displayed in the SpotterViz interface.
+ * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+ * @group Embed components
+ */
+export interface SpotterVizStarterPrompt {
+	/** Identifier for the prompt. */
+	id: string;
+	/** Short label shown to the user as a clickable suggestion. */
+	displayText: string;
+	/** Full prompt text sent to Spotter when the user clicks the suggestion. */
+	fullPrompt: string;
+}
+/**
+ * Configuration for the SpotterViz interface shown on the Liveboard.
+ * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+ * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+ * @group Embed components
+ * @example
+ * ```js
+ * const embed = new AppEmbed('#embed-container', {
+ *    ... // other options,
+ *    spotterViz: {
+ *        brandName: 'MyBrand',
+ *        brandHeadline: 'Hi, there! I\'m',
+ *        description: 'Ask questions about your data',
+ *        inputChatPlaceholder: 'Ask a question...',
+ *        hideStarterPrompts: false,
+ *        customStarterPrompts: [
+ *            { id: '1', displayText: 'Top products', fullPrompt: 'What are the top products by revenue?' }
+ *        ],
+ *    },
+ * })
+ * ```
+ */
+export interface SpotterVizConfig {
+	/**
+	 * Rename the default "SpotterViz" label shown in the SpotterViz interface with a custom brand name.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @default ''
+	 */
+	brandName?: string;
+	/**
+	 * Custom headline text shown before the brand name in the SpotterViz interface.
+	 * Replaces the default greeting prefix (e.g. "Hi, there! I'm").
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @default ''
+	 */
+	brandHeadline?: string;
+	/**
+	 * Hides the starter prompts section entirely in the SpotterViz interface.
+	 * When set to `true`, the starter prompts are not displayed.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @default false
+	 */
+	hideStarterPrompts?: boolean;
+	/**
+	 * Overrides the starter prompts with a custom list.
+	 * Each entry must match the {@link SpotterVizStarterPrompt} shape.
+	 * Has no effect when `hideStarterPrompts` is `true`.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 */
+	customStarterPrompts?: SpotterVizStarterPrompt[];
+	/**
+	 * Custom description text shown in the SpotterViz interface.
+	 * Replaces the default SpotterViz description.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 */
+	description?: string;
+	/**
+	 * Custom placeholder text for the chat input in the SpotterViz interface.
+	 * Replaces the default chat input placeholder text.
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 */
+	inputChatPlaceholder?: string;
+}
 /**
  * Pages within the ThoughtSpot app that can be embedded.
  */
@@ -10603,7 +11091,15 @@ export enum HomePage {
 	 * ModularWithStylingChanges (v3) introduces Modular Home Experience
 	 * with styling changes.
 	 */
-	ModularWithStylingChanges = "v3"
+	ModularWithStylingChanges = "v3",
+	/**
+	 * Focused (v4) introduces the V4 homepage experience
+	 * 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
+	 */
+	Focused = "v4"
 }
 /**
  * Define the version of the list page
@@ -11035,6 +11531,21 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	isUnifiedSearchExperienceEnabled?: boolean;
+	/**
+	 * This flag is used to enable the new connection experience for AppEmbed.
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    newConnectionsExperience: true,
+	 * })
+	 * ```
+	 */
+	newConnectionsExperience?: boolean;
 	/**
 	 * This flag is used to enable/disable the styling and grouping in a Liveboard. Use {@link isLiveboardMasterpiecesEnabled} instead.
 	 * @deprecated This flag is deprecated.
@@ -11135,6 +11646,17 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	lazyLoadingForFullHeight?: boolean;
+	/**
+	 * This flag is used to enable container-aware full height lazy loading.
+	 *
+	 * Use this when the embed is rendered inside a scrollable or clipping
+	 * container instead of relying on the browser window as the only viewport.
+	 *
+	 * @type {boolean}
+	 * @default false
+	 * @hidden
+	 */
+	enableScrollableContainerLazyLoading?: boolean;
 	/**
 	 * The margin to be used for lazy loading.
 	 *
@@ -11221,6 +11743,29 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	spotterChatConfig?: SpotterChatViewConfig;
+	/**
+	 * Configuration for the SpotterViz interface shown on the Liveboard.
+	 * Customize the brand name, description, chat input placeholder,
+	 * starter prompts, and visibility of starter prompts in the SpotterViz panel.
+	 *
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#embed-container', {
+	 *    ... // other options
+	 *    spotterViz: {
+	 *        brandName: 'MyBrand',
+	 *        brandHeadline: 'Hi, there! I\'m',
+	 *        description: 'Ask questions about your data',
+	 *        inputChatPlaceholder: 'Ask a question...',
+	 *        hideStarterPrompts: false,
+	 *        customStarterPrompts: [{ id: '1', displayText: 'Top products', fullPrompt: 'What are the top products by revenue?' }]
+	 *    },
+	 * })
+	 * ```
+	 */
+	spotterViz?: SpotterVizConfig;
 	/**
 	 * Enables the stop answer generation button in the Spotter embed UI,
 	 * allowing users to interrupt an ongoing answer generation.
@@ -11289,6 +11834,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 export interface AppEmbedAppInitData extends DefaultAppInitData {
 	embedParams?: {
 		spotterSidebarConfig?: SpotterSidebarViewConfig;
+		spotterVizConfig?: SpotterVizConfig;
 	};
 }
 /**
@@ -11298,6 +11844,8 @@ export interface AppEmbedAppInitData extends DefaultAppInitData {
 export class AppEmbed extends V1Embed {
 	protected viewConfig: AppViewConfig;
 	private defaultHeight;
+	private lazyLoadScrollContainers;
+	private lazyLoadResizeObserver;
 	constructor(domSelector: DOMSelector, viewConfig: AppViewConfig);
 	/**
 	 * Extends the default APP_INIT payload with `embedParams.spotterSidebarConfig`
@@ -11660,6 +12208,15 @@ export const exportTML: (data: exportTMLInput) => Promise<any>;
  * @group Global methods
  */
 export const reloadIframe: (iFrame: HTMLIFrameElement) => void;
+/**
+ * APP_INIT data shape for LiveboardEmbed.
+ * @internal
+ */
+export interface LiveboardEmbedAppInitData extends DefaultAppInitData {
+	embedParams?: {
+		spotterVizConfig?: SpotterVizConfig;
+	};
+}
 /**
  * The configuration for the embedded Liveboard or visualization page view.
  * @group Embed components
@@ -12078,6 +12635,16 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 * ```
 	 */
 	lazyLoadingForFullHeight?: boolean;
+	/**
+	 * This flag is used to enable container-aware full height lazy loading.
+	 *
+	 * Use this when the embed is rendered inside a scrollable or clipping
+	 * container instead of relying on the browser window as the only viewport.
+	 *
+	 * @type {boolean}
+	 * @default false
+	 */
+	enableScrollableContainerLazyLoading?: boolean;
 	/**
 	 * The margin to be used for lazy loading.
 	 *
@@ -12159,6 +12726,29 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 * ```
 	 */
 	spotterChatConfig?: SpotterChatViewConfig;
+	/**
+	 * Configuration for the SpotterViz interface shown on the Liveboard.
+	 * Customize the brand name, description, chat input placeholder,
+	 * starter prompts, and visibility of starter prompts in the SpotterViz panel.
+	 *
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new LiveboardEmbed('#embed-container', {
+	 *    ... // other options
+	 *    spotterViz: {
+	 *        brandName: 'MyBrand',
+	 *        brandHeadline: 'Hi, there! I\'m',
+	 *        description: 'Ask questions about your data',
+	 *        inputChatPlaceholder: 'Ask a question...',
+	 *        hideStarterPrompts: false,
+	 *        customStarterPrompts: [{ id: '1', displayText: 'Top products', fullPrompt: 'What are the top products by revenue?' }],
+	 *    },
+	 * })
+	 * ```
+	 */
+	spotterViz?: SpotterVizConfig;
 	/**
 	 * If set to true, enables visualization data caching on the Liveboard.
 	 * @type {boolean}
@@ -12191,7 +12781,10 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 export class LiveboardEmbed extends V1Embed {
 	protected viewConfig: LiveboardViewConfig;
 	private defaultHeight;
+	private lazyLoadScrollContainers;
+	private lazyLoadResizeObserver;
 	constructor(domSelector: DOMSelector, viewConfig: LiveboardViewConfig);
+	protected getAppInitData(): Promise<LiveboardEmbedAppInitData>;
 	/**
 	 * Construct a map of params to be passed on to the
 	 * embedded Liveboard or visualization.