npm - @thoughtspot/visual-embed-sdk - Versions diffs - 1.49.1 → 1.49.3 - Mend

@thoughtspot/visual-embed-sdk 1.49.1 → 1.49.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (151) hide show

package/cjs/package.json +4 -10
package/cjs/src/css-variables.d.ts +17 -0
package/cjs/src/css-variables.d.ts.map +1 -1
package/cjs/src/embed/app.d.ts +7 -1
package/cjs/src/embed/app.d.ts.map +1 -1
package/cjs/src/embed/app.js +4 -1
package/cjs/src/embed/app.js.map +1 -1
package/cjs/src/embed/app.spec.js +97 -0
package/cjs/src/embed/app.spec.js.map +1 -1
package/cjs/src/embed/conversation.d.ts +8 -0
package/cjs/src/embed/conversation.d.ts.map +1 -1
package/cjs/src/embed/conversation.js +2 -1
package/cjs/src/embed/conversation.js.map +1 -1
package/cjs/src/embed/conversation.spec.js +12 -0
package/cjs/src/embed/conversation.spec.js.map +1 -1
package/cjs/src/embed/events.spec.js +5 -0
package/cjs/src/embed/events.spec.js.map +1 -1
package/cjs/src/embed/liveboard.d.ts +6 -0
package/cjs/src/embed/liveboard.d.ts.map +1 -1
package/cjs/src/embed/liveboard.js +4 -1
package/cjs/src/embed/liveboard.js.map +1 -1
package/cjs/src/embed/liveboard.spec.js +11 -0
package/cjs/src/embed/liveboard.spec.js.map +1 -1
package/cjs/src/embed/spotter-viz-utils.d.ts +29 -0
package/cjs/src/embed/spotter-viz-utils.d.ts.map +1 -1
package/cjs/src/embed/spotter-viz-utils.js.map +1 -1
package/cjs/src/embed/ts-embed.d.ts +38 -0
package/cjs/src/embed/ts-embed.d.ts.map +1 -1
package/cjs/src/embed/ts-embed.js +166 -9
package/cjs/src/embed/ts-embed.js.map +1 -1
package/cjs/src/embed/ts-embed.spec.js +237 -0
package/cjs/src/embed/ts-embed.spec.js.map +1 -1
package/cjs/src/index.d.ts +2 -2
package/cjs/src/index.d.ts.map +1 -1
package/cjs/src/index.js.map +1 -1
package/cjs/src/types.d.ts +87 -4
package/cjs/src/types.d.ts.map +1 -1
package/cjs/src/types.js +47 -3
package/cjs/src/types.js.map +1 -1
package/cjs/src/utils/graphql/answerService/answerService.spec.js +15 -0
package/cjs/src/utils/graphql/answerService/answerService.spec.js.map +1 -1
package/cjs/src/utils/processTrigger.d.ts.map +1 -1
package/cjs/src/utils/processTrigger.js +6 -5
package/cjs/src/utils/processTrigger.js.map +1 -1
package/cjs/src/utils/processTrigger.spec.js +13 -0
package/cjs/src/utils/processTrigger.spec.js.map +1 -1
package/cjs/src/utils.d.ts +10 -0
package/cjs/src/utils.d.ts.map +1 -1
package/cjs/src/utils.js +25 -4
package/cjs/src/utils.js.map +1 -1
package/cjs/src/utils.spec.js +48 -0
package/cjs/src/utils.spec.js.map +1 -1
package/dist/{index-B6Rn561t.js → index-DsSQndIB.js} +303 -187
package/dist/src/css-variables.d.ts +17 -0
package/dist/src/css-variables.d.ts.map +1 -1
package/dist/src/embed/app.d.ts +7 -1
package/dist/src/embed/app.d.ts.map +1 -1
package/dist/src/embed/conversation.d.ts +8 -0
package/dist/src/embed/conversation.d.ts.map +1 -1
package/dist/src/embed/liveboard.d.ts +6 -0
package/dist/src/embed/liveboard.d.ts.map +1 -1
package/dist/src/embed/spotter-viz-utils.d.ts +29 -0
package/dist/src/embed/spotter-viz-utils.d.ts.map +1 -1
package/dist/src/embed/ts-embed.d.ts +38 -0
package/dist/src/embed/ts-embed.d.ts.map +1 -1
package/dist/src/index.d.ts +2 -2
package/dist/src/index.d.ts.map +1 -1
package/dist/src/types.d.ts +87 -4
package/dist/src/types.d.ts.map +1 -1
package/dist/src/utils/processTrigger.d.ts.map +1 -1
package/dist/src/utils.d.ts +10 -0
package/dist/src/utils.d.ts.map +1 -1
package/dist/tsembed-react.es.js +282 -35
package/dist/tsembed-react.js +583 -220
package/dist/tsembed.es.js +282 -35
package/dist/tsembed.js +583 -220
package/dist/visual-embed-sdk-react-full.d.ts +190 -4
package/dist/visual-embed-sdk-react.d.ts +190 -4
package/dist/visual-embed-sdk.d.ts +190 -4
package/lib/package.json +4 -10
package/lib/src/css-variables.d.ts +17 -0
package/lib/src/css-variables.d.ts.map +1 -1
package/lib/src/embed/app.d.ts +7 -1
package/lib/src/embed/app.d.ts.map +1 -1
package/lib/src/embed/app.js +4 -1
package/lib/src/embed/app.js.map +1 -1
package/lib/src/embed/app.spec.js +97 -0
package/lib/src/embed/app.spec.js.map +1 -1
package/lib/src/embed/conversation.d.ts +8 -0
package/lib/src/embed/conversation.d.ts.map +1 -1
package/lib/src/embed/conversation.js +2 -1
package/lib/src/embed/conversation.js.map +1 -1
package/lib/src/embed/conversation.spec.js +12 -0
package/lib/src/embed/conversation.spec.js.map +1 -1
package/lib/src/embed/events.spec.js +5 -0
package/lib/src/embed/events.spec.js.map +1 -1
package/lib/src/embed/liveboard.d.ts +6 -0
package/lib/src/embed/liveboard.d.ts.map +1 -1
package/lib/src/embed/liveboard.js +4 -1
package/lib/src/embed/liveboard.js.map +1 -1
package/lib/src/embed/liveboard.spec.js +11 -0
package/lib/src/embed/liveboard.spec.js.map +1 -1
package/lib/src/embed/spotter-viz-utils.d.ts +29 -0
package/lib/src/embed/spotter-viz-utils.d.ts.map +1 -1
package/lib/src/embed/spotter-viz-utils.js.map +1 -1
package/lib/src/embed/ts-embed.d.ts +38 -0
package/lib/src/embed/ts-embed.d.ts.map +1 -1
package/lib/src/embed/ts-embed.js +167 -10
package/lib/src/embed/ts-embed.js.map +1 -1
package/lib/src/embed/ts-embed.spec.js +237 -0
package/lib/src/embed/ts-embed.spec.js.map +1 -1
package/lib/src/index.d.ts +2 -2
package/lib/src/index.d.ts.map +1 -1
package/lib/src/index.js.map +1 -1
package/lib/src/types.d.ts +87 -4
package/lib/src/types.d.ts.map +1 -1
package/lib/src/types.js +47 -3
package/lib/src/types.js.map +1 -1
package/lib/src/utils/graphql/answerService/answerService.spec.js +15 -0
package/lib/src/utils/graphql/answerService/answerService.spec.js.map +1 -1
package/lib/src/utils/processTrigger.d.ts.map +1 -1
package/lib/src/utils/processTrigger.js +6 -5
package/lib/src/utils/processTrigger.js.map +1 -1
package/lib/src/utils/processTrigger.spec.js +13 -0
package/lib/src/utils/processTrigger.spec.js.map +1 -1
package/lib/src/utils.d.ts +10 -0
package/lib/src/utils.d.ts.map +1 -1
package/lib/src/utils.js +22 -1
package/lib/src/utils.js.map +1 -1
package/lib/src/utils.spec.js +49 -1
package/lib/src/utils.spec.js.map +1 -1
package/lib/src/visual-embed-sdk.d.ts +190 -4
package/package.json +4 -10
package/src/css-variables.ts +20 -0
package/src/embed/app.spec.ts +109 -0
package/src/embed/app.ts +11 -1
package/src/embed/conversation.spec.ts +17 -0
package/src/embed/conversation.ts +10 -0
package/src/embed/events.spec.ts +7 -0
package/src/embed/liveboard.spec.ts +15 -0
package/src/embed/liveboard.ts +10 -0
package/src/embed/spotter-viz-utils.ts +30 -0
package/src/embed/ts-embed.spec.ts +294 -0
package/src/embed/ts-embed.ts +180 -9
package/src/index.ts +2 -1
package/src/types.ts +86 -3
package/src/utils/graphql/answerService/answerService.spec.ts +18 -0
package/src/utils/processTrigger.spec.ts +23 -0
package/src/utils/processTrigger.ts +8 -6
package/src/utils.spec.ts +63 -0
package/src/utils.ts +25 -1

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

