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

package/dist/tsembed-react.es.js

@@ -1,4 +1,4 @@
-/* @thoughtspot/visual-embed-sdk version 1.46.3 */
+/* @thoughtspot/visual-embed-sdk version 1.46.5-beta.1 */
 'use client';
 import * as React from 'react';
 import React__default, { useRef, useCallback } from 'react';
@@ -238,6 +238,7 @@ 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
@@ -283,6 +284,7 @@ var AuthType;
      * });
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     AuthType["SAMLRedirect"] = "SSO_SAML";
     /**
      * SSO using OIDC
@@ -296,6 +298,7 @@ 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
@@ -321,6 +324,7 @@ var AuthType;
      * });
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     AuthType["TrustedAuthToken"] = "AuthServer";
     /**
      * Trusted authentication server Cookieless, Use your own authentication
@@ -1460,22 +1464,45 @@ 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
@@ -1487,11 +1514,41 @@ 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
@@ -1525,7 +1582,8 @@ 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`
@@ -1959,6 +2017,25 @@ 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
  */
 var HostEvent;
@@ -1981,6 +2058,16 @@ 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";
     /**
@@ -2031,6 +2118,24 @@ 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";
@@ -2051,6 +2156,13 @@ 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";
@@ -2064,6 +2176,15 @@ 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";
@@ -2076,6 +2197,14 @@ 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";
@@ -2109,6 +2238,15 @@ 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
      */
@@ -2142,6 +2280,14 @@ 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";
@@ -2152,6 +2298,14 @@ 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";
@@ -2162,6 +2316,14 @@ 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";
@@ -2248,6 +2410,37 @@ 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
      */
@@ -2258,6 +2451,12 @@ 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
      */
@@ -2268,6 +2467,12 @@ 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";
@@ -2277,6 +2482,12 @@ 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";
@@ -2287,6 +2498,18 @@ 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";
@@ -2297,6 +2520,18 @@ 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";
@@ -2306,6 +2541,12 @@ 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";
@@ -2332,6 +2573,18 @@ 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
      */
@@ -2376,6 +2629,18 @@ 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";
@@ -2400,6 +2665,14 @@ 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";
@@ -2417,6 +2690,20 @@ 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";
@@ -2438,6 +2725,20 @@ 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";
@@ -2463,6 +2764,26 @@ 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";
@@ -2480,6 +2801,20 @@ 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";
@@ -2497,6 +2832,20 @@ 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";
@@ -2525,6 +2874,22 @@ 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
@@ -2546,6 +2911,20 @@ 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";
@@ -2563,6 +2942,18 @@ 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";
@@ -2583,6 +2974,20 @@ 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";
@@ -2634,9 +3039,16 @@ 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
@@ -2662,6 +3074,18 @@ 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";
@@ -2689,6 +3113,18 @@ 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";
@@ -2702,6 +3138,18 @@ 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";
@@ -2741,6 +3189,18 @@ 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
      */
@@ -2757,6 +3217,20 @@ 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";
@@ -2773,6 +3247,20 @@ 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";
@@ -2789,6 +3277,20 @@ 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";
@@ -2801,6 +3303,12 @@ 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";
@@ -2812,6 +3320,13 @@ 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";
@@ -2819,7 +3334,8 @@ 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:
@@ -2902,6 +3418,18 @@ 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";
@@ -2915,6 +3443,14 @@ 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";
@@ -2928,6 +3464,15 @@ 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";
@@ -2941,6 +3486,15 @@ 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";
@@ -3017,13 +3571,24 @@ 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.
@@ -3040,6 +3605,16 @@ 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";
@@ -3059,18 +3634,77 @@ 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
@@ -3090,7 +3724,8 @@ 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
@@ -3109,6 +3744,34 @@ 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";
@@ -3150,6 +3813,15 @@ 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";
@@ -3160,6 +3832,12 @@ 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";
@@ -3169,6 +3847,12 @@ 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";
@@ -3927,6 +4611,7 @@ var Action;
      * disabledActions: [Action.LiveboardInfo]
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     Action["LiveboardInfo"] = "pinboardInfo";
     /**
      * @hidden
@@ -3957,6 +4642,7 @@ var Action;
      * disabledActions: [Action.Subscription]
      * ```
      */
