@thoughtspot/visual-embed-sdk 1.46.4 → 1.46.5

package/src/types.ts

@@ -57,6 +57,7 @@ export enum AuthType {
      * @deprecated This option is deprecated.
      * @hidden
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     SAML = 'SSO_SAML',
     /**
      * SSO using SAML
@@ -102,6 +103,7 @@ export enum AuthType {
      * });
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     SAMLRedirect = 'SSO_SAML',
     /**
      * SSO using OIDC
@@ -115,6 +117,7 @@ export enum AuthType {
      * Will make the host application redirect to the OIDC IdP.
      * See code samples in {@link SAMLRedirect}.
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     OIDCRedirect = 'SSO_OIDC',
     /**
      * Trusted authentication server
@@ -140,6 +143,7 @@ export enum AuthType {
      * });
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     TrustedAuthToken = 'AuthServer',
     /**
      * Trusted authentication server Cookieless, Use your own authentication
@@ -2734,6 +2738,17 @@ export enum EmbedEvent {
      * ```
      */
     DownloadAsXlsx = 'downloadAsXlsx',
+    /**
+     * Emitted when the Download Liveboard as Continuous PDF action is triggered
+     * on a Liveboard.
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.DownloadLiveboardAsContinuousPDF, payload => {
+     *   console.log('download liveboard as continuous PDF', payload)})
+     * ```
+     */
+    DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
     /**
      * Emitted when an Answer is deleted in the app
      *  Use start:true to subscribe to when delete is initiated, or end:true to subscribe
@@ -3137,22 +3152,45 @@ export enum EmbedEvent {
     /**
      * Emitted when name, status (private or public) or filter values of a
      * Personalised view is updated.
+     * This event is deprecated. Use {@link EmbedEvent.UpdatePersonalizedView} instead.
      * @returns viewName: string
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     UpdatePersonalisedView = 'updatePersonalisedView',
+    /**
+     * Emitted when name, status (private or public) or filter values of a
+     * Personalized view is updated.
+     * @returns viewName: string
+     * @returns viewId: string
+     * @returns liveboardId: string
+     * @returns isPublic: boolean
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    UpdatePersonalizedView = UpdatePersonalisedView,
     /**
      * Emitted when a Personalised view is saved.
+     * This event is deprecated. Use {@link EmbedEvent.SavePersonalizedView} instead.
      * @returns viewName: string
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     SavePersonalisedView = 'savePersonalisedView',
+    /**
+     * Emitted when a Personalized view is saved.
+     * @returns viewName: string
+     * @returns viewId: string
+     * @returns liveboardId: string
+     * @returns isPublic: boolean
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    SavePersonalizedView = SavePersonalisedView,
     /**
      * Emitted when a Liveboard is reset.
      * @returns viewName: string
@@ -3164,11 +3202,41 @@ export enum EmbedEvent {
     ResetLiveboard = 'resetLiveboard',
     /**
      * Emitted when a PersonalisedView is deleted.
+     * This event is deprecated. Use {@link EmbedEvent.DeletePersonalizedView} instead.
      * @returns views: string[]
      * @returns liveboardId: string
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     DeletePersonalisedView = 'deletePersonalisedView',
+    /**
+     * Emitted when a PersonalizedView is deleted.
+     * @returns views: string[]
+     * @returns liveboardId: string
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    DeletePersonalizedView = DeletePersonalisedView,
+    /**
+     * Emitted when a user selects a different Personalized View or
+     * resets to the original/default view on a Liveboard.
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.ChangePersonalizedView, (data) => {
+     *   console.log(data.viewName);    // 'Q4 Revenue' or 'Original View'
+     *   console.log(data.viewId);      // '2a021a12-...' or null (default)
+     *   console.log(data.liveboardId); // 'abc123...'
+     *   console.log(data.isPublic);    // true | false
+     * })
+     * ```
+     * @returns viewName: string - Name of the selected view,
+     *   or 'Original View' when reset to default.
+     * @returns viewId: string | null - GUID of the selected view,
+     *   or null when reset to default.
+     * @returns liveboardId: string
+     * @returns isPublic: boolean
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    ChangePersonalizedView = 'changePersonalisedView',
     /**
      * Emitted when a user creates a Worksheet.
      * @version SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
@@ -3202,7 +3270,8 @@ export enum EmbedEvent {
      * @param - Includes the following parameters:
      * - `payload`: The payload received from the embed related to the Data API call.
      * - `responder`: Contains elements that let developers define whether ThoughtSpot
-     *   will run or block the search operation, and if blocked, which error message to provide.
+     *   will run or block the search operation, and if blocked, which error message to
+     *   provide.
      * - `execute` - When `execute` returns `true`, the search is run.
      * When `execute` returns `false`, the search is not executed.
      * - `error` - Developers can customize the user-facing error message when `execute`
@@ -3638,6 +3707,25 @@ export enum EmbedEvent {
  *      );
  *  }
  * ```
+ *
+ * **Context Parameter (SDK: 1.45.2+)**
+ *
+ * Starting from SDK version 1.45.2 | ThoughtSpot: 26.3.0.cl, you can optionally pass a
+ * `ContextType` as the third parameter to the `trigger` method to specify the context
+ * from which the event is triggered. This helps ThoughtSpot understand the current page
+ * context (Search, Answer, Liveboard, or Spotter) for better event handling.
+ *
+ * @example
+ * ```js
+ * import { HostEvent, ContextType } from '@thoughtspot/visual-embed-sdk';
+ *
+ * // Trigger Pin event with Search context
+ * appEmbed.trigger(HostEvent.Pin, {
+ *     vizId: "123",
+ *     liveboardId: "456"
+ * }, ContextType.Search);
+ * ```
+ *
  * @group Events
  */
 
@@ -3660,6 +3748,16 @@ export enum HostEvent {
          execute: true
        });
      * ```
+     * @example
+     * ```js
+     * // Trigger search from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Search, {
+     *     searchQuery: "[revenue] by [region]",
+     *     dataSources: ["cd252e5c-b552-49a8-821d-3eadaa049cca"],
+     *     execute: true
+     * }, ContextType.Search);
+     * ```
      */
     Search = 'search',
     /**
@@ -3710,6 +3808,24 @@ export enum HostEvent {
      *    });
      *  })
      * ```
