@thoughtspot/visual-embed-sdk 1.52.0 → 1.52.1

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

@@ -1300,6 +1300,280 @@ export class AnswerService {
 	addDisplayedVizToLiveboard(liveboardId: string): Promise<any>;
 	setTMLOverride(override: any): void;
 }
+export interface LiveboardTab {
+	id: string;
+	name: string;
+	[key: string]: any;
+}
+export interface LiveboardGroup {
+	id: string;
+	name: string;
+	[key: string]: any;
+}
+/**
+ * Levels at which a filter or parameter can be applied.
+ */
+export enum ApplicabilityLevel {
+	Liveboard = "LIVEBOARD",
+	Tab = "TAB",
+	Group = "GROUP"
+}
+/**
+ * Scopes a filter or parameter to a specific target.
+ * At `LIVEBOARD` level the filter applies to the whole Liveboard, so `targetId`
+ * is not required. `level` accepts the enum or its string value, e.g. `'TAB'`.
+ */
+export interface Applicability {
+	level: ApplicabilityLevel | `${ApplicabilityLevel}`;
+	targetId?: string;
+}
+export interface FilterUpdate {
+	column: string;
+	oper: string;
+	values: string[];
+	type?: string;
+	applicability?: Applicability;
+}
+export interface LiveboardFilter {
+	applicability?: Applicability;
+	[key: string]: any;
+}
+export interface LiveboardParameter {
+	applicability?: Applicability;
+	[key: string]: any;
+}
+export enum UIPassthroughEvent {
+	PinAnswerToLiveboard = "addVizToPinboard",
+	SaveAnswer = "saveAnswer",
+	GetDiscoverabilityStatus = "getDiscoverabilityStatus",
+	GetAvailableUIPassthroughs = "getAvailableUiPassthroughs",
+	GetAnswerConfig = "getAnswerPageConfig",
+	GetLiveboardConfig = "getPinboardPageConfig",
+	GetUnsavedAnswerTML = "getUnsavedAnswerTML",
+	UpdateFilters = "updateFilters",
+	Drilldown = "drillDown",
+	GetAnswerSession = "getAnswerSession",
+	GetFilters = "getFilters",
+	GetIframeUrl = "getIframeUrl",
+	GetParameters = "getParameters",
+	GetTML = "getTML",
+	GetTabs = "getTabs",
+	GetGroups = "getGroups",
+	GetExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard"
+}
+/**
+ * UI passthrough contract. Each event's request/response is a named interface so it
+ * documents and imports cleanly; `UIPassthroughContractBase` maps events to the pairs.
+ */
+/** Request for {@link UIPassthroughEvent.PinAnswerToLiveboard}. */
+export interface PinAnswerToLiveboardRequest {
+	vizId?: string;
+	newVizName: string;
+	newVizDescription?: string;
+	liveboardId?: string;
+	tabId?: string;
+	newLiveboardName?: string;
+	newTabName?: string;
+}
+/** Response for {@link UIPassthroughEvent.PinAnswerToLiveboard}. */
+export interface PinAnswerToLiveboardResponse {
+	liveboardId: string;
+	tabId: string;
+	vizId: string;
+}
+/** Request for {@link UIPassthroughEvent.SaveAnswer}. */
+export interface SaveAnswerRequest {
+	name: string;
+	description: string;
+	vizId?: string;
+	isDiscoverable?: boolean;
+}
+/** Response for {@link UIPassthroughEvent.SaveAnswer}. */
+export interface SaveAnswerResponse {
+	answerId: string;
+	saveResponse?: any;
+	shareResponse?: any;
+}
+/** Response for {@link UIPassthroughEvent.GetDiscoverabilityStatus}. */
+export interface GetDiscoverabilityStatusResponse {
+	shouldShowDiscoverability: boolean;
+	isDiscoverabilityCheckboxUnselectedPerOrg: boolean;
+}
+/** Response for {@link UIPassthroughEvent.GetAvailableUIPassthroughs}. */
+export interface GetAvailableUIPassthroughsResponse {
+	keys: string[];
+}
+/** Request for {@link UIPassthroughEvent.GetAnswerConfig}. */
+export interface GetAnswerConfigRequest {
+	vizId?: string;
+}
+/** Request for {@link UIPassthroughEvent.GetUnsavedAnswerTML}. */
+export interface GetUnsavedAnswerTMLRequest {
+	sessionId?: string;
+	vizId?: string;
+}
+/** Response for {@link UIPassthroughEvent.GetUnsavedAnswerTML}. */
+export interface GetUnsavedAnswerTMLResponse {
+	tml: string;
+}
+/** Request for {@link UIPassthroughEvent.GetAnswerSession}. */
+export interface GetAnswerSessionRequest {
+	vizId?: string;
+}
+/** Response for {@link UIPassthroughEvent.GetAnswerSession}. */
+export interface GetAnswerSessionResponse {
+	session: SessionInterface;
+	embedAnswerData?: Record<string, any>;
+}
+/** Request for {@link UIPassthroughEvent.GetFilters}. */
+export interface GetFiltersRequest {
+	vizId?: string;
+}
+/** Response for {@link UIPassthroughEvent.GetFilters}. */
+export interface GetFiltersResponse {
+	liveboardFilters: LiveboardFilter[];
+	runtimeFilters: RuntimeFilter[];
+}
+/** Response for {@link UIPassthroughEvent.GetIframeUrl}. */
+export interface GetIframeUrlResponse {
+	iframeUrl: string;
+}
+/** Response for {@link UIPassthroughEvent.GetParameters}. */
+export interface GetParametersResponse {
+	parameters: LiveboardParameter[];
+}
+/** Request for {@link UIPassthroughEvent.GetTML}. */
+export interface GetTMLRequest {
+	vizId?: string;
+	includeNonExecutedSearchTokens?: boolean;
+}
+/** Response for {@link UIPassthroughEvent.GetTabs}. */
+export interface GetTabsResponse {
+	orderedTabIds: string[];
+	numberOfTabs: number;
+	Tabs: LiveboardTab[];
+}
+/** Response for {@link UIPassthroughEvent.GetGroups}. */
+export interface GetGroupsResponse {
+	orderedGroupIds: string[];
+	numberOfGroups: number;
+	Groups: LiveboardGroup[];
+}
+/** Response for {@link UIPassthroughEvent.GetExportRequestForCurrentPinboard}. */
+export interface GetExportRequestForCurrentPinboardResponse {
+	data: {
+		v2Content: string;
+	};
+	type: UIPassthroughEvent.GetExportRequestForCurrentPinboard;
+}
+/**
+ * Request for {@link UIPassthroughEvent.UpdateFilters}. Not the host-event
+ * `UpdateFiltersRequest` (host-event-contracts.ts), which has a different shape.
+ */
+export interface UpdateFiltersPassthroughRequest {
+	filter?: FilterUpdate;
+	filters?: FilterUpdate[];
+}
+/** Request for {@link UIPassthroughEvent.Drilldown}. */
+export interface DrilldownRequest {
+	points: {
+		selectedPoints?: string[];
+		clickedPoint?: string;
+	};
+	columnGuid?: string;
+	autoDrillDown?: boolean;
+	vizId?: string;
+}
+/** Maps each UI passthrough event to its request/response pair. */
+export type UIPassthroughContractBase = {
+	[UIPassthroughEvent.PinAnswerToLiveboard]: {
+		request: PinAnswerToLiveboardRequest;
+		response: PinAnswerToLiveboardResponse;
+	};
+	[UIPassthroughEvent.SaveAnswer]: {
+		request: SaveAnswerRequest;
+		response: SaveAnswerResponse;
+	};
+	[UIPassthroughEvent.GetDiscoverabilityStatus]: {
+		request: any;
+		response: GetDiscoverabilityStatusResponse;
+	};
+	[UIPassthroughEvent.GetAvailableUIPassthroughs]: {
+		request: any;
+		response: GetAvailableUIPassthroughsResponse;
+	};
+	[UIPassthroughEvent.GetAnswerConfig]: {
+		request: GetAnswerConfigRequest;
+		response: any;
+	};
+	[UIPassthroughEvent.GetLiveboardConfig]: {
+		request: any;
+		response: any;
+	};
+	[UIPassthroughEvent.GetUnsavedAnswerTML]: {
+		request: GetUnsavedAnswerTMLRequest;
+		response: GetUnsavedAnswerTMLResponse;
+	};
+	[UIPassthroughEvent.GetAnswerSession]: {
+		request: GetAnswerSessionRequest;
+		response: GetAnswerSessionResponse;
+	};
+	[UIPassthroughEvent.GetFilters]: {
+		request: GetFiltersRequest;
+		response: GetFiltersResponse;
+	};
+	[UIPassthroughEvent.GetIframeUrl]: {
+		request: Record<string, never>;
+		response: GetIframeUrlResponse;
+	};
+	[UIPassthroughEvent.GetParameters]: {
+		request: Record<string, never>;
+		response: GetParametersResponse;
+	};
+	[UIPassthroughEvent.GetTML]: {
+		request: GetTMLRequest;
+		response: Record<string, any>;
+	};
+	[UIPassthroughEvent.GetTabs]: {
+		request: Record<string, never>;
+		response: GetTabsResponse;
+	};
+	[UIPassthroughEvent.GetGroups]: {
+		request: Record<string, never>;
+		response: GetGroupsResponse;
+	};
+	[UIPassthroughEvent.GetExportRequestForCurrentPinboard]: {
+		request: Record<string, never>;
+		response: GetExportRequestForCurrentPinboardResponse;
+	};
+	[UIPassthroughEvent.UpdateFilters]: {
+		request: UpdateFiltersPassthroughRequest;
+		response: unknown;
+	};
+	[UIPassthroughEvent.Drilldown]: {
+		request: DrilldownRequest;
+		response: unknown;
+	};
+};
+export type UIPassthroughRequest<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]["request"];
+export type UIPassthroughResponse<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]["response"];
+export type UIPassthroughArrayResponse<ApiName extends keyof UIPassthroughContractBase> = Array<{
+	refId?: string;
+	value?: UIPassthroughResponse<ApiName>;
+	error?: any;
+}>;
+export type EmbedApiHostEventMapping = {
+	[HostEvent.Pin]: UIPassthroughEvent.PinAnswerToLiveboard;
+	[HostEvent.SaveAnswer]: UIPassthroughEvent.SaveAnswer;
+	[HostEvent.GetAnswerSession]: UIPassthroughEvent.GetAnswerSession;
+	[HostEvent.GetFilters]: UIPassthroughEvent.GetFilters;
+	[HostEvent.GetIframeUrl]: UIPassthroughEvent.GetIframeUrl;
+	[HostEvent.GetParameters]: UIPassthroughEvent.GetParameters;
+	[HostEvent.GetTML]: UIPassthroughEvent.GetTML;
+	[HostEvent.GetTabs]: UIPassthroughEvent.GetTabs;
+	[HostEvent.GetGroups]: UIPassthroughEvent.GetGroups;
+	[HostEvent.getExportRequestForCurrentPinboard]: UIPassthroughEvent.GetExportRequestForCurrentPinboard;
+};
 /**
  * The authentication mechanism for allowing access to
  * the embedded app
@@ -3734,6 +4008,15 @@ export interface RuntimeParameter {
 	 * Values
 	 */
 	value: number | boolean | string;
