@thoughtspot/visual-embed-sdk 1.52.0 → 1.52.1

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

@@ -1250,6 +1250,280 @@ declare 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 declare 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 declare 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
@@ -3647,6 +3921,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.
@@ -4098,6 +4381,9 @@ export declare 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
@@ -4114,6 +4400,9 @@ export declare 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
@@ -4130,6 +4419,9 @@ export declare 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
@@ -4146,6 +4438,9 @@ export declare 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
@@ -4424,6 +4719,9 @@ export declare 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
@@ -5502,6 +5800,7 @@ export declare 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.
@@ -5529,6 +5828,9 @@ export declare 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`
@@ -5608,6 +5910,8 @@ export declare 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);
@@ -5626,6 +5930,7 @@ export declare 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
@@ -5648,6 +5953,7 @@ export declare 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
@@ -5675,6 +5981,7 @@ export declare 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
@@ -5716,6 +6023,7 @@ export declare 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`
@@ -5743,6 +6051,9 @@ export declare 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,
@@ -5825,6 +6136,7 @@ export declare 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>' }`.
@@ -5856,6 +6168,7 @@ export declare enum HostEvent {
 	OpenParameter = "openParameter",
 	/**
 	 * Add columns to the current search query.
+	 * Payload: `{ columnIds: string[] }`.
 	 * @param - { columnIds: string[] }
 	 * @example
 	 * ```js
@@ -5874,6 +6187,7 @@ export declare enum HostEvent {
 	AddColumns = "addColumns",
 	/**
 	 * Remove a column from the current search query.
+	 * Payload: `{ columnId: string }`.
 	 * @param - { columnId: string }
 	 * @example
 	 * ```js
@@ -5898,6 +6212,8 @@ export declare 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(
@@ -5919,6 +6235,8 @@ export declare 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.
@@ -6033,6 +6351,7 @@ export declare enum HostEvent {
 	LiveboardInfo = "pinboardInfo",
 	/**
 	 * Trigger the **Schedule** action on an embedded Liveboard.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 *  liveboardEmbed.trigger(HostEvent.Schedule)
@@ -6048,6 +6367,7 @@ export declare enum HostEvent {
 	Schedule = "subscription",
 	/**
 	 * Trigger the **Manage schedule** action on an embedded Liveboard
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 *  liveboardEmbed.trigger(HostEvent.SchedulesList)
@@ -6064,6 +6384,7 @@ export declare enum HostEvent {
 	/**
 	 * Trigger the **Export TML** action on an embedded Liveboard or
 	 * Answer.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.ExportTML)
@@ -6086,6 +6407,7 @@ export declare 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)
@@ -6107,6 +6429,7 @@ export declare enum HostEvent {
 	EditTML = "editTSL",
 	/**
 	 * Trigger the **Update TML** action on an embedded Liveboard.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.UpdateTML)
@@ -6124,6 +6447,7 @@ export declare 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
@@ -6174,6 +6498,7 @@ export declare enum HostEvent {
 	/**
 	 * Trigger the **AI Highlights** action on an embedded Liveboard
 	 *
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.AIHighlights)
@@ -6228,6 +6553,9 @@ export declare 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)
@@ -6242,6 +6570,7 @@ export declare enum HostEvent {
 	Remove = "delete",
 	/**
 	 * Trigger the **Explore** action on a visualization.
+	 * Payload: {@link RequiredVizRequest}.
 	 * @param - an object with `vizId` as a key
 	 * @example
 	 * ```js
@@ -6261,6 +6590,7 @@ export declare 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
@@ -6292,6 +6622,7 @@ export declare 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
@@ -6329,6 +6660,7 @@ export declare 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
@@ -6371,6 +6703,7 @@ export declare 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
@@ -6416,6 +6749,7 @@ export declare 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
@@ -6461,6 +6795,8 @@ export declare 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) => {
@@ -6510,6 +6846,7 @@ export declare 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
@@ -6543,6 +6880,7 @@ export declare 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
@@ -6571,6 +6909,7 @@ export declare 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.
@@ -6633,6 +6972,7 @@ export declare enum HostEvent {
 	/**
 	 * Trigger the **Download** > **PNG** action on
 	 * charts in the embedded view.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.DownloadAsPng,
@@ -6663,6 +7003,7 @@ export declare 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
@@ -6702,6 +7043,7 @@ export declare 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
@@ -6741,6 +7083,7 @@ export declare enum HostEvent {
 	/**
 	 * Trigger the **Share** action on an embedded
 	 * Liveboard or Answer.
+	 * Payload: {@link VizScopedRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.Share)
@@ -6767,6 +7110,7 @@ export declare 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.
 	 *
@@ -6818,6 +7162,7 @@ export declare 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
@@ -6848,6 +7193,7 @@ export declare 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
@@ -6878,6 +7224,7 @@ export declare 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
@@ -6906,6 +7253,7 @@ export declare enum HostEvent {
 	ManagePipelines = "manage-pipeline",
 	/**
 	 * Reset search operation on the Search or Answer page.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * searchEmbed.trigger(HostEvent.ResetSearch)
@@ -6933,6 +7281,8 @@ export declare 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);
@@ -6952,6 +7302,7 @@ export declare 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.
@@ -7080,6 +7431,8 @@ export declare enum HostEvent {
 	UpdateFilters = "updateFilters",
 	/**
 	 * Get tab details for the current Liveboard.
+	 * Payload: none.
+	 * Response: {@link GetTabsResponse}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.GetTabs).then((tabDetails) => {
@@ -7105,6 +7458,8 @@ export declare 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) => {
@@ -7129,6 +7484,7 @@ export declare 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
@@ -7151,6 +7507,7 @@ export declare 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
@@ -7179,6 +7536,8 @@ export declare 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
@@ -7206,6 +7565,7 @@ export declare enum HostEvent {
 	GetAnswerSession = "getAnswerSession",
 	/**
 	 * Trigger the *Ask Sage* action for visualizations
+	 * Payload: {@link RequiredVizRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.AskSage,
@@ -7217,6 +7577,7 @@ export declare enum HostEvent {
 	/**
 	 * Trigger cross filter update action on a Liveboard.
 	 *
+	 * Payload: {@link UpdateCrossFilterRequest}.
 	 * @example
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.UpdateCrossFilter, {
@@ -7232,7 +7593,9 @@ export declare 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);
@@ -7253,6 +7616,7 @@ export declare 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.
@@ -7310,6 +7674,8 @@ export declare 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) => {
@@ -7347,6 +7713,7 @@ export declare enum HostEvent {
 	 * ```js
 	 * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
 	 * ```
+	 * Payload: {@link PersonalisedViewRequest} (`viewId` only).
 	 * @example
 	 * ```js
 	 * // Update personalized view from liveboard context
@@ -7379,6 +7746,7 @@ export declare 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(
@@ -7422,6 +7790,8 @@ export declare 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.
@@ -7507,6 +7877,7 @@ export declare 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.
@@ -7531,6 +7902,7 @@ export declare enum HostEvent {
 	SpotterSearch = "SpotterSearch",
 	/**
 	 * Edits the last prompt in spotter embed.
+	 * Payload: `string`.
 	 * @param - `query`: Text string
 	 * @example
 	 * ```js
@@ -7547,6 +7919,7 @@ export declare enum HostEvent {
 	EditLastPrompt = "EditLastPrompt",
 	/**
 	 * Opens the data source preview modal in Spotter Embed.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
@@ -7582,6 +7955,7 @@ export declare enum HostEvent {
 	DataModelInstructions = "DataModelInstructions",
 	/**
 	 * Resets the Spotter Embed Conversation.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.ResetSpotterConversation);
@@ -7594,6 +7968,7 @@ export declare 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' });
@@ -7603,6 +7978,7 @@ export declare enum HostEvent {
 	ShareSpotterConversation = "ShareSpotterConversation",
 	/**
 	 * Closes the Spotter share-conversation modal. No-op if none is open.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.CloseSpotterShareConversation);
@@ -7612,6 +7988,7 @@ export declare enum HostEvent {
 	CloseSpotterShareConversation = "CloseSpotterShareConversation",
 	/**
 	 * Exits the read-only shared-conversation view.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.ExitSpotterSharedConversation);
@@ -7621,6 +7998,7 @@ export declare enum HostEvent {
 	ExitSpotterSharedConversation = "ExitSpotterSharedConversation",
 	/**
 	 * Deletes the last prompt in spotter embed.
+	 * Payload: none.
 	 * @example
 	 * ```js
 	 * spotterEmbed.trigger(HostEvent.DeleteLastPrompt);
@@ -7630,6 +8008,7 @@ export declare 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
@@ -7668,6 +8047,7 @@ export declare 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
@@ -7729,6 +8109,7 @@ export declare 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
@@ -7746,6 +8127,7 @@ export declare 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
@@ -7770,6 +8152,7 @@ export declare 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, {
@@ -7788,6 +8171,7 @@ export declare 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
@@ -7800,6 +8184,7 @@ export declare enum HostEvent {
 	SpotterVizSendUserMessage = "SpotterVizSendUserMessage",
 	/**
 	 * Initializes a new SpotterViz conversation.
+	 * Payload: none.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @example
 	 * ```js
@@ -7809,6 +8194,7 @@ export declare enum HostEvent {
 	InitSpotterVizConversation = "InitSpotterVizConversation",
 	/**
 	 * Opens the SpotterViz panel.
+	 * Payload: none.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @example
 	 * ```js
@@ -7818,6 +8204,7 @@ export declare enum HostEvent {
 	OpenSpotterVizPanel = "OpenSpotterVizPanel",
 	/**
 	 * Closes the SpotterViz panel.
+	 * Payload: none.
 	 * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
 	 * @example
 	 * ```js
@@ -7828,6 +8215,7 @@ export declare 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);
@@ -9860,92 +10248,376 @@ export declare enum Action {
 	 * disabledActions: [Action.SpotterOnLiveboard]
 	 * ```
 	 */
-	SpotterOnLiveboard = "spotterOnLiveboard"
-}
-export declare enum PrefetchFeatures {
-	FullApp = "FullApp",
-	SearchEmbed = "SearchEmbed",
-	LiveboardEmbed = "LiveboardEmbed",
-	VizEmbed = "VizEmbed"
-}
-declare 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[];
-}
-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 declare 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],
+	 * }
+	 * ```
 	 */
-	PRIMARY = "PRIMARY",
+	ChartTypeSettings = "CHART_TYPE",
 	/**
-	 * Shows the action inside the "More" menu
-	 * (three-dot overflow menu).
+	 * 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],
+	 * }
+	 * ```
 	 */