+     * @example
+     * ```js
+     * // Drill down from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.DrillDown, {
+     *     points: { clickedPoint, selectedPoints },
+     *     autoDrillDown: true
+     * }, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Drill down from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.DrillDown, {
+     *     points: { clickedPoint, selectedPoints },
+     *     columnGuid: "column-guid"
+     * }, ContextType.Search);
+     * ```
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      */
     DrillDown = 'triggerDrillDown',
@@ -3730,6 +3846,13 @@ export enum HostEvent {
      * const url = embed.trigger(HostEvent.GetIframeUrl);
      * console.log("iFrameURL",url);
      * ```
+     * @example
+     * ```js
+     * // Get iframe URL from specific context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * const url = await appEmbed.trigger(HostEvent.GetIframeUrl, {}, ContextType.Answer);
+     * console.log("iFrameURL", url);
+     * ```
      * @version SDK: 1.35.0 | ThoughtSpot: 10.4.0.cl
      */
     GetIframeUrl = 'GetIframeUrl',
@@ -3743,6 +3866,15 @@ export enum HostEvent {
      *  '730496d6-6903-4601-937e-2c691821af3c',
      *  'd547ec54-2a37-4516-a222-2b06719af726'])
      * ```
+     * @example
+     * ```js
+     * // Set visible vizs from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, [
+     *     '730496d6-6903-4601-937e-2c691821af3c',
+     *     'd547ec54-2a37-4516-a222-2b06719af726'
+     * ], ContextType.Liveboard);
+     * ```
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      */
     SetVisibleVizs = 'SetPinboardVisibleVizs',
@@ -3755,6 +3887,14 @@ export enum HostEvent {
      *  tabId:'730496d6-6903-4601-937e-2c691821af3c'
      * })
      * ```
+     * @example
+     * ```js
+     * // Set active tab from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SetActiveTab, {
+     *     tabId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.24.0 | ThoughtSpot: 9.5.0.cl, 9.5.1-sw
      */
     SetActiveTab = 'SetActiveTab',
@@ -3788,6 +3928,15 @@ export enum HostEvent {
      *   {columnName: "item type",operator: RuntimeFilterOp.EQ,values: ["Jackets"]}
      * ])
      * ```
+     * @example
+     * ```js
+     * // Update runtime filters from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
+     *     {columnName: "region", operator: RuntimeFilterOp.EQ, values: ["west"]},
+     *     {columnName: "product", operator: RuntimeFilterOp.IN, values: ["shoes", "boots"]}
+     * ], ContextType.Liveboard);
+     * ```
      * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
      * @important
      */
@@ -3821,6 +3970,14 @@ export enum HostEvent {
      * LiveboardEmbed.trigger(HostEvent.OpenFilter,
      *   { column: {columnId: '<column-GUID>'}})
      * ```
+     * @example
+     * ```js
+     * // Open filter from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.OpenFilter, {
+     *     column: { columnId: '<column-GUID>', name: 'region', type: 'ATTRIBUTE', dataType: 'CHAR'}
+     * }, ContextType.Search);
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     OpenFilter = 'openFilter',
@@ -3831,6 +3988,14 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.AddColumns, { columnIds: ['<column-GUID>','<column-GUID>'] })
      * ```