+	/**
+	 * Whether the parameter is visible to the user (`UpdateParameters` only).
+	 */
+	isVisibleToUser?: boolean;
+	/**
+	 * Scope of the update (`UpdateParameters` only). Omitting it, or `level`,
+	 * targets the Liveboard level.
+	 */
+	applicability?: Applicability;
 }
 /**
  * Event types emitted by the embedded ThoughtSpot application.
@@ -4185,6 +4468,9 @@ export enum EmbedEvent {
 	Download = "download",
 	/**
 	 * Emitted when the download action is triggered on an Answer.
+	 * Payload varies by context: {@link VizScopedRequest} (Search, Answer,
+	 * Liveboard), {@link RequiredVizRequest} (Spotter, vizId required). trigger()
+	 * accepts the union now; per-context enforced next release.
 	 *  Use start:true to subscribe to when download is initiated, or end:true to
 	 *  subscribe to when download is completed. Default is end:true.
 	 * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
@@ -4201,6 +4487,9 @@ export enum EmbedEvent {
 	DownloadAsPng = "downloadAsPng",
 	/**
 	 * Emitted when the Download as PDF action is triggered on an Answer
+	 * Payload varies by context: {@link VizScopedRequest} (Search, Answer; plus
+	 * liveboardId on Liveboard), {@link RequiredVizRequest} (Spotter). trigger()
+	 * accepts the union now; per-context enforced next release.
 	 *  Use start:true to subscribe to when download as PDF is initiated, or end:true to
 	 *  subscribe to when download as PDF is completed. Default is end:true.
 	 * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
@@ -4217,6 +4506,9 @@ export enum EmbedEvent {
 	DownloadAsPdf = "downloadAsPdf",
 	/**
 	 * Emitted when the Download as CSV action is triggered on an Answer.
+	 * Payload varies by context: {@link VizScopedRequest} (Search, Answer,
+	 * Liveboard), {@link RequiredVizRequest} (Spotter, vizId required). trigger()
+	 * accepts the union now; per-context enforced next release.
 	 *  Use start:true to subscribe to when download as CSV is initiated, or end:true to
 	 *  subscribe to when download as CSV is completed. Default is end:true.
 	 * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
@@ -4233,6 +4525,9 @@ export enum EmbedEvent {
 	DownloadAsCsv = "downloadAsCsv",
 	/**
 	 * Emitted when the Download as XLSX action is triggered on an Answer.
+	 * Payload varies by context: {@link VizScopedRequest} (Search, Answer,
+	 * Liveboard), {@link RequiredVizRequest} (Spotter, vizId required). trigger()
+	 * accepts the union now; per-context enforced next release.
 	 *  Use start:true to subscribe to when download as XLSX is initiated, or end:true to
 	 *  subscribe to when download as XLSX is completed. Default is end:true.
 	 * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
@@ -4511,6 +4806,9 @@ export enum EmbedEvent {
 	Schedule = "subscription",
 	/**
 	 * Emitted when a user clicks **Edit** on a Liveboard or visualization
+	 * Payload varies by context: {@link VizScopedRequest} (Liveboard),
+	 * {@link RequiredVizRequest} (Spotter, vizId required). trigger() accepts the
+	 * union now; per-context enforced next release.
 	 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
 	 * @example
 	 * ```js
@@ -5589,6 +5887,7 @@ export enum HostEvent {
 	 * the search query string.
 	 * Supported in `AppEmbed` and `SearchEmbed` deployments.
 	 * Includes the following properties:
+	 * Payload: {@link SearchRequest}.
 	 * @param - Includes the following keys:
 	 * - `searchQuery`: Query string with search tokens.
 	 * - `dataSources`: Data source GUID to search on.
@@ -5616,6 +5915,9 @@ export enum HostEvent {
 	Search = "search",
 	/**
 	 * Triggers a drill on certain points of the specified column
+	 * Payload: {@link DrillDownRequest}; in Liveboard context vizId is required
+	 * ({@link RequiredVizRequest}). trigger() accepts the union now; per-context
+	 * enforced next release.
 	 * Includes the following properties:
 	 * @param - Includes the following keys:
 	 * - `points`: An object containing `selectedPoints` and/or `clickedPoint`
@@ -5695,6 +5997,8 @@ export enum HostEvent {
 	Reload = "reload",
 	/**
 	 * Get iframe URL for the current embed view.
+	 * Payload: none.
+	 * Response: {@link GetIframeUrlResponse}.
 	 * @example
 	 * ```js
 	 * const url = embed.trigger(HostEvent.GetIframeUrl);
@@ -5713,6 +6017,7 @@ export enum HostEvent {
 	GetIframeUrl = "GetIframeUrl",
 	/**
 	 * Display specific visualizations on a Liveboard.
+	 * Payload: `string[]`.
 	 * @param - An array of GUIDs of the visualization to show. The visualization IDs not passed
 	 *  in this parameter will be hidden.
 	 * @example
@@ -5735,6 +6040,7 @@ export enum HostEvent {
 	SetVisibleVizs = "SetPinboardVisibleVizs",
 	/**
 	 * Set a Liveboard tab as an active tab.
+	 * Payload: {@link SetActiveTabRequest}.
 	 * @param - tabId - string of id of Tab to show
 	 * @example
 	 * ```js
@@ -5762,6 +6068,7 @@ export enum HostEvent {
 	 * and `AppEmbed` only. In full application embedding, this event updates
 	 * the runtime filters applied on the Liveboard and saved Answer objects.
 	 *
+	 * Payload: {@link RuntimeFilter}[].
 	 * @param - Array of {@link RuntimeFilter} objects. Each item includes:
 	 * - `columnName`: Name of the column to filter on.
 	 * - `operator`: {@link RuntimeFilterOp} to apply. For more information, see
@@ -5803,6 +6110,7 @@ export enum HostEvent {
 	 * Accepts either a plain value or an object with `path`
 	 * and an optional `replace` flag.
 	 *
+	 * Payload: `string` | `number` | {@link NavigateRequest}.
 	 * @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`
@@ -5830,6 +6138,9 @@ export enum HostEvent {
 	/**
 	 * Open the filter panel for a particular column.
 	 * Works with Search and Liveboard embed.
+	 * Payload: {@link OpenFilterRequest} (the cross-context superset). The
+	 * accepted fields vary by context: {@link OpenFilterLiveboardRequest},
+	 * {@link OpenFilterSpotterRequest}, {@link OpenFilterSearchRequest}.
 	 * @param - { columnId: string,
 	 *  name: string,
 	 *  type: ATTRIBUTE/MEASURE,
@@ -5912,6 +6223,7 @@ export enum HostEvent {
 	/**
 	 * Open the parameter panel for a particular parameter on a Liveboard.
 	 * Mirrors {@link HostEvent.OpenFilter} for parameters.
+	 * Payload: {@link OpenParameterRequest}.
 	 * @param - Includes the following keys:
 	 * - `parameter`: An object identifying the parameter to open, for
 	 *   example, `{ parameterId: '<parameter-GUID>' }`.
@@ -5943,6 +6255,7 @@ export enum HostEvent {
 	OpenParameter = "openParameter",
 	/**
 	 * Add columns to the current search query.
+	 * Payload: `{ columnIds: string[] }`.
 	 * @param - { columnIds: string[] }
 	 * @example
 	 * ```js
@@ -5961,6 +6274,7 @@ export enum HostEvent {
 	AddColumns = "addColumns",
 	/**
 	 * Remove a column from the current search query.
+	 * Payload: `{ columnId: string }`.
 	 * @param - { columnId: string }
 	 * @example
 	 * ```js
@@ -5985,6 +6299,8 @@ export enum HostEvent {
 	 * sorting, toggling of legends, and data drill down.
 	 * For more information, see
 	 * link:https://developers.thoughtspot.com/docs/fetch-data-and-report-apis#transient-lb-content[Liveboard data with unsaved changes].
+	 * Payload: none.
+	 * Response: {@link GetExportRequestForCurrentPinboardResponse}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard).then(
@@ -6006,6 +6322,8 @@ export enum HostEvent {
 	 * requiring additional user input via the *Pin to Liveboard* modal, define
 	 * the following parameters:
 	 *
+	 * Payload: {@link PinAnswerToLiveboardRequest}.
+	 * Response: {@link PinAnswerToLiveboardResponse}.
 	 * @param - Includes the following keys:
 	 * - `vizId`: GUID of the saved Answer or Spotter visualization ID to pin to a
 	 * Liveboard.
@@ -6120,6 +6438,7 @@ export enum HostEvent {
 	LiveboardInfo = "pinboardInfo",
 	/**
 	 * Trigger the **Schedule** action on an embedded Liveboard.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 *  liveboardEmbed.trigger(HostEvent.Schedule)
@@ -6135,6 +6454,7 @@ export enum HostEvent {
 	Schedule = "subscription",
 	/**
 	 * Trigger the **Manage schedule** action on an embedded Liveboard
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 *  liveboardEmbed.trigger(HostEvent.SchedulesList)
@@ -6151,6 +6471,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Export TML** action on an embedded Liveboard or
 	 * Answer.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.ExportTML)
@@ -6173,6 +6494,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Edit TML** action on an embedded Liveboard or
 	 * saved Answers in the full application embedding.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.EditTML)
@@ -6194,6 +6516,7 @@ export enum HostEvent {
 	EditTML = "editTSL",
 	/**
 	 * Trigger the **Update TML** action on an embedded Liveboard.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.UpdateTML)
@@ -6211,6 +6534,7 @@ export enum HostEvent {
 	 * Trigger the **Download PDF** action on an embedded Liveboard,
 	 * visualization or Answer.
 	 *
+	 * Payload: {@link VizScopedRequest} plus optional `liveboardId`.
 	 * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
 	 *
 	 * **NOTE**: The **Download** > **PDF** action is available on
@@ -6261,6 +6585,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **AI Highlights** action on an embedded Liveboard
 	 *
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.AIHighlights)
@@ -6315,6 +6640,9 @@ export enum HostEvent {
 	MakeACopy = "makeACopy",
 	/**
 	 * Trigger the **Delete** action for a Liveboard.
+	 * Payload varies by context: {@link RequiredVizRequest} (Liveboard, vizId
+	 * required), {@link VizScopedRequest} (Search). trigger() accepts the union
+	 * now; per-context enforced next release.
 	 * @example
 	 * ```js
 	 * appEmbed.trigger(HostEvent.Remove)
@@ -6329,6 +6657,7 @@ export enum HostEvent {
 	Remove = "delete",
 	/**
 	 * Trigger the **Explore** action on a visualization.
+	 * Payload: {@link RequiredVizRequest}.
 	 * @param - an object with `vizId` as a key
 	 * @example
 	 * ```js
@@ -6348,6 +6677,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Create alert** action on a KPI chart
 	 * in a Liveboard or saved Answer.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - an object with `vizId` as a key
 	 * @example
 	 * ```js
@@ -6379,6 +6709,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Manage alerts** action on a KPI chart
 	 * in a visualization or saved Answer.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - an object with `vizId` as a key
 	 * @example
 	 * ```js
@@ -6416,6 +6747,7 @@ export enum HostEvent {
 	 * on a Liveboard.
 	 *
 	 * This event is not supported in visualization embed and search embed.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - Object parameter. Includes the following keys:
 	 * - `vizId`: To trigger the action for a specific visualization in Liveboard embed,
 	 *   pass in `vizId` as a key. In Spotter embed, `vizId` refers to the Answer ID and
@@ -6458,6 +6790,7 @@ export enum HostEvent {
 	Edit = "edit",
 	/**
 	 * Trigger the **Copy link** action on a Liveboard or visualization
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - object - to trigger the action for a
 	 * specific visualization in Liveboard embed, pass in `vizId` as a key
 	 * @example
@@ -6503,6 +6836,7 @@ export enum HostEvent {
 	CopyLink = "embedDocument",
 	/**
 	 * Trigger the **Present** action on a Liveboard or visualization
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - object - to trigger the action for a specific visualization
 	 *  in Liveboard embed, pass in `vizId` as a key
 	 * @example
@@ -6548,6 +6882,8 @@ export enum HostEvent {
 	Present = "present",
 	/**
 	 * Get TML for the current search.
+	 * Payload: {@link GetTMLRequest}.
+	 * Response: `Record<string, any>`.
 	 * @example
 	 * ```js
 	 * searchEmbed.trigger(HostEvent.GetTML).then((tml) => {
@@ -6597,6 +6933,7 @@ export enum HostEvent {
 	 * Trigger the **Show underlying data** action on a
 	 * chart or table.
 	 *
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - an object with vizId as a key
 	 * @example
 	 * ```js
@@ -6630,6 +6967,7 @@ export enum HostEvent {
 	 * Trigger the **Delete** action for a visualization
 	 * in an embedded Liveboard, or a chart or table
 	 * generated from Search.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - Liveboard embed takes an object with `vizId` as a key.
 	 * Can be left empty if embedding Search or visualization.
 	 * @example
@@ -6658,6 +6996,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **SpotIQ analyze** action on a
 	 * chart or table.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - Liveboard embed takes `vizId` as a
 	 * key. Can be left undefined when embedding Search or
 	 * visualization.
@@ -6720,6 +7059,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Download** > **PNG** action on
 	 * charts in the embedded view.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.DownloadAsPng,
@@ -6750,6 +7090,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Download** > **CSV**  action on tables in
 	 * the embedded view.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - `vizId` refers to the Visualization ID in Spotter embed and is required in Spotter embed.
 	 * @example
 	 * ```js
@@ -6789,6 +7130,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Download** > **XLSX**  action on tables
 	 * in the embedded view.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - `vizId` refers to the Visualization ID in Spotter embed and is required in Spotter embed.
 	 * @example
 	 * ```js
@@ -6828,6 +7170,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Share** action on an embedded
 	 * Liveboard or Answer.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.Share)
@@ -6854,6 +7197,7 @@ export enum HostEvent {
 	 * Trigger the **Save** action on a Liveboard, Answer, or Spotter.
 	 * Saves the changes.
 	 *
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - `vizId` refers to the Spotter Visualization Id used in Spotter embed.
 	 * It is required and can be retrieved from the data embed event.
 	 *
@@ -6905,6 +7249,7 @@ export enum HostEvent {
 	/**
 	 * Trigger the **Sync to Sheets** action on an embedded visualization or Answer
 	 * Sends data from an Answer or Liveboard visualization to a Google sheet.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - an object with `vizId` as a key
 	 * @example
 	 * ```js
@@ -6935,6 +7280,7 @@ export enum HostEvent {
 	 * Trigger the **Sync to Other Apps** action on an embedded visualization or Answer
 	 * Sends data from an Answer or Liveboard visualization to third-party apps such
 	 * as Slack, Salesforce, Microsoft Teams, ServiceNow and so on.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - an object with vizId as a key
 	 * @example
 	 * ```js
@@ -6965,6 +7311,7 @@ export enum HostEvent {
 	 * Trigger the **Manage pipelines** action on an embedded
 	 * visualization or Answer.
 	 * Allows users to manage ThoughtSpot Sync pipelines.
+	 * Payload: {@link VizScopedRequest}.
 	 * @param - an object with `vizId` as a key
 	 * @example
 	 * ```js
@@ -6993,6 +7340,7 @@ export enum HostEvent {
 	ManagePipelines = "manage-pipeline",
 	/**
 	 * Reset search operation on the Search or Answer page.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * searchEmbed.trigger(HostEvent.ResetSearch)
@@ -7020,6 +7368,8 @@ export enum HostEvent {
 	 * whole Liveboard.
 	 * The `applicability` attribute is available from SDK: 1.53.0 |
 	 * ThoughtSpot: 26.10.0.cl.
+	 * Payload: {@link GetFiltersRequest}.
+	 * Response: {@link GetFiltersResponse}.
 	 * @example
 	 * ```js
 	 * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
@@ -7039,6 +7389,7 @@ export enum HostEvent {
 	GetFilters = "getFilters",
 	/**
 	 * Update one or several filters applied on a Liveboard.
+	 * Payload: {@link UpdateFiltersRequest}.
 	 * @param - Includes the following keys:
 	 * - `filter`: A single filter object containing column name, filter operator, and
 	 * values.
@@ -7167,6 +7518,8 @@ export enum HostEvent {
 	UpdateFilters = "updateFilters",
 	/**
 	 * Get tab details for the current Liveboard.
+	 * Payload: none.
+	 * Response: {@link GetTabsResponse}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.GetTabs).then((tabDetails) => {
@@ -7192,6 +7545,8 @@ export enum HostEvent {
 	/**
 	 * Get group details for the current Liveboard.
 	 * Mirrors {@link HostEvent.GetTabs} for filter/parameter groups.
+	 * Payload: none.
+	 * Response: {@link GetGroupsResponse}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.GetGroups).then((groupDetails) => {
@@ -7216,6 +7571,7 @@ export enum HostEvent {
 	GetGroups = "getGroups",
 	/**
 	 * Set the visible tabs on a Liveboard.
+	 * Payload: `string[]`.
 	 * @param - an array of ids of tabs to show, the IDs not passed
 	 *          will be hidden.
 	 * @example
@@ -7238,6 +7594,7 @@ export enum HostEvent {
 	SetVisibleTabs = "SetPinboardVisibleTabs",
 	/**
 	 * Set the hidden tabs on a Liveboard.
+	 * Payload: `string[]`.
 	 * @param - an array of the IDs of the tabs to hide.
 	 * The IDs not passed will be shown.
 	 * @example
@@ -7266,6 +7623,8 @@ export enum HostEvent {
 	 * `getAnswerService()` method on the embed instance to get an AnswerService
 	 * object that provides a more convenient interface for working with answers.
 	 *
+	 * Payload: {@link GetAnswerSessionRequest}.
+	 * Response: {@link GetAnswerSessionResponse}.
 	 * @example
 	 * ```js
 	 * // Preferred way to get an AnswerService
@@ -7293,6 +7652,7 @@ export enum HostEvent {
 	GetAnswerSession = "getAnswerSession",
 	/**
 	 * Trigger the *Ask Sage* action for visualizations
+	 * Payload: {@link RequiredVizRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.AskSage,
@@ -7304,6 +7664,7 @@ export enum HostEvent {
 	/**
 	 * Trigger cross filter update action on a Liveboard.
 	 *
+	 * Payload: {@link UpdateCrossFilterRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.UpdateCrossFilter, {
@@ -7319,7 +7680,9 @@ export enum HostEvent {
 	UpdateCrossFilter = "UpdateCrossFilter",
 	/**
 	 * Trigger reset action for a personalized Liveboard view.
-	 * This event is deprecated. Use {@link HostEvent.ResetLiveboardPersonalizedView} instead.
+	 * This event is deprecated.
+	 * Use {@link HostEvent.ResetLiveboardPersonalizedView} instead.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.ResetLiveboardPersonalisedView);
@@ -7340,6 +7703,7 @@ export enum HostEvent {
 	/**
 	 * Triggers an action to update Parameter values on embedded
 	 * Answers, Liveboard, and Spotter answer in Edit mode.
+	 * Payload: {@link RuntimeParameter}[].
 	 * @param - Includes the following keys for each item:
 	 * - `name`: Name of the parameter.
 	 * - `value`: The value to set for the parameter.
@@ -7397,6 +7761,8 @@ export enum HostEvent {
 	 * whole Liveboard.
 	 * The `applicability` attribute is available from SDK: 1.53.0 |
 	 * ThoughtSpot: 26.10.0.cl.
+	 * Payload: none.
+	 * Response: {@link GetParametersResponse}.
 	 * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
@@ -7434,6 +7800,7 @@ export enum HostEvent {
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
 	 * ```
+	 * Payload: {@link PersonalisedViewRequest} (`viewId` only).
 	 * @example
 	 * ```js
 	 * // Update personalized view from liveboard context
@@ -7466,6 +7833,7 @@ export enum HostEvent {
 	 * If neither is provided, the Liveboard resets to the original/default view.
 	 * When a `viewName` is provided and multiple views share
 	 * the same name, the first match is selected.
+	 * Payload: {@link PersonalisedViewRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(
@@ -7509,6 +7877,8 @@ export enum HostEvent {
 	 * If no parameters are specified, the save action is
 	 * triggered with a modal to prompt users to
 	 * add a name and description for the Answer.
+	 * Payload: {@link SaveAnswerRequest}.
+	 * Response: {@link SaveAnswerResponse}.
 	 * @param - Includes the following keys:
 	 * - `vizId`: Refers to the Answer ID in Spotter embed and is **required** in Spotter
 	 * embed.
@@ -7594,6 +7964,7 @@ export enum HostEvent {
 	/**
 	 * Triggers a search operation with the search tokens specified in
 	 * the search query string in spotter embed.
+	 * Payload: {@link SpotterSearchRequest}.
 	 * @param - Includes the following keys:
 	 * - `query`: Text string in Natural Language format.
 	 * - `executeSearch`: Boolean to execute search and update search query.
@@ -7618,6 +7989,7 @@ export enum HostEvent {
 	SpotterSearch = "SpotterSearch",
 	/**
 	 * Edits the last prompt in spotter embed.
+	 * Payload: `string`.
 	 * @param - `query`: Text string
 	 * @example
 	 * ```js
@@ -7634,6 +8006,7 @@ export enum HostEvent {
 	EditLastPrompt = "EditLastPrompt",
 	/**
 	 * Opens the data source preview modal in Spotter Embed.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
@@ -7669,6 +8042,7 @@ export enum HostEvent {
 	DataModelInstructions = "DataModelInstructions",
 	/**
 	 * Resets the Spotter Embed Conversation.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.ResetSpotterConversation);
@@ -7681,6 +8055,7 @@ export enum HostEvent {
 	 * `conversationId` is **mandatory** — you must pass the id of the
 	 * conversation to share. Also no-op when sharing is disabled
 	 * (enableShareConversation off) or when already in the read-only shared view.
+	 * Payload: {@link ConversationScopedRequest}.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.ShareSpotterConversation, { conversationId: 'abc' });
@@ -7690,6 +8065,7 @@ export enum HostEvent {
 	ShareSpotterConversation = "ShareSpotterConversation",
 	/**
 	 * Closes the Spotter share-conversation modal. No-op if none is open.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.CloseSpotterShareConversation);
@@ -7699,6 +8075,7 @@ export enum HostEvent {
 	CloseSpotterShareConversation = "CloseSpotterShareConversation",
 	/**
 	 * Exits the read-only shared-conversation view.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.ExitSpotterSharedConversation);
@@ -7708,6 +8085,7 @@ export enum HostEvent {
 	ExitSpotterSharedConversation = "ExitSpotterSharedConversation",
 	/**
 	 * Deletes the last prompt in spotter embed.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.DeleteLastPrompt);
@@ -7717,6 +8095,7 @@ export enum HostEvent {
 	DeleteLastPrompt = "DeleteLastPrompt",
 	/**
 	 * Toggle the visualization to chart or table view.
+	 * Payload: {@link RequiredVizRequest}.
 	 * @param - `vizId ` refers to the Visualization ID in Spotter embed and is required.
 	 * @example
 	 * ```js
@@ -7755,6 +8134,7 @@ export enum HostEvent {
 	VisibleEmbedCoordinates = "visibleEmbedCoordinates",
 	/**
 	 * Trigger the *Spotter* action for visualizations present on the liveboard's vizzes.
+	 * Payload: {@link RequiredVizRequest}.
 	 * @param - `vizId` refers to the Visualization ID in Spotter embed and is required.
 	 * @example
 	 * ```js
@@ -7816,6 +8196,7 @@ export enum HostEvent {
 	 * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
 	 * instance.
 	 *
+	 * Payload: {@link ConversationScopedRequest}.
 	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 	 * @example
 	 * ```js
@@ -7833,6 +8214,7 @@ export enum HostEvent {
 	 * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
 	 * instance.
 	 *
+	 * Payload: {@link ConversationScopedRequest}.
 	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
 	 * @example
 	 * ```js
@@ -7857,6 +8239,7 @@ export enum HostEvent {
 	 * Trigger the **Send Test Email** action in the Liveboard schedule modal.
 	 * Sends a test schedule email to self or all recipients.
 	 * Requires `isSendNowLiveboardSchedulingEnabled` to be enabled.
+	 * Payload: {@link ScheduleEmailRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.SendTestScheduleEmail, {
@@ -7875,6 +8258,7 @@ export enum HostEvent {
 	SendTestScheduleEmail = "sendTestScheduleEmail",
 	/**
 	 * Sends a user message (prompt) to the SpotterViz panel programmatically.
+	 * Payload: `{ query: string }`.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @param query - the prompt text to send.
 	 * @example
@@ -7887,6 +8271,7 @@ export enum HostEvent {
 	SpotterVizSendUserMessage = "SpotterVizSendUserMessage",
 	/**
 	 * Initializes a new SpotterViz conversation.
+	 * Payload: none.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @example
 	 * ```js
@@ -7896,6 +8281,7 @@ export enum HostEvent {
 	InitSpotterVizConversation = "InitSpotterVizConversation",
 	/**
 	 * Opens the SpotterViz panel.
+	 * Payload: none.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @example
 	 * ```js
@@ -7905,6 +8291,7 @@ export enum HostEvent {
 	OpenSpotterVizPanel = "OpenSpotterVizPanel",
 	/**
 	 * Closes the SpotterViz panel.
+	 * Payload: none.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @example
 	 * ```js
@@ -7915,6 +8302,7 @@ export enum HostEvent {
 	/**
 	 * Clears browser cache and fetches new data for liveboard ChartViz Containers.
 	 * Requires `enableLiveboardDataCache` to be enabled.
+	 * Payload: {@link ScheduleEmailRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.RefreshLiveboardBrowserCache);
@@ -9947,89 +10335,350 @@ export enum Action {
 	 * disabledActions: [Action.SpotterOnLiveboard]
 	 * ```
 	 */
