@thoughtspot/visual-embed-sdk 1.46.3 → 1.46.5-beta.1

package/lib/src/types.js

@@ -53,6 +53,7 @@ export var AuthType;
      * @deprecated This option is deprecated.
      * @hidden
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     AuthType["SAML"] = "SSO_SAML";
     /**
      * SSO using SAML
@@ -98,6 +99,7 @@ export var AuthType;
      * });
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     AuthType["SAMLRedirect"] = "SSO_SAML";
     /**
      * SSO using OIDC
@@ -111,6 +113,7 @@ export var 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
     AuthType["OIDCRedirect"] = "SSO_OIDC";
     /**
      * Trusted authentication server
@@ -136,6 +139,7 @@ export var AuthType;
      * });
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     AuthType["TrustedAuthToken"] = "AuthServer";
     /**
      * Trusted authentication server Cookieless, Use your own authentication
@@ -1275,22 +1279,45 @@ export var 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
      */
     EmbedEvent["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
+     */
+    EmbedEvent["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
      */
     EmbedEvent["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
+     */
+    EmbedEvent["SavePersonalizedView"] = "savePersonalisedView";
     /**
      * Emitted when a Liveboard is reset.
      * @returns viewName: string
@@ -1302,11 +1329,41 @@ export var EmbedEvent;
     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
      */
     EmbedEvent["DeletePersonalisedView"] = "deletePersonalisedView";
+    /**
+     * Emitted when a PersonalizedView is deleted.
+     * @returns views: string[]
+     * @returns liveboardId: string
+     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+     */
+    EmbedEvent["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
+     */
+    EmbedEvent["ChangePersonalizedView"] = "changePersonalisedView";
     /**
      * Emitted when a user creates a Worksheet.
      * @version SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
@@ -1340,7 +1397,8 @@ export var 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`
@@ -1774,6 +1832,25 @@ export var 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
  */
 export var HostEvent;
@@ -1796,6 +1873,16 @@ export var 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);
+     * ```
      */
     HostEvent["Search"] = "search";
     /**
@@ -1846,6 +1933,24 @@ export var 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
      */
     HostEvent["DrillDown"] = "triggerDrillDown";
@@ -1866,6 +1971,13 @@ export var 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
      */
     HostEvent["GetIframeUrl"] = "GetIframeUrl";
@@ -1879,6 +1991,15 @@ export var 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
      */
     HostEvent["SetVisibleVizs"] = "SetPinboardVisibleVizs";
@@ -1891,6 +2012,14 @@ export var 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
      */
     HostEvent["SetActiveTab"] = "SetActiveTab";
@@ -1924,6 +2053,15 @@ export var 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
      */
@@ -1957,6 +2095,14 @@ export var 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
      */
     HostEvent["OpenFilter"] = "openFilter";
@@ -1967,6 +2113,14 @@ export var 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
      */
     HostEvent["AddColumns"] = "addColumns";
@@ -1977,6 +2131,14 @@ export var 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
      */
     HostEvent["RemoveColumn"] = "removeColumn";
@@ -2063,6 +2225,37 @@ export var 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
      */
@@ -2073,6 +2266,12 @@ export var 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
      */
@@ -2083,6 +2282,12 @@ export var 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
      */
     HostEvent["Schedule"] = "subscription";
@@ -2092,6 +2297,12 @@ export var 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
      */
     HostEvent["SchedulesList"] = "schedule-list";
@@ -2102,6 +2313,18 @@ export var 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
      */
     HostEvent["ExportTML"] = "exportTSL";
@@ -2112,6 +2335,18 @@ export var 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
      */
     HostEvent["EditTML"] = "editTSL";
@@ -2121,6 +2356,12 @@ export var 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
      */
     HostEvent["UpdateTML"] = "updateTSL";
@@ -2147,6 +2388,18 @@ export var 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
      */
@@ -2191,6 +2444,18 @@ export var 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
      */
     HostEvent["MakeACopy"] = "makeACopy";
@@ -2215,6 +2480,14 @@ export var 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
      */
     HostEvent["Explore"] = "explore";
@@ -2232,6 +2505,20 @@ export var 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
      */
     HostEvent["CreateMonitor"] = "createMonitor";
@@ -2253,6 +2540,20 @@ export var 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
      */
     HostEvent["ManageMonitor"] = "manageMonitor";
@@ -2278,6 +2579,26 @@ export var 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
      */
     HostEvent["Edit"] = "edit";
@@ -2295,6 +2616,20 @@ export var 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);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     HostEvent["CopyLink"] = "embedDocument";
@@ -2312,6 +2647,20 @@ export var 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);
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     HostEvent["Present"] = "present";
@@ -2340,6 +2689,22 @@ export var 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
@@ -2361,6 +2726,20 @@ export var 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
      */
     HostEvent["ShowUnderlyingData"] = "showUnderlyingData";
@@ -2378,6 +2757,18 @@ export var 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
      */
     HostEvent["Delete"] = "onDeleteAnswer";
@@ -2398,6 +2789,20 @@ export var 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
      */
     HostEvent["SpotIQAnalyze"] = "spotIQAnalyze";
@@ -2449,9 +2854,16 @@ export var 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
     HostEvent["DownloadAsPng"] = "downloadAsPng";
     /**
      * Trigger the **Download** > **CSV**  action on tables in
@@ -2477,6 +2889,18 @@ export var 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
      */
     HostEvent["DownloadAsCsv"] = "downloadAsCSV";
@@ -2504,6 +2928,18 @@ export var 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
      */
     HostEvent["DownloadAsXlsx"] = "downloadAsXLSX";
@@ -2517,6 +2953,18 @@ export var 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
      */
     HostEvent["Share"] = "share";
@@ -2556,6 +3004,18 @@ export var 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
      */
@@ -2572,6 +3032,20 @@ export var 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
      */
     HostEvent["SyncToSheets"] = "sync-to-sheets";
@@ -2588,6 +3062,20 @@ export var 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
      */
     HostEvent["SyncToOtherApps"] = "sync-to-other-apps";
@@ -2604,6 +3092,20 @@ export var 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
      */
     HostEvent["ManagePipelines"] = "manage-pipeline";
@@ -2616,6 +3118,12 @@ export var 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
      */
     HostEvent["ResetSearch"] = "resetSearch";
@@ -2627,6 +3135,13 @@ export var 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
      */
     HostEvent["GetFilters"] = "getFilters";
@@ -2634,7 +3149,8 @@ export var 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:
@@ -2717,6 +3233,18 @@ export var 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
      */
     HostEvent["UpdateFilters"] = "updateFilters";
@@ -2730,6 +3258,14 @@ export var 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
      */
     HostEvent["GetTabs"] = "getTabs";
@@ -2743,6 +3279,15 @@ export var 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
      */
     HostEvent["SetVisibleTabs"] = "SetPinboardVisibleTabs";
@@ -2756,6 +3301,15 @@ export var 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
      */
     HostEvent["SetHiddenTabs"] = "SetPinboardHiddenTabs";
@@ -2832,13 +3386,24 @@ export var HostEvent;
     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
      */
     HostEvent["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
+     */
+    HostEvent["ResetLiveboardPersonalizedView"] = "ResetLiveboardPersonalisedView";
     /**
      * Triggers an action to update Parameter values on embedded
      * Answers, Liveboard, and Spotter answer in Edit mode.
@@ -2855,6 +3420,16 @@ export var 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
      */
     HostEvent["UpdateParameters"] = "UpdateParameters";
@@ -2874,18 +3449,77 @@ export var 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
      */
     HostEvent["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
      */
     HostEvent["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
+     */
+    HostEvent["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
+     */
+    HostEvent["SelectPersonalizedView"] = "SelectPersonalisedView";
     /**
      * @hidden
      * Notify when info call is completed successfully
@@ -2905,7 +3539,8 @@ export var 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
@@ -2924,6 +3559,34 @@ export var 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
      */
     HostEvent["SaveAnswer"] = "saveAnswer";
@@ -2965,6 +3628,15 @@ export var 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
      */
     HostEvent["SpotterSearch"] = "SpotterSearch";
@@ -2975,6 +3647,12 @@ export var 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
      */
     HostEvent["EditLastPrompt"] = "EditLastPrompt";
@@ -2984,6 +3662,12 @@ export var 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
      */
     HostEvent["PreviewSpotterData"] = "PreviewSpotterData";
@@ -3742,6 +4426,7 @@ export var Action;
      * disabledActions: [Action.LiveboardInfo]
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     Action["LiveboardInfo"] = "pinboardInfo";
     /**
      * @hidden
@@ -3772,6 +4457,7 @@ export var Action;
      * disabledActions: [Action.Subscription]
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     Action["Subscription"] = "subscription";
     /**
      * The **Explore** action on Liveboard visualizations
@@ -4251,13 +4937,25 @@ export var 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
      */
     Action["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
+     */
+    Action["PersonalizedViewsDropdown"] = "personalisedViewsDropdown";
     /**
      * Action ID for show or hide the user details on a
      * Liveboard (Recently visited / social proof)
@@ -4345,14 +5043,27 @@ export var 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
      */
     Action["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
+     */
+    Action["OrganizeFavorites"] = "organiseFavourites";
     /**
      * The **AI Highlights** action on a Liveboard.
      *
@@ -5102,6 +5813,22 @@ export var EmbedErrorCodes;
     /** Invalid URL provided in configuration */
     EmbedErrorCodes["INVALID_URL"] = "INVALID_URL";
 })(EmbedErrorCodes || (EmbedErrorCodes = {}));
+/**
+ * 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 var ContextType;
 (function (ContextType) {
     /**
@@ -5120,6 +5847,10 @@ export var ContextType;
      * Spotter context for spotter modal/page.
      */
     ContextType["Spotter"] = "spotter";
+    /**
+     * Other context for any other generic page.
+     */
+    ContextType["Other"] = "other";
 })(ContextType || (ContextType = {}));
 /**
  * Enum for the type of API intercepted