+     * @example
+     * ```js
+     * // Add columns from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.AddColumns, {
+     *     columnIds: ['col-guid-1', 'col-guid-2']
+     * }, ContextType.Search);
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     AddColumns = 'addColumns',
@@ -3841,6 +4006,14 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.RemoveColumn, { columnId: '<column-Guid>' })
      * ```
+     * @example
+     * ```js
+     * // Remove column from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.RemoveColumn, {
+     *     columnId: 'column-guid'
+     * }, ContextType.Search);
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     RemoveColumn = 'removeColumn',
@@ -3927,6 +4100,37 @@ export enum HostEvent {
     *
     * spotterEmbed.trigger(HostEvent.Pin, { vizId: latestSpotterVizId });
     * ```
+     * @example
+     * ```js
+     * // Using context parameter to specify the context type (SDK: 1.45.2+)
+     * // Pin from a search answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Pin, {
+     *     vizId: "123",
+     *     newVizName: "Sales by region",
+     *     liveboardId: "456"
+     *  }, ContextType.Search);
+     * ```
+     * @example
+     * ```js
+     * // Pin from an answer context (explore modal/page) (SDK: 1.45.2+)
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Pin, {
+     *     vizId: "789",
+     *     newVizName: "Revenue trends",
+     *     liveboardId: "456"
+     *  }, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Pin from a spotter context (SDK: 1.45.2+)
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Pin, {
+     *     vizId: latestSpotterVizId,
+     *     newVizName: "AI-generated insights",
+     *     liveboardId: "456"
+     *  }, ContextType.Spotter);
+     * ```
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
@@ -3937,6 +4141,12 @@ export enum HostEvent {
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
+     *```
+     * @example
+     * ```js
+     * // Show liveboard info from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.LiveboardInfo, {}, ContextType.Liveboard);
      * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
@@ -3947,6 +4157,12 @@ export enum HostEvent {
      * ```js
      *  liveboardEmbed.trigger(HostEvent.Schedule)
      * ```
+     * @example
+     * ```js
+     * // Schedule from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Schedule, {}, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     Schedule = 'subscription',
@@ -3956,6 +4172,12 @@ export enum HostEvent {
      * ```js
      *  liveboardEmbed.trigger(HostEvent.ScheduleList)
      * ```
+     * @example
+     * ```js
+     * // Manage schedules from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.ScheduleList, {}, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     SchedulesList = 'schedule-list',
@@ -3966,6 +4188,18 @@ export enum HostEvent {
      * ```js
      * liveboardEmbed.trigger(HostEvent.ExportTML)
      * ```
+     * @example
+     * ```js
+     * // Export TML from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.ExportTML, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Export TML from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.ExportTML, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     ExportTML = 'exportTSL',
@@ -3976,6 +4210,18 @@ export enum HostEvent {
      * ```js
      * liveboardEmbed.trigger(HostEvent.EditTML)
      * ```
+     * @example
+     * ```js
+     * // Edit TML from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.EditTML, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Edit TML from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.EditTML, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     EditTML = 'editTSL',
@@ -3985,6 +4231,12 @@ export enum HostEvent {
      * ```js
      * liveboardEmbed.trigger(HostEvent.UpdateTML)
      * ```
+     * @example
+     * ```js
+     * // Update TML from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.UpdateTML, {}, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     UpdateTML = 'updateTSL',
@@ -4011,10 +4263,34 @@ export enum HostEvent {
     *
     * spotterEmbed.trigger(HostEvent.DownloadAsPdf, { vizId: latestSpotterVizId });
     * ```
+     * @example
+     * ```js
+     * // Download as PDF from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.DownloadAsPdf, {}, ContextType.Search);
+     * ```
+     * @example
+     * ```js
+     * // Download as PDF from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.DownloadAsPdf, {}, ContextType.Liveboard);
+     * ```
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     DownloadAsPdf = 'downloadAsPdf',
+    /**
+     * Trigger the **Download Liveboard as Continuous PDF** action on an
+     * embedded Liveboard.
+     *
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.DownloadLiveboardAsContinuousPDF)
+     * ```
+     *
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
     /**
      * Trigger the **AI Highlights** action on an embedded Liveboard
      *
@@ -4055,6 +4331,18 @@ export enum HostEvent {
      *
      * spotterEmbed.trigger(HostEvent.MakeACopy, { vizId: latestSpotterVizId });
      * ```
+     * @example
+     * ```js
+     * // Make a copy from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.MakeACopy, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Make a copy from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.MakeACopy, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     MakeACopy = 'makeACopy',
@@ -4079,6 +4367,14 @@ export enum HostEvent {
      * ```js
      * liveboardEmbed.trigger(HostEvent.Explore, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
      * ```
+     * @example
+     * ```js
+     * // Explore from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Explore, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     Explore = 'explore',
@@ -4096,6 +4392,20 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.CreateMonitor)
      * ```
+     * @example
+     * ```js
+     * // Create monitor from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.CreateMonitor, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Create monitor from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.CreateMonitor, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     CreateMonitor = 'createMonitor',
@@ -4117,6 +4427,20 @@ export enum HostEvent {
      * ```js
      * vizEmbed.trigger(HostEvent.ManageMonitor)
      * ```
+     * @example
+     * ```js
+     * // Manage monitor from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.ManageMonitor, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Manage monitor from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.ManageMonitor, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     ManageMonitor = 'manageMonitor',
@@ -4142,6 +4466,26 @@ export enum HostEvent {
      * ```js
      * spotterEmbed.trigger(HostEvent.Edit);
      * ```
+     * @example
+     * ```js
+     * // Using context parameter to edit liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Edit, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Edit from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Edit, {}, ContextType.Search);
+     * ```
+     * * @example
+     * ```js
+     * // Edit from spotter context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Edit, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Spotter);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     Edit = 'edit',
@@ -4159,6 +4503,34 @@ export enum HostEvent {
      * ```js
      * vizEmbed.trigger(HostEvent.CopyLink)
      * ```
+     * @example
+     * ```js
+     * // Copy link from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.CopyLink, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Copy link from liveboard visualization context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.CopyLink, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Copy link from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.CopyLink, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Copy link from liveboard visualization context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.CopyLink, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     CopyLink = 'embedDocument',
@@ -4176,6 +4548,34 @@ export enum HostEvent {
      * ```js
      * vizEmbed.trigger(HostEvent.Present)
      * ```
+     * @example
+     * ```js
+     * // Present from liveboard visualization context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Present, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Present from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Present, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Present from liveboard visualization context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Present, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Present from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Present, {}, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     Present = 'present',
@@ -4204,6 +4604,22 @@ export enum HostEvent {
      *      tml.answer.search_query // TML representation of the search query
      *   );
      * })
+    * ```
+     * @example
+     * ```js
+     * // Get TML from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.GetTML, {}, ContextType.Search).then((tml) => {
+     *   console.log(tml.answer.search_query);
+     * });
+     * ```
+     * @example
+     * ```js
+     * // Get TML from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.GetTML, {}, ContextType.Search).then((tml) => {
+     *   console.log(tml.answer);
+     * });
      * ```
      * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
      * @important
@@ -4225,6 +4641,20 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.ShowUnderlyingData)
      * ```
+     * @example
+     * ```js
+     * // Show underlying data from liveboard visualization context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.ShowUnderlyingData, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Show underlying data from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.ShowUnderlyingData, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     ShowUnderlyingData = 'showUnderlyingData',
@@ -4242,6 +4672,18 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.Delete)
      * ```
+     * @example
+     * ```js
+     * // Delete from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Delete, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Delete from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Delete, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     Delete = 'onDeleteAnswer',
@@ -4262,6 +4704,20 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.SpotIQAnalyze)
      * ```
+     * @example
+     * ```js
+     * // SpotIQ analyze from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.SpotIQAnalyze, { vizId: '730496d6-6903-4601-937e-2c691821af3c' }, ContextType.Search);
+     * ```
+     * @example
+     * ```js
+     * // SpotIQ analyze from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     SpotIQAnalyze = 'spotIQAnalyze',
@@ -4313,9 +4769,16 @@ export enum HostEvent {
      *
      * spotterEmbed.trigger(HostEvent.DownloadAsPng, { vizId: latestSpotterVizId });
      * ```
+     * @example
+     * ```js
+     * // Download as PNG from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.DownloadAsPng, {}, ContextType.Search);
+     * ```
      *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.1.sw
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     DownloadAsPng = 'downloadAsPng',
     /**
      * Trigger the **Download** > **CSV**  action on tables in
@@ -4341,6 +4804,18 @@ export enum HostEvent {
      *
      * spotterEmbed.trigger(HostEvent.DownloadAsCsv, { vizId: latestSpotterVizId });
      * ```
+     * @example
+     * ```js
+     * // Download as CSV from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.DownloadAsCsv, {}, ContextType.Search);
+     * ```
+     * @example
+     * ```js
+     * // Download as CSV from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.DownloadAsCsv, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     DownloadAsCsv = 'downloadAsCSV',
@@ -4368,6 +4843,18 @@ export enum HostEvent {
      *
      * spotterEmbed.trigger(HostEvent.DownloadAsXlsx, { vizId: latestSpotterVizId });
      * ```
+     * @example
+     * ```js
+     * // Download as XLSX from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.DownloadAsXlsx, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Download as XLSX from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.DownloadAsXlsx, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     DownloadAsXlsx = 'downloadAsXLSX',
@@ -4381,6 +4868,18 @@ export enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.Share)
      * ```
+     * @example
+     * ```js
+     * // Share from Liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.Share, {}, ContextType.Liveboard);
+     * ```
+     * @example
+     * ```js
+     * // Share from search-answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Share, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     Share = 'share',
@@ -4420,6 +4919,18 @@ export enum HostEvent {
      *
      * spotterEmbed.trigger(HostEvent.Save, { vizId: latestSpotterVizId });
      * ```
+     * @example
+     * ```js
+     * // Save from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.Save, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Save from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.Save, {}, ContextType.Search);
+     * ```
      *
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
@@ -4436,6 +4947,20 @@ export enum HostEvent {
      * ```js
      * vizEmbed.trigger(HostEvent.SyncToSheets)
      * ```
+     * @example
+     * ```js
+     * // Sync to sheets from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.SyncToSheets, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Sync to sheets from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SyncToSheets, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     SyncToSheets = 'sync-to-sheets',
@@ -4452,6 +4977,20 @@ export enum HostEvent {
      * ```js
      * vizEmbed.trigger(HostEvent.SyncToOtherApps)
      * ```
+     * @example
+     * ```js
+     * // Sync to other apps from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.SyncToOtherApps, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Sync to other apps from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     SyncToOtherApps = 'sync-to-other-apps',
@@ -4468,6 +5007,20 @@ export enum HostEvent {
      * ```js
      * vizEmbed.trigger(HostEvent.ManagePipelines)
      * ```
+     * @example
+     * ```js
+     * // Manage pipelines from answer context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * appEmbed.trigger(HostEvent.ManagePipelines, {}, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Manage pipelines from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.ManagePipelines, {
+     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     ManagePipelines = 'manage-pipeline',
@@ -4480,6 +5033,12 @@ export enum HostEvent {
      * ```js
      * appEmbed.trigger(HostEvent.ResetSearch)
      * ```
+     * @example
+     * ```js
+     * // Reset search from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * searchEmbed.trigger(HostEvent.ResetSearch, {}, ContextType.Search);
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1.sw
      */
     ResetSearch = 'resetSearch',
@@ -4491,6 +5050,13 @@ export enum HostEvent {
      * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
      *     console.log('data', data);
      * ```
+     * @example
+     * ```js
+     * // Get filters from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * const data = await liveboardEmbed.trigger(HostEvent.GetFilters, {}, ContextType.Liveboard);
+     * console.log('filters', data);
+     * ```
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
      */
     GetFilters = 'getFilters',
@@ -4498,7 +5064,8 @@ export enum HostEvent {
      * Update one or several filters applied on a Liveboard.
      * @param - Includes the following keys:
      * - `filter`: A single filter object containing column name, filter operator, and
-     * values. - `filters`: Multiple filter objects with column name, filter operator,
+     * values.
+     * - `filters`: Multiple filter objects with column name, filter operator,
      * and values for each.
      *
      * Each filter object must include the following attributes:
@@ -4581,6 +5148,18 @@ export enum HostEvent {
      *  }]
      * });
      * ```
+     * @example
+     * ```js
+     * // Update filters from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
+     *     filter: {
+     *         column: "item type",
+     *         oper: "IN",
+     *         values: ["shoes", "boots"]
+     *     }
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
      */
     UpdateFilters = 'updateFilters',
@@ -4594,6 +5173,14 @@ export enum HostEvent {
      *   );
      * })
      * ```
+     * @example
+     * ```js
+     * // Get tabs from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.GetTabs, {}, ContextType.Liveboard).then((tabDetails) => {
+     *     console.log('tabs', tabDetails);
+     * });
+     * ```
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
      */
     GetTabs = 'getTabs',
@@ -4607,6 +5194,15 @@ export enum HostEvent {
      *  '430496d6-6903-4601-937e-2c691821af3c',
      *  'f547ec54-2a37-4516-a222-2b06719af726'])
      * ```
+     * @example
+     * ```js
+     * // Set visible tabs from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SetVisibleTabs, [
+     *     '430496d6-6903-4601-937e-2c691821af3c',
+     *     'f547ec54-2a37-4516-a222-2b06719af726'
+     * ], ContextType.Liveboard);
+     * ```
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
      */
     SetVisibleTabs = 'SetPinboardVisibleTabs',
@@ -4620,6 +5216,15 @@ export enum HostEvent {
      *  '630496d6-6903-4601-937e-2c691821af3c',
      *  'i547ec54-2a37-4516-a222-2b06719af726'])
      * ```
+     * @example
+     * ```js
+     * // Set hidden tabs from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
+     *     '630496d6-6903-4601-937e-2c691821af3c',
+     *     'i547ec54-2a37-4516-a222-2b06719af726'
+     * ], ContextType.Liveboard);
+     * ```
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
      */
     SetHiddenTabs = 'SetPinboardHiddenTabs',
@@ -4696,13 +5301,24 @@ export enum HostEvent {
     UpdateCrossFilter = 'UpdateCrossFilter',
     /**
      * Trigger reset action for a personalized Liveboard view.
+     * This event is deprecated. Use {@link HostEvent.ResetLiveboardPersonalizedView} instead.
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.ResetLiveboardPersonalisedView);
      * ```
      * @version SDK: 1.29.0 | ThoughtSpot Cloud: 10.1.0.cl, 10.1.0.sw
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     ResetLiveboardPersonalisedView = 'ResetLiveboardPersonalisedView',
+    /**
+     * Trigger reset action for a personalized Liveboard view.
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.ResetLiveboardPersonalizedView);
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    ResetLiveboardPersonalizedView = ResetLiveboardPersonalisedView,
     /**
      * Triggers an action to update Parameter values on embedded
      * Answers, Liveboard, and Spotter answer in Edit mode.
@@ -4719,6 +5335,16 @@ export enum HostEvent {
      *   isVisibleToUser: false
      * }])
      * ```
+     * @example
+     * ```js
+     * // Update parameters from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
+     *     name: "Region Param",
+     *     value: "West",
+     *     isVisibleToUser: true
+     * }], ContextType.Liveboard);
+     * ```
      * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
      */
     UpdateParameters = 'UpdateParameters',
@@ -4738,18 +5364,77 @@ export enum HostEvent {
      * });
      *
      * spotterEmbed.trigger(HostEvent.GetParameters, { vizId: latestSpotterVizId });
+     *```
+     * @example
+     * ```js
+     * // Get parameters from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.GetParameters, {}, ContextType.Liveboard).then((parameters) => {
+     *     console.log('parameters', parameters);
+     * });
      * ```
      * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
      */
     GetParameters = 'GetParameters',
     /**
      * Triggers an event to update a personalized view of a Liveboard.
+     * This event is deprecated. Use {@link HostEvent.UpdatePersonalizedView} instead.
      * ```js
      * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
      * ```
+     * @example
+     * ```js
+     * // Update personalized view from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {
+     *     viewId: '1234'
+     * }, ContextType.Liveboard);
+     * ```
      * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     UpdatePersonalisedView = 'UpdatePersonalisedView',
+    /**
+     * Triggers an event to update a personalized view of a Liveboard.
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    UpdatePersonalizedView = UpdatePersonalisedView,    
+    /**
+     * Triggers selection of a specific Personalized View on a
+     * Liveboard without reloading the embed. Pass either a
+     * `viewId` (GUID) or `viewName`. If both are provided, `viewId` takes precedence.
+     * 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.
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(
+     *   HostEvent.SelectPersonalizedView,
+     *   { viewId: '2a021a12-1aed-425d-984b-141ee916ce72' },
+     * )
+     * ```
+     * @example
+     * ```js
+     * // Select by name
+     * liveboardEmbed.trigger(
+     *   HostEvent.SelectPersonalizedView,
+     *   { viewName: 'Dr Smith Cardiology' },
+     * )
+     * ```
+     * @example
+     * ```js
+     * // Reset to default view
+     * liveboardEmbed.trigger(
+     *   HostEvent.SelectPersonalizedView,
+     *   {},
+     * )
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    SelectPersonalizedView = 'SelectPersonalisedView',
     /**
      * @hidden
      * Notify when info call is completed successfully
@@ -4769,7 +5454,8 @@ export enum HostEvent {
      * add a name and description for the Answer.
      * @param - Includes the following keys:
      * - `vizId`: Refers to the Answer ID in Spotter embed and is **required** in Spotter
-     * embed. - `name`: Optional. Name string for the Answer.
+     * embed.
+     * - `name`: Optional. Name string for the Answer.
      * - `description`: Optional. Description text for the Answer.
      * @example
      * ```js