-	MENU = "MENU",
+	LayoutSettings = "LAYOUT",
 	/**
-	 * Shows the action in the right-click
-	 * context menu. Only supported for
-	 * {@link CustomActionTarget.VIZ},
-	 * {@link CustomActionTarget.ANSWER}, and
-	 * {@link CustomActionTarget.SPOTTER} targets.
+	 * 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],
+	 * }
+	 * ```
 	 */
-	CONTEXTMENU = "CONTEXTMENU"
-}
-/**
- * Enum options to mention the target of the code-based custom action.
- * The target determines which type of ThoughtSpot object the action is
- * associated with, and also controls which positions and scoping options
- * are available.
- */
-export declare enum CustomActionTarget {
+	ColumnSettings = "COLUMN",
 	/**
-	 * Action applies at the Liveboard level.
-	 * Supported positions:
-	 * {@link CustomActionsPosition.PRIMARY},
-	 * {@link CustomActionsPosition.MENU}.
-	 * Can be scoped with
-	 * `metadataIds.liveboardIds`,
+	 * 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 declare enum PrefetchFeatures {
+	FullApp = "FullApp",
+	SearchEmbed = "SearchEmbed",
+	LiveboardEmbed = "LiveboardEmbed",
+	VizEmbed = "VizEmbed"
+}
+declare 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 declare enum CustomActionsPosition {
+	/**
+	 * Shows the action as a primary button
+	 * in the toolbar area of the embed.
+	 */
+	PRIMARY = "PRIMARY",
+	/**
+	 * Shows the action inside the "More" menu
+	 * (three-dot overflow menu).
+	 */
+	MENU = "MENU",
+	/**
+	 * Shows the action in the right-click
+	 * context menu. Only supported for
+	 * {@link CustomActionTarget.VIZ},
+	 * {@link CustomActionTarget.ANSWER}, and
+	 * {@link CustomActionTarget.SPOTTER} targets.
+	 */
+	CONTEXTMENU = "CONTEXTMENU"
+}
+/**
+ * Enum options to mention the target of the code-based custom action.
+ * The target determines which type of ThoughtSpot object the action is
+ * associated with, and also controls which positions and scoping options
+ * are available.
+ */
+export declare enum CustomActionTarget {
+	/**
+	 * Action applies at the Liveboard level.
+	 * Supported positions:
+	 * {@link CustomActionsPosition.PRIMARY},
+	 * {@link CustomActionsPosition.MENU}.
+	 * Can be scoped with
+	 * `metadataIds.liveboardIds`,
 	 * `orgIds`, and `groupIds`.
 	 */
 	LIVEBOARD = "LIVEBOARD",
@@ -10757,6 +11429,166 @@ export interface VisualizationOverrides {
 	/** 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;
+}
 /**
  * Enum for auth failure types.
  * This value is passed to the listener for {@link AuthStatus.FAILURE}.
@@ -10868,284 +11700,421 @@ export declare enum AuthStatus {
 	SAML_POPUP_CLOSED_NO_AUTH = "SAML_POPUP_CLOSED_NO_AUTH"
 }
 /**
- * Event emitter returned from {@link init}.
- * @group Authentication / Init
+ * Event emitter returned from {@link init}.
+ * @group Authentication / Init
+ */
+export interface AuthEventEmitter {
+	/**
+	 * Register a listener on Auth failure.
+	 * @param event
+	 * @param listener
+	 */
+	on(event: AuthStatus.FAILURE, listener: (failureType: AuthFailureType) => void): this;
+	/**
+	 * Register a listener on Auth SDK success.
+	 * @param event
+	 * @param listener
+	 */
+	on(event: AuthStatus.SDK_SUCCESS | AuthStatus.LOGOUT | AuthStatus.WAITING_FOR_POPUP | AuthStatus.SAML_POPUP_CLOSED_NO_AUTH, listener: () => void): this;
+	on(event: AuthStatus.SUCCESS, listener: (sessionInfo: any) => void): this;
+	once(event: AuthStatus.FAILURE, listener: (failureType: AuthFailureType) => void): this;
+	once(event: AuthStatus.SDK_SUCCESS | AuthStatus.LOGOUT | AuthStatus.WAITING_FOR_POPUP | AuthStatus.SAML_POPUP_CLOSED_NO_AUTH, listener: () => void): this;
+	once(event: AuthStatus.SUCCESS, listener: (sessionInfo: any) => void): this;
+	/**
+	 * Trigger an event on the emitter returned from init.
+	 * @param {@link AuthEvent}
+	 */
+	emit(event: AuthEvent, ...args: any[]): boolean;
+	/**
+	 * Remove listener from the emitter returned from init.
+	 * @param event
+	 * @param listener
+	 * @param context
+	 * @param once
+	 */
+	off(event: AuthStatus, listener: (...args: any[]) => void, context: any, once: boolean): this;
+	/**
+	 * Remove all the event listeners
+	 * @param event
+	 */
+	removeAllListeners(event: AuthStatus): this;
+}
+/**
+ * Events which can be triggered on the emitter returned from {@link init}.
+ * @group Authentication / Init
+ */
+export declare enum AuthEvent {
+	/**
+	 * Manually trigger the SSO popup. This is useful when
+	 * authStatus is SAMLRedirect/OIDCRedirect and inPopup is set to true
+	 */
+	TRIGGER_SSO_POPUP = "TRIGGER_SSO_POPUP"
+}
+/**
+ * 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 OpenParameterRequest {
+	parameter: {
+		parameterId?: string;
+		parameterName?: string;
+	};
+	applicability?: Applicability;
+}
+/**
+ * Request payload for {@link HostEvent.Search}.
+ */
+export interface SearchRequest {
+	searchQuery: string;
+	dataSources: string[];
+	execute?: boolean;
+}
+/**
+ * Request payload for {@link HostEvent.SpotterSearch}.
  */
-export interface AuthEventEmitter {
-	/**
-	 * Register a listener on Auth failure.
-	 * @param event
-	 * @param listener
-	 */
-	on(event: AuthStatus.FAILURE, listener: (failureType: AuthFailureType) => void): this;
+export interface SpotterSearchRequest {
+	query: string;
+	executeSearch: boolean;
+}
+/**
+ * A single cross-filter condition for {@link HostEvent.UpdateCrossFilter}.
+ */
+export interface CrossFilterCondition {
+	columnName?: string;
+	operator?: string;
+	values: Array<string | number | boolean>;
+}
+/**
+ * Request payload for {@link HostEvent.UpdateCrossFilter}.
+ */
+export interface UpdateCrossFilterRequest {
+	vizId: string;
+	conditions: CrossFilterCondition[];
+}
+/**
+ * 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;
+}
+/**
+ * Request payload for {@link HostEvent.UpdateFilters} (singular or plural
+ * form).
+ */
+export interface UpdateFiltersRequest {
+	filter?: HostFilterUpdate;
+	filters?: HostFilterUpdate[];
 	/**
-	 * Register a listener on Auth SDK success.
-	 * @param event
-	 * @param listener
+	 * Scope the update to a specific visualization on a Liveboard.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
 	 */
-	on(event: AuthStatus.SDK_SUCCESS | AuthStatus.LOGOUT | AuthStatus.WAITING_FOR_POPUP | AuthStatus.SAML_POPUP_CLOSED_NO_AUTH, listener: () => void): this;
-	on(event: AuthStatus.SUCCESS, listener: (sessionInfo: any) => void): this;
-	once(event: AuthStatus.FAILURE, listener: (failureType: AuthFailureType) => void): this;
-	once(event: AuthStatus.SDK_SUCCESS | AuthStatus.LOGOUT | AuthStatus.WAITING_FOR_POPUP | AuthStatus.SAML_POPUP_CLOSED_NO_AUTH, listener: () => void): this;
-	once(event: AuthStatus.SUCCESS, listener: (sessionInfo: any) => void): this;
+	visualizationId?: string;
 	/**
-	 * Trigger an event on the emitter returned from init.
-	 * @param {@link AuthEvent}
+	 * Scope the update to a specific Liveboard.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
 	 */
-	emit(event: AuthEvent, ...args: any[]): boolean;
+	liveboardId?: string;
+}
+/**
+ * Request payload for personalised-view host events.
+ */
+export interface PersonalisedViewRequest {
+	viewId?: string;
+	viewName?: string;
+}
+/**
+ * Request payload for schedule-email related host events.
+ */
+export interface ScheduleEmailRequest {
+	sendToSelf?: boolean;
+}
+/**
+ * Object form of the {@link HostEvent.Navigate} payload.
+ */
+export interface NavigateRequest {
 	/**
-	 * Remove listener from the emitter returned from init.
-	 * @param event
-	 * @param listener
-	 * @param context
-	 * @param once
+	 * Route to navigate to, or a history delta such as `1` or `-1`.
 	 */
-	off(event: AuthStatus, listener: (...args: any[]) => void, context: any, once: boolean): this;
+	path: string | number;
 	/**
-	 * Remove all the event listeners
-	 * @param event
+	 * When `true`, replaces the current history entry instead of pushing.
 	 */
-	removeAllListeners(event: AuthStatus): this;
+	replace?: boolean;
 }
 /**
- * Events which can be triggered on the emitter returned from {@link init}.
- * @group Authentication / Init
+ * Request payload for {@link HostEvent.SetActiveTab}.
  */
-export declare enum AuthEvent {
+export interface SetActiveTabRequest {
 	/**
-	 * Manually trigger the SSO popup. This is useful when
-	 * authStatus is SAMLRedirect/OIDCRedirect and inPopup is set to true
+	 * Id of the liveboard tab to make active.
 	 */
-	TRIGGER_SSO_POPUP = "TRIGGER_SSO_POPUP"
-}
-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 declare enum ApplicabilityLevel {
-	Liveboard = "LIVEBOARD",
-	Tab = "TAB",
-	Group = "GROUP"
+	tabId: string;
 }
 /**
- * Scopes a filter or parameter to a specific target.
- * At `LIVEBOARD` level the filter applies to the whole Liveboard, so `targetId`
- * is not required.
+ * 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 Applicability {
-	level: 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 declare 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"
-}
-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[];
-		};
+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;
 declare class HostEventClient {
 	iFrame: HTMLIFrameElement;
 	/** Cached list of available UI passthrough keys from the embedded app */
@@ -11195,7 +12164,7 @@ declare 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>>;
 }
 declare class TsEmbed {
 	/**
@@ -11213,6 +12182,7 @@ declare 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
@@ -11382,10 +12352,10 @@ declare 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>;
@@ -11578,21 +12548,6 @@ declare 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.
@@ -11616,7 +12571,7 @@ declare 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
@@ -11652,6 +12607,8 @@ declare class TsEmbed {
 	 */
 	private embedContainerReadyCallbacks;
 	protected getPreRenderObj<T extends TsEmbed>(): T;
+	protected takeOverPreRender(): void;
+	private markEmbedContainerLoaded;
 	private checkEmbedContainerLoaded;
 	private executeEmbedContainerReadyCallbacks;
 	/**
@@ -11662,8 +12619,12 @@ declare 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.
@@ -11680,7 +12641,7 @@ declare 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.
@@ -11782,6 +12743,7 @@ declare class TsEmbed {
 	 * @returns
 	 */
 	prerenderGeneric(): Promise<any>;
+	protected preRenderParamsApplied: Promise<void>;
 	protected beforePrerenderVisible(): void;
 	/**
 	 * Displays the pre-rendered component inside the host element.
@@ -11860,7 +12822,7 @@ declare 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
@@ -12021,7 +12983,21 @@ export interface SearchViewConfig extends SearchLiveboardCommonViewConfig, Omit<
 	 * })
 	 * ```
 	 */
-	dataSource?: string;
+	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.
@@ -13398,7 +14374,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.
@@ -13683,34 +14659,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	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.
-	 *
-	 * Supported embed types: `AppEmbed`
-	 * @version SDK: 1.21.0 | ThoughtSpot: 9.4.0.cl, 9.4.0-sw
-	 * @example
-	 * ```js
-	 * const embed = new AppEmbed('#tsEmbed', {
-	 *    ... // other embed view config
-	 *    fullHeight: true,
-	 * })
-	 * ```
-	 */
-	fullHeight?: boolean;
 	/**
 	 * Enables the V2 navigation and modular home page experience.
 	 * For more information,
@@ -13905,78 +14853,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.
 	 *
@@ -14164,23 +15040,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
@@ -14230,6 +15089,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.
@@ -14245,9 +15118,7 @@ export interface AppEmbedAppInitData extends DefaultAppInitData {
 }
 declare 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`
@@ -14268,27 +15139,11 @@ declare 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.
@@ -14319,8 +15174,6 @@ declare 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
@@ -14342,71 +15195,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
@@ -14750,77 +15539,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.
@@ -14959,9 +15677,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 }
 declare 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>;
 	/**
@@ -14971,27 +15687,11 @@ declare 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;
 	/**
@@ -15006,22 +15706,23 @@ declare 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,