-	SpotterOnLiveboard = "spotterOnLiveboard"
-}
-export enum PrefetchFeatures {
-	FullApp = "FullApp",
-	SearchEmbed = "SearchEmbed",
-	LiveboardEmbed = "LiveboardEmbed",
-	VizEmbed = "VizEmbed"
-}
-/**
- * Enum for options to change context trigger.
- * The `BOTH_CLICKS` option is available from 10.8.0.cl.
- */
-export enum ContextMenuTriggerOptions {
-	LEFT_CLICK = "left-click",
-	RIGHT_CLICK = "right-click",
-	BOTH_CLICKS = "both-clicks"
-}
-export interface ColumnValue {
-	column: {
-		id: string;
-		name: string;
-		dataType: string;
-		[key: string]: any;
-	};
-	value: string | number | boolean | {
-		v: {
-			s: number;
-			e: number;
-		};
-	};
-}
-export interface VizPoint {
-	selectedAttributes: ColumnValue[];
-	selectedMeasures: ColumnValue[];
-}
-/**
- * @group Events
- */
-export interface CustomActionPayload {
-	contextMenuPoints?: {
-		clickedPoint: VizPoint;
-		selectedPoints: VizPoint[];
-	};
-	embedAnswerData: {
-		name: string;
-		id: string;
-		sources: {
-			header: {
-				guid: string;
-			};
-		};
-		columns: any[];
-		data: any[];
-		[key: string]: any;
-	};
-	session: SessionInterface;
-	vizId?: string;
-}
-export interface CustomAction {
-	name: string;
-	id: string;
-	position: CustomActionsPosition;
-	target: CustomActionTarget;
-	metadataIds?: {
-		answerIds?: string[];
-		liveboardIds?: string[];
-		vizIds?: string[];
-	};
-	dataModelIds?: {
-		modelIds?: string[];
-		modelColumnNames?: string[];
-	};
-	orgIds?: string[];
-	groupIds?: string[];
-}
-/**
- * Enum options to show custom actions at different
- * positions in the application.
- */
-export enum CustomActionsPosition {
+	SpotterOnLiveboard = "spotterOnLiveboard",
 	/**
-	 * Shows the action as a primary button
-	 * in the toolbar area of the embed.
+	 * Controls the visibility and disabled state of the "Chart Type" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.ChartTypeSettings],
+	 *     disabledActions: [Action.ChartTypeSettings],
+	 * }
+	 * ```
+	 */
+	ChartTypeSettings = "CHART_TYPE",
+	/**
+	 * Controls the visibility and disabled state of the "Layout" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.LayoutSettings],
+	 *     disabledActions: [Action.LayoutSettings],
+	 * }
+	 * ```
+	 */
+	LayoutSettings = "LAYOUT",
+	/**
+	 * Controls the visibility and disabled state of the "Column" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.ColumnSettings],
+	 *     disabledActions: [Action.ColumnSettings],
+	 * }
+	 * ```
+	 */
+	ColumnSettings = "COLUMN",
+	/**
+	 * Controls the visibility and disabled state of the "Axis" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.AxisSettings],
+	 *     disabledActions: [Action.AxisSettings],
+	 * }
+	 * ```
+	 */
+	AxisSettings = "AXIS",
+	/**
+	 * Controls the visibility and disabled state of the "Data Label" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.DataLabelSettings],
+	 *     disabledActions: [Action.DataLabelSettings],
+	 * }
+	 * ```
+	 */
+	DataLabelSettings = "DATA_LABEL",
+	/**
+	 * Controls the visibility and disabled state of the "Tooltip" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.TooltipSettings],
+	 *     disabledActions: [Action.TooltipSettings],
+	 * }
+	 * ```
+	 */
+	TooltipSettings = "TOOLTIP",
+	/**
+	 * Controls the visibility and disabled state of the "Legend" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.LegendSettings],
+	 *     disabledActions: [Action.LegendSettings],
+	 * }
+	 * ```
+	 */
+	LegendSettings = "LEGEND",
+	/**
+	 * Controls the visibility and disabled state of the "Display" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.DisplaySettings],
+	 *     disabledActions: [Action.DisplaySettings],
+	 * }
+	 * ```
+	 */
+	DisplaySettings = "DISPLAY",
+	/**
+	 * Controls the visibility and disabled state of the "Query Details" menu
+	 * item in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.QuerySettings],
+	 *     disabledActions: [Action.QuerySettings],
+	 * }
+	 * ```
+	 */
+	QuerySettings = "QUERY_DETAILS",
+	/**
+	 * Controls the visibility and disabled state of the "Custom Action" menu
+	 * item in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.CustomSettings],
+	 *     disabledActions: [Action.CustomSettings],
+	 * }
+	 * ```
+	 */
+	CustomSettings = "CUSTOM_ACTION",
+	/**
+	 * Controls the visibility and disabled state of the "Muze AI" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.MuzeAiSettings],
+	 *     disabledActions: [Action.MuzeAiSettings],
+	 * }
+	 * ```
+	 */
+	MuzeAiSettings = "MUZE_AI",
+	/**
+	 * Controls the visibility and disabled state of the "R Analysis" menu item
+	 * in Chart Settings V2.
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.RAnalysisSettings],
+	 *     disabledActions: [Action.RAnalysisSettings],
+	 * }
+	 * ```
+	 */
+	RAnalysisSettings = "R_ANALYSIS",
+	/**
+	 * Controls the visibility and disabled state of the "Add to Collection" menu item.
+	 * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.AddToCollection],
+	 *     disabledActions: [Action.AddToCollection],
+	 * }
+	 * ```
+	 */
+	AddToCollection = "addToCollection",
+	/**
+	 * Controls the visibility and disabled state of the "Create Collection" button.
+	 * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.CreateCollection],
+	 *     disabledActions: [Action.CreateCollection],
+	 * }
+	 * ```
+	 */
+	CreateCollection = "createCollection",
+	/**
+	 * Controls the visibility and disabled state of the "Move" menu item in a
+	 * Collection.
+	 * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.MoveToCollection],
+	 *     disabledActions: [Action.MoveToCollection],
+	 * }
+	 * ```
+	 */
+	MoveToCollection = "moveToCollection",
+	/**
+	 * Controls the visibility and disabled state of the "Remove" menu item in a
+	 * Collection.
+	 * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.RemoveFromCollection],
+	 *     disabledActions: [Action.RemoveFromCollection],
+	 * }
+	 * ```
+	 */
+	RemoveFromCollection = "removeFromCollection",
+	/**
+	 * Controls the visibility and disabled state of the "Delete" menu item for a
+	 * Collection.
+	 * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * {
+	 *     hiddenActions: [Action.DeleteCollection],
+	 *     disabledActions: [Action.DeleteCollection],
+	 * }
+	 * ```
+	 */
+	DeleteCollection = "deleteCollection"
+}
+export enum PrefetchFeatures {
+	FullApp = "FullApp",
+	SearchEmbed = "SearchEmbed",
+	LiveboardEmbed = "LiveboardEmbed",
+	VizEmbed = "VizEmbed"
+}
+/**
+ * Enum for options to change context trigger.
+ * The `BOTH_CLICKS` option is available from 10.8.0.cl.
+ */
+export enum ContextMenuTriggerOptions {
+	LEFT_CLICK = "left-click",
+	RIGHT_CLICK = "right-click",
+	BOTH_CLICKS = "both-clicks"
+}
+export interface ColumnValue {
+	column: {
+		id: string;
+		name: string;
+		dataType: string;
+		[key: string]: any;
+	};
+	value: string | number | boolean | {
+		v: {
+			s: number;
+			e: number;
+		};
+	};
+}
+export interface VizPoint {
+	selectedAttributes: ColumnValue[];
+	selectedMeasures: ColumnValue[];
+}
+/**
+ * @group Events
+ */
+export interface CustomActionPayload {
+	/**
+	 * Id of the custom action that was triggered. Matches the `id` you set on
+	 * the {@link CustomAction}. Omitted on Liveboard-level code-based actions.
+	 */
+	id?: string;
+	contextMenuPoints?: {
+		clickedPoint: VizPoint;
+		selectedPoints: VizPoint[];
+	};
+	embedAnswerData: {
+		name: string;
+		id: string;
+		sources: {
+			header: {
+				guid: string;
+			};
+		};
+		columns: any[];
+		data: any[];
+		[key: string]: any;
+	};
+	session: SessionInterface;
+	vizId?: string;
+}
+/**
+ * A code-based custom action to inject into the embedded ThoughtSpot UI.
+ * Pass an array of these as `customActions` in the embed view config. When a
+ * user invokes the action, the host emits {@link EmbedEvent.CustomAction} with
+ * a {@link CustomActionPayload} carrying the same `id`.
+ */
+export interface CustomAction {
+	/**
+	 * Display label shown on the action's button or menu item.
+	 */
+	name: string;
+	/**
+	 * Unique identifier for the action. Echoed back as `id` on the
+	 * {@link CustomActionPayload} when the action is invoked.
+	 */
+	id: string;
+	/**
+	 * Where the action appears: a primary button, the "More" menu, or the
+	 * right-click context menu. See {@link CustomActionsPosition}.
+	 */
+	position: CustomActionsPosition;
+	/**
+	 * The surface the action applies to (Liveboard, visualization, Answer, or
+	 * Spotter). See {@link CustomActionTarget}. The allowed `position` values
+	 * and scoping keys depend on the target.
+	 */
+	target: CustomActionTarget;
+	/**
+	 * Scope the action to specific objects by GUID. Which keys are allowed
+	 * depends on `target` (for example, a `VIZ` action may use `answerIds`,
+	 * `liveboardIds`, and `vizIds`).
+	 */
+	metadataIds?: {
+		answerIds?: string[];
+		liveboardIds?: string[];
+		vizIds?: string[];
+	};
+	/**
+	 * Scope the action by data model, using model GUIDs or column names.
+	 * Allowed for `VIZ`, `ANSWER`, and `SPOTTER` targets.
+	 */
+	dataModelIds?: {
+		modelIds?: string[];
+		modelColumnNames?: string[];
+	};
+	/**
+	 * Restrict the action to specific organizations by ID.
+	 */
+	orgIds?: string[];
+	/**
+	 * Restrict the action to specific user groups by ID.
+	 */
+	groupIds?: string[];
+}
+/**
+ * Enum options to show custom actions at different
+ * positions in the application.
+ */
+export enum CustomActionsPosition {
+	/**
+	 * Shows the action as a primary button
+	 * in the toolbar area of the embed.
 	 */
 	PRIMARY = "PRIMARY",
 	/**
@@ -10956,259 +11605,556 @@ export interface TableOverrides {
 	updateMaskPaths?: string[];
 }
 /**
- * Visualization overrides to customize chart and table rendering
- * within embedded ThoughtSpot components.
- *
- * @group Visual Overrides
- * @example
- * ```js
- * const embed = new AppEmbed('#tsEmbed', {
- *   visualOverrides: {
- *     chart: {
- *       legend: { show: true, position: 'bottom' },
- *       columns: [{ name: 'Revenue', color: '#1f77b4' }],
- *     },
- *     table: {
- *       display: { tableTheme: 'ZEBRA', tableContentDensity: 'COMPACT' },
- *     },
- *   },
- * });
- * ```
+ * Visualization overrides to customize chart and table rendering
+ * within embedded ThoughtSpot components.
+ *
+ * @group Visual Overrides
+ * @example
+ * ```js
+ * const embed = new AppEmbed('#tsEmbed', {
+ *   visualOverrides: {
+ *     chart: {
+ *       legend: { show: true, position: 'bottom' },
+ *       columns: [{ name: 'Revenue', color: '#1f77b4' }],
+ *     },
+ *     table: {
+ *       display: { tableTheme: 'ZEBRA', tableContentDensity: 'COMPACT' },
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export interface VisualizationOverrides {
+	/** Chart visualization overrides */
+	chart?: ChartOverrides;
+	/** Table visualization overrides */
+	table?: TableOverrides;
+}
+/**
+ * The configuration object for the full-height behavior shared by the
+ * Liveboard and app embeds.
+ *
+ * When `fullHeight` is enabled the SDK resizes the embed container to match the
+ * height reported by the ThoughtSpot app, and — when lazy loading is also
+ * enabled — keeps the app informed of the portion of the embed that is
+ * currently visible so that visualizations load on demand.
+ */
+export interface FullHeightViewConfig {
+	/**
+	 * If set to true, the embedded object container dynamically resizes
+	 * according to the height of the Liveboard.
+	 *
+	 * **Note**:  Using fullHeight loads all visualizations on the
+	 * Liveboard simultaneously, which results in multiple warehouse
+	 * queries and potentially a longer wait for the topmost
+	 * visualizations to display on the screen.
+	 * Setting `fullHeight` to `false` fetches visualizations
+	 * incrementally as users scroll the page to view the charts and tables.
+	 *
+	 * From SDK 1.52.0, enabling `fullHeight` also turns on
+	 * {@link lazyLoadingForFullHeight} and
+	 * {@link enableScrollableContainerLazyLoading}, so visualizations load as
+	 * they scroll into view. Set either flag to `false` to opt out.
+	 *
+	 * Supported embed types: `LiveboardEmbed`, `AppEmbed`
+	 * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with the embed component name.
+	 * // For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#embed', {
+	 *   ... // other view config
+	 *   fullHeight: true,
+	 * });
+	 * ```
+	 */
+	fullHeight?: boolean;
+	/**
+	 * This is the minimum height (in pixels) for a full-height Liveboard.
+	 * Setting this height helps resolve issues with empty Liveboards and
+	 * other screens navigable from a Liveboard.
+	 *
+	 * Supported embed types: `LiveboardEmbed`, `AppEmbed`
+	 * @version SDK: 1.44.2 | ThoughtSpot: 10.15.0.cl
+	 * @default 500
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with the embed component name.
+	 * // For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#embed', {
+	 *   ... // other view config
+	 *   fullHeight: true,
+	 *   minimumHeight: 600,
+	 * });
+	 * ```
+	 */
+	minimumHeight?: number;
+	/**
+	 * This is the minimum height (in pixels) for a full-height Liveboard.
+	 * Setting this height helps resolve issues with empty Liveboards and
+	 * other screens navigable from a Liveboard.
+	 *
+	 * Supported embed types: `LiveboardEmbed`, `AppEmbed`
+	 * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
+	 * @deprecated Use `minimumHeight` instead.
+	 * @default 500
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with the embed component name.
+	 * // For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#embed', {
+	 *   ... // other view config
+	 *   fullHeight: true,
+	 *   defaultHeight: 600,
+	 * });
+	 * ```
+	 */
+	defaultHeight?: number;
+	/**
+	 * Loads visualizations only as they scroll into the viewport, instead of
+	 * loading the whole full-height Liveboard at once.
+	 *
+	 * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
+	 * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
+	 * set explicitly. Set it to `false` to load every visualization upfront.
+	 * The flag has no effect unless `fullHeight` is enabled.
+	 *
+	 * Supported embed types: `LiveboardEmbed`, `AppEmbed`
+	 * @type {boolean}
+	 * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+	 * @default true when `fullHeight` is enabled, from SDK 1.52.0
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with the embed component name.
+	 * // For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#embed-container', {
+	 *    // ...other options
+	 *    fullHeight: true,
+	 *    lazyLoadingForFullHeight: true,
+	 * })
+	 * ```
+	 */
+	lazyLoadingForFullHeight?: boolean;
+	/**
+	 * How far outside the viewport a visualization starts loading, when
+	 * {@link lazyLoadingForFullHeight} is enabled.
+	 *
+	 * For example, if the margin is set to '10px',
+	 * the visualization will be loaded 10px before its top edge is visible in the
+	 * viewport.
+	 *
+	 * The format is similar to CSS margin, so `'500px 0px'` extends the
+	 * prefetch 500px above and below the viewport and not sideways. Accepted
+	 * units are `px`, `em`, `rem`, `%`, `vh` and `vw`, plus bare `0` and
+	 * `auto`; an invalid value is logged and ignored.
+	 *
+	 * From SDK 1.52.0 this defaults to `'500px 0px'` — roughly one
+	 * visualization ahead of the scroll position, so a chart has usually
+	 * finished loading by the time it scrolls into view. Use a smaller margin
+	 * to cut warehouse queries further, or `'0px'` to load a visualization
+	 * only once it is actually visible.
+	 *
+	 * Supported embed types: `LiveboardEmbed`, `AppEmbed`
+	 * @type {string}
+	 * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+	 * @default '500px 0px' when `fullHeight` is enabled, from SDK 1.52.0
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with the embed component name.
+	 * // For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#embed-container', {
+	 *    // ...other options
+	 *    fullHeight: true,
+	 *    lazyLoadingForFullHeight: true,
+	 *    // With 0px, the visualization only starts loading once it is
+	 *    // visible in the viewport.
+	 *    lazyLoadingMargin: '0px',
+	 * })
+	 * ```
+	 */
+	lazyLoadingMargin?: string;
+	/**
+	 * Computes the visible region of the embed against its scrollable and
+	 * clipping ancestors, instead of treating the browser window as the only
+	 * viewport, and tracks scroll and resize on those ancestors.
+	 *
+	 * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
+	 * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
+	 * set explicitly. Set it to `false` when the page scrolls with the window
+	 * and the embed has no clipping ancestor, to skip the extra ancestor
+	 * tracking.
+	 *
+	 * Supported embed types: `LiveboardEmbed`, `AppEmbed`
+	 * @type {boolean}
+	 * @default true when `fullHeight` is enabled, from SDK 1.52.0
+	 */
+	enableScrollableContainerLazyLoading?: boolean;
+}
+/**
+ * Request for host events that MAY target a specific visualization.
+ * Omitting vizId targets the current answer/liveboard as a whole.
+ * (In some contexts, e.g. Spotter, the app requires vizId at runtime.)
+ */
+export interface VizScopedRequest {
+	vizId?: string;
+}
+/**
+ * Request for host events that MUST target a specific visualization.
+ */
+export interface RequiredVizRequest {
+	vizId: string;
+}
+/**
+ * Request for Spotter conversation-scoped host events.
+ */
+export interface ConversationScopedRequest {
+	conversationId: string;
+}
+/**
+ * Request payload for {@link HostEvent.OpenFilter}. Field requirements
+ * vary by context (Search requires columnId/type/dataType/name); the
+ * contract is the cross-context superset — the app validates per context
+ * at runtime. Per-context views: {@link OpenFilterLiveboardRequest},
+ * {@link OpenFilterSpotterRequest}, {@link OpenFilterSearchRequest}.
+ */
+export interface OpenFilterRequest {
+	column: {
+		columnId?: string;
+		columnName?: string;
+		type?: string;
+		dataType?: string;
+		name?: string;
+		isStrictDateColumn?: boolean;
+	};
+	applicability?: Applicability;
+	visualizationId?: string;
+	liveboardId?: string;
+}
+/**
+ * `OpenFilter` in Liveboard context: full column plus scoping fields.
+ * A per-context view of {@link OpenFilterRequest} (documentation only today;
+ * `trigger()` accepts the superset).
+ */
+export interface OpenFilterLiveboardRequest {
+	column: {
+		columnId?: string;
+		columnName?: string;
+	};
+	applicability?: Applicability;
+	visualizationId?: string;
+	liveboardId?: string;
+}
+/**
+ * `OpenFilter` in Spotter context: only the column identity is accepted.
+ */
+export interface OpenFilterSpotterRequest {
+	column: {
+		columnId?: string;
+		columnName?: string;
+	};
+}
+/**
+ * `OpenFilter` in Search/Answer context: column identity plus column metadata.
+ */
+export interface OpenFilterSearchRequest {
+	column: {
+		columnId?: string;
+		columnName?: string;
+		type?: string;
+		dataType?: string;
+		name?: string;
+		isStrictDateColumn?: boolean;
+	};
+}
+/**
+ * Request payload for {@link HostEvent.DrillDown}. Drills on selected or
+ * clicked points of a visualization. In Liveboard context `vizId` is required
+ * at runtime (documentation only today; `trigger()` is not yet type-enforced).
+ */
+export interface DrillDownRequest {
+	points: {
+		clickedPoint?: object;
+		selectedPoints?: object[];
+	};
+	columnGuid?: string;
+	autoDrillDown?: boolean;
+	vizId?: string;
+}
+/**
+ * Request payload for {@link HostEvent.OpenParameter}. One of parameterId
+ * or parameterName must be provided (validated at runtime).
  */