@@ -4788,6 +5474,34 @@ export enum HostEvent {
      *
      * spotterEmbed.trigger(HostEvent.SaveAnswer, { vizId: latestSpotterVizId });
      * ```
+     * @example
+     * ```js
+     * // Using context parameter to save answer from search context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * const saveAnswerResponse = await appEmbed.trigger(HostEvent.SaveAnswer, {
+     *      name: "Regional sales analysis",
+     *      description: "Sales breakdown by region"
+     *   }, ContextType.Search);
+     * ```
+     * @example
+     * ```js
+     * // Save answer from answer context (explore modal)
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * const saveAnswerResponse = await appEmbed.trigger(HostEvent.SaveAnswer, {
+     *      name: "Modified analysis",
+     *      description: "Updated from explore view"
+     *   }, ContextType.Answer);
+     * ```
+     * @example
+     * ```js
+     * // Save answer from spotter context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * const saveAnswerResponse = await appEmbed.trigger(HostEvent.SaveAnswer, {
+     *      vizId: latestSpotterVizId,
+     *      name: "AI insights",
+     *      description: "Generated from Spotter"
+     *   }, ContextType.Spotter);
+     * ```
      * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
      */
     SaveAnswer = 'saveAnswer',
@@ -4829,6 +5543,15 @@ export enum HostEvent {
      *  executeSearch: true,
      * })
      * ```