+    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
     Action["Subscription"] = "subscription";
     /**
      * The **Explore** action on Liveboard visualizations
@@ -4436,13 +5122,25 @@ 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)
@@ -4530,14 +5228,27 @@ 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.
      *
@@ -5287,6 +5998,22 @@ 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
+ */
 var ContextType;
 (function (ContextType) {
     /**
@@ -5305,6 +6032,10 @@ 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
@@ -8234,6 +8965,13 @@ var UIPassthroughEvent;
     UIPassthroughEvent["GetAnswerConfig"] = "getAnswerPageConfig";
     UIPassthroughEvent["GetLiveboardConfig"] = "getPinboardPageConfig";
     UIPassthroughEvent["GetUnsavedAnswerTML"] = "getUnsavedAnswerTML";
+    UIPassthroughEvent["GetAnswerSession"] = "getAnswerSession";
+    UIPassthroughEvent["GetFilters"] = "getFilters";
+    UIPassthroughEvent["GetIframeUrl"] = "getIframeUrl";
+    UIPassthroughEvent["GetParameters"] = "getParameters";
+    UIPassthroughEvent["GetTML"] = "getTML";
+    UIPassthroughEvent["GetTabs"] = "getTabs";
+    UIPassthroughEvent["GetExportRequestForCurrentPinboard"] = "getExportRequestForCurrentPinboard";
 })(UIPassthroughEvent || (UIPassthroughEvent = {}));
 
 const EndPoints = {
@@ -8867,9 +9605,11 @@ const DATA_TYPES = ['DATE', 'DATE_TIME', 'TIME'];
  * You can use this service to:
  *
  * - Add or remove columns from Answers (`addColumns`, `removeColumns`,
- * `addColumnsByName`) - Apply filters to Answers (`addFilter`)
+ * `addColumnsByName`)
+ * - Apply filters to Answers (`addFilter`)
  * - Get data from Answers in different formats (JSON, CSV, PNG) (`fetchData`,
- * `fetchCSVBlob`, `fetchPNGBlob`) - Get data for specific points in visualizations
+ * `fetchCSVBlob`, `fetchPNGBlob`)
+ * - Get data for specific points in visualizations
  * (`getUnderlyingDataForPoint`)
  * - Run custom queries (`executeQuery`)
  * - Add visualizations to Liveboards (`addDisplayedVizToLiveboard`)
@@ -9163,7 +9903,7 @@ class AnswerService {
     async getTML() {
         const { object } = await this.executeQuery(getAnswerTML, {});
         const edoc = object[0].edoc;
-        const YAML = await import('./index-DyX-x6uN.js');
+        const YAML = await import('./index-DW2wEHqy.js');
         const parsedDoc = YAML.parse(edoc);
         return {
             answer: {
@@ -17618,7 +18358,8 @@ var AuthFailureType;
     /**
      * The current authentication token or session has expired.
      *
-     * Emitted when the embed receives an auth-expiry signal and starts auth refresh handling.
+     * Emitted when the embed receives an auth-expiry signal and starts auth refresh
+     * handling.
      */
     AuthFailureType["EXPIRY"] = "EXPIRY";
     /**
@@ -18465,11 +19206,25 @@ function processEventData(type, eventData, thoughtSpotHost, containerEl) {
     return eventData;
 }
 
-var name="@thoughtspot/visual-embed-sdk";var version$1="1.46.3";var description="ThoughtSpot Embed SDK";var module="lib/src/index.js";var main="dist/tsembed.js";var types="lib/src/index.d.ts";var files=["dist/**","lib/**","src/**","cjs/**"];var exports={".":{"import":"./lib/src/index.js",require:"./cjs/src/index.js",types:"./lib/src/index.d.ts"},"./react":{"import":"./lib/src/react/all-types-export.js",require:"./cjs/src/react/all-types-export.js",types:"./lib/src/react/all-types-export.d.ts"},"./lib/src/react":{"import":"./lib/src/react/all-types-export.js",require:"./cjs/src/react/all-types-export.js",types:"./lib/src/react/all-types-export.d.ts"}};var typesVersions={"*":{react:["./lib/src/react/all-types-export.d.ts"]}};var scripts={lint:"eslint 'src/**'","lint:fix":"eslint 'src/**/*.*' --fix",tsc:"tsc -p tsconfig.build.json --incremental false; tsc -p tsconfig.build.json --incremental false --module commonjs --outDir cjs","build-and-publish":"npm run build:gatsby && npm run publish","bundle-dts-file":"dts-bundle-generator --config ./dts-config/dts-bundle-file.config.js","bundle-dts":"dts-bundle-generator --config ./dts-config/dts-bundle.config.js","bundle-dts-react":"dts-bundle-generator --config ./dts-config/dts-bundle-react.config.js","bundle-dts-react-full":"dts-bundle-generator --config ./dts-config/dts-bundle-react-full.config.js",build:"rollup -c",watch:"rollup -cw",docgen:"typedoc --tsconfig tsconfig.build.json --theme typedoc-theme --json static/typedoc/typedoc.json --disableOutputCheck","test-sdk":"jest -c jest.config.sdk.js --runInBand",test:"npm run test-sdk",posttest:"cat ./coverage/sdk/lcov.info | npx coveralls-next || echo 'Warning: Coveralls upload failed but not breaking the build.'","is-publish-allowed":"node scripts/is-publish-allowed.js",prepublishOnly:"npm run is-publish-allowed && npm run test && npm run tsc && npm run bundle-dts-file && npm run bundle-dts && npm run bundle-dts-react && npm run bundle-dts-react-full && npm run build","check-size":"npm run build && size-limit","publish-dev":"npm publish --tag dev","publish-prod":"npm publish --tag latest",dev:"vite -c vite.local.config.ts"};var peerDependencies={react:"> 16.8.0","react-dom":"> 16.8.0"};var dependencies={classnames:"^2.3.1",eventemitter3:"^4.0.7",lodash:"^4.17.23","mixpanel-browser":"2.47.0","ts-deepmerge":"^6.0.2",tslib:"^2.5.3","use-deep-compare-effect":"^1.8.1",yaml:"^2.5.1"};var devDependencies={"@mdx-js/mdx":"^1.6.22","@mdx-js/react":"^1.6.22","@react-icons/all-files":"^4.1.0","@rollup/plugin-commonjs":"^18.0.0","@rollup/plugin-json":"^4.1.0","@rollup/plugin-node-resolve":"^11.2.1","@rollup/plugin-replace":"^5.0.2","@size-limit/preset-big-lib":"^11.2.0","@testing-library/dom":"^7.31.0","@testing-library/jest-dom":"^5.14.1","@testing-library/react":"^11.2.7","@testing-library/user-event":"^13.1.8","@types/jest":"^30.0.0","@types/lodash":"^4.17.0","@types/mixpanel-browser":"^2.35.6","@types/react-test-renderer":"^17.0.1","@typescript-eslint/eslint-plugin":"^8.28.0","@typescript-eslint/parser":"^8.28.0",ajv:"^8.17.1",asciidoctor:"^2.2.1","babel-jest":"^30.2.0","babel-preset-gatsby":"^1.10.0","command-line-args":"^5.1.1","coveralls-next":"^5.0.0",crypto:"^1.0.1","current-git-branch":"^1.1.0","dts-bundle-generator":"^9.5.1",eslint:"^9.23.0","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^10.1.1","eslint-import-resolver-typescript":"^4.2.5","eslint-plugin-comment-length":"2.2.1","eslint-plugin-import":"^2.31.0","eslint-plugin-jsdoc":"^50.6.9","eslint-plugin-prettier":"^5.2.5","eslint-plugin-react":"^7.37.5","eslint-plugin-react-hooks":"^5.2.0","fs-extra":"^10.0.0","gh-pages":"6.3.0",globals:"^16.0.0","highlight.js":"^10.6.0","html-to-text":"^8.0.0","identity-obj-proxy":"^3.0.0","istanbul-merge":"^2.0.0",jest:"^30.2.0","jest-environment-jsdom":"^29.7.0","jest-fetch-mock":"^3.0.3",jsdom:"^17.0.0",prettier:"2.1.2",react:"^16.14.0","react-dom":"^16.14.0","react-resizable":"^1.11.0","react-resize-detector":"^6.6.0","react-test-renderer":"^17.0.2","react-use-flexsearch":"^0.1.1",rollup:"4.24.0","rollup-plugin-typescript2":"0.27.3","ts-jest":"^29.4.6","ts-loader":"8.0.4",typedoc:"0.21.6","typedoc-plugin-toc-group":"thoughtspot/typedoc-plugin-toc-group",typescript:"^4.9.4","typescript-eslint":"^8.29.1","url-search-params-polyfill":"^8.1.0",util:"^0.12.4",vite:"^6.3.5"};var author="ThoughtSpot";var email="support@thoughtspot.com";var license="ThoughtSpot Development Tools End User License Agreement";var directories={lib:"lib"};var repository={type:"git",url:"git+https://github.com/thoughtspot/visual-embed-sdk.git"};var publishConfig={registry:"https://registry.npmjs.org"};var keywords=["thoughtspot","everywhere","embedded","embed","sdk","analytics"];var bugs={url:"https://github.com/thoughtspot/visual-embed-sdk/issues"};var homepage="https://github.com/thoughtspot/visual-embed-sdk#readme";var globals={window:{}};var pkgInfo = {name:name,version:version$1,description:description,module:module,main:main,types:types,files:files,exports:exports,typesVersions:typesVersions,"size-limit":[{path:"dist/tsembed.es.js",limit:"32 kB"}],scripts:scripts,peerDependencies:peerDependencies,dependencies:dependencies,devDependencies:devDependencies,author:author,email:email,license:license,directories:directories,repository:repository,publishConfig:publishConfig,keywords:keywords,bugs:bugs,homepage:homepage,globals:globals};
-
+var name="@thoughtspot/visual-embed-sdk";var version$1="1.46.5-beta.1";var description="ThoughtSpot Embed SDK";var module="lib/src/index.js";var main="dist/tsembed.js";var types="lib/src/index.d.ts";var files=["dist/**","lib/**","src/**","cjs/**"];var exports={".":{"import":"./lib/src/index.js",require:"./cjs/src/index.js",types:"./lib/src/index.d.ts"},"./react":{"import":"./lib/src/react/all-types-export.js",require:"./cjs/src/react/all-types-export.js",types:"./lib/src/react/all-types-export.d.ts"},"./lib/src/react":{"import":"./lib/src/react/all-types-export.js",require:"./cjs/src/react/all-types-export.js",types:"./lib/src/react/all-types-export.d.ts"}};var typesVersions={"*":{react:["./lib/src/react/all-types-export.d.ts"]}};var scripts={lint:"eslint 'src/**'","lint:fix":"eslint 'src/**/*.*' --fix",tsc:"tsc -p tsconfig.build.json --incremental false; tsc -p tsconfig.build.json --incremental false --module commonjs --outDir cjs","build-and-publish":"npm run build:gatsby && npm run publish","bundle-dts-file":"dts-bundle-generator --config ./dts-config/dts-bundle-file.config.js && node dts-config/wrap-ambient-module.mjs","bundle-dts":"dts-bundle-generator --config ./dts-config/dts-bundle.config.js","bundle-dts-react":"dts-bundle-generator --config ./dts-config/dts-bundle-react.config.js","bundle-dts-react-full":"dts-bundle-generator --config ./dts-config/dts-bundle-react-full.config.js",build:"rollup -c",watch:"rollup -cw",docgen:"typedoc --tsconfig tsconfig.build.json --theme typedoc-theme --json static/typedoc/typedoc.json --disableOutputCheck","test-sdk":"jest -c jest.config.sdk.js --runInBand",test:"npm run test-sdk",posttest:"cat ./coverage/sdk/lcov.info | npx coveralls-next || echo 'Warning: Coveralls upload failed but not breaking the build.'","is-publish-allowed":"node scripts/is-publish-allowed.js",prepublishOnly:"npm run tsc && npm run bundle-dts-file && npm run bundle-dts && npm run bundle-dts-react && npm run bundle-dts-react-full && npm run build","check-size":"npm run build && size-limit","publish-dev":"npm publish --tag dev","publish-prod":"npm publish --tag latest",dev:"vite -c vite.local.config.ts"};var peerDependencies={react:"> 16.8.0","react-dom":"> 16.8.0"};var dependencies={classnames:"^2.3.1",eventemitter3:"^4.0.7",lodash:"^4.17.23","mixpanel-browser":"2.47.0","ts-deepmerge":"^6.0.2",tslib:"^2.5.3","use-deep-compare-effect":"^1.8.1",yaml:"^2.5.1"};var devDependencies={"@mdx-js/mdx":"^1.6.22","@mdx-js/react":"^1.6.22","@react-icons/all-files":"^4.1.0","@rollup/plugin-commonjs":"^18.0.0","@rollup/plugin-json":"^4.1.0","@rollup/plugin-node-resolve":"^11.2.1","@rollup/plugin-replace":"^5.0.2","@size-limit/preset-big-lib":"^11.2.0","@testing-library/dom":"^7.31.0","@testing-library/jest-dom":"^5.14.1","@testing-library/react":"^11.2.7","@testing-library/user-event":"^13.1.8","@types/jest":"^30.0.0","@types/lodash":"^4.17.0","@types/mixpanel-browser":"^2.35.6","@types/react-test-renderer":"^17.0.1","@typescript-eslint/eslint-plugin":"^8.28.0","@typescript-eslint/parser":"^8.28.0",ajv:"^8.17.1",asciidoctor:"^2.2.1","babel-jest":"^30.2.0","babel-preset-gatsby":"^1.10.0","command-line-args":"^5.1.1","coveralls-next":"^5.0.0",crypto:"^1.0.1","current-git-branch":"^1.1.0","dts-bundle-generator":"^9.5.1",eslint:"^9.23.0","eslint-config-airbnb-base":"^15.0.0","eslint-config-prettier":"^10.1.1","eslint-import-resolver-typescript":"^4.2.5","eslint-plugin-comment-length":"2.2.1","eslint-plugin-import":"^2.31.0","eslint-plugin-jsdoc":"^50.6.9","eslint-plugin-prettier":"^5.2.5","eslint-plugin-react":"^7.37.5","eslint-plugin-react-hooks":"^5.2.0","fs-extra":"^10.0.0","gh-pages":"6.3.0",globals:"^16.0.0","highlight.js":"^10.6.0","html-to-text":"^8.0.0","identity-obj-proxy":"^3.0.0","istanbul-merge":"^2.0.0",jest:"^30.2.0","jest-environment-jsdom":"^29.7.0","jest-fetch-mock":"^3.0.3",jsdom:"^17.0.0",prettier:"2.1.2",react:"^16.14.0","react-dom":"^16.14.0","react-resizable":"^1.11.0","react-resize-detector":"^6.6.0","react-test-renderer":"^17.0.2","react-use-flexsearch":"^0.1.1",rollup:"4.24.0","rollup-plugin-typescript2":"0.27.3","ts-jest":"^29.4.6","ts-loader":"8.0.4",typedoc:"0.21.6","typedoc-plugin-toc-group":"thoughtspot/typedoc-plugin-toc-group",typescript:"^4.9.4","typescript-eslint":"^8.29.1","url-search-params-polyfill":"^8.1.0",util:"^0.12.4",vite:"^6.3.5"};var author="ThoughtSpot";var email="support@thoughtspot.com";var license="ThoughtSpot Development Tools End User License Agreement";var directories={lib:"lib"};var repository={type:"git",url:"git+https://github.com/thoughtspot/visual-embed-sdk.git"};var publishConfig={registry:"https://registry.npmjs.org"};var keywords=["thoughtspot","everywhere","embedded","embed","sdk","analytics"];var bugs={url:"https://github.com/thoughtspot/visual-embed-sdk/issues"};var homepage="https://github.com/thoughtspot/visual-embed-sdk#readme";var globals={window:{}};var pkgInfo = {name:name,version:version$1,description:description,module:module,main:main,types:types,files:files,exports:exports,typesVersions:typesVersions,"size-limit":[{path:"dist/tsembed.es.js",limit:"32 kB"}],scripts:scripts,peerDependencies:peerDependencies,dependencies:dependencies,devDependencies:devDependencies,author:author,email:email,license:license,directories:directories,repository:repository,publishConfig:publishConfig,keywords:keywords,bugs:bugs,homepage:homepage,globals:globals};
+
+/** Host events that use getDataWithPassthroughFallback (getter-style APIs) */
+const HOST_EVENT_PASSTHROUGH_MAP = {
+    [HostEvent.GetAnswerSession]: UIPassthroughEvent.GetAnswerSession,
+    [HostEvent.GetFilters]: UIPassthroughEvent.GetFilters,
+    [HostEvent.GetIframeUrl]: UIPassthroughEvent.GetIframeUrl,
+    [HostEvent.GetParameters]: UIPassthroughEvent.GetParameters,
+    [HostEvent.GetTML]: UIPassthroughEvent.GetTML,
+    [HostEvent.GetTabs]: UIPassthroughEvent.GetTabs,
+    [HostEvent.getExportRequestForCurrentPinboard]: UIPassthroughEvent.GetExportRequestForCurrentPinboard,
+};
 class HostEventClient {
     constructor(iFrame) {
         this.iFrame = iFrame;
+        this.customHandlers = {
+            [HostEvent.Pin]: (p, c) => this.handlePinEvent(p, c),
+            [HostEvent.SaveAnswer]: (p, c) => this.handleSaveAnswerEvent(p, c),
+        };
     }
     /**
      * A wrapper over process trigger to
@@ -18486,7 +19241,7 @@ class HostEventClient {
     }
     async handleHostEventWithParam(apiName, parameters, context) {
         var _a, _b, _c, _d;
-        const response = (_b = (_a = (await this.triggerUIPassthroughApi(apiName, parameters, context))) === null || _a === void 0 ? void 0 : _a.filter) === null || _b === void 0 ? void 0 : _b.call(_a, (r) => r.error || r.value)[0];
+        const response = (_b = (_a = (await this.triggerUIPassthroughApi(apiName, parameters, context))) === null || _a === void 0 ? void 0 : _a.find) === null || _b === void 0 ? void 0 : _b.call(_a, (r) => r.error || r.value);
         if (!response) {
             const error = `No answer found${parameters.vizId ? ` for vizId: ${parameters.vizId}` : ''}.`;
             throw { error };
@@ -18495,13 +19250,35 @@ class HostEventClient {
             || ((_c = response.value) === null || _c === void 0 ? void 0 : _c.errors)
             || ((_d = response.value) === null || _d === void 0 ? void 0 : _d.error);
         if (errors) {
-            throw { error: response.error };
+            const message = typeof errors === 'string' ? errors : JSON.stringify(errors);
+            throw { error: message };
         }
         return { ...response.value };
     }
     async hostEventFallback(hostEvent, data, context) {
         return this.processTrigger(hostEvent, data, context);
     }
+    /**
+     * For getter events that return data. Tries UI passthrough first;
+     * if the app doesn't support it (no response data), falls back to
+     * the legacy host event channel. Real errors are thrown as-is.
+     */
+    async getDataWithPassthroughFallback(passthroughEvent, hostEvent, payload, context) {
+        var _a, _b, _c;
+        const response = await this.triggerUIPassthroughApi(passthroughEvent, payload || {}, context);
+        const matched = (_a = response === null || response === void 0 ? void 0 : response.find) === null || _a === void 0 ? void 0 : _a.call(response, (r) => r.error || r.value);
+        if (!matched) {
+            return this.hostEventFallback(hostEvent, payload, context);
+        }
+        const errors = matched.error
+            || ((_b = matched.value) === null || _b === void 0 ? void 0 : _b.errors)
+            || ((_c = matched.value) === null || _c === void 0 ? void 0 : _c.error);
+        if (errors) {
+            const message = typeof errors === 'string' ? errors : JSON.stringify(errors);
+            throw new Error(message);
+        }
+        return { ...matched.value };
+    }
     /**
      * Setter for the iframe element used for host events
      * @param {HTMLIFrameElement} iFrame - the iframe element to set
@@ -18545,14 +19322,15 @@ class HostEventClient {
         };
     }
     async triggerHostEvent(hostEvent, payload, context) {
-        switch (hostEvent) {
-            case HostEvent.Pin:
-                return this.handlePinEvent(payload, context);
-            case HostEvent.SaveAnswer:
-                return this.handleSaveAnswerEvent(payload, context);
-            default:
-                return this.hostEventFallback(hostEvent, payload, context);
+        const customHandler = this.customHandlers[hostEvent];
+        if (customHandler) {
+            return customHandler(payload, context);
+        }
+        const passthroughEvent = HOST_EVENT_PASSTHROUGH_MAP[hostEvent];
+        if (passthroughEvent) {
+            return this.getDataWithPassthroughFallback(passthroughEvent, hostEvent, payload, context);
         }
+        return this.hostEventFallback(hostEvent, payload, context);
     }
 }
 
@@ -19843,7 +20621,21 @@ class TsEmbed {
      * Triggers an event to the embedded app
      * @param {HostEvent} messageType The event type
      * @param {any} data The payload to send with the message
+     * @param {ContextType} context Optional context type to specify the context from which the event is triggered.
+     * Use ContextType.Search for search answer context, ContextType.Answer for answer/explore context,
+     * ContextType.Liveboard for liveboard context, or ContextType.Spotter for spotter context.
+     * Available from SDK version 1.45.2 | ThoughtSpot: 26.3.0.cl
      * @returns A promise that resolves with the response from the embedded app
+     * @example
+     * ```js
+     * // Trigger Pin event with context (SDK: 1.45.2+)
+     * import { HostEvent, ContextType } from '@thoughtspot/visual-embed-sdk';
+     * embed.trigger(HostEvent.Pin, {
+     *   vizId: "123",
+     *   liveboardId: "456"
+     * }, ContextType.Search);
+     * ```
+     * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl (for context parameter)
      */
     async trigger(messageType, data = {}, context) {
         uploadMixpanelEvent(`${MIXPANEL_EVENT.VISUAL_SDK_TRIGGER}-${messageType}`);
@@ -19906,8 +20698,33 @@ class TsEmbed {
         return this.render();
     }
     /**
-     * Get the current context of the embedded TS component.
-     * @returns The current context object containing the page type and object ids.
+    * Context object for the embedded component.
+    * @returns {ContextObject} The current context object containing the page type and object ids.
+    * @example
+    * ```js
+    * const context = await embed.getCurrentContext();
+    * console.log(context);
+    *
+    * // Example output
+    * {
+    *   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
      */
     async getCurrentContext() {
@@ -20731,13 +21548,22 @@ let AppEmbed$1 = class AppEmbed extends V1Embed {
             const visibleCoordinatesData = calculateVisibleElementData(this.iFrame);
             responder({ type: EmbedEvent.RequestVisibleEmbedCoordinates, data: visibleCoordinatesData });
         };
+        this.HEIGHT_CHANAGE_THRESHOLD = 30;
         /**
          * Set the iframe height as per the computed height received
          * from the ThoughtSpot app.
          * @param data The event payload
          */
         this.updateIFrameHeight = (data) => {
-            this.setIFrameHeight(Math.max(data.data, this.defaultHeight));
+            logger$3.error('Updating iframe height', data);
+            const currentHeight = this.iFrame.getBoundingClientRect().height;
+            const heightToSet = Math.max(data.data, this.defaultHeight);
+            const heightChange = Math.abs(heightToSet - currentHeight);
+            if (heightChange < this.HEIGHT_CHANAGE_THRESHOLD) {
+                logger$3.info('Height change is less than the threshold, skipping height update', { heightChange, heightToSet, currentHeight });
+                return;
+            }
+            this.setIFrameHeight(heightToSet);
             this.sendFullHeightLazyLoadData();
         };
         this.embedIframeCenter = (data, responder) => {
@@ -21196,13 +22022,21 @@ let LiveboardEmbed$1 = class LiveboardEmbed extends V1Embed {
             const visibleCoordinatesData = calculateVisibleElementData(this.iFrame);
             responder({ type: EmbedEvent.RequestVisibleEmbedCoordinates, data: visibleCoordinatesData });
         };
+        this.HEIGHT_CHANAGE_THRESHOLD = 30;
         /**
          * Set the iframe height as per the computed height received
          * from the ThoughtSpot app.
          * @param data The event payload
          */
         this.updateIFrameHeight = (data) => {
-            this.setIFrameHeight(Math.max(data.data, this.defaultHeight));
+            const currentHeight = this.iFrame.getBoundingClientRect().height;
+            const heightToSet = Math.max(data.data, this.defaultHeight);
+            const heightChange = Math.abs(heightToSet - currentHeight);
+            if (heightChange < this.HEIGHT_CHANAGE_THRESHOLD) {
+                logger$3.info('Height change is less than the threshold, skipping height update', { heightChange, heightToSet, currentHeight });
+                return;
+            }
+            this.setIFrameHeight(heightToSet);
             this.sendFullHeightLazyLoadData();
         };
         this.embedIframeCenter = (data, responder) => {
@@ -21368,7 +22202,8 @@ let LiveboardEmbed$1 = class LiveboardEmbed extends V1Embed {
     }
     getIframeSuffixSrc(liveboardId, vizId, activeTabId, personalizedViewId) {
         // Extract view from liveboardId if passed along with it (legacy
-        // approach) View must be appended as query param at the end, not
+        // approach)
+        // View must be appended as query param at the end, not
         // embedded in path
         let liveboardGuid = liveboardId;
         let legacyViewId;
@@ -22222,60 +23057,64 @@ const componentFactory = (EmbedConstructor,
 // intended for preRendering. If set to true, the component will call the
 // Embed.preRender() method instead of the usual render method, and it will
 // not be destroyed when the component is unmounted.
-isPreRenderedComponent = false) => React__default.forwardRef((props, forwardedRef) => {
-    const ref = React__default.useRef(null);
-    const { className, style, ...embedProps } = props;
-    const { viewConfig, listeners } = getViewPropsAndListeners(embedProps);
-    const handleDestroy = (tsEmbed) => {
-        // do not destroy if it is a preRender component
-        if (isPreRenderedComponent)
-            return;
-        // if component is connected to a preRendered component
-        if (props.preRenderId) {
-            tsEmbed.hidePreRender();
-            return;
-        }
-        tsEmbed.destroy();
-    };
-    const handlePreRenderRendering = (tsEmbed) => {
-        tsEmbed.preRender();
-    };
-    const handleDefaultRendering = (tsEmbed) => {
-        // if component is connected to a preRendered component
-        if (props.preRenderId) {
-            tsEmbed.showPreRender();
-            return;
-        }
-        tsEmbed.render();
-    };
-    const handleRendering = (tsEmbed) => {
-        if (isPreRenderedComponent) {
-            handlePreRenderRendering(tsEmbed);
-            return;
-        }
-        handleDefaultRendering(tsEmbed);
-    };
-    useDeepCompareEffect(() => {
-        const tsEmbed = new EmbedConstructor(ref.current, deepMerge({
-            insertAsSibling: viewConfig.insertAsSibling,
-            frameParams: {
-                class: viewConfig.insertAsSibling ? className || '' : '',
-            },
-        }, viewConfig));
-        Object.keys(listeners).forEach((eventName) => {
-            tsEmbed.on(eventName, listeners[eventName]);
-        });
-        handleRendering(tsEmbed);
-        if (forwardedRef) {
-            forwardedRef.current = tsEmbed;
-        }
-        return () => {
-            handleDestroy(tsEmbed);
+isPreRenderedComponent = false) => {
+    const Component = React__default.forwardRef((props, forwardedRef) => {
+        const ref = React__default.useRef(null);
+        const { className, style, ...embedProps } = props;
+        const { viewConfig, listeners } = getViewPropsAndListeners(embedProps);
+        const handleDestroy = (tsEmbed) => {
+            // do not destroy if it is a preRender component
+            if (isPreRenderedComponent)
+                return;
+            // if component is connected to a preRendered component
+            if (props.preRenderId) {
+                tsEmbed.hidePreRender();
+                return;
+            }
+            tsEmbed.destroy();
         };
-    }, [viewConfig, listeners]);
-    const preRenderStyles = isPreRenderedComponent ? { display: 'none' } : {};
-    return viewConfig.insertAsSibling ? (React__default.createElement("span", { "data-testid": "tsEmbed", ref: ref, style: { position: 'absolute', ...preRenderStyles } })) : (React__default.createElement("div", { "data-testid": "tsEmbed", ref: ref, style: { ...style, ...preRenderStyles }, className: `ts-embed-container ${className}` }));
-});
+        const handlePreRenderRendering = (tsEmbed) => {
+            tsEmbed.preRender();
+        };
+        const handleDefaultRendering = (tsEmbed) => {
+            // if component is connected to a preRendered component
+            if (props.preRenderId) {
+                tsEmbed.showPreRender();
+                return;
+            }
+            tsEmbed.render();
+        };
+        const handleRendering = (tsEmbed) => {
+            if (isPreRenderedComponent) {
+                handlePreRenderRendering(tsEmbed);
+                return;
+            }
+            handleDefaultRendering(tsEmbed);
+        };
+        useDeepCompareEffect(() => {
+            const tsEmbed = new EmbedConstructor(ref.current, deepMerge({
+                insertAsSibling: viewConfig.insertAsSibling,
+                frameParams: {
+                    class: viewConfig.insertAsSibling ? className || '' : '',
+                },
+            }, viewConfig));
+            Object.keys(listeners).forEach((eventName) => {
+                tsEmbed.on(eventName, listeners[eventName]);
+            });
+            handleRendering(tsEmbed);
+            if (forwardedRef) {
+                forwardedRef.current = tsEmbed;
+            }
+            return () => {
+                handleDestroy(tsEmbed);
+            };
+        }, [viewConfig, listeners]);
+        const preRenderStyles = isPreRenderedComponent ? { display: 'none' } : {};
+        return viewConfig.insertAsSibling ? (React__default.createElement("span", { "data-testid": "tsEmbed", ref: ref, style: { position: 'absolute', ...preRenderStyles } })) : (React__default.createElement("div", { "data-testid": "tsEmbed", ref: ref, style: { ...style, ...preRenderStyles }, className: `ts-embed-container ${className}` }));
+    });
+    Component.displayName = EmbedConstructor.name || 'EmbedComponent';
+    return Component;
+};
 /**
  * React component for Search Embed.
  * @example
@@ -22489,6 +23328,7 @@ const SpotterMessage = React__default.forwardRef((props, ref) => {
     const { message, query: _, ...otherProps } = props;
     return (React__default.createElement(ConversationMessage, { ref: ref, ...message, ...otherProps }));
 });
+SpotterMessage.displayName = 'SpotterMessage';
 /**
  * React component for PreRendered Conversation embed.
  *