@thoughtspot/visual-embed-sdk 1.50.1 → 1.51.0

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

@@ -40,6 +40,42 @@ export interface CustomCssVariables {
 	 * Font color of the top navigation panel.
 	 */
 	"--ts-var-nav-color"?: string;
+	/**
+	 * Background color of the left navigation panel.
+	 */
+	"--ts-var-left-nav-background"?: string;
+	/**
+	 * Background color of the active tab in the left navigation panel.
+	 */
+	"--ts-var-left-nav-active-tab-background"?: string;
+	/**
+	 * Border color of the active tab in the left navigation panel.
+	 */
+	"--ts-var-left-nav-active-tab-border-color"?: string;
+	/**
+	 * Font color of the section title in the left navigation panel.
+	 */
+	"--ts-var-left-nav-section-title-color"?: string;
+	/**
+	 * Font color of the items in the left navigation panel.
+	 */
+	"--ts-var-left-nav-item-color"?: string;
+	/**
+	 * Font color of the selected item in the left navigation panel.
+	 */
+	"--ts-var-left-nav-item-selection-color"?: string;
+	/**
+	 * Background color of the selected item in the left navigation panel.
+	 */
+	"--ts-var-left-nav-item-selection-background"?: string;
+	/**
+	 * Color of the active tab icon in the left navigation panel.
+	 */
+	"--ts-var-left-nav-tab-icon-active-color"?: string;
+	/**
+	 * Color of the inactive tab icon in the left navigation panel.
+	 */
+	"--ts-var-left-nav-tab-icon-inactive-color"?: string;
 	/**
 	 * Background color of the *Search data* button.
 	 */
@@ -1399,7 +1435,9 @@ export enum AuthType {
 }
 /**
  *
- * **Note**:  This attribute is not supported in the classic (V1) homepage experience.
+ * **Note**: The classic (V1) and Modular (V2) home page experiences are
+ * deprecated. This attribute applies to V3 (ModularWithStylingChanges) and
+ * V4 (Focused) home page experiences.
  *
  */
 export enum HomeLeftNavItem {
@@ -2797,7 +2835,9 @@ export interface HomePageConfig {
 	 * To specify the modules, import the `HomepageModule` enum.
 	 * For example: `hiddenHomepageModules = [HomepageModule.MyLibrary]`
 	 *
-	 * **Note**: This attribute is not supported in the classic (v1) experience.
+	 * **Note**: The classic (V1) and Modular (V2) home page experiences are
+	 * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
+	 * and V4 (Focused) home page experiences.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
@@ -2806,7 +2846,7 @@ export interface HomePageConfig {
 	 * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
 	 *
 	 * const embed = new AppEmbed('#tsEmbed', {
-	 *    ... // V2/V3 navigation and home page experience attributes
+	 *    ... // V3 navigation and home page experience attributes
 	 *    hiddenHomepageModules : [HomepageModule.Favorite,HomepageModule.Learning],
 	 *    //...other embed view configuration attributes
 	 * })
@@ -2817,8 +2857,11 @@ export interface HomePageConfig {
 	 * Reorder home page modules.
 	 * To specify the modules, import the `HomepageModule` enum.
 	 * For example: `reorderedHomepageModules = [HomepageModule.MyLibrary,
-	 * HomepageModule.Watchlist]` **Note**: This attribute is not supported in the
-	 * classic (v1) homepage.
+	 * HomepageModule.Watchlist]`
+	 *
+	 * **Note**: The classic (V1) and Modular (V2) home page experiences are
+	 * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
+	 * and V4 (Focused) home page experiences.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
@@ -2827,7 +2870,7 @@ export interface HomePageConfig {
 	 * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
 	 *
 	 * const embed = new AppEmbed('#tsEmbed', {
-	 *    ...//V2/V3 navigation and home page experience attributes
+	 *    ...//V3 navigation and home page experience attributes
 	 *    reorderedHomepageModules:[HomepageModule.Favorite,HomepageModule.MyLibrary],
 	 *    //... other embed view configuration attributes
 	 * })
@@ -2839,7 +2882,9 @@ export interface HomePageConfig {
 	 * on the home page left navigation panel.
 	 * To specify the menu items, import the `HomeLeftNavItem` enum.
 	 *
-	 * **Note**: This attribute is not supported in the classic (v1) homepage.
+	 * **Note**: The classic (V1) and Modular (V2) home page experiences are
+	 * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
+	 * and V4 (Focused) home page experiences.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
@@ -3215,6 +3260,24 @@ export interface LiveboardAppEmbedViewConfig {
 	 * ```
 	 */
 	isCentralizedLiveboardFilterUXEnabled?: boolean;
+	/**
+	 * This flag is used to enable or disable scoped Liveboard filtering.
+	 * When enabled, filters and parameters can be scoped to a group of
+	 * visualizations on a Liveboard, in addition to the Liveboard and
+	 * tab levels.
+	 *
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+	 * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    isScopedLiveboardFilteringEnabled: true,
+	 * })
+	 * ```
+	 */
+	isScopedLiveboardFilteringEnabled?: boolean;
 	/**
 	 * This flag is used to enable or disable the link parameters in liveboard.
 	 *
@@ -3398,7 +3461,9 @@ export enum RuntimeFilterOp {
  * via `hiddenHomepageModules` and reordered via
  * `reorderedHomepageModules`.
  *
- * **Note**: This option is not supported in the classic (v1) experience.
+ * **Note**: The classic (V1) and Modular (V2) home page experiences are
+ * deprecated. These modules apply to V3 (ModularWithStylingChanges) and
+ * V4 (Focused) home page experiences.
  * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
  */
 export enum HomepageModule {
@@ -4387,11 +4452,19 @@ export enum EmbedEvent {
 	 * Emitted when a user changes any filter on a Liveboard.
 	 * Returns filter type and name, column name and ID, and runtime
 	 * filter details.
+	 * The payload includes an optional `applicability` attribute indicating the
+	 * scope of the changed filter. It contains a `level` (`LIVEBOARD`,
+	 * `TAB`, or `GROUP`) and, when `level` is `TAB` or `GROUP`, a
+	 * `targetId` with the GUID of the target. At `LIVEBOARD` level there
+	 * is no `targetId`, since the filter applies to the whole Liveboard.
+	 * The `applicability` attribute is available from SDK: 1.53.0 |
+	 * ThoughtSpot: 26.10.0.cl.
 	 * @example
 	 *
 	 * ```js
 	 * LiveboardEmbed.on(EmbedEvent.FilterChanged, (payload) => {
 	 *    console.log('payload', payload);
+	 *    // payload.data optionally includes applicability: { level, targetId }
 	 * })
 	 * ```
 	 * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
@@ -4583,9 +4656,17 @@ export enum EmbedEvent {
 	/**
 	 * Emitted when parameter changes in an Answer
 	 * or Liveboard.
+	 * The payload includes an optional `applicability` attribute indicating the
+	 * scope of the changed parameter. It contains a `level` (`LIVEBOARD`,
+	 * `TAB`, or `GROUP`) and, when `level` is `TAB` or `GROUP`, a
+	 * `targetId` with the GUID of the target. At `LIVEBOARD` level there
+	 * is no `targetId`, since the parameter applies to the whole Liveboard.
+	 * The `applicability` attribute is available from SDK: 1.53.0 |
+	 * ThoughtSpot: 26.10.0.cl.
 	 * ```js
 	 * liveboardEmbed.on(EmbedEvent.ParameterChanged, (payload) => {
 	 *     console.log('payload', payload);
+	 *     // payload.data optionally includes applicability: { level, targetId }
 	 * })
 	 * ```
 	 * @version SDK: 1.29.0 | ThoughtSpot: 10.3.0.cl
@@ -4887,6 +4968,158 @@ export enum EmbedEvent {
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
 	 */
 	SpotterConversationDeleted = "spotterConversationDeleted",
+	/**
+	 * Emitted when the header Share button is clicked. Fires `Start` then `End`
+	 * to bracket the interaction. App→host counterpart of the
+	 * `ShareSpotterConversation` host event (user-driven vs programmatic open).
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterShareConversationButtonHeaderClicked, (payload) => {
+	 *     // payload: { convId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareConversationButtonHeaderClicked = "spotterShareConversationButtonHeaderClicked",
+	/**
+	 * Emitted when the sidebar Share item is clicked. Fires `Start` then `End`
+	 * to bracket the interaction.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterShareConversationMenuItemSidebarClicked, (payload) => {
+	 *     // payload: { convId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareConversationMenuItemSidebarClicked = "spotterShareConversationMenuItemSidebarClicked",
+	/**
+	 * Emitted when a Spotter conversation is shared (recipients added, or a new
+	 * share created). The host builds its own link from shareId/convId + its
+	 * configured CONVERSATION_URL — no link string is sent. Distinct from
+	 * `SpotterShareModalConfirmButtonClicked`, which fires at click time before
+	 * the save resolves.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterConversationShared, (payload) => {
+	 *     // payload: { convId: string, shareId: string,
+	 *     //            recipientsAdded: string[], recipientsRemoved: string[] }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterConversationShared = "spotterConversationShared",
+	/**
+	 * Emitted when access to a shared Spotter conversation is revoked
+	 * (recipients removed). `fullyRevoked` is true when the last sharee is removed
+	 * and the share is deleted entirely.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterConversationShareRevoked, (payload) => {
+	 *     // payload: { convId: string, shareId: string,
+	 *     //            recipientsRemoved: string[], fullyRevoked: boolean }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterConversationShareRevoked = "spotterConversationShareRevoked",
+	/**
+	 * Emitted when a recipient opens a shared Spotter conversation (read-only
+	 * view). No shareId available viewer-side.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterSharedConversationViewed, (payload) => {
+	 *     // payload: { convId: string, sourceConvId: string }
+	 *     // convId = resolved snapshot conv id; sourceConvId = the shared URL id
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterSharedConversationViewed = "spotterSharedConversationViewed",
+	/**
+	 * Emitted when the user toggles the share-modal "include new messages since
+	 * last shared version" checkbox.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterShareIncludeNewMessagesCheckboxToggled, (payload) => {
+	 *     // payload: { convId: string, includeNewMessages: boolean }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareIncludeNewMessagesCheckboxToggled = "spotterShareIncludeNewMessagesCheckboxToggled",
+	/**
+	 * Emitted when the user dismisses the stale-snapshot info banner via its
+	 * cross (distinct from the include-new-messages checkbox toggle).
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterShareStaleInfoBannerDismissed, (payload) => {
+	 *     // payload: { convId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareStaleInfoBannerDismissed = "spotterShareStaleInfoBannerDismissed",
+	/**
+	 * Emitted when the modal Share (confirm) button is clicked — fires at click
+	 * time, before the save resolves. Distinct from the `SpotterConversationShared`
+	 * / `SpotterConversationShareRevoked` result events.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterShareModalConfirmButtonClicked, (payload) => {
+	 *     // payload: { convId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareModalConfirmButtonClicked = "spotterShareModalConfirmButtonClicked",
+	/**
+	 * Emitted when the share modal is dismissed via the Cancel button.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterShareModalCancelButtonClicked, (payload) => {
+	 *     // payload: { convId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareModalCancelButtonClicked = "spotterShareModalCancelButtonClicked",
+	/**
+	 * Emitted when a recipient leaves the read-only shared view via the Exit
+	 * button.
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterSharedConversationExitButtonClicked, (payload) => {
+	 *     // payload: { convId: string }
+	 * })
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterSharedConversationExitButtonClicked = "spotterSharedConversationExitButtonClicked",
+	/**
+	 * Emitted when a Spotter conversation is pinned.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterConversationPinned, (payload) => {
+	 *     console.log('Conversation pinned', payload);
+	 *     // payload: { conversationId: string, pinnedAt: string (ISO 8601) }
+	 * })
+	 * ```
+	 */
+	SpotterConversationPinned = "spotterConversationPinned",
+	/**
+	 * Emitted when a Spotter conversation is unpinned.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * spotterEmbed.on(EmbedEvent.SpotterConversationUnpinned, (payload) => {
+	 *     console.log('Conversation unpinned', payload);
+	 *     // payload: { conversationId: string, unpinnedAt: string (ISO 8601) }
+	 * })
+	 * ```
+	 */
+	SpotterConversationUnpinned = "spotterConversationUnpinned",
 	/**
 	 * Emitted when a Spotter conversation is selected/clicked.
 	 * @example
@@ -5402,6 +5635,17 @@ export enum HostEvent {
 	 *  name: string,
 	 *  type: ATTRIBUTE/MEASURE,
 	 *  dataType: INT64/CHAR/DATE }
+	 *
+	 * `applicability` - Optional. Scopes the filter to a specific target,
+	 * for example, a single Liveboard tab, so the panel for the correct
+	 * scoped filter is opened. Available from SDK: 1.53.0 |
+	 * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+	 *
+	 *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
+	 *  - `targetId`: The GUID of the target, for example, the tab GUID.
+	 *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
+	 *    `level` is `LIVEBOARD`, since the filter applies to the whole
+	 *    Liveboard. Omitting `applicability` targets the `LIVEBOARD` level.
 	 * @example
 	 * ```js
 	 * searchEmbed.trigger(HostEvent.OpenFilter,
@@ -5414,6 +5658,14 @@ export enum HostEvent {
 	 * ```
 	 * @example
 	 * ```js
+	 * // Open a filter scoped to a specific Liveboard tab
+	 * liveboardEmbed.trigger(HostEvent.OpenFilter, {
+	 *     column: { columnId: '<column-GUID>' },
+	 *     applicability: { level: 'TAB', targetId: '<tab-GUID>' }
+	 * });
+	 * ```
+	 * @example
+	 * ```js
 	 * // Open filter from search context
 	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
 	 * searchEmbed.trigger(HostEvent.OpenFilter, {
@@ -5423,6 +5675,38 @@ export enum HostEvent {
 	 * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
 	 */
 	OpenFilter = "openFilter",
+	/**
+	 * Open the parameter panel for a particular parameter on a Liveboard.
+	 * Mirrors {@link HostEvent.OpenFilter} for parameters.
+	 * @param - Includes the following keys:
+	 * - `parameter`: An object identifying the parameter to open, for
+	 *   example, `{ parameterId: '<parameter-GUID>' }`.
+	 * - `applicability`: Optional. Scopes the parameter to a specific target,
+	 *   for example, a single Liveboard tab, so the panel for the correct
+	 *   scoped parameter is opened. Includes the following attributes:
+	 *
+	 *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
+	 *    - `targetId`: The GUID of the target, for example, the tab GUID.
+	 *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
+	 *      `level` is `LIVEBOARD`, since the parameter applies to the whole
+	 *      Liveboard. Omitting `applicability` targets the `LIVEBOARD` level.
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.OpenParameter, {
+	 *     parameter: { parameterId: '<parameter-GUID>' }
+	 * });
+	 * ```
+	 * @example
+	 * ```js
+	 * // Open a parameter scoped to a specific group
+	 * liveboardEmbed.trigger(HostEvent.OpenParameter, {
+	 *     parameter: { parameterId: '<parameter-GUID>' },
+	 *     applicability: { level: 'GROUP', targetId: '<group-GUID>' }
+	 * });
+	 * ```
+	 * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+	 */
+	OpenParameter = "openParameter",
 	/**
 	 * Add columns to the current search query.
 	 * @param - { columnIds: string[] }
@@ -6486,13 +6770,13 @@ export enum HostEvent {
 	/**
 	 * Get details of filters applied on the Liveboard.
 	 * Returns arrays containing Liveboard filter and runtime filter elements.
-	 * Each Liveboard filter may include an `applicability` attribute
+	 * Each Liveboard filter includes an optional `applicability` attribute
 	 * indicating the scope of the filter. It contains a `level`
 	 * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
 	 * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
 	 * level there is no `targetId`, since the filter applies to the
 	 * whole Liveboard.
-	 * The `applicability` attribute is available from SDK: 1.51.0 |
+	 * The `applicability` attribute is available from SDK: 1.53.0 |
 	 * ThoughtSpot: 26.10.0.cl.
 	 * @example
 	 * ```js
@@ -6535,7 +6819,7 @@ export enum HostEvent {
 	 * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
 	 *
 	 * `applicability` - Optional. Scopes the filter to a specific target,
-	 * for example, a single Liveboard tab. Available from SDK: 1.51.0 |
+	 * for example, a single Liveboard tab. Available from SDK: 1.53.0 |
 	 * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
 	 *
 	 *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
@@ -6658,6 +6942,28 @@ export enum HostEvent {
 	 * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
 	 */
 	GetTabs = "getTabs",
+	/**
+	 * Get group details for the current Liveboard.
+	 * Mirrors {@link HostEvent.GetTabs} for filter/parameter groups.
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.GetGroups).then((groupDetails) => {
+	 *   console.log(
+	 *      groupDetails // GroupDetails of current Liveboard
+	 *   );
+	 * })
+	 * ```
+	 * @example
+	 * ```js
+	 * // Get groups from liveboard context
+	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+	 * liveboardEmbed.trigger(HostEvent.GetGroups, {}, ContextType.Liveboard).then((groupDetails) => {
+	 *     console.log('groups', groupDetails);
+	 * });
+	 * ```
+	 * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+	 */
+	GetGroups = "getGroups",
 	/**
 	 * Set the visible tabs on a Liveboard.
 	 * @param - an array of ids of tabs to show, the IDs not passed
@@ -6786,7 +7092,7 @@ export enum HostEvent {
 	 * - `value`: The value to set for the parameter.
 	 * - `isVisibleToUser`: Optional. To control the visibility of the parameter chip.
 	 * - `applicability`: Optional. Scopes the parameter to a specific target,
-	 * for example, a single Liveboard tab. Available from SDK: 1.51.0 |
+	 * for example, a single Liveboard tab. Available from SDK: 1.53.0 |
 	 * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
 	 *
 	 *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
@@ -6830,13 +7136,13 @@ export enum HostEvent {
 	UpdateParameters = "UpdateParameters",
 	/**
 	 * Triggers GetParameters to fetch the runtime Parameters.
-	 * Each parameter may include an `applicability` attribute
+	 * Each parameter includes an optional `applicability` attribute
 	 * indicating the scope of the parameter. It contains a `level`
 	 * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
 	 * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
 	 * level there is no `targetId`, since the parameter applies to the
 	 * whole Liveboard.
-	 * The `applicability` attribute is available from SDK: 1.51.0 |
+	 * The `applicability` attribute is available from SDK: 1.53.0 |
 	 * ThoughtSpot: 26.10.0.cl.
 	 * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
 	 * ```js
@@ -7104,6 +7410,36 @@ export enum HostEvent {
 	 * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
 	 */
 	ResetSpotterConversation = "ResetSpotterConversation",
+	/**
+	 * Opens the Spotter share-conversation modal for the given conversation.
+	 * `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.
+	 * @example
+	 * ```js
+	 * spotterEmbed.trigger(HostEvent.ShareSpotterConversation, { conversationId: 'abc' });
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	ShareSpotterConversation = "ShareSpotterConversation",
+	/**
+	 * Closes the Spotter share-conversation modal. No-op if none is open.
+	 * @example
+	 * ```js
+	 * spotterEmbed.trigger(HostEvent.CloseSpotterShareConversation);
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	CloseSpotterShareConversation = "CloseSpotterShareConversation",
+	/**
+	 * Exits the read-only shared-conversation view.
+	 * @example
+	 * ```js
+	 * spotterEmbed.trigger(HostEvent.ExitSpotterSharedConversation);
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	ExitSpotterSharedConversation = "ExitSpotterSharedConversation",
 	/**
 	 * Deletes the last prompt in spotter embed.
 	 * @example
@@ -7199,6 +7535,41 @@ export enum HostEvent {
 	 * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
 	 */
 	StartNewSpotterConversation = "StartNewSpotterConversation",
+	/**
+	 * Pins a saved Spotter conversation so it floats to the top of the past
+	 * conversations sidebar. The `conversationId` of the conversation to pin is
+	 * required.
+	 *
+	 * This feature is available only when chat history is enabled on your ThoughtSpot
+	 * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
+	 * instance.
+	 *
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * spotterEmbed.trigger(HostEvent.PinSpotterConversation, {
+	 *     conversationId: '<conversation-id>',
+	 * });
+	 * ```
+	 */
+	PinSpotterConversation = "PinSpotterConversation",
+	/**
+	 * Unpins a previously pinned Spotter conversation. The `conversationId` of the
+	 * conversation to unpin is required.
+	 *
+	 * This feature is available only when chat history is enabled on your ThoughtSpot
+	 * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
+	 * instance.
+	 *
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * spotterEmbed.trigger(HostEvent.UnpinSpotterConversation, {
+	 *     conversationId: '<conversation-id>',
+	 * });
+	 * ```
+	 */
+	UnpinSpotterConversation = "UnpinSpotterConversation",
 	/**
 	 * @hidden
 	 * Get the current context of the embedded page.
@@ -8565,6 +8936,19 @@ export enum Action {
 	 *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
 	 */
 	ChangeFilterVisibilityInTab = "changeFilterVisibilityInTab",
+	/**
+	 * Action ID to show, hide, or disable all filter surfaces on a Liveboard,
+	 * including filter, parameter, and cross-filter chips at the liveboard,
+	 * tab, and group levels. Parameter and cross-filter chips are hide-only.
+	 *
+	 *  @example
+	 * ```js
+	 * hiddenActions: [Action.AllLiveboardFilters]
+	 * disabledActions: [Action.AllLiveboardFilters]
+	 * ```
+	 *  @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+	 */
+	AllLiveboardFilters = "allLiveboardFilters",
 	/**
 	 * The **Data model instructions** button on the Spotter interface.
 	 * Allows opening the data model instructions modal.
@@ -8900,6 +9284,89 @@ export enum Action {
 	 * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
 	 */
 	SpotterChatRename = "spotterChatRename",
+	/**
+	 * Controls visibility and disable state of the Spotter conversation Share
+	 * button in the chat header. Only takes effect once sharing is enabled
+	 * (enableShareConversation on).
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.SpotterShareConversationButtonHeader]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareConversationButtonHeader = "spotterShareConversationButtonHeader",
+	/**
+	 * Controls visibility and disable state of the Share item in the Spotter
+	 * conversation history (sidebar) edit menu. Independent of the header button
+	 * above, so a host can show Share in one entry point and hide it in the other.
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.SpotterShareConversationMenuItemSidebar]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareConversationMenuItemSidebar = "spotterShareConversationMenuItemSidebar",
+	/**
+	 * Controls visibility of the entire read-only shared-conversation data-access
+	 * banner shown when a recipient opens a shared view. Hide-only.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterSharedConversationBanner]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterSharedConversationBanner = "spotterSharedConversationBanner",
+	/**
+	 * Controls visibility and disable state of the cross/close button on the
+	 * read-only shared-conversation data-access banner (keeps the banner itself).
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterSharedConversationBannerDismissButton]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterSharedConversationBannerDismissButton = "spotterSharedConversationBannerDismissButton",
+	/**
+	 * Controls visibility and disable state of the Exit button in the read-only
+	 * shared-view header. Hiding it does not disable the ExitSpotterSharedConversation
+	 * host event.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterSharedConversationExitButton]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterSharedConversationExitButton = "spotterSharedConversationExitButton",
+	/**
+	 * Controls visibility of the share-modal footer note ("Chat will be shared up
+	 * to the current moment…"). Hide-only.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterShareUpToCurrentInfo]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareUpToCurrentInfo = "spotterShareUpToCurrentInfo",
+	/**
+	 * Controls visibility and disable state of the share-modal "include new
+	 * messages since last shared version" checkbox.
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.SpotterShareIncludeNewMessagesCheckbox]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareIncludeNewMessagesCheckbox = "spotterShareIncludeNewMessagesCheckbox",
+	/**
+	 * Controls visibility and disable state of the cross on the share-modal
+	 * stale-snapshot info banner.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterShareStaleInfoBannerDismissButton]
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	SpotterShareStaleInfoBannerDismissButton = "spotterShareStaleInfoBannerDismissButton",
 	/**
 	 * Controls visibility and disable state of the delete action
 	 * in the Spotter conversation edit menu.
@@ -8910,6 +9377,16 @@ export enum Action {
 	 * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
 	 */
 	SpotterChatDelete = "spotterChatDelete",
+	/**
+	 * Controls visibility and disable state of the pin/unpin action
+	 * in the Spotter conversation edit menu.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.SpotterChatPin]
+	 * ```
+	 */
+	SpotterChatPin = "spotterChatPin",
 	/**
 	 * Controls visibility and disable state of the documentation/best practices
 	 * link in the Spotter sidebar footer.
@@ -10086,6 +10563,11 @@ export interface LiveboardTab {
 	name: string;
 	[key: string]: any;
 }
+export interface LiveboardGroup {
+	id: string;
+	name: string;
+	[key: string]: any;
+}
 enum ApplicabilityLevel {
 	Liveboard = "LIVEBOARD",
 	Tab = "TAB",
@@ -10131,6 +10613,7 @@ export enum UIPassthroughEvent {
 	GetParameters = "getParameters",
 	GetTML = "getTML",
 	GetTabs = "getTabs",
+	GetGroups = "getGroups",
 	GetExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard"
 }
 export type UIPassthroughContractBase = {
@@ -10240,6 +10723,14 @@ export type UIPassthroughContractBase = {
 			Tabs: LiveboardTab[];
 		};
 	};
+	[UIPassthroughEvent.GetGroups]: {
+		request: Record<string, never>;
+		response: {
+			orderedGroupIds: string[];
+			numberOfGroups: number;
+			Groups: LiveboardGroup[];
+		};
+	};
 	[UIPassthroughEvent.GetExportRequestForCurrentPinboard]: {
 		request: Record<string, never>;
 		response: {
@@ -10285,6 +10776,7 @@ export type EmbedApiHostEventMapping = {
 	[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;
@@ -10940,6 +11432,37 @@ export enum SpotterQueryMode {
 	FAST_SEARCH = "fastSearch",
 	RESEARCH = "research"
 }
+/**
+ * Configuration for the pin/unpin conversation feature in the Spotter sidebar.
+ * Grouped into one object because pin exposes several related settings
+ * (enable + label overrides), unlike single-item actions like rename or
+ * delete.
+ * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+ */
+export interface SpotterChatPinConfig {
+	/**
+	 * Enables the pin/unpin conversation feature in embedded Spotter. Disabled
+	 * by default — hosts must opt in. When off, the Pin/Unpin menu entry and
+	 * the pin glyph are hidden and the PinSpotterConversation /
+	 * UnpinSpotterConversation host events are no-ops. Native (non-embedded)
+	 * Spotter is unaffected and ships pin enabled.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @default false
+	 */
+	enabled?: boolean;
+	/**
+	 * Custom label text for the pin action in the conversation edit menu.
+	 * Defaults to translated "Pin" text.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 */
+	pinLabel?: string;
+	/**
+	 * Custom label text for the unpin action in the conversation edit menu.
+	 * Defaults to translated "Unpin" text.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 */
+	unpinLabel?: string;
+}
 /**
  * Configuration for the Spotter sidebar.
  * Can be used in SpotterEmbed and AppEmbed.
@@ -10977,6 +11500,12 @@ export interface SpotterSidebarViewConfig {
 	 * @version SDK: 1.47.0 | ThoughtSpot: 26.4.0.cl
 	 */
 	spotterChatDeleteLabel?: string;
+	/**
+	 * Pin/unpin conversation feature config (enable + label overrides).
+	 * Off by default in embed — hosts opt in via `enabled`.
+	 * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 */
+	spotterChatPinConfig?: SpotterChatPinConfig;
 	/**
 	 * Custom title text for the delete conversation confirmation modal.
 	 * Defaults to translated "Delete chat" text.
@@ -11027,6 +11556,84 @@ export interface SpotterSidebarViewConfig {
 	 */
 	spotterAnalystsLabel?: string;
 }
+/**
+ * Configuration for the Spotter conversation sharing feature.
+ * Can be used in SpotterEmbed and AppEmbed.
+ * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+ * @group Embed components
+ */
+export interface SpotterShareConversationConfig {
+	/**
+	 * Enables sharing of the conversation.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 */
+	enableShareConversation?: boolean;
+	/**
+	 * Header Share button + sidebar Share item label.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default "Share"
+	 */
+	spotterShareLabel?: string;
+	/**
+	 * Share modal title.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareModalTitle?: string;
+	/**
+	 * Modal confirm button label.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default "Share"
+	 */
+	spotterShareConfirmLabel?: string;
+	/**
+	 * Modal cancel button label.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default "Cancel"
+	 */
+	spotterShareCancelLabel?: string;
+	/**
+	 * "Add users or groups" label.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareAddUsersLabel?: string;
+	/**
+	 * Empty-state title ("No users added yet").
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareEmptyTitle?: string;
+	/**
+	 * Empty-state subtitle ("Not shared with any user").
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareEmptySubtitle?: string;
+	/**
+	 * "Include new messages since last shared version" checkbox label.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareIncludeNewMessagesLabel?: string;
+	/**
+	 * Footer note when the snapshot is current ("…up to the current moment…").
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareUpToCurrentLabel?: string;
+	/**
+	 * Stale-snapshot info banner text ("All added users and groups will receive…").
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterShareStaleInfoLabel?: string;
+	/**
+	 * Read-only shared-view data-access banner message.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	spotterSharedConversationBannerMessage?: string;
+	/**
+	 * Read-only shared-view Exit button label.
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default "Exit"
+	 */
+	spotterSharedConversationExitLabel?: string;
+}
 /**
  * Configuration for customizing Spotter chat UI branding.
  * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
@@ -11081,8 +11688,27 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, "primaryAct
 	/**
 	 * The ID of the data source object. For example, Model, View, or Table. Spotter uses
 	 * this object to query data and generate Answers.
+	 * This field is optional. If not provided, Spotter loads using the
+	 * previously selected user data source.
 	 */
-	worksheetId: string;
+	worksheetId?: string;
+	/**
+	 * The array of data source GUIDs to set on load. Spotter uses
+	 * these GUIDs to query data and generate Answers.
+	 * dataSources is preferred over worksheetId if both are provided.
+	 * The feature is currently behind a feature flag.
+	 *
+	 * Supported embed types: `SpotterEmbed`
+	 * @example
+	 * ```js
+	 * const embed = new SpotterEmbed('#tsEmbed', {
+	 *     // ...other embed view config
+	 *     dataSources: ['id-2345', 'id-2345'],
+	 * });
+	 * ```
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 */
+	dataSources?: string[];
 	/**
 	 * Ability to pass a starting search query to the conversation.
 	 */
@@ -11242,6 +11868,21 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, "primaryAct
 	 * ```
 	 */
 	updatedSpotterChatPrompt?: boolean;
+	/**
+	 * showSpotterRadiance : Controls the radiance on the Spotter page.
+	 *
+	 * Supported embed types: `SpotterEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new SpotterEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    showSpotterRadiance : true,
+	 * })
+	 * ```
+	 */
+	showSpotterRadiance?: boolean;
 	/**
 	 * Sets the default query mode when Spotter loads — Fast Search or
 	 * Research Mode. Applies fresh on every new session for this embed
@@ -11318,6 +11959,59 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, "primaryAct
 	 * ```
 	 */
 	spotterChatConfig?: SpotterChatViewConfig;
+	/**
+	 * Configuration for the Spotter conversation sharing feature.
+	 *
+	 * Supported embed types: `SpotterEmbed`, `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new SpotterEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    spotterShareConversationConfig: {
+	 *        enableShareConversation: true,
+	 *    },
+	 * })
+	 * ```
+	 */
+	spotterShareConversationConfig?: SpotterShareConversationConfig;
+	/**
+	 * The ID of a shared Spotter conversation to open directly in the read-only
+	 * reader view. Use this to land a share recipient in the shared conversation
+	 * when they open a host-configured `CONVERSATION_URL` share link: read the
+	 * `{conversation-id}` from your page URL and pass it here.
+	 *
+	 * Requires the Spotter conversation-sharing feature to be enabled
+	 * (`spotterShareConversationConfig.enableShareConversation`). The recipient
+	 * must be an authorized sharee — the server returns access-denied otherwise.
+	 *
+	 * Supported embed types: `SpotterEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @example
+	 * ```js
+	 * const convId = new URLSearchParams(window.location.search).get('conversation-id');
+	 * const embed = new SpotterEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    sharedConversationId: convId,
+	 * })
+	 * ```
+	 */
+	sharedConversationId?: string;
+	/**
+	 * updatedSpotterExperience : Controls the updated Spotter experience.
+	 *
+	 * Supported embed types: `SpotterEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new SpotterEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    updatedSpotterExperience : true,
+	 * })
+	 * ```
+	 */
+	updatedSpotterExperience?: boolean;
 }
 /**
  * The configuration for the embedded spotterEmbed options.
@@ -11334,6 +12028,7 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {
 export interface SpotterAppInitData extends DefaultAppInitData {
 	embedParams?: {
 		spotterSidebarConfig?: SpotterSidebarViewConfig;
+		spotterShareConversationConfig?: SpotterShareConversationConfig;
 		visualOverridesParams?: VisualizationOverrides | null;
 	};
 }
@@ -11616,6 +12311,9 @@ export enum HomePage {
 	/**
 	 * Modular (v2) introduces the updated Modular Home Experience.
 	 * It serves as the foundational version of the home page.
+	 * Use {@link HomePage.ModularWithStylingChanges} (V3) or
+	 * {@link HomePage.Focused} (V4) instead.
+	 * @deprecated V1 and V2 home page experiences are deprecated.
 	 */
 	Modular = "v2",
 	/**
@@ -11689,13 +12387,14 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	showPrimaryNavbar?: boolean;
 	/**
 	 * Control the visibility of the left navigation panel on the home page
-	 * in the V2 and V3 navigation and home page experience.
+	 * in the V3 and V4 navigation and home page experience.
 	 * If `showPrimaryNavbar` is true, that is, if the Global and Homepage
 	 * navigation bars are visible, this flag will only hide the left navigation bar
 	 * on the home page.
 	 * The `showPrimaryNavbar` flag takes precedence over the `hideHomepageLeftNav`.
 	 *
-	 * **Note**: This attribute is not supported in the classic (V1) experience.
+	 * **Note**: The classic (V1) and Modular (V2) home page experiences are
+	 * deprecated. This attribute applies to V3 and V4 home page experiences.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
@@ -11761,11 +12460,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	hideHamburger?: boolean;
 	/**
 	 * Control the visibility of the object search
-	 * on the top navigation bar in the
-	 * V2 and V3 navigation experience.
+	 * on the top navigation bar in the V3 navigation experience.
 	 *
-	 * **Note**: This attribute is not supported
-	 * in the classic (V1) experience.
+	 * **Note**: The classic (V1) and V2 navigation experiences are
+	 * deprecated. This attribute applies to the V3 navigation experience.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -11783,8 +12481,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * Control the visibility of the notification icon
 	 * on the top navigation bar in V3 navigation experience.
 	 *
-	 * **Note**: This attribute is not supported
-	 * in the classic (V1) and V2 experience modes.
+	 * **Note**: The classic (V1) and V2 experience modes are deprecated.
+	 * This attribute applies to the V3 experience.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -11799,14 +12497,14 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 */
 	hideNotification?: boolean;
 	/**
-	 * Control the visibility of the application selection menu
-	 * in the top navigation bar in the V2 experience.
+	 * Control the visibility of the application selection menu.
 	 * In the V3 experience, it shows or hides application selection
 	 * icons on the left navigation panel.
 	 * By default, the application selection menu and icons are
 	 * shown in the UI.
 	 *
-	 * **Note**: This attribute is not supported in the classic (V1) experience.
+	 * **Note**: The classic (V1) and V2 experiences are deprecated.
+	 * This attribute applies to the V3 experience.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
@@ -11824,7 +12522,8 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * Control the visibility of the Org switcher button on the nav-bar.
 	 * By default, the Org switcher button is shown.
 	 *
-	 * **Note**: This attribute is not supported in the classic (V1) experience.
+	 * **Note**: The classic (V1) experience is deprecated. This attribute
+	 * applies to V2 (deprecated), V3 and V4 experiences.
 	 *
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
@@ -11983,6 +12682,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * Supported embed types: `AppEmbed`
 	 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
 	 * @default false
+	 * Use the discoveryExperience.homePage option with
+	 * {@link HomePage.ModularWithStylingChanges} (V3) or
+	 * {@link HomePage.Focused} (V4) instead.
+	 * @deprecated The V1 and V2 home page experiences are deprecated.
 	 * @example
 	 * ```js
 	 * const embed = new AppEmbed('#tsEmbed', {
@@ -12114,11 +12817,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	/**
 	 * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
 	 * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
-	 * This feature is GA from version 26.5.0.cl. It is disabled by default in embed deployments.
+	 * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.8.0.cl.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
 	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 * @default true
 	 * @example
 	 * ```js
 	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -12131,10 +12835,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	isContinuousLiveboardPDFEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the XLSX/CSV download option for Liveboards
+	 * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.6.0.cl
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+	 * @default true
 	 * @example
 	 * ```js
 	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -12147,10 +12853,12 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	isLiveboardXLSXCSVDownloadEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the granular XLSX/CSV schedules feature
+	 * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.6.0.cl
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+	 * @default true
 	 * @example
 	 * ```js
 	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -12226,6 +12934,21 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	updatedSpotterChatPrompt?: boolean;
+	/**
+	 * showSpotterRadiance : Controls the radiance on the Spotter page.
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    showSpotterRadiance : true,
+	 * })
+	 * ```
+	 */
+	showSpotterRadiance?: boolean;
 	/**
 	 * Sets the default query mode when Spotter loads — Fast Search or
 	 * Research Mode. Applies fresh on every new session for this embed
@@ -12270,6 +12993,10 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 *    spotterSidebarConfig: {
 	 *        enablePastConversationsSidebar: true,
 	 *        spotterSidebarTitle: 'My Conversations',
+	 *        // Opt in to pin/unpin conversations in embedded Spotter
+	 *        spotterChatPinConfig: {
+	 *            enabled: true,
+	 *        },
 	 *    },
 	 * })
 	 * ```
@@ -12293,6 +13020,49 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	spotterChatConfig?: SpotterChatViewConfig;
+	/**
+	 * Configuration for the Spotter conversation sharing feature.
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    spotterShareConversationConfig: {
+	 *        enableShareConversation: true,
+	 *    },
+	 * })
+	 * ```
+	 */
+	spotterShareConversationConfig?: SpotterShareConversationConfig;
+	/**
+	 * Sets the default data sources (Models) for the Spotter experience shown on
+	 * the home page of the full app embed. Accepts a list of Model GUIDs to
+	 * preselect the data sources available to Spotter, or the literal
+	 * `'auto_mode'` sentinel to load Spotter with the "Auto" model selected by
+	 * default. This is consistent with how `worksheetId: 'auto_mode'` enables
+	 * Auto mode in `SpotterEmbed`.
+	 *
+	 * **Note**: If `'auto_mode'` is included alongside one or more Model GUIDs,
+	 * `'auto_mode'` takes precedence and is selected by default.
+	 *
+	 * **Note**: `'auto_mode'` requires the Spotter 3 experience with data source
+	 * discovery enabled on your instance, and a Spotter-enabled home page (for
+	 * example, `discoveryExperience.homePage: HomePage.Focused`).
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.10.0.cl
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    discoveryExperience: { homePage: HomePage.Focused },
+	 *    spotterDataSources: ['model-guid-1', 'model-guid-2'], // or ['auto_mode']
+	 * })
+	 * ```
+	 */
+	spotterDataSources?: string[];
 	/**
 	 * Configuration for the SpotterViz interface shown on the Liveboard.
 	 * Customize the brand name, description, chat input placeholder,
@@ -12388,6 +13158,21 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
 	 */
 	visualOverrides?: VisualizationOverrides;
+	/**
+	 * updatedSpotterExperience : Controls the updated Spotter experience.
+	 *
+	 * Supported embed types: `AppEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new AppEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    updatedSpotterExperience : true,
+	 * })
+	 * ```
+	 */
+	updatedSpotterExperience?: boolean;
 }
 /**
  * APP_INIT data shape for AppEmbed.
@@ -12397,6 +13182,7 @@ export interface AppEmbedAppInitData extends DefaultAppInitData {
 	embedParams?: {
 		spotterSidebarConfig?: SpotterSidebarViewConfig;
 		spotterVizConfig?: SpotterVizConfig;
+		spotterShareConversationConfig?: SpotterShareConversationConfig;
 	};
 }
 /**
@@ -12427,6 +13213,7 @@ export class AppEmbed extends V1Embed {
 	 * embedded Liveboard or visualization.
 	 */
 	protected getEmbedParams(): string;
+	protected getEmbedParamsObject(): any;
 	private sendFullHeightLazyLoadData;
 	/**
 	 * This is a handler for the RequestVisibleEmbedCoordinates event.
@@ -13134,11 +13921,12 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	/**
 	 * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
 	 * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
-	 * This feature is GA from version 26.5.0.cl. It is disabled by default in embed deployments.
+	 * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.8.0.cl.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
 	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 * @default true
 	 * @example
 	 * ```js
 	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -13151,10 +13939,12 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	isContinuousLiveboardPDFEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the XLSX/CSV download option for Liveboards
+	 * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.6.0.cl.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+	 * @default true
 	 * @example
 	 * ```js
 	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -13167,10 +13957,12 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	isLiveboardXLSXCSVDownloadEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the granular XLSX/CSV schedules feature
+	 * This feature is GA from SDK version 1.51.0 and ThoughtSpot version 26.6.0.cl.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+	 * @default true
 	 * @example
 	 * ```js
 	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -13261,6 +14053,21 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 * ```
 	 */
 	updatedSpotterChatPrompt?: boolean;
+	/**
+	 * showSpotterRadiance : Controls the radiance on the Spotter page.
+	 *
+	 * Supported embed types: `LiveboardEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new LiveboardEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    showSpotterRadiance : true,
+	 * })
+	 * ```
+	 */
+	showSpotterRadiance?: boolean;
 	/**
 	 * Enables the stop answer generation button in the Spotter embed UI,
 	 * allowing users to interrupt an ongoing answer generation.
@@ -13336,6 +14143,21 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 * ```
 	 */
 	enableLiveboardDataCache?: boolean;
+	/**
+	 * updatedSpotterExperience : Controls the updated Spotter experience.
+	 *
+	 * Supported embed types: `LiveboardEmbed`
+	 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new LiveboardEmbed('#tsEmbed', {
+	 *    ... //other embed view config
+	 *    updatedSpotterExperience : true,
+	 * })
+	 * ```
+	 */
+	updatedSpotterExperience?: boolean;
 }
 /**
  * Embed a ThoughtSpot Liveboard or visualization. When rendered it already
@@ -14096,6 +14918,10 @@ export const MIXPANEL_EVENT: {
 	VISUAL_SDK_IFRAME_LOAD_PERFORMANCE: string;
 	VISUAL_SDK_EMBED_CREATE: string;
 	VERCEL_INTEGRATION_COMPLETED: string;
+	VISUAL_SDK_RENDER_CALLED: string;
+	VISUAL_SDK_PRE_RENDER: string;
+	VISUAL_SDK_SHOW_PRE_RENDER: string;
+	VISUAL_SDK_HIDE_PRE_RENDER: string;
 };
 /**
  * Pushes the event with its Property key-value map to mixpanel.