+     * @example
+     * ```js
+     * // Spotter search from spotter context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * spotterEmbed.trigger(HostEvent.SpotterSearch, {
+     *     query: 'sales by region',
+     *     executeSearch: true
+     * }, ContextType.Spotter);
+     * ```
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     SpotterSearch = 'SpotterSearch',
@@ -4839,6 +5562,12 @@ export enum HostEvent {
      * ```js
      * spotterEmbed.trigger(HostEvent.EditLastPrompt, "revenue per year");
      * ```
+     * @example
+     * ```js
+     * // Edit last prompt from spotter context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * spotterEmbed.trigger(HostEvent.EditLastPrompt, "sales by region", ContextType.Spotter);
+     * ```
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     EditLastPrompt = 'EditLastPrompt',
@@ -4848,6 +5577,12 @@ export enum HostEvent {
      * ```js
      * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
      * ```
+     * @example
+     * ```js
+     * // Preview spotter data from spotter context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * spotterEmbed.trigger(HostEvent.PreviewSpotterData, {}, ContextType.Spotter);
+     * ```
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     PreviewSpotterData = 'PreviewSpotterData',
@@ -5142,6 +5877,7 @@ export enum Param {
     IsLazyLoadingForEmbedEnabled = 'isLazyLoadingForEmbedEnabled',
     RootMarginForLazyLoad = 'rootMarginForLazyLoad',
     isPNGInScheduledEmailsEnabled = 'isPNGInScheduledEmailsEnabled',
+    IsWYSIWYGLiveboardPDFEnabled = 'isWYSIWYGLiveboardPDFEnabled',
     isLiveboardXLSXCSVDownloadEnabled = 'isLiveboardXLSXCSVDownloadEnabled',
     isGranularXLSXCSVSchedulesEnabled = 'isGranularXLSXCSVSchedulesEnabled',
     isCentralizedLiveboardFilterUXEnabled = 'isCentralizedLiveboardFilterUXEnabled',
@@ -5487,6 +6223,16 @@ export enum Action {
      * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
      */
     DownloadLiveboard = 'downloadLiveboard',
+    /**
+     * The **Download Liveboard as Continuous PDF** menu action on a Liveboard.
+     * Allows downloading the entire Liveboard as a continuous PDF.
+     * @example
+     * ```js
+     * disabledActions: [Action.DownloadLiveboardAsContinuousPDF]
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
     /**
      * @hidden
      */
@@ -5611,6 +6357,7 @@ export enum Action {
      * disabledActions: [Action.LiveboardInfo]
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     LiveboardInfo = 'pinboardInfo',
     /**
      * @hidden
@@ -5641,6 +6388,7 @@ export enum Action {
      * disabledActions: [Action.Subscription]
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     Subscription = 'subscription',
     /**
      * The **Explore** action on Liveboard visualizations
@@ -6121,13 +6869,25 @@ export enum Action {
     /**
      * The Liveboard Personalised Views dropdown.
      * Allows navigating to a personalized Liveboard View.
+     * This action is deprecated. Use {@link Action.PersonalizedViewsDropdown} instead.
      *  @example
      * ```js
      * disabledActions: [Action.PersonalisedViewsDropdown]
      * ```
      *  @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 10.1.0.sw
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     PersonalisedViewsDropdown = 'personalisedViewsDropdown',
+    /**
+     * The Liveboard Personalized Views dropdown.
+     * Allows navigating to a personalized Liveboard View.
+     *  @example
+     * ```js
+     * disabledActions: [Action.PersonalizedViewsDropdown]
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    PersonalizedViewsDropdown = PersonalisedViewsDropdown,    
     /**
      * Action ID for show or hide the user details on a
      * Liveboard (Recently visited / social proof)
@@ -6220,15 +6980,29 @@ export enum Action {
     /**
      * The **Organize Favourites** action on Homepage
      * *Favorites* module.
+     * This action is deprecated. Use {@link Action.OrganizeFavorites} instead.
      *
      * @example
      * ```js
      * disabledActions: [Action.OrganiseFavourites]
      * ```
      * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl
+     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
      */
     OrganiseFavourites = 'organiseFavourites',
 
+    /**
+     * The **Organize Favorites** action on Homepage
+     * *Favorites* module.
+     *
+     * @example
+     * ```js
+     * disabledActions: [Action.OrganizeFavorites]
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    OrganizeFavorites = OrganiseFavourites,
+
     /**
      * The **AI Highlights** action on a Liveboard.
      *
@@ -6695,6 +7469,39 @@ export enum Action {
      * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
      */
     SpotterDocs = 'spotterDocs',
+    /**
+     * Controls visibility and disable state of the connector resources
+     * section in the Spotter chat interface.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterChatConnectorResources]
+     * disabledActions: [Action.SpotterChatConnectorResources]
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
+     */
+    SpotterChatConnectorResources = 'spotterChatConnectorResources',
+    /**
+     * Controls visibility and disable state of the connectors
+     * in the Spotter chat interface.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterChatConnectors]
+     * disabledActions: [Action.SpotterChatConnectors]
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
+     */
+    SpotterChatConnectors = 'spotterChatConnectors',
+    /**
+     * Controls visibility and disable state of the mode switcher
+     * in the Spotter chat interface.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterChatModeSwitcher]
+     * disabledActions: [Action.SpotterChatModeSwitcher]
+     * ```
+     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
+     */
+    SpotterChatModeSwitcher = 'spotterChatModeSwitcher',
     /**
      * The **Include current period** checkbox for date filters.
      * Controls the visibility and availability of the option to include
@@ -7071,6 +7878,15 @@ export enum EmbedErrorCodes {
 
     /** Invalid URL provided in configuration */
     INVALID_URL = 'INVALID_URL',
+
+    /** Host event payload validation failed */
+    HOST_EVENT_VALIDATION = 'HOST_EVENT_VALIDATION',
+
+    /** UpdateFilters payload is invalid - missing or malformed filter/filters */
+    UPDATEFILTERS_INVALID_PAYLOAD = 'UPDATEFILTERS_INVALID_PAYLOAD',
+
+    /** DrillDown payload is invalid - missing or malformed points */
+    DRILLDOWN_INVALID_PAYLOAD = 'DRILLDOWN_INVALID_PAYLOAD',
 }
 
 /**
@@ -7084,7 +7900,8 @@ export enum EmbedErrorCodes {
  *
  * - **errorType**: One of the predefined {@link ErrorDetailsTypes} values
  * - **message**: Human-readable error description (string or array of strings for
- * multiple errors) - **code**: Machine-readable error identifier {@link EmbedErrorCodes}
+ * multiple errors)
+ * - **code**: Machine-readable error identifier {@link EmbedErrorCodes}
  * values
  * - **[key: string]**: Additional context-specific for backward compatibility
  *
@@ -7133,6 +7950,22 @@ export interface EmbedErrorDetailsEvent {
     [key: string]: any;
 }
 
+/**
+ * Context types for specifying the page context when triggering host events.
+ * Used as the third parameter in the `trigger` method to help ThoughtSpot
+ * understand the current page context for better event handling.
+ *
+ * @example
+ * ```js
+ * import { HostEvent, ContextType } from '@thoughtspot/visual-embed-sdk';
+ *
+ * // Trigger an event with specific context
+ * embed.trigger(HostEvent.Pin, { vizId: "123", liveboardId: "456" }, ContextType.Search);
+ * ```
+ *
+ * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
+ * @group Events
+ */
 export enum ContextType {
     /**
      * Search answer context for search page or edit viz dialog on liveboard page.
@@ -7150,6 +7983,11 @@ export enum ContextType {
      * Spotter context for spotter modal/page.
      */
     Spotter = 'spotter',
+
+    /**
+     * Other context for any other generic page.
+     */
+    Other = 'other',
 }
 
 export interface DefaultAppInitData {
@@ -7257,33 +8095,7 @@ export interface ObjectIds {
     modalTitle?: string;
 }
 
-/**
- * Context object for the embedded component.
- * @example
- * ```js
- * const context = await embed.getCurrentContext();
- * console.log(context);
- * {
- *   stack: [
- *     {
- *       name: 'Liveboard',
- *       type: ContextType.Liveboard,
- *       objectIds: {
- *         liveboardId: '123',
- *       },
- *     },
- *   ],
- *   currentContext: {
- *     name: 'Liveboard',
- *     type: ContextType.Liveboard,
- *     objectIds: {
- *       liveboardId: '123',
- *     },
- *   },
- * }
- * ```
- * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
- */
+
 export interface ContextObject {
     /**
      * Stack of context objects.