@thoughtspot/visual-embed-sdk 1.26.2 → 1.27.0-alpha.0

package/dist/src/types.d.ts

@@ -29,10 +29,14 @@ export declare enum AuthType {
      */
     None = "None",
     /**
-     * Passthrough SSO to the embedded App within the iframe. Requires least
+     * Passthrough SSO to the embedded application within the iframe. Requires least
      * configuration, but may not be supported by all IDPs. This will behave like `None`
      * if SSO is not configured on ThoughtSpot.
      *
+     * To use this:
+     * Your SAML or OpenID provider must allow iframe redirects.
+     * For example, if you are using Okta as IdP, you can enable iframe embedding.
+     *
      * @example
      * ```js
      * init({
@@ -40,12 +44,7 @@ export declare enum AuthType {
      *   authType: AuthType.EmbeddedSSO,
      *  });
      * ```
-     * Set authentication type as Embedded SSO.
-     *
-     * To use this:
-     * Your SAML or OpenID provider must allow iframe redirects.
-     * eg. If you are using okta as IdP, you can enable iFrame embedding.
-     * @version: SDK: 1.15.0 | ThouhgtSpot: 8.8.0.cl
+     * @version: SDK: 1.15.0 | ThoughtSpot: 8.8.0.cl
      */
     EmbeddedSSO = "EmbeddedSSO",
     /**
@@ -64,10 +63,10 @@ export declare enum AuthType {
     SAML = "SSO_SAML",
     /**
      * SSO using SAML
-     * Will make the host application redirect to the SAML Idp. Use this
-     * when the idp does not allow itself to be embedded.
+     * Makes the host application redirect to the SAML IdP. Use this
+     * if your IdP does not allow itself to be embedded.
      *
-     * This redirects the host application to the SAML Idp. The host application
+     * This redirects the host application to the SAML IdP. The host application
      * will be redirected back to the ThoughtSpot app after authentication.
      *
      * @example
@@ -78,7 +77,7 @@ export declare enum AuthType {
      *  });
      * ```
      *
-     * This opens the SAML Idp in a popup window. The popup is triggered
+     * This opens the SAML IdP in a popup window. The popup is triggered
      * when the user clicks the trigger button. The popup window will be
      * closed automatically after authentication.
      * @example
@@ -92,8 +91,8 @@ export declare enum AuthType {
      * });
      * ```
      *
-     * Can also use event to trigger the popup flow. Works the same
-     * as above example.
+     * Can also use the event to trigger the popup flow. Works the same
+     * as the above example.
      * @example
      * ```js
      * const authEE = init({
@@ -117,7 +116,7 @@ export declare enum AuthType {
     OIDC = "SSO_OIDC",
     /**
      * SSO using OIDC
-     * Will make the host application redirect to the OIDC Idp.
+     * Will make the host application redirect to the OIDC IdP.
      * See code samples in {@link SAMLRedirect}.
      */
     OIDCRedirect = "SSO_OIDC",
@@ -129,8 +128,8 @@ export declare enum AuthType {
      */
     AuthServer = "AuthServer",
     /**
-     * Trusted authentication server, Use your own authentication server
-     * which returns a bearer token, generated using the secret_key obtained
+     * Trusted authentication server. Use your own authentication server
+     * which returns a bearer token, generated using the `secret_key` obtained
      * from ThoughtSpot.
      *
      * @example
@@ -147,11 +146,11 @@ export declare enum AuthType {
      */
     TrustedAuthToken = "AuthServer",
     /**
-     * Trusted authentication server Cookieless, Use you own authentication
-     * server which returns a bearer token, generated using the secret_key
+     * Trusted authentication server Cookieless, Use your own authentication
+     * server which returns a bearer token, generated using the `secret_key`
      * obtained from ThoughtSpot. This uses a cookieless authentication
-     * approach, recommended to by pass third-party cookie-blocking restriction
-     * implemented by some browsers
+     * approach, recommended to bypass the third-party cookie-blocking restriction
+     * implemented by some browsers.
      *
      * @example
      * ```js
@@ -164,7 +163,7 @@ export declare enum AuthType {
      *      .then((data) => data.token);
      *  }
      * ```
-     * @version SDK: 1.22.0| ThouhgtSpot: 9.3.0.cl, 9.5.1.sw
+     * @version SDK: 1.22.0| ThoughtSpot: 9.3.0.cl, 9.5.1.sw
      */
     TrustedAuthTokenCookieless = "AuthServerCookieless",
     /**
@@ -286,13 +285,19 @@ export interface EmbedConfig {
      * The ThoughtSpot cluster hostname or IP address.
      */
     thoughtSpotHost: string;
+    /**
+     * If true, all the iframe links will have /v2 added automatically.
+     * If false, all the iframe links will have /v1 added automatically.
+     * If undefined, nothing will be added
+     */
+    enableReactShell?: boolean | undefined;
     /**
      * The authentication mechanism to use.
      */
     authType: AuthType;
     /**
      * [AuthServer] The trusted authentication endpoint to use to get the
-     * authentication token. A GET request is made to the
+     * authentication token. A `GET` request is made to the
      * authentication API endpoint, which  returns the token
      * as a plaintext response. For trusted authentication,
      * the `authEndpoint` or `getAuthToken` attribute is required.
@@ -305,8 +310,8 @@ export interface EmbedConfig {
      * attribute is required.
      *
      * It is advisable to fetch a new token inside this method and not
-     * reuse and older issued token, as because when auth expires this is
-     * called again and if it is called with an older token the authentication
+     * reuse the old issued token. When auth expires this method is
+     * called again and if it is called with an older token, the authentication
      * will not succeed.
      */
     getAuthToken?: () => Promise<string>;
@@ -316,7 +321,7 @@ export interface EmbedConfig {
      */
     username?: string;
     /**
-     * [Basic] The ThoughtSpot login password corresponding to the user name
+     * [Basic] The ThoughtSpot login password corresponding to the username
      *
      * Warning: This feature is primarily intended for developer testing. It is
      * strongly advised not to use this authentication method in production.
@@ -324,7 +329,7 @@ export interface EmbedConfig {
     password?: string;
     /**
      * [SSO] For SSO Authentication, if `noRedirect` is set to true, it will
-     * open the SAML auth flow in a popup, instead of redirecting browser in
+     * open the SAML auth flow in a popup, instead of redirecting the browser in
      * place.
      *
      * @default false
@@ -333,91 +338,93 @@ export interface EmbedConfig {
     noRedirect?: boolean;
     /**
      * [SSO] For SSO Authentication, if `inPopup` is set to true, it will open
-     * the SAML auth flow in a popup, instead of redirecting browser in place.
+     * the SAML auth flow in a popup, instead of redirecting the browser in place.
      *
-     * Need to use this with authTriggerContainer. Or manually trigger
-     * the AuthEvent.TRIGGER_SSO_POPUP event on a user interaction.
+     * Need to use this with `authTriggerContainer`. Or manually trigger
+     * the `AuthEvent.TRIGGER_SSO_POPUP` event on a user interaction.
      *
      * @default false
      * @version SDK: 1.18.0
      */
     inPopup?: boolean;
     /**
-     * [SSO] For SSO Authentication, one can supply an optional path param,
-     * this will be the path on the host origin where the SAML flow will be
+     * [SSO] For SSO Authentication, one can supply an optional path param;
+     * This will be the path on the host origin where the SAML flow will be
      * terminated.
      *
      * Eg: "/dashboard", "#/foo" [Do not include the host]
      *
-     * @version SDK: 1.10.2 | 8.2.0.cl, 8.4.1.sw
+     * @version SDK: 1.10.2 | ThoughtSpot 8.2.0.cl, 8.4.1.sw
      */
     redirectPath?: string;
     /** @internal */
     basepath?: string;
     /**
-     * Should we encode URL Query Params using base64 encoding which thoughtspot
-     * will generate for embedding. This provides additional security to
-     * thoughtspot clusters against Cross site scripting attacks.
+     * Boolean to define if the query parameters in the ThoughtSpot URL
+     * should be encoded in base64. This provides additional security to
+     * Thoughtspot clusters against cross-site scripting attacks.
      *
      * @default false
      */
     shouldEncodeUrlQueryParams?: boolean;
     /**
-     * Suppress cookie access alert when third party cookies are blocked by the
-     * user's browser. Third party cookie blocking is the default behaviour on
-     * Safari and opt-in for Firefox/Chrome. If you set this to `true`, you are
-     * encouraged to handle `noCookieAccess` event, to show your own treatment
+     * Suppress cookie access alert when third-party cookies are blocked by the
+     * user's browser. Third-party cookie blocking is the default behaviour on
+     * some web browsers like Safari. If you set this attribute to `true`,
+     * you are encouraged to handle `noCookieAccess` event, to show your own treatment
      * in this case.
      *
      * @default false
      */
     suppressNoCookieAccessAlert?: boolean;
     /**
-     * Ignore cookie access alert when third party cookies are blocked by the
+     * Ignore the cookie access alert when third-party cookies are blocked by the
      * user's browser. If you set this to `true`, the embedded iframe behaviour
-     * persist even in case of non logged in user.
+     * persists even in the case of a non-logged-in user.
      *
      * @default false
      */
     ignoreNoCookieAccess?: boolean;
     /**
-     * Re-login when session expires with the previous login options
+     * Re-login a user with the previous login options
+     * when a user session expires.
      *
      * @default false
      */
     autoLogin?: boolean;
     /**
      * Disable redirection to the login page when the embedded session expires
-     * This flag is typically used alongside the combination of auth modes such as {@link
-     * AuthType.AuthServer} and auto login behavior {@link EmbedConfig.autoLogin}
+     * This flag is typically used alongside the combination of authentication modes such
+     * as {@link AuthType.AuthServer} and auto-login behavior {@link
+     * EmbedConfig.autoLogin}
      *
      * @version SDK: 1.9.3 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
      * @default false
      */
     disableLoginRedirect?: boolean;
     /**
-     * This message is displayed on the embed view when the login fails.
+     * This message is displayed in the embedded view when a user login fails.
      *
      * @version SDK: 1.10.1 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
      */
     loginFailedMessage?: string;
     /**
-     * Calls the prefetch method internally when set to true
+     * Calls the prefetch method internally when set to `true`
      *
      * @default false
      */
     callPrefetch?: boolean;
     /**
-     * When there are multiple embeds, queue the render of embed to start
-     *  after the previous embed's render is complete. This helps in the load
-     *  performance by decreasing the load on the browser.
+     * When there are multiple objects embedded, queue the rendering of embedded objects
+     * to start after the previous embed's render is complete. This helps improve
+     * performance by decreasing the load on the browser.
      *
      *  @Version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      * @default false
      */
     queueMultiRenders?: boolean;
     /**
-     * Dynamic CSS Url to be injected in the loaded application.
+     * Dynamic CSS URL to be injected in the loaded application.
      * You would also need to set `style-src` in the CSP settings.
      *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
@@ -425,9 +432,9 @@ export interface EmbedConfig {
      */
     customCssUrl?: string;
     /**
-     * [AuthServer|Basic] Detect if 3rd party cookies are enabled by doing an
+     * [AuthServer|Basic] Detect if third-party party cookies are enabled by doing an
      * additional call. This is slower and should be avoided. Listen to the
-     * NO_COOKIE_ACCESS event to handle the situation.
+     * `NO_COOKIE_ACCESS` event to handle the situation.
      *
      * This is slightly slower than letting the browser handle the cookie check, as it
      * involves an extra network call.
@@ -436,26 +443,26 @@ export interface EmbedConfig {
      */
     detectCookieAccessSlow?: boolean;
     /**
-     * Hide beta alert warning message for SearchEmbed.
+     * Hide the `beta` alert warning message for SearchEmbed.
      *
      * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw*
      */
     suppressSearchEmbedBetaWarning?: boolean;
     /**
-     * Hide beta alert warning message for SageEmbed.
+     * Hide `beta` alert warning message for SageEmbed.
      *
      */
     suppressSageEmbedBetaWarning?: boolean;
     /**
      * Custom style params for embed Config.
      *
-     * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl
+     * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
      */
     customizations?: CustomisationsInterface;
     /**
-     * For inPopup SAMLRedirect or OIDCRedirect Auth, we need a button which the user
-     * click to trigger the flow. This is the containing element
-     * for that button.
+     * For `inPopup` SAMLRedirect or OIDCRedirect authentication, we need a
+     * button that the user can click to trigger the flow.
+     * This attribute sets a containing element for that button.
      *
      * @example
      * ```js
@@ -465,11 +472,11 @@ export interface EmbedConfig {
      *   authTriggerContainer: '#auth-trigger-container'
      * })
      * ```
-     * @version SDK: 1.17.0 | ThoughtSpot: *
+     * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
      */
     authTriggerContainer?: string | HTMLElement;
     /**
-     * Specify that we want to use the AuthEvent.TRIGGER_SSO_POPUP event to trigger
+     * Specify that we want to use the `AuthEvent.TRIGGER_SSO_POPUP` event to trigger
      * SAML popup. This is useful when you want to trigger the popup on a custom user
      * action.
      *
@@ -477,20 +484,22 @@ export interface EmbedConfig {
     useEventForSAMLPopup?: boolean;
     /**
      * Text to show in the button which triggers the popup auth flow.
-     * Default: "Authorize".
+     * Default: `Authorize`.
      *
-     * @version SDK: 1.17.0 | ThoughtSpot: *
+     * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
      */
     authTriggerText?: string;
     /**
-     * Disable Full App access of Embedded app outside of the iFrame.
+     * Prevent users from accessing the full application or ThoughtSpot application pages
+     * access to the embedded application users
+     * outside of the iframe.
      *
      * @default true
      * @version SDK: 1.22.0 | ThoughtSpot: 9.3.0.cl, 9.5.1.sw
      */
     blockNonEmbedFullAppAccess?: boolean;
     /**
-     * Host config incase embedded app is inside TS app itself
+     * Host config in case embedded app is inside TS app itself
      *
      * @hidden
      */
@@ -516,17 +525,17 @@ export interface EmbedConfig {
 export interface LayoutConfig {
 }
 /**
- * Embedded iFrame configuration
+ * Embedded iframe configuration
  *
  * @group Embed components
  */
 export interface FrameParams {
     /**
-     * The width of the iFrame (unit is pixels if numeric).
+     * The width of the iframe (unit is pixels if numeric).
      */
     width?: number | string;
     /**
-     * The height of the iFrame (unit is pixels if numeric).
+     * The height of the iframe (unit is pixels if numeric).
      */
     height?: number | string;
     /**
@@ -627,7 +636,6 @@ export interface ViewConfig {
      */
     runtimeParameters?: RuntimeParameter[];
     /**
-     /**
      * The locale/language to use for the embedded view.
      *
      * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
@@ -727,31 +735,29 @@ export interface ViewConfig {
      */
     reorderedHomepageModules?: HomepageModule[];
     /**
-     * The list of tab IDs to show in the embedded.
-     * Only this Tabs will be shown in their respective LBs.
-     * Use this to show an tabID.
+     * The list of tab IDs to show in the embedded Liveboard.
+     * Only the tabs specified in the array will be shown in the Liveboard.
      *
-     * Use either this or hiddenTabs.
+     * Use either `visibleTabs` or `hiddenTabs`.
      *
      * @example
      * ```js
-     * const embed = new LiveboardEmbed('#embed', {
-     *   ... // other liveboard view config
-     *   visibleTabs: [
+     * visibleTabs: [
      * '430496d6-6903-4601-937e-2c691821af3c',
-     *  'f547ec54-2a37-4516-a222-2b06719af726']
-     * });
+     * 'f547ec54-2a37-4516-a222-2b06719af726']
      * ```
      * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
      */
     visibleTabs?: string[];
     /**
-     * homepageLeftNavItems : show/hide Homeapage Left Nav Bar Items
-     * There are 8 home nav list items, we will send those item as list
-     * which we want to hide for TSE.
-     * eg: hiddenHomeLeftNavItems = [HomeLeftNavItem.Home] to hide home.
+     * homepageLeftNavItems : Show or hide the left navigation bar items.
+     * There are 8 eight home navigation list items.
+     * To hide these items, specify the string in the array.
      *
-     * @version SDK: 1.27.0 | Thoughtspot: 9.8.0.cl
+     * ```js
+     * hiddenHomeLeftNavItems = [HomeLeftNavItem.Home]
+     * ```
+     * @version SDK: 1.27.0 | Thoughtspot: 9.10.0.cl
      */
     hiddenHomeLeftNavItems?: HomeLeftNavItem[];
     /**
@@ -767,7 +773,7 @@ export interface ViewConfig {
      * });
      * embed.showPreRender();
      * ```
-     * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
+     * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl, 9.8.0.sw
      */
     preRenderId?: string;
     /**
@@ -800,7 +806,7 @@ export type MessagePayload = {
     status?: string;
 };
 /**
- * MessageOptions: By Providing options, getting specific event start / end based on
+ * MessageOptions: By providing options, getting specific event start / end based on
  * option
  *
  * @group Events
@@ -808,7 +814,7 @@ export type MessagePayload = {
 export type MessageOptions = {
     /**
      *  A boolean value indicating that start status events of this type
-     *  will be dispatched
+     *  will be dispatched.
      */
     start?: boolean;
 };
@@ -828,7 +834,7 @@ responder?: (data: any) => void) => void;
  */
 export type MessageCallbackObj = {
     /**
-     *  options: It contains start, A boolean value indicating that start
+     *  options: It contains start, a boolean value indicating that start
      *  status events of this type will be dispatched
      */
     options: MessageOptions;
@@ -900,7 +906,7 @@ export declare enum RuntimeFilterOp {
     IN = "IN"
 }
 /**
- * Home page module that can be hide
+ * Home page module that can be hidden
  */
 export declare enum HomepageModule {
     /**
@@ -916,7 +922,7 @@ export declare enum HomepageModule {
      */
     Favorite = "FAVORITE",
     /**
-     * List of answers and liveboards
+     * List of answers and Liveboards
      */
     MyLibrary = "MY_LIBRARY",
     /**
@@ -949,7 +955,7 @@ export interface RuntimeFilter {
     values: (number | boolean | string)[];
 }
 /**
- * A filter that can be applied to ThoughtSpot answers, Liveboards, or
+ * A filter that can be applied to ThoughtSpot Answers, Liveboards, or
  * visualizations at runtime.
  */
 export interface RuntimeParameter {
@@ -985,6 +991,14 @@ export interface RuntimeParameter {
 export declare enum EmbedEvent {
     /**
      * Rendering has initialized.
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Init, showLoader)
+     *  //show a loader
+     * function showLoader() {
+     * document.getElementById("loader");
+     * }
+     *```
      *
      * @returns timestamp - The timestamp when the event was generated.
      */
@@ -992,69 +1006,162 @@ export declare enum EmbedEvent {
     /**
      * Authentication has either succeeded or failed.
      *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.AuthInit, payload => {
+     *    console.log('AuthInit', payload);
+     * })
+     *```
+     *
      * @returns isLoggedIn - A Boolean specifying whether authentication was successful.
      */
     AuthInit = "authInit",
     /**
      * The embed object container has loaded.
-     *
      * @returns timestamp - The timestamp when the event was generated.
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Load, hideLoader)
+     *    //hide loader
+     * function hideLoader() {
+     *   document.getElementById("loader");
+     * }
+     *```
      */
     Load = "load",
     /**
      * Data pertaining to answer or Liveboard is received
-     *
      * @return data - The answer or Liveboard data
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Data, payload => {
+     *    console.log('data', payload);
+     * })
+     *```
      * @important
      */
     Data = "data",
     /**
-     * Search/answer/Liveboard filters have been applied/updated by the user.
+     * Search/Answer/Liveboard filters have been applied/updated by the user.
      *
      * @hidden
      */
     FiltersChanged = "filtersChanged",
     /**
      * Search query has been updated by the user.
+     *
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.QueryChanged, payload => console.log('data', payload))
+     *```
+     *
      */
     QueryChanged = "queryChanged",
     /**
-     * A drill down operation has been performed.
+     * A drill-down operation has been performed.
      *
      * @returns additionalFilters - Any additional filters applied
      * @returns drillDownColumns - The columns on which drill down was performed
      * @returns nonFilteredColumns - The columns that were not filtered
+     *
+     * @example
+     *```js
+     * searchEmbed.trigger(HostEvent.DrillDown, {
+     *    points: {
+     *        clickedPoint,
+     *        selectedPoints: selectedPoint
+     *    },
+     *    autoDrillDown: true,
+     * })
+     *```
+     * In this example, `VizPointDoubleClick` event is used for
+     * triggering the `DrillDown` event when an area or specific
+     * data point on a table or chart is double-clicked.
+     *
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
+     *   console.log(payload);
+     *   const clickedPoint = payload.data.clickedPoint;
+     *   const selectedPoint = payload.data.selectedPoints;
+     *   console.log('>>> called', clickedPoint);
+     *   embed.trigger(HostEvent.DrillDown, {
+     *      points: {
+     *      clickedPoint,
+     *          selectedPoints: selectedPoint
+     *     },
+     *   autoDrillDown: true,
+     *     })
+     * })
+     *```
+     *
      */
     Drilldown = "drillDown",
     /**
      * One or more data sources have been selected.
-     *
      * @returns dataSourceIds - the list of data sources
+     *
+     * @example
+     * ```js
+     * searchEmbed.on(EmbedEvent.DataSourceSelected, payload => {
+     *    console.log('DataSourceSelected', payload);
+     * })
+     * ```
+     *
      */
     DataSourceSelected = "dataSourceSelected",
     /**
      * One or more data columns have been selected.
-     *
      * @returns columnIds - the list of columns
      * @version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
+     *
+     * @example
+     * ```js
+     * appEmbed.on(EmbedEvent.AddRemoveColumns, payload => {
+     *   console.log('AddRemoveColumns', payload);
+     * })
+     * ```
+     *
      */
     AddRemoveColumns = "addRemoveColumns",
     /**
-     * A custom action has been triggered
+     * A custom action has been triggered.
      *
-     * @returns actionId - The id of the custom action
-     * @returns data - The answer or Liveboard data
+     * @returns actionId - ID of the custom action
+     * @returns data - Response payload with the Answer or Liveboard data
+     *
+     * @example
+     * ```js
+     * appEmbed.on(EmbedEvent.customAction, payload => {
+     *     const data = payload.data;
+     *     if (data.id === 'insert Custom Action ID here') {
+     *         console.log('Custom Action event:', data.embedAnswerData);
+     *     }
+     * })
+     * ```
      */
     CustomAction = "customAction",
     /**
-     * Listen to double clicks on a visualization
+     * Listen to double click actions on a visualization.
+     *
+     * @return ContextMenuInputPoints - Data point that is double-clicked
      *
-     * @return ContextMenuInputPoints - data point that is double clicked
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
+     *
+     * @example
+     * ```js
+     * livebaordEmbed.on(EmbedEvent.VizPointDoubleClick, payload => {
+     *      console.log('VizPointDoubleClick', payload)
+     * })
+     * ```
      */
     VizPointDoubleClick = "vizPointDoubleClick",
     /**
-     * Listen to clicks on a visualization in a liveboard or Search result.
+     * Listen to clicks on a visualization in a Liveboard or Search result.
+     *
+     * @return viz, clickedPoint - metadata about the point that is clicked
+     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @important
      *
      * @example
      * ```js
@@ -1068,25 +1175,46 @@ export declare enum EmbedEvent {
      *   )
      * });
      * ```
-     * @return viz, clickedPoint - metadata about point that is clicked
-     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
-     * @important
      */
     VizPointClick = "vizPointClick",
     /**
      * An error has occurred.
      *
      * @returns error - An error object or message
+     *
+     * @example
+     * ```js
+     * SearchEmbed.on(EmbedEvent.Error, showErrorMsg)
+     * //show error messaage
+     *  function showErrorMsg() {
+     *    document.getElementById("error");
+     * ```
+     *
      */
     Error = "Error",
     /**
-     * The embedded object has sent an alert
+     * The embedded object has sent an alert.
      *
      * @returns alert - An alert object
+     *
+     * @example
+     * ```js
+     * searchEmbed.on(EmbedEvent.Alert)
+     * ```
+     *
      */
     Alert = "alert",
     /**
      * The ThoughtSpot auth session has expired.
+     *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.AuthExpire, showAuthExpired)
+     * //show auth expired banner
+     * function showAuthExpired() {
+     *    document.getElementById("authExpiredBanner");
+     * }
+     *```
      */
     AuthExpire = "ThoughtspotAuthExpired",
     /**
@@ -1116,14 +1244,28 @@ export declare enum EmbedEvent {
      */
     EmbedIframeCenter = "EmbedIframeCenter",
     /**
-     * Emitted when  the "Get Data" button in Search Bar embed
-     * is clicked.
+     * Emitted when the **Get Data** action is initiated.
+     * Applicable to `SearchBarEmbed` only.
+     *
+     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      *
-     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
+     * @example
+     *```js
+     * searchbarEmbed.on(EmbedEvent.GetDataClick)
+     *  .then(data => {
+     *  console.log('Answer Data:', data);
+     * })
+     *```
      */
     GetDataClick = "getDataClick",
     /**
      * Detects the route change.
+     *
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.RouteChange, payload =>
+     *    console.log('data', payload))
+     *```
      */
     RouteChange = "ROUTE_CHANGE",
     /**
@@ -1133,10 +1275,15 @@ export declare enum EmbedEvent {
      */
     V1Data = "exportVizDataToParent",
     /**
-     * Emitted when the embed does not have cookie access. This
-     * happens on Safari where third-party cookies are blocked by default.
+     * Emitted when the embed does not have cookie access. This happens
+     * when Safari and other Web browsers block third-party cookies
+     * are blocked by default. `NoCookieAccess` can trigger
      *
-     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.NoCookieAccess)
+     *```
+     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1.sw
      */
     NoCookieAccess = "noCookieAccess",
     /**
@@ -1148,239 +1295,539 @@ export declare enum EmbedEvent {
     SAMLComplete = "samlComplete",
     /**
      * Emitted when any modal is opened in the app
-     *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DialogOpen, payload => {
+     *    console.log('dialog open', payload);
+     *  })
+     *```
      */
     DialogOpen = "dialog-open",
     /**
      * Emitted when any modal is closed in the app
-     *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DialogClose, payload => {
+     *     console.log('dialog close', payload);
+     * })
+     *```
      */
     DialogClose = "dialog-close",
     /**
      * Emitted when the Liveboard shell loads.
      * You can use this event as a hook to trigger
      * other events on the rendered Liveboard.
-     *
      * @version SDK: 1.9.1 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.LiveboardRendered, payload => {
+           console.log('Liveboard is rendered', payload);
+       })
+     *```
+     * The following example shows how to trigger
+     * `SetVisibleVizs` event using LiveboardRendered embed event:
+     *
+     * @example
+     *```js
+     * const embedRef = useEmbedRef();
+     * const onLiveboardRendered = () => {
+     * embed.trigger(HostEvent.SetVisibleVizs, ['viz1', 'viz2']);
+     * };
+     *```
      */
     LiveboardRendered = "PinboardRendered",
     /**
      * This can be used to register an event listener which
      * is triggered on all events.
-     *
      * @Version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.ALL, payload => {
+     *  console.log('Embed Events', payload)
+     * })
+     *```
      */
     ALL = "*",
     /**
      * Emitted when an Answer is saved in the app
-     *
      * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     *  searchEmbed.on(EmbedEvent.Save, payload => {
+     *    console.log('Save', payload)
+     *  }, {
+     *    start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.Save, payload => {
+     *    console.log('Save', payload)
+     * })
+     *```
      */
     Save = "save",
     /**
      * Emitted when the download action is triggered on an answer
      *
+     * **Note**: This event is deprecated in v1.21.0.
+     * To fire an event when a download action is initiated on a chart or table,
+     * use `EmbedEvent.DownloadAsPng`, `EmbedEvent.DownloadAsPDF`, `EmbedEvent.DownloadAsCSV`,
+     * or `EmbedEvent.DownloadAsXLSX`
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Download, {
+     * vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * })
+     *```
      */
     Download = "download",
     /**
      * Emitted when the download action is triggered on an answer
-     *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
+     *
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
+     *   console.log('download PNG', payload)}, {start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
+     *   console.log('download PNG', payload)})
+     *```
+     *
      */
     DownloadAsPng = "downloadAsPng",
     /**
      * Emitted when the Download as PDF action is triggered on an answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
+     *   console.log('download PDF', payload)}, {start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
+     *   console.log('download PDF', payload)})
+     *```
+     *
      */
     DownloadAsPdf = "downloadAsPdf",
     /**
      * Emitted when the Download as CSV action is triggered on an answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
+     *   console.log('download CSV', payload)}, {start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsCSV, payload => {
+     *    console.log('download CSV', payload)})
+     *```
      */
     DownloadAsCsv = "downloadAsCsv",
     /**
      * Emitted when the Download as XLSX action is triggered on an answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
+     *   console.log('download Xlsx', payload)}, { start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
+     *   console.log('download Xlsx', payload)})
+     *```
      */
     DownloadAsXlsx = "downloadAsXlsx",
     /**
-     * Emitted when an answer is deleted in the app
+     * Emitted when an Answer is deleted in the app
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * //trigger when action starts
+     * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
+     *    console.log('delete answer', payload)}, {start: true })
+     * //trigger when action is completed
+     * appEmbed.on(EmbedEvent.AnswerDelete, payload => {
+     *    console.log('delete answer', payload)})
+     *```
      */
     AnswerDelete = "answerDelete",
     /**
      * Emitted when an answer is pinned to a Liveboard
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.Pin, payload => {
+     *    console.log('pin', payload)
+     * }, {
+     * start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.Pin, payload => {
+     *    console.log('pin', payload)
+     * })
+     *```
      */
     Pin = "pin",
     /**
      * Emitted when SpotIQ analysis is triggered
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
+     *   console.log('SpotIQAnalyze', payload)
+     * }, {
+     * start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
+     *   console.log('SpotIQ analyze', payload)
+     * })
+     *```
      */
     SpotIQAnalyze = "spotIQAnalyze",
     /**
      * Emitted when a user shares an object with another user or group
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     *
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.Share, payload => {
+     *    console.log('Share', payload)
+     * }, {
+     * start: true
+     * })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.Share, payload => {
+     *   console.log('Share', payload)
+     * })
+     *```
      */
     Share = "share",
     /**
-     * Emitted when a user clicks the Include action to include a specific value or data
-     * on a chart or table
+     * Emitted when a user clicks the **Include** action to include a specific value or
+     * data on a chart or table.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DrillInclude, payload => {
+     *    console.log('Drill include', payload);
+     * })
+     *```
      */
     DrillInclude = "context-menu-item-include",
     /**
-     * Emitted when a user clicks the Exclude action to exclude a specific value or data
-     * on a chart or table
+     * Emitted when a user clicks the **Exclude** action to exclude a specific value or
+     * data on a chart or table
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.DrillExclude, payload => {
+     *     console.log('Drill exclude', payload);
+     * })
+     *```
      */
     DrillExclude = "context-menu-item-exclude",
     /**
-     * Emitted when copied column value on the app
+     * Emitted when a column value is copied in the embedded app.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * seachEmbed.on(EmbedEvent.CopyToClipboard, payload => {
+     *    console.log('copy to clipboard', payload);
+     * })
+     *```
      */
     CopyToClipboard = "context-menu-item-copy-to-clipboard",
     /**
-     * Emitted when a user clicks the Update TML action
+     * Emitted when a user clicks the **Update TML** action
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.UpdateTML)
+     * })
+     *```
      */
     UpdateTML = "updateTSL",
     /**
-     * Emitted when a user clicks the Edit TML action
+     * Emitted when a user clicks the **Edit TML** action
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.EditTML, payload => {
+     *    console.log('Edit TML', payload);
+     * })
+     *```
      */
     EditTML = "editTSL",
     /**
-     * Emitted when ExportTML trigger in answer on the app
-     *
+     * Emitted when the **Export TML** action is triggered on an
+     * an embedded object in the app
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * searchEmbed.on(EmbedEvent.ExportTML, payload => {
+     *     console.log('Export TML', payload)}, { start: true })
+     * //trigger when action ends
+     * searchEmbed.on(EmbedEvent.ExportTML, payload => {
+     *     console.log('Export TML', payload)})
+     *```
      */
     ExportTML = "exportTSL",
     /**
-     * Emitted when an answer is saved as a view
+     * Emitted when an Answer is saved as a View.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * appEmbed.on(EmbedEvent.SaveAsView, payload => {
+     *    console.log('View', payload);
+     * })
+     *```
      */
     SaveAsView = "saveAsView",
     /**
-     * Emitted when copy of existing answer on the app
+     * Emitted when the user creates a copy of an Answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * //trigger when action starts
+     * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
+     *    console.log('Copy and edit', payload)}, {start: true })
+     * //trigger when action ends
+     * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
+     *    console.log('Copy and edit', payload)})
+     *```
      */
     CopyAEdit = "copyAEdit",
     /**
-     * Emitted when a user clicks Show underlying data on an answe
+     * Emitted when a user clicks Show underlying data on an Answer
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.ShowUnderlyingData, payload => {
+     *    console.log('show data', payload);
+     * })
+     *```
      */
     ShowUnderlyingData = "showUnderlyingData",
     /**
-     * Emitted when an answer is switched to a chart or table view
+     * Emitted when an answer is switched to a chart or table view.
      *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     *```js
+     * searchEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
+     *    console.log('switch view', payload);
+     * })
+     *```
      */
     AnswerChartSwitcher = "answerChartSwitcher",
     /**
-     * Internal event to communicate the initial settings back to the TS APP
+     * Internal event to communicate the initial settings back to the ThoughtSpot app
      *
      * @hidden
      */
     APP_INIT = "appInit",
     /**
-     * Emitted when a user clicks Show Liveboard details on a Liveboard
+     * Emitted when a user clicks **Show Liveboard details** on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
+     *    console.log('Liveboard details', payload);
+     * })
+     *```
      */
     LiveboardInfo = "pinboardInfo",
     /**
      * Emitted when a user clicks on the Favorite icon on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.AddToFavorites, payload => {
+     *    console.log('favorites', payload);
+     * })
+     *```
      */
     AddToFavorites = "addToFavorites",
     /**
-     * Emitted when a user clicks Schedule on a Liveboard
+     * Emitted when a user clicks **Schedule** on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Schedule, payload => {
+     *    console.log(`Liveboard schedule', payload);
+     * })
+     *```
      */
     Schedule = "subscription",
     /**
-     * Emitted when a user clicks Edit on a Liveboard or visualization
+     * Emitted when a user clicks **Edit** on a Liveboard or visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Edit, payload => {
+     *    console.log(`Liveboard edit', payload);
+     * })
+     *```
      */
     Edit = "edit",
     /**
-     * Emitted when a user clicks Make a copy on a Liveboard
+     * Emitted when a user clicks *Make a copy* on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.MakeACopy, payload => {
+     *    console.log(`Copy', payload);
+     * })
+     *```
      */
     MakeACopy = "makeACopy",
     /**
-     * Emitted when a user clicks Present on a Liveboard or visualization
+     * Emitted when a user clicks **Present** on a Liveboard or visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Present)
+     *```
+     *
+     * @example
+     *```js
+     * liveboardEmbed.on(EmbedEvent.Present, {
+     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * })
+     *```
      */
     Present = "present",
     /**
-     * Emitted when a user clicks Delete on a Liveboard
+     * Emitted when a user clicks **Delete** on a visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Delete,
+     *   {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
+     *
      */
     Delete = "delete",
     /**
      * Emitted when a user clicks Manage schedules on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.SchedulesList)
+     *```
+     *
      */
     SchedulesList = "schedule-list",
     /**
-     * Emitted when a user clicks Cancel in edit mode on a Liveboard
+     * Emitted when a user clicks **Cancel** in edit mode on a Liveboard
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Cancel)
+     *```
+     *
      */
     Cancel = "cancel",
     /**
-     * Emitted when a user clicks Explore on a visualization
+     * Emitted when a user clicks **Explore** on a visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.Explore,  {
+     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
+     *
      */
     Explore = "explore",
     /**
-     * Emitted when a user clicks Copy link action on a visualization
+     * Emitted when a user clicks **Copy link** action on a visualization
      *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.CopyLink, {
+     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
+     *
      */
     CopyLink = "embedDocument",
     /**
-     * Emitted when a user interacts with cross filters on a visualization or liveboard
+     * Emitted when a user interacts with cross filters on a visualization or Liveboard
+     *
+     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
+     *
+     * @example
+     *```js
+     * liveboardEmbed.trigger(HostEvent.CrossFilterChanged, {
+     *    vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *```
      *
-     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     CrossFilterChanged = "cross-filter-changed",
     /**
      * Emitted when a user right clicks on a visualization (chart or table)
      *
-     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
+     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
+     *
+     * @example
+     *```js
+     * LiveboardEmbed.on(EmbedEvent.VizPointRightClick, payload => {
+     *    console.log('VizPointClick', payload)
+     * })
+     *```
      */
     VizPointRightClick = "vizPointRightClick",
     /**
-     * Emitted when a user clicks on Insert to slide on a visualization
+     * Emitted when a user clicks **Insert to slide** on a visualization
      *
      * @hidden
      */
@@ -1388,52 +1835,53 @@ export declare enum EmbedEvent {
     /**
      * @hidden
      * Emitted when a user changes any filter on a Liveboard.
-     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
+     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
      */
     FilterChanged = "filterChanged",
     /**
-     *  Emitted when a user click on Go button in Sage Embed
+     *  Emitted when a user clicks the **Go** button on the Search page
      *
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     SageEmbedQuery = "sageEmbedQuery",
     /**
-     * Emitten when a user select data source in Sage Embed
+     * Emitted when a user selects a data source.
+     *
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      *
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
      */
     SageWorksheetUpdated = "sageWorksheetUpdated",
     /**
-     * Emitted when a user updates a connection in Data tab
+     * Emitted when a user updates a connection on the **Data** page
      *
-     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
+     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
      */
     UpdateConnection = "updateConnection",
     /**
-     * Emitted when a user updates a connection in Data tab
+     * Emitted when a user updates a connection on the **Data** page
      *
-     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
+     * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
      */
     CreateConnection = "createConnection",
     /**
      * Emitted when name, status (private or public) or filter values of a
-     * PersonalisedView is updated.
+     * Personalised view is updated.
      *
      * @returns viewName: string
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     UpdatePersonalisedView = "updatePersonalisedView",
     /**
-     * Emitted when a PersonalisedView is saved.
+     * Emitted when a Personalised view is saved.
      *
      * @returns viewName: string
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     SavePersonalisedView = "savePersonalisedView",
     /**
@@ -1443,7 +1891,7 @@ export declare enum EmbedEvent {
      * @returns viewId: string
      * @returns liveboardId: string
      * @returns isPublic: boolean
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     ResetLiveboard = "resetLiveboard",
     /**
@@ -1451,11 +1899,11 @@ export declare enum EmbedEvent {
      *
      * @returns views: string[]
      * @returns liveboardId: string
-     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK : 1.26.0 | Thoughtspot: 9.7.0.cl, 9.8.0.sw
      */
     DeletePersonalisedView = "deletePersonalisedView",
     /**
-     * Emitten when a user creates a new worksheet
+     * Emitted when a user creates a new worksheet
      *
      * @version SDK : 1.27.0 | Thoughtspot: 9.8.0.cl
      */
@@ -1485,15 +1933,16 @@ export declare enum EmbedEvent {
  */
 export declare enum HostEvent {
     /**
-     * Triggers a search query in AppEmbed and SearchEmbed
-     * deployments.
+     * Triggers a search operation with the search tokens specified in
+     * the search query string.
+     * Supported in `AppEmbed` and `SearchEmbed` deployments.
      * Includes the following properties:
      *
-     * @param - dataSourceIds - The data source GUID to Search on
+     * @param - `searchQuery` - query string with search tokens
+     * @param - `dataSources` - Data source GUID to Search on
      *                        - Although an array, only a single source
      *                          is supported.
-     * @param - searchQuery - Query string with search tokens
-     * @param - execute - executes the existing / updated query
+     * @param - `execute` - executes search and updates the existing query
      * @example
      * ```js
      * searchembed.trigger(HostEvent.Search, {
@@ -1513,6 +1962,10 @@ export declare enum HostEvent {
      * @param - columnGuid - Optional. GUID of the column to drill
      * by. If not provided it will auto drill by the configured
      *   column.
+     * @param - autoDrillDown - Optional. If true, the drill down will be
+     * done automatically on the most popular column.
+     * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
+     * in case of a liveboard.
      * @example
      * ```js
      * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -1529,6 +1982,25 @@ export declare enum HostEvent {
      *       });
      * })
      * ```
+     * @example
+     * ```js
+     *  // Works with TS 9.8.0 and above
+     *
+     *  liveboardEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
+     *    console.log(payload);
+     *    const clickedPoint = payload.data.clickedPoint;
+     *    const selectedPoint = payload.data.selectedPoints;
+     *    console.log('>>> called', clickedPoint);
+     *    liveboardEmbed.trigger(HostEvent.DrillDown, {
+     *      points: {
+     *        clickedPoint,
+     *        selectedPoints: selectedPoint
+     *      },
+     *      autoDrillDown: true,
+     *      vizId: payload.data.vizId
+     *    });
+     *  })
+     * ```
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      */
     DrillDown = "triggerDrillDown",
@@ -1545,7 +2017,7 @@ export declare enum HostEvent {
      */
     Reload = "reload",
     /**
-     * Sets the visible visualizations on a Liveboard.
+     * Display specific visualizations on a Liveboard.
      *
      * @param - An array of GUIDs of the visualization to show. The visualization IDs not passed
      *  in this parameter will be hidden.
@@ -1559,7 +2031,7 @@ export declare enum HostEvent {
      */
     SetVisibleVizs = "SetPinboardVisibleVizs",
     /**
-     * Set the Active Tab of a Liveboard.
+     * Set a Liveboard tab as an active tab.
      *
      * @param - tabId - string of id of Tab to show
      * @example
@@ -1572,7 +2044,7 @@ export declare enum HostEvent {
      */
     SetActiveTab = "SetActiveTab",
     /**
-     * Updates runtime filters applied on a Saved Answer or Liveboard. The
+     * Update runtime filters applied on a Saved Answer or Liveboard. The
      * runtime filters passed here are appended to the existing runtime
      * filters.
      * Pass an array of runtime filters with the following attributes:
@@ -1598,10 +2070,12 @@ export declare enum HostEvent {
      */
     UpdateRuntimeFilters = "UpdateRuntimeFilters",
     /**
-     * Navigate to a specific page in the embedded application without reloading the page.
+     * Navigate to a specific page in the embedded ThoughtSpot application.
      * This is the same as calling `appEmbed.navigateToPage(path, true)`
      *
-     * @param - path - the path to navigate to (can be a number[1/-1] to go forward/back)
+     * @param - `path` - the path to navigate to to go forward or back. The path value can
+     * be a number; for example, `1`, `-1`.
+     *
      * @example
      * ```js
      * appEmbed.navigateToPage(-1)
@@ -1610,7 +2084,7 @@ export declare enum HostEvent {
      */
     Navigate = "Navigate",
     /**
-     * Opens the filter panel for a particular column.
+     * Open the filter panel for a particular column.
      * Works with Search and Liveboard embed.
      *
      * @param - { columnId: string,
@@ -1628,7 +2102,7 @@ export declare enum HostEvent {
      */
     OpenFilter = "openFilter",
     /**
-     * Adds columns to the current search query.
+     * Add columns to the current search query.
      *
      * @param - { columnIds: string[] }
      * @example
@@ -1639,7 +2113,7 @@ export declare enum HostEvent {
      */
     AddColumns = "addColumns",
     /**
-     * Removes a column from the current search query.
+     * Remove a column from the current search query.
      *
      * @param - { columnId: string }
      * @example
@@ -1650,27 +2124,29 @@ export declare enum HostEvent {
      */
     RemoveColumn = "removeColumn",
     /**
-     * Gets the current Liveboard content.
+     * Get the transient state of a Liveboard as encoded content.
+     * This includes unsaved and ad hoc changes such as
+     * Liveboard filters, runtime filters applied on visualizations on a
+     * Liveboard, and Liveboard layout, changes to visualizations such as
+     * sorting, toggling of legends, and data drill down.
      *
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
+     * liveboardEmbed.trigger(HostEvent.getexportrequestforcurrentpinboard).then(
+     * data=>console.log(data))
      * ```
      * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1.sw
      */
     getExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard",
     /**
-     * Triggers the **Pin** action on an embedded object
+     * Trigger the **Pin** action on an embedded object
      *
      * @param - Liveboard embed takes the `vizId` as a
-     * key. Can be left undefined when embedding Search, full app or
+     * key. Can be left undefined when embedding Search, full app, or
      * a visualization.
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.Pin, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
-     * ```
-     * ```js
-     * vizEmbed.trigger(HostEvent.Pin)
+     * appEmbed.trigger(HostEvent.Pin)
      * ```
      * ```js
      * searchEmbed.trigger(HostEvent.Pin)
@@ -1679,17 +2155,18 @@ export declare enum HostEvent {
      */
     Pin = "pin",
     /**
-     * Triggers the **Show Liveboard details** action on a Liveboard
+     * Trigger the **Show Liveboard details** action
+     * on an embedded Liveboard.
      *
      * @example
-     * ```js
-     *  liveboardEmbed.trigger(HostEvent.LiveboardInfo)
-     * ```
+     *```js
+     * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
+     *```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
      */
     LiveboardInfo = "pinboardInfo",
     /**
-     * Triggers the **Schedule** action on a Liveboard
+     * Trigger the **Schedule** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1699,7 +2176,7 @@ export declare enum HostEvent {
      */
     Schedule = "subscription",
     /**
-     * Triggers the **Manage schedule** action on a Liveboard
+     * Trigger the **Manage schedule** action on an embedded Liveboard
      *
      * @example
      * ```js
@@ -1709,7 +2186,7 @@ export declare enum HostEvent {
      */
     SchedulesList = "schedule-list",
     /**
-     * Triggers the **Export TML** action on a Liveboard
+     * Trigger the **Export TML** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1719,7 +2196,7 @@ export declare enum HostEvent {
      */
     ExportTML = "exportTSL",
     /**
-     * Triggers the **Edit TML** action on a Liveboard
+     * Trigger the **Edit TML** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1729,7 +2206,7 @@ export declare enum HostEvent {
      */
     EditTML = "editTSL",
     /**
-     * Triggers the **Update TML** action on a Liveboard
+     * Trigger the **Update TML** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1739,7 +2216,7 @@ export declare enum HostEvent {
      */
     UpdateTML = "updateTSL",
     /**
-     * Triggers the **Download PDF** action on a Liveboard
+     * Trigger the **Download PDF** action on an embedded Liveboard.
      *
      * @example
      * ```js
@@ -1749,8 +2226,8 @@ export declare enum HostEvent {
      */
     DownloadAsPdf = "downloadAsPdf",
     /**
-     * Triggers the **Make a copy** action on a Liveboard, Search, or
-     * visualization page
+     * Trigger the **Make a copy** action on a Liveboard, Search, or
+     * visualization page.
      *
      * @example
      * ```js
@@ -1766,7 +2243,7 @@ export declare enum HostEvent {
      */
     MakeACopy = "makeACopy",
     /**
-     * Triggers the **Delete** action on a Liveboard
+     * Trigger the **Delete** action for a Liveboard.
      *
      * @example
      * ```js
@@ -1776,7 +2253,7 @@ export declare enum HostEvent {
      */
     Remove = "delete",
     /**
-     * Triggers the **Explore* action on a visualization
+     * Trigger the **Explore** action on a visualization.
      *
      * @param - an object with `vizId` as a key
      * @example
@@ -1787,7 +2264,7 @@ export declare enum HostEvent {
      */
     Explore = "explore",
     /**
-     * Triggers the **Create alert** action on a visualization
+     * Trigger the **Create alert** action on a visualization
      *
      * @param - an object with `vizId` as a key
      * @example
@@ -1800,7 +2277,7 @@ export declare enum HostEvent {
      */
     CreateMonitor = "createMonitor",
     /**
-     * Triggers the **Manage alerts** action on a visualization
+     * Trigger the **Manage alerts** action on a visualization
      *
      * @param - an object with `vizId` as a key
      * @example
@@ -1813,7 +2290,7 @@ export declare enum HostEvent {
      */
     ManageMonitor = "manageMonitor",
     /**
-     * Triggers the **Edit** action on a Liveboard or visualization
+     * Trigger the **Edit** action on a Liveboard or visualization
      *
      * @param - object - To trigger the action for a specific visualization
      * in Liveboard embed, pass in `vizId` as a key.
@@ -1834,7 +2311,7 @@ export declare enum HostEvent {
      */
     Edit = "edit",
     /**
-     * Triggers the **Copy link** action on a Liveboard or visualization
+     * Trigger the **Copy link** action on a Liveboard or visualization
      *
      * @param - object - to trigger the action for a
      * specific visualization in Liveboard embed, pass in `vizId` as a key
@@ -1852,7 +2329,7 @@ export declare enum HostEvent {
      */
     CopyLink = "embedDocument",
     /**
-     * Triggers the **Present** action on a Liveboard or visualization
+     * Trigger the **Present** action on a Liveboard or visualization
      *
      * @param - object - to trigger the action for a specific visualization
      *  in Liveboard embed, pass in `vizId` as a key
@@ -1870,7 +2347,7 @@ export declare enum HostEvent {
      */
     Present = "present",
     /**
-     * Gets TML for the current search.
+     * Get TML for the current search.
      *
      * @example
      * ```js
@@ -1885,7 +2362,7 @@ export declare enum HostEvent {
      */
     GetTML = "getTML",
     /**
-     * Triggers the **Show underlying data** action on visualization or search
+     * Trigger the **Show underlying data** action on visualization or search
      *
      * @param - an object with vizId as a key
      * @example
@@ -1903,7 +2380,9 @@ export declare enum HostEvent {
      */
     ShowUnderlyingData = "showUnderlyingData",
     /**
-     * Triggers the **Delete** action on visualization or search
+     * Trigger the **Delete** action for a visualization
+     * in an embedded Liveboard, or a chart or table
+     * generated from Search.
      *
      * @param - Liveboard embed takes an object with `vizId` as a key.
      * Can be left empty if embedding Search or visualization.
@@ -1913,16 +2392,13 @@ export declare enum HostEvent {
      * '730496d6-6903-4601-937e-2c691821af3c'})
      * ```
      * ```js
-     * vizEmbed.trigger(HostEvent.Delete)
-     * ```
-     * ```js
      * searchEmbed.trigger(HostEvent.Delete)
      * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     Delete = "onDeleteAnswer",
     /**
-     * Triggers the **SpotIQ analyze** action on visualization
+     * Trigger the **SpotIQ analyze** action on visualization
      * or search.
      *
      * @param - Liveboard embed takes `vizId` as a
@@ -1943,7 +2419,7 @@ export declare enum HostEvent {
      */
     SpotIQAnalyze = "spotIQAnalyze",
     /**
-     * Triggers the **Download** action on charts in
+     * Trigger the **Download** action on charts in
      * the embedded view.
      *
      * @example
@@ -1952,17 +2428,15 @@ export declare enum HostEvent {
      * '730496d6-6903-4601-937e-2c691821af3c'})
      * ```
      * ```js
-     * vizEmbed.trigger(HostEvent.Download)
-     * ```
-     * ```js
-     * searchEmbed.trigger(HostEvent.Download)
+     * embed.trigger(HostEvent.Download)
      * ```
-     * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw ,Use {@link DownloadAsPng}
+     * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
+     * Use {@link DownloadAsPng}
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
      */
     Download = "downloadAsPng",
     /**
-     * Triggers the **Download** > **PNG** action on
+     * Trigger the **Download** > **PNG** action on
      * charts in the embedded view.
      *
      * @example
@@ -1978,7 +2452,7 @@ export declare enum HostEvent {
      */
     DownloadAsPng = "downloadAsPng",
     /**
-     * Triggers the **Download** > **CSV**  action on tables in
+     * Trigger the **Download** > **CSV**  action on tables in
      * the embedded view.
      *
      * @example
@@ -1996,7 +2470,7 @@ export declare enum HostEvent {
      */
     DownloadAsCsv = "downloadAsCSV",
     /**
-     * Triggers the **Download** > **XLSX**  action on tables
+     * Trigger the **Download** > **XLSX**  action on tables
      * in the embedded view.
      *
      * @example
@@ -2014,7 +2488,7 @@ export declare enum HostEvent {
      */
     DownloadAsXlsx = "downloadAsXLSX",
     /**
-     * Triggers the **Share** action on an embedded
+     * Trigger the **Share** action on an embedded
      * Liveboard or Answer.
      *
      * @example
@@ -2028,7 +2502,7 @@ export declare enum HostEvent {
      */
     Share = "share",
     /**
-     * Triggers the **Save**  action on a Liveboard or Answer.
+     * Trigger the **Save**  action on a Liveboard or Answer.
      * Saves the changes.
      *
      * @example
@@ -2042,7 +2516,7 @@ export declare enum HostEvent {
      */
     Save = "save",
     /**
-     * Triggers the **Sync to Sheets** action on an embedded visualization or Answer
+     * Trigger the **Sync to Sheets** action on an embedded visualization or Answer
      * Sends data from an Answer or Liveboard visualization to a Google sheet.
      *
      * @param - an object with `vizId` as a key
@@ -2058,7 +2532,7 @@ export declare enum HostEvent {
      */
     SyncToSheets = "sync-to-sheets",
     /**
-     * Triggers the **Sync to Other Apps** action on an embedded visualization or Answer
+     * Trigger the **Sync to Other Apps** action on an embedded visualization or Answer
      * Sends data from an Answer or Liveboard visualization to third-party apps such
      * as Slack, Salesforce, Microsoft Teams, ServiceNow and so on.
      *
@@ -2075,7 +2549,7 @@ export declare enum HostEvent {
      */
     SyncToOtherApps = "sync-to-other-apps",
     /**
-     * Triggers the **Manage pipelines** action on an embedded
+     * Trigger the **Manage pipelines** action on an embedded
      * visualization or Answer.
      * Allows users to manage ThoughtSpot Sync pipelines.
      *
@@ -2092,18 +2566,21 @@ export declare enum HostEvent {
      */
     ManagePipelines = "manage-pipeline",
     /**
-     * Triggers the Reset search on the Search page
+     * Reset search operation on the Search or Answer page.
      *
      * @example
      * ```js
      * searchEmbed.trigger(HostEvent.ResetSearch)
      * ```
+     * ```js
+     * appEmbed.trigger(HostEvent.ResetSearch)
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1.sw
      */
     ResetSearch = "resetSearch",
     /**
      * @hidden
-     * Gets the currents visible and runtime filters applied on a Liveboard
+     * Get the currents visible and runtime filters applied on a Liveboard
      * @example
      * liveboardEmbed.trigger(HostEvent.GetFilters)
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
@@ -2111,7 +2588,7 @@ export declare enum HostEvent {
     GetFilters = "getFilters",
     /**
      * @hidden
-     * Updates the visible filters on the Liveboard.
+     * Update the visible filters on the Liveboard.
      * @param - filter: filter object containing column name and filter operation and values
      * @example
      *
@@ -2124,7 +2601,7 @@ export declare enum HostEvent {
      */
     UpdateFilters = "updateFilters",
     /**
-     * Get Tab for the current Liveboard.
+     * Get tab details for the current Liveboard.
      *
      * @example
      * ```js
@@ -2138,9 +2615,9 @@ export declare enum HostEvent {
      */
     GetTabs = "getTabs",
     /**
-     * Set the visible Tabs on a Liveboard.
+     * Set the visible tabs on a Liveboard.
      *
-     * @param - an array of ids of Tabs to show, the ids not passed
+     * @param - an array of ids of tabs to show, the IDs not passed
      *          will be hidden.
      * @example
      * ```js
@@ -2154,8 +2631,8 @@ export declare enum HostEvent {
     /**
      * Set the hidden tabs on a Liveboard.
      *
-     * @param - an array of ids of Tabs to hide, the ids not passed
-     *          will be shown.
+     * @param - an array of the IDs of the tabs to hide.
+     * The IDs not passed will be shown.
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
@@ -2166,9 +2643,12 @@ export declare enum HostEvent {
      */
     SetHiddenTabs = "SetPinboardHiddenTabs",
     /**
-     * Updates the search query for sage embed.
+     * Updates the search query string for Natural Language Search operations.
+     *
+     * @param - `queryString`: Text string in Natural Language format
+     *
+     * @param - `executeSearch`: Boolean to execute search and update search query
      *
-     * @param - searchOptions: an object queryString and option to execute the query.
      * @example
      * ```js
      * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
@@ -2176,7 +2656,7 @@ export declare enum HostEvent {
      *  executeSearch: true,
      * })
      * ```
-     * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
+     * @version SDK: 1.26.0 | Thoughtspot: 9.8.0.cl, 9.8.0.sw
      */
     UpdateSageQuery = "updateSageQuery",
     /**
@@ -2189,24 +2669,25 @@ export declare enum HostEvent {
      *      vizId: '123', // For Liveboard Visualization.
      *  })
      * ```
+     * @version SDK: 1.26.0 | Thoughtspot: 9.10.0.cl
      */
     GetAnswerSession = "getAnswerSession"
 }
 /**
  * The different visual modes that the data sources panel within
- * search could appear in, i.e., hidden, collapsed, or expanded.
+ * search could appear in, such as hidden, collapsed, or expanded.
  */
 export declare enum DataSourceVisualMode {
     /**
-     * Data source panel is hidden.
+     * The data source panel is hidden.
      */
     Hidden = "hide",
     /**
-     * Data source panel is collapsed, but the user can manually expand it.
+     * The data source panel is collapsed, but the user can manually expand it.
      */
     Collapsed = "collapse",
     /**
-     * Data source panel is expanded, but the user can manually collapse it.
+     * The data source panel is expanded, but the user can manually collapse it.
      */
     Expanded = "expand"
 }
@@ -2282,7 +2763,8 @@ export declare enum Param {
     LiveboardHeaderSticky = "isLiveboardHeaderSticky",
     IsProductTour = "isProductTour",
     HideSearchBarTitle = "hideSearchBarTitle",
-    HideSageAnswerHeader = "hideSageAnswerHeader"
+    HideSageAnswerHeader = "hideSageAnswerHeader",
+    HideSearchBar = "hideSearchBar"
 }
 /**
  * ThoughtSpot application pages include actions and menu commands
@@ -2342,9 +2824,11 @@ export declare enum Action {
     SaveAsView = "saveAsView",
     /**
      * The **Make a copy** action on a Liveboard or Answer
-     * page.
-     * Creates a copy of the Liveboard, visualization,
-     * or Answer.
+     * page. Creates a copy of the Liveboard.
+     * In LiveboardEmbed, the **Make a copy** action is not available for
+     * visualizations in the embedded Liveboard view.
+     * In AppEmbed, the **Make a copy** action is available on both
+     * Liveboards and visualizations.
      *
      * @example
      * ```js
@@ -2528,7 +3012,7 @@ export declare enum Action {
      */
     DownloadAsPdf = "downloadAsPdf",
     /**
-     * The **Download**  > **CSV** menu action for tables on a Liveboard
+     * The **Download** > **CSV** menu action for tables on a Liveboard
      * or Answer page.
      * Downloads a visualization or Answer in the XLSX format.
      *
@@ -3059,6 +3543,7 @@ export declare enum Action {
      */
     RenameModalTitleDescription = "renameModalTitleDescription",
     /**
+     *
      * @version SDK: 1.25.0 | Thoughtspot: 9.6.0.cl
      */
     RequestVerification = "requestVerification",