-export interface VisualizationOverrides {
-	/** Chart visualization overrides */
-	chart?: ChartOverrides;
-	/** Table visualization overrides */
-	table?: TableOverrides;
+export interface OpenParameterRequest {
+	parameter: {
+		parameterId?: string;
+		parameterName?: string;
+	};
+	applicability?: Applicability;
 }
-export interface LiveboardTab {
-	id: string;
-	name: string;
-	[key: string]: any;
+/**
+ * Request payload for {@link HostEvent.Search}.
+ */
+export interface SearchRequest {
+	searchQuery: string;
+	dataSources: string[];
+	execute?: boolean;
 }
-export interface LiveboardGroup {
-	id: string;
-	name: string;
-	[key: string]: any;
+/**
+ * Request payload for {@link HostEvent.SpotterSearch}.
+ */
+export interface SpotterSearchRequest {
+	query: string;
+	executeSearch: boolean;
 }
 /**
- * Levels at which a filter or parameter can be applied.
+ * A single cross-filter condition for {@link HostEvent.UpdateCrossFilter}.
  */
-export enum ApplicabilityLevel {
-	Liveboard = "LIVEBOARD",
-	Tab = "TAB",
-	Group = "GROUP"
+export interface CrossFilterCondition {
+	columnName?: string;
+	operator?: string;
+	values: Array<string | number | boolean>;
 }
 /**
- * Scopes a filter or parameter to a specific target.
- * At `LIVEBOARD` level the filter applies to the whole Liveboard, so `targetId`
- * is not required.
+ * Request payload for {@link HostEvent.UpdateCrossFilter}.
  */
-export interface Applicability {
-	level: ApplicabilityLevel;
-	targetId?: string;
+export interface UpdateCrossFilterRequest {
+	vizId: string;
+	conditions: CrossFilterCondition[];
 }
-export interface FilterUpdate {
-	column: string;
-	oper: string;
-	values: string[];
+/**
+ * A single filter entry for {@link HostEvent.UpdateFilters}. Supports both
+ * the current (columnName/operator) and legacy (column/oper) field names.
+ */
+export interface HostFilterUpdate {
+	columnName?: string;
+	columnId?: string;
+	operator?: string;
+	values: Array<string | number | boolean>;
 	type?: string;
+	datePeriod?: string;
+	negate?: boolean;
+	/** Legacy field name for columnName. */
+	column?: string;
+	/** Legacy field name for operator. */
+	oper?: string;
 	applicability?: Applicability;
 }
-export interface LiveboardFilter {
-	applicability?: Applicability;
-	[key: string]: any;
+/**
+ * Request payload for {@link HostEvent.UpdateFilters} (singular or plural
+ * form).
+ */
+export interface UpdateFiltersRequest {
+	filter?: HostFilterUpdate;
+	filters?: HostFilterUpdate[];
+	/**
+	 * Scope the update to a specific visualization on a Liveboard.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	visualizationId?: string;
+	/**
+	 * Scope the update to a specific Liveboard.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	liveboardId?: string;
 }
-export interface LiveboardParameter {
-	applicability?: Applicability;
-	[key: string]: any;
+/**
+ * Request payload for personalised-view host events.
+ */
+export interface PersonalisedViewRequest {
+	viewId?: string;
+	viewName?: string;
 }
-export enum UIPassthroughEvent {
-	PinAnswerToLiveboard = "addVizToPinboard",
-	SaveAnswer = "saveAnswer",
-	GetDiscoverabilityStatus = "getDiscoverabilityStatus",
-	GetAvailableUIPassthroughs = "getAvailableUiPassthroughs",
-	GetAnswerConfig = "getAnswerPageConfig",
-	GetLiveboardConfig = "getPinboardPageConfig",
-	GetUnsavedAnswerTML = "getUnsavedAnswerTML",
-	UpdateFilters = "updateFilters",
-	Drilldown = "drillDown",
-	GetAnswerSession = "getAnswerSession",
-	GetFilters = "getFilters",
-	GetIframeUrl = "getIframeUrl",
-	GetParameters = "getParameters",
-	GetTML = "getTML",
-	GetTabs = "getTabs",
-	GetGroups = "getGroups",
-	GetExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard"
+/**
+ * Request payload for schedule-email related host events.
+ */
+export interface ScheduleEmailRequest {
+	sendToSelf?: boolean;
 }
-export type UIPassthroughContractBase = {
-	[UIPassthroughEvent.PinAnswerToLiveboard]: {
-		request: {
-			vizId?: string;
-			newVizName: string;
-			newVizDescription?: string;
-			liveboardId?: string;
-			tabId?: string;
-			newLiveboardName?: string;
-			newTabName?: string;
-		};
-		response: {
-			liveboardId: string;
-			tabId: string;
-			vizId: string;
-		};
-	};
-	[UIPassthroughEvent.SaveAnswer]: {
-		request: {
-			name: string;
-			description: string;
-			vizId?: string;
-			isDiscoverable?: boolean;
-		};
-		response: {
-			answerId: string;
-			saveResponse?: any;
-			shareResponse?: any;
-		};
-	};
-	[UIPassthroughEvent.GetDiscoverabilityStatus]: {
-		request: any;
-		response: {
-			shouldShowDiscoverability: boolean;
-			isDiscoverabilityCheckboxUnselectedPerOrg: boolean;
-		};
-	};
-	[UIPassthroughEvent.GetAvailableUIPassthroughs]: {
-		request: any;
-		response: {
-			keys: string[];
-		};
-	};
-	[UIPassthroughEvent.GetAnswerConfig]: {
-		request: {
-			vizId?: string;
-		};
-		response: any;
-	};
-	[UIPassthroughEvent.GetLiveboardConfig]: {
-		request: any;
-		response: any;
-	};
-	[UIPassthroughEvent.GetUnsavedAnswerTML]: {
-		request: {
-			sessionId?: string;
-			vizId?: string;
-		};
-		response: {
-			tml: string;
-		};
-	};
-	[UIPassthroughEvent.GetAnswerSession]: {
-		request: {
-			vizId?: string;
-		};
-		response: {
-			session: SessionInterface;
-			embedAnswerData?: Record<string, any>;
-		};
-	};
-	[UIPassthroughEvent.GetFilters]: {
-		request: {
-			vizId?: string;
-		};
-		response: {
-			liveboardFilters: LiveboardFilter[];
-			runtimeFilters: RuntimeFilter[];
-		};
-	};
-	[UIPassthroughEvent.GetIframeUrl]: {
-		request: Record<string, never>;
-		response: {
-			iframeUrl: string;
-		};
-	};
-	[UIPassthroughEvent.GetParameters]: {
-		request: Record<string, never>;
-		response: {
-			parameters: LiveboardParameter[];
-		};
-	};
-	[UIPassthroughEvent.GetTML]: {
-		request: {
-			vizId?: string;
-			includeNonExecutedSearchTokens?: boolean;
-		};
-		response: Record<string, any>;
-	};
-	[UIPassthroughEvent.GetTabs]: {
-		request: Record<string, never>;
-		response: {
-			orderedTabIds: string[];
-			numberOfTabs: number;
-			Tabs: LiveboardTab[];
-		};
+/**
+ * Object form of the {@link HostEvent.Navigate} payload.
+ */
+export interface NavigateRequest {
+	/**
+	 * Route to navigate to, or a history delta such as `1` or `-1`.
+	 */
+	path: string | number;
+	/**
+	 * When `true`, replaces the current history entry instead of pushing.
+	 */
+	replace?: boolean;
+}
+/**
+ * Request payload for {@link HostEvent.SetActiveTab}.
+ */
+export interface SetActiveTabRequest {
+	/**
+	 * Id of the liveboard tab to make active.
+	 */
+	tabId: string;
+}
+/**
+ * Typed request payloads for host events that do not go through the UI
+ * passthrough pipeline (`HostEvent` member → request type; `void` = no payload).
+ *
+ * Shapes are transcribed from the host's runtime validation schemas
+ * (embed-util HostEventContract) — what the ThoughtSpot app actually enforces —
+ * flattened across contexts to the permissive superset (context-specific
+ * requirements are validated at runtime).
+ *
+ * Responses are typed only for UI-passthrough-backed events today (see
+ * {@link HostEventResponse}). Add a response map alongside this one when the
+ * first explicit response shape is specified; tightening later is additive.
+ *
+ * Deliberately absent (do not add without an audit):
+ * - DrillDown: the runtime schema (object-shaped points) and the UI
+ *   passthrough contract (string-shaped points) disagree — resolve the
+ *   drift first.
+ * - GetAnswerSession/GetParameters/GetTML: typed via the UI passthrough
+ *   mapping; their Spotter-context vizId requirement is runtime-only.
+ */
+export interface HostEventRequestMap {
+	[HostEvent.UpdateRuntimeFilters]: RuntimeFilter[];
+	[HostEvent.UpdateParameters]: RuntimeParameter[];
+	[HostEvent.UpdateFilters]: UpdateFiltersRequest;
+	[HostEvent.UpdateCrossFilter]: UpdateCrossFilterRequest;
+	[HostEvent.OpenFilter]: OpenFilterRequest;
+	[HostEvent.OpenParameter]: OpenParameterRequest;
+	[HostEvent.SetVisibleVizs]: string[];
+	[HostEvent.SetVisibleTabs]: string[];
+	[HostEvent.SetHiddenTabs]: string[];
+	[HostEvent.SetActiveTab]: SetActiveTabRequest;
+	[HostEvent.Navigate]: string | number | NavigateRequest;
+	[HostEvent.Search]: SearchRequest;
+	[HostEvent.ResetSearch]: void;
+	[HostEvent.AddColumns]: {
+		columnIds: string[];
 	};
-	[UIPassthroughEvent.GetGroups]: {
-		request: Record<string, never>;
-		response: {
-			orderedGroupIds: string[];
-			numberOfGroups: number;
-			Groups: LiveboardGroup[];
-		};
+	[HostEvent.RemoveColumn]: {
+		columnId: string;
 	};
-	[UIPassthroughEvent.GetExportRequestForCurrentPinboard]: {
-		request: Record<string, never>;
-		response: {
-			data: {
-				v2Content: string;
-			};
-			type: UIPassthroughEvent.GetExportRequestForCurrentPinboard;
-		};
+	[HostEvent.Edit]: VizScopedRequest;
+	[HostEvent.Save]: VizScopedRequest;
+	[HostEvent.Delete]: VizScopedRequest;
+	[HostEvent.Share]: VizScopedRequest;
+	[HostEvent.Present]: VizScopedRequest;
+	[HostEvent.CopyLink]: VizScopedRequest;
+	[HostEvent.ExportTML]: VizScopedRequest;
+	[HostEvent.EditTML]: VizScopedRequest;
+	[HostEvent.UpdateTML]: VizScopedRequest;
+	[HostEvent.SchedulesList]: VizScopedRequest;
+	[HostEvent.Schedule]: VizScopedRequest;
+	[HostEvent.SpotIQAnalyze]: VizScopedRequest;
+	[HostEvent.ShowUnderlyingData]: VizScopedRequest;
+	[HostEvent.CreateMonitor]: VizScopedRequest;
+	[HostEvent.ManageMonitor]: VizScopedRequest;
+	[HostEvent.SyncToSheets]: VizScopedRequest;
+	[HostEvent.SyncToOtherApps]: VizScopedRequest;
+	[HostEvent.ManagePipelines]: VizScopedRequest;
+	[HostEvent.DownloadAsPng]: VizScopedRequest;
+	[HostEvent.DownloadAsCsv]: VizScopedRequest;
+	[HostEvent.DownloadAsXlsx]: VizScopedRequest;
+	[HostEvent.DownloadAsPdf]: VizScopedRequest & {
+		liveboardId?: string;
 	};
-	[UIPassthroughEvent.UpdateFilters]: {
-		request: {
-			filter?: FilterUpdate;
-			filters?: FilterUpdate[];
-		};
-		response: unknown;
+	[HostEvent.Explore]: RequiredVizRequest;
+	[HostEvent.AskSage]: RequiredVizRequest;
+	[HostEvent.AskSpotter]: RequiredVizRequest;
+	[HostEvent.AnswerChartSwitcher]: RequiredVizRequest;
+	[HostEvent.UpdatePersonalisedView]: Pick<PersonalisedViewRequest, "viewId">;
+	[HostEvent.SelectPersonalizedView]: PersonalisedViewRequest;
+	[HostEvent.ResetLiveboardPersonalisedView]: void;
+	[HostEvent.AIHighlights]: void;
+	[HostEvent.SendTestScheduleEmail]: ScheduleEmailRequest;
+	[HostEvent.RefreshLiveboardBrowserCache]: ScheduleEmailRequest;
+	[HostEvent.SpotterSearch]: SpotterSearchRequest;
+	[HostEvent.ResetSpotterConversation]: void;
+	[HostEvent.ShareSpotterConversation]: ConversationScopedRequest;
+	[HostEvent.CloseSpotterShareConversation]: void;
+	[HostEvent.ExitSpotterSharedConversation]: void;
+	[HostEvent.PinSpotterConversation]: ConversationScopedRequest;
+	[HostEvent.UnpinSpotterConversation]: ConversationScopedRequest;
+	[HostEvent.EditLastPrompt]: string;
+	[HostEvent.DeleteLastPrompt]: void;
+	[HostEvent.PreviewSpotterData]: void;
+	[HostEvent.SpotterVizSendUserMessage]: {
+		query: string;
 	};
-	[UIPassthroughEvent.Drilldown]: {
-		request: {
-			points: {
-				selectedPoints?: string[];
-				clickedPoint?: string;
-			};
-			columnGuid?: string;
-			autoDrillDown?: boolean;
-			vizId?: string;
-		};
-		response: unknown;
+	[HostEvent.InitSpotterVizConversation]: void;
+	[HostEvent.OpenSpotterVizPanel]: void;
+	[HostEvent.CloseSpotterVizPanel]: void;
+}
+/**
+ * Per-context request shapes for events whose payload varies by
+/**
+ * Resolves the typed request payload for a host event.
+ * Resolution order:
+ * 1. Explicitly typed request in {@link HostEventRequestMap}
+ * 2. UI passthrough backed contract ({@link EmbedApiHostEventMapping})
+ * 3. `any` (event not audited/typed yet — backward compatible)
+ *
+ * Requests are the cross-context superset today. The per-context `*Request`
+ * interfaces (e.g. {@link OpenFilterLiveboardRequest}) document how the shape
+ * narrows by context; a later release may thread the caller's context to
+ * enforce it.
+ */
+export type HostEventRequest<HostEventT extends HostEvent> = HostEventT extends keyof HostEventRequestMap ? HostEventRequestMap[HostEventT] : HostEventT extends keyof EmbedApiHostEventMapping ? UIPassthroughRequest<EmbedApiHostEventMapping[HostEventT]> : any;
+/**
+ * Resolves the typed response payload for a host event. Only UI passthrough
+ * backed events have typed responses today; everything else resolves to `any`.
+ */
+export type HostEventResponse<HostEventT extends HostEvent, ContextT extends ContextType = ContextType> = HostEventT extends keyof EmbedApiHostEventMapping ? UIPassthroughResponse<EmbedApiHostEventMapping[HostEventT]> : any;
+/**
+ * Payload type accepted by `embed.trigger()`. Keeps the historical
+ * `PayloadT` escape hatch so untyped existing call sites keep compiling.
+ */
+export type TriggerPayload<PayloadT, HostEventT extends HostEvent> = PayloadT | HostEventRequest<HostEventT>;
+/**
+ * Deep `Partial` of a request type: every field optional at every depth, with no
+ * index signature — so object literals carrying unknown fields are flagged.
+ */
+export type DeepPartial<T> = T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? {
+	[K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * `trigger()`'s `data` type: an all-optional view of the event's request type.
+ * See {@link HostEventRequest} and the `*Request` interfaces, e.g. {@link SearchRequest}.
+ * No-payload events take `{}`. SDK 1.54.0 makes this strict (required fields enforced).
+ */
+export type TriggerData<HostEventT extends HostEvent> = HostEventRequest<HostEventT> extends void ? Record<string, never> : DeepPartial<HostEventRequest<HostEventT>>;
+/**
+ * Response type returned by `embed.trigger()`.
+ */
+export type TriggerResponse<PayloadT, HostEventT extends HostEvent, ContextT extends ContextType = ContextType> = PayloadT extends HostEventRequest<HostEventT> ? HostEventResponse<HostEventT, ContextT> : any;
+/**
+ * Typed `data` field per embed event. Seed with audited events only.
+ */
+export interface EmbedEventDataExtension {
+	[EmbedEvent.AuthInit]: {
+		/**
+		 * Whether authentication was successful.
+		 */
+		isLoggedIn?: boolean;
+		[key: string]: any;
 	};
+	[EmbedEvent.EmbedListenerReady]: Record<string, any>;
+	/**
+	 * Fired when a callback-type custom action is triggered. Use
+	 * `payload.data.id` to identify which action fired.
+	 */
+	[EmbedEvent.CustomAction]: CustomActionPayload;
+}
+/**
+ * Resolves the typed `data` payload for an embed event; `any` when the
+ * event has not been audited/typed yet.
+ */
+export type EmbedEventData<EmbedEventT extends EmbedEvent> = EmbedEventT extends keyof EmbedEventDataExtension ? EmbedEventDataExtension[EmbedEventT] : any;
+/**
+ * Full envelope delivered to `embed.on()` callbacks for a given event:
+ * the wire fields (`type`, `status`) plus the typed `data`.
+ */
+export type EmbedEventPayload<EmbedEventT extends EmbedEvent> = Omit<MessagePayload, "data"> & {
+	data: EmbedEventData<EmbedEventT>;
 };
-export type UIPassthroughRequest<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]["request"];
-export type UIPassthroughResponse<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]["response"];
-export type UIPassthroughArrayResponse<ApiName extends keyof UIPassthroughContractBase> = Array<{
-	refId?: string;
-	value?: UIPassthroughResponse<ApiName>;
-	error?: any;
-}>;
-export type EmbedApiHostEventMapping = {
-	[HostEvent.Pin]: UIPassthroughEvent.PinAnswerToLiveboard;
-	[HostEvent.SaveAnswer]: UIPassthroughEvent.SaveAnswer;
-	[HostEvent.GetAnswerSession]: UIPassthroughEvent.GetAnswerSession;
-	[HostEvent.GetFilters]: UIPassthroughEvent.GetFilters;
-	[HostEvent.GetIframeUrl]: UIPassthroughEvent.GetIframeUrl;
-	[HostEvent.GetParameters]: UIPassthroughEvent.GetParameters;
-	[HostEvent.GetTML]: UIPassthroughEvent.GetTML;
-	[HostEvent.GetTabs]: UIPassthroughEvent.GetTabs;
-	[HostEvent.GetGroups]: UIPassthroughEvent.GetGroups;
-	[HostEvent.getExportRequestForCurrentPinboard]: UIPassthroughEvent.GetExportRequestForCurrentPinboard;
-};
-export type HostEventRequest<HostEventT extends HostEvent> = HostEventT extends keyof EmbedApiHostEventMapping ? UIPassthroughRequest<EmbedApiHostEventMapping[HostEventT]> : any;
-export type HostEventResponse<HostEventT extends HostEvent, ContextT extends ContextType> = HostEventT extends keyof EmbedApiHostEventMapping ? UIPassthroughResponse<EmbedApiHostEventMapping[HostEventT]> : any;
-export type TriggerPayload<PayloadT, HostEventT extends HostEvent> = PayloadT | HostEventRequest<HostEventT>;
-export type TriggerResponse<PayloadT, HostEventT extends HostEvent, ContextT extends ContextType> = PayloadT extends HostEventRequest<HostEventT> ? HostEventResponse<HostEventT, ContextT> : any;
 class HostEventClient {
 	iFrame: HTMLIFrameElement;
 	/** Cached list of available UI passthrough keys from the embedded app */
@@ -11258,7 +12204,7 @@ class HostEventClient {
 	 * @param payload - Optional payload for the event
 	 * @param context - Optional context (e.g. vizId) for scoped operations
 	 */
-	triggerHostEvent<HostEventT extends HostEvent, PayloadT = HostEventRequest<HostEventT>, ContextT extends ContextType = ContextType>(hostEvent: HostEventT, payload?: TriggerPayload<PayloadT, HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextType>>;
+	triggerHostEvent<HostEventT extends HostEvent, PayloadT = HostEventRequest<HostEventT>, ContextT extends ContextType = ContextType>(hostEvent: HostEventT, payload?: TriggerPayload<PayloadT, HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextT>>;
 }
 class TsEmbed {
 	/**
@@ -11276,6 +12222,7 @@ class TsEmbed {
 	 * The key to store the embed instance in the DOM node
 	 */
 	protected embedNodeKey: string;
+	protected embedContainerLoadedKey: string;
 	protected isAppInitialized: boolean;
 	/**
 	 * A reference to the iframe within which the ThoughtSpot app
@@ -11445,10 +12392,10 @@ class TsEmbed {
 	 */
 	protected getEmbedBasePath(query: string): string;
 	protected getUpdateEmbedParamsObject(): Promise<{
-		customisations: CustomisationsInterface;
-		authToken: string;
 		runtimeFilterParams: string;
 		runtimeParameterParams: string;
+		customisations: CustomisationsInterface;
+		authToken: string;
 		hiddenHomepageModules: HomepageModule[];
 		reorderedHomepageModules: string[];
 		hostConfig: Record<string, any>;
@@ -11641,21 +12588,6 @@ class TsEmbed {
 	 * or else the v2 event type itself
 	 */
 	protected getCompatibleEventType(eventType: EmbedEvent): EmbedEvent;
-	/**
-	 * Calculates the iframe center for the current visible viewPort
-	 * of iframe using Scroll position of Host App, offsetTop for iframe
-	 * in Host app. ViewPort height of the tab.
-	 * @returns iframe Center in visible viewport,
-	 *  Iframe height,
-	 *  View port height.
-	 */
-	protected getIframeCenter(): {
-		iframeCenter: number;
-		iframeScrolled: number;
-		iframeHeight: number;
-		viewPortHeight: number;
-		iframeVisibleViewPort: number;
-	};
 	/**
 	 * Registers an event listener to trigger an alert when the ThoughtSpot app
 	 * sends an event of a particular message type to the host application.
@@ -11679,7 +12611,7 @@ class TsEmbed {
 	 * });
 	 * ```
 	 */
-	on(messageType: EmbedEvent, callback: MessageCallback, options?: MessageOptions, isRegisteredBySDK?: boolean): typeof TsEmbed.prototype;
+	on<EmbedEventT extends EmbedEvent>(messageType: EmbedEventT, callback: (payload: EmbedEventPayload<EmbedEventT>, responder?: (data: any) => void) => void, options?: MessageOptions, isRegisteredBySDK?: boolean): typeof TsEmbed.prototype;
 	/**
 	 * Removes an event listener for a particular event type.
 	 * @param messageType The message type
@@ -11715,6 +12647,8 @@ class TsEmbed {
 	 */
 	private embedContainerReadyCallbacks;
 	protected getPreRenderObj<T extends TsEmbed>(): T;
+	protected takeOverPreRender(): void;
+	private markEmbedContainerLoaded;
 	private checkEmbedContainerLoaded;
 	private executeEmbedContainerReadyCallbacks;
 	/**
@@ -11725,8 +12659,12 @@ class TsEmbed {
 	protected createEmbedContainerHandler: (source: EmbedEvent.AuthInit | EmbedEvent.EmbedListenerReady) => () => void;
 	/**
 	 * Triggers an event to the embedded app
+	 *
+	 * Payload typing: from SDK 1.52.0 (ThoughtSpot Cloud 26.9.0.cl), unknown fields
+	 * on a known event's payload fail to compile. From SDK 1.54.0 (26.11.0.cl) the
+	 * payload is checked strictly against the event contract — update call sites now.
 	 * @param {HostEvent} messageType The event type
-	 * @param {any} data The payload to send with the message
+	 * @param {TriggerData} data The payload, typed against the event's contract
 	 * @param {ContextType} context Optional context type to specify the context from which the event is triggered.
 	 * Use ContextType.Search for search answer context, ContextType.Answer for answer/explore context,
 	 * ContextType.Liveboard for liveboard context, or ContextType.Spotter for spotter context.
@@ -11743,7 +12681,7 @@ class TsEmbed {
 	 * ```
 	 * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl (for context parameter)
 	 */
-	trigger<HostEventT extends HostEvent, PayloadT = HostEventRequest<HostEventT>, ContextT extends ContextType = ContextType>(messageType: HostEventT, data?: TriggerPayload<PayloadT, HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextT>>;
+	trigger<HostEventT extends HostEvent, PayloadT = HostEventRequest<HostEventT>, ContextT extends ContextType = ContextType>(messageType: HostEventT, data?: TriggerData<HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextT>>;
 	/**
 	 * Triggers an event to the embedded app, skipping the UI flow.
 	 * @param {UIPassthroughEvent} apiName - The name of the API to be triggered.
@@ -11845,6 +12783,7 @@ class TsEmbed {
 	 * @returns
 	 */
 	prerenderGeneric(): Promise<any>;
+	protected preRenderParamsApplied: Promise<void>;
 	protected beforePrerenderVisible(): void;
 	/**
 	 * Displays the pre-rendered component inside the host element.
@@ -11923,7 +12862,7 @@ class V1Embed extends TsEmbed {
 	 * });
 	 * ```
 	 */
-	on(messageType: EmbedEvent, callback: MessageCallback, options?: MessageOptions): typeof TsEmbed.prototype;
+	on<EmbedEventT extends EmbedEvent>(messageType: EmbedEventT, callback: (payload: EmbedEventPayload<EmbedEventT>, responder?: (data: any) => void) => void, options?: MessageOptions): typeof TsEmbed.prototype;
 	/**
 	 * Only for testing purposes.
 	 * @hidden
@@ -13055,7 +13994,7 @@ export interface DiscoveryExperience {
  * The view configuration for full app embedding.
  * @group Embed components
  */
-export interface AppViewConfig extends AllEmbedViewConfig {
+export interface AppViewConfig extends AllEmbedViewConfig, FullHeightViewConfig {
 	/**
 	 * If true, the top navigation bar within the ThoughtSpot app
 	 * is displayed. By default, the navigation bar is hidden.
@@ -13323,51 +14262,23 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
 	 * @hidden
-	 */
-	liveboardV2?: boolean;
-	/**
-	 * If set to true, the Search Assist feature is enabled.
-	 *
-	 * Supported embed types: `AppEmbed`
-	 * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1-sw
-	 * @default true
-	 * @example
-	 * ```js
-	 * const embed = new AppEmbed('#tsEmbed', {
-	 *    ... // other embed view config
-	 *    enableSearchAssist: true,
-	 * })
-	 * ```
-	 */
-	enableSearchAssist?: boolean;
-	/**
-	 * If set to true, the Liveboard container dynamically resizes
-	 * according to the height of the Liveboard.
-	 *
-	 * **Note**: Using fullHeight loads all visualizations
-	 * on the Liveboard simultaneously, which results in
-	 * multiple warehouse queries and potentially a
-	 * longer wait for the topmost visualizations to
-	 * display on the screen. Setting fullHeight to
-	 * `false` fetches visualizations incrementally as
-	 * users scroll the page to view the charts and tables.
-	 *
-	 * From SDK 1.52.0, enabling `fullHeight` also turns on
-	 * {@link lazyLoadingForFullHeight} and
-	 * {@link enableScrollableContainerLazyLoading}, so visualizations load as
-	 * they scroll into view. Set either flag to `false` to opt out.
+	 */
+	liveboardV2?: boolean;
+	/**
+	 * If set to true, the Search Assist feature is enabled.
 	 *
 	 * Supported embed types: `AppEmbed`
-	 * @version SDK: 1.21.0 | ThoughtSpot: 9.4.0.cl, 9.4.0-sw
+	 * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1-sw
+	 * @default true
 	 * @example
 	 * ```js
 	 * const embed = new AppEmbed('#tsEmbed', {
 	 *    ... // other embed view config
-	 *    fullHeight: true,
+	 *    enableSearchAssist: true,
 	 * })
 	 * ```
 	 */
-	fullHeight?: boolean;
+	enableSearchAssist?: boolean;
 	/**
 	 * Enables the V2 navigation and modular home page experience.
 	 * For more information,
@@ -13562,78 +14473,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	isGranularXLSXCSVSchedulesEnabled?: boolean;
-	/**
-	 * Loads visualizations only as they scroll into the viewport, instead of
-	 * loading the whole full-height Liveboard at once.
-	 *
-	 * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
-	 * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
-	 * set explicitly. Set it to `false` to load every visualization upfront.
-	 * The flag has no effect unless `fullHeight` is enabled.
-	 *
-	 * @type {boolean}
-	 * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
-	 * @default true when `fullHeight` is enabled, from SDK 1.52.0
-	 * @example
-	 * ```js
-	 * const embed = new AppEmbed('#embed-container', {
-	 *    // ...other options
-	 *    fullHeight: true,
-	 *    lazyLoadingForFullHeight: true,
-	 * })
-	 * ```
-	 */
-	lazyLoadingForFullHeight?: boolean;
-	/**
-	 * Computes the visible region of the embed against its scrollable and
-	 * clipping ancestors, instead of treating the browser window as the only
-	 * viewport, and tracks scroll and resize on those ancestors.
-	 *
-	 * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
-	 * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
-	 * set explicitly. Set it to `false` when the page scrolls with the window
-	 * and the embed has no clipping ancestor, to skip the extra ancestor
-	 * tracking.
-	 *
-	 * @type {boolean}
-	 * @default true when `fullHeight` is enabled, from SDK 1.52.0
-	 * @hidden
-	 */
-	enableScrollableContainerLazyLoading?: boolean;
-	/**
-	 * How far outside the viewport a visualization starts loading, when
-	 * {@link lazyLoadingForFullHeight} is enabled.
-	 *
-	 * For example, if the margin is set to '10px',
-	 * the visualization will be loaded 10px before its top edge is visible in the
-	 * viewport.
-	 *
-	 * The format is similar to CSS margin, so `'500px 0px'` extends the
-	 * prefetch 500px above and below the viewport and not sideways. Accepted
-	 * units are `px`, `em`, `rem`, `%`, `vh` and `vw`, plus bare `0` and
-	 * `auto`; an invalid value is logged and ignored.
-	 *
-	 * From SDK 1.52.0 this defaults to `'500px 0px'` — roughly one
-	 * visualization ahead of the scroll position, so a chart has usually
-	 * finished loading by the time it scrolls into view. Use a smaller margin
-	 * to cut warehouse queries further, or `'0px'` to load a visualization
-	 * only once it is actually visible.
-	 *
-	 * @type {string}
-	 * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
-	 * @default '500px 0px' when `fullHeight` is enabled, from SDK 1.52.0
-	 * @example
-	 * ```js
-	 * const embed = new AppEmbed('#embed-container', {
-	 *    // ...other options
-	 *    fullHeight: true,
-	 *    lazyLoadingForFullHeight: true,
-	 *   // Using 0px, the visualization will be only loaded when it's visible in the viewport.
-	 *    lazyLoadingMargin: '0px',
-	 * })
-	 * ```
-	 */
-	lazyLoadingMargin?: string;
 	/**
 	 * updatedSpotterChatPrompt : Controls the updated spotter chat prompt.
 	 *
@@ -13821,23 +14660,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * @default false
 	 */
 	enableStopAnswerGenerationEmbed?: boolean;
-	/**
-	 * This is the minimum height (in pixels) for a full-height App.
-	 * Setting this height helps resolve issues with empty Apps and
-	 * other screens navigable from an App.
-	 *
-	 * @version SDK: 1.44.2 | ThoughtSpot: 10.15.0.cl
-	 * @default 500
-	 * @example
-	 * ```js
-	 * const embed = new AppEmbed('#embed', {
-	 *   ... // other app view config
-	 *   fullHeight: true,
-	 *   minimumHeight: 600,
-	 * });
-	 * ```
-	 */
-	minimumHeight?: number;
 	/**
 	 * To enable the homepage announcement banner.
 	 * Controls the visibility of the announcement section
@@ -13887,6 +14709,20 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	updatedSpotterExperience?: boolean;
+	/**
+	 * If set to `true`, the answer edit panel is hidden.
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    hideAnswerEditPanel: true,
+	 * })
+	 * ```
+	 */
+	hideAnswerEditPanel?: boolean;
 }
 /**
  * APP_INIT data shape for AppEmbed.
@@ -13906,9 +14742,7 @@ export interface AppEmbedAppInitData extends DefaultAppInitData {
  */
 export class AppEmbed extends V1Embed {
 	protected viewConfig: AppViewConfig;
-	private defaultHeight;
-	private lazyLoadScrollContainers;
-	private lazyLoadResizeObserver;
+	private readonly fullHeightController?;
 	constructor(domSelector: DOMSelector, viewConfig: AppViewConfig);
 	/**
 	 * Extends the default APP_INIT payload with `embedParams.spotterSidebarConfig`
@@ -13929,27 +14763,11 @@ export class AppEmbed extends V1Embed {
 	 */
 	protected getEmbedParams(): string;
 	protected getEmbedParamsObject(): any;
-	private sendFullHeightLazyLoadData;
-	/**
-	 * This is a handler for the RequestVisibleEmbedCoordinates event.
-	 * It is used to send the visible coordinates data to the host application.
-	 * @param data The event payload
-	 * @param responder The responder function
-	 */
-	private requestVisibleEmbedCoordinatesHandler;
 	/**
 	 * Constructs the URL of the ThoughtSpot app page to be rendered.
 	 * @param pageId The ID of the page to be embedded.
 	 */
 	getIFrameSrc(): string;
-	/**
-	 * Set the iframe height as per the computed height received
-	 * from the ThoughtSpot app.
-	 * @param data The event payload
-	 */
-	protected updateIFrameHeight: (data: MessagePayload) => void;
-	private embedIframeCenter;
-	private setIframeHeightForNonEmbedLiveboard;
 	/**
 	 * Gets the ThoughtSpot route of the page for a particular page ID.
 	 * @param pageId The identifier for a page in the ThoughtSpot app.
@@ -13980,8 +14798,6 @@ export class AppEmbed extends V1Embed {
 	 */
 	destroy(): void;
 	private postRender;
-	private registerLazyLoadEvents;
-	private unregisterLazyLoadEvents;
 	/**
 	 * Renders the embedded application pages in the ThoughtSpot app.
 	 * @param renderOptions An object containing the page ID
@@ -14286,71 +15102,7 @@ export interface LiveboardEmbedAppInitData extends DefaultAppInitData {
  * The configuration for the embedded Liveboard or visualization page view.
  * @group Embed components
  */
-export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardCommonViewConfig, LiveboardAppEmbedViewConfig {
-	/**
-	 * If set to true, the embedded object container dynamically resizes
-	 * according to the height of the Liveboard.
-	 *
-	 * **Note**:  Using fullHeight loads all visualizations on the
-	 * Liveboard simultaneously, which results in multiple warehouse
-	 * queries and potentially a longer wait for the topmost
-	 * visualizations to display on the screen.
-	 * Setting `fullHeight` to `false` fetches visualizations
-	 * incrementally as users scroll the page to view the charts and tables.
-	 *
-	 * From SDK 1.52.0, enabling `fullHeight` also turns on
-	 * {@link lazyLoadingForFullHeight} and
-	 * {@link enableScrollableContainerLazyLoading}, so visualizations load as
-	 * they scroll into view. Set either flag to `false` to opt out.
-	 *
-	 *
-	 * Supported embed types: `LiveboardEmbed`
-	 * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
-	 * @example
-	 * ```js
-	 * const embed = new LiveboardEmbed('#embed', {
-	 *   ... // other liveboard view config
-	 *  fullHeight: true,
-	 * });
-	 * ```
-	 */
-	fullHeight?: boolean;
-	/**
-	 * This is the minimum height (in pixels) for a full-height Liveboard.
-	 * Setting this height helps resolve issues with empty Liveboards and
-	 * other screens navigable from a Liveboard.
-	 *
-	 * Supported embed types: `LiveboardEmbed`
-	 * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
-	 * @deprecated Use `minimumHeight` instead.
-	 * @default 500
-	 * @example
-	 * ```js
-	 * const embed = new LiveboardEmbed('#embed', {
-	 *   ... // other liveboard view config
-	 *   fullHeight: true,
-	 *   defaultHeight: 600,
-	 * });
-	 * ```
-	 */
-	defaultHeight?: number;
-	/**
-	 * This is the minimum height (in pixels) for a full-height Liveboard.
-	 * Setting this height helps resolve issues with empty Liveboards and
-	 * other screens navigable from a Liveboard.
-	 *
-	 * @version SDK: 1.44.2 | ThoughtSpot: 10.15.0.cl
-	 * @default 500
-	 * @example
-	 * ```js
-	 * const embed = new LiveboardEmbed('#embed', {
-	 *   ... // other liveboard view config
-	 *   fullHeight: true,
-	 *   minimumHeight: 600,
-	 * });
-	 * ```
-	 */
-	minimumHeight?: number;
+export interface LiveboardViewConfig extends BaseViewConfig, FullHeightViewConfig, SearchLiveboardCommonViewConfig, LiveboardAppEmbedViewConfig {
 	/**
 	 * If set to true, the context menu in visualizations will be enabled.
 	 * @version SDK: 1.1.0 | ThoughtSpot: 8.1.0.sw
@@ -14694,77 +15446,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 * ```
 	 */
 	isGranularXLSXCSVSchedulesEnabled?: boolean;
-	/**
-	 * Loads visualizations only as they scroll into the viewport, instead of
-	 * loading the whole full-height Liveboard at once.
-	 *
-	 * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
-	 * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
-	 * set explicitly. Set it to `false` to load every visualization upfront.
-	 * The flag has no effect unless `fullHeight` is enabled.
-	 *
-	 * @type {boolean}
-	 * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
-	 * @default true when `fullHeight` is enabled, from SDK 1.52.0
-	 * @example
-	 * ```js
-	 * const embed = new LiveboardEmbed('#embed-container', {
-	 *    // ...other options
-	 *    fullHeight: true,
-	 *    lazyLoadingForFullHeight: true,
-	 * })
-	 * ```
-	 */
-	lazyLoadingForFullHeight?: boolean;
-	/**
-	 * Computes the visible region of the embed against its scrollable and
-	 * clipping ancestors, instead of treating the browser window as the only
-	 * viewport, and tracks scroll and resize on those ancestors.
-	 *
-	 * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
-	 * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
-	 * set explicitly. Set it to `false` when the page scrolls with the window
-	 * and the embed has no clipping ancestor, to skip the extra ancestor
-	 * tracking.
-	 *
-	 * @type {boolean}
-	 * @default true when `fullHeight` is enabled, from SDK 1.52.0
-	 */
-	enableScrollableContainerLazyLoading?: boolean;
-	/**
-	 * How far outside the viewport a visualization starts loading, when
-	 * {@link lazyLoadingForFullHeight} is enabled.
-	 *
-	 * For example, if the margin is set to '10px',
-	 * the visualization will be loaded 10px before its top edge is visible in the
-	 * viewport.
-	 *
-	 * The format is similar to CSS margin, so `'500px 0px'` extends the
-	 * prefetch 500px above and below the viewport and not sideways. Accepted
-	 * units are `px`, `em`, `rem`, `%`, `vh` and `vw`, plus bare `0` and
-	 * `auto`; an invalid value is logged and ignored.
-	 *
-	 * From SDK 1.52.0 this defaults to `'500px 0px'` — roughly one
-	 * visualization ahead of the scroll position, so a chart has usually
-	 * finished loading by the time it scrolls into view. Use a smaller margin
-	 * to cut warehouse queries further, or `'0px'` to load a visualization
-	 * only once it is actually visible.
-	 *
-	 * @type {string}
-	 * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
-	 * @default '500px 0px' when `fullHeight` is enabled, from SDK 1.52.0
-	 * @example
-	 * ```js
-	 * const embed = new LiveboardEmbed('#embed-container', {
-	 *    // ...other options
-	 *    fullHeight: true,
-	 *    lazyLoadingForFullHeight: true,
-	 *   // Using 0px, the visualization will be only loaded when it's visible in the viewport.
-	 *    lazyLoadingMargin: '0px',
-	 * })
-	 * ```
-	 */
-	lazyLoadingMargin?: string;
 	/**
 	 * showSpotterLimitations : show limitation text
 	 * of the spotter underneath the chat input.
@@ -14918,9 +15599,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
  */
 export class LiveboardEmbed extends V1Embed {
 	protected viewConfig: LiveboardViewConfig;
-	private defaultHeight;
-	private lazyLoadScrollContainers;
-	private lazyLoadResizeObserver;
+	private readonly fullHeightController?;
 	constructor(domSelector: DOMSelector, viewConfig: LiveboardViewConfig);
 	protected getAppInitData(): Promise<LiveboardEmbedAppInitData>;
 	/**
@@ -14930,27 +15609,11 @@ export class LiveboardEmbed extends V1Embed {
 	protected getEmbedParams(): string;
 	protected getEmbedParamsObject(): any;
 	private getIframeSuffixSrc;
-	private sendFullHeightLazyLoadData;
-	/**
-	 * This is a handler for the RequestVisibleEmbedCoordinates event.
-	 * It is used to send the visible coordinates data to the host application.
-	 * @param data The event payload
-	 * @param responder The responder function
-	 */
-	private requestVisibleEmbedCoordinatesHandler;
 	/**
 	 * Construct the URL of the embedded ThoughtSpot Liveboard or visualization
 	 * to be loaded within the iFrame.
 	 */
 	private getIFrameSrc;
-	/**
-	 * Set the iframe height as per the computed height received
-	 * from the ThoughtSpot app.
-	 * @param data The event payload
-	 */
-	private updateIFrameHeight;
-	private embedIframeCenter;
-	private setIframeHeightForNonEmbedLiveboard;
 	private setActiveTab;
 	private showPreviewLoader;
 	/**
@@ -14965,22 +15628,23 @@ export class LiveboardEmbed extends V1Embed {
 		personalizedViewId: string;
 	};
 	protected beforePrerenderVisible(): void;
+	private isShowingLiveboardRoute;
 	protected handleRenderForPrerender(): Promise<TsEmbed>;
 	/**
 	 * Triggers an event to the embedded app
+	 * Payload typing follows {@link TsEmbed.trigger}: unknown fields fail to compile
+	 * from SDK 1.52.0; strict contract checks land in SDK 1.54.0.
 	 * @param {HostEvent} messageType The event type
-	 * @param {any} data The payload to send with the message
+	 * @param {TriggerData} data The payload, typed against the event's contract
 	 * @returns A promise that resolves with the response from the embedded app
 	 */
-	trigger<HostEventT extends HostEvent, PayloadT = HostEventRequest<HostEventT>, ContextT extends ContextType = ContextType>(messageType: HostEventT, data?: TriggerPayload<PayloadT, HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextT>>;
+	trigger<HostEventT extends HostEvent, PayloadT = HostEventRequest<HostEventT>, ContextT extends ContextType = ContextType>(messageType: HostEventT, data?: TriggerData<HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextT>>;
 	/**
 	 * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
 	 * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
 	 */
 	destroy(): void;
 	private postRender;
-	private registerLazyLoadEvents;
-	private unregisterLazyLoadEvents;
 	/**
 	 * Render an embedded ThoughtSpot Liveboard or visualization
 	 * @param renderOptions An object specifying the Liveboard ID,
@@ -15151,6 +15815,20 @@ export interface SearchViewConfig extends SearchLiveboardCommonViewConfig, Omit<
 	 * ```
 	 */
 	dataSource?: string;
+	/**
+	 * If set to `true`, the answer edit panel is hidden.
+	 *
+	 * Supported embed types: `SearchEmbed`
+	 * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new SearchEmbed('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    hideAnswerEditPanel: true,
+	 * })
+	 * ```
+	 */
+	hideAnswerEditPanel?: boolean;
 	/**
 	 * The initial search query to load the answer with.
 	 * Use {@link searchOptions} instead.