@@ -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.
@@ -11323,6 +11468,12 @@ export interface SpotterVizStarterPrompt {
  *        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
+ *        loaderHeadline: 'Crunching the numbers...',
+ *        loaderTips: [
+ *            { label: 'Tip', text: 'try asking about revenue by region' },
+ *            { label: 'Tip', text: 'use natural language' },
+ *        ],
  *    },
  * })
  * ```
@@ -11367,6 +11518,29 @@ export interface SpotterVizConfig {
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 */
 	inputChatPlaceholder?: string;
+	/**
+	 * Custom headline text shown in the SpotterViz loading state.
+	 * Replaces the default loading headline.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 */
+	loaderHeadline?: string;
+	/**
+	 * Custom tips shown in the SpotterViz loading state.
+	 * Replaces the default loading tips with the provided list.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 */
+	loaderTips?: SpotterVizLoaderTip[];
+}
+/**
+ * A single tip shown in the SpotterViz loading state.
+ * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+ * @group Embed components
+ */
+export interface SpotterVizLoaderTip {
+	/** Short label rendered alongside the tip (e.g. "Tip"). */
+	label: string;
+	/** Tip body text. */
+	text: string;
 }
 /**
  * Pages within the ThoughtSpot app that can be embedded.
@@ -12111,7 +12285,13 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 *        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?' }]
+	 *        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
+	 *        loaderHeadline: 'Crunching the numbers...',
+	 *        loaderTips: [
+	 *            { label: 'Tip', text: 'try asking about revenue by region' },
+	 *            { label: 'Tip', text: 'use natural language' },
+	 *        ],
 	 *    },
 	 * })
 	 * ```
@@ -12808,6 +12988,12 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 *        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
+	 *        loaderHeadline: 'Crunching the numbers...',
+	 *        loaderTips: [
+	 *            { label: 'Tip', text: 'try asking about revenue by region' },
+	 *            { label: 'Tip', text: 'use natural language' },
+	 *        ],
 	 *    },
 	 * })
 	 * ```

package/dist/visual-embed-sdk-react.d.ts CHANGED Viewed

@@ -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.
@@ -5128,11 +5184,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
 	 */
@@ -7587,6 +7662,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
@@ -8644,6 +8729,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.
@@ -9941,6 +10040,8 @@ declare class TsEmbed {
 	private shouldEncodeUrlQueryParams;
 	private defaultHiddenActions;
 	private resizeObserver;
+	private preRenderContainerEl;
+	private containerScrollListener;
 	protected hostEventClient: HostEventClient;
 	protected isReadyForRenderPromise: Promise<void>;
 	protected shouldWaitForRenderPromise: boolean;
@@ -10108,6 +10209,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;
@@ -10320,6 +10444,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: *
@@ -10994,6 +11131,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.
@@ -11296,6 +11441,12 @@ export interface SpotterVizStarterPrompt {
  *        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
+ *        loaderHeadline: 'Crunching the numbers...',
+ *        loaderTips: [
+ *            { label: 'Tip', text: 'try asking about revenue by region' },
+ *            { label: 'Tip', text: 'use natural language' },
+ *        ],
  *    },
  * })
  * ```
@@ -11340,6 +11491,29 @@ export interface SpotterVizConfig {
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 */
 	inputChatPlaceholder?: string;
+	/**
+	 * Custom headline text shown in the SpotterViz loading state.
+	 * Replaces the default loading headline.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 */
+	loaderHeadline?: string;
+	/**
+	 * Custom tips shown in the SpotterViz loading state.
+	 * Replaces the default loading tips with the provided list.
+	 * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+	 */
+	loaderTips?: SpotterVizLoaderTip[];
+}
+/**
+ * A single tip shown in the SpotterViz loading state.
+ * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
+ * @group Embed components
+ */
+export interface SpotterVizLoaderTip {
+	/** Short label rendered alongside the tip (e.g. "Tip"). */
+	label: string;
+	/** Tip body text. */
+	text: string;
 }
 /**
  * Pages within the ThoughtSpot app that can be embedded.
@@ -12080,7 +12254,13 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 *        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?' }]
+	 *        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
+	 *        loaderHeadline: 'Crunching the numbers...',
+	 *        loaderTips: [
+	 *            { label: 'Tip', text: 'try asking about revenue by region' },
+	 *            { label: 'Tip', text: 'use natural language' },
+	 *        ],
 	 *    },
 	 * })
 	 * ```
@@ -12777,6 +12957,12 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 *        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
+	 *        loaderHeadline: 'Crunching the numbers...',
+	 *        loaderTips: [
+	 *            { label: 'Tip', text: 'try asking about revenue by region' },
+	 *            { label: 'Tip', text: 'use natural language' },
+	 *        ],
 	 *    },
 	 * })
 